dsh-model-visibility 0.1.1 → 0.2.0

package/README.en.md

@@ -1,48 +1,48 @@
-# dsh-model-visibility
-
-**English · [中文](README.md)**
-
-Model visibility for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): control which models appear in the conversation model selector.
-
-Installs a dedicated **Model visibility** settings section (right after 模型 / Models in the left nav):
-
-- 🔍 **Search** — live filter by model name / id / provider
-- 🎚️ **Per-model switches** — hide a model and it disappears from the selector instantly; flip back to restore
-- 📦 **Provider-level batch** — hide or show every model of one provider in one click
-- ♻️ **Reset all** — clear the hidden list
-- 🛡️ **Zero intrusion** — writes only the plugin's own hidden list, never your provider config; hiding a model a session already uses never interrupts that session
-- 🆕 **New models visible by default** — the plugin remembers what to hide, not what to show
-
-## Preview
-
-![Model visibility section](https://raw.githubusercontent.com/Lzh3070/dsh-model-visibility/main/docs/screenshot.png)
-
-## Requirements
-
-- DeepSeek Harness ≥ 0.1.1-rc.2 (earlier versions untested)
-- Node.js 22+
-
-## Install
-
-```sh
-dsh plugin --profile web add dsh-model-visibility
-```
-
-Restart `dsh web` to activate.
-
-## How it works
-
-- **Host half** (`lib/index.js`): owns the `model-visibility` settings section (the hidden list) and wraps `ctx.llm.listModels` at its source, so both `session.models` (the conversation selector) and `llm.models` (the settings page) receive the filtered catalog. Catalog membership is advisory in the harness, so hiding a model a session already uses never breaks that session's dispatch.
-- **Browser half** (`lib/client.js`): registers a `settings.section` page; page state is the union of the filtered catalog and the hidden entries, each hidden entry labeled by the display-name snapshot captured when it was hidden.
-
-## Uninstall
-
-```sh
-dsh plugin --profile web remove dsh-model-visibility
-```
-
-Uninstalling restores everything: the plugin never writes provider config, and the hidden list dies with the package.
-
-## License
-
-MIT
+# dsh-model-visibility
+
+**English · [中文](README.md)**
+
+Model visibility for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness): control which models appear in the conversation model selector.
+
+Installs a dedicated **Model visibility** settings section (right after 模型 / Models in the left nav):
+
+- 🔍 **Search** — live filter by model name / id / provider
+- 🎚️ **Per-model switches** — hide a model and it disappears from the selector instantly; flip back to restore
+- 📦 **Provider-level batch** — hide or show every model of one provider in one click
+- ♻️ **Reset all** — clear the hidden list
+- 🛡️ **Zero intrusion** — writes only the plugin's own hidden list, never your provider config; hiding a model a session already uses never interrupts that session
+- 🆕 **New models visible by default** — the plugin remembers what to hide, not what to show
+
+## Preview
+
+![Model visibility section](https://raw.githubusercontent.com/Lzh3070/dsh-model-visibility/main/docs/screenshot.png)
+
+## Requirements
+
+- **DeepSeek Harness ≥ 0.2.0-rc.1** (0.2.0 rebuilt settings on volatile configuration and `configForms`; use plugin 0.1.2 on 0.1.x hosts)
+- Node.js 22+
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-model-visibility
+```
+
+Restart `dsh web` to activate.
+
+## How it works
+
+- **Host half** (`lib/index.js`): declares the `hidden` field `.volatile()`, so a settings-form write commits the new value into the same stable reference through the Loader (no plugin restart), and wraps `ctx.llm.listModels` at its source — both the conversation selector and the settings page receive the filtered catalog. Catalog membership is advisory in the harness, so hiding a model a session already uses never breaks that session's dispatch.
+- **Browser half** (`lib/client.js`): registers a `settings.section` page; durable state rides 0.2.0's shared `ctx.configForms` form, the catalog arrives through `ctx.remote.session.modelCatalog()` and refreshes on `llm/adapters-updated`, and page state is the union of the filtered catalog and the hidden entries, each hidden entry labeled by the display-name snapshot captured when it was hidden.
+
+## Uninstall
+
+```sh
+dsh plugin --profile web remove dsh-model-visibility
+```
+
+Uninstalling restores everything: the plugin never writes provider config, and the hidden list dies with the package.
+
+## License
+
+MIT

package/README.md

@@ -1,48 +1,48 @@
-# dsh-model-visibility
-
-**[English](README.en.md) · 中文**
-
-[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的模型可见性插件：控制哪些模型出现在对话界面的模型选择菜单里。
-
-安装后在设置左侧导航提供一个独立的「**模型可见性**」分区页（紧跟「模型」）：
-
-- 🔍 **搜索** —— 按模型名/ID/渠道名实时过滤
-- 🎚️ **逐模型开关** —— 隐藏的模型立即从选择器消失，显示即恢复
-- 📦 **渠道级批量** —— 一键隐藏/显示某个 Provider 的全部模型
-- ♻️ **一键恢复全部** —— 清空隐藏列表
-- 🛡️ **零侵入** —— 只写插件自己的隐藏列表，不改你的 Provider 配置；隐藏正在使用的模型不会中断该会话
-- 🆕 **新模型自动可见** —— 插件只记录"要隐藏什么"，Provider 新广告的模型默认出现
-
-## 预览
-
-![模型可见性分区页](https://raw.githubusercontent.com/Lzh3070/dsh-model-visibility/main/docs/screenshot.png)
-
-## 要求
-
-- DeepSeek Harness ≥ 0.1.1-rc.2（更早版本未测试）
-- Node.js 22+（构建与运行）
-
-## 安装
-
-```sh
-dsh plugin --profile web add dsh-model-visibility
-```
-
-重启 `dsh web` 后生效。
-
-## 工作原理
-
-- **宿主半**（`lib/index.js`）：持有 `model-visibility` 设置段（隐藏列表），并在源头包装 `ctx.llm.listModels`——会话选择器（`session.models`）与设置页（`llm.models`）拿到的目录都是过滤后的。目录成员资格在 harness 中是"建议性"的，因此隐藏一个正在使用的模型不影响其调度。
-- **浏览器半**（`lib/client.js`）：向设置壳注册一个 `settings.section` 分区页；页面状态来自"过滤后目录 ∪ 隐藏条目"的并集，隐藏条目携带隐藏时抓取的显示名快照。
-
-## 卸载
-
-```sh
-dsh plugin --profile web remove dsh-model-visibility
-```
-
-卸载即恢复原状：插件不写入 Provider 配置，隐藏列表随包删除自动失效。
-
-## License
-
-MIT
+# dsh-model-visibility
+
+**[English](README.en.md) · 中文**
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的模型可见性插件：控制哪些模型出现在对话界面的模型选择菜单里。
+
+安装后在设置左侧导航提供一个独立的「**模型可见性**」分区页（紧跟「模型」）：
+
+- 🔍 **搜索** —— 按模型名/ID/渠道名实时过滤
+- 🎚️ **逐模型开关** —— 隐藏的模型立即从选择器消失，显示即恢复
+- 📦 **渠道级批量** —— 一键隐藏/显示某个 Provider 的全部模型
+- ♻️ **一键恢复全部** —— 清空隐藏列表
+- 🛡️ **零侵入** —— 只写插件自己的隐藏列表，不改你的 Provider 配置；隐藏正在使用的模型不会中断该会话
+- 🆕 **新模型自动可见** —— 插件只记录"要隐藏什么"，Provider 新广告的模型默认出现
+
+## 预览
+
+![模型可见性分区页](https://raw.githubusercontent.com/Lzh3070/dsh-model-visibility/main/docs/screenshot.png)
+
+## 要求
+
+- **DeepSeek Harness ≥ 0.2.0-rc.1**（0.2.0 以 volatile 配置与 `configForms` 重构了设置体系；0.1.x 宿主请使用本插件 0.1.2）
+- Node.js 22+（构建与运行）
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-model-visibility
+```
+
+重启 `dsh web` 后生效。
+
+## 工作原理
+
+- **宿主半**（`lib/index.js`）：`hidden` 字段声明为 `.volatile()`，设置表单写入时由 Loader 把新值原地提交进同一稳定引用（插件不重启），并在源头包装 `ctx.llm.listModels`——会话选择器与设置页拿到的目录都是过滤后的。目录成员资格在 harness 中是"建议性"的，因此隐藏一个正在使用的模型不影响其调度。
+- **浏览器半**（`lib/client.js`）：向设置壳注册一个 `settings.section` 分区页；持久状态经 0.2.0 的 `ctx.configForms` 共享表单读写，目录经 `ctx.remote.session.modelCatalog()` 读取并跟随 `llm/adapters-updated` 失效刷新；页面状态来自"过滤后目录 ∪ 隐藏条目"的并集，隐藏条目携带隐藏时抓取的显示名快照。
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove dsh-model-visibility
+```
+
+卸载即恢复原状：插件不写入 Provider 配置，隐藏列表随包删除自动失效。
+
+## License
+
+MIT