Zsxq Topic

# topic +answer（回答提问）

本 skill 对应 shortcut：`zsxq-cli topic +answer`。

对 `q&a` 类型的主题发布**官方回答**。仅适用于问答类主题，且每个问题只能回答一次。

> [!CAUTION]
> 这是**公开写入操作**，且**每个问题只能回答一次**，回答后无法修改。执行前必须向用户确认：
> 1. 目标主题（topic_id）及其问题内容
> 2. 回答的完整内容

> [!IMPORTANT]
> `+answer` 与 `+reply` 的区别：
> - `+answer`：发布"官方回答"，附加在问题下方，标记为已回答（`q&a` 专用，只能用一次）
> - `+reply`：发表普通评论，适用于所有类型主题，可发多条

## 命令

```bash
# 回答一个提问
zsxq-cli topic +answer \
  --topic-id 111222333466 \
  --text "示例回答内容"

# JSON 格式输出
zsxq-cli topic +answer \
  --topic-id 111222333466 \
  --text "示例回答内容" \
  --json

# 带附件的回答
zsxq-cli topic +answer \
  --topic-id 111222333466 \
  --text "示例回答内容" \
  --files diagram.png
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--topic-id <id>` | **是** | 主题 ID（必须是 `q&a` 类型） |
| `--text <text>` | **是** | 回答正文 |
| `--files <paths>` | 否 | 附件路径，多个用逗号分隔 |
| `--json` | 否 | 输出原始 JSON |

## 推荐工作流

先确认主题类型，再发布：

```bash
# 第一步：确认目标主题是 q&a 类型并核对问题内容
zsxq-cli topic +detail --topic-id 111222333466 --json
# 查看返回 JSON 中的 "type" 是否为 "q&a"

# 第二步：确认无误后发布回答
zsxq-cli topic +answer \
  --topic-id 111222333466 \
  --text "示例回答内容"
```

如果不知道有哪些待回答的提问，先列一下：

```bash
# 自己发起的未回答提问
zsxq-cli api call get_self_question_topics --params '{"topic_filter":"unanswered","count":20}'

# 别人向我发起的未回答提问
zsxq-cli api call get_self_answer_topics --params '{"topic_filter":"unanswered","count":20}'
```

> `get_self_question_topics` / `get_self_answer_topics` 还支持 `topic_filter:"answered"` 查看已回答记录。

## 失败语义

写入失败即原子回滚 —— 失败不会消耗"每题只能回答一次"的额度，确认参数后可重试。

## 错误说明

| 错误 | 原因 |
|------|------|
| `问题已回答` | 该主题已有官方回答，每题只能回答一次 |
| `topic is not q&a` | 主题类型不是提问，应使用 `+reply` 发评论 |

通用错误（401、`--topic-id is required`、主题不存在等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。

## 参考

- [zsxq-topic-reply](zsxq-topic-reply.md) — 发表普通评论（适用于所有类型）
- [zsxq-topic-detail](zsxq-topic-detail.md) — 查看主题详情和类型
- [zsxq-shared](../../zsxq-shared/SKILL.md)


# topic +create（发布主题）

本 skill 对应 shortcut：`zsxq-cli topic +create`。

在指定星球内发布一条新主题（帖子）。

> [!IMPORTANT]
> 仅支持发布 `talk`（普通帖子）类型主题。`q&a`、`task`、`solution` 类型暂不支持通过 CLI 创建。

> [!CAUTION]
> 这是**公开写入操作** —— 发布后对星球成员可见。执行前必须向用户确认：
> 1. 目标星球（group_id 和星球名称）
> 2. 发布的内容

## 命令

```bash
# 发布一条主题
zsxq-cli topic +create \
  --group-id 123456789 \
  --text "示例主题正文内容"

# 带附件（图片/文件，逗号分隔）
zsxq-cli topic +create \
  --group-id 123456789 \
  --text "示例内容" \
  --files photo.jpg,report.pdf
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--group-id <id>` | **是** | 目标星球 ID（从 `group +list` 获取） |
| `--text <text>` | **是** | 主题正文内容，支持 `\n` 换行 |
| `--files <paths>` | 否 | 附件路径，多个用逗号分隔（图片/文件） |
| `--json` | 否 | 输出原始 JSON（含新建 topic_id） |

## 输出

成功后输出：

```
✓ Topic created
{
  "topic_id": "111222333455",
  "title": "示例主题标题",
  "create_time": "2026-04-01T15:44:23.555+0800"
}
```

## 推荐工作流

```bash
# 第一步：确认目标星球
zsxq-cli group +list

# 第二步：确认内容无误后执行
zsxq-cli topic +create --group-id <id> --text "内容"

# 第三步：验证发布结果
zsxq-cli topic +detail --topic-id <新建的 topic_id>
```

## 失败语义

写入失败即原子回滚 —— 不会留下空主题或半成品 topic_id。重试前请先确认参数是否合法。

## 错误说明

通用错误（401、`--group-id is required`、星球无权限发帖等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。本命令无特有错误。

## 参考

- [zsxq-topic-reply](zsxq-topic-reply.md) — 对已发主题评论
- [zsxq-group-list](../../zsxq-group/references/zsxq-group-list.md) — 获取 group_id
- [zsxq-shared](../../zsxq-shared/SKILL.md)


# topic 删除（通过 api raw）

通过 `zsxq-cli api raw` 删除指定主题。删除后**不可恢复**。

> [!CAUTION]
> 这是**不可逆的破坏性操作** —— 删除后主题及其所有评论、回答将永久消失，无法恢复。执行前必须向用户确认：
> 1. 目标主题（topic_id）及其内容
> 2. 明确用户确实要删除（而非取消精华、删除评论等其他操作）

## 命令

```bash
# 删除主题
zsxq-cli api raw --method DELETE --path /v2/topics/<topic_id>

# 示例
zsxq-cli api raw --method DELETE --path /v2/topics/15522482218442
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `<topic_id>` | **是** | 主题 ID（拼接到 URL 路径中） |

## 推荐工作流

```bash
# 第一步：确认主题内容，确保删对目标
zsxq-cli topic +detail --topic-id 15522482218442

# 第二步：向用户确认后执行删除
zsxq-cli api raw --method DELETE --path /v2/topics/15522482218442
```

## 失败语义

删除失败即原子回滚 —— 主题保持原状不会被部分删除。

## 错误说明

| 错误             | 原因