fix(topic): 移除 article 类型,补全正确的四种主题类型

主题 type 字段实际只有 talk / q&a / task / solution,
article 从未存在于 API 返回值中。+create 仅支持 talk,
在 reference 中补充 [!IMPORTANT] 说明。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
zhuguojie
2026-05-25 13:58:56 +08:00
parent 677113296c
commit a8226a5071
5 changed files with 11 additions and 7 deletions
+2 -2
View File
@@ -15,14 +15,14 @@ metadata:
## Core Concepts
- **星球Group**:知识星球的社群单元,由 `group_id`纯数字唯一标识。用户可以是创建者owner或成员member
- **主题Topic**星球内的内容单元包括帖子talk、提问q&a文章article)等,由 `topic_id` 唯一标识。
- **主题Topic**星球内的内容单元包括帖子talk、提问q&a作业task、作业答案solution)等,由 `topic_id` 唯一标识。
- **标签Hashtag**:星球内的分类标签,由 `hashtag_id` 标识,可附加到主题上。
## Resource Relationships
```
Group (group_id)
├── Topic (topic_id) — talk / q&a / article
├── Topic (topic_id) — talk / q&a / task / solution
│ ├── Comment (comment_id)
│ │ └── 楼中楼 Reply (replied_comment_id)
│ ├── Answerq&a 类型专属)
@@ -35,7 +35,7 @@ zsxq-cli group +topics --group-id 123456789 --json
|----------|------|----------------|------------|
| 111222333444 | talk | 示例主题标题 | 2025-12-31T09:19:28.239+0800 |
- `TYPE``talk`(帖子)、`q&a`(提问)、`article`(文章
- `TYPE``talk`(帖子)、`q&a`(提问)、`task`(作业题目)、`solution`(作业答案
- `TITLE / DIGEST`:优先显示标题,无标题时显示内容摘要(截断至 50 字符)
## 说明
+4 -3
View File
@@ -17,7 +17,8 @@ metadata:
- **主题Topic**:星球内的内容单元,由 `topic_id` 唯一标识。类型:
- `talk`:普通帖子(图文)
- `q&a`:提问,可被星主回答
- `article`:长文章
- `task`:作业题目
- `solution`:作业答案
- **评论Comment**:主题下的回复,由 `comment_id` 标识,支持楼中楼(`replied_comment_id`)。
- **精华Digested**:星主可将优质主题设为精华,在星球内突出展示。
@@ -25,7 +26,7 @@ metadata:
```
Group (group_id)
└── Topic (topic_id) — talk / q&a / article
└── Topic (topic_id) — talk / q&a / task / solution
├── Comment (comment_id)
│ └── 楼中楼 Reply (replied_comment_id)
├── Answerq&a 类型专属)
@@ -40,7 +41,7 @@ Shortcut 是对常用操作的高级封装(`zsxq-cli topic +<verb> [flags]`
|----------|------|
| [`+search`](references/zsxq-topic-search.md) | 在星球内全文搜索主题,返回 topic_id / 类型 / 标题 / 时间表格 |
| [`+detail`](references/zsxq-topic-detail.md) | 获取单条主题的完整详情(内容、评论数、点赞数、标签等) |
| [`+create`](references/zsxq-topic-create.md) | 在指定星球发布新主题(帖子),需确认内容后执行 |
| [`+create`](references/zsxq-topic-create.md) | 在指定星球发布新主题(仅支持 talk 类型),需确认内容后执行 |
| [`+edit`](references/zsxq-topic-edit.md) | 编辑自己发布的主题(正文、附件),需确认内容后执行 |
| [`+reply`](references/zsxq-topic-reply.md) | 对主题发表评论,支持楼中楼回复,需确认内容后执行 |
| [`+answer`](references/zsxq-topic-answer.md) | 对提问类主题q&a发布官方回答需确认内容后执行 |
@@ -4,6 +4,9 @@
在指定星球内发布一条新主题(帖子)。
> [!IMPORTANT]
> 仅支持发布 `talk`(普通帖子)类型主题。`q&a`、`task`、`solution` 类型暂不支持通过 CLI 创建。
> [!CAUTION]
> 这是**公开写入操作** —— 发布后对星球成员可见。执行前必须向用户确认:
> 1. 目标星球group_id 和星球名称)
@@ -51,7 +51,7 @@ zsxq-cli topic +detail --topic-id 111222333444 --json
字段含义:
- `type`:主题类型,`talk`(普通帖子)/ `q&a`(提问)/ `article`(文章
- `type`:主题类型,`talk`(普通帖子)/ `q&a`(提问)/ `task`(作业题目)/ `solution`(作业答案
- `digested`:是否被设为精华
- `counts`:评论数 / 点赞数 / 阅读数
- `owner` / `group`:主题作者与所属星球的精简信息