heron 是什么
heron 是一个跑在本地、配置是文件的多 Agent 运行时。一组 agent 跑在你自己机器上， 各带模型、提示词与工具边界，共用一套审批闸门；你在浏览器里跟它对话， 它能读你的项目代码、改文件、跑命令；需要你点头的动作会停下来等你批。
「配置是文件」而不是「配置进版本库」：配置可以 review、可以提交进 版本库，但那不是前提 —— 全放本地、只你自己看，同样跑得好好的。真正关键的是 它是可读的文件：权限边界写在
policy/permissions.yaml里，而不是藏在 某个黑盒设置面板后面。
核心能力：
| 能力 | 说明 |
|---|---|
| 多轮持久会话 | 每个会话一条常驻运行线，随时接着聊；历史落盘，关掉浏览器再打开还在 |
| 抢占 | Agent 回答途中你又发一条，旧的一轮在安全点让位给新的 |
| 中止 | 立刻停掉当前这一轮 |
| 人工审批（HITL） | 写文件、执行命令等动作在执行前挂起，你批准后从 checkpoint 恢复 |
| 多 agent 委派 | 一个主 agent 把活分给子 agent（只读检索 / 改代码 / 审阅），可并行 |
| 知识库 | 把自己的语料建成索引，agent 用 kb_search 检索并给出来源 |
| 配置热更新 | 改 llm/ agents/ policy/ 保存即生效，不用重启 |
| 图形化配置编辑器 | 界面里直接编辑配置文件，写入前自动校验 |
| 斜杠命令与技能 | /review、/explain、/fix 等开箱可用；技能可自建 |
命名来自苍鹭（heron）：长久静立、瞬间精准出手 —— 对应「持久等待 + 抢占接管」。