zsxq-topic

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

topic (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取
../zsxq-shared/SKILL.md
，其中包含认证、错误处理规则。

CRITICAL — MUST use the Read tool to read
../zsxq-shared/SKILL.md
before starting, which contains authentication and error handling rules.

Core Concepts

主题（Topic）：星球内的内容单元，由
```
topic_id
```
唯一标识。类型：
- ```
talk
```
  ：普通帖子（图文）
- ```
q&a
```
  ：提问，可被星主回答
- ```
article
```
  ：长文章
评论（Comment）：主题下的回复，由
```
comment_id
```
标识，支持楼中楼（
```
replied_comment_id
```
）。
精华（Digested）：星主可将优质主题设为精华，在星球内突出展示。

Topic: Content unit within the Planet, uniquely identified by
```
topic_id
```
. Types:
- ```
talk
```
  : Regular post (images and text)
- ```
q&a
```
  : Question, can be answered by the Planet Owner
- ```
article
```
  : Long article
Comment: Reply under a topic, identified by
```
comment_id
```
, supports nested replies (
```
replied_comment_id
```
).
Digested: The Planet Owner can mark high-quality topics as digested for prominent display within the Planet.

Resource Relationships

Group (group_id)
└── Topic (topic_id) — talk / q&a / article
    ├── Comment (comment_id)
    │   └── 楼中楼 Reply (replied_comment_id)
    ├── Answer（q&a 类型专属）
    └── Hashtag 标签列表

Group (group_id)
└── Topic (topic_id) — talk / q&a / article
    ├── Comment (comment_id)
    │   └── 楼中楼 Reply (replied_comment_id)
    ├── Answer（q&a 类型专属）
    └── Hashtag 标签列表

Important Notes

写入操作前必须确认

Must Confirm Before Write Operations

发帖、评论、回答均为不可撤销的公开操作，执行前必须向用户确认：

目标星球 / 主题（group_id / topic_id）
发布的内容（title / content / text）

Posting, commenting, and answering are irreversible public operations. Must confirm with the user before execution:

Target Planet / Topic (group_id / topic_id)
Content to publish (title / content / text)

topic_id 的获取

Obtaining topic_id

不确定 topic_id 时，先查询再操作：

关键词搜索：

topic +search --group-id xxx --query "关键词"

浏览最新：
```
group +topics --group-id xxx
```
查看详情：
```
topic +detail --topic-id xxx
```

When unsure of the topic_id, query first before proceeding:

Keyword search:

topic +search --group-id xxx --query "keywords"

Browse latest:
```
group +topics --group-id xxx
```
View details:
```
topic +detail --topic-id xxx
```

Shortcuts（推荐优先使用）

Shortcuts (Recommended for Priority Use)

Shortcut 是对常用操作的高级封装（

zsxq-cli topic +<verb> [flags]

）。有 Shortcut 的操作优先使用。

Shortcut	说明
`+search`	在星球内全文搜索主题，返回 topic_id / 类型 / 标题 / 时间表格
`+detail`	获取单条主题的完整详情（内容、评论数、点赞数、标签等）
`+create`	在指定星球发布新主题（帖子），需确认内容后执行
`+reply`	对主题发表评论，支持楼中楼回复，需确认内容后执行
`+answer`	对提问类主题（q&a）发布官方回答，需确认内容后执行

Shortcuts are advanced encapsulations of common operations (

zsxq-cli topic +<verb> [flags]

). Prioritize using operations with Shortcuts.

Shortcut	Description
`+search`	Full-text search for topics within the Planet, returns a table of topic_id / type / title / time
`+detail`	Get complete details of a single topic (content, comment count, like count, tags, etc.)
`+create`	Publish a new topic (post) in the specified Planet, execute after confirming content
`+reply`	Post a comment on a topic, supports nested replies, execute after confirming content
`+answer`	Publish an official answer to a q&a type topic, execute after confirming content

API（通过

zsxq-cli api call

直接调用）

API (Directly Called via

zsxq-cli api call

)

Shortcut 未覆盖的高级操作：

工具	参数	说明
`get_topic_comments`	`topic_id` , `limit` , `index`	获取主题评论列表（分页）
`set_topic_digested`	`topic_id` , `digested`	设置/取消精华（星主权限）
`set_topic_tags`	`topic_id` , `titles`	为主题设置标签（标签名数组）
`get_self_question_topics`	`topic_filter` , `count` , `end_time`	查看自己发起的提问（ `unanswered` / `answered` ）

Advanced operations not covered by Shortcuts:

Tool	Parameters	Description
`get_topic_comments`	`topic_id` , `limit` , `index`	Get topic comment list (pagination)
`set_topic_digested`	`topic_id` , `digested`	Set/cancel digested status (Planet Owner permission)
`set_topic_tags`	`topic_id` , `titles`	Set tags for a topic (array of tag names)
`get_self_question_topics`	`topic_filter` , `count` , `end_time`	View questions initiated by yourself ( `unanswered` / `answered` )

zsxq-topic

Original

Translation

topic (v1)

topic (v1)

Core Concepts

Core Concepts

Resource Relationships

Resource Relationships

Important Notes

Important Notes

写入操作前必须确认

Must Confirm Before Write Operations

topic_id 的获取

Obtaining topic_id

Shortcuts（推荐优先使用）

Shortcuts (Recommended for Priority Use)

API（通过
`zsxq-cli api call`
直接调用）

API (Directly Called via
`zsxq-cli api call`
)

zsxq-topic

Original

Translation

topic (v1)

topic (v1)

Core Concepts

Core Concepts

Resource Relationships

Resource Relationships

Important Notes

Important Notes

写入操作前必须确认

Must Confirm Before Write Operations

topic_id 的获取

Obtaining topic_id

Shortcuts（推荐优先使用）

Shortcuts (Recommended for Priority Use)

API（通过 zsxq-cli api call 直接调用）

API (Directly Called via zsxq-cli api call)

API（通过
`zsxq-cli api call`
直接调用）

API (Directly Called via
`zsxq-cli api call`
)