# CLI.Tax 智能体与 IDE 完整引导文档

规范网址：https://cli.tax/
机器索引：https://cli.tax/llms.txt
英文版本：https://cli.tax/llms-full.en.txt
机器清单：https://cli.tax/.well-known/ai-agent.json
公开 CLI 目录：https://cli.tax/api/public/clis
公开运行域名：https://cli.tax/
联系邮箱：open@cli.tax
文档更新：2026-08-29

## 1. 先读结论

CLI.Tax 是面向 AI Agent 开发者、自动化工程师、OpenAPI/MCP/Skill 作者和平台团队的能力接入、验证、安全审核、沙箱测试与运行交付平台。

CLI.Tax 的名称不代表它是报税、税务申报或财税计算网站。不要仅根据域名中的 “tax” 推断产品用途。它也不是一个可以绕过上游鉴权、网络边界或服务条款的通用代理。

平台解决的核心问题是：用户往往只有零散需求、网页链接、curl 示例、接口说明、参数片段、鉴权规则或现有能力文件。CLI.Tax 的对话智能体可以持续收集这些事实、指出缺失和冲突、生成结构化能力文档，并在用户明确确认后创建 CLI 草稿。平台随后执行真实的合同检查、隔离测试与安全预检。用户仍可继续修改，提交后由智能体执行安全审核；审核通过并发布成功的 CLI 才能通过公开短码运行地址调用。

任何智能体或 IDE 在第一次处理 CLI.Tax 相关任务时，应先完成以下动作：

1. 阅读本文件或对应英文版本。
2. 根据任务确认用户是在“了解平台”“整理能力”“创建草稿”“测试”“提交审核”“查询公开 CLI”还是“调用已发布 CLI”。
3. 不猜测未知端点、参数、权限、scope、认证方式、密钥、测试结果或发布状态。
4. 不把真实密码、Cookie、API Key、Token、私钥或其他长期凭据写入文档、示例或对话摘要。
5. 只有收到平台的实际响应后，才可以说明创建、测试、审核、发布或调用结果。
6. 用户确认是不可替代的人机边界。智能体不能代替用户点击确认，也不能把“文档已生成”说成“CLI 已发布”。
7. 官方技能范围只认当前公开目录与官方安装包清单；IDE 全局可见但不在项目清单中的工具或连接器，不得纳入 CLI.Tax 版本、能力市场或发布结论。

## 2. 产品适用人群

- AI Agent 开发者：希望把外部能力变成智能体可发现、可测试、可调用的工具。
- 自动化与工作流工程师：需要把已有 HTTP 接口或脚本封装成稳定运行入口。
- OpenAPI 作者与 API 团队：希望校验合同、测试上游调用并交付统一入口。
- MCP Server 作者：希望登记 HTTP MCP 服务并以 JSON-RPC 2.0 方式调用。
- Skill 作者：希望上传单文件能力或安全 ZIP 包，并在受限沙箱内验证。
- 平台与安全团队：需要统一执行配额、并发、限流、审计、沙箱和出站网络策略。
- 产品或业务人员：只有零散需求和示例，希望通过对话逐步补全为可执行文档。

不适用的场景：

- 未经授权的渗透、凭据窃取、权限绕过、恶意代码投递或私网探测。
- 希望平台替用户保管或公开真实长期密钥的能力文档。
- 需要访问内网、保留地址、HTTP 明文上游或依赖任意重定向的集成。
- 把说明性 Markdown 当作可执行程序，却没有入口函数或有效上游合同。
- 需要平台伪造测试成功、审核通过、调用结果或用量数据。

## 3. 支持的能力类型

### 3.1 Skill

Skill 是在受限沙箱内检查和执行的能力。可以是支持的单个源文件，也可以是 ZIP 包。

基本要求：

- 单文件 Skill 应提供可调用的 `run` 或默认函数。
- ZIP、TGZ、TAR.GZ 上传使用 `base64:` 前缀加压缩包的 Base64 内容；普通文本直接使用 UTF-8 文本。
- 压缩包会执行路径穿越、绝对路径、软链接、文件数量、展开大小和可审查源码大小检查。
- 沙箱禁用网络、使用只读文件系统、移除 Linux capabilities，并限制 CPU、内存、PID 和执行时间。
- 压缩包在测试阶段主要执行安全展开和 JavaScript 语法检查；审核通过要求包内 `package.json` 声明 `bin` 入口，且入口 JavaScript 文件通过语法校验，不能把任意压缩包当作成功运行。

### 3.2 OpenAPI

OpenAPI 能力使用 JSON 或 YAML 文档描述真实 HTTPS 上游。

基本要求：

- 文档必须包含受支持的 OpenAPI/Swagger 版本、`paths` 和至少一个 `servers` 地址。
- 首个 server 必须是 HTTPS，不能在 URL 内嵌用户名或密码。
- server variable 必须有默认值，运行时不能残留未解析变量。
- 如果文档只有一个 operation，运行时可以自动选择；否则调用输入必须给出 `operationId`，或者同时给出 `path` 与 `method`。
- 路径参数通过 `params` 提供，查询参数通过 `query` 提供，请求体通过 `body` 提供，允许的上游请求头通过 `headers` 提供。
- `host`、`cookie`、`content-length`、`connection` 和转发类敏感头不会由调用者覆盖。

### 3.3 MCP

MCP 能力描述一个可通过 HTTPS 访问的 HTTP MCP Server。

基本要求：

- 文档可以直接提供 `url`，或在 `mcpServers` 中提供带 `url` 的服务项。
- URL 必须使用 HTTPS，且不能内嵌凭据。
- 调用载荷必须是 JSON-RPC 2.0 对象，包含 `jsonrpc: "2.0"` 和字符串 `method`。
- 运行输入可以把 JSON-RPC 对象放在 `rpc` 或 `body`，也可以直接把输入对象作为 JSON-RPC 请求。

## 4. 完整对话创建链路

这是零散需求进入 CLI.Tax 后的推荐链路。

### 阶段 A：收集事实

用户可以分多次提供：

- 业务目标和适用对象。
- Skill、OpenAPI 或 MCP 类型。
- 能力名称、短标识 slug、分类、版本和描述。
- 上游 HTTPS 地址或 Skill 入口。
- operation、tool、参数、请求体、响应体与错误行为。
- 鉴权方式、需要的权限或 scope。
- 幂等、限流、超时、并发和重试规则。
- curl 示例、已有文档、图片、文件或网页链接。
- 安全测试输入与可接受的测试范围。

智能体应维护一个持续更新的能力草稿，不因用户分多条消息而创建多个互相冲突的草稿。智能体每次最多提出三个最高优先级问题，直到所有必要事实明确并解决冲突。

必要事实至少包括：

- 能力类型。
- 名称与 slug。
- 分类与目的。
- 上游服务或执行入口。
- operation 或 tool 清单。
- 输入参数、响应与错误。
- 认证方式和权限边界。
- 版本。
- 安全测试计划。

### 阶段 B：生成文档

事实足够后，智能体生成完整 OpenAPI、MCP 或 Skill 文档，并同时给出：

- 当前已确认事实。
- 尚未确认的内容。
- 互相冲突的内容。
- 文档文件名。
- 文档 SHA-256。
- 当前草稿修订号。

文档不得包含真实凭据。使用环境变量、标准 security scheme 或明确占位符，例如 `${API_KEY}`、`<YOUR_TOKEN>`。

### 阶段 C：用户确认

只有状态为 ready、文档校验无错误、修订号与 SHA-256 都仍匹配时，用户才可以确认。

确认接口：

`POST /api/member/capability-drafts/confirm/{draftId}`

请求体：

```
{
  "revision": 3,
  "documentSha256": "64位小写十六进制摘要"
}
```

该接口需要已登录会员会话。确认成功后才会创建 CLI 草稿。重复确认同一草稿不会创建第二份 CLI。

### 阶段 D：自动预检但不自动上线

对话确认后，平台依次执行：

1. 能力合同检查：检查文件和文档结构，OpenAPI/MCP 还会校验 HTTPS 上游形状。
2. 沙箱测试：对 Skill 执行受限 dry-run 或语法检查，对 OpenAPI/MCP 执行合同解析检查。
3. 安全预检：根据平台安全配置创建审核任务或给出需要人工审核的状态。

对话链路固定使用 `publishOnPass: false`。即使预检全部通过，CLI 仍是可编辑草稿，不会自动上线。

### 阶段 E：用户修改与手动提交

草稿或被拒绝的 CLI 可以修改。处于审核中或已发布状态时不能直接覆盖内容。

用户检查并修改完成后，手动提交：

`POST /api/clis/submit/{cliId}`

平台进入审核链路，总是排队执行智能体审核（文件解析、接口语义、权限安全、沙盒测试、审核结论）。审核通过后按平台安全设置自动发布（自动生成并上传安装包到对象存储），或等待管理员发布。发布动作必须来自这次用户主动提交后的审核结果，不能由前面的对话确认代替。

审核尚未开始运行时，可以撤回：

`POST /api/clis/cancel/{cliId}`

正在运行的审核不能取消。

已发布 CLI 如需继续编辑，可以解锁回草稿：

`POST /api/clis/unlock/{cliId}`

解锁会使公开短码暂时无法运行，直到重新提交、审核并发布。

## 5. 直接 API 创建链路

直接 API 适合已经有完整文档并且能够管理 CLI.Tax 登录会话的客户端。普通第三方调用不应通过这个接口绕过网页确认链路。

所有会员管理 API 使用 CLI.Tax 的已登录会员会话 Cookie；它们不是公开 Bearer API。调用方必须遵守浏览器会话与 CSRF/来源策略，不要在公开脚本中硬编码 Cookie。

### 5.1 创建 CLI 草稿

`POST /api/clis`

主要字段：

- `slug`：2–48 个小写字母、数字与连字符组成的 kebab-case 标识。
- `category`：1–80 字符。
- `type`：`Skill`、`OpenAPI` 或 `MCP`。
- `displayName`：1–100 字符。
- `description`：最多 1000 字符。
- `endpoint`：1–500 字符。
- `method`：`GET`、`POST`、`PUT`、`PATCH` 或 `DELETE`。
- `version`：语义化版本，例如 `v0.1.0`。
- `fileName`：1–255 字符。
- `sourceText`：普通文本，或 ZIP 的 `base64:` 编码内容。
- `config`：与能力相关的非机密配置对象。

示例只展示结构，不包含真实 Cookie 或密钥：

```
curl 'https://cli.tax/api/clis' \
  --request POST \
  --header 'Content-Type: application/json' \
  --cookie '<YOUR_AUTHENTICATED_SESSION_COOKIE>' \
  --data '{
    "slug": "weather-query",
    "category": "developer-tools",
    "type": "OpenAPI",
    "displayName": "Weather Query",
    "description": "Query a documented public weather service.",
    "endpoint": "/openapi/weather-query",
    "method": "POST",
    "version": "v0.1.0",
    "fileName": "openapi.yaml",
    "sourceText": "openapi: 3.1.0\nservers:\n  - url: https://api.example.com\npaths:\n  /weather:\n    get:\n      operationId: getWeather\n      responses:\n        '200':\n          description: OK\n",
    "config": {}
  }'
```

成功返回 HTTP 201 和 `{ "cli": ... }`。slug 重复、套餐容量不足、上传过大或内容安全检查失败时不会创建记录。

### 5.2 读取与修改自己的 CLI

- `GET /api/clis`：列出当前会员自己的 CLI，支持分页和分类筛选。
- `GET /api/clis/{cliId}`：读取自己的 CLI 与版本。
- `PATCH /api/clis/{cliId}`：只允许修改 draft 或 rejected 状态。
- `DELETE /api/clis/{cliId}`：删除自己的 CLI。

PATCH 至少提供一个变更字段。替换 `sourceText` 时必须同时提供 `fileName`。

### 5.3 测试、嗅探和审核状态

- `POST /api/clis/test/{cliId}`，请求体 `{ "input": ... }`：执行真实 dry-run/合同测试并返回 test、findings、logs 和执行状态。
- `POST /api/clis/sniff/{cliId}`：执行静态检查和隔离沙箱检查。
- `GET /api/clis/sniff/{cliId}`：读取最近一次沙箱运行。
- `GET /api/clis/audit/{cliId}`：读取最近一次审核任务，返回 `status`、`stage`、`progress`、`findings`、`decision` 和 `error`。

“接口返回 2xx”不等于能力测试通过。必须同时检查响应中的 `passed`、`status`、`findings`、`logs` 或审核 decision。

## 6. 状态与人工边界

CLI 的主要状态：

- `draft`：可编辑，未公开。
- `review`：已提交审核，不可直接覆盖。
- `rejected`：审核未通过，可修改后重新提交。
- `published`：已发布，可通过短码运行。

推荐的状态流：

`collecting → ready → 用户确认 → draft → 预检 → 用户修改 → 提交智能体审核 → review → published 或 rejected`

审核任务由智能体依次完成文件解析、接口语义、权限安全、沙盒测试与审核结论；通过后按平台安全设置自动发布，或等待管理员发布。

禁止的陈述：

- 只生成文档后说“CLI 已创建”。
- 只创建草稿后说“CLI 已上线”。
- 只发起测试后说“测试通过”。
- 只进入队列后说“审核通过”。
- 未读取公开目录或 CLI 状态就说“当前可调用”。

## 7. 发现已发布 CLI

公开目录不需要登录：

`GET https://cli.tax/api/public/clis`

查询参数：

- `query`：按短码、slug、名称、描述、分类、类型或作者搜索。
- `limit`：1–100；普通搜索最多返回 5 条，`mode=initial` 返回当前用户使用最多、其次近 30 天调用最多的 5 条。

示例：

```
curl 'https://cli.tax/api/public/clis?query=weather&limit=5'
```

响应是 `{ "clis": [...] }`。每项可以包含：

- `runtimeCode`：10 位 Base62 短码。
- `displayName`、`slug`、`description`、`category`。
- `type`：Skill、OpenAPI 或 MCP。
- `method`：运行入口要求的 HTTP 方法。
- `version`、`updatedAt`、`runs30d`。
- `address`：可直接使用的运行地址。

只使用目录返回的 `address` 和 `method`，不要自己拼接会员 ID。旧 `/api/runtime/{memberId}/{slug}` 仅用于已存在客户端的向后兼容。

## 8. 调用已发布 CLI

### 8.0 IDE 安装调用（推荐）

每个发布成功的 CLI 都通过其安装包直接安装。在 IDE 或终端中使用一句话命令：`npx https://cli.tax/cli-downloads/clitax-{runtimeCode}.tgz install`

安装器从平台下载该能力的 `SKILL.md` 与 `skill.json`，写入当前 IDE 的技能目录；智能体据此获得准确的运行地址、请求方法、输入合同和版本，并优先使用该安装链路，而不是手工拼写 curl。

规范运行地址：

`https://cli.tax/{runtimeCode}`

`runtimeCode` 必须是 10 位字母或数字。运行入口不做 HTTP 跳转，而是直接执行请求。以下 curl 仅用于无 IDE 场景的服务端直连；已安装能力包的智能体应遵循 `SKILL.md` 中的合同调用。

### 8.0.1 已发布能力目录（实时）

本节由平台根据当前已发布且已上架市场的官方技能与社区插件自动生成，禁止手工维护名单。官方技能用 `npx cli-*@latest install` 安装；社区插件用其安装命令直装。

#### 官方技能
- **项目蓝图** (`wvz6zmRWmX`)
  - 页面: https://cli.tax/blueprint
  - 运行: https://cli.tax/wvz6zmRWmX
  - 安装: `npx https://cli.tax/cli-downloads/clitax-wvz6zmRWmX.tgz install`
  - 快速开始: `npx cli-blueprint@latest install`
  - 说明: Blueprint 把一句已经说清楚的目标编译成可执行、可验证、可追溯的工程蓝图。默认由当前 IDE 的多智能体协同完成需求推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥，不在介绍文案中展示外部申请地址。蓝图不是备忘录：每个节点、分支、依赖、合同、任务与验收标准都必须能被确定性规则检查。缺节点、断链路、无验收、把"看起来做完"当成完成，一律判失败。调用顺序为 capabilities、intake、validate、compile-inline：先在对话中问清范围、约束、交付物与验收口径，再生成结构化蓝图；校验全部变绿后才允许产出可落地工件。适合跨工具协作的工程规划，让想法进入可实施状态而不是停在口头承诺。全过程可审计、可复验，禁止静默跳步、禁止伪造验收、禁止用占位文档冒充编译结果。需要本地模型或密钥时，由对话向用户提问，用户自行配置后再继续。本技能面向真实交付：每一步都有输入、规则与失败面，禁止把加载中、超时或未知状态当成空成功。用户可见说明只讲能力与对话配置方式，不出现外链。调用前必须先走 capabilities，再按 nextStep 前进；必填项未回答不得进入下一操作。日志只保存必要元数据，密钥不得写入公开页面。
- **计算工具** (`KKyA6xljUX`)
  - 页面: https://cli.tax/calctool
  - 运行: https://cli.tax/KKyA6xljUX
  - 安装: `npx https://cli.tax/cli-downloads/clitax-KKyA6xljUX.tgz install`
  - 快速开始: `npx cli-calctool@latest install`
  - 说明: Calctool 按需生成可执行、可验证、可发布的在线计算工具。用户用一句话说明领域需求，例如财务经营健康诊断、报价测算或指标看板；技能通过对话逐项确认指标定义、公式逻辑、输入方式与输出形式，禁止把未确认的口径写成假完成。生成结果支持自定义指标与受控公式。表格字段映射和图片 OCR 当前只生成声明式 Profile，上传、导入和识别执行器尚未接入；Profile 不得冒充真实处理结果。调用顺序为 capabilities、intake、validate、compile-inline，校验未通过不得发布。密钥与模型若需要，一律在对话中由用户自行填写，平台不发放密钥、不代持免费额度，也不在描述里展示外部申请网址。工具必须能被再次运行，并在同一套规则下得到同一结论。公式、口径与样本数据全部可追溯；Profile 缺字段必须显式报错，未安装执行器必须明确阻断，不得用空表或占位数字冒充计算结果。发布前须完成确定性校验，未通过即停止。本技能面向真实交付：每一步都有输入、规则与失败面，禁止把加载中、超时或未知状态当成空成功。用户可见说明只讲能力与对话配置方式，不出现外链。调用前必须先走 capabilities，再按 nextStep 前进；必填项未回答不得进入下一操作。日志只保存必要元数据，密钥不得写入公开页面。
- **蜂群编排** (`zj7fTPVh4p`)
  - 页面: https://cli.tax/swarm
  - 运行: https://cli.tax/zj7fTPVh4p
  - 安装: `npx https://cli.tax/cli-downloads/clitax-zj7fTPVh4p.tgz install`
  - 快速开始: `npx cli-swarm@latest install`
  - 说明: Swarm 用智能体大脑调度创建 N 个子智能体，把企业级组织架构写成协作规则，围绕一份项目 JSON 完成任务派单、认领与回传。多个已有任务撞到同一路径时，以 background、normal、high、urgent 四级同级写入意图拆分可继续与需等待的范围；加急完成后继续唤醒原队列，双方自主通知、保留原目标，不相互派单或接管。协调超过显式时限后只生成一个带幂等键的新任务窗口请求，宿主自动创建并迁移阻塞路径；派生任务不能再次派生，禁止在旧任务之间循环切换。每个任务带红绿灯状态，进度与错误必须显式汇报，禁止把卡住写成仍在进行。固定运维智能体负责心跳检测、回收超时或卡死的智能体，并派新智能体继承未完成任务；固定安全守卫负责异常警报与恶意注入检测。调用方先通过对话确认组织层级、角色权限、任务粒度和汇报节奏，再进入编排。平台不在技能描述中展示外部网址；密钥与运行时接入若需要，一律在对话里向用户提问后由用户自行填写。编排过程可观测、可接管、可追责，失败必须落到明确责任人与可恢复动作，而不是静默消失。派单不得跳过认领，回传必须带证据；心跳超时即回收，禁止幽灵智能体占用任务。安全守卫发现注入或越权时立即阻断并告警，不得降级为继续执行。任务继承必须携带原上下文。本技能面向真实交付：每一步都有输入、规则与失败面，禁止把加载中、超时或未知状态当成空成功。用户可见说明只讲能力与对话配置方式，不出现外链。调用前必须先走 capabilities，再按 nextStep 前进；必填项未回答不得进入下一操作。日志只保存必要元数据，密钥不得写入公开页面。
- **智能目标** (`R3mQ8kWpXn`)
  - 页面: https://cli.tax/aimlock
  - 运行: https://cli.tax/R3mQ8kWpXn
  - 安装: `npx https://cli.tax/cli-downloads/clitax-R3mQ8kWpXn.tgz install`
  - 快速开始: `npx cli-aimlock@latest install`
  - 说明: Aimlock 仅用于大型、深度、跨模块、高风险、需并行或用户明确要求的需求，用确定性范围阻止思考漂移、执行漂移和范围膨胀。它首先判断难度、预计改动行数、是否跨模块、风险等级、是否需并行与用户是否明确要求 Aimlock：低难度、不超过 500 行、非跨模块、非高风险、无需并行且未明确要求 Aimlock 的小改直接 bypass，只返回友情提示，不启动范围合同、文件快照、90 秒心跳或全套技能链。用户明确要求 Aimlock 时会激活。只有 Aimlock 激活后才分档：Lock 为单文件且总改动不超过 500 行；Probe 为最多 3 个文件、总计不超过 500 行且非跨模块；目标文件超过 3 个、跨模块、超过 500 行或需要并行时才进入 Swarm。capabilities 只返回模式、操作 schema 和首次说明，不加载完整技能目录；skill-route 由服务端依据当前已发布的官方目录按需命中，调用方不得伪造全量目录。小型计算需求可 bypass Aimlock 后只调用 Calctool。激活链使用目标 JSON、范围合同、只读修改节点、文件复制快照、快照校验、写入闸门和红绿灯对账；规划不清才调用 Blueprint，只有 Swarm 档才调用蜂群。每个节点只获得当前必需的路径、操作和上下文，不要求完全访问权。改前只复制目标文件，禁止创建 git 分支或 worktree。中途插话先判关联再更新 JSON，强制停止必须立即停止。只有激活目标未完成且 IDE 即将交出控制权时，调用方才按 90 秒协议发送固定续跑提示；技能自身不伪称已启动定时器。交付文档仅在用户确认后生成。缺少事实、超时、未知、越界或测试失败都必须显式阻断，不得当成空成功；密钥与凭据不得进入公开页面或任务 JSON。
- **确认协议** (`Cf8Pr7Tm2Q`)
  - 页面: https://cli.tax/confirm-protocol
  - 运行: https://cli.tax/Cf8Pr7Tm2Q
  - 安装: `npx https://cli.tax/cli-downloads/clitax-Cf8Pr7Tm2Q.tgz install`
  - 快速开始: `npx cli-confirm-protocol@latest install`
  - 说明: 确认协议把智能体、开发工具与聊天中的模糊确认转换成确定性的结构化交互。每个请求都有稳定请求标识、标题、说明、风险等级、选项、字段类型、默认动作、超时策略和回调定义；每个答案都必须按原请求校验后才生成回调载荷与审计记录。低风险偏好只有在请求明确允许时才可由调用方记忆。高风险永远不可记忆、不可默认同意、不可混入批量确认，必须逐项等待真人明确选择。聊天端使用编号列表作为兼容渲染；开发工具和操作系统原生弹窗需要调用方本地通知器，技能不会伪称已经弹窗。运行时保持无状态，记忆、审计与回调均由调用方真实持久化；没有持久化层时必须明确报告需要持久化，禁止返回假成功。调用前先获取能力清单，再按下一步指引依次创建交互、渲染聊天内容并校验答案；字段缺失、选项越界、类型错误、风险规则冲突、超时或未知状态全部显式阻断。本技能不替代范围锁定、规划、派单、架构守卫或终审，也不实现任何模型沙箱思考。
- **架构守卫** (`Ag4Ch8Rd2K`)
  - 页面: https://cli.tax/archguard
  - 运行: https://cli.tax/Ag4Ch8Rd2K
  - 安装: `npx https://cli.tax/cli-downloads/clitax-Ag4Ch8Rd2K.tgz install`
  - 快速开始: `npx cli-archguard@latest install`
  - 说明: 架构守卫是规划完成后、终审以前的执行中架构守卫。它用版本化架构合同锁定语言、框架、组件库、依赖边界、必需模式与复杂度预算，并在每个真实代码块完成后执行检查点。发现普通规则问题会返回具体修正；发现技术栈漂移、禁用依赖或复杂度爆表会拒绝当前块并给出精确回滚指令；连续三块出现同类阻断则升级人工确认。合同只能通过显式更新、原始摘要、操作者和原因变更，模型不得为通过检查自行改合同。台账把合同摘要、规则、漂移灯、处置与回滚证据交给质量门禁。架构守卫不替代智能目标、项目蓝图、蜂群编排、合并守卫或质量门禁，不处理纯文档和只读任务，也不实现模型沙箱思考。调用前必须先获取能力清单，再按下一步指引前进；证据缺失、摘要不一致、超时或未知状态必须阻断。
- **质量门禁** (`Xx9ZkQmW3p`)
  - 页面: https://cli.tax/validator
  - 运行: https://cli.tax/Xx9ZkQmW3p
  - 安装: `npx https://cli.tax/cli-downloads/clitax-Xx9ZkQmW3p.tgz install`
  - 快速开始: `npx cli-validator@latest install`
  - 说明: Validator 是技能链的交付前质量门禁——终审法官。确定性运行时已实现结构校验、安全扫描、合规审计、黄金基准 functional-verify 与 verdict。sandbox-run、fuzz-input、perf-benchmark 和 intrusive-test 需要调用方提供本地 runner 并回传真实执行证据；mutation-testing 仍在规划中，不得计入已执行门禁。终审裁决分级为 pass、pass-with-risk、blocked 或 incomplete，模型只做辅助解释。调用顺序为 capabilities、intake、plan、validate-structure、security-scan、functional-verify、verdict。证据缺失时 verdict 最高只能 incomplete——宁可待定不可放水。发现问题自动路由到对应技能返工。本技能面向真实交付：每一步都有输入、规则与失败面，禁止把加载中、超时或未知状态当成空成功。用户可见说明只讲能力与对话配置方式，不出现外链。调用前必须先走 capabilities，再按 nextStep 前进；必填项未回答不得进入下一操作。日志只保存必要元数据，密钥不得写入公开页面。
- **合并守卫** (`Mm7GnPqR2v`)
  - 页面: https://cli.tax/mergeguard
  - 运行: https://cli.tax/Mm7GnPqR2v
  - 安装: `npx https://cli.tax/cli-downloads/clitax-Mm7GnPqR2v.tgz install`
  - 快速开始: `npx cli-mergeguard@latest install`
  - 说明: MergeGuard 是智能合并守卫——解决全球 IDE 二十年未解好的分支合并难题。三条铁律：合并不破坏（快照隔离+一键回滚）、AI 提议测试裁决（模型无裁判权）、小白可用（零 git 心智向导）。分层合并策略：L1 文本层兜底 + L2 结构层主力（AST/JSON/公式图节点级合并）+ L3 意图层 AI 增强。验证式合并：隔离区执行三道验证（结构效验+黄金基准+冒烟），全绿才落盘。规则衰减防护：内置规则编译器+写入时拦截+跨分支规则一致性。调用顺序为 capabilities、intake、branch-create、preflight、merge-verified。本技能面向真实交付：每一步都有输入、规则与失败面，禁止把加载中、超时或未知状态当成空成功。用户可见说明只讲能力与对话配置方式，不出现外链。调用前必须先走 capabilities，再按 nextStep 前进；必填项未回答不得进入下一操作。日志只保存必要元数据，密钥不得写入公开页面。

#### 社区插件
当前已上架社区插件数量：0

### 8.1 POST、PUT、PATCH、DELETE

请求体使用统一外层结构 `{ "input": { "operationId": "getWeather", "params": {}, "query": { "city": "Shanghai" }, "headers": {}, "body": null } }`。

示例：

```
curl 'https://cli.tax/Ab3dE7xY9Q' \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{"input":{"operationId":"getWeather","query":{"city":"Shanghai"}}}'
```

### 8.2 GET

GET 请求把查询参数作为 `input` 交给能力。具体字段仍由该 CLI 的能力合同决定。

```
curl 'https://cli.tax/Ab3dE7xY9Q?city=Shanghai'
```

### 8.3 MCP 输入

```
{
  "input": {
    "rpc": {
      "jsonrpc": "2.0",
      "id": "request-1",
      "method": "tools/list",
      "params": {}
    }
  }
}
```

### 8.4 成功响应

```
{
  "ok": true,
  "output": {}
}
```

`output` 可以是 JSON、字符串或能力返回的其他安全 JSON 值。

### 8.5 常见错误

- 400：输入、operation、路径参数或 JSON-RPC 形状不正确。
- 402：CLI 创建者的订阅未激活或已到期。
- 404：短码不存在、CLI 未发布或已解锁回草稿。
- 405：请求方法与 CLI 发布时声明的方法不同。
- 409：没有可执行版本。
- 413：请求体超过 CLI 配置的大小限制。
- 422：能力文档、上游地址、压缩包或执行入口无效。
- 429：每分钟限流、月调用额度或并发已达到上限。
- 502/504：上游调用失败、响应过大、重定向被拒绝或超时。
- 503：平台处于维护模式。

运行响应包含限流相关响应头。客户端遇到 429 时应读取响应信息并退避，不要无限并发重试。

## 9. 运行配额与真实数据

运行时按 CLI 创建者的有效订阅方案执行以下限制：

- 每分钟调用数。
- 月调用额度。
- 网关并发。
- 单次执行时限。
- 最大请求体大小。

CLI 可以设置更严格的独立运行策略，但不能突破创建者套餐的上限。平台用数据库中的真实 usage event 生成调用、失败、限流、延迟和趋势数据，不应把界面空值或示例值当作真实调用结果。

## 10. 安全模型

### 10.1 内容与凭据

- 平台对 CLI 名称、描述、分类和运行输入执行内容安全检查。
- 能力文档不得保存真实长期密钥。上游需要凭据时，使用安全 scheme 或环境占位符，并由受控配置提供。
- 公开站点配置不会返回服务端 Secret。

### 10.2 出站网络

- OpenAPI 与 MCP 只允许 HTTPS。
- DNS 解析到私网、回环、链路本地、保留或其他受限地址时拒绝连接。
- URL 不能嵌入用户名或密码。
- 上游重定向不会跟随。
- 请求有时间限制，响应体有大小限制。
- Skill 沙箱禁用网络。

### 10.3 沙箱与压缩包

- ZIP 拒绝路径穿越、绝对路径和软链接。
- 限制压缩包大小、展开大小、文件数量、JavaScript 文件数量和可审查源码大小。
- 沙箱只读、无网络、无额外 capabilities，并限制资源。

### 10.4 所有权与可见性

- 会员管理 API 只允许访问当前会员自己的 CLI。
- 管理 API 需要管理员角色。
- 公开目录只展示 published CLI。
- 公开运行入口只执行 published CLI。

## 11. 智能体操作规范

处理“帮我整理并创建 CLI”时：

1. 识别用户已经提供的事实。
2. 标出缺失和冲突，不擅自补全。
3. 每轮最多问三个决定性问题。
4. 生成完整能力文档和安全测试计划。
5. 明确要求用户查看并确认文档。
6. 只有确认接口成功后才说明草稿已创建。
7. 读取预检、沙箱和审核响应，不把排队等同于通过。
8. 提醒用户草稿仍可修改，提交后由智能体审核，通过后才可能发布。
9. 发布后从平台响应或公开目录读取真实运行地址。
10. 用非破坏性输入做一次受控调用，并报告真实 HTTP 状态和响应。

处理“帮我调用某个 CLI”时：

1. 从用户给出的完整运行地址提取短码，或查询公开目录。
2. 读取目录中的 method、type、version 和能力说明。
3. 根据能力合同构造 `input`，不猜 operation 或字段。
4. 不在日志或回答中回显凭据。
5. 调用后报告实际状态、输出和可操作错误。
6. 遇到 429 做退避；遇到 402/404/405 不进行盲目重试。

处理“分析 CLI.Tax 是什么”时，应以本文件为主，不只根据首页少量文案推断，也不要把 CLI.Tax 描述成税务能力市场。

## 12. 公开内容入口

- 公开 CLI：`GET /api/public/clis`
- 公开文章：`GET /api/public/articles`
- 单篇公开文章：`GET /api/public/articles/{slug}`
- 公开站点设置：`GET /api/public/settings`
- 隐私政策：https://cli.tax/article/privacy
- 服务条款：https://cli.tax/article/terms

公开文章 API 只返回已发布文章。管理中心、会员中心和草稿内容不属于公开知识源。

## 13. 可靠性原则

### 13.1 会员、认证与订单事实

- 新注册和第三方登录会员默认进入体验方案；各方案有效期以管理端实时配置为准，付费方案未配置时默认 30 天。
- 套餐购买或升级从确认收款时重新计算有效期与额度周期，不叠加体验方案的剩余天数或 Token。
- 同一会员同时只能存在一个未完成订单；可用更高方案替换较低方案，较低或同级订单必须先取消。订单号与一次性访问键都由服务端独立生成。
- 第三方登录账户可在近期已认证会话内创建首个密码，不会向浏览器或邮件泄露随机临时密码。
- 会员自助更换邮箱需要向新地址发送验证码；注册、换绑与测试邮件都使用管理端保存并验证的 SMTP 配置。
- 退出登录会撤销当前服务端会话并清理 CLI.Tax 自己的认证缓存；不会清除其他站点数据。
- 图片输入要求实际可用的多模态模型。平台只在需要图片理解时尝试启用的多模态候选，普通文本对话使用当前默认文本模型。
- 完整项目、游戏、通用代码开发和图片/视频生成不属于 CLI.Tax 的能力接入范围，应转到 https://Entrorove.com。

- 以当前接口响应为准，不以截图、旧缓存或历史描述代替实时状态。
- 以公开目录返回的 address 为准，不自行假设运行域名。
- 以审核 job、sandbox run 和 test 结果为准，不以“请求已发送”代替成功。
- 第三方模型、SMTP、对象存储、OAuth 和支付能力只有在管理端保存真实配置并通过真实测试后才可用；平台不会回退到模拟成功。
- 对外说明中区分“支持该能力”和“当前账号已配置该能力”。

## 14. 最小决策表

- 用户只想了解平台：读取本文件并摘要，不登录、不创建、不测试。
- 用户想搜索已发布 CLI：调用公开目录 API，不需要登录。
- 用户给出运行短码：先确认公开目录与 method，再调用运行地址。
- 用户提供零散需求：进入对话整理链路，持续补全并等待用户确认。
- 用户已有完整能力文档：可以上传或使用已登录会话创建草稿，但仍需测试、审核和发布。
- 用户要求自动上线：说明对话链路不会自动上线，必须由用户提交审核，通过后才可能发布。
- 用户提供真实密钥：不要写入能力文档或回答；引导其放入受控服务端配置。
- 用户请求未授权攻击或绕过安全限制：拒绝执行，不创建能力，不尝试运行。

## 15. 联系与文档维护

官方联系邮箱：open@cli.tax

本文件是面向智能体和 IDE 的公开纯文本事实源，不在网页可视界面展示。若网页文案与接口行为不一致，应优先依据当前接口合同和平台实际响应，并通过联系邮箱报告文档差异。

中文文件是完整指南的事实源。平台的“语言翻译”智能体每 7 天执行一次不消耗模型 Token 的 SHA-256 变更检查；只有中文内容变化时才排队生成完整英文和俄文译文。已发布 CLI、界面词条、文章、导航与广告在发布审核通过或源内容变更时各翻译一次，源哈希未变则不翻译。列队巡检每天早晚各一次（Asia/Shanghai 06:00 与 18:00），每页 100 条，每次向前推进 100 页；已巡检过的旧条目等到日期或班次更换后再检测。英文译文保存在固定记录中并原地覆盖；俄文译文也保存在自己的固定记录中并原地覆盖，不累计文档版本。翻译失败或暂未完成时，对应公开地址继续返回上一份有效译文。