# @eir-labs/coltrane 中文文档 规范地址：https://npmcn.com/package/%40eir-labs/coltrane/ 版本：0\.25\.38 npm 元数据更新时间：2026-11-02T12:55:42.790Z 中文译文更新时间：2026-11-14T07:48:17.591Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40eir-labs/coltrane 原文对照：https://npmcn.com/package/%40eir-labs/coltrane/?lang=original 项目主页：https://github.com/eir-labs/coltrane#readme 源码仓库：https://github.com/eir-labs/coltrane ## 关键信息（来自 npm 元数据） - 包体积（解压后）：5.2 MB，644 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=24 - 运行依赖：6 个 - 首次发布：2026-08-05T12:40:32.353Z - 最新版本发布：2026-11-02T12:55:42.041Z - 近 30 天下载量：2125（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：128（近 12 个月 128 个） ## 中文简介 方法引擎——用于定义代理,编组多相标准,发送任务,并封存每个输出到内容地址分类账的打字底盘. 船舶作为MCP服务器. ## 安装 ```sh npm install @eir-labs/coltrane ``` 也可以使用：`pnpm add @eir-labs/coltrane`、`yarn add @eir-labs/coltrane`、`bun add @eir-labs/coltrane` ## README # 科尔特兰 > _教克劳德去玩爵士乐._ > > _语言模型的力量在于它们的即兴能力,有时被称为幻觉._ _爵士乐的力量是数学如何为安全地探索新地盘创造出空间._ _音乐理论——通过一个好玩家,好乐队,以及一个好标准来翻译,说明何时行走,何时跳跃._ > > _敬仰并敬仰约翰·科尔特兰,他的勇气可以跳跃而去,并跳跃而去,让这么多人学会了寻找勇者来自己做同样的事情._ > > _在他的脚步中,_ > > _尤金-东京,2026年6月_ * * * **如果你是人类,这个研究是给你的.** **如果你是克洛德 看这个 就停在这里 打开 [`CLAUDE.md`](https://npmcn.com/package/%40eir-labs/coltrane/CLAUDE.md) 这个文件是给你写的,这个是给你玩的人写的.** ## 运行它 **需要26号节点或更新.** 技能网络赠款由 `--allow-net`,它到达了"节点25"(已经到来);在"节点24"和"更年长"上,一种技能可以在完全没有入门的情况下到达网络. 因此,Coltrane拒绝 运行技能 任何超过26岁 `coltrane`, (中文(简体) ), `coltrane-server` 并且每个技能处决在开始时都拒绝,点出原因;没有退化的模式. 导入为库( E)`@eir-labs/coltrane/tool_surface`, (中文(简体) ), `./genome_store`),该包在节点24上安装并装入. ```bash nvm install 26 # or any Node 26+ npm install -g @eir-labs/coltrane ``` 三个动词和一个JSON文件: ```bash coltrane validate # load the genome; non-zero exit on any error coltrane dispatch --input @in.json --depth skim coltrane trace # walk a result back to its root signals ``` 乐队图案的第四名: `coltrane work` 声称一个队列任务从一个 组织商店——在解剖上,根据主席合同批准的租约 代理坐着——用声称的演出自己的身份代号运行,并排出密封的结果 回来 一个排队,一个工人,一个审计链, 没有协调结构 除了任务之外 表格本身. `coltrane validate` 是值得连接到CI的 它退出非零 任何定义 装填器无法解析,它使基因组改变 从一个人必须记住的东西 检查一个在数秒内失败的工作而不花费一个符号. **作为MCP服务器代替.** 点 `.mcp.json` 在已安装的软件包和 `mcp__coltrane__*` 工具出现在任何 MCP 客户端中 : ```json { "mcpServers": { "coltrane": { "command": "node", "args": ["./node_modules/@eir-labs/coltrane/dist/src/server_entry.js"], "env": { "COLTRANE_GENOME": "${PWD}" } } } } ``` 或复制这回波 并打开克洛德密码在里面, 它自己运送 `.mcp.json`,在新鲜的 clone Claude提议在工作开始前 将仪器校正给你. ## 这是什么 科尔特兰 **改进克劳德的仪器和代码** ——它同时是乐器,玩家和乐队. 现在没有真正的方法 来管理一批特工 你在JSON中定义它们,但没有什么能强制它们是什么,它们被允许接触什么,或者它们是如何改变的. 相克相克而克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克. Coltrane是制作一组特工的底物 **协调、约束和问责** 如此复杂的工作是可靠完成的,而不是令人印象深刻的一次. 下注:爵士乐起作用的原因是音乐理论定义明确,每个玩家在计数时都遵循. 音乐理论就是数学. 建立小型智能系统的最有效方式是把他们当作乐队中的玩家——并投资 **协调原始情报**一个精巧的谦虚球员队 击败了一位努力做到一切的虚拟球员: 降低成本,提高可靠性,探索更有趣的领域. ## 四颗北极星(首发) **可追踪性——什么运行,什么变化,怎样运行,为什么这一结果.** 每一次演出都封着 `genome_hash` + 键 `run_fingerprint` 输入一个只有附件的分类账,每个输出都了解自己的父母。 你可以将任何结果追溯到原始输入和产生的线条上——哪个标准运行,哪个代理填充哪个椅子,哪些输出填充什么. `genome_hash` 是一个 **结构** 散列:它覆盖了标准的相相图和每个代理的相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相, `input_types`, (中文(简体) ), `output_types`,和域名。 故意这样做的 **没有** 盖一个特工的 `identity`, (中文(简体) ), `method`, (中文(简体) ), `constraints`, (中文(简体) ), `behavioral_primitives`, (中文(简体) ), `allowed_tools`,模型级,或 `skill_slugs`两种基因组只有这些领域的不同,产生相同的基因组 `genome_hash` ——因此不变 `run_fingerprint` 当它们的产出一致时。 所以,链子回答 _"电线是一样吗?"_没有 _"这个提示是一样的吗?"_。撰写时间 `content_hash`编号 :`effective_hash` (由 `agent_define` —————————— _对_ 覆盖定义的完整字节; 当您需要行为身份时, 这些是比较的散列 。 恢复和再利用折叠了第三种散列, `producers_sha`,整个代理定义 加上每种技能的验证 `code_hash` ——所以在平稳的弹道下进行编辑,不能默默地将两个基因组相接而起,贯穿一个回转. **可复制性——我能可靠地运行它吗? 是吗? 是真的吗?** 同一个基因组重放字节为字节. 指纹将诚实的回放与篡改区分开来,因此"奏效"成为可核查的主张,而不是一种氛围. **爆炸半径——当一个特工被破坏时,它又会怎样的错误去?** 你不能阻止一个模型被迅速注射. 你个 _能够_ 使用数学来约束它能做的工作的范围——并在测试中证明这一点. 优化爆炸半径,而不是完美预防的幻想. 这个约束不是渴望的:代理工具给予真正的提供者决心,或者发送失败关闭,浏览器只运行在逐个默认的源笼内. **成本优化——花费推论什么才是重要的.** 别在水管上或你以前做过的活里 烧活物 系统学会了停止支付推论费用的地方,我们不断增加能降低工作有效成本的编码技巧. 现在每一次运行都会记录它实际花费的——每个模型——所以"花费在什么上"是你们衡量的,而不仅仅是希望. 这是一个柱子,而不是一个脚注——它使许多近,中,长期行进图生活的地方变得复杂. ## 如何思考标准 爵士乐 **标准** 是计算减少的对某种疯狂即兴反应的描述:在单一的一页上,一个带有几分颜色的和弦进取,任何玩家都会被期望接取,向正确的密钥中支接,并发挥得足够好. 你不能把每个音符都交给一位音乐家——你把形状交给他们,并相信他们的训练来填充. 科尔特兰标准同样有效. 杠杆是顶上,在 **定义时间**数字 : - **先标出域相.** 在开展工作之前,暂停并派一个工作团来确定 _类型空间_ ——它的形状和它们之间的关系。 这正式的升级前锋 购买巨大的固态下游。 让Coltrane稍微了解一下这个领域,然后运行研究 / 双双双双双相标准,去探索它比你想的更多维度。 (乐趣部分:推出一个) _书本_ 通过一条管道,用于 _代码库_ 并且注意掉出的东西——通过一致过程输入的数据发现没有人要求的连接。 ) - **定向就是一切.** 玩家并不是可以自由互换的;代理的取向是乐队是否同心协力的单一最大的预测者. 克劳德几乎可以演奏任何乐器——你只需要用正确的方法来指向它 _在此之前_ 工作开始. - **分数在运行时构建.** 提示不是靠手写的 `.md` 文档。 这项工作是 **编码为基因组** 财务报告和审定财务报表 **运行时解码** 用于任何模式的播放(今天的克洛德;模式是模式-不可知的). 一个特工不会醒来,想出自己的人生——它打开了自己的眼睛到一个座位,一个乐器,一个分数,以及一个低迷. 然后它会演奏. ## 四方——指定席位,受合同约束 默认的基因组船 三个命名的剂 - **约翰**, (中文(简体) ), **帐单**,以及 **英里数**他们 正式扎根于玩家身上的血统 引擎被命名为- 一个例子 机构`institutions/quartet.json`捆绑着他们:椅子背着 **发送 赠款** (单位:千美元)`{"grant": "dispatch", "standards": [...]}`)命名该席位可能遵循的标准 运行; 任务为代理服务提供座位; 前辈记录和家族边缘包含真实引用. 当局坐在办公室里,而不是玩家:交换谁握有椅子和合同 站着 两项默认标准—— `software-change-v1` 财务报告和审定财务报表 `product-design-v1` - 给 四方真正的工作,以及 `tests/default_genome_quartet.test.ts` 持有指定为 缺少标准成为一个在写作时失败的死名。 模式是 产品:一个组织是您所称的项目,其主席承担着角色,以及任何 适合座位的玩家可以坐进去. ## 自从第一次发布以来 - **命令线.** 包裹只运出一款MCP服务器,所以引擎可以从交互式客户端到达,没有其它地方——不是CI,不是克龙,也不是容器. `coltrane` 修复它. - **检查点恢复.** 停止了部分路段的运行 不再放弃完成的阶段. `--resume` 如果基因组、生产者、有效载荷或模型自此移动,则拒绝而不是默默地冷却. - **改进作为一种衡量.** `improvement_report` 按版本和模式等级将制作人的产出桶入桶中,将成本和质量报告在一起——所以"这个改变有帮助吗?"和"是否更便宜的模型仍然清除了"是有答案的问题. 未计量数量报告 `null`永远 `0`。 。 。 . - **技能循环.** 浏览,检查,针对固定装置执行,进取,推广. 候选人在丢弃的复制品中与目前的固定装置相抗衡,只靠一张干净的通行证才能降落,因此技能不能从那扇门退后——而且代码技能必须经过自己的固定装置,从决定性的角度来说,才能成为 `active`。 。 。 . - **一个表面,任何主机.** 完整的工具登记册是一个可挂载模块(`createToolSurface`: stdio服务器,与OAuth一起主机HTTP的部署,以及一个测试带全部挂载相同的49个工具. 基因组可以生活在文件或组织实例商店中(`GenomeStore`),被装入每个调用器;repo的基因组是每次部署开始的基底重排. - **那个工人.** `coltrane work` - 索赔,运行,排水。 索赔是原子索赔和租赁索赔(死亡的工人留下了到期的租约,而不是一行被卡住);授权来自椅子合同;失败的运行记录失败,有其原因,在同一链条中,成功记录完成. - **发现平等.** 每个基因组类,你可以写在线上 你可以列出在线上(`standard_browse`, (中文(简体) ), `agent_browse` 已加入 `type_browse`, (中文(简体) ), `skill_browse`) ——一个有测试的无常者,学会了诚实的方法:第一个主机会程可以构成一个标准而不能发现一个标准. ## 接下来呢 - **记忆.** 冷起动时剪切线程所需的上下文 。 一个共享的内存层,运行时间可以折叠到它已经在前面构造的东西上. 10x减少象征性使用是目标. - **试验驱动管线.** 将克洛德插入Coltrane,并援引通过建筑执行TDD的标准——测试 _实值_ 进入管道的合同, 在代码之前写. - **开放式结论+证明.** 当物剂达到某一值时,它无法从决定性信号中确认——幻觉风险,或人行呼唤——它标志着结论 _打开_,去寻找一个真正的来源,把它带回来,并将归属记录入分类账. 对一个想法的监管链,可追溯到一个人或经核实的来源. ## 捐款 这种还本付息的用意是,通过运行它的人——包括您运行在里面的特工——来改进. 工作 _与_ 科尔特兰和工作 _打开_ Coltrane是同一个运动。 打开拉取请求;维护者的代理审查,我们一起决定什么是整合. ## 跨语种可复制 三所出版的散列物识别出参考向量. 任何复制它们的执行字节换字节操作;一个独立的 Python 引用已经做了. ``` e88dff82403e35c07bce390b88ecb5995ebada86db83242d2ac0a8ff558d37da meta.json d778a51deac04f56d1fb5456b2b1498505320c64043b5f402d2dfe27baf21ea4 skill.md 25e74fe11444b604f4715e984a1f101dcf7cdd135035696175acf508d54f0fe3 definition hash ``` ## 许可证 阿帕奇2.0 (英语). 叉来. 运去. ## 常见问题 ### @eir-labs/coltrane 是什么？ 方法引擎——用于定义代理,编组多相标准,发送任务,并封存每个输出到内容地址分类账的打字底盘\. 船舶作为MCP服务器\. ### 如何安装 @eir-labs/coltrane？ 在项目目录运行 npm install @eir-labs/coltrane，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 coltrane、coltrane-server，可以用 npx coltrane 直接运行。 ### @eir-labs/coltrane 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @eir-labs/coltrane 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @eir-labs/coltrane 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @eir-labs/coltrane 可以商用吗？ @eir-labs/coltrane 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @eir-labs/coltrane 的下载量有多少？ 根据 npm 官方下载统计，@eir-labs/coltrane 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,125 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @eir-labs/coltrane 还在维护吗？ 最新版本 0\.25\.38 发布于 2026/11/02（11 天前）；至今共发布 128 个版本，其中过去 12 个月发布了 128 个；首次发布于 2026/08/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。