mirror of
https://github.com/unnoo/zsxq-skill.git
synced 2026-09-14 19:59:58 +08:00
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:
@@ -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)
|
||||
│ ├── Answer(q&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 字符)
|
||||
|
||||
## 说明
|
||||
|
||||
@@ -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)
|
||||
├── Answer(q&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`:主题作者与所属星球的精简信息
|
||||
|
||||
Reference in New Issue
Block a user