# gitlink-faq Wiki 发布

> 本文档说明如何将生成的 FAQ 内容发布到 GitLink 项目 Wiki。

## 发布命令

### 首次创建知识库页面

```bash
gitlink-cli wiki +create \
  --title "Issue-知识库" \
  --file ./issue-knowledge-base.md \
  --message "自动生成：从已关闭 Issue 归纳分类"
```

### 更新已有知识库页面

```bash
# 预览变更
gitlink-cli wiki +update --title "Issue-知识库" --file ./issue-knowledge-base.md --dry-run

# 覆盖更新
gitlink-cli wiki +update --title "Issue-知识库" --file ./issue-knowledge-base.md
```

### 检查知识库是否存在

```bash
# 列出所有 Wiki 页面
gitlink-cli wiki +list --format json

# 查看知识库内容
gitlink-cli wiki +view --title "Issue-知识库" --format json
```

## 发布检查清单

在 `wiki +create` 或 `wiki +update` 之前：

- [ ] FAQ 内容已展示给用户并获得确认
- [ ] `--dry-run` 已通过
- [ ] Markdown 格式正确（代码块、链接、表格）
- [ ] 来源 Issue 链接有效
- [ ] 不存在敏感信息（Token、密码等）

## Wiki API 注意事项

- Wiki 使用独立的 **Gateway API**（`https://gateway.gitlink.org.cn/api`），不走主 API
- 内容自动 base64 编码，CLI 已处理
- `project_id` 会自动解析并缓存
- 如果更新失败（页面不存在），改用 `wiki +create`

## 发布后

发布完成后告知用户：
- Wiki 页面链接
- FAQ 条目数量统计
- 建议的刷新频率（每 1-2 周）
