钛回购运营商
Titanium Repo Operator是一个异步优先的MCP服务器，为自主编码代理提供原子、可审计的回购操作。经过测试，CI强制，可重复运行。
快速入门
curl -LsSf https://astral.sh/uv/install.sh | sh
make test
make run期望输出
EVAL RESULTS
smoke: pass (12.34ms)
tool_contract: pass (20.11ms)
atomic_write: pass (3.42ms)
checks_passed: 3/3
safe_commands: 5评估
运行评估套件：
make eval| 度量 | 命令 | 预期 |
|---|---|---|
| 评估通过率 | make eval | 3/3 (100%) |
| SAFE_COMMANDS计数 | make eval | 5 |
正确性证据
make eval 包括对工具契约合规性和原子写入的轻量级检查。
| 检查 | 信号 | 示例结果 |
|---|---|---|
| 工具合同合规性 | 所有预期工具均已注册；生成的模式 | 通过，\<25ms |
| 禁止路径拒绝 | validate_path("../forbidden") 升高 | 通过，\<5ms |
| 原子写入保证 | 内容匹配最新，无临时文件 | 通过，\<5ms |
快速入门（本地）
推荐（紫外线）：
curl -LsSf https://astral.sh/uv/install.sh | sh
make run可编辑安装（pip）：
pip install -e .
titanium-mcp快速入门（docker）
docker compose up --build验证（60秒验证）
make test
make evalCI强制执行lint、类型检查、单元测试和覆盖率（最低65%）。
评估
运行评估套件：
make eval期望输出
EVAL RESULTS
smoke: pass (12.34ms)
tool_contract: pass (20.11ms)
atomic_write: pass (3.42ms)
checks_passed: 3/3
safe_commands: 5| 度量 | 命令 | 预期 |
|---|---|---|
| 评估通过率 | make eval | 3/3 (100%) |
| SAFE_COMMANDS计数 | make eval | 5 |
正确性证据
make eval 包括对工具契约合规性和原子写入的轻量级检查。
| 检查 | 信号 | 示例结果 |
|---|---|---|
| 工具合同合规性 | 所有预期工具均已注册；生成的模式 | 通过，\<25ms |
| 禁止路径拒绝 | validate_path("../forbidden") 升高 | 通过，\<5ms |
| 原子写入保证 | 内容匹配最新，无临时文件 | 通过，\<5ms |
生产说明
- 使用随附的
Dockerfile以构建容器映像。 - 默认情况下，在禁用网络的情况下运行容器，并在下装载工作区
/workspace. - 将机密与Vault/云KMS集成；不要将代币烘焙成图像。
- 集
TITANIUM_AUDIT_KEY适用于非开发环境；默认密钥被拒绝。
文件
titanium_repo_operator/--包含服务器、工具、策略和实用程序的包server.py--兼容性垫片uv run server.pyDockerfile--生产容器k8s/deployment.yaml--k8s部署清单示例.github/workflows/ci.yaml--CI工作流程build-and-push.sh--用于CI的Docker构建脚本SECURITY.md--安全强化指南和检查表Makefile—make run,make test,make evalevals/smoke_eval.py--对回购结构和SAFE_COMMANDS进行烟雾检查evals/tool_contract_eval.py--工具注册表和模式合规性检查evals/atomic_write_eval.py--原子写入不变量检查evals/run_eval.py--联合评估跑者