dsh-model-capability-sync 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-model-capability-sync contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,114 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# dsh-model-capability-sync
+
+给已经配好的 DeepSeek Harness LLM 供应商**补全模型能力参数**的插件。
+
+它只做一件事：拿你已经配置的模型 id 去 [models.dev](https://models.dev) 查事实，把
+`上下文窗口 / 输出上限 / 是否支持图片 / 推理档位` 写回官方适配器的配置里。
+**它不发任何推理请求，也不注册 LLM 路由**——调用仍然由官方插件负责。
+
+## 为什么需要它
+
+中转网关（NewAPI 之类）的 `/models` 只返回模型 id，不告诉你上下文多大、能不能吃图片。
+官方适配器把没声明的能力按"纯文本"处理，于是模型明明支持图片，界面上却提示不支持。
+
+本插件把公开目录里的能力事实补进配置，让官方适配器能正确声明能力。
+
+## 工作方式
+
+```
+设置页（浏览器）                       宿主
+┌──────────────────────┐   RPC    ┌──────────────────────────┐
+│ 读 llm-pi-ai 的配置   │ ───────► │ 下载 models.dev（带缓存） │
+│ 列出模型 / 勾选       │ ◄─────── │ 匹配 id → 能力字段        │
+│ 预览将写入的字段      │          └──────────────────────────┘
+│ 应用 → settings.mutate│
+└──────────────────────┘
+```
+
+- 写入走**官方 settings 服务**（`remote.settings.mutate`），落点是 profile 的
+  `cordis.patch.yml`，热生效，不用重启。
+- 默认**只填空白字段**：你手填过的值不会被改写，除非勾选「覆盖已有值」。
+  空白包括 `undefined`、`''`、`[]`、`{}` —— 配置 schema 会给没填的字段补默认值
+  （例如没声明 `input` 会读成 `[]`），这些默认值不算「你填过」。
+- 表里有两列图片：**「图片」= 目录声明将写入的值，「当前生效」= 真正接管这条路由的
+  适配器此刻上报的值**（也就是聊天请求看到的）。两列不一致，说明同一个 provider
+  路由被另一个插件抢占，写这份配置不会生效。
+- **每个单元格显示 `旧值 → 新值`**，顶部汇总"将修改 N 行 · M 个字段"；没有变化的行
+  不可勾选，「全选」只作用于可见且有变化的行。支持按模型 ID / 目录 ID 搜索，以及
+  「只看有变化的」筛选。
+- **自动排序**：写入时按「前缀分组 + 组内名称」排序。有前缀的（`qoder-gj/xxx`）按
+  前缀字母序分组，组内按名称；没有前缀的直接按名称。比较忽略大小写，结果稳定。
+- 匹配规则由严到松：别名 → 精确 → 忽略大小写 → 去供应商前缀 → 去变体后缀
+  （`-high/-low/-medium/-thinking/-preview`）。优先选**第一方厂商**的目录条目，
+  避免被聚合站的错误数字带偏。
+- 目录下载失败会重试 3 次，仍失败则回落到本机缓存
+  `~/.dsh/model-capability-sync/catalog.json`，页面标注「正在使用本机缓存」。
+  手动预热：`node --experimental-strip-types scripts/warm-cache.mjs`。
+  宿主进程连不上 models.dev 时页面依然可用。
+
+## 安装
+
+从 npm 安装（发布后）：
+
+```sh
+dsh plugin --profile web add dsh-model-capability-sync
+```
+
+**DSH 桌面版不要用命令行装**：桌面应用独占自己的 profile，CLI 改动不生效，
+请在应用内 **设置 → 插件** 里安装。
+
+从本地源码安装（开发用）：
+
+```sh
+dsh plugin --profile desktop add "link:D:/code/dsh-model-capability-sync"
+```
+
+装完重启 dsh，设置页会出现「模型能力同步」。
+
+要求：`dsh` 运行时 `^0.2.1-rc.2`（写在 `package.json` 的 `engines.dsh`，宿主会据此做兼容检查）。
+
+## 目录结构
+
+| 路径 | 用途 |
+| --- | --- |
+| `src/index.ts` | 宿主半：RPC 通道 `preview`（目录能力）+ `live`（当前生效） |
+| `src/catalog.ts` | models.dev 下载 / 缓存（内存 + 本机文件）/ 索引 |
+| `src/match.ts` | 网关 id → 目录条目的匹配规则 |
+| `src/sort.ts` | 模型排序（前缀分组 + 名称） |
+| `src/mapping.ts` | 目录条目 → 能力字段（纯函数） |
+| `src/client/` | 设置页（React 组件 + 文案） |
+| `scripts/` | 构建脚本 + 冒烟脚本 |
+| `docs/` | 需求、技术选型、设计规范、开发计划 |
+
+## 开发
+
+```sh
+npm install
+npm run typecheck      # 两端类型检查
+npm run build          # lib/index.js + lib/client.js
+node --experimental-strip-types scripts/smoke.mjs   # 真实目录冒烟（需联网）
+```
+
+## 里程碑
+
+| 阶段 | 内容 | 状态 |
+| --- | --- | --- |
+| P0 | 骨架、构建、文档 | ✅ |
+| P1 | 目录拉取、匹配、映射、只读预览 | ✅ |
+| P2 | 预览表 + 写入设置 | ✅ |
+| P2.5 | 差异预览、筛选、排序、写入位置文案 | ✅ |
+| P3 | 别名表、手动覆盖 | ⬜ |
+| P4 | 迁移旧适配器的模型清单并停用它 | ⬜ |
+| P5 | 打包发布（npm + 社区目录） | 🔄 仓库已就绪，待发布 |
+
+发版步骤见仓库内的 `docs/publishing.md`。
+
+## 已知边界
+
+- models.dev 描述的是**官方模型**能力；中转网关背后实际路由到哪个上游，目录说了不算。
+  本插件给的是"最可能的答案"，最终仍建议用一张真图验证。
+- 未在目录中的模型（新模型、厂商自造别名）保持原样，可在 P3 的别名表里手工指定。
+
+## 许可证
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-model-capability-sync bundle patch
+#
+# 在 profile 组合中插入插件行。本插件不注册任何 LLM 路由，只注册一个自有 RPC
+# 通道 + 一个设置页，因此不会与任何适配器争抢 provider 路由。
+
+- insert:
+    - id: model-capability-sync
+      name: dsh-model-capability-sync