# @happyvertical/smrt-mcp-openai 中文文档

规范地址：https://npmcn.com/package/%40happyvertical/smrt-mcp-openai/

版本：0\.62\.1
npm 元数据更新时间：2026-11-17T07:54:38.459Z
中文译文更新时间：2026-11-17T09:55:34.738Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：239 kB，61 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-10-15T06:07:05.963Z
- 最新版本发布：2026-11-17T07:54:36.891Z
- 近 30 天下载量：16797（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：128（近 12 个月 128 个）

## 中文简介

SMRT MCP Apps 的可选 OpenAI 导航和设置

## 安装

```sh
npm install @happyvertical/smrt-mcp-openai
```

也可以使用：`pnpm add @happyvertical/smrt-mcp-openai`、`yarn add @happyvertical/smrt-mcp-openai`、`bun add @happyvertical/smrt-mcp-openai`

## README

# @happyvertical/smrt-mcp-openai (英语)

可选导航,设置,上下文,消息和提及 s-m-r-t MCP Apps. 普通的S -m -r -t应用程序没有 导入此软件包。 这个 `./client` 条目是只使用浏览器并取决于 便携式 `@happyvertical/smrt-mcp-apps` 桥; 根项由已存在的 app-MCP工作流程不创建另一个服务器或授权政策.

## 合同和范围

该套软件包执行下列儿童的导航/设置和背景/信息/感知: [3202号](https://github.com/happyvertical/smrt/issues/3202) 下划线 [M0 集成标准](https://npmcn.com/package/docs/content/architecture/mcp-apps-integration.md)数字 :

-   全球和线程条目元数据 `{}`。 。 。 .
-   结构化原始设置和权限过滤布局动作; 现代 发现广告 `capabilities.extensions['openai/settings']` 仅在 两个设置工具都在请求的授权目录中.
-   资源显示模式元数据和可移植显示请求,并带有内置倒计时.
-   经验证的本地/网络应用程序链接和观察到的主机深层链接通过一个 已存在的域授权读取工具.
-   登机申报表;包装技能/资产核查属于M7.

精确基线 : [OpenAI 扩展光谱 e314720](https://github.com/openai/mcp-extensions/blob/e314720a0daac326217d1f123fcf51647868fa9f/docs/spec.md), (中文(简体) ), 在协调世界时2026-09-30日重新认证为上游主干线 [正式扩展指南](https://developers.openai.com/plugins/build/extensions) 财务报告和审定财务报表 [用户界面指南](https://developers.openai.com/plugins/build/chatgpt-ui). SDK v1 (英语) OpenAI 帮助者是故意不依赖的. 服务器运输使用本地 范围 MCP SDK 2.0.0 / 协议 `2026-07-28`; 浏览器应用 `2026-01-26`。 。 。 .

仅宣布已执行的特性。 文件/表格仍然是单独的计划M6儿童。 设置支持布林斯,字符串/enums/长边框, 数字/输入器/距离/多边。 任意的regex模式是明确的 拒绝以避免运行未绑定的图案; 应用程序可以使用 enum 或 一个已存在的域验证符。 没有静默的降级计划发生. 元数据为 以64 KiB为界,深度为16;设置为64字段,字符串为4096字符, 路线到2048字符。 未知字段/ 类型已关闭 .

## 服务器组成

使用 `withOpenAiEntrypoints(existingReadWorkflow, ['global', 'thread'])` 通过 的结果 `createMcpAppServer({ workflowTools })`保留 处理器和便携式 `_meta.ui.resourceUri`初步工具成果仍然 没有重复的进入点呼叫。 给出线索视图不同的描述性标题.

`bindOpenAiSettings({ schema, read, update, server: () => appServer })` 包裹两个 现有工作流程定义。 添加其内容 `workflows` 到服务器上,然后挂载 与 `extensions: ({ tools }) => settings.extensions(tools)`复选运行 打开 `server/discover` 使用相同的经核实的主目录和经过过滤的目录 用于发现工具。 说明或扩展元数据都不允许.

读取处理器返回 `structuredContent: { schema, values, layout? }`,带有 每个财产的价值。 更新处理器收到 `{ set: { changedField: value } }` 返回时 `structuredContent: { values }`。更新是绝对值任务, 不切换或递增。 约束性核查其宣布的读取/写出效果, 需要一能的指派,验证投入/产出,并永不重复.

**业主必须批准资源所有权,重新检查现租户 并持续使用现有执行人和 修订政策.** 适配器不提供持久性,交易守护, 或域批准。 主机电线合同没有修订参数;不添加 一个被发明的字段。 需要人力审查/修订标志的工作流量应保留 而不是强迫它进入本地环境。 测试 运行自有的 SQLite 交易, 守护更新, 滚回和重试 .

过 `openAiDisplayMetadata({ availableDisplayModes: ['inline', 'fullscreen'], preferredDisplayMode: 'fullscreen' })` 作为已宣布的资源 `metadata`。 。 。 . 资源安全元数据和文摘仍为应用MCP所拥有. `pip` 不属于 上面写着OpenAI显示合同 输入字段保存上游默认值; 首选项仍然是提示.

`openAiOnboardingDeclaration('./skills/setup/SKILL.md')` 仅返回 `{ extensions: { 'com.openai': { onboardingSkill: ... } } }`合并到 插件显示; 它不安装或执行该技能 .

## 浏览器导航和倒置

导入 `./client`,通过现有的 `McpAppBridge` 改为 `observeOpenAiNavigation({ bridge, resolveTool, onResult, onFallback })`电话 卸载时返回的处置者。 它的消耗范围 `rawHostContext` 从 桥的验证来源/来源和寿命周期,仅承认 `openai/deepLink: { url }`,并使用 `{ url }`。 。 。 . 域工具必须拒绝被猜测或交叉租户对象. 服务器应用程序 可使用 `resolveOpenAiNavigationTarget` 只发送授权的读取工具.

重复的相同路线不重复呼叫; 新路线取消旧请求 并且忽略了陈旧的答复。 URL是相适应的,无碎片的,无逆向的, 并拒绝协议相对、双编码和控制特征表格。 处理 查询参数作为不信任输入,绝不作为身份或批准。 字义 查询分隔器在路径名解码之前分离, 所以编码了问号 无法隐藏向上段 。 查询值中类似 Traversal 的文本仍然合法 .

只有被拒绝的工具呼叫或 `isError` 结果选择 `denied` 倒计时. 消费者回调例外并非授权失败, 也绝不重试 倒计时。 回调会处理自己的渲染错误; 未发现的例外 在一个同步的结果/倒计时回调中,作为未处理的承诺拒绝.

`createOpenAiAppLink` 释放被绑住的桌面( e)`codex`),移动(`chatgpt`)或网络 格式,有单独编码的插件/工具/路径组件. `openAiNavigationLink` 需要明确 `'present'` 支持选择本地链接; `'absent'`不详 或错误支持使用配置的 HTTPS 应用程序 URL。 此支持投入 是一个部署/观察者的决定, **未发明的 MCP 能力字段**。 。 。 . 入境点/登入点同样没有贴有标签的客户广告; 保留普通工具/设置导航。 本地结构设置为 选项:相同的设置工具和应用程序设置页仍然可用.

`requestOpenAiDisplayMode` 使用经商的便携式模式; 缺少/未知模式 或被拒绝的请求返回 `'inline'`。UI必须保留其内在 当导航无法解决时,布局和制成普通链接.

## 背景、信息和作曲者提到

浏览器消费者导入 `updateOpenAiModelContext` 从 `./context` 财务报告和审定财务报表 `sendOpenAiMessage` 从 `./messages`。服务器消费者导入 `withOpenAiMentionSearch` 财务报告和审定财务报表 `resolveOpenAiMentionSelection` 从 `./mentions`。 。 。 . 这些子路径共享现有的可移植桥和授权的app-MCP服务器.

`updateOpenAiModelContext({ bridge, value, native })` 将上下文替换为 `{ text: { text, title?, thumbnail? }, structuredContent? }`文本为非空并 最多16384个字符; 标题限制为512个. 设定 `background: true` 的文本值,以发送仅限助手的受众 元数据; 背景是演示文稿 提示, **非隐私边界**:模型/提供者仍然收到上下文. 只发送该收件人授权的数据 。 谈判 `openai/modelContext` 使用提供的本地调用。 缺少支持或本土故障倒计时 改为可移植文本和结构化内容,没有本地元数据。 中止/处置 防止后退.

`sendOpenAiMessage({ bridge, value, native })` 接受文本,并 `target: 'active'` (默认)或 `'new'`。主动对话可以使用便携式短信. 新对话需要谈判 `openai/message` 和本土召回; 在信件到达活动方之前, 丢失或错误支持拒绝 谈话 未知目标/模式无法关闭, 发送没有重试 .

`withOpenAiMentionSearch(existingReadWorkflow)` 声明只使用应用程序的作曲搜索 元数据和 a `{ query }` 输入(最多256个字符,包括空搜索). 它自己的处理器返回 `structuredContent: { items }`,最多25个 `{ type: 'resource', resourceUri, title, subtitle?, icons? }` 条目。 处理 是非空的不透明字符串,最多为2048个字符;标题/子标题是 非空地,并被限制在512。 最多8个图标都要求 `src` (2048年), (中文(简体) ), 可选 `mimeType` (128) 最多8个非空地 `sizes` 字符串( 每个32个), 财务报告和审定财务报表 `theme: 'light' | 'dark'`。未知字段和错误的数值拒绝. 已出版的输出计划描述了这些相同的被关闭对象和限制.

搜索结果就是发现提示,从不授权. 传递精确 已返回 `resourceUri` 作为当前选择工作流程的参数 `resolveOpenAiMentionSelection({ server, tool, arguments, principal })`编辑 应用程序提供可信、新解决的本金; 应用- MCP 政策 重新检查演员、现租户、范围和每个电话的会员资格,以及 拥有工作流程重新检查处理所有权。 永远不要从手柄中获取身份, 浏览器元数据或搜索时间权限 。 我猜,交叉租借电话和 搜索后撤销不能选择私人数据 。 此帮助添加了否 选择处理器、身份提供者、持久性或授权政策.

## 审定和证据

运行 `pnpm install`,然后记录到依赖性构建和包口:

```sh
pnpm exec turbo build --filter=@happyvertical/smrt-mcp-openai...
pnpm --filter @happyvertical/smrt-mcp-openai typecheck
pnpm --filter @happyvertical/smrt-mcp-openai test
pnpm --filter @happyvertical/smrt-mcp-openai test:e2e
pnpm --filter @happyvertical/smrt-mcp-openai verify:pack
```

行为/威胁矩阵在 [TEST-DESIGN.md (中文(简体) )](https://npmcn.com/package/%40happyvertical/smrt-mcp-openai/TEST-DESIGN.md). 礼宾测试 使用 SDK 客户端和 HTTP 挂载, 包括 JWKS/ MCP 套接字 通过公开的 M2 认证网关, 并附有符号、 演员、 租户和撤销拒绝; 浏览器套件使用真实的 Chromium 沙盒式iframe 有无网络 CSP并构建了浏览器输出. 包装出口 检查声明和浏览器/服务器边界。 现有应用程序- MCP 完整 成套/类型检查/包件和便携式桥门也适用于集成变化. 协调员安排所有根口和独立审查.

**未声称实际 OpenAI 主机兼容性 .** 合成主机没有 证明桌面、工作网络、iOS、Android或账户滚动支持。 没有配置 提供了OpenAI主机连接或可部署注册的合成插件; 记录准确的主机/建设/平台、认证配置、资产修订和观察 导航/设置结果,然后要求支持的宿主接受。 这个 上游支持矩阵仅是预期支持;网络指Work,不包括 经典的ChatGPT. M8型机车的实际接收仍开放.

## 常见问题

### @happyvertical/smrt-mcp-openai 是什么？

SMRT MCP Apps 的可选 OpenAI 导航和设置

### 如何安装 @happyvertical/smrt-mcp-openai？

在项目目录运行 npm install @happyvertical/smrt-mcp-openai，或使用 pnpm add / yarn add / bun add。

### @happyvertical/smrt-mcp-openai 支持 TypeScript 吗？

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

### @happyvertical/smrt-mcp-openai 支持 ESM 还是 CommonJS？

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

### @happyvertical/smrt-mcp-openai 可以商用吗？

@happyvertical/smrt-mcp-openai 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @happyvertical/smrt-mcp-openai 的下载量有多少？

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

### @happyvertical/smrt-mcp-openai 还在维护吗？

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

