dsh-model-smart-config
为 DeepSeek Harness 第三方 API 提供商智能设置模型：识别模型 ID，并填写上下文窗口、输入模态和推理级别。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Seller-1990/dsh-model-smart-config#50de4a363fb5302632a2b2fa0c4bce316362a059Model Smart Config 以 dsh-model-smart-config 发布，当前版本为 0.3.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Smart model setup for DeepSeek Harness. Recognize a third-party model ID and fill in its context window / input modalities / reasoning levels — directly inside the official model row.
dsh-model-smart-config 给 DeepSeek Harness 的第三方 API 补上「智能配置」：
填完 url / key / model 之后，插件按模型名识别它是谁，把上下文窗口、输入模态、思考等级
直接填进官方那一条模型行里 —— 不必再手工编辑 cordis.patch.yml。
| 类型 | DeepSeek Harness 插件（dsh.bundle bundle patch + Web client） |
| 规则表 | 201 条有序正则规则 / 33 家厂商，每条都带官方文档 source |
| 依赖 | 运行时零依赖（@deepseek-ai/* 由宿主独占供给，插件不声明） |
| 许可 | MIT |
一条官方模型行上多了什么（左：敲入 id 只识别、不写值；右：点「智能匹配」后填值）
新增模型那一行立刻就有键 · 未识别不写错值 · 不再另起一整块
截图取自真实 Harness 界面（用一个中性草稿 provider，不含任何真实 provider 名或密钥）。
DeepSeek Harness discovers third-party models over the network, and that path only ever yields
{id, name, contextWindow?, maxTokens?} — no modality, no reasoning levels. This plugin fills
that gap with a curated, ordered-regex rule table:
text / image) and reasoning levels
(off / minimal / low / medium / high / xhigh / max).Install (GUI: Plugin Marketplace → Add plugin, or CLI):
dsh plugin --profile <profile> add https://github.com/Seller-1990/dsh-model-smart-config
Then open Settings → Models. In an existing third-party (pi-ai) provider, choose Edit → expand 自定义设置 / Customized. In Add API → Custom provider, fetch and adopt models (or add a row manually) without saving first. Each row carries a badge and a Smart match button. Matching updates the host's draft only; the official Save / Cancel controls retain ownership.
官方 discoverModels 的返回取决于走哪条路径（详见 docs/01-research.md §1）：
| 路径 | 返回字段 |
|---|---|
| P1 · provider 在 pi-ai 内置目录 | {id, name, contextWindow, maxTokens, inputModalities} |
P2 · 走网络 GET {baseURL}/models | {id, name, contextWindow?, maxTokens?} —— 无模态 |
第三方 provider 必须走 P2，所以实际只拿得到 4 项。 官方源码注释也明确写了：provider 编辑器 故意不提供 reasoning effort，因为它是每模型能力，只留在配置文件里 —— 即官方把思考等级 留给用户手改。这就是本插件要补的空白。
识别是入口。 不认出模型身份，就判不出能力标签。
① 模型识别 归一化模型名 → 有序正则规则匹配 → 分层覆盖合并
② 规格取值 命中即取：多模态 ← 公开信息；思考等级 ← 官方文档条目（表内带 source）
③ 兜底 未命中 → 端点元数据补数值 → 可选实测探测 → 名称启发式只给候选，不自动写
字段按来源判定，而非仅凭型号命中：有文档来源的内置字段可写，未知字段保持未设置。
resolveModelInfo 返回的是目录、用户配置和默认值合并后的当前配置，
msc/authoritative 将其标记为 resolved-config，仅供诊断，不再覆盖注册表建议。
只有明确标记为 catalog 的独立元数据才可优先补全；当前宿主接口不提供该来源证明。
思考等级继续保留内置表、手动实测与只展示不写的名称候选，详见
docs/03-inference-rules.md。
规则表是有序正则 + 分层覆盖，不是扁平名表 —— glm-5.3-flash 要同时继承
glm-5（容量）、glm-5.3（档位）、glm-5.3-flash（多模态）三层信息。
表的范式参考了同类工具的注册表设计（有序规则数组 + 分层覆盖），
分析见 docs/03-inference-rules.md §2。
别名表 ALIASES：第三方聚合站普遍加厂商前缀或改写成别名
（openai/gpt-4o、deepseek-chat ↔ deepseek-v4-flash），归一化剥离 org/ 之后再过一层别名，
别名只改匹配用名、不改显示名。
不静默写错值是硬底线：未识别时不写 input / reasoningEfforts（键直接不出现在结果里），
界面显示「未识别」并允许手动指定。
不碰配置文件：安装只动 profile 的 package.json（link/git 依赖），不手写
cordis.patch.yml；密钥走官方 credentials 面（配置里只留 apiKeyEnv 引用）。
填值走官方受控控件，持久化由用户按官方「保存」触发 —— 插件自己 settings.mutate
会顶掉 revision 导致官方保存撞 settings/conflict，所以插件零写库。
实测值不回流离线表：探测结果只填进当前表单供确认，离线表始终是随插件版本更新的资产。
input 事件打标，其余写入视为用户手改并登记；
此后自动路径不再回写你的改动 —— 改 id 也不会抹掉。input 或本次手动选择冲突，
保留用户选择并提示手动确认；不会把默认纯文本误当官方结论，也不会强制全部勾选图像。profile 条目上的五个开关（见 cordis.patch.yml）：
| 键 | 默认 | 含义 |
|---|---|---|
enabled | true | 总开关（false 时行内不渲染任何控件） |
autoApplyContext | true | 允许把上下文窗口 / 最大输出填进官方行 |
autoApplyModality | true | 允许把输入模态填进官方行 |
autoApplyReasoning | true | 允许把思考等级填进官方行 |
allowProbe | true | 是否显示「测试」（探测只在手动点击时发生） |
| 层 | 文件 | 职责 |
|---|---|---|
| Host 半 | index.js | 规则判定、当前解析配置、实测探测：msc/infer / msc/authoritative / msc/probe |
| Client 半 | client.js | Provider 卡片与新增草稿入口、逐行 Portal、受控表单填值与生命周期清理 |
| 规则数据 | data/model-rules.js | 有序正则规则与逐字段文档来源；显式未知字段不继承旧值 |
| 判定层 | rules/ | 名称归一化、分层匹配、字段来源和可写性判定 |
| 测试 | test/ | 规则、来源、宿主 RPC、渲染、挂载、React 受控交互与草稿回归 |
行内定位不依赖 CSS-module 哈希类名（哈希随构建变）。插件只用官方通过
data-plugin-css 注入的稳定字面类名 label.dshModelModalityToggleCompact 作行锚点
（每行恰好一个），并显式重写该行的 gridTemplateColumns 给自己腾出一格，
撤走时把官方原值还原。
行内有横向预算：长文案一律进绝对定位的悬浮弹层（0 宽度），行内只留短词 + 一个字的
状态记号；每个行内元素都有 max-width 上限。这条规矩和它的实测数字写在
client.js 的 CSS_TEXT 上方注释里。
方式一 · GUI：打开插件管理器 → 添加插件 → 粘贴本仓库 URL（或本地绝对路径）。
方式二 · CLI：
dsh plugin --profile <profile> add https://github.com/Seller-1990/dsh-model-smart-config
<spec> 也接受 file: / link: 前缀、.tgz、或绝对路径（相对路径会被拒绝）。
更新应通过插件管理器或官方 CLI 完成；按上一节核验 Client 与 Host 实际版本，不以安装成功提示替代运行验证。
卸载：
dsh plugin --profile <profile> remove dsh-model-smart-config
npm install
npm test
测试覆盖规则表与字段来源、Host RPC 合同、SSR 首帧、行内挂载与空间预算、
jsdom 交互、React 受控字段以及新增草稿生命周期。实际桌面宿主 bundle 的装配回归
使用 MSC_HOST_MODELS_BUNDLE 指定本机副本，再执行 npm run test:host-assembly；
未提供该环境变量会明确失败，不会把这一项静默跳过。该测试不等同于当前窗口端到端验收。
渲染/交互测试需要一份真实的 React 与 jsdom（已列入 devDependencies），
也可以用 MSC_REACT_ENV / MSC_DOM_ENV 指向别的 node_modules 布局。
单独跑规则表：
npm run test:rules。 注意node --test test/（目录形式）在当前 Node 下会误报 1 个失败，请按上面的脚本逐文件跑。
infer 只查内置规则；兼容端点 authoritative
只读本机的当前解析配置（不是独立官方目录证明），其 resolved-config 字段不作为可写能力。apiKeyEnv（没有就按 provider 名派生
*_API_KEY）在本机 credentials 面解析出密钥，然后只对你在这个 provider 里填的
baseURL 发一次最小请求，用来看哪些思考等级会被接受。debug 日志）、不进返回值、
不跨越 Host↔Client 通道（credentials.describe/resolve 只在 Host 进程内使用）。
插件自身不采集、不上报、不落盘任何凭据。source，便于核对与纠错。
未命中的模型不会被猜一个值写进去。| 文件 | 内容 |
|---|---|
docs/01-research.md | 调研结论与证据链：官方能力边界、可用通道、环境实测 |
docs/02-architecture.md | 插件架构、包结构、数据流、卡片交互、实现顺序 |
docs/03-inference-rules.md | 模型识别与参数判定规则；注册表范式分析（§2） |
docs/04-risks-and-decisions.md | 已定决策、技术风险、验收标准 |
安装验证与逐轮实现证据属于本机实测记录，不随公开仓库分发； 上文提及的实测数字（几何、字节数、
rev）均出自那些记录。