什么是 Tetrees Agent EX？
Tetrees Agent EX 是一个公共集成工具包，用于通过托管的 Tetrees Agent MCP 服务器和 API 使用 Tetrees AI Packs。它为买家、构建者和卖家提供客户端、配置示例及安全扩展示例。
该工具包公开的是面向开发者的契约，而不是托管服务的内部实现。它不包含 Tetrees Agent 的实现细节、私有 Pack 智能、Agent AVCP 评分规则、服务提示词、审核系统、存储基础设施或生产凭证。
Tetrees 托管的操作不需要本地 GPU。使用模型的运行会在执行前以 Tetrees Points 报价。获取 Pack 后，用户也可以向本地 MCP 进程提供受支持的供应商密钥。
你可以构建什么
买家和操作员工作流
买家和操作员可以使用公共契约来：
- 搜索 AI Pack 目录。
- 查看 Pack 的公开 Agent AVCP 报告和运行时配置文件。
- 在消耗 Tetrees Points 前获取运行报价。
- 通过无状态的 Points 资助预览试用 Pack。
- 在 Tetrees EX 上获取免费 Pack 或购买付费 Pack。
- 下载已拥有的不可变
.taip版本。
构建者工作流
构建者可以将经过试用评估的 Pack 连接到用户控制的能力，同时将绑定信息和凭证保留在用户自己的设备上。支持的模式包括固定 HTTPS API、嵌套 MCP 服务器和无 Shell 本地技能。
卖家工作流
卖家可以创建列表、上传不可变的 Pack 版本和图片、检查就绪状态、运行 Agent AVCP、查看私有修复反馈，并发布通过评估的版本。
先决条件
在配置托管 MCP 集成之前，请准备以下内容：
- Node.js 20 或更高版本。
- 从 Tetrees 账户页面获取的可撤销 API 令牌。
- 如果计划使用托管 MCP 服务器，还需要兼容 MCP 的客户端。
- 如果希望运行检查器、CLI、示例或验证命令，还需要本地检出该仓库。
请勿将凭证放入 Pack、提示词、源文件或共享的 MCP 配置中。可选的供应商密钥只能存在于本地 MCP 进程的环境中。
配置托管 MCP 服务器
将以下服务器定义添加到 MCP 客户端的配置中。将占位符替换为可撤销的 Tetrees 账户令牌。
{
"mcpServers": {
"tetrees-ai": {
"command": "npx",
"args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.0"],
"env": {
"TETREES_API_URL": "https://ex.tetrees.ai/api",
"TETREES_TOKEN": "<revocable-account-token>"
}
}
}
}保存配置后重启 MCP 客户端。v=2.2.0 后缀可防止 npx 重用同一 URL 下缓存的旧 tarball。只有在 Tetrees 发布新的 MCP 契约时，才应更改此值。
尝试安全的 MCP 请求
让 MCP 客户端搜索 Pack 并获取报价，但不要启动付费运行：
Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.此请求遵循预期的安全模式：发现 Pack，检查其公开评估结果和运行时要求，请求报价，并在消耗 Points 前等待明确批准。
检查公共 MCP 契约
在仓库目录中安装依赖、导出令牌，然后运行 MCP 检查器：
npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect检查器会启动官方托管 MCP 包，并列出其公共工具和资源。它还会检查预期的买家、构建者和卖家功能面。检查过程不会消耗 Points，也不会更改账户状态。
使用公共 API CLI
该项目不会自动加载机密文件。请将 .env.example 中的相关值复制到 Shell 环境中，不要指望 CLI 读取这些值。
export TETREES_TOKEN="txk_..."运行只读命令
先运行检查服务和账户、但不会发起模型工作的命令：
npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>使用 catalog 查找 Pack，使用 runtime 查看其运行时配置文件，使用 report 检查其公开 Agent AVCP 报告。models 和 skills 命令会公开受支持的公共选项，而 owned 会列出与账户关联的 Pack。
运行前获取报价
报价不会启动模型请求。提供所选 Pack 和模型标识符：
npm run tetrees -- quote <pack-id> <model-id>在批准执行前，检查确切的模型、令牌上限、托管技能、增长检查点以及报价中的 Points 承诺。
确认消耗 Points 的运行
要启动运行，请加入确切的确认标志：
npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend由 Points 资助的预览是无状态的，未使用的预留 Points 会被退回。CLI 会对形似机密的响应字段进行脱敏，并报告 Tetrees 错误代码、HTTP 状态值和 Retry-After 信息。它不会自动重试变更操作。
遵循买家流程
谨慎的买家工作流程按以下顺序进行：
- 搜索符合任务需求的 Pack。
- 检查其公开的 Agent AVCP 报告和运行时配置。
- 核对确切的模型、令牌上限、托管技能和增长检查点。
- 批准并运行由 Points 资助的无状态预览。
- 获取免费 Pack，或通过 Tetrees EX 购买付费 Pack。
- 使用下载、BYOK、已保存的增长数据和客户端扩展等所有权权益。
仓库包含一个有文档说明的只读发现与报价示例：
node examples/buyer/discover-and-quote.mjs "incident response"将 incident response 替换为其他搜索短语，即可探索适用于不同用例的 Pack。
以构建者身份添加本地能力
已发布的 Pack 可以声明已通过 Agent AVCP 的客户端扩展。扩展的实际绑定和凭据仍保留在本地，因此 Tetrees 托管不会继承这些权限。
选择绑定模式
https_api：连接到固定的 HTTPS 基础 URL，并使用已声明的方法和由环境提供的请求头。mcp：在不使用 shell 的情况下启动嵌套 MCP 服务器，并将其映射到已声明的工具名称。local_skill：启动一个不使用 shell 的子进程，该进程接收一个 JSON 请求并返回一个 JSON 结果。
使用 examples/extensions/client-extensions.example.json 作为配置起点。仓库还提供了 examples/extensions/local-skill/issue-summary.mjs 作为本地技能示例，以及 docs/BUILDER_GUIDE.md 作为完整的构建者契约说明。
写入方法要求使用准确的逐次调用批准短语
APPROVE extensionId.methodId。不要将一般性的对话批准视为执行写入操作的权限。
以卖家身份发布 Pack
卖家流程由契约驱动。首先在不修改 Pack 的情况下检查其就绪状态和报告：
node examples/seller/check-readiness.mjs <pack-id>新版本准备就绪后，使用明确确认上传一个更高且不可变的版本：
node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload上传后，使用托管的 MCP 工具或Tetrees API 参考完成发布流程：
- 提交已上传的版本。
- 请求 Agent AVCP 报价。
- 在运行 Agent AVCP 前确认准确的 Point 数量。
- 检查私有报告和修复反馈。
- 仅发布通过评估的摘要。
准备列表时，请参考 docs/SELLER_GUIDE.md 和 examples/seller/pack-listing.example.json。
高级安全与可靠性提示
将机密与共享配置分开
将 Tetrees 令牌和可选的提供商密钥存储在本地进程环境中。切勿将提供商凭据嵌入 Pack、提示词、源文件或可能被共享的配置中。使用可撤销的令牌，以便在需要时撤回访问权限。
不要自动重试变更操作
对于失败的写入操作，在决定如何处理之前，请检查报告的 Tetrees 错误代码、HTTP 状态和 Retry-After 值。自动重试可能会重复上传、购买、运行或其他会改变状态的操作。
有意固定托管 MCP 契约
保留 MCP 软件包 URL 上有文档说明的查询后缀，以避免使用过时的 npx 缓存条目。仅在官方发布契约版本后更新该后缀。
审查公开边界
在贡献代码前，请阅读 SECURITY.md 和 docs/PUBLIC_BOUNDARY.md。贡献只能与有文档说明的公开身份验证契约交互，不得假定可以访问 Agent 内部、私有 Pack 数据、评分固件、签名密钥、数据库、管理 API 或部署基础设施。
验证仓库
在分发更改或准备软件包前，运行提供的检查：
npm test
npm run check:public-boundary
npm pack --dry-run有用的公开参考资料
结语
Tetrees Agent EX 为发现、评估、运行、扩展和发布 Tetrees AI Pack 提供了透明的公开契约。从只读检查开始，在模型资助的工作前请求准确报价，对消费和写入操作要求明确确认，并将所有用户拥有的凭据和扩展权限保留在本地。