内容
# 工具授权协议(TAP)
凭证隔离、审批门控和AI代理的连接器路由。
本仓库包含最有用的代码,适用于:
- 审计请求路由和连接器行为
- 调试失败的请求
- 了解审批流程
- 改进连接器端的请求塑形
- 为核心TAP体验贡献修复
> [!WARNING]
> **自行托管意味着您需要负责凭证和签名密钥的安全性。**
> TAP将秘密凭证从您的代理中隔离出来,但自行运行它需要您负责主机加固、密钥隔离和策略引擎的正确操作。这是一条适合熟悉安全性的团队的路径。对于其他人,建议强烈使用托管版本:凭证位于一个硬件保护环境中,我们无法读取, 且无需运行任何运维操作。 在 [tap.human.tech](https://tap.human.tech) 上免费开始。
## 开始这里
- `crates/tap-proxy/src/routing.rs` — TAP如何解析连接器目标形状
- `crates/tap-proxy/src/placeholder.rs` — 凭证替换和位置验证
- `crates/tap-proxy/src/policy.rs` — 审批策略执行
- `docs/` — 完整的文档,包括自行托管指南
## 已包含
- 核心代理和存储包
- Telegram和Matrix审批机器人
- 远程MCP服务器(`tap-mcp`)
- 命令行界面(CLI)
- 文档(自行托管、API参考、凭证设置)
## 不包含
- 环境部署胶水(CCE策略生成、发布策略自动化、ARM模板、环境配置)
- 生产工作流程和秘密凭证启动
- 托管主机操作胶水
- 托管仪表板UI源(包含一个占位符,以便代理编译)
**密钥管理源代码已包含** (`key_provider_enclave.rs`, `kms_azure.rs`, `skr.rs`) — 这是 [docs.tap.human.tech/security](https://docs.tap.human.tech/security) 中记录的托管模型,每个托管版本的托管测量值发布在 [`measurements/`](measurements/) 中。托管部署和操作基础设施与此仓库分开维护。
## 安全
参见 [`SECURITY.md`](SECURITY.md) 以报告漏洞。
## 许可证
[Apache-2.0](LICENSE):免费使用、阅读、修改和自行托管。此仓库是开源TAP运行时(`tap-core`、`tap-proxy`、`tap-bot`、`tap-cli`、`tap-mcp`)。托管仪表板和管理服务部署胶水是专有的,位于一个单独的私有仓库中。
## 贡献
参见 `CONTRIBUTING.md`。
## 测试
```bash
# 需要Postgres(默认为postgres://tap:tap@localhost:5434/tap,可以覆盖)。隔离套件并行执行;环境变更的单元测试保持串行。
cargo test -p tap-core
cargo test -p tap-proxy --test integration --test e2e
cargo test -p tap-proxy -p tap-bot -p tap-cli --lib --bins -- --test-threads=1
```