How to install zsxq-group
npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-groupFull instructions (SKILL.md)
Source of truth, from unnoo/zsxq-skill.
name: zsxq-group version: 1.3.2 description: "知识星球（星球）管理：列出星球、浏览主题、查询标签、搜索成员。当用户需要查看自己加入或创建的星球、浏览星球内容、获取 group_id、查询星球标签或成员时使用。" metadata: requires: bins: ["zsxq-cli"] cliHelp: "zsxq-cli group --help"
group
首次使用或遇到认证错误（401 / token 过期 /
not logged in）时，先读../zsxq-shared/SKILL.md了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。
Core Concepts
- 星球（Group）：知识星球的社群单元，由
group_id（纯数字）唯一标识。用户可以是创建者（owner）或成员（member）。 - 主题（Topic）：星球内的内容单元，包括帖子（talk）、提问（q&a）、作业（task）、作业答案（solution）等，由
topic_id唯一标识。 - 标签（Hashtag）：星球内的分类标签，由
hashtag_id标识，可附加到主题上。
Resource Relationships
Group (group_id)
├── Topic (topic_id) — talk / q&a / task / solution
│ ├── Comment (comment_id)
│ │ └── 楼中楼 Reply (replied_comment_id)
│ ├── Answer（q&a 类型专属）
│ └── Hashtag 标签
└── Hashtag (hashtag_id)
└── Topic 列表
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（zsxq-cli group +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+list | 列出当前用户加入或创建的所有星球，输出 group_id 和名称表格 |
+topics | 列出星球内最新主题，支持分页游标，输出 topic_id / 类型 / 标题 / 时间表格 |
+hashtags | 列出星球内所有标签及主题数量 |
API（通过 zsxq-cli api call 直接调用）
Shortcut 未覆盖的高级操作：
| 工具 | 参数 | 说明 |
|---|---|---|
search_groups | keyword | 按关键词搜索星球 |
search_group_members | group_id, keyword, limit | 搜索星球成员 |
get_hashtag_topics | hashtag_id, limit, end_time | 列出某标签下的主题（分页） |
反例（不要做）
| ❌ 不要做 | ✅ 应该做 |
|---|---|
按关键词找内容时用 +topics 翻页逐条人工筛选 | 用 zsxq-topic 的 +search 全文搜索 |
查「自己最近发过什么」时逐个星球跑 +topics | 用 zsxq-user 的 +footprints 一次拿到跨星球足迹 |
| 用户只给星球名称时，让用户自己提供 group_id 或凭记忆猜 ID | 先 group +list（自己加入的）或 search_groups（公开搜索）查到 ID 再继续 |
| 名称命中多个相似星球时默认取第一个 | 列出候选（group_id + 名称）让用户确认 |
把 search_group_members 当成员列表接口、调大 limit 遍历全员 | 它是关键词搜索，只用于按昵称定位具体成员 |
Related skills
More from unnoo/zsxq-skill and the wider catalog.
zsxq-shared
知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作的安全规则、常见错误码处理（401 token 过期、缺参数等）。当用户首次登录、退出登录、查看认证状态、调用 zsxq-cli api raw / api call、需要拼接知识星球分享链接，或遇到认证或 HTTP 错误时使用。
zsxq-topic
知识星球主题管理：搜索主题、查看主题详情、发布帖子、编辑主题、发表评论、回复某条评论（楼中楼）、回答提问、删除主题；通过 api call 查看主题评论列表、设置精华、设置标签、查看自己提的问题与已回答记录。当用户需要查找内容、发帖、编辑主题、评论、回复评论、回答问题、删除主题、查看主题评论、查看自己的提问记录、或管理主题精华和标签时使用。
zsxq-note
知识星球公开笔记管理：创建笔记、编辑笔记、查看笔记详情、查看笔记列表、删除笔记。当用户需要在知识星球创建可分享的公开笔记、编辑笔记、查看笔记详情、删除笔记、或查看历史笔记时使用。注意：笔记是公开内容，任何持有链接的人都可访问。
zsxq-user
知识星球用户信息与反馈：查看当前登录用户的个人资料、查询跨星球的最近发主题足迹、提交 NPS 反馈（推荐分数 + 建议）。当用户需要查看自己的用户 ID、昵称、头像、认证状态，查看自己最近在各星球发过的主题，或向知识星球官方提交 NPS 评分/产品建议时使用。