需要操作知识星球内容、认证、运营或 Skill Pay…

适用于通过 zsxq-cli 或 call_zsxq_api 对知识星球进行认证、星球/主题/评论/成员/专栏/笔记管理、运营场景编排、产品规则查询及 Skill Pay 微信支付。

适用场景

解决思路

1. 默认假设 zsxq-cli 已安装且已登录，无需每次主动检查；只在命令执行报错时才按需处理登录/认证/HTTP 错误，见 references/auth-errors.md。
2. 执行通道判定：宿主可执行 zsxq-cli 时选 CLI 通道，优先使用，因为 shortcut 有参数校验与本地编排，行为最可控。
3. 否则若宿主工具列表中存在 call_zsxq_api，则选 MCP 通道。
4. 两者都没有时，停止并提醒用户：安装 CLI（见 references/auth-errors.md）或在宿主中接入知识星球 MCP（密钥管理页创建 api-key 后复制链接接入），由用户选择。
5. 通道判定是一次性环境探测；选定后一致使用，不混用；仅当某操作标注「仅 CLI 通道」/「仅 MCP 通道」时，对该操作单独切换或告知用户。
6. MCP 通道下所有调用都通过底层接口工具 call_zsxq_api（参数 {method, path, query?, body?}）；不得臆造未文档化的 method/path，能力底表见 references/endpoint-catalog.md，未覆盖即视为不支持。
7. 执行模式路由：请求命中已注册场景时进入场景模式，读场景入口文档，按流程编排原子操作。
8. 请求明确对应一个常用操作时进入原子操作，读对应 reference，直接调用推荐命令。
9. 都未命中时进入探索模式，按 references/cli-exploration.md 通过 CLI 帮助和 API 列表发现能力。
10. 原子操作和场景执行时不得预先运行无关的 doctor、--help 或 api list；仅在能力不匹配或调用失败时回退到探索模式。
11. 按快速索引路由：登录/查看登录状态/排查认证或 HTTP 错误，去 references/auth-errors.md。
12. 按快速索引路由：每日巡场，查今天需要关注/处理的新内容，去 references/scenarios/daily-patrol.md。
13. 按快速索引路由：整理评论区、找未回复评论并起草回复，去 references/scenarios/triage-comments.md。
14. 按快速索引路由：处理别人向我提的、还没回答的问题，去 references/scenarios/manage-inbound-questions.md。
15. 按快速索引路由：整理精华与标签（加精/打标签建议），去 references/scenarios/curate-digest-and-tags.md。
16. 按快速索引路由：生成运营日报/周报/复盘，去 references/scenarios/compose-operations-report.md。
17. 按快速索引路由：把星球内容做成日报海报图片（PNG），去 references/scenarios/generate-daily-poster.md。
18. 按快速索引路由：把星球帖子做成竖版动画视频（MP4），去 references/scenarios/generate-video.md。
19. 按快速索引路由：巡查监控负面/风险内容，去 references/scenarios/monitor-risky-content.md。
20. 按快速索引路由：按给定标签批量给主题打标，去 references/scenarios/batch-tag-topics.md。
21. 按快速索引路由：到期成员续费关怀（识别即将到期成员、分层写话术），去 references/scenarios/care-expiring-members.md。
22. 按快速索引路由：把最新主题批量收录进专栏，去 references/scenarios/archive-topics-to-column.md。
23. 按快速索引路由：问产品规则/功能/常见问题（退款、费率、开票、认证、审核、封禁等），去 references/scenarios/answer-product-docs.md。
24. 按快速索引路由：检查/迁移/清理旧版 zsxq skill，去 references/scenarios/migrate-legacy-skills.md。
25. 按快速索引路由：使用 Skill Pay 付费加入/续期/购买/付费提问/赞赏，去 references/scenarios/purchase-with-skill-pay.md。
26. 按快速索引路由：创建知识星球微信订单/处理支付挑战与安全恢复，去 references/wechat-order-create.md。
27. 按快速索引路由：查询加入、礼品卡、续费、轻读或星球邀请码价格，去 references/wechat-order-create.md#下单前查询价格。
28. 按快速索引路由：直接调底层 API/探索未封装能力，去 references/cli-exploration.md。
29. 按快速索引路由：拼接知识星球分享链接，去 references/share-links.md。
30. 按快速索引路由：了解安全规则（写入/删除确认），去「安全规则」小节。
31. 按快速索引路由：列出我加入的星球/获取 group_id，去 references/group-list.md。
32. 按快速索引路由：修改星球名称/简介/背景图/亮点图，去 references/group-settings.md。
33. 按快速索引路由：浏览星球内最新主题，去 references/group-topics.md。
34. 按快速索引路由：查看星球标签，去 references/group-hashtags.md。
35. 按快速索引路由：在星球内搜索内容，去 references/topic-search.md。
36. 按快速索引路由：查看帖子详情，去 references/topic-detail.md。
37. 按快速索引路由：发帖（普通/投票/提问/markdown/AI 声明），去 references/topic-create.md。
38. 按快速索引路由：编辑帖子，去 references/topic-edit.md。
39. 按快速索引路由：评论/楼中楼回复，去 references/topic-reply.md。
40. 按快速索引路由：回答提问（立即/定时/静默），去 references/topic-answer.md。
41. 按快速索引路由：删除主题，去 references/topic-delete.md。
42. 按快速索引路由：定时发布主题/修改或取消定时任务，去 references/topic-schedule.md。
43. 按快速索引路由：查看待执行的定时任务与配额，去 references/topic-scheduled.md。
44. 按快速索引路由：设为精华/置顶（星主），去 references/topic-set.md。
45. 按快速索引路由：取消精华（底层接口 api call），去 references/topic-digest.md。
46. 按快速索引路由：给主题设置标签，去 references/topic-tags.md。
47. 按快速索引路由：读取/设置主题所属专栏（收录到专栏），去 references/topic-attached-columns.md。
48. 按快速索引路由：查看自己的用户信息，去 references/user-info.md。
49. 按快速索引路由：查看自己发过的帖子（跨星球），去 references/user-footprints.md。
50. 按快速索引路由：提交 NPS 反馈，去 references/user-nps.md。
51. 按快速索引路由：创建/查看/编辑/删除笔记，去 references/note-create.md 等对应 reference。
52. 按快速索引路由：写入前需要确认哪些事项，去对应 reference 的 > [!CAUTION] 块 +「安全规则」小节。
53. 资源关系：User(user_id) 下含 Group(group_id)、Note(note_id)；Group 含 Topic(topic_id)、Scheduled Job(job_id)、Hashtag(hashtag_id)；Topic 含 Comment(comment_id)、楼中楼 Reply(replied_comment_id)、Answer、Hashtag；Note 是公开笔记，不属于任何星球。
54. 核心概念：星球（Group）由 group_id（纯数字）唯一标识，用户可以是创建者或成员。
55. 核心概念：主题（Topic）类型有 talk（帖子）、q&a（提问）、task（作业）、solution（作业答案）。
56. 核心概念：笔记（Note）独立于星球，公开可见，任何持有链接的人都能访问，不是私密备忘录。
57. 核心概念：评论（Comment）是主题下的回复，支持楼中楼（replied_comment_id）。
58. 核心概念：精华（Digested）/置顶（Sticky）需有管理权限（星主/管理员/合伙人）才能设置，改变主题在星球内展示。
59. 核心概念：定时任务（Scheduled Job）可将主题或回答定时在未来某个时间点自动发布，14 天窗口内，每星球上限 10 个。
60. 安全规则：禁止输出或传播认证 token；token 是登录凭证，不在终端明文输出，不分享给他人。
61. 安全规则：写入/删除操作前必须确认用户意图，包括发帖、编辑、评论、回答、定时发布、设置精华/置顶、修改星球资料、创建笔记、删除主题或笔记、取消定时任务、提交 NPS 反馈等。
62. 安全规则：Skill Pay 仅支持 WorkBuddy 且宿主必须提供官方 weixinpay_pay；任一条件不满足时，必须在创建订单前说明不支持并停止，不得调用 call_zsxq_api 创建订单。
63. 安全规则：创建订单前必须按原子 reference 查询或计算价格，并确认类型、对象与实际应付金额；固定价格不得由用户改写，支付必须由用户本人授权；PAYMENT_REQUIRED 即使返回 success: false 也只表示待支付，不代表失败或支付成功，禁止自动重试创建订单。
64. 安全规则：不确定 group_id/topic_id/comment_id/note_id 时，先用查询命令确认，再执行写入或删除。
65. 安全规则：笔记是公开内容，任何持有链接的人均可访问；涉及隐私或敏感信息不要写进笔记。
66. 安全规则：api raw 写入不得绕过原子操作的安全约束；探索模式发现的写入接口同样需要用户确认。
67. 安全规则：各写入/删除 reference 的 > [!CAUTION] 块列出该操作特有的确认项。
68. 安全规则：通道选定后一致使用不混用；MCP 通道不得臆造未在 reference 或 endpoint-catalog 中文档化的 method/path。
69. 所有示例中的 ID、订单号、支付码等标识均为模拟数据，不对应真实资源；执行操作时必须通过查询结果或用户输入取得并核对真实标识，不得直接复用示例值。
70. 场景：每日巡场，触发语「每日巡场/巡检星球」「看看今天有什么要处理的」，读 references/scenarios/daily-patrol.md，按流程编排原子操作。
71. 场景：评论区运营，触发语「整理评论区问题给我回复」「找出没回复的评论、起草回复」，读 references/scenarios/triage-comments.md，按流程编排原子操作。
72. 场景：提问管理，触发语「找出别人向我提问但我还没回答的」「按优先级整理待回答提问」，读 references/scenarios/manage-inbound-questions.md，按流程编排原子操作。
73. 场景：精华与标签整理，触发语「整理最近主题，该加精加精、该打标签打标签」「哪些帖子值得设精华」，读 references/scenarios/curate-digest-and-tags.md，按流程编排原子操作。
74. 场景：运营日报/周报/复盘，触发语「做今天的运营日报」「做本周运营周报」「复盘过去 7 天运营」，读 references/scenarios/compose-operations-report.md，按流程编排原子操作。
75. 场景：生成星球日报海报，触发语「生成星球日报海报/做张日报图」「把最近内容做成一张海报发群里」，读 references/scenarios/generate-daily-poster.md，按流程编排原子操作。
76. 场景：生成竖版动画视频，触发语「帮我把这篇帖子做成视频」「找最近适合做视频的帖子」「生成本周视频」「把星球内容做成视频」，读 references/scenarios/generate-video.md，按流程编排原子操作。
77. 场景：负面内容监控，触发语「巡查/监控星球风险内容」「每小时查辱骂/广告/投诉」，读 references/scenarios/monitor-risky-content.md，按流程编排原子操作。
78. 场景：自动打标签，触发语「用给定标签给最近主题批量打标」「批量回标历史内容」，读 references/scenarios/batch-tag-topics.md，按流程编排原子操作。
79. 场景：到期成员续费关怀，触发语「查即将到期的成员」「做续费关怀/续费提醒」「按活跃度给到期成员写话术」，读 references/scenarios/care-expiring-members.md，按流程编排原子操作。
80. 场景：收录主题到专栏，触发语「把最新 N 条主题收录进专栏 XX」「批量把主题归档到专栏/整理专题合集」，读 references/scenarios/archive-topics-to-column.md，按流程编排原子操作。
81. 场景：迁移旧版 skill，触发语「检查/清理/迁移旧版知识星球 skill」「升级 zsxq skill」，读 references/scenarios/migrate-legacy-skills.md，按流程编排原子操作。
82. 场景：Skill Pay 购买，触发语「用 Skill Pay/微信支付加入或续期」「购买礼品卡/轻读」「付费提问/赞赏」，读 references/scenarios/purchase-with-skill-pay.md，按流程编排原子操作。
83. 场景：回答产品文档问题，触发语「星球怎么退款/退款要多久」「手续费多少/费率是多少」「怎么开票/企业认证要什么材料」「为什么审核不通过/违规封禁规则」，读 references/scenarios/answer-product-docs.md，按流程编排原子操作。
84. Skill Pay：处理 Skill Pay 购买意图时，读取 references/scenarios/purchase-with-skill-pay.md 进行编排。
85. Skill Pay：创建订单、价格、支付授权和安全恢复的参数与错误语义只以 references/wechat-order-create.md 为准。
86. 星球管理：用 zsxq-cli group +list 列出加入/创建的星球，获取 group_id。
87. 星球管理：用 zsxq-cli group +topics 浏览星球最新主题（分页）。
88. 星球管理：用 zsxq-cli group +hashtags 列出星球标签及主题数。
89. 星球管理：用 zsxq-cli group +settings 修改星球名称/简介/背景图/亮点图，写入前必须确认。
90. 星球管理：用 zsxq-cli api call search_groups --keyword 按关键词搜索星球。
91. 星球管理：用 zsxq-cli api call search_group_members --group_id --keyword --limit 搜索星球成员。
92. 星球管理：用 zsxq-cli api call get_hashtag_topics --hashtag_id --limit --end_time 列出某标签下的主题（分页）。
93. 星球管理：用 api raw --method GET --path /v2/groups/<group_id>/members --query '<json>' 获取成员列表。
94. 星球管理：用 api raw --method GET --path /v2/groups/<group_id>/columns 获取专栏列表。
95. 星球管理：用 api raw --method POST --path /v2/groups/<group_id>/columns --body '{"name":"…"}' 创建专栏，写入前必须确认。
96. 星球管理反例：按关键词找内容时不要用 +topics 翻页逐条人工筛选，应使用 topic +search 全文搜索。
97. 星球管理反例：查「自己最近发过什么」时不要逐个星球跑 +topics，应使用 user +footprints 一次拿到跨星球足迹。
98. 星球管理反例：用户只给星球名称时，不要让用户自己提供 group_id，应先 group +list 或 search_groups 查到 ID 再继续。
99. 星球管理反例：名称命中多个相似星球时不要默认取第一个，应列出候选（group_id + 名称）让用户确认。
100. 星球管理反例：不要把 search_group_members 当成员列表接口、调大 limit 遍历全员；它是关键词搜索，只用于按昵称定位具体成员。
101. 主题管理：用 zsxq-cli topic +search 在星球内全文搜索主题。
102. 主题管理：用 zsxq-cli topic +detail 获取主题完整详情。
103. 主题管理：用 zsxq-cli topic +create 发布新帖子（talk/q&a、投票、AI 声明、markdown），写入前必须确认。
104. 主题管理：用 zsxq-cli topic +edit 编辑自己的帖子（正文/附件/AI 声明/投票），写入前必须确认。
105. 主题管理：用 zsxq-cli topic +reply 评论/楼中楼回复，写入前必须确认。
106. 主题管理：用 zsxq-cli topic +answer 回答提问（支持定时/静默），写入前必须确认。
107. 主题管理：用 zsxq-cli topic +set 设置精华/置顶，写入前必须确认。
108. 主题管理：用 zsxq-cli topic +schedule 定时发布主题（创建/修改），写入前必须确认。
109. 主题管理：用 zsxq-cli topic +scheduled 查看待执行定时任务与配额。
110. 主题管理：用 zsxq-cli topic +unschedule 取消定时任务，写入前必须确认。
111. 主题管理：用 zsxq-cli api call get_topic_comments --topic_id --limit --index 获取主题评论列表（分页）。
112. 主题管理：用 zsxq-cli api call set_topic_digested --topic_id --digested 设置/取消精华（星主权限），写入前必须确认。
113. 主题管理：用 zsxq-cli api call set_topic_tags --topic_id --titles 为主题设置标签（titles 为完整标签集合），写入前必须确认。
114. 主题管理：用 zsxq-cli api call get_self_question_topics --topic_filter --count --end_time 查看自己发起的提问。
115. 主题管理：用 zsxq-cli api call get_self_answer_topics --topic_filter（unanswered/answered） --count --end_time 查看别人向我发起的提问（账号级，返回项带 group 字段，需按星球过滤）。
116. 主题管理：用 api raw --method DELETE --path /v2/topics/<topic_id> 删除主题，写入前必须确认。
117. 主题管理：用 api raw --method GET --path /v2/topics/<topic_id>/attached_columns 读取主题所属专栏。
118. 主题管理：用 api raw --method POST --path /v2/topics/<topic_id>/attached_columns --body '{"column_ids":[...]}' 设置主题所属专栏，写入前必须确认；该操作会全量替换 column_ids 覆盖原归属，加入某专栏须先读现有集合再并入回设。
119. 用户信息：用 zsxq-cli user +info 查看当前用户资料（user_id、昵称等）。
120. 用户信息：用 zsxq-cli user +footprints 查看跨星球发帖足迹。
121. 用户信息：用 zsxq-cli user +nps 提交 NPS 反馈，写入前必须确认；用户表达产品不满、发现平台缺能力或多次重试受挫时，完成主任务后可顺带提示提交 NPS 反馈，触发细则见 references/user-nps.md#主动触发场景。
122. 笔记管理：用 zsxq-cli note +create 创建公开笔记，写入前必须确认。
123. 笔记管理：用 zsxq-cli note +list 查看笔记列表。
124. 笔记管理：用 zsxq-cli note +detail 查看笔记详情。
125. 笔记管理：用 zsxq-cli note +edit 编辑笔记，写入前必须确认。
126. 笔记管理：用 zsxq-cli note +delete 删除笔记（不可恢复），写入前必须确认。

适用边界 · 注意事项

• 宿主既不能执行 zsxq-cli 也没有 call_zsxq_api 时，不适用；应停止并让用户安装 CLI 或接入 MCP。
• Skill Pay 仅支持 WorkBuddy 且宿主必须提供官方 weixinpay_pay；任一条件不满足时，不适用且不得创建订单。
• 认证 token 不应输出或传播；笔记是公开内容，涉及隐私或敏感信息时不应写进笔记；未确认写入/删除意图或未取得真实 ID 时不应执行相应操作。