前言¶
如果你在维护一个知识星球，会遇到两类重复劳动：一类是登录后在网页上点帖子、回评论、打标签、做巡场；另一类是想把这些动作写进脚本或 Agent 流程里，却找不到稳定可用的接口说明。前者靠人肉，后者靠猜接口。
这个 Skill 属于第二类问题的直接解法：它把知识星球 CLI（zsxq-cli）和底层接口的操作方式整理成一份可被 Agent 读取的操作指南，覆盖星球与内容管理，也覆盖 Skill Pay 微信支付场景。
定位与来源¶
- Skill 名称：【官方】知识星球·星球助手
- 坐标：@zsxq/zsxq
- 版本：2.2.1
- 来源：enterprise，发布者「知识星球」
- 分类：business-ops
- 官方地址：https://api.skillhub.cn/zsxq/zsxq
- SkillHub 页面：https://www.skillhub.cn/skills/zsxq/zsxq
发布者是知识星球本身，来源标记为 enterprise。这意味着接口行为以官方口径为准，而不是社区维护的逆向文档。
核心能力¶
官方简介把能力分成三块：星球与内容管理、Skill Pay 微信支付、以及旧版 Skill 的迁移清理。下面按这三块展开，只列资料中出现过的能力点。
1、星球与内容管理¶
- 登录与认证状态查看
- 主题的查看、搜索、发布、编辑、删除
- 评论、回答、回复评论
- 定时发布、定时任务、定时回答
- 投票、问答主题、付费提问
- markdown 正文、AI 声明（aigc / personal_perspective）
- 置顶、精华、标签 / hashtag
- 成员列表、成员到期时间、足迹、提问记录
- 星球设置：名称、简介、背景图、亮点图
- 分享链接拼接、分享链接获取
- 专栏 column 列表、收录主题到专栏
运营侧的动作也被明确列出：每日巡场、评论区运营、提问管理、精华与标签整理、运营日报周报复盘、生成星球日报海报图片、生成竖版动画视频、负面内容监控、批量打标签、到期成员续费关怀。
2、Skill Pay 微信支付场景¶
- 查询星球价格、续费价格、轻读价格
- 付费加入、续费 / 续期
- 礼品卡
- 赞赏用户 / 主题 / 评论
- 购买轻读
- 购买创建星球邀请码
- 创建订单
3、底层接口直调¶
- 直接调用底层接口，官方列出的形态是 api call、api raw、call_zsxq_api
- 关键标识符：group_id、topic_id、comment_id
这一层是给需要精细控制参数的场景用的，前面两层的托管操作最终也会落到这些标识符上。
4、旧版 Skill 检查、迁移、清理¶
官方简介明确覆盖 zsxq-shared、zsxq-group 等旧版 skill 升级到单一 zsxq 的流程。也就是从多包结构迁移到单一 zsxq skill。
安装与启用¶
已抓取资料中未提供具体的安装命令、目录路径或配置文件字段。可以确认的信息如下：
- 发布形式：Skill，按通用 SKILL.md 格式组织
- 标识坐标：@zsxq/zsxq
- 版本：2.2.1
- 是否需要 API Key：标签标记为 requires_api_key=false
requires_api_key=false 这个标记值得注意：它表示该 Skill 不要求自行配置 API Key，认证状态由登录流程负责。
安装与启用的具体命令请以官方地址 https://api.skillhub.cn/zsxq/zsxq 和 SkillHub 页面 https://www.skillhub.cn/skills/zsxq/zsxq 为准。本文写作时这两个页面未能成功抓取，因此不在此给出推测命令。
触发方式¶
官方简介给出了明确的触发口径：用户提到下列关键词时应当使用本 Skill，即使只涉及单一操作也应触发。这些关键词可以看作一份能力清单。
- 平台与本体词：知识星球、zsxq、小密圈、星球
- 认证类：登录、认证状态
- 内容动作类：发帖、评论、回答、编辑、删除主题、投票、问答主题、置顶、精华、标签 / hashtag
- 排期类：定时发布、定时任务、定时回答
- 正文与声明类：markdown 正文、AI 声明（aigc / personal_perspective）
- 成员类：成员、足迹、提问记录
- 支付类：Skill Pay、微信支付、付费加入、续费、续期、礼品卡、付费提问、赞赏、购买轻读、购买创建星球邀请码、创建订单
- 价格类：星球价格、续费价格、轻读价格
- 标识符类：group_id、topic_id、comment_id
- 运营类：每日巡场、评论区运营、提问管理、精华与标签整理、运营日报周报复盘、星球日报海报图片、竖版动画视频、负面内容监控、批量打标签、到期成员续费关怀、收录主题到专栏、分享链接
- 接口类：api call、api raw、call_zsxq_api
- 迁移类：zsxq-shared、zsxq-group
关键的一点是最后那句：即使只涉及单一操作（如获取 group_id、查看帖子详情、回复评论），也应触发。这避免了「任务看起来太小所以跳过 Skill」导致的接口误用。
适用场景¶
适合的人大致是三类。
- 知识星球运营者：需要把巡场、评论区维护、标签整理、续费关怀做成固定流程，而不是每天手动点。
- 要把星球动作接入 Agent 或脚本的开发者：需要一个明确的接口与字段说明，而不是自行摸索。
- 正在从旧版 skill 迁移的人：手上有 zsxq-shared、zsxq-group 等历史包，需要检查和清理。
注意与限制¶
- 发布者为企业方，接口与字段以官方口径为准，遇到行为差异优先对照官方页面。
- Skill 覆盖的是操作指南层面，不包含第三方插件或社区扩展。
- 定时发布、定时任务、定时回答涉及服务端排期，行为取决于知识星球侧的支持情况。
- Skill Pay 与微信支付相关的操作会真实产生订单与支付行为，做批量操作前需要确认当前登录身份对应的星球和权限。
- 旧版迁移前先做检查，确认当前环境里还有哪些旧包在生效，再动手清理。
结尾¶
这个 Skill 的价值在于把知识星球 CLI（zsxq-cli）和底层接口的完整操作方式固化成一份指南，让运营动作和接口调用走同一套口径，也顺带覆盖了 Skill Pay 微信支付场景和旧版 skill 的迁移。对于已经在用或打算用 Agent 处理知识星球事务的人来说，它是目前能拿到的官方操作入口。
官方地址：https://api.skillhub.cn/zsxq/zsxq
SkillHub 页面：https://www.skillhub.cn/skills/zsxq/zsxq
