mirror of https://github.com/jackwener/OpenCLI.git synced 2026-09-14 18:25:42 +08:00

Files

T

tiaot33 5553300597 feat(linux-do): split topic content into a dedicated command (#821 )

* feat(linux-do): split topic content into a dedicated command

Move the old main-post path out of linux-do topic so topic stays a summarized first-page reader while topic-content becomes the Markdown-focused entrypoint for full post bodies.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

* feat(linux-do): update topic content handling to include YAML front matter

* fix(linux-do): update default output format to plain for topic-content rendering

* fix(linux-do): replace js-yaml with inline YAML serialization for topic-content

Adapters must only import node builtins, relative modules, or opencli
public APIs. Hand-roll the simple front matter serialization to remove
the third-party js-yaml dependency.

* fix(linux-do): refine YAML quoting to only escape colons followed by space

Colons in URLs (e.g. https://) are valid unquoted YAML values. Only
quote when a colon is followed by a space or appears at end of line.

---------

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

2026-04-06 02:59:56 +08:00

5.8 KiB

Raw Permalink Blame History

LINUX DO

Mode: 🔐 Browser · Domain: linux.do

Commands

Command	Description
`opencli linux-do feed`	Browse topics (site-wide, by tag, or by category)
`opencli linux-do categories`	List all categories
`opencli linux-do tags`	List popular tags
`opencli linux-do search <query>`	Search topics
`opencli linux-do topic <id>`	View topic posts
`opencli linux-do topic-content <id>`	Read the main topic body as Markdown
`opencli linux-do user-topics <username>`	Topics created by a user
`opencli linux-do user-posts <username>`	Replies posted by a user

feed

Browse topic listings. Defaults to latest topics when called with no arguments.

Supports filtering by --tag, --category, or both
--tag accepts tag name, slug, or ID
--category accepts category name, slug, ID, or Parent / Child path for sub-categories
Use --view to switch between latest / hot / top

Basic

# Latest topics (default)
opencli linux-do feed

# Hot topics
opencli linux-do feed --view hot

# Top topics — default period is weekly
opencli linux-do feed --view top
opencli linux-do feed --view top --period daily
opencli linux-do feed --view top --period monthly

# Sort by views descending
opencli linux-do feed --order views

# Sort by created time ascending
opencli linux-do feed --order created --ascending

# Limit results
opencli linux-do feed --limit 10

# JSON output
opencli linux-do feed -f json

Filter by tag

# By tag name, slug, or ID — all equivalent
opencli linux-do feed --tag "ChatGPT"
opencli linux-do feed --tag chatgpt
opencli linux-do feed --tag 3

# Tag + hot view
opencli linux-do feed --tag "ChatGPT" --view hot

# Tag + top view with period
opencli linux-do feed --tag "OpenAI" --view top --period monthly

Filter by category

Supports both top-level and sub-categories. Sub-categories auto-resolve their parent path.

# Top-level category — name, slug, or ID
opencli linux-do feed --category "开发调优"
opencli linux-do feed --category develop
opencli linux-do feed --category 4

# Sub-category
opencli linux-do feed --category "开发调优 / Lv1"
opencli linux-do feed --category "网盘资源"

# Category + hot / top view
opencli linux-do feed --category "开发调优" --view hot
opencli linux-do feed --category "开发调优" --view top --period weekly

Category + tag

Combine --category and --tag to narrow results within a category.

opencli linux-do feed --category "开发调优" --tag "ChatGPT"
opencli linux-do feed --category "网盘资源" --tag "OpenAI"
opencli linux-do feed --category 94 --tag 4 --view top --period monthly

Parameters

Parameter	Description	Default
`--view V`	`latest`, `hot`, `top`	`latest`
`--tag VALUE`	Tag name, slug, or ID	—
`--category VALUE`	Category name, slug, or ID	—
`--limit N`	Number of results	`20`
`--order O`	`default`, `created`, `activity`, `views`, `posts`, `category`, `likes`, `op_likes`, `posters`	`default`
`--ascending`	Sort ascending instead of descending	off
`--period P`	`all`, `daily`, `weekly`, `monthly`, `quarterly`, `yearly` (only with `--view top`)	`weekly`

Output columns: title, replies, created, likes, views, url

search

Search topics by keyword.

opencli linux-do search "NixOS"
opencli linux-do search "Docker" --limit 10
opencli linux-do search "Claude" -f json

Output columns: rank, title, views, likes, replies, url

topic

View summarized first-page posts within a topic.

opencli linux-do topic 1234
opencli linux-do topic 1234 --limit 50

Notes:

content is a plain-text summary extracted from each first-page post
Each summary is truncated to 200 characters
Use opencli linux-do topic-content <id> for the full main post body in Markdown

Output columns: author, content, likes, created_at

topic-content

Read the main topic body as Markdown.

opencli linux-do topic-content 1234
opencli linux-do topic-content 1234 -f json

Notes:

Default output prints the Markdown body directly for copy/paste or piping into LLMs
Use -f json if you want a machine-readable wrapper

Output columns: content

user-topics

List topics created by a user.

opencli linux-do user-topics neo
opencli linux-do user-topics neo --limit 10

Output columns: rank, title, replies, created_at, likes, views, url

user-posts

List replies posted by a user.

opencli linux-do user-posts neo
opencli linux-do user-posts neo --limit 10

Output columns: index, topic_user, topic, reply, time, url

Compatibility

The legacy commands below are still available as compatibility wrappers while feed becomes the canonical entrypoint:

opencli linux-do latest
opencli linux-do hot --period weekly
opencli linux-do category develop 4

Preferred modern forms:

opencli linux-do feed --view latest
opencli linux-do feed --view top --period weekly
opencli linux-do feed --category 4

Prerequisites

Chrome running and logged into linux.do
Browser Bridge extension installed

5.8 KiB Raw Permalink Blame History