用途:该技能面向知识星球(星球)管理,帮助用户查看自己加入或创建的星球、浏览星球内容、获取 group_id、查询星球标签或搜索星成员。首次使用或遇到认证错误(401 / token 过期 / not logged in)时,应先阅读 ../zsxq-shared/SKILL.md 了解登录与 API 调用约定;日常调用已登录账户无需每次重读。
核心概念:星球(Group)由 group_id(纯数字)唯一标识,用户可为创建者或成员;主题(Topic)包括 talk、q&a、task、solution 等,由 topic_id 标识;标签(Hashtag)由 hashtag_id 标识,可附加到主题。层级关系为 Group 下含 Topic(Topic 下含 Comment、楼中楼 Reply、q&a 专属 Answer、Hashtag)与 Hashtag(下含 Topic 列表)。
主要能力:推荐优先使用 Shortcut(zsxq-cli group +<verb> [flags])。+list 列出当前用户加入或创建的所有星球,输出 group_id 和名称;+topics 列出星球内最新主题,支持分页游标,输出 topic_id / 类型 / 标题 / 时间;+hashtags 列出星球内所有标签及主题数量。Shortcut 未覆盖的高级操作可通过 zsxq-cli api call 调用:search_groups(keyword)按关键词搜索星球;search_group_members(group_id, keyword, limit)搜索星球成员;get_hashtag_topics(hashtag_id, limit, end_time)列出某标签下主题(分页)。
使用建议与限制:按关键词找内容时不要用 +topics 翻页人工筛选,应使用 zsxq-topic 的 +search 全文搜索;查自己最近发过什么可用 zsxq-user 的 +footprints 一次拿到跨星球足迹。用户只给星球名称时,应先 group +list 或 search_groups 查到 ID;名称命中多个相似星球时列出候选让用户确认。search_group_members 是关键词搜索,只用于按昵称定位具体成员,不应调大 limit 遍历全员。具体安装与认证细节暂未提供。