---
id: daily-zsxq-topic
name: "zsxq-topic"
url: https://skills.yangsir.net/skill/daily-zsxq-topic
author: unnoo
domain: automation
tags: ["automation", "api-integration", "knowledge-management", "content-creation"]
install_count: 1600
rating: 4.30 (7 reviews)
github: https://github.com/unnoo/zsxq-skill
---

# zsxq-topic

> 管理知识星球主题，支持查看帖子、问答、长文等内容类型，可进行搜索、筛选和批量操作

**Stats**: 1,600 installs · 4.3/5 (7 reviews)

## Before / After 对比

### 主题内容管理

**Before**:

手动浏览知识星球中的各种主题内容，需要逐个点击查看详情，复制保存文字和图片，分类整理耗时费力，难以快速定位特定内容

**After**:

通过 CLI 快速检索和过滤主题内容，支持按类型、时间、关键词筛选，批量导出文本和图片，自动分类存储，大幅提升内容管理效率

| Metric | Before | After | Change |
|---|---|---|---|
| 内容整理时间 | 90分钟 | 10分钟 | -89% |

## Readme

# zsxq-topic

# topic (v1)

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../zsxq-shared/SKILL.md`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/../zsxq-shared/SKILL.md)，其中包含认证、错误处理规则。**

## Core Concepts

- **主题（Topic）**：星球内的内容单元，由 `topic_id` 唯一标识。类型：

`talk`：普通帖子（图文）

- `q&a`：提问，可被星主回答

- `article`：长文章

- **评论（Comment）**：主题下的回复，由 `comment_id` 标识，支持楼中楼（`replied_comment_id`）。

- **精华（Digested）**：星主可将优质主题设为精华，在星球内突出展示。

## Resource Relationships

```
Group (group_id)
└── Topic (topic_id) — talk / q&a / article
    ├── Comment (comment_id)
    │   └── 楼中楼 Reply (replied_comment_id)
    ├── Answer（q&a 类型专属）
    └── Hashtag 标签列表

```

## Important Notes

### 写入操作前必须确认

发帖、评论、回答均为**不可撤销的公开操作**，执行前必须向用户确认：

- 目标星球 / 主题（group_id / topic_id）

- 发布的内容（title / content / text）

### topic_id 的获取

不确定 topic_id 时，先查询再操作：

- 关键词搜索：`topic +search --group-id xxx --query "关键词"`

- 浏览最新：`group +topics --group-id xxx`

- 查看详情：`topic +detail --topic-id xxx`

## Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（`zsxq-cli topic +<verb> [flags]`）。有 Shortcut 的操作优先使用。

Shortcut
说明

[`+search`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/references/zsxq-topic-search.md)
在星球内全文搜索主题，返回 topic_id / 类型 / 标题 / 时间表格

[`+detail`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/references/zsxq-topic-detail.md)
获取单条主题的完整详情（内容、评论数、点赞数、标签等）

[`+create`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/references/zsxq-topic-create.md)
在指定星球发布新主题（帖子），需确认内容后执行

[`+reply`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/references/zsxq-topic-reply.md)
对主题发表评论，支持楼中楼回复，需确认内容后执行

[`+answer`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/references/zsxq-topic-answer.md)
对提问类主题（q&a）发布官方回答，需确认内容后执行

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

Shortcut 未覆盖的高级操作：

工具
参数
说明

`get_topic_comments`
`topic_id`, `limit`, `index`
获取主题评论列表（分页）

`set_topic_digested`
`topic_id`, `digested`
设置/取消精华（星主权限）

`set_topic_tags`
`topic_id`, `titles`
为主题设置标签（标签名数组）

`get_self_question_topics`
`topic_filter`, `count`, `end_time`
查看自己发起的提问（`unanswered`/`answered`）

`get_self_answer_topics`
`topic_filter`, `count`, `end_time`
查看别人向我发起的提问（`unanswered`/`answered`）

[`delete topic`](https://github.com/unnoo/zsxq-skill/blob/HEAD/skills/zsxq-topic/references/zsxq-topic-delete.md)
`topic_id`（路径参数）
删除主题（`api raw --method DELETE`，不可恢复）

Weekly Installs704Repository[unnoo/zsxq-skill](https://github.com/unnoo/zsxq-skill)GitHub Stars62First SeenTodaySecurity Audits[Gen Agent Trust HubPass](/unnoo/zsxq-skill/zsxq-topic/security/agent-trust-hub)[SocketPass](/unnoo/zsxq-skill/zsxq-topic/security/socket)[SnykWarn](/unnoo/zsxq-skill/zsxq-topic/security/snyk)

---
*Source: https://skills.yangsir.net/skill/daily-zsxq-topic*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-zsxq-topic/markdown*