# @coda-console/ultra 中文文档

规范地址：https://npmcn.com/package/%40coda-console/ultra/

版本：1\.2\.2
npm 元数据更新时间：2026-10-31T18:20:36.232Z
中文译文更新时间：2026-10-31T19:58:39.568Z
软件包许可：MIT

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

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

弃用说明：已并入 @coda-console/composer（输入框模式），请改用它

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

- 包体积（解压后）：18.9 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-30T10:05:07.836Z
- 最新版本发布：2026-10-31T15:30:05.308Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

输入框的 Ultra 协调模式：节省主 Agent 的 Token 和上下文，非微小任务的执行默认交给 Coda 子会话，串行任务也委派。主 Agent 负责决策、调度和验收。名单在模式参数里改，常用的存成模板。

## 安装

```sh
npm install @coda-console/ultra
```

也可以使用：`pnpm add @coda-console/ultra`、`yarn add @coda-console/ultra`、`bun add @coda-console/ultra`

## README

# Ultra

> Ultra 已并入 [`@coda-console/composer`](https://npmcn.com/package/%40coda-console/composer/README.md)（输入框模式）。本包暂时保留，待 Coda 完成设置迁移后再处理；新插件的模板设置为 `composer.templates`。

输入框的 Ultra 协调模式（Coda 的[输入框模式](https://github.com/coda-console/coda/blob/main/docs/plugins.md#%E8%BE%93%E5%85%A5%E6%A1%86%E6%A8%A1%E5%BC%8F)）：在保持质量的前提下，节省主 Agent 的 Token 和上下文。 主 Agent 负责定义任务、困难决策、调度和验收，非微小任务的主要执行工作按名单用 `spawn` 派给 Coda 子会话；关键路径和需要串行执行的任务也委派。 只有整个请求已经明确、简短答复或一次显然的局部操作就能完成时，主 Agent 才直接做，例如已知位置的错字或简单状态查询。 不能把复杂任务拆成单条命令逐个自己执行；小任务一旦需要排查或调试，就交给子会话。

从 Coda 的商店安装（npm 包 `@coda-console/ultra`，分类「工作流程」），不随 Coda 默认装上。Coda 不认识 Ultra：模式、参数、给 Agent 的话都在这个插件里。

**用法**：会话或新任务的输入框里打 `/ultra`（或在 `/` 菜单、iPhone 的「+」里选），输入框进入 Ultra；在新任务里进入，发出第一条后开出的会话就在 Ultra 里，模式条上写着所选的模板和名单里 Agent 的图标；点模式条打开参数：

| 参数 | 是什么 |
| --- | --- |
| 模板 | 设置 `ultra.templates` 里的模板，加「自定义」；选一个就把名单换成它的，手动改了名单就变成「自定义」。进入时取排第一的模板；没有模板时为「自定义」，名单为空 |
| 子 Agent | 名单，一行一个：Agent 组合（Agent、模型、推理强度、配置项）和「什么时候派给它」。名单为空或名单里没提到的活，Agent 用自己的 Agent 和模型派 |

模式开着时发的每条消息照常发给这个会话，工具栏上的 Agent 和模型不变；点 × 退出。

**告诉 Agent 什么**（`ultra.mjs`，经 Coda 的「顺带告诉」随下一轮带上）：

-   开着后发的第一条，以及参数改过之后的第一条：进入协调模式，原先「没要求就别派」不再适用；用户明确修改规则时优先，普通的实现请求不算解除协调职责。附上名单，一行一个，写成 `spawn` 要的 `agent`、`model`、`effort`、`mode`、`options`。
-   主 Agent 定义任务、处理困难决策、约定验收标准、选择执行者、检查证据并汇总。多文件修改、重构、调试、评审、详细规划、研究和验证默认委派；实现、编写测试、运行测试或构建及失败修复也交给子会话。微小任务例外按整个请求判断，为调度和验收做少量定向阅读、只读抽查可以。
-   子任务具体、自包含，给出相关背景、验收标准和不与其他执行中会话重叠的写入范围；相关工作交给同一个执行者，后续修正复用它。子会话回传简短结论、文件或来源、实际验证结果和未解决问题，不回传大量日志。
-   主 Agent 在交接任务里明确子会话是执行者，自己完成任务，不继承主会话的协调职责；没有明确指派就不继续转派，获准转派也走 Coda。结果自动回来，主 Agent 不重复子会话的搜索、修改和常规检查。
-   委派只走 Coda 的 `spawn`，即使用自己的 Agent 和模型，也创建 Coda 子会话；除非用户明确要求，不用运行时自带的子 Agent 或委派工具。
-   之后每条模式内消息都带简短提醒：节省主 Agent 的 Token，非微小执行工作必须委派，串行和关键路径也适用，不能拆成单条命令自己做或重复子会话的工作；也提醒执行者分工、等待和只走 Coda 的规则。
-   名单写得太长、连同说明超过 Coda 一次能告诉 Agent 的长度（4000 字）时，那条消息发不出去，界面说明原因；改短后再发就照常告诉。
-   退出时撤销 Ultra 的优先委派职责和「委派只走 Coda」限定，恢复通常的执行与委派指令，Coda 子会话回到「有要求才派」；一条都没发过就不说。

同时在跑的子会话有多少由 Coda 管（「会话生命周期」插件的设置「同时执行的子会话」），满了 `spawn` 当场失败。 并发已满时等已有 Coda 子会话结束、腾出名额；`spawn` 不可用时说明阻塞，只继续不依赖它的协调工作。两种情况都不扩大微小任务例外或改用原生子 Agent。 这些职责和委派渠道仍是提示词约束，插件没有在运行时禁用主 Agent 的执行工具或原生子 Agent 工具。

**设置** `ultra.templates`：一列行，每行「模板名、Agent、什么时候派给它」，同一个模板名的几行是一个模板。默认不带模板，子会话沿用当前会话的 Agent 和模型；用户可以自行添加、修改、删除模板。

测试在 `test/plugins/ultra/`。

委派范围与微小任务例外的基础文案采用 [oh-my-claudecode 的委派规则](https://github.com/Yeachan-Heo/oh-my-claudecode/blob/82602887b71a3984e040fac2839ec8d27a7c67b6/docs/CLAUDE.md#L16)， 适配 Coda 的 `spawn` 与名单，并补充节省主 Agent Token、串行委派和避免重复执行的要求。版权与 MIT 许可见 [THIRD\_PARTY\_NOTICES.md](https://npmcn.com/package/%40coda-console/ultra/THIRD_PARTY_NOTICES.md)，随 npm 包一同提供。

## 常见问题

### @coda-console/ultra 是什么？

输入框的 Ultra 协调模式：节省主 Agent 的 Token 和上下文，非微小任务的执行默认交给 Coda 子会话，串行任务也委派。主 Agent 负责决策、调度和验收。名单在模式参数里改，常用的存成模板。注意：该包已被作者标记为弃用——已并入 @coda-console/composer（输入框模式），请改用它

### 如何安装 @coda-console/ultra？

在项目目录运行 npm install @coda-console/ultra，或使用 pnpm add / yarn add / bun add。

### @coda-console/ultra 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/coda-console\_\_ultra 是否存在。

### @coda-console/ultra 支持 ESM 还是 CommonJS？

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

### @coda-console/ultra 可以商用吗？

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

### @coda-console/ultra 还在维护吗？

最新版本 1\.2\.2 发布于 2026/10/31（2 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/10/30。作者已将其标记为弃用，新项目建议寻找替代方案。