dsh-pi-catalog-sync
dsh 插件：通过官方设置接口将 pi.dev 模型目录同步到 llm-pi-ai 提供商路由中，包括原地同步无法处理的 OpenRouter 等混合协议路由。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:jiawei322/dsh-pi-catalog-sync#b71090b395a3b1da0697e03f48cfddc436a51e5aPi Catalog Sync 以 dsh-pi-catalog-sync 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Sync the pi.dev model catalog into DeepSeek Harness (dsh) llm-pi-ai provider routes through the official settings seam — no source patch — including mixed-protocol routes like OpenRouter, where new models land on a companion route while the built-in route stays untouched.
把 pi.dev 的模型目录同步进 DSH 的 llm-pi-ai 各 provider 路由，经官方 settings 接缝写盘，不补丁 DSH 源码。
DSH Web「模型」页给预置 provider 的模型列表不是实时拉取的，而是读打包在 @earendil-works/pi-ai 里的静态快照（dist/providers/data/*.json，本机为 2026-09-05 生成、366 个 OpenRouter 模型）。dsh-llm-pi-ai 的 discoverModels 对 catalog 路由直接返回该快照，不发任何网络请求，所以快照之后上架的模型永远搜不到。
pi.dev 把自己的目录以 JSON 公开：
| 端点 | 内容 |
|---|---|
GET https://pi.dev/api/models | 全部 39 个 provider 的目录（约 640 KB） |
GET https://pi.dev/api/models/providers/<route> | 单个路由（如 openrouter 377 个模型 / 183 KB） |
GET https://pi.dev/api/models/providers | provider id 列表 |
实测（2026-09-18）：pi.dev 的 openrouter 377 个模型，比本机 pi-ai 快照多 23 个，正好包含 stealth/union-alpha、deepseek/deepseek-v4.1-flash、~openai/gpt-*-latest 等新上架模型。字段与 DSH 模型 profile 的词汇表对齐（id / name / api / baseUrl / provider / reasoning / thinkingLevelMap / input / cost / contextWindow / maxTokens / compat），翻译成本极低。
@aiwayds/dsh-model-sync：同样走 pi.dev → settings，功能完整，但它的翻译规则 13 会丢弃混合协议路由上的新增模型（"base-less entry on a mixed-protocol route has no addressable api"）。实测跑它的翻译器：openrouter 写入 366、丢弃 23（含 stealth/union-alpha）。原因在 DSH 侧：models 条目不能带 per-model api，而 openrouter 的内置目录跨 anthropic-messages + openai-completions 两种协议。@goodandready/dsh-model-sync：走各 provider 自己的 API 同步 + Web 卡片，但只作用于自建路由（有 baseURL/api 的 profile），预置 catalog 路由不在其范围。本插件的差异点：混合协议路由也能同步——默认不碰原路由，把新模型放进一条伴生路由（openrouter-live，api openai-completions）。
name / contextWindow / input、reasoningEfforts（由 pi.dev 的 thinkingLevelMap 推导）、compat.{thinkingFormat,supportsReasoningEffort}（仅 openai-completions）、容量卫生门（非正整数、或 maxTokens >= contextWindow 的列表回声一律不写）。settings.mutate 写入 llm-pi-ai.providers.<路由>.models（带 revision，SETTINGS_CONFLICT 自动重试一次）。混合协议路由的策略（mixedProtocolStrategy）：
| 值 | 行为 |
|---|---|
companion（默认） | 原路由保持 pi-ai 内置目录不动；新模型写入伴生路由（api/baseURL 由条目自身推导，可显式配置） |
route-api | 在原路由上写 api: <单一协议>，所有模型（含新增）都在原路由，代价是原本走 anthropic-messages 的模型改走 openai-completions |
skip | 只报告，不写 |
lib/plan.js）：对真实 pi.dev 数据跑通（openrouter → 伴生 23 个新模型；zai-coding-cn / minimax-cn → 原地同步）。lib/writer.js）：settings.mutate + revision 校验 + SETTINGS_CONFLICT 重试一次、只写变化、dry-run、伴生路由首次创建时才补 api / baseURL / apiKeyEnv。19 个单元测试通过。pi-catalog-sync 配置命名空间、定时刷新、/pi-catalog-sync 命令）、Web「模型」页卡片、装进 profile 的端到端验证。modelOverrides，llm-pi-ai 会拒绝同时携带 models 列表的路由。本插件对这类路由跳过并明确报告（不折叠、不清空，零数据丢失）；要同步就得先清掉该键，或后续加一个 fold+unset 的可选模式。npm test # 规划核心单元测试
PI_AI_DATA_DIR=<pi-ai>/dist/providers/data npm run dry-run # 只读 dry-run：对比 pi.dev 与本机内置目录