# @fortrip/agent-contract 中文文档

规范地址：https://npmcn.com/package/%40fortrip/agent-contract/

版本：6\.0\.0
npm 元数据更新时间：2026-11-14T12:05:49.882Z
中文译文更新时间：2026-11-15T09:45:10.957Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fortrip/agent-contract
原文对照：https://npmcn.com/package/%40fortrip/agent-contract/?lang=original
项目主页：https://github.com/FortripEngineering/fortrip#readme
源码仓库：https://github.com/FortripEngineering/fortrip

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：461 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：zod ^4\.4\.0
- 首次发布：2026-10-22T14:12:01.567Z
- 最新版本发布：2026-11-14T12:05:49.465Z
- 近 30 天下载量：7071（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

Fortrip的代理人API的合同([https://api.fortrip.ai/v1 (英语)](https://api.fortrip.ai/v1))及其MCP服务器:限制,路径,请求和响应计划,出错代码和字段规则.

## 安装

```sh
npm install @fortrip/agent-contract
```

也可以使用：`pnpm add @fortrip/agent-contract`、`yarn add @fortrip/agent-contract`、`bun add @fortrip/agent-contract`

## README

# @ fortrip/代理合同

Fortrip API v1的合同(`https://api.fortrip.ai/v1`)及其MCP 服务器( e)`https://mcp.fortrip.ai/`:限制、路径、请求和答复 fortrip CLI 的策略、错误代码和字段规则(`fortrip`页:1 主机为 MCP 服务器, 商店则列出全部共享, 因此无法漂移 分开.

它有一个同伴依赖, `zod` (单位:千美元)`^4.4.0`),并随地而跑 ES2023确实如此. 其主要版本在合同解除时发生变化,而不是 aPI 代码 : `6.x` 服务 Fortrip API v1.

```ts
import { API, LIMITS, PUBLIC_ORIGINS, containsCardNumber } from "@fortrip/agent-contract";

PUBLIC_ORIGINS.api + API.hotelSearch; // "https://api.fortrip.ai/v1/hotels/search"
LIMITS.rooms; // 8
```

出口:

-   `API`, (中文(简体) ), `PUBLIC_ORIGINS`, (中文(简体) ), `MCP_PATH`, (中文(简体) ), `LIMITS`, (中文(简体) ), `ERROR_CODES`, (中文(简体) ), `SEARCH_SORTS` 财务报告和审定财务报表 `FILTERABLE_AMENITIES`: 路径、主机、限制、出错代码 和词汇;
-   `searchHotelsInput`, (中文(简体) ), `getHotelInput`, (中文(简体) ), `hotelOffersInput`, (中文(简体) ), `createOrderInput`, (中文(简体) ), `getOrderInput`, (中文(简体) ), `listOrdersInput`, (中文(简体) ), `cancelOrderInput` 财务报告和审定财务报表 `payOrderInput`请求的zod计划, 与 `offersPerHotel(limitPerHotel, hotelsWithOffers)`,每个报价 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}请客的宾馆接到电话 `misplacedKeys(schema, issues, sent)`, (中文(简体) ), 在错误的深度发送的密钥所在处 `misplacedKeyHint(key)`, (中文(简体) ), 怎样告诉打电话的人 `searchResult`, (中文(简体) ), `hotel`, (中文(简体) ), `hotelOffersResult`, (中文(简体) ), `order`, (中文(简体) ), `orderList`, (中文(简体) ), `paymentHandler` 财务报告和审定财务报表 `errorEnvelope`开放的策略 答复 `ERROR_DETAILS`,每个错误代码 `details`,以及 `parseOpen`,一个保存未知字段和值的解析器;
-   `COMMANDS`, (中文(简体) ), `COMMAND_GROUPS` 财务报告和审定财务报表 `GLOBAL_FLAGS`,CLI的命令,以及 以他们的旗子和旗子盟誓, `commandInvocation(spec)`页:1 命令按其输入方式( q)`fortrip hotels search`, (中文(简体) ), `TOOLS`,“MCP” 工具,以及 `SERVER_INFO`,用于Fortrip的 MCP 服务器如何描述自己;
-   `renderToolResult(tool, data, surface?)` 财务报告和审定财务报表 `renderError(envelope, status?, surface?)`,结果的全文或 错误,命名工具(`"mcp"`,默认值)或命令和旗帜 (单位:千美元)`"cli"`:一个MCP结果就是这个文本块,没有添加. 这个 最终结果的规则也被导出( e)`ORDER_NEXT_STEP`, (中文(简体) ), `CANCEL_NEXT_STEP`, (中文(简体) ), `PAY_NEXT_STEP`, (中文(简体) ), `PRESENTATION_HINT`,以及 `cancelNextStep(surface)` 财务报告和审定财务报表 `payNextStep(surface)`,该词2 用来 `"mcp"` 或者说 `"cli"`),以及 `renderGuide(surface, topic)`,代理人 以 Markdown 为指南 `"mcp"`, (中文(简体) ), `"claude-skill"` 或者说 `"cli"`· ;
-   字段规则,例如 `containsCardNumber`,客名规则和日期 帮助者,和 `CONTRACT_VERSION`。 。 。 .

浏览器代码,只需要宾名规则(`GUEST_NAME_PATTERN`, (中文(简体) ), `GUEST_NAME_TITLE`, (中文(简体) ), `GUEST_NAME_MESSAGE`, (中文(简体) ), `guestNameRe`, (中文(简体) ), `normalizeGuestName`(中文(简体) ) 可以从 `@fortrip/agent-contract/guest-name`。该模块导入 没有包裹,所以它不会拉进来 `zod` 或建立根项的计划 满载。 根入出同名.

Apache License 2.0 (2.0: MIT前的版本). 版权2026 FortripAI, Inc. "Fortrip"是FortripAI股份有限公司的商标. 执照不颁发 允许使用商品名、商标、服务标志或产品名称 用于合理和习惯用途的除外 描述软件的出处并复制了NOTICE的内容 文件(第6节) 资料来源: [https://github.com/FortripEngineering/fortrip/tree/main/packages/ Contract 互联网档案馆的存檔,存档日期2013-12-02](https://github.com/FortripEngineering/fortrip/tree/main/packages/contract)。 。 。 .

## 常见问题

### @fortrip/agent-contract 是什么？

Fortrip的代理人API的合同\(https://api\.fortrip\.ai/v1 \(英语\)\)及其MCP服务器:限制,路径,请求和响应计划,出错代码和字段规则\.

### 如何安装 @fortrip/agent-contract？

在项目目录运行 npm install @fortrip/agent-contract，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.4\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fortrip/agent-contract 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fortrip/agent-contract 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fortrip/agent-contract 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fortrip/agent-contract 可以商用吗？

@fortrip/agent-contract 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @fortrip/agent-contract 的下载量有多少？

根据 npm 官方下载统计，@fortrip/agent-contract 在 2026/10/16 – 2026/11/14 这 30 天内被下载 7,071 次，日均约 236 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fortrip/agent-contract 还在维护吗？

最新版本 6\.0\.0 发布于 2026/11/14（1 天前）；至今共发布 31 个版本，其中过去 12 个月发布了 31 个；首次发布于 2026/10/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。