知识星球官方出品，由知识星球团队开发和维护 — 让 AI 成为你在知识星球的超级助理。

安装 ·能做什么 ·技能·认证 ·命令 ·安全

为什么选 zsxq-skill？

• 官方出品 — 由知识星球团队开发和维护，能力与平台同步更新
• 权限可控 — 仅访问你有权限查看的星球内容，不越权
• 多端适配 — 支持 OpenClaw、Claude、Cursor 等常见 AI 工具
• 快速上手 — 安装简单，配置完成后即可开始使用
• 安全可控 — 采用 OAuth 2.0 授权，Token 存储在系统 Keychain，写入操作前需确认

能做什么

安装并登录后，你可以通过对话直接让 AI 帮你完成知识星球里的常见操作。

核心能力

• 星球管理：列出已加入的星球，搜索星球，查看标签、成员和专栏
• 内容搜索：按关键词搜索星球里的帖子、文章和提问
• 主题查看：查看主题详情、评论、点赞和标签信息
• 发布互动：发布主题、编辑主题、评论回复、回答提问
• 精华与标签：设置/取消精华，为主题打标签，管理专栏收录
• 个人笔记：创建、编辑、查看、删除笔记
• 账号信息：查看个人资料、发帖足迹、提交 NPS 反馈
• 场景编排：多步骤运营场景（每日巡场、评论运营、日报周报、海报/视频生成等）

典型使用场景

• 看看我加入了哪些星球
• 搜索某个星球里的 AI / Python / 投资相关内容
• 查看某条主题的完整内容和评论互动
• 帮我发一条新主题，或回复这条评论
• 回答一个提问类主题
• 给主题设置标签、设为精华，或收录到专栏
• 记一条个人笔记，稍后再整理
• 查看我的账号信息和历史发帖足迹

场景化运营（一句话触发多步骤编排）：

• 「每日巡场」— 自动汇总今天新内容、待处理提问和评论
• 「整理评论区问题给我回复」— 找出未回复评论并起草回复
• 「做本周运营周报」— 统计新增/活跃/精华，生成结构化周报
• 「生成星球日报海报」— 把内容精选做成 PNG 海报图片
• 「把帖子做成视频」— 把星球内容转成竖版动画视频

适合谁用

• 知识星球的星主：用 AI 快速回复提问、整理精华、管理主题标签
• 开发者：基于 zsxq-cli 和 MCP 能力构建自动化流程

---

安装与快速开始

给 AI 助手的注意： 如果你是 AI Agent 且正在协助用户执行安装，请直接跳转到快速开始（AI Agent），那里包含你需要完成的所有步骤。

快速开始（人类用户）

第一步：安装 CLI

zsxq-skill

知识星球官方出品，由知识星球团队开发和维护 — 让 AI 成为你在知识星球的超级助理。

安装 · 能做什么 · Skills · 认证 · 命令 · 安全

为什么选 zsxq-skill？

• 官方出品 — 由知识星球团队开发和维护，能力与平台同步更新
• 权限可控 — 仅访问你有权限查看的星球内容，不越权
• 多端适配 — 支持 OpenClaw、Claude、Cursor 等常见 AI 工具
• 快速上手 — 安装简单，配置完成后即可开始使用
• 安全可控 — 采用 OAuth 2.0 授权，Token 存储在系统 Keychain，写入操作前需确认

能做什么

安装并登录后，你可以通过对话直接让 AI 帮你完成知识星球里的常见操作。

核心能力

• 星球管理：列出已加入的星球，搜索星球，查看标签、成员和专栏
• 内容搜索：按关键词搜索星球里的帖子、文章和提问
• 主题查看：查看主题详情、评论、点赞和标签信息
• 发布互动：发布主题、编辑主题、评论回复、回答提问
• 精华与标签：设置/取消精华，为主题打标签，管理专栏收录
• 个人笔记：创建、编辑、查看、删除笔记
• 账号信息：查看个人资料、发帖足迹、提交 NPS 反馈
• 场景编排：多步骤运营场景（每日巡场、评论运营、日报周报、海报/视频生成等）

典型使用场景

• 看看我加入了哪些星球
• 搜索某个星球里的 AI / Python / 投资相关内容
• 查看某条主题的完整内容和评论互动
• 帮我发一条新主题，或回复这条评论
• 回答一个提问类主题
• 给主题设置标签、设为精华，或收录到专栏
• 记一条个人笔记，稍后再整理
• 查看我的账号信息和历史发帖足迹

场景化运营（一句话触发多步骤编排）：

• 「每日巡场」— 自动汇总今天新内容、待处理提问和评论
• 「整理评论区问题给我回复」— 找出未回复评论并起草回复
• 「做本周运营周报」— 统计新增/活跃/精华，生成结构化周报
• 「生成星球日报海报」— 把内容精选做成 PNG 海报图片
• 「把帖子做成视频」— 把星球内容转成竖版动画视频

适合谁用

• 知识星球的星主：用 AI 快速回复提问、整理精华、管理主题标签
• 开发者：基于 zsxq-cli 和 MCP 能力构建自动化流程

---

安装与快速开始

Note for AI assistants: 如果你是 AI Agent 且正在协助用户执行安装，请直接跳转到快速开始（AI Agent），那里包含你需要完成的所有步骤。

快速开始（人类用户）

第一步：安装 CLI

npm install -g zsxq-cli

第二步：安装 Skill

npx skills add https://github.com/unnoo/zsxq-skill --yes

第三步：登录账号

zsxq-cli auth login

命令会输出一个链接和验证码，用手机或浏览器打开链接完成授权即可。

方式二：接入 MCP（免安装 CLI）

1. 打开知识星球密钥管理页，创建密钥
2. 复制含 api-key 的 MCP 链接
3. 用页面提供的「Add to Codex / Claude / Cursor」按钮一键接入，或把链接手动添加到宿主的 MCP 配置
4. 安装 Skill（同方式一第 2 步）

接入后 AI 会通过 MCP 通道操作知识星球；本机同时装有 zsxq-cli 时优先走 CLI 通道。

快速开始（AI Agent）

以下步骤面向 AI Agent，部分步骤需要用户在手机或浏览器中配合完成。

第 1 步 — 安装 CLI

npm install -g zsxq-cli

第 2 步 — 安装 Skill

npx skills add https://github.com/unnoo/zsxq-skill --yes

第 3 步 — 登录

在后台运行此命令，命令会输出授权链接和验证码，提取后发给用户，等待用户完成授权后命令自动退出。

zsxq-cli auth login

第 4 步 — 验证

zsxq-cli auth status

---

Agent Skills

只需安装一个 zsxq Skill，即可获得全部能力：

所有能力支持 CLI / MCP 双通道，Skill 自动判定：本机有 zsxq-cli 走 CLI，否则走 MCP 的 call_zsxq_api。

Skill 内部按三层路由执行：场景模式（命中场景 → 按编排执行）→ 原子操作（命中已知命令 → 直接调用）→ 探索模式（未命中 → 通过 CLI 发现能力）。所有命令细节和参数均由 28 个 reference 文档独立承载，SKILL.md 只负责路由和索引。

从旧版（zsxq-shared / zsxq-group / zsxq-topic / zsxq-user / zsxq-note 五件套）升级的用户，安装新版后直接对 AI 说「检查并迁移旧版知识星球 skill」，AI 会先扫描报告、经你确认后再清理。

---

功能详情