> 首次使用或遇到认证错误（401 / token 过期 / not logged in）时，先读 ../zsxq-shared/SKILL.md 了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。
group_id（纯数字）唯一标识。用户可以是创建者（owner）或成员（member）。topic_id 唯一标识。hashtag_id 标识，可附加到主题上。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 列表
Shortcut 是对常用操作的高级封装（zsxq-cli group +）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
| ---------- | ------ |
+list | 列出当前用户加入或创建的所有星球，输出 group_id 和名称表格 |
+topics | 列出星球内最新主题，支持分页游标，输出 topic_id / 类型 / 标题 / 时间表格 |
+hashtags | 列出星球内所有标签及主题数量 |
zsxq-cli api call 直接调用）Shortcut 未覆盖的高级操作：
| 工具 | 参数 | 说明 |
|---|---|---|
| ------ | ------ | ------ |
search_groups | keyword | 按关键词搜索星球 |
search_group_members | group_id, keyword, limit | 搜索星球成员 |
get_hashtag_topics | hashtag_id, limit, end_time | 列出某标签下的主题（分页） |
共 3 个版本