知识星球 zsxq-cli

解决什么问题

运营知识星球时，很多操作天然不适合手动点鼠标：每日巡场要翻最新主题、评论区和待回答问题；内容治理要做加精、打标签、收录专栏；数据产出要出日报周报，甚至把帖子转成海报图或竖版视频。这些需求要么靠人肉重复劳动，要么靠写一次性脚本硬编码 API。zsxq-cli 技能把「认证 → 定位 → 读写 → 编排」这条路打包成一套可复用的调用约定，让 Agent 能直接用命令行完成知识星球的日常运维，而不是每次从零摸索接口。

它如何工作

技能的核心设计是分层路由，按顺序匹配用户请求：

• 场景模式：请求命中已注册的业务场景（如每日巡场、评论区整理、到期成员续费关怀），读取对应 scenarios/*.md 入口文档，按流程编排多个原子操作。
• 原子操作：请求明确对应单个常用操作（如发帖、评论、设精华），直接跳转到对应 reference 调用推荐命令，如 zsxq-cli topic +create、zsxq-cli topic +reply。
• 探索模式：都不命中时，通过 references/cli-exploration.md 查 CLI 帮助和 API 列表发现未封装能力。

一个关键纪律是：执行原子操作和场景时，不预先跑无关的 doctor、--help 或 api list，只在能力不匹配或调用失败时才回退探索模式，避免无谓开销。

覆盖的能力面包括：

• 星球管理：group +list / +topics / +hashtags 列出星球、浏览主题、查看标签；search_groups、search_group_members 做关键词检索。
• 主题管理：全文搜索、详情读取、发帖、编辑、评论/楼中楼回复、回答提问；通过 set_topic_digested、set_topic_tags 做精华与标签治理；原始 HTTP 调用支持删除主题、读写所属专栏。
• 用户与笔记：user +info、+footprints 查资料和跨星球发帖足迹；note +create / +list / +edit / +delete 管理公开笔记。
• 内容产出场景：运营日报/周报/复盘、生成日报海报 PNG、把帖子转成竖版动画视频 MP4、负面内容监控、按标签批量打标、把主题收录进专栏。

边界与注意点

这套技能有几个必须提前知道的约束：

• 笔记是公开内容。任何拿到链接的人都能访问，别把隐私或敏感信息写进 note。
• 写入和删除操作前必须向用户确认。发帖、编辑、评论、回答、设精华、打标签、删主题、提交 NPS 反馈等，都要确认意图后再执行；api raw 写入不得绕过这一约束。
• 不确定 ID 先查再写。group_id、topic_id、comment_id、note_id 没确认前不要直接写，先用查询命令拿到准确值。
• 专栏归属是全量替换。设置主题所属专栏时 column_ids 会覆盖原有归属，「加入某专栏」必须先读现有集合再合并回设，不能直接追加。
• search_group_members 不是成员列表接口，它只按昵称定位具体成员，别指望调大 limit 遍历全员。
• 认证 token 不输出、不传播，token 是登录凭证，不在终端明文显示也不分享给他人。
• 技能默认 zsxq-cli 已安装且已登录，认证异常时参考 references/auth-errors.md 按需处理。