mirror of
https://github.com/jackwener/OpenCLI.git
synced 2026-09-14 18:25:42 +08:00
tiaot33
5553300597
* 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>
224 lines
5.8 KiB
Markdown
224 lines
5.8 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
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`
|
|
|
|
## categories
|
|
|
|
List forum categories with optional sub-category expansion.
|
|
|
|
```bash
|
|
opencli linux-do categories
|
|
opencli linux-do categories --subcategories
|
|
opencli linux-do categories --limit 50
|
|
```
|
|
|
|
When `--subcategories` is enabled, sub-categories are rendered as `Parent / Child` so the `name` value can be copied directly into `opencli linux-do feed --category ...`.
|
|
|
|
Output columns: `name`, `slug`, `id`, `topics`, `description`
|
|
|
|
## tags
|
|
|
|
List tags sorted by usage count.
|
|
|
|
```bash
|
|
opencli linux-do tags
|
|
opencli linux-do tags --limit 50
|
|
```
|
|
|
|
Output columns: `rank`, `name`, `count`, `url`
|
|
|
|
## search
|
|
|
|
Search topics by keyword.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
opencli linux-do latest
|
|
opencli linux-do hot --period weekly
|
|
opencli linux-do category develop 4
|
|
```
|
|
|
|
Preferred modern forms:
|
|
|
|
```bash
|
|
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](/guide/browser-bridge) installed
|