group (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取
../zsxq-shared/SKILL.md
,其中包含认证、错误处理规则。
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)
│ └── Hashtag 标签
└── Hashtag (hashtag_id)
└── Topic 列表
Shortcuts(推荐优先使用)
Shortcut 是对常用操作的高级封装(
zsxq-cli group +
查看所有可用工具
zsxq-cli api call < tool
--params '
'
调用工具
Shortcut 未覆盖的高级操作: 工具 参数 说明 search_groups keyword 按关键词搜索星球 search_group_members group_id , keyword , limit 搜索星球成员 get_hashtag_topics hashtag_id , limit , end_time 列出某标签下的主题(分页)