zsxq-topic
unnoo/zsxq-skill
Manage Knowledge Planet topics: search, create, edit, comment, answer questions, and moderate content.
What is zsxq-topic?
A skill for managing topics (posts, Q&A, tasks) within Knowledge Planet groups. Use it to search topics, view details, publish and edit posts, comment and reply, answer questions, delete topics, and manage topic metadata like tags and digest status.
- Search topics across a Knowledge Planet group with full-text search
- View complete topic details including content, comments, likes, and tags
- Create new topics (talk type) with confirmation workflow
- Edit existing topics (text and attachments) you authored
- Post comments and nested replies (楼中楼) on topics
- Publish official answers to Q&A type topics
How to install zsxq-topic
npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-topic- zsxq-cli installed and available in PATH
- Authentication configured (see zsxq-shared skill for login details)
- Valid Knowledge Planet group access
How to use zsxq-topic
- 1.Authenticate with Knowledge Planet using zsxq-shared login if not already logged in
- 2.Use `zsxq-cli topic +search` to find existing topics by keyword
- 3.Use `zsxq-cli topic +detail <topic_id>` to view full topic information
- 4.Use `zsxq-cli topic +create` to publish a new post with confirmation
- 5.Use `zsxq-cli topic +reply` to comment or reply to existing topics
- 6.Use `zsxq-cli topic +answer` to provide official answers to Q&A topics
- 7.Use `zsxq-cli api call` for advanced operations like setting tags, digest status, or retrieving your question history
- 8.Use `zsxq-cli api raw --method DELETE --path /v2/topics/<topic_id>` to delete topics
Use cases
- Search for existing discussions or solutions within a Knowledge Planet group
- Publish new posts or ask questions in a group
- Respond to questions or provide answers as a group moderator
- Organize topics by tagging and marking high-quality content as digest
- Track your own questions and answers across groups
- Knowledge Planet group members
- Group moderators and administrators
- Content curators managing topic quality
- Users seeking or sharing knowledge within groups
zsxq-topic FAQ
Currently the skill supports creating 'talk' type topics (regular posts with text and images). Other types like q&a, task, and solution are managed through the Knowledge Planet interface.
No, the +edit shortcut only allows editing topics you authored. Moderators can delete topics via API if needed.
It's a reply to a specific comment within a topic thread, creating a nested conversation. Use the +reply shortcut with the comment_id to create nested replies.
Use `zsxq-cli api call set_topic_digested` with the topic_id and digested flag. This requires moderator/owner permissions.
Use `zsxq-cli api call get_self_question_topics` with filters for unanswered or answered questions to see your question records.
Full instructions (SKILL.md)
Source of truth, from unnoo/zsxq-skill.
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 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+search | 在星球内全文搜索主题，返回 topic_id / 类型 / 标题 / 时间表格 |
+detail | 获取单条主题的完整详情（内容、评论数、点赞数、标签等） |
+create | 在指定星球发布新主题（仅支持 talk 类型），需确认内容后执行 |
+edit | 编辑自己发布的主题（正文、附件），需确认内容后执行 |
+reply | 对主题发表评论，支持楼中楼回复，需确认内容后执行 |
+answer | 对提问类主题（q&a）发布官方回答，需确认内容后执行 |
API（通过 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） |
原始 HTTP 调用（zsxq-cli api raw）
| 操作 | 命令模板 | 说明 |
|---|---|---|
| 删除主题 | api raw --method DELETE --path /v2/topics/<topic_id> | 删除主题，不可恢复 |
Related skills
More from unnoo/zsxq-skill and the wider catalog.
zsxq-shared
知识星球 CLI 共享基础：认证、API 调用、链接拼接、错误处理
zsxq-note
Manage shareable public notes on 知识星球 (Zhihu Planet) with create, edit, view, and delete operations.
zsxq-group
Manage 知识星球 (Zhihu Knowledge Planet) groups: list, browse topics, query tags, search members.
zsxq-user
View 知识星球 user profile, cross-sphere topic footprints, and submit NPS feedback.