给你和你的Agent配个行车记录仪

人机共享的探索地图:人看画布,Agent 读 map.json

活点地图画布实拍:主路线绿色实线推进,问题路线红色虚线悬空,便签挂在节点上

画布实拍:绿实线走通、红虚线证伪、灰点线待验证,便签挂在节点与方案上

一分钟接入你的项目

给用 Codex、Kimi Code、Claude Code 等 AI 编程助手的人。接入后,Agent 每次会话开始先读地图,主动汇报:当前进展、等你判断的方案、停滞的路线。

1复制接入协议

协议告诉 Agent:map.json 怎么读、什么时候汇报全局、干活后怎么同步、什么不许碰。

也可以手动打开 agent-kit/AGENTS.snippet.md,全文复制。

2贴给你的 Agent

在你的项目目录里,对 Agent 说一句:

运行 curl -sL https://livedotmap.top/agent-kit/setup.md 查看接入指引,按它在我的项目目录完成活点地图接入;如果拉取失败,把网址换成 https://app.live-dot-map.workers.dev/agent-kit/setup.md 再试,仍失败换 https://test-d0gims26n5c5ce096-1425841737.tcloudbaseapp.com/agent-kit/setup.md。

剩下全自动:下载画布到 ~/.live-dot-map/、建桌面快捷方式、注入协议、初始化地图、拉起画布。已有记录文件也会一并迁移成地图草稿,你在画布上审核。

3连上项目文件夹

打开画布,菜单里选「打开项目文件夹」。画布改动自动存进 map.json;Agent 改了,画布两秒内自己刷新。

打开画布

文件夹直连需要 Chrome 或 Edge;不行就导出 map.json 交给 Agent,一样能用。

画布上能干什么

状态属于方案线,不属于节点;探索允许失败、回退、悬空。

演示 GIF 待补充

建节点 · 拉方案线

N 建节点,L 从节点拉出方案线。绿实线走通、红虚线证伪、灰点线待验证——切状态只改颜色,不动连接。

演示 GIF 待补充

便签标注 · 评分归档

黄便签挂在节点与方案线上记结论;结果打分 0–100;归档只弱化、不删除,历史永远翻得回来。

演示 GIF 待补充

与 Agent 共享一张图

画布和 Agent 读写同一个 map.json。你改完它接着用;它改完,画布两秒自刷新。

本地优先

地图数据和 Markdown 都在你自己的项目目录里。离线可用,不要账号,不要云数据库。

Codex、Kimi Code、Claude Code 等 Agent 通过项目文件读写同一张地图。不同 Agent,同一份记忆。

判断权永远在人:评分你打、归档你确认、画布上随便改,Agent 下次读到的就是你的版本。

项目目录/ ├── .live-dot-map/ │ ├── map.json # 单一事实源:路线/节点/方案线/标注 │ └── nodes/ routes/ # 节点与方案的 Markdown 详情分片 └── AGENTS.md # 项目级 Agent 指令(含活点地图协议段)

先让 Agent 给你汇报一次全局

复制协议 → 贴给 Agent → 连上文件夹。从下一次会话开始,它先开口。