@lynn123411/dsh-model-submenu 0.2.2 → 0.2.3

package/DETAILS.md

@@ -0,0 +1,46 @@
+# @lynn123411/dsh-model-submenu 详情
+
+> 本文档是 [README.md](./README.md) 的补充：装配形态、开发副本与验证。
+
+## 装配形态
+
+装进 profile 一条命令即可，profile 侧不用手写任何补丁：
+
+```bash
+dsh plugin --profile web add @lynn123411/dsh-model-submenu
+```
+
+这条命令把包名写进 profile 的 `dependencies`，并登记进 `dsh.profile.bundles`；包内 `cordis.patch.yml` 随之插入一条根层行：
+
+```yaml
+- insert:
+    - id: lynn-model-submenu
+      name: '@lynn123411/dsh-model-submenu'
+```
+
+这条行同时承载两个半边：宿主半边在那条行下注册插件本体，浏览器半边由 Web shell 按 root loader 的 enabled entry 依据 `dsh.client` 声明服务 `lib/client.js`。行不写 `config`——写了当场抛，免得拼错的行静默什么都不注册。
+
+客户端半边声明的服务（`dsh.client.inject`）：`@deepseek-ai/dsh-client-ui-slots`、`@deepseek-ai/dsh-client-locale`、`@deepseek-ai/dsh-client-ui-model-selection`。少声明一个不会报错，只会让插件在页面里消失。
+
+## 开发副本
+
+运行副本用 `link:` 连到本仓库目录，改完即生效（细则见仓库 `docs/rules/dev-copy.md`）：
+
+```bash
+cd ~/.dsh/profiles/web && pnpm add "link:<my-dsh 绝对路径>/plugins/dsh-model-submenu" --offline
+cd <my-dsh 绝对路径>/plugins/dsh-model-submenu && pnpm install && pnpm build
+```
+
+客户端半边改完刷新页面即生效，必要时硬刷新一次；宿主半边要重启 DSH 实例（loader 只在启动时装载）。
+
+## 验证
+
+在包目录跑一条链：
+
+```bash
+cd plugins/dsh-model-submenu && pnpm check
+```
+
+`check` = `typecheck` + `build`（tsdown）+ `smoke` + `assert:lib-untracked`。`scripts/smoke-client.mjs` 按 Web shell 的方式装载构建产物 `lib/client.js`（`window.__ModuleLoader__.load` 桩件），喂假 cordis 服务，断言导出身份、`inject` 表、以 `priority: -100` 接管 `conversation.input.model` 座位，以及各供应商与模型的注册项齐全；`lib/` 是构建镜像，`assert:lib-untracked` 判它没被 git 跟踪。
+
+要肉眼确认页面上的形态，用仓库的 `node tools/verify-client.mjs dsh-model-submenu --needle '<你新写的类名或文案>'`。

package/README.md

@@ -1,19 +1,22 @@
 # @lynn123411/dsh-model-submenu
 
-给输入框里的模型选择器加上供应商层级：先在供应商里挑，再挑该供应商的模型。
+给输入框里的模型选择器加上供应商层级：先在供应商里挑，再挑这个供应商的模型，模型列表与推理等级都留在同一张原生弹层里。
 
-## 特性
+## 功能
 
-- **一级仍是原生两行**：根面板保持内置弹层的两行结构，「供应商」取代原来的「模型」，右侧显示当前供应商名；「推理等级」行原样保留。
-- **第二级按供应商**：点「供应商」进入供应商列表；当前供应商那行显示它正在使用的模型名并带勾选，其余行显示该供应商的模型数量，顺序沿用 Host 给出的顺序。
-- **第三级按模型**：点某个供应商，同一面板内换成它的模型列表，面板顶部是返回行；点模型立即提交并关闭。
-- **推理等级照原生**：根面板的「推理等级」行进入当前模型的等级列表，选中即提交，「Default」行表示跟随供应商默认；当前模型没有推理等级时不显示该行。
-- **失败与加载态照旧**：目录加载中显示刷新提示，加载失败与供应商加载失败都在供应商列表顶部给出提示与「重新加载」；提交被拒时弹出与内置同款的提示气泡。
+- **按供应商挑模型**：点「供应商」进入供应商列表，当前供应商那行显示它正在使用的模型名并带勾选，其余行显示它有多少个模型；再点某个供应商，同一面板内换成它的模型列表，点模型立即提交并关闭。
+- **推理等级照原生**：根面板的「推理等级」行进入当前模型的等级列表，选中即提交，「Default」行表示跟随供应商默认；当前模型没有推理等级时不显示这一行。
+- **加载与失败有提示**：目录加载中显示刷新提示，加载失败与供应商加载失败都在列表顶部给出提示与「重新加载」，提交被拒时弹出与内置同款的提示气泡。
 - **键鼠行为照旧**：方向键在行间移动、Tab 等同回车、Escape 与 Shift+Tab 先退回上一层、在根层才关闭；输入框过窄时触发器只显示图标。
+
+## 特性
+
+- **一级仍是原生两行**：根面板保持内置弹层的两行结构，「供应商」取代原来的「模型」，右侧显示当前供应商名，「推理等级」行原样保留。
 - **接管内置座位**：以 `priority: -100` 占据 `conversation.input.model`，外观沿用内置弹层与 `--dsw-*` 主题变量；`/model` 命令面板与设置页不受影响。
+- **形态与装配**：bundle 型插件，客户端半边随包内 `cordis.patch.yml` 的根层行服务，profile 侧不用手写补丁；装法、开发副本与验证见 [DETAILS.md](./DETAILS.md)。
 
 ## 安装
 
-```
+```bash
 dsh plugin --profile web add @lynn123411/dsh-model-submenu
-```
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynn123411/dsh-model-submenu",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "给输入框的模型选择器加上供应商层级：先选供应商，再选它下面的模型。",
   "license": "MIT",
   "publishConfig": {
@@ -35,7 +35,8 @@
     "cordis.patch.yml",
     "README.md",
     "locale",
-    "assets"
+    "assets",
+    "DETAILS.md"
   ],
   "dsh": {
     "bundle": {