zsxq

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

zsxq-cli 完整操作指南

Complete Operation Guide for zsxq-cli

本 Skill 覆盖通过 zsxq-cli 操作知识星球的所有场景:认证、星球管理、主题管理、用户信息、笔记管理。
默认假设 zsxq-cli 已安装且已登录,无需每次主动检查。只在命令执行报错时才按需处理(见
references/auth-errors.md
)。
This Skill covers all scenarios of operating Zsxq (Knowledge Planet) via zsxq-cli: authentication, group management, topic management, user information, note management.
Default assumption: zsxq-cli is installed and logged in; no need to check proactively every time. Handle on-demand only when command execution errors occur (see
references/auth-errors.md
).

执行模式

Execution Mode

按以下顺序路由用户请求,命中即执行,不再往下走:
  1. 场景模式 — 请求命中已注册场景:读场景入口文档,按流程编排原子操作
  2. 原子操作 — 请求明确对应一个常用操作:读对应 reference,直接调用推荐命令
  3. 探索模式 — 都未命中:按
    references/cli-exploration.md
    通过 CLI 帮助和 API 列表发现能力
原子操作和场景执行时不得预先运行无关的
doctor
--help
api list
。仅在能力不匹配或调用失败时回退到探索模式。
Route user requests in the following order; execute immediately when a match is found and stop proceeding further:
  1. Scenario Mode — Request matches registered scenarios: Read scenario entry documents and orchestrate atomic operations according to the process
  2. Atomic Operation Mode — Request clearly corresponds to a common operation: Read the corresponding reference and directly call the recommended command
  3. Exploration Mode — No matches found: Discover capabilities via CLI help and API list according to
    references/cli-exploration.md
Do not pre-run irrelevant
doctor
,
--help
or
api list
during atomic operation or scenario execution. Fall back to Exploration Mode only when capabilities do not match or calls fail.

快速索引

Quick Index

根据用户意图,直接跳转到对应小节或 reference:
用户想要…去哪看
登录 / 查看登录状态 / 排查认证或 HTTP 错误
references/auth-errors.md
每日巡场:查今天需要关注/处理的新内容
scenarios/daily-patrol.md
整理评论区、找未回复评论并起草回复
scenarios/triage-comments.md
处理别人向我提的、还没回答的问题
scenarios/manage-inbound-questions.md
整理精华与标签(加精 / 打标签建议)
scenarios/curate-digest-and-tags.md
生成运营日报 / 周报 / 复盘
scenarios/compose-operations-report.md
把星球内容做成日报海报图片(PNG)
scenarios/generate-daily-poster.md
把星球帖子做成竖版动画视频(MP4)
scenarios/generate-video.md
巡查监控负面 / 风险内容
scenarios/monitor-risky-content.md
按给定标签批量给主题打标
scenarios/batch-tag-topics.md
到期成员续费关怀(识别即将到期成员、分层写话术)
scenarios/care-expiring-members.md
把最新主题批量收录进专栏
scenarios/archive-topics-to-column.md
检查/迁移/清理旧版 zsxq skill
references/scenarios/migrate-legacy-skills.md
直接调底层 API / 探索未封装能力
references/cli-exploration.md
拼接知识星球分享链接
references/share-links.md
了解安全规则(写入/删除确认)安全规则
列出我加入的星球 / 获取 group_id
references/group-list.md
浏览星球内最新主题
references/group-topics.md
查看星球标签
references/group-hashtags.md
在星球内搜索内容
references/topic-search.md
查看帖子详情
references/topic-detail.md
发帖
references/topic-create.md
编辑帖子
references/topic-edit.md
评论 / 楼中楼回复
references/topic-reply.md
回答提问
references/topic-answer.md
删除主题
references/topic-delete.md
设为精华 / 取消精华(星主)
references/topic-digest.md
给主题设置标签
references/topic-tags.md
读取 / 设置主题所属专栏(收录到专栏)
references/topic-attached-columns.md
查看自己的用户信息
references/user-info.md
查看自己发过的帖子(跨星球)
references/user-footprints.md
提交 NPS 反馈
references/user-nps.md
创建/查看/编辑/删除笔记
references/note-create.md
写入前需要确认哪些事项→ 对应 reference 的
> [!CAUTION]
块 + 安全规则
Jump directly to the corresponding section or reference based on user intent:
User wants to…Go to
Login / Check login status / Troubleshoot authentication or HTTP errors
references/auth-errors.md
Daily patrol: Check new content that needs attention/handling today
scenarios/daily-patrol.md
Organize comment sections, find unreplied comments and draft replies
scenarios/triage-comments.md
Handle unanswered questions asked to me
scenarios/manage-inbound-questions.md
Organize digests and tags (suggestions for marking as digest / tagging)
scenarios/curate-digest-and-tags.md
Generate operation daily/weekly reports / reviews
scenarios/compose-operations-report.md
Make Zsxq content into daily poster images (PNG)
scenarios/generate-daily-poster.md
Make Zsxq posts into vertical animated videos (MP4)
scenarios/generate-video.md
Inspect and monitor negative / risky content
scenarios/monitor-risky-content.md
Batch tag topics with given tags
scenarios/batch-tag-topics.md
Renewal care for expiring members (identify expiring members, tiered message drafting)
scenarios/care-expiring-members.md
Batch archive latest topics to columns
scenarios/archive-topics-to-column.md
Check/migrate/clean up legacy zsxq skills
references/scenarios/migrate-legacy-skills.md
Directly call underlying APIs / explore unencapsulated capabilities
references/cli-exploration.md
Splice Zsxq share links
references/share-links.md
Understand security rules (confirmation for write/delete)Security Rules
List joined Groups / get group_id
references/group-list.md
Browse latest topics in a Group
references/group-topics.md
View Group tags
references/group-hashtags.md
Search content in a Group
references/topic-search.md
View post details
references/topic-detail.md
Post a topic
references/topic-create.md
Edit a post
references/topic-edit.md
Comment / nested reply
references/topic-reply.md
Answer a question
references/topic-answer.md
Delete a topic
references/topic-delete.md
Mark as digest / cancel digest (Group owner)
references/topic-digest.md
Set tags for a topic
references/topic-tags.md
Read / set columns attached to a topic (archive to columns)
references/topic-attached-columns.md
View own user information
references/user-info.md
View own posts across Groups
references/user-footprints.md
Submit NPS feedback
references/user-nps.md
Create/view/edit/delete notes
references/note-create.md
etc.
Matters needing confirmation before writing
> [!CAUTION]
blocks in corresponding references + Security Rules

资源关系

Resource Relationships

User (user_id) — 已登录账户
├── Group (group_id) — 星球/社群
│   ├── Topic (topic_id) — talk / q&a / task / solution
│   │   ├── Comment (comment_id)
│   │   │   └── 楼中楼 Reply (replied_comment_id)
│   │   ├── Answer — q&a 类型专属
│   │   └── Hashtag 标签
│   └── Hashtag (hashtag_id)
│       └── Topic 列表
└── Note (note_id) — 公开笔记,不属于任何星球
User (user_id) — Logged-in account
├── Group (group_id) — Zsxq community
│   ├── Topic (topic_id) — talk / q&a / task / solution
│   │   ├── Comment (comment_id)
│   │   │   └── Nested Reply (replied_comment_id)
│   │   ├── Answer — Exclusive to q&a type
│   │   └── Hashtag
│   └── Hashtag (hashtag_id)
│       └── Topic list
└── Note (note_id) — Public note, not belonging to any Group

核心概念

Core Concepts

  • 星球(Group):知识星球的社群单元,由
    group_id
    (纯数字)唯一标识。用户可以是创建者或成员。
  • 主题(Topic):星球内的内容单元,类型:
    talk
    (帖子)、
    q&a
    (提问)、
    task
    (作业)、
    solution
    (作业答案)。
  • 笔记(Note):独立于星球的内容单元,公开可见,任何持有链接的人都能访问 —— 不是私密备忘录。
  • 评论(Comment):主题下的回复,支持楼中楼(
    replied_comment_id
    )。
  • 精华(Digested):星主可将优质主题设为精华。
  • Group: The community unit of Zsxq, uniquely identified by
    group_id
    (numeric only). Users can be creators or members.
  • Topic: The content unit within a Group, types:
    talk
    (post),
    q&a
    (question),
    task
    (assignment),
    solution
    (assignment answer).
  • Note: A content unit independent of Groups, publicly visible, accessible to anyone with the link — not a private memo.
  • Comment: Replies under a Topic, supporting nested replies (
    replied_comment_id
    ).
  • Digested: Group owners can mark high-quality Topics as digested.

安全规则

Security Rules

  • 禁止输出或传播认证 token —— token 是登录凭证,不在终端明文输出,不分享给他人
  • 写入/删除操作前必须确认用户意图(发帖、编辑、评论、回答、创建笔记、删除主题或笔记、提交 NPS 反馈等)
  • 不确定
    group_id
    /
    topic_id
    /
    comment_id
    /
    note_id
    时,先用查询命令确认,再执行写入或删除
  • 笔记是公开内容,任何持有链接的人均可访问 —— 涉及隐私或敏感信息不要写进笔记
  • api raw
    写入不得绕过原子操作的安全约束;探索模式发现的写入接口同样需要用户确认
  • 各写入/删除 reference 的
    > [!CAUTION]
    块列出该操作特有的确认项
  • Forbid outputting or spreading authentication tokens — Tokens are login credentials; do not output them in plain text in the terminal or share them with others
  • Must confirm user intent before write/delete operations (posting, editing, commenting, answering, creating notes, deleting topics or notes, submitting NPS feedback, etc.)
  • When unsure about
    group_id
    /
    topic_id
    /
    comment_id
    /
    note_id
    , use query commands to confirm first before executing write or delete operations
  • Notes are public content, accessible to anyone with the link — do not include privacy or sensitive information in notes
  • api raw
    write operations must not bypass security constraints of atomic operations; write interfaces discovered in Exploration Mode also require user confirmation
  • > [!CAUTION]
    blocks in each write/delete reference list specific confirmation items for that operation

场景(Scenarios)

Scenarios

场景表达业务目标,由多个原子操作编排而成。SKILL.md 只链接场景入口,流程细节见入口文档。
场景触发语入口
每日巡场「每日巡场 / 巡检星球」「看看今天有什么要处理的」
scenarios/daily-patrol.md
评论区运营「整理评论区问题给我回复」「找出没回复的评论、起草回复」
scenarios/triage-comments.md
提问管理「找出别人向我提问但我还没回答的」「按优先级整理待回答提问」
scenarios/manage-inbound-questions.md
精华与标签整理「整理最近主题,该加精加精、该打标签打标签」「哪些帖子值得设精华」
scenarios/curate-digest-and-tags.md
运营日报 / 周报 / 复盘「做今天的运营日报」「做本周运营周报」「复盘过去 7 天运营」
scenarios/compose-operations-report.md
生成星球日报海报「生成星球日报海报 / 做张日报图」「把最近内容做成一张海报发群里」
scenarios/generate-daily-poster.md
生成竖版动画视频「帮我把这篇帖子做成视频」「找最近适合做视频的帖子」「生成本周视频」「把星球内容做成视频」
scenarios/generate-video.md
负面内容监控「巡查 / 监控星球风险内容」「每小时查辱骂 / 广告 / 投诉」
scenarios/monitor-risky-content.md
自动打标签「用给定标签给最近主题批量打标」「批量回标历史内容」
scenarios/batch-tag-topics.md
到期成员续费关怀「查即将到期的成员」「做续费关怀 / 续费提醒」「按活跃度给到期成员写话术」
scenarios/care-expiring-members.md
收录主题到专栏「把最新 N 条主题收录进专栏 XX」「批量把主题归档到专栏 / 整理专题合集」
scenarios/archive-topics-to-column.md
迁移旧版 skill「检查/清理/迁移旧版知识星球 skill」「升级 zsxq skill」
scenarios/migrate-legacy-skills.md
Scenarios express business goals, orchestrated from multiple atomic operations. SKILL.md only links to scenario entries; process details are in the entry documents.
ScenarioTrigger PhrasesEntry
Daily Patrol
Daily patrol / inspect the Group
See what needs to be handled today
scenarios/daily-patrol.md
Comment Section Operation
Organize comment section questions for me to reply
Find unreplied comments and draft replies
scenarios/triage-comments.md
Question Management
Find unanswered questions asked to me
Organize pending questions by priority
scenarios/manage-inbound-questions.md
Digest and Tag Organization
Organize recent topics, mark as digest and add tags as needed
Which posts are worth marking as digest
scenarios/curate-digest-and-tags.md
Operation Daily/Weekly Report & Review
Create today's operation daily report
Create this week's operation weekly report
Review the past 7 days of operations
scenarios/compose-operations-report.md
Generate Zsxq Daily Poster
Generate Zsxq daily poster / make a daily report image
Make recent content into a poster to share in groups
scenarios/generate-daily-poster.md
Generate Vertical Animated Video
Help me make this post into a video
Find recent posts suitable for video creation
Generate this week's video
Make Zsxq content into videos
scenarios/generate-video.md
Negative Content Monitoring
Inspect / monitor risky content in the Group
Check for insults / ads / complaints every hour
scenarios/monitor-risky-content.md
Batch Tagging
Batch tag recent topics with given tags
Batch tag historical content
scenarios/batch-tag-topics.md
Expiring Member Renewal Care
Check expiring members
Do renewal care / reminders
Write tiered messages for expiring members based on activity
scenarios/care-expiring-members.md
Archive Topics to Columns
Archive the latest N topics to Column XX
Batch archive topics to columns / organize thematic collections
scenarios/archive-topics-to-column.md
Migrate Legacy Skills
Check/clean/migrate legacy Zsxq Skills
Upgrade zsxq Skill
scenarios/migrate-legacy-skills.md

星球管理(group)

Group Management

Shortcut说明Reference
zsxq-cli group +list
列出加入/创建的星球,获取 group_id
group-list.md
zsxq-cli group +topics
浏览星球最新主题(分页)
group-topics.md
zsxq-cli group +hashtags
列出星球标签及主题数
group-hashtags.md
API(
zsxq-cli api call
):
工具参数说明
search_groups
keyword
按关键词搜索星球
search_group_members
group_id
,
keyword
,
limit
搜索星球成员
get_hashtag_topics
hashtag_id
,
limit
,
end_time
列出某标签下的主题(分页)
原始 HTTP 调用:
操作命令模板Reference
成员列表
api raw --method GET --path /v2/groups/<group_id>/members --query '<json>'
group-members.md
专栏列表
api raw --method GET --path /v2/groups/<group_id>/columns
group-columns.md
创建专栏
api raw --method POST --path /v2/groups/<group_id>/columns --body '{"name":"…"}'
⚠️
group-column-create.md
成员列表的
expired_time
仅付费星球星主/管理员可见。主题的专栏归属为主题维度操作,见主题管理的原始 HTTP 调用。
ShortcutDescriptionReference
zsxq-cli group +list
List joined/created Groups, get group_id
group-list.md
zsxq-cli group +topics
Browse latest topics in a Group (pagination)
group-topics.md
zsxq-cli group +hashtags
List Group tags and topic counts
group-hashtags.md
API (
zsxq-cli api call
):
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 tag (pagination)
Raw HTTP Calls:
OperationCommand TemplateReference
Member List
api raw --method GET --path /v2/groups/<group_id>/members --query '<json>'
group-members.md
Column List
api raw --method GET --path /v2/groups/<group_id>/columns
group-columns.md
Create Column
api raw --method POST --path /v2/groups/<group_id>/columns --body '{"name":"…"}'
⚠️
group-column-create.md
expired_time
in member lists is only visible to Group owners/administrators of paid Groups. Column attribution of topics is a topic-level operation, see raw HTTP calls in Topic Management.

反例(不要做)

Anti-Patterns (Do Not Do)

❌ 不要做✅ 应该做
按关键词找内容时用
+topics
翻页逐条人工筛选
topic +search
全文搜索
查「自己最近发过什么」时逐个星球跑
+topics
user +footprints
一次拿到跨星球足迹
用户只给星球名称时,让用户自己提供 group_id
group +list
search_groups
查到 ID 再继续
名称命中多个相似星球时默认取第一个列出候选(group_id + 名称)让用户确认
search_group_members
当成员列表接口、调大
limit
遍历全员
它是关键词搜索,只用于按昵称定位具体成员
❌ Do Not✅ Do
Manually paginate with
+topics
to filter content by keyword
Use
topic +search
for full-text search
Run
+topics
in each Group to check "what I've posted recently"
Use
user +footprints
to get cross-Group footprints at once
Ask users to provide group_id when only given Group nameFirst find the ID via
group +list
or
search_groups
before proceeding
Default to the first match when multiple similar Groups hit the nameList candidates (group_id + name) for user confirmation
Treat
search_group_members
as a member list interface and increase
limit
to traverse all members
It is a keyword search, only used to locate specific members by nickname

主题管理(topic)

Topic Management

Shortcut说明Reference
zsxq-cli topic +search
在星球内全文搜索主题
topic-search.md
zsxq-cli topic +detail
获取主题完整详情
topic-detail.md
zsxq-cli topic +create
发布新帖子(talk)⚠️
topic-create.md
zsxq-cli topic +edit
编辑自己的帖子 ⚠️
topic-edit.md
zsxq-cli topic +reply
评论 / 楼中楼回复 ⚠️
topic-reply.md
zsxq-cli topic +answer
回答提问 ⚠️
topic-answer.md
⚠️ = 写入操作,执行前必须向用户确认内容。
API(
zsxq-cli api call
):
工具参数说明Reference
get_topic_comments
topic_id
,
limit
,
index
获取主题评论列表(分页)
set_topic_digested
topic_id
,
digested
设置/取消精华(星主权限)⚠️
topic-digest.md
set_topic_tags
topic_id
,
titles
为主题设置标签(titles 为完整标签集合)⚠️
topic-tags.md
get_self_question_topics
topic_filter
,
count
,
end_time
查看自己发起的提问
get_self_answer_topics
topic_filter
unanswered
/
answered
),
count
,
end_time
查看别人向我发起的提问(账号级,返回项带
group
字段,需按星球过滤)
⚠️ = 写入操作(
set_topic_digested
/
set_topic_tags
会修改星球内容),执行前必须向用户确认,并遵守安全规则与对应 reference 的
> [!CAUTION]
块。
原始 HTTP 调用:
操作命令模板Reference
删除主题
api raw --method DELETE --path /v2/topics/<topic_id>
⚠️
topic-delete.md
读取主题所属专栏
api raw --method GET --path /v2/topics/<topic_id>/attached_columns
topic-attached-columns.md
设置主题所属专栏
api raw --method POST --path /v2/topics/<topic_id>/attached_columns --body '{"column_ids":[...]}'
⚠️
topic-attached-columns.md
⚠️ = 写入操作,执行前必须向用户确认。设置主题所属专栏为全量替换
column_ids
会覆盖该主题原有专栏归属,「加入某专栏」须先读现有集合再并入回设,详见
topic-attached-columns.md
ShortcutDescriptionReference
zsxq-cli topic +search
Full-text search for topics in a Group
topic-search.md
zsxq-cli topic +detail
Get complete topic details
topic-detail.md
zsxq-cli topic +create
Publish a new post (talk) ⚠️
topic-create.md
zsxq-cli topic +edit
Edit own posts ⚠️
topic-edit.md
zsxq-cli topic +reply
Comment / nested reply ⚠️
topic-reply.md
zsxq-cli topic +answer
Answer questions ⚠️
topic-answer.md
⚠️ = Write operation; must confirm content with user before execution.
API (
zsxq-cli api call
):
ToolParametersDescriptionReference
get_topic_comments
topic_id
,
limit
,
index
Get topic comment list (pagination)
set_topic_digested
topic_id
,
digested
Set/cancel digest (Group owner permission) ⚠️
topic-digest.md
set_topic_tags
topic_id
,
titles
Set tags for a topic (titles are the complete tag set) ⚠️
topic-tags.md
get_self_question_topics
topic_filter
,
count
,
end_time
View questions initiated by myself
get_self_answer_topics
topic_filter
(
unanswered
/
answered
),
count
,
end_time
View questions asked to me (account-level, returns include
group
field, need to filter by Group)
⚠️ = Write operations (
set_topic_digested
/
set_topic_tags
modify Group content); must confirm with user before execution and comply with Security Rules and
> [!CAUTION]
blocks in corresponding references.
Raw HTTP Calls:
OperationCommand TemplateReference
Delete Topic
api raw --method DELETE --path /v2/topics/<topic_id>
⚠️
topic-delete.md
Read Columns Attached to Topic
api raw --method GET --path /v2/topics/<topic_id>/attached_columns
topic-attached-columns.md
Set Columns Attached to Topic
api raw --method POST --path /v2/topics/<topic_id>/attached_columns --body '{"column_ids":[...]}'
⚠️
topic-attached-columns.md
⚠️ = Write operation; must confirm with user before execution. Setting columns attached to a topic is a full replacement:
column_ids
will overwrite the topic's existing column attribution. To "add to a column", first read the existing set, merge the new column, then set it back, see
topic-attached-columns.md
for details.

用户信息(user)

User Information

Shortcut说明Reference
zsxq-cli user +info
查看当前用户资料(user_id、昵称等)
user-info.md
zsxq-cli user +footprints
查看跨星球发帖足迹
user-footprints.md
zsxq-cli user +nps
提交 NPS 反馈 ⚠️
user-nps.md
用户使用过程中表达产品不满、发现平台缺能力或多次重试受挫时,完成主任务后可顺带提示提交 NPS 反馈,触发细则见
user-nps.md
ShortcutDescriptionReference
zsxq-cli user +info
View current user profile (user_id, nickname, etc.)
user-info.md
zsxq-cli user +footprints
View cross-Group post footprints
user-footprints.md
zsxq-cli user +nps
Submit NPS feedback ⚠️
user-nps.md
When users express dissatisfaction with the product, find missing capabilities, or encounter repeated failures during use, after completing the main task, you can prompt them to submit NPS feedback. Trigger rules are in
user-nps.md
.

笔记管理(note)

Note Management

笔记是公开内容,任何持有链接的人都能访问 —— 涉及隐私或敏感信息不要写进笔记。
Shortcut说明Reference
zsxq-cli note +create
创建公开笔记 ⚠️
note-create.md
zsxq-cli note +list
查看笔记列表
note-list.md
zsxq-cli note +detail
查看笔记详情
note-detail.md
zsxq-cli note +edit
编辑笔记 ⚠️
note-edit.md
zsxq-cli note +delete
删除笔记(不可恢复)⚠️
note-delete.md
Notes are public content, accessible to anyone with the link — do not include privacy or sensitive information in notes.
ShortcutDescriptionReference
zsxq-cli note +create
Create public note ⚠️
note-create.md
zsxq-cli note +list
View note list
note-list.md
zsxq-cli note +detail
View note details
note-detail.md
zsxq-cli note +edit
Edit note ⚠️
note-edit.md
zsxq-cli note +delete
Delete note (irreversible) ⚠️
note-delete.md