zsxq
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesezsxq-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
按以下顺序路由用户请求,命中即执行,不再往下走:
- 场景模式 — 请求命中已注册场景:读场景入口文档,按流程编排原子操作
- 原子操作 — 请求明确对应一个常用操作:读对应 reference,直接调用推荐命令
- 探索模式 — 都未命中:按 通过 CLI 帮助和 API 列表发现能力
references/cli-exploration.md
原子操作和场景执行时不得预先运行无关的、doctor或--help。仅在能力不匹配或调用失败时回退到探索模式。api list
Route user requests in the following order; execute immediately when a match is found and stop proceeding further:
- Scenario Mode — Request matches registered scenarios: Read scenario entry documents and orchestrate atomic operations according to the process
- Atomic Operation Mode — Request clearly corresponds to a common operation: Read the corresponding reference and directly call the recommended command
- Exploration Mode — No matches found: Discover capabilities via CLI help and API list according to
references/cli-exploration.md
Do not pre-run irrelevant,doctoror--helpduring atomic operation or scenario execution. Fall back to Exploration Mode only when capabilities do not match or calls fail.api list
快速索引
Quick Index
根据用户意图,直接跳转到对应小节或 reference:
| 用户想要… | 去哪看 |
|---|---|
| 登录 / 查看登录状态 / 排查认证或 HTTP 错误 | → |
| 每日巡场:查今天需要关注/处理的新内容 | → |
| 整理评论区、找未回复评论并起草回复 | → |
| 处理别人向我提的、还没回答的问题 | → |
| 整理精华与标签(加精 / 打标签建议) | → |
| 生成运营日报 / 周报 / 复盘 | → |
| 把星球内容做成日报海报图片(PNG) | → |
| 把星球帖子做成竖版动画视频(MP4) | → |
| 巡查监控负面 / 风险内容 | → |
| 按给定标签批量给主题打标 | → |
| 到期成员续费关怀(识别即将到期成员、分层写话术) | → |
| 把最新主题批量收录进专栏 | → |
| 检查/迁移/清理旧版 zsxq skill | → |
| 直接调底层 API / 探索未封装能力 | → |
| 拼接知识星球分享链接 | → |
| 了解安全规则(写入/删除确认) | → 安全规则 |
| 列出我加入的星球 / 获取 group_id | → |
| 浏览星球内最新主题 | → |
| 查看星球标签 | → |
| 在星球内搜索内容 | → |
| 查看帖子详情 | → |
| 发帖 | → |
| 编辑帖子 | → |
| 评论 / 楼中楼回复 | → |
| 回答提问 | → |
| 删除主题 | → |
| 设为精华 / 取消精华(星主) | → |
| 给主题设置标签 | → |
| 读取 / 设置主题所属专栏(收录到专栏) | → |
| 查看自己的用户信息 | → |
| 查看自己发过的帖子(跨星球) | → |
| 提交 NPS 反馈 | → |
| 创建/查看/编辑/删除笔记 | → |
| 写入前需要确认哪些事项 | → 对应 reference 的 |
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 | → |
| Daily patrol: Check new content that needs attention/handling today | → |
| Organize comment sections, find unreplied comments and draft replies | → |
| Handle unanswered questions asked to me | → |
| Organize digests and tags (suggestions for marking as digest / tagging) | → |
| Generate operation daily/weekly reports / reviews | → |
| Make Zsxq content into daily poster images (PNG) | → |
| Make Zsxq posts into vertical animated videos (MP4) | → |
| Inspect and monitor negative / risky content | → |
| Batch tag topics with given tags | → |
| Renewal care for expiring members (identify expiring members, tiered message drafting) | → |
| Batch archive latest topics to columns | → |
| Check/migrate/clean up legacy zsxq skills | → |
| Directly call underlying APIs / explore unencapsulated capabilities | → |
| Splice Zsxq share links | → |
| Understand security rules (confirmation for write/delete) | → Security Rules |
| List joined Groups / get group_id | → |
| Browse latest topics in a Group | → |
| View Group tags | → |
| Search content in a Group | → |
| View post details | → |
| Post a topic | → |
| Edit a post | → |
| Comment / nested reply | → |
| Answer a question | → |
| Delete a topic | → |
| Mark as digest / cancel digest (Group owner) | → |
| Set tags for a topic | → |
| Read / set columns attached to a topic (archive to columns) | → |
| View own user information | → |
| View own posts across Groups | → |
| Submit NPS feedback | → |
| Create/view/edit/delete notes | → |
| Matters needing confirmation before writing | → |
资源关系
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 (numeric only). Users can be creators or members.
group_id - Topic: The content unit within a Group, types: (post),
talk(question),q&a(assignment),task(assignment answer).solution - 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, use query commands to confirm first before executing write or delete operationsnote_id - Notes are public content, accessible to anyone with the link — do not include privacy or sensitive information in notes
- write operations must not bypass security constraints of atomic operations; write interfaces discovered in Exploration Mode also require user confirmation
api raw - blocks in each write/delete reference list specific confirmation items for that operation
> [!CAUTION]
场景(Scenarios)
Scenarios
场景表达业务目标,由多个原子操作编排而成。SKILL.md 只链接场景入口,流程细节见入口文档。
| 场景 | 触发语 | 入口 |
|---|---|---|
| 每日巡场 | 「每日巡场 / 巡检星球」「看看今天有什么要处理的」 | |
| 评论区运营 | 「整理评论区问题给我回复」「找出没回复的评论、起草回复」 | |
| 提问管理 | 「找出别人向我提问但我还没回答的」「按优先级整理待回答提问」 | |
| 精华与标签整理 | 「整理最近主题,该加精加精、该打标签打标签」「哪些帖子值得设精华」 | |
| 运营日报 / 周报 / 复盘 | 「做今天的运营日报」「做本周运营周报」「复盘过去 7 天运营」 | |
| 生成星球日报海报 | 「生成星球日报海报 / 做张日报图」「把最近内容做成一张海报发群里」 | |
| 生成竖版动画视频 | 「帮我把这篇帖子做成视频」「找最近适合做视频的帖子」「生成本周视频」「把星球内容做成视频」 | |
| 负面内容监控 | 「巡查 / 监控星球风险内容」「每小时查辱骂 / 广告 / 投诉」 | |
| 自动打标签 | 「用给定标签给最近主题批量打标」「批量回标历史内容」 | |
| 到期成员续费关怀 | 「查即将到期的成员」「做续费关怀 / 续费提醒」「按活跃度给到期成员写话术」 | |
| 收录主题到专栏 | 「把最新 N 条主题收录进专栏 XX」「批量把主题归档到专栏 / 整理专题合集」 | |
| 迁移旧版 skill | 「检查/清理/迁移旧版知识星球 skill」「升级 zsxq skill」 | |
Scenarios express business goals, orchestrated from multiple atomic operations. SKILL.md only links to scenario entries; process details are in the entry documents.
| Scenario | Trigger Phrases | Entry |
|---|---|---|
| Daily Patrol | | |
| Comment Section Operation | | |
| Question Management | | |
| Digest and Tag Organization | | |
| Operation Daily/Weekly Report & Review | | |
| Generate Zsxq Daily Poster | | |
| Generate Vertical Animated Video | | |
| Negative Content Monitoring | | |
| Batch Tagging | | |
| Expiring Member Renewal Care | | |
| Archive Topics to Columns | | |
| Migrate Legacy Skills | | |
星球管理(group)
Group Management
| Shortcut | 说明 | Reference |
|---|---|---|
| 列出加入/创建的星球,获取 group_id | |
| 浏览星球最新主题(分页) | |
| 列出星球标签及主题数 | |
API():
zsxq-cli api call| 工具 | 参数 | 说明 |
|---|---|---|
| | 按关键词搜索星球 |
| | 搜索星球成员 |
| | 列出某标签下的主题(分页) |
原始 HTTP 调用:
| 操作 | 命令模板 | Reference |
|---|---|---|
| 成员列表 | | |
| 专栏列表 | | |
| 创建专栏 | | |
成员列表的仅付费星球星主/管理员可见。主题的专栏归属为主题维度操作,见主题管理的原始 HTTP 调用。expired_time
| Shortcut | Description | Reference |
|---|---|---|
| List joined/created Groups, get group_id | |
| Browse latest topics in a Group (pagination) | |
| List Group tags and topic counts | |
API ():
zsxq-cli api call| Tool | Parameters | Description |
|---|---|---|
| | Search Groups by keyword |
| | Search Group members |
| | List topics under a tag (pagination) |
Raw HTTP Calls:
| Operation | Command Template | Reference |
|---|---|---|
| Member List | | |
| Column List | | |
| Create Column | | |
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.expired_time
反例(不要做)
Anti-Patterns (Do Not Do)
| ❌ 不要做 | ✅ 应该做 |
|---|---|
按关键词找内容时用 | 用 |
查「自己最近发过什么」时逐个星球跑 | 用 |
| 用户只给星球名称时,让用户自己提供 group_id | 先 |
| 名称命中多个相似星球时默认取第一个 | 列出候选(group_id + 名称)让用户确认 |
把 | 它是关键词搜索,只用于按昵称定位具体成员 |
| ❌ Do Not | ✅ Do |
|---|---|
Manually paginate with | Use |
Run | Use |
| Ask users to provide group_id when only given Group name | First find the ID via |
| Default to the first match when multiple similar Groups hit the name | List candidates (group_id + name) for user confirmation |
Treat | It is a keyword search, only used to locate specific members by nickname |
主题管理(topic)
Topic Management
| Shortcut | 说明 | Reference |
|---|---|---|
| 在星球内全文搜索主题 | |
| 获取主题完整详情 | |
| 发布新帖子(talk)⚠️ | |
| 编辑自己的帖子 ⚠️ | |
| 评论 / 楼中楼回复 ⚠️ | |
| 回答提问 ⚠️ | |
⚠️ = 写入操作,执行前必须向用户确认内容。
API():
zsxq-cli api call| 工具 | 参数 | 说明 | Reference |
|---|---|---|---|
| | 获取主题评论列表(分页) | — |
| | 设置/取消精华(星主权限)⚠️ | |
| | 为主题设置标签(titles 为完整标签集合)⚠️ | |
| | 查看自己发起的提问 | — |
| | 查看别人向我发起的提问(账号级,返回项带 | — |
⚠️ = 写入操作(/set_topic_digested会修改星球内容),执行前必须向用户确认,并遵守安全规则与对应 reference 的set_topic_tags块。> [!CAUTION]
原始 HTTP 调用:
| 操作 | 命令模板 | Reference |
|---|---|---|
| 删除主题 | | |
| 读取主题所属专栏 | | |
| 设置主题所属专栏 | | |
⚠️ = 写入操作,执行前必须向用户确认。设置主题所属专栏为全量替换:会覆盖该主题原有专栏归属,「加入某专栏」须先读现有集合再并入回设,详见column_ids。topic-attached-columns.md
| Shortcut | Description | Reference |
|---|---|---|
| Full-text search for topics in a Group | |
| Get complete topic details | |
| Publish a new post (talk) ⚠️ | |
| Edit own posts ⚠️ | |
| Comment / nested reply ⚠️ | |
| Answer questions ⚠️ | |
⚠️ = Write operation; must confirm content with user before execution.
API ():
zsxq-cli api call| Tool | Parameters | Description | Reference |
|---|---|---|---|
| | Get topic comment list (pagination) | — |
| | Set/cancel digest (Group owner permission) ⚠️ | |
| | Set tags for a topic (titles are the complete tag set) ⚠️ | |
| | View questions initiated by myself | — |
| | View questions asked to me (account-level, returns include | — |
⚠️ = Write operations (/set_topic_digestedmodify Group content); must confirm with user before execution and comply with Security Rules andset_topic_tagsblocks in corresponding references.> [!CAUTION]
Raw HTTP Calls:
| Operation | Command Template | Reference |
|---|---|---|
| Delete Topic | | |
| Read Columns Attached to Topic | | |
| Set Columns Attached to Topic | | |
⚠️ = Write operation; must confirm with user before execution. Setting columns attached to a topic is a full replacement: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, seecolumn_idsfor details.topic-attached-columns.md
用户信息(user)
User Information
| Shortcut | 说明 | Reference |
|---|---|---|
| 查看当前用户资料(user_id、昵称等) | |
| 查看跨星球发帖足迹 | |
| 提交 NPS 反馈 ⚠️ | |
用户使用过程中表达产品不满、发现平台缺能力或多次重试受挫时,完成主任务后可顺带提示提交 NPS 反馈,触发细则见。user-nps.md
| Shortcut | Description | Reference |
|---|---|---|
| View current user profile (user_id, nickname, etc.) | |
| View cross-Group post footprints | |
| Submit NPS feedback ⚠️ | |
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 |
|---|---|---|
| 创建公开笔记 ⚠️ | |
| 查看笔记列表 | |
| 查看笔记详情 | |
| 编辑笔记 ⚠️ | |
| 删除笔记(不可恢复)⚠️ | |
Notes are public content, accessible to anyone with the link — do not include privacy or sensitive information in notes.
| Shortcut | Description | Reference |
|---|---|---|
| Create public note ⚠️ | |
| View note list | |
| View note details | |
| Edit note ⚠️ | |
| Delete note (irreversible) ⚠️ | |