zsxq
Installation
SKILL.md
知识星球操作指南(CLI / MCP 双通道)
本 Skill 覆盖通过 zsxq-cli(CLI 通道)或底层接口工具 call_zsxq_api(MCP 通道)操作知识星球的所有场景:认证、星球管理、主题管理、用户信息、笔记管理,以及 Skill Pay 微信支付。
默认假设 zsxq-cli 已安装且已登录,无需每次主动检查。只在命令执行报错时才按需处理(见
references/auth-errors.md)。
本 Skill 所有示例中的 ID、订单号、支付码等标识均为模拟数据,不对应真实资源。执行操作时必须通过查询结果或用户输入取得并核对真实标识,不得直接复用示例值。
执行通道
本 Skill 的所有能力有两条执行通道,先判定通道再路由:
- 宿主可执行
zsxq-cli→ CLI 通道(优先;shortcut 有参数校验与本地编排,行为最可控) - 否则宿主工具列表中存在
call_zsxq_api→ MCP 通道 - 两者都没有 → 停止并提醒用户:安装 CLI(见
references/auth-errors.md)或在宿主中接入知识星球 MCP(密钥管理页创建 api-key 后复制链接接入),由用户选择
- 通道判定是一次性环境探测;选定后一致使用,不混用。仅当某操作标注「仅 CLI 通道」/「仅 MCP 通道」时,对该操作单独切换或告知用户。
- MCP 通道下所有调用都通过底层接口工具
call_zsxq_api(参数{method, path, query?, body?});不得臆造未文档化的 method/path——能力底表见references/endpoint-catalog.md,未覆盖即视为不支持。 - 「执行模式」路由(场景 → 原子 → 探索)在两条通道下相同;通道只决定各 reference「## 命令」节使用哪一组调用块。