/zsxq

name: zsxq
description: "知识星球 CLI（zsxq-cli）与底层接口完整操作指南，涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI 声明（aigc/personal_perspective）、置顶、精华、标签/hashtag、成员、足迹、提问记录、分享链接、NPS 反馈、Skill Pay、微信支付、查询星球价格/续费价格/轻读价格、付费加入、续费/续期、礼品卡、付费提问、赞赏用户/主题/评论、购买轻读、购买创建星球邀请码、创建订单、group_id、topic_id、comment_id，需要登录/查看认证状态、查看/搜索/发布/编辑/管理知识星球内容、做星球AI搜索总结 / 按相关度总结搜索结果 / 搜不到时列出最贴近的主题、修改星球名称/简介/背景图/亮点图（星球设置）、做每日巡场 / 评论区运营 / 提问管理 / 精华与标签整理 / 运营日报周报复盘 / 生成星球日报海报图片 / 生成竖版动画视频 / 负面内容监控 / 批量打标签 / 到期成员续费关怀 / 收录主题到专栏等运营场景、拼接分享链接、直接调用底层接口（api call / api raw / call_zsxq_api）、知识星球 MCP 接入 / api-key、查成员列表 / 成员到期时间 / 专栏 column 列表，或询问知识星球产品规则与常见问题（退款条件 / 退款要多久 / 手续费多少 / 费率是多少 / 提现多久到账 / 怎么开发票 / 企业认证要什么材料 / 分享有赏比例 / 为什么审核不通过 / 为什么打不开 / 违规封禁规则 / 用户协议隐私政策等，读官方帮助中心 doc.zsxq.com 后回答），或需要检查/迁移/清理旧版知识星球 skill（zsxq-shared、zsxq-group 等升级到单一 zsxq）时，必须使用本 Skill。即使只涉及单一操作（如获取 group_id、查看帖子详情、回复评论），也应触发"
metadata:
  version: "3.0.0"
  channels: "cli（zsxq-cli，优先）/ mcp（call_zsxq_api，兜底）"
  cliHelp: "zsxq-cli --help"

知识星球操作指南（CLI / MCP 双通道）

本 Skill 覆盖通过 zsxq-cli（CLI 通道）或底层接口工具 call_zsxq_api（MCP 通道）操作知识星球的所有场景：认证、星球管理、主题管理、用户信息、笔记管理，以及 Skill Pay 微信支付。

> **默认假设 zsxq-cli 已安装且已登录**，无需每次主动检查。只在命令执行报错时才按需处理（见 [`references/auth-errors.md`](references/auth-errors.md)）。

> 本 Skill 所有示例中的 ID、订单号、支付码等标识均为模拟数据，不对应真实资源。执行操作时必须通过查询结果或用户输入取得并核对真实标识，不得直接复用示例值。

执行通道

本 Skill 的所有能力有两条执行通道，先判定通道再路由：

1. 宿主可执行 `zsxq-cli` → **CLI 通道**（优先；shortcut 有参数校验与本地编排，行为最可控） 2. 否则宿主工具列表中存在 `call_zsxq_api` → **MCP 通道** 3. 两者都没有 → 停止并提醒用户：安装 CLI（见 [`references/auth-errors.md`](references/auth-errors.md)）或在宿主中接入知识星球 MCP（密钥管理页创建 api-key 后复制链接接入），由用户选择

• 通道判定是一次性环境探测；选定后一致使用，不混用。仅当某操作标注「仅 CLI 通道」/「仅 MCP 通道」时，对该操作单独切换或告知用户。
• MCP 通道下所有调用都通过底层接口工具 `call_zsxq_api`（参数 `{method, path, query?, body?}`）；**不得臆造未文档化的 method/path**——能力底表见 [`references/endpoint-catalog.md`](references/endpoint-catalog.md)，未覆盖即视为不支持。
• 「执行模式」路由（场景 → 原子 → 探索）在两条通道下相同；通道只决定各 reference「## 命令」节使用哪一组调用块。

执行模式

按以下顺序路由用户请求，命中即执行，不再往下走：

1. **场景模式** — 请求命中[已注册场景](#场景scenarios)：读场景入口文档，按流程编排原子操作 2. **原子操作** — 请求明确对应一个常用操作：读对应 reference，直接调用推荐命令 3. **探索模式** — 都未命中：按 [`references/cli-exploration.md`](references/cli-exploration.md) 通过 CLI 帮助和 API 列表发现能力

> 原子操作和场景执行时**不得**预先运行无关的 `doctor`、`--help` 或 `api list`。仅在能力不匹配或调用失败时回退到探索模式。

快速索引

根据用户意图，直接跳转到对应小节或 reference：

| 用户想要… | 去哪看 | |----------|--------| | 登录 / 查看登录状态 / 排查认证或 HTTP 错误 | → [`references/auth-errors.md`](references/auth-errors.md) | | 每日巡场：查今天需要关注/处理的新内容 | → [`scenarios/daily-patrol.md`](references/scenarios/daily-patrol.md) | | 整理评论区、找未回复评论并起草回复 | → [`scenarios/triage-comments.md`](references/scenarios/triage-comments.md) | | 处理别人向我提的、还没回答的问题 | → [`scenarios/manage-inbound-questions.md`](references/scenarios/manage-inbound-questions.md) | | 整理精华与标签（加精 / 打标签建议） | → [`scenarios/curate-digest-and-tags.md`](references/scenarios/curate-digest-and-tags.md) | | 生成运营日报 / 周报 / 复盘 | → [`scenarios/compose-operations-report.md`](references/scenarios/compose-operations-report.md) | | 把星球内容做成日报海报图片（PNG） | → [`scenarios/generate-daily-poster.md`](references/scenarios/generate-daily-poster.md) | | 把星球帖子做成竖版动画视频（MP4） | → [`scenarios/generate-video.md`](references/scenarios/generate-video.md) | | 巡查监控负面 / 风险内容 | → [`scenarios/monitor-risky-content.md`](references/scenarios/monitor-risky-content.md) | | 按给定标签批量给主题打标 | → [`scenarios/batch-tag-topics.md`](references/scenarios/batch-tag-topics.md) | | 到期成员续费关怀（识别即将到期成员、分层写话术） | → [`scenarios/care-expiring-members.md`](references/scenarios/care-expiring-members.md) | | 把最新主题批量收录进专栏 | → [`scenarios/archive-topics-to-column.md`](references/scenarios/archive-topics-to-column.md) | | 问产品规则/功能/常见问题（退款、费率、开票、认证、审核、封禁…） | → [`references/scenarios/answer-product-docs.md`](references/scenarios/answer-product-docs.md) | | 检查/迁移/清理旧版 zsxq skill | → [`references/scenarios/migrate-legacy-skills.md`](references/scenarios/migrate-legacy-skills.md) | | 使用 Skill Pay 付费加入 / 续期 / 购买 / 付费提问 / 赞赏 | → [`references/scenarios/purchase-with-skill-pay.md`](references/scenarios/purchase-with-skill-pay.md) | | 创建知识星球微信订单 / 处理支付挑战与安全恢复 | → [`references/wechat-order-create.md`](references/wechat-order-create.md) | | 查询加入、礼品卡、续费、轻读或星球邀请码价格 | → [`references/wechat-order-create.md#下单前查询价格`](references/wechat-order-create.md#下单前查询价格) | | 直接调底层 API / 探索未封装能力 | → [`references/cli-exploration.md`](references/cli-exploration.md) | | 拼接知识星球分享链接 | → [`references/share-links.md`](references/share-links.md) | | 了解安全规则（写入/删除确认） | → [安全规则](#安全规则) | | 列出我加入的星球 / 获取 group_id | → [`references/group-list.md`](references/group-list.md) | | 修改星球名称 / 简介 / 背景图 / 亮点图 | → [`references/group-settings.md`](references/group-settings.md) | | 浏览星球内最新主题 | → [`references/group-topics.md`](references/group-topics.md) | | 查看星球标签 | → [`references/group-hashtags.md`](references/group-hashtags.md) | | 在星球内搜索内容 | → [`references/topic-search.md`](references/topic-search.md) | | 把星球内搜索结果做成 AI 总结 | → [`scenarios/summarize-search-results.md`](references/scenarios/summarize-search-results.md) | | 查看帖子详情 | → [`references/topic-detail.md`](references/topic-detail.md) | | 发帖（普通 / 投票 / 提问 / markdown / AI 声明） | → [`references/topic-create.md`](references/topic-create.md) | | 编辑帖子 | → [`references/topic-edit.md`](references/topic-edit.md) | | 评论 / 楼中楼回复 | → [`references/topic-reply.md`](references/topic-reply.md) | | 回答提问（立即 / 定时 / 静默） | → [`references/topic-answer.md`](references/topic-answer.md) | | 删除主题 | → [`references/topic-delete.md`](references/topic-delete.md) | | 定时发布主题 / 修改或取消定时任务 | → [`references/topic-schedule.md`](references/topic-schedule.md) | | 查看待执行的定时任务与配额 | → [`references/topic-scheduled.md`](references/topic-scheduled.md) | | 设为精华 / 置顶（星主） | → [`references/topic-set.md`](references/topic-set.md) | | 取消精华（底层接口 api call） | → [`references/topic-digest.md`](references/topic-digest.md) | | 给主题设置标签 | → [`references/topic-tags.md`](references/topic-tags.md) | | 读取 / 设置主题所属专栏（收录到专栏） | → [`references/topic-attac