Skip to content

Agent Decisions Dashboard本机决策台账与审阅工作台

基于 Python 3.9+ 标准库、SQLite 与零构建静态前端打造,专为个人与本机 AI 编程工具协作记录结论、批注原话与版本历史。

能力定位与明确边界 ​

能做到什么程度(已实现能力)

  • 零依赖单机启动与外部挂载:仅靠 Python 3.9+ 标准库与内置 sqlite3 运行;通过 --config /path/to/dashboard.config.json 即时挂载任意本地项目台账。
  • 可追溯记录、审阅与回滚:维护 schema_version: "2.0" Markdown 权威正文 + SQLite 历史快照(revisions)、ABA 防护版本号、request_id 幂等重放、在线热备份(/api/backup)与路径隔离自动 Git 提交。
  • Agent 上下文与只读校验:提供五桶过滤上下文导出(把 partially_accepted 归入待决需求,剥离过期否决),配套 before-task / after-write 只读 CLI 钩子与 agent-question 单选交互卡片。

明确不能做什么(非目标与硬限制)

  • 不做远程访问与多人协作:HTTP 网关严格拒绝非回环地址(如 0.0.0.0),采用进程内线程锁,不支持多用户登录、鉴权权限分配或多进程并发共享同一个 decisions.db。
  • 不自动执行代码、测试或部署任务:accepted、verified 与 agent-question 选中结果仅作为台账记录,服务端与钩子绝不代跑构建/测试、也不授予 Shell 执行权限。
  • 仅靠 metadata.json 或 Markdown 不能替代完整数据库:metadata.json 只是只读导出摘要,Markdown 仅存最新正文;历史快照与请求幂等键仅存在于 decisions.db。

决策生命周期交互图 ​

决策状态流转交互图(支持平移 / 缩放 / 节点探查)

快速上手演示 ​

sh
git clone https://github.com/CyberNova2333/agent-decisions-dashboard.git
cd agent-decisions-dashboard
./start_dashboard.sh --port 8765
# 或直接执行:python3 -m core.server --port 8765 --no-browser

服务仅监听本机回环地址;启动后在浏览器打开 http://127.0.0.1:8765/dashboard.html 即可开始新建与批阅议题。

文档分层导航 ​

按照读者需求快速跳转

  • 初次体验或挂载外部项目台账:阅读 起步与配置部署,包含 ./start_dashboard.sh / .bat 启动方式、dashboard.config.json 配置矩阵与排错;
  • 逐一查阅 HTTP 端点、CLI 与标准调用示例:进入 API 与组件参考(三栏式交互文档)或查看完整契约页 接口与扩展契约;
  • 阅读实现链路、源码定位或迁移旧版记录:查阅 原理与源码导览,了解完整保存主流程、代码地图与迁移说明;
  • 维护仓库源码、提交 PR 或查看证据审计:参阅仓库根目录 repo-docs/README.md 与 CONTRIBUTING.md。