name: zsxq-group version: 1.3.0 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）、文章（article）等，由 topic_id 唯一标识。
• 标签（Hashtag）：星球内的分类标签，由 hashtag_id 标识，可附加到主题上。

Resource Relationships

Group (group_id)
├── Topic (topic_id) — talk / q&a / article
│   ├── Comment (comment_id)
│   │   └── 楼中楼 Reply (replied_comment_id)
│   ├── Answer（q&a 类型专属）
│   └── Hashtag 标签
└── Hashtag (hashtag_id)
    └── Topic 列表

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（zsxq-cli group +<verb> [flags]）。有 Shortcut 的操作优先使用。

API（通过 zsxq-cli api call 直接调用）

Shortcut 未覆盖的高级操作：