跳到正文

Agent Contract

Agent Contract 是版本化、可检查的发现层，让 AI 客户端不必猜测配置字段、CLI 语法、MCP 权限与部署路由。

安装包契约

创建或维护本地项目时，从这里开始：

text
@aicode-nexus/silen/agent/manifest.json

包清单会指向当前准确版本的配置 API、CLI/MCP 契约、公共 TypeScript 导出、指南与任务手册。例如 agent/tasks/create-site.md 描述受支持的激活路径，并链接回权威机器可读资源，而不是复制定义。

部署站点契约

开启后，每次生产构建都会发布站点专属的 /.well-known/silen/manifest.json，并按 base 解析。当前官网的实时清单描述 base、语言、资源、任务与公开项目指引；资源与任务 URL 保持 base 相对。manifest schema 不包含部署 origin 字段。

ts
ai: {
  contract: {
    enabled: true,
    instructions: '.silen/ai-public.md',
    tasksDir: '.silen/ai-tasks',
  },
}

指令与任务都是显式公开构建输入。不要包含本地绝对路径、密钥、私有端点、凭证或未公开运行信息。

Schema 版本 2

当前 manifest 与 API 文档使用 schemaVersion: 2。manifest 的 MCP 能力声明 stdio、协议版本 2025-11-25 与 2026-07-28、空扩展列表、本地运行、 默认只读和 --allow-write 门禁。API 文档为每个工具增加 outputSchema；MCP 成功调用会同时返回文本与对应的、经过 schema 校验的 structuredContent。

该契约不声明远程传输或可选 MCP 扩展；这些能力需要独立设计和授权。

包内还包含生成的文件系统 Skill： dist/agent/skills/silen-docs-readonly；CLI API 会记录 silen ai skills 和 --experimental-skills-over-mcp。默认 manifest 仍声明 extensions: []，因为可选 运行参数不等于站点能力。Skill 文本只是流程知识，不授予 Host 运行命令、访问 网络、写文件、提交、推送或部署的权限。

客户端行为

Codex、Claude Code、Cursor 等客户端应使用同一份清单，不要维护各自的 API 副本。若客户端不支持声明的契约 schema，应退回到链接的公开 Markdown，并保持只读。读取部署内容时以站点清单为准；针对已安装包生成代码时以包契约为准。

下一步配置本地工作区与 MCP。