gitlink-cli/skills/gitlink-faq/references/gitlink-faq-publish.md

gitlink-faq Wiki 发布

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

发布命令

首次创建知识库页面

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

更新已有知识库页面

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

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

检查知识库是否存在

# 列出所有 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 周）