On first use or when encountering an authentication error (401 / token expired /
not logged in), first read../zsxq-shared/SKILL.mdto understand the login and API call conventions. There is no need to reread it every time when making routine calls with an already logged-in account.
Core Concepts
- Topic: the content unit within a Planet, uniquely identified by
topic_id. Types:talk: regular post (text and images)q&a: question, which can be answered by the Planet ownertask: assignment questionsolution: assignment answer
- Comment: a reply under a topic, identified by
comment_id, supports nested replies (replied_comment_id)。 - Featured (Digested): the Planet owner can set high-quality topics as featured to highlight them within the Planet.
Resource Relationships
Group (group_id)
└── Topic (topic_id) — talk / q&a / task / solution
├── Comment (comment_id)
│ └── 楼中楼 Reply (replied_comment_id)
├── Answer(q&a 类型专属)
└── Hashtag 标签列表
Shortcuts (recommended, use first)
Shortcut is a high-level wrapper for common operations (zsxq-cli topic +<verb> [flags]). For operations that have a Shortcut, use it first.
| Shortcut | Description |
|---|---|
+search |
Full-text search topics within a Planet, returning a table of topic_id / type / title / time |
+detail |
Get the full details of a single topic (content, comment count, like count, tags, etc.) |
+create |
Publish a new topic in the specified Planet (only talk type is supported), execute after confirming the content |
+edit |
Edit a topic you published (body, attachments), execute after confirming the content |
+reply |
Post a comment on a topic, supports nested replies, execute after confirming the content |
+answer |
Publish an official answer to a question-type topic (q&a), execute after confirming the content |
API (called directly via zsxq-cli api call )
Advanced operations not covered by Shortcut:
| Tool | Parameter | Description |
|---|---|---|
get_topic_comments |
topic_id, limit, index |
Get a topic's comment list (paginated) |
set_topic_digested |
topic_id, digested |
Set/unset featured (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 you have initiated (unanswered/answered) |
get_self_answer_topics |
topic_filter, count, end_time |
View questions others have initiated to me (unanswered/answered) |
Raw HTTP call (zsxq-cli api raw)
| Operation | Command template | Description |
|---|---|---|
| Delete topic | api raw --method DELETE --path /v2/topics/<topic_id> |
Delete a topic, irreversible |