# @alexeiled/pi-model-router 中文文档 规范地址：https://npmcn.com/package/%40alexeiled/pi-model-router/ 版本：0\.19\.0 npm 元数据更新时间：2026-11-04T08:53:38.584Z 中文译文更新时间：2026-11-06T16:15:36.463Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40alexeiled/pi-model-router 原文对照：https://npmcn.com/package/%40alexeiled/pi-model-router/?lang=original 项目主页：https://github.com/alexei-led/pi-model-router#readme 源码仓库：https://github.com/alexei-led/pi-model-router ## 关键信息（来自 npm 元数据） - 包体积（解压后）：501 kB，35 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.19\.0 - 运行依赖：0 个 - peer 依赖：@earendil-works/pi-ai ^1\.1\.0，@earendil-works/pi-tui ^1\.1\.0，@earendil-works/pi-agent-core ^1\.1\.0，@earendil-works/pi-coding-agent ^1\.1\.0 - 首次发布：2026-09-20T07:44:31.527Z - 最新版本发布：2026-11-04T08:53:38.233Z - 近 30 天下载量：2762（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：29（近 12 个月 29 个） ## 中文简介 Pi 型号路由器带有分类器-型号路由,软预算控制,以及自定义提供者支持. ## 安装 ```sh npm install @alexeiled/pi-model-router ``` 也可以使用：`pnpm add @alexeiled/pi-model-router`、`yarn add @alexeiled/pi-model-router`、`bun add @alexeiled/pi-model-router` ## README # pi- 型号路由器 [![CI](https://github.com/alexei-led/pi-model-router/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/alexei-led/pi-model-router/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/%40alexeiled%2Fpi-model-router)](https://www.npmjs.com/package/@alexeiled/pi-model-router) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/%40alexeiled/pi-model-router/LICENSE) **停止手动更换模型.** 保存一个配置 [Pi](https://github.com/earendil-works/pi/tree/main/packages/coding-agent)。 。 。 . `pi-model-router` 可随着任务的变化选择不同的模型和推理努力,包括在工具-启动请求之间. 可选建议使用任何在Pi中注册的文本能力分类器. 路由器使用Pi的打出分级器API,并且需要对准确的型号进行明确的逐一批准. ## 为什么用它? - **手动变化较少.** 一个剖面可以结合快速,低成本的路线和更强大的模型. - **控制成本和质量.** 你选择模型,努力水平,倒置顺序和基线。 任何时间都可以固定路线. - **运行模式 .** `cost`, (中文(简体) ), `balanced` 或者说 `quality` 选择首选的模型/效果对,每个配置文件、项目或会话。 OpenAI默认使用Luna,Terra和Sol;自定义路由保持了决定性的变换. [选择模式](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/routing-modes.md)。 。 。 . - **内建活动路线.** 识别的 OpenAI 和 Claude 配置文件会获得代码、调试、探索、计划、审查、操作和文件的默认值。 推出一个细胞或选择退出. [默认和调制](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/activity-routing.md)。 。 。 . - **适应性工具循环.** 定期背景审查在不拖延产生的情况下评估目前的工作。 符合资格的建议可以改变要求之间的层次、活动和努力,并有明确的切换成本控制. - **显相决定.** 一个紧凑的信号小组显示实际活动、模型和努力。 被搁置的提案保持不变。 打开 `/router` 用于原生栏/跳伞、观察用法和会话控制. 目的是有选择地使用昂贵的模型,而不是不惜任何代价最便宜的答案. 节省取决于您的配置、 任务组合、 输出大小和缓存再使用 . 顾问会增加耐性。 它们的费用与发电费用分开. ## 可选路线咨询 使用 Jev, Clef/Clef Flash/Clef Omni, OpenAI决定,或本地的 Ollama 或 lama.cpp 分类器在 Pi 中注册. 它读取了最近的背景 并从你的资料中建议一个模式和努力. 选定的生成模型产生答案,而不是顾问. ```mermaid flowchart LR Task["Your task"] --> Router["Pi model router"] Advisor["Configured Pi classifier"] -.-> Router Router --> Light["Micro / low"] Router --> Strong["Medium / high"] Light --> Answer["Answer and tool calls"] Strong --> Answer classDef policy fill:#dbeafe,stroke:#2563eb,color:#0f172a classDef advisor fill:#fef3c7,stroke:#b45309,color:#451a03 classDef generation fill:#dcfce7,stroke:#15803d,color:#14532d class Router policy class Advisor advisor class Light,Strong generation ``` 配置 Pi 的分类证书并批准其精确度 `provider/model` 每个简介的参考文献。 所选文本可以包含私人数据. 路由器只发送文本 。 没有顾问,它使用兼容的本地路线. [支持的模式、证书和配置](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/classifier-advisor.md) 这个 [参考配置](https://npmcn.com/package/%40alexeiled/pi-model-router/model-router.example.json) 选择被钉住的 Jev 1.14,但将建议禁用,直到您选择加入. 缺少目录条目需要 Pi 提供者扩展 [可选目录示例](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/classifier-advisor.md#1-register-missing-classifier-entries) 需要Pi 1. 3+. 路由器使用一个被选中的分类器,而不是投票或分类器故障. ## 在 Pi 中检查路径 运行 **`/router`** 5个标签 : **现在 路线 分类符 使用符 设置**。 。 。 . 打开任何标签 `/router routes`, (中文(简体) ), `/router classifier`, (中文(简体) ), `/router usage` 或者说 `/router settings`。 。 。 . `/router status` 返回短文本. 双线条在新会话中开通. `/router widget` 切换到安静的页脚状态 . ```text ╭──────────────────────────────────────────────────────╮ │ Router / auto │ │ ›Now | Routes | Classifier | Usage | Settings │ │ ▂▄ GLM 5.3 Flash · low ⏵ pinned │ │ zai/glm-5.3-flash · effort low │ │ Pinned route │ │ Mode: balanced (default) · bypassed by pin · /router │ │ mode │ │ │ │ Switch history · retained active branch │ │ History collection is on · last 50 observations │ │ Observed: ▂▄▆ MiMo V2.6 Flash · high · baseline │ │ Model switch: ▂▄▆ MiMo V2.6 Flash · high → ▂▄ GLM │ │ 5.3 Flash · low · pinned │ │ Why this route? | Done │ ╰──────────────────────────────────────────────────────╯ ``` 栏杆 `▂ ▂▄ ▂▄▆ ▂▄▆█` 命名等级, `micro` 改为 `high`在每一个表面。 用两个便宜的测试模型从皮1.5中捕获. [检查员控制](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/user-guide.md#native-inspector) • 妇女 [分类设置](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/classifier-advisor.md) ## 皮的转弯 这种示意图条显示完成后选择的等级较低. 这不是路由承诺或长期基准. ```text ▂▄ GPT 6 Luna · low = fits auto · balanced (default) · classifier 807 ms ``` 模型回答和调用工具. 定期背景审查采用有限度的当前进展;在下次请求时可适用新的建议。 成本敏感性和短视率可以维持一个昂贵的开关,而强大的能力建议可以超过估计数。 优惠、同意和产生保障仍然适用. [适应性路由和切换政策](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/user-guide.md#activity-routes) [读取状态并掌握控制](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/user-guide.md#understand-the-result) 最近的记录涵盖25届会议的1,967个答复。 他们显示路线使用,没有保证节省. [见图表、费用计算和限额](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/evaluation.md) ## 升级至0.18.0 已确认的 OpenAI 活动默认值现在以中价/高价使用 Terra . 质量默认更倾向于一个更强大的模型,而不是更多的努力. **物理模型和支出在再装入时可以改变,即使是对现有剖面.** 通用用户声明和明确活动覆盖不重写. 升级前设置 `profiles..activityPreset: "off"` 保留遗产 三级行为。 重新启动 Pi 或运行 `/reload` 更新后; 检查路由. 见 [默认所有者、 退出和模式表格](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/routing-modes.md#openai-default-preferences)。 。 。 . ## 升级至0.16.0 更新后重新启动 Pi 。 没有配置 `mode` 路线如前. 项目 `.pi/model-router.json` 文件现在只能设置路由, `activityRouting`, (中文(简体) ), 显示和 `mode` (安检). `off`编号 :`minimal` 努力争取 `low` 上方则禁用 一级。 现在,重复的工具故障在每个模式中都升级了一层. [更新细节 +](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/user-guide.md#from-015x-to-0160) ## 升级至0.15.1 如果您安装了可选的分类器-目录扩展名, 请替换其副本 ,在重新启动 Pi 之前使用更新的示例。 此修正启动失败 Pi 1.3.0的捆绑装载机. 仅更新路由器软件包并不更新 单独的扩展; 跟着 [目录更新步骤](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/classifier-advisor.md#1-register-missing-classifier-entries)。 。 。 . ### 从0.14 更新后重新启动 Pi 。 不需要从0.14移出路线政策或配置. 路线和分类器控制器现在有自己的标签. 分类器启用和配置文件批准仍在用户配置中. 历史收藏仍可选入: `/router log on` 收集新的决定。 巡视员明确了伐木状态. 现有的指针、努力设置、符合资格的路线保障和4项要求的审查没有改变. ### 从0.1.2.0之前的版本 更新后, 重新启动 Pi。 替换 `/router-ui` 与 `/router`,以及 `/router ` 与 `/router profile `。分类器建议现在使用任何 Pi 注册的分类器。 以通用顾问模式取代供应商的具体配置,并逐一核准. [分类移徙 ∗](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/user-guide.md#from-011x-to-012x) 旧的 Jev/Clef/聊天分类器设置无法启用当前顾问 。 遵循上面的移入步骤, 即使旧文件仍然在不加警告的情况下加载 . ## 安装 需要皮条 **1.1.0 或稍后的1.x系列** 和节点js **22.19.0+ (单位:千美元)**。 。 。 . 自动SDK/主机门对接Pi 1.1.0. 这个 [0.15 本地TUI检查](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/testing/router-observability-015-acceptance.md) 使用 Pi 1.3. 0 的缩写。 可选分类器-目录例需要Pi 1.3+. ```sh pi install npm:@alexeiled/pi-model-router ``` 那就开始新的皮课. [使用可用的模型创建配置文件](https://npmcn.com/package/%40alexeiled/pi-model-router/docs/user-guide.md#first-profile) 如果使用上游包,请先去掉. 两个软件包都登记 `router` 供养. * * * 独立分叉 [叶刘的花花公子](https://github.com/yeliu84/pi-model-router),拥有原麻省理工学院的执照和归属. ## 常见问题 ### @alexeiled/pi-model-router 是什么？ Pi 型号路由器带有分类器-型号路由,软预算控制,以及自定义提供者支持\. ### 如何安装 @alexeiled/pi-model-router？ 在项目目录运行 npm install @alexeiled/pi-model-router，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-ai（^1\.1\.0）、@earendil-works/pi-tui（^1\.1\.0）、@earendil-works/pi-agent-core（^1\.1\.0）、@earendil-works/pi-coding-agent（^1\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @alexeiled/pi-model-router 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/alexeiled\_\_pi-model-router 是否存在。 ### @alexeiled/pi-model-router 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @alexeiled/pi-model-router 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @alexeiled/pi-model-router 可以商用吗？ @alexeiled/pi-model-router 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @alexeiled/pi-model-router 的下载量有多少？ 根据 npm 官方下载统计，@alexeiled/pi-model-router 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,762 次，日均约 92 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @alexeiled/pi-model-router 还在维护吗？ 最新版本 0\.19\.0 发布于 2026/11/04（3 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 29 个；首次发布于 2026/09/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。