青简 QingAgent

最佳实践：让 Claude Code 用青简当编辑器

如果你已经在用 Claude Code 或 Codex 这类终端 Agent 干活，青简可以成为它们的「编辑器后端」：Agent 负责生产和修改内容，青简负责排版呈现、版本管理，以及最关键的——每一处改动先摆出来给你过目。桥梁是随桌面客户端分发的 qa 命令行工具。

准备：确认 qa 命令可用

安装并首次启动青简桌面客户端后，qa 会自动写入 ~/.qingagent/bin/qa（macOS / Linux 会尽力链接到 /usr/local/bin）。终端里敲不到 qa 时补一行 PATH：

export PATH="$HOME/.qingagent/bin:$PATH"   # Windows: %USERPROFILE%\.qingagent\bin

然后确认青简实例在跑：

qa status

给你的 Agent 装上「说明书」

让 Claude Code 学会跟青简打交道，只需要一条命令：

qa skills install claude    # Codex 用户：qa skills install codex

这会给 Claude Code 装一个指针技能，告诉它 qa 命令的用法和协作规范。此后你在 Claude Code 里说「把这份分析写进我的青简文档」，它就知道该怎么做了。

Agent 都能做什么

qa 暴露的是一套受约束的文档协作接口，核心命令组：

qa sessions list                 # 列出文档
qa doc read -s <id>              # 读取正文
qa doc propose -s <id> ...       # 提交修改提案（全文/局部替换/追加）
qa review run -s <id> --type <t> # 发起审查
qa template list / pull / push   # 管理审查模板
qa skills list / install         # 管理技能

注意 doc propose 这个词——外部 Agent 对文档的修改是提案而不是直写，还带版本号校验（--expect-version），并发改稿不会互相覆盖。提案在青简界面里以对照形式出现，和 AI 改稿一样逐条过目、逐条采纳，「先审后应用」的铁律对外部 Agent 同样生效。

一个真实的工作流

以「让 Claude Code 写周报」为例：

  1. 在青简里新建文档「本周周报」，记下 qa sessions list 里它的 id；

  2. 在 Claude Code 里说：「统计本周 git 提交和 PR，写成周报，用 qa 提交到我的青简文档 <id>」；

  3. Claude Code 读仓库、汇总、qa doc propose 提交；

  4. 回到青简，改动已经摆成对照卡——走查、采纳、提交，排版好的周报直接导出 Word 发群里。

数据活儿交给会跑命令的 Agent，文字把关留在青简，两边各干各擅长的事。

边界与安全

qa 走的是本机 external API，权限被刻意收窄：读写文档、发审查、管模板技能——仅此而已，动不了你的模型 Key 和全局设置。技能的导入删除也只在桌面客户端开放，Web 部署形态默认拒绝。想深入的开发者可以看产品仓库里的 docs/qa-cli-review.md，有完整的命令参考和端到端样例。