dsh-effort-menu 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LYLMagui
+
+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,106 @@
-# Temporary Holding Version
+# dsh-effort-menu
 
-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.
+A replacement model menu for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) composer: pick a model and set its reasoning effort in the same popup.
+
+[![MIT license](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![DSH >=0.2.2-rc.1](https://img.shields.io/badge/DSH-%3E%3D0.2.2--rc.1-4d6bfe)](#compatibility)
+
+English | [简体中文](./README.zh-CN.md)
+
+In the shipped menu, effort lives in a submenu: after switching models, the "Effort" row opens a second list with Default, Low, High and Max. Following zcode's approach, this plugin puts the levels on a slider at the bottom of the menu instead. The slider has one node per level the current model supports, so the effort can be dragged right after picking a model.
+
+The three most recent models sit at the top, and hovering the provider row opens every model in a flyout. Reads and writes go through the shipped per-session model directory, so the native selector and the `/model` popup share the same state.
+
+## Screenshots
+
+The model menu, with the reasoning-effort slider at the bottom.
+
+| Light | Dark |
+| --- | --- |
+| <img src="docs/screenshots/menu-light.png" alt="Model menu with the reasoning-effort slider, light theme" width="400"> | <img src="docs/screenshots/menu-dark.png" alt="Model menu with the reasoning-effort slider, dark theme" width="400"> |
+
+Hovering the provider row opens a flyout with every provider's models.
+
+<img src="docs/screenshots/flyout-light.png" alt="Model menu with the all-models flyout, light theme" width="620">
+
+<img src="docs/screenshots/flyout-dark.png" alt="Model menu with the all-models flyout, dark theme" width="620">
+
+## Features
+
+- The current level carries over on a model switch; if the new model lacks it, its highest level is used.
+- A model without its own default gets a leading "Default" node that leaves the choice to the provider.
+- A model list that fails to load is reported in the menu with a retry button.
+- Keyboard support. Arrow keys move between items and adjust the slider, `Esc` closes the menu.
+- Follows the app's light and dark themes; interface text in English and Chinese.
+
+## Install
+
+Requires DSH `0.2.2-rc.1` or newer, with a build that ships the `dsh-client-ui-conversation`, `dsh-client-ui-model-selection` and `dsh-client-locale` client packages (see [Compatibility](#compatibility)).
+
+### Web
+
+With a CLI-managed profile, one command installs it into `web`.
+
+```sh
+dsh plugin --profile web add dsh-effort-menu
+```
+
+There is no build step. The browser half is the committed `client.js`. Restart `dsh web`, or reload the page.
+
+### Desktop
+
+The `desktop` profile is managed by the app. Fully quit the app before using the CLI, or keep it running and install the checkout directory through **Plugin Manager**.
+
+```sh
+# CLI install, with the desktop app fully quit
+dsh plugin --profile desktop add dsh-effort-menu
+
+# Or clone it and point Plugin Manager at the directory
+git clone https://github.com/xuanfenglajiao/dsh-effort-menu.git
+```
+
+Restart the app after installing.
+
+### Manual
+
+If you would rather not use the CLI, edit the profile's own `package.json`.
+
+**Web profile.** Edit `~/.dsh/profiles/web/package.json` and add the package to `dependencies`.
+
+```json
+"dependencies": {
+  "dsh-effort-menu": "^1.0.0"
+}
+```
+
+Then append it to the `dsh.profile.bundles` array.
+
+```json
+"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-effort-menu"]
+```
+
+Run `pnpm install` in that directory and restart `dsh web`.
+
+**Desktop profile.** Edit `~/.dsh/profiles/desktop/package.json` and add the same entry to `dependencies` only. The desktop profile does not list plugins in `bundles`.
+
+```json
+"dependencies": {
+  "dsh-effort-menu": "^1.0.0"
+}
+```
+
+Run `pnpm install` and restart the app.
+
+**Uninstall** with `dsh plugin --profile web remove dsh-effort-menu`, or remove it in Plugin Manager on the desktop app.
+
+## Compatibility
+
+- Supports DSH `0.2.2-rc.1` and newer. Developed and tested on DeepSeek Harness Desktop 44.7.0 (DSH `0.2.2-rc.1`) on Windows 11; earlier DSH versions are not supported.
+- The current model must expose `reasoning.efforts` for the slider to have anything to show. Otherwise the menu says the model provides no levels.
+- Renders nothing in subagent sessions.
+
+## Known limitations
+
+- **One occupant of the model slot.** The plugin takes over the single slot `conversation.input.model` at priority `-1`, shadowing the shipped selector. Another plugin that replaces the same slot competes for it, so install only one. Plugins that restyle the shipped selector from outside may not apply to this menu.
+- **The model label sub-slot is not extensible.** `conversation.input.model.label` is declared by the shipped model-selection package, and a second declaration makes the whole client entry fail to load. This plugin therefore renders model names itself, and labels that other plugins contribute to that sub-slot do not appear here.
+- **No automated tests yet.** Changes are checked by hand in a running app.

package/README.zh-CN.md

@@ -0,0 +1,106 @@
+# dsh-effort-menu
+
+给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 输入框换一个模型菜单，选模型和调思考强度在同一个弹层里完成。
+
+[![MIT license](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![DSH >=0.2.2-rc.1](https://img.shields.io/badge/DSH-%3E%3D0.2.2--rc.1-4d6bfe)](#兼容性)
+
+[English](./README.md) | 简体中文
+
+官方菜单把思考强度放在二级菜单「推理等级」里，换完模型还要再点进去，从 Default、Low、High、Max 里挑。本插件参考 zcode 的做法，把档位做成菜单底部的一条滑杆。当前模型有几档，滑杆上就有几个点，选完模型直接拖。
+
+顶部列着最近用过的三个模型，悬停提供商行会在右侧展开全部模型。读写走的是官方的会话模型目录，和原生选择器、`/model` 弹窗共用一份状态。
+
+## 截图
+
+模型菜单，底部是当前模型的思考强度滑杆。
+
+| 浅色 | 深色 |
+| --- | --- |
+| <img src="docs/screenshots/menu-light.png" alt="带思考强度滑杆的模型菜单（浅色主题）" width="400"> | <img src="docs/screenshots/menu-dark.png" alt="带思考强度滑杆的模型菜单（深色主题）" width="400"> |
+
+悬停提供商行，会在右侧展开全部提供商的模型。
+
+<img src="docs/screenshots/flyout-light.png" alt="模型菜单与全部模型列表（浅色主题）" width="620">
+
+<img src="docs/screenshots/flyout-dark.png" alt="模型菜单与全部模型列表（深色主题）" width="620">
+
+## 功能
+
+- 切换模型时沿用当前档位，新模型没有这一档就用它的最高档。
+- 模型没有自带默认值时，滑杆最左侧多一个「默认」档，交给提供商决定。
+- 模型列表加载失败会在菜单里提示，可以直接重试。
+- 支持键盘操作。方向键切换菜单项、调节滑杆，`Esc` 关闭菜单。
+- 跟随应用的浅色和深色主题，界面提供中文和英文。
+
+## 安装
+
+需要 DSH `0.2.2-rc.1` 或更新版本，并自带 `dsh-client-ui-conversation`、`dsh-client-ui-model-selection` 和 `dsh-client-locale` 三个客户端包（见[兼容性](#兼容性)）。
+
+### Web 端
+
+用 CLI 管理 profile 时，一条命令装进 `web`。
+
+```sh
+dsh plugin --profile web add dsh-effort-menu
+```
+
+本插件没有构建步骤，浏览器端就是仓库里提交的 `client.js`。装完重启 `dsh web`，或者刷新页面。
+
+### 桌面端
+
+`desktop` profile 由应用管理。先完全退出桌面应用，再用 CLI 安装；或者不退出，打开应用内的 **Plugin Manager** 选择安装这个目录。
+
+```sh
+# CLI 安装，需要先完全退出桌面应用
+dsh plugin --profile desktop add dsh-effort-menu
+
+# 或者克隆下来，在 Plugin Manager 里选择这个目录
+git clone https://github.com/xuanfenglajiao/dsh-effort-menu.git
+```
+
+装完重启应用。
+
+### 手动安装
+
+不想动 CLI 时，可以直接改 profile 自己的 `package.json`。
+
+**Web profile。** 编辑 `~/.dsh/profiles/web/package.json`，在 `dependencies` 里加上本插件。
+
+```json
+"dependencies": {
+  "dsh-effort-menu": "^1.0.0"
+}
+```
+
+再把它追加到 `dsh.profile.bundles` 数组里。
+
+```json
+"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-effort-menu"]
+```
+
+然后在同一目录执行 `pnpm install`，重启 `dsh web`。
+
+**桌面端 profile。** 编辑 `~/.dsh/profiles/desktop/package.json`，只在 `dependencies` 里加同样的条目。桌面端不把插件写进 `bundles` 列表。
+
+```json
+"dependencies": {
+  "dsh-effort-menu": "^1.0.0"
+}
+```
+
+执行 `pnpm install`，重启应用。
+
+**卸载**时执行 `dsh plugin --profile web remove dsh-effort-menu`，桌面端在 Plugin Manager 里移除即可。
+
+## 兼容性
+
+- 支持 DSH `0.2.2-rc.1` 及更新版本。开发和测试用的是 DeepSeek Harness Desktop 44.7.0（DSH `0.2.2-rc.1`），Windows 11；更早的 DSH 版本不受支持。
+- 当前模型必须公布 `reasoning.efforts`，滑杆才有内容可显示。否则菜单会提示该模型没有可选档位。
+- 在子代理会话中不渲染任何内容。
+
+## 已知限制
+
+- **模型槽位只能有一个占用者。** 本插件以优先级 `-1` 接管单占位槽 `conversation.input.model`，遮住官方选择器。其他同样替换该槽位的插件会与它竞争，请只安装其中一个。从外部给官方选择器改样式的插件，可能对这个菜单不生效。
+- **模型标签子槽无法扩展。** `conversation.input.model.label` 由官方 model-selection 包声明，重复声明会让整个客户端条目加载失败。因此本插件自己渲染模型名称，其他插件贡献到该子槽的标签不会显示在这里。
+- **暂无自动化测试。** 目前靠在运行中的应用里手工验证。