> 首次使用或遇到认证错误（401 / token 过期 / not logged in）时，先读 ../zsxq-shared/SKILL.md 了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。
topic_id 唯一标识。类型：talk：普通帖子（图文）q&a：提问，可被星主回答article：长文章comment_id 标识，支持楼中楼（replied_comment_id）。Group (group_id)
└── Topic (topic_id) — talk / q&a / article
├── Comment (comment_id)
│ └── 楼中楼 Reply (replied_comment_id)
├── Answer（q&a 类型专属）
└── Hashtag 标签列表
Shortcut 是对常用操作的高级封装（zsxq-cli topic +）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
| ---------- | ------ |
+search | 在星球内全文搜索主题，返回 topic_id / 类型 / 标题 / 时间表格 |
+detail | 获取单条主题的完整详情（内容、评论数、点赞数、标签等） |
+create | 在指定星球发布新主题（帖子），需确认内容后执行 |
+edit | 编辑自己发布的主题（正文、附件），需确认内容后执行 |
+reply | 对主题发表评论，支持楼中楼回复，需确认内容后执行 |
+answer | 对提问类主题（q&a）发布官方回答，需确认内容后执行 |
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） |
get_self_answer_topics | topic_filter, count, end_time | 查看别人向我发起的提问（unanswered/answered） |
zsxq-cli api raw）| 操作 | 命令模板 | 说明 |
|---|---|---|
| ------ | ---------- | ------ |
| 删除主题 | api raw --method DELETE --path /v2/topics/ | 删除主题，不可恢复 |
共 3 个版本