git-perf

独立的 Git 绩效 / 评审台账（与 NANA-OS / DiOS 同级、另仓）。

• DiOS 只负责事件与 Agent，不承载绩效业务模型
• 本产品提供 Web + REST + MCP，供人查看、供 Agent 写入

Git Host ──webhook──► DiOS ──► Reviewer Agent ──MCP──► git-perf ──► Web

目标与契约（必读）

文档	内容
docs/GOALS.md	产品目标、非目标、成功标准、与 DiOS 边界
docs/CONTRACT.md	契约 v0.1.2：远程 MCP /mcp + REST/Web；Agent 是否调用由提示词决定

实现与改动须遵守 CONTRACT；破坏性变更先改契约版本号。

快速启动

cd /home/xu/workspace/git-perf
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

uvicorn app.main:app --host 0.0.0.0 --port 8090 --reload

• Web：http://localhost:8090/
• OpenAPI：http://localhost:8090/docs
• 远程 MCP（主路径）：http://localhost:8090/mcp

冒烟验收

# 临时 DB + 临时端口；不写正式 data/
./scripts/smoke.sh

覆盖：REST 闭环 + 远程 Streamable HTTP MCP（/mcp list_tools + call_tool）。

MCP（注册到 DiOS）

推荐（远程）： Web 起来后，DiOS 登记

字段	值
name	git-perf
transport	streamable_http
url	http://<宿主机对 Agent 可达地址>:8090/mcp

# 仅本地调试 stdio（不要给 task 容器用）
python -m mcp_server

详见 CONTRACT §5、§3。

仓库状态

独立 Git 仓库（勿并入 NANA-OS）。远端：HQIT/dios-mcp-git-perf（public）。

数据

默认 SQLite：data/git_perf.db（可用环境变量 GIT_PERF_DB 覆盖）。