Complete Operation Guide for zsxq-cli

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. 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

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

scenarios/generate-daily-poster.md

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

references/scenarios/migrate-legacy-skills.md

references/cli-exploration.md

references/share-links.md

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

references/user-nps.md

references/note-create.md

> [!CAUTION]

Resource Relationships

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: 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

• 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

Daily patrol / inspect the Group

See what needs to be handled today

scenarios/daily-patrol.md

Organize comment section questions for me to reply

Find unreplied comments and draft replies

scenarios/triage-comments.md

Find unanswered questions asked to me

Organize pending questions by priority

scenarios/manage-inbound-questions.md

Organize recent topics, mark as digest and add tags as needed

Which posts are worth marking as digest

scenarios/curate-digest-and-tags.md

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 / make a daily report image

Make recent content into a poster to share in groups

scenarios/generate-daily-poster.md

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

Inspect / monitor risky content in the Group

Check for insults / ads / complaints every hour

scenarios/monitor-risky-content.md

Batch tag recent topics with given tags

Batch tag historical content

scenarios/batch-tag-topics.md

Check expiring members

Do renewal care / reminders

Write tiered messages for expiring members based on activity

scenarios/care-expiring-members.md

Archive the latest N topics to Column XX

Batch archive topics to columns / organize thematic collections

scenarios/archive-topics-to-column.md

Check/clean/migrate legacy Zsxq Skills

Upgrade zsxq Skill

scenarios/migrate-legacy-skills.md

Group Management

zsxq-cli group +list

group-list.md

zsxq-cli group +topics

group-topics.md

zsxq-cli group +hashtags

group-hashtags.md

zsxq-cli api call

search_groups

keyword

search_group_members

group_id

keyword

limit

get_hashtag_topics

hashtag_id

limit

end_time

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

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 +list

search_groups

search_group_members

limit

Topic Management

zsxq-cli topic +search

topic-search.md

zsxq-cli topic +detail

topic-detail.md

zsxq-cli topic +create

topic-create.md

zsxq-cli topic +edit

topic-edit.md

zsxq-cli topic +reply

topic-reply.md

zsxq-cli topic +answer

topic-answer.md

⚠️ = Write operation; must confirm content with user before execution.

zsxq-cli api call

get_topic_comments

topic_id

limit

index

set_topic_digested

topic_id

digested

topic-digest.md

set_topic_tags

topic_id

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

⚠️ = 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.

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

⚠️ = 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 Information

zsxq-cli user +info

user-info.md

zsxq-cli user +footprints

user-footprints.md

zsxq-cli user +nps

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 Management

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