SuperAPI AI Directory

zsxq-topic

Coding & development

View repository

Updated 10-16 09:45

About this skill

topic

On first use or when encountering an authentication error (401 / token expired / not logged in), first read ../zsxq-shared/SKILL.md to 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 owner
    • task: assignment question
    • solution: 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