name: zsxq-topic version: 1.3.1 description: "知识星球主题管理：搜索主题、查看主题详情、发布帖子、编辑主题、发表评论、回复某条评论（楼中楼）、回答提问、删除主题；通过 api call 查看主题评论列表、设置精华、设置标签、查看自己提的问题与已回答记录。当用户需要查找内容、发帖、编辑主题、评论、回复评论、回答问题、删除主题、查看主题评论、查看自己的提问记录、或管理主题精华和标签时使用。" metadata: requires: bins: ["zsxq-cli"] cliHelp: "zsxq-cli topic --help"

topic

首次使用或遇到认证错误（401 / token 过期 / not logged in）时，先读 `../zsxq-shared/SKILL.md` 了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。

Core Concepts

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

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（推荐优先使用）

Shortcut 是对常用操作的高级封装（zsxq-cli topic +<verb> [flags]）。有 Shortcut 的操作优先使用。

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

Shortcut 未覆盖的高级操作：

原始 HTTP 调用（zsxq-cli api raw）