Back to Details

zsxq-group

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

group (v1)

group (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 
../zsxq-shared/SKILL.md
，其中包含认证、错误处理规则。
CRITICAL — MUST read 
../zsxq-shared/SKILL.md
 first before starting, which contains authentication and error handling rules.

Core Concepts

Core Concepts

  • 星球（Group）：知识星球的社群单元，由 
    group_id
    （纯数字）唯一标识。用户可以是创建者（owner）或成员（member）。
  • 主题（Topic）：星球内的内容单元，包括帖子（talk）、提问（q&a）、文章（article）等，由 
    topic_id
    唯一标识。
  • 标签（Hashtag）：星球内的分类标签，由 
    hashtag_id
    标识，可附加到主题上。
  • Group: The community unit of Knowledge Planet, uniquely identified by 
    group_id
    (pure numbers). Users can be owners or members.
  • Topic: The content unit within a group, including talks, Q&As, articles, etc., uniquely identified by 
    topic_id
    .
  • Hashtag: The classification tag within a group, identified by 
    hashtag_id
    , which can be attached to topics.

Resource Relationships

Resource Relationships

Group (group_id)
├── Topic (topic_id) — talk / q&a / article
│   ├── Comment (comment_id)
│   └── Hashtag 标签
└── Hashtag (hashtag_id)
    └── Topic 列表
Group (group_id)
├── Topic (topic_id) — talk / q&a / article
│   ├── Comment (comment_id)
│   └── Hashtag (Tag)
└── Hashtag (hashtag_id)
    └── Topic List

Shortcuts（推荐优先使用）

Shortcuts (Recommended for Priority Use)

Shortcut 是对常用操作的高级封装（
zsxq-cli group +<verb> [flags]
）。有 Shortcut 的操作优先使用。
Shortcut说明
+list
列出当前用户加入的所有星球，支持分页，输出 group_id 和名称表格
+topics
列出星球内最新主题，支持分页游标，输出 topic_id / 类型 / 标题 / 时间表格
+hashtags
列出星球内所有标签及主题数量
Shortcuts are advanced encapsulations of common operations (
zsxq-cli group +<verb> [flags]
). Use shortcut-supported operations first.
ShortcutDescription
+list
List all groups the current user has joined, supports pagination, outputs a table of group_id and names
+topics
List the latest topics in a group, supports pagination cursors, outputs a table of topic_id / type / title / time
+hashtags
List all hashtags in a group and the number of topics

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

API (Directly called via 
zsxq-cli api call
)

bash
zsxq-cli api list                           # 查看所有可用工具
zsxq-cli api call <tool> --params '<json>'  # 调用工具
Shortcut 未覆盖的高级操作：
工具参数说明
search_groups
keyword
按关键词搜索星球
search_group_members
group_id
, 
keyword
, 
limit
搜索星球成员
get_hashtag_topics
hashtag_id
, 
limit
, 
end_time
列出某标签下的主题（分页）
bash
zsxq-cli api list                           # View all available tools
zsxq-cli api call <tool> --params '<json>'  # Call a tool
Advanced operations not covered by Shortcuts:
ToolParametersDescription
search_groups
keyword
Search groups by keyword
search_group_members
group_id
, 
keyword
, 
limit
Search group members
get_hashtag_topics
hashtag_id
, 
limit
, 
end_time
List topics under a specific hashtag (pagination)