dsh-eco-router

DeepSeek Harness 的 token 高效模型路由飞轮。

中文 | English

它把 OpenSquilla 的核心思想——"同样的预算，更强的能力（same budget, more capability）"——做成一个自改进路由循环：观测每一轮的 （任务 → 模型 → 结果），按任务类别蒸馏出一张带逐模型错误计数的路由表，持久化到 eco_router.json，并暴露一个 eco_route 工具，把每个任务路由到历史上成功过的最便宜模型档位。

真实验证截图

（真实加载构建产物 lib/index.js，以两个模型档位验证：一个 code 任务在 deepseek-v4-flash 上成功、一个 media 任务在 flash 上失败后，eco_route 把 code 任务路由到便宜档 deepseek-v4-flash、把 media 任务升级到强档 deepseek-v4-pro。）

使用方式

1. 前置条件（依赖状态）

⚠️ 本插件依赖的 @deepseek-ai/* 包（@deepseek-ai/cordis、@deepseek-ai/schemastery、@deepseek-ai/dsh-agent、@deepseek-ai/dsh-fs、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-settings、@deepseek-ai/dsh-tools，以及客户端 dsh-client-runtime / dsh-client-ui-settings / dsh-client-ui-slots / dsh-client-ui-settings-plugins）尚未发布到 npm，它们是 deepseek-harness monorepo 的 workspace: 内部包。在仓库之外直接 npm install 会解析失败。

目前要构建，二选一：

• 在 harness monorepo 内构建 —— 把本包放进 packages/（或作为 workspace 引入），让 @deepseek-ai/* 以 workspace 包形式解析；
• 等上游发布 —— 待 @deepseek-ai/* 上 npm 后，锁定 peerDependencies 版本再正常安装。

2. 构建

npm install
npm run build                    # 宿主半部 → lib/index.js
DSH_BUILD_FACE=client npm run bundle   # 浏览器半部 → lib/client.js（需 harness 环境）

3. 挂载（preset 配置）

把本目录复制到你的用户 preset 根目录并挂载，或在自己的组合里加一行：

- id: dsh-eco-router
  name: '@joyfoxai/dsh-eco-router'
  config:
    tiers: [deepseek-v4-flash, deepseek-v4-pro]   # 从便宜到贵
    autoRoute: false                               # true → 在 agent/request 直接覆盖

• tiers —— 有序模型 id，最便宜在前。eco_route 推荐该任务类型下无错误记录的最便宜档位。
• autoRoute —— 为 true 时，插件会在 agent/request 瀑布里直接覆盖所路由的模型（而不只是推荐）。

插件只注入宿主服务（fs、tools、settings、llm），自身不发布任何服务，因此这一行直接平铺即可，无需 isolate 域。

4. 设置界面（运行时配置）

tiers 和 autoRoute 也可在运行时通过 dsh-eco-router 设置命名空间修改（组合的 config 是其 base 层）。浏览器端注册了一张 settings.plugin.item 卡片——位于 设置 → 插件——内含 autoRoute 开关和一个 tiers 多选下拉（数据源来自宿主枚举的模型 llm.listModels）。改动经设置 watch 热生效，无需重启。

它做了什么

阶段	实现
观测任务	agent/inbox/claimed → 用户消息文本 + 粗分类（media / code / research / documents / comm / general）
观测模型	agent/request 瀑布 → 每步实际路由的 { provider, model }
观测结果	tools/result（工具名 + isError）与 agent/error
蒸馏	按类别聚合 { turns, errors, models: { model: { uses, errors } } }
持久化	每轮结束把路由表写入 eco_router.json
推荐	eco_route → 该任务类型下零错误的最便宜档位
路由（可选）	autoRoute: true 时还会在 agent/request 直接覆盖所路由的模型

所有监听器都挂在发起 agent 的作用域上下文（agent.ctx.on(...)）上——与 harness 自带 installModelSelection 相同的模式，因此只观测该 agent 自身的流量。

目录结构

dsh-eco-router/
├── src/index.ts           # 宿主插件：name / inject / Config / apply
├── src/client/index.ts    # 浏览器端：设置卡片
├── preset/
│   ├── agent.cordis.yml   # 引用本包的组合示例
│   └── preset.yml         # preset 显示元数据
├── docs/verify.png        # 真实构建验证截图
├── package.json
├── tsconfig.json
├── tsdown.config.ts
├── README.md              # 本文档（中文，默认）
└── README.en.md           # English

License

MIT