dsh-plugin-effort-declare 0.1.0

package/CONTRIBUTING.en.md

@@ -0,0 +1,57 @@
+# Contributing
+
+<p align="center">
+  <samp>
+    <a href="./CONTRIBUTING.md">中文</a> ·
+    <strong>English</strong>
+  </samp>
+</p>
+
+Back to the [README](./README.en.md). Issues and pull requests are welcome.
+
+## Boundary
+
+Write `llm-pi-ai` settings only:
+
+- No `llm/stream` intercept
+- No fork of the official Models page
+- No parallel effort table
+- No per-model `reasoningEfforts` in the bundle layer (settings dict merge has no delete semantics)
+- Do not set route-level `reasoning` to `high`
+
+Any new model-visible input must land in a session-log-rebuildable mechanism. This plugin does not inject prompt text.
+
+Clearing a declaration unsets `reasoningEfforts` (absence = default off). Do not write `false`.
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+```
+
+- Host and client must use separate `tsconfig` files (their Context merges cannot share one TypeScript program)
+- The client bundle must not inline `@deepseek-ai/*` except platform modules in the shell’s frozen table. Collaborate through Cordis services; do not value-import the official Models page
+- Source: [src/README.md](./src/README.md); domain logic: [src/core/README.md](./src/core/README.md); settings UI: [src/client/README.md](./src/client/README.md); tests: [tests/README.md](./tests/README.md)
+
+Before sending a change, say whether it is a bugfix, UI improvement, or an alignment with a newer DSH / pi-ai schema. Update zh and en docs together. The root README and [INSTALL.en.md](./INSTALL.en.md) are for users; this file and the READMEs under `src/` and `tests/` are for people changing code.
+
+Canonical level names and `thinkingFormat` enums come from the installed `llm-pi-ai` schema / catalog. The repo keeps a fallback whitelist pinned by tests; if the schema drifts, update the tests first, then the UI.
+
+## Publishing to npm
+
+The package name is unscoped `dsh-plugin-effort-declare`. After `npm login`, with a clean working tree:
+
+```bash
+pnpm test && pnpm typecheck && pnpm build
+pnpm pack      # confirm the tarball contains lib/ and cordis.patch.yml
+pnpm publish
+```
+
+`pnpm publish` fails on an unclean Git tree. Commit first (and preferably push). Do not pass `--no-git-checks`.
+
+## Security
+
+Do not paste API keys or `.credentials.yaml` values into logs, screenshots, docs, or issues.

package/CONTRIBUTING.md

@@ -0,0 +1,57 @@
+# 贡献
+
+<p align="center">
+  <samp>
+    <strong>中文</strong> ·
+    <a href="./CONTRIBUTING.en.md">English</a>
+  </samp>
+</p>
+
+回到 [README](./README.md)。欢迎 Issue 与 Pull Request。
+
+## 边界
+
+只写 `llm-pi-ai` 配置：
+
+- 不要加 `llm/stream` 拦截
+- 不要 fork 官方模型页
+- 不要平行再存一份档位表
+- 不要在 bundle 层预置 per-model `reasoningEfforts`（settings 字典合并没有删除语义）
+- 不要把路由级 `reasoning` 写成 `high`
+
+新增任何模型可见输入，必须走会话日志可重建的机制。本插件不向模型注入提示词。
+
+「清除声明」是删掉 `reasoningEfforts`（缺席 = 默认关闭），不要写成 `false`。
+
+## 开发
+
+```bash
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm build
+```
+
+- Host 与 client 必须分 `tsconfig`（两边 Context merge 不能共一个 TypeScript Program）
+- 客户端 bundle 禁止把 `@deepseek-ai/*` 打进包内（shell 冻结模块表里的平台模块除外）。跨插件协作走 Cordis 服务，不要 value-import 官方模型页
+- 源码：[src/README.md](./src/README.md)；领域逻辑：[src/core/README.md](./src/core/README.md)；设置页：[src/client/README.md](./src/client/README.md)；测试：[tests/README.md](./tests/README.md)
+
+提交前请说明改动是修 bug、增强 UI，还是对齐新的 DSH / pi-ai schema。中英文档一起改。根 README 和 [INSTALL.md](./INSTALL.md) 面向使用者；本文件与 `src/`、`tests/` 的 README 面向改代码的人。
+
+上游档位名与 `thinkingFormat` 枚举以 DSH 安装里 `llm-pi-ai` 的 schema / catalog 为准。仓库内有一份回退白名单，并由测试钉住；schema 漂移时应先改测试再改 UI。
+
+## 发布到 npm
+
+包名 `dsh-plugin-effort-declare`（未加 scope）。先 `npm login`，工作区干净后再：
+
+```bash
+pnpm test && pnpm typecheck && pnpm build
+pnpm pack      # 确认 tarball 含 lib/ 与 cordis.patch.yml
+pnpm publish
+```
+
+`pnpm publish` 在 Git 有未提交改动时会失败。应先 commit（建议再 push），不要用 `--no-git-checks` 绕过。
+
+## 安全
+
+不要在日志、截图、文档或 issue 中粘贴 API 密钥或 `.credentials.yaml` 的值。

package/INSTALL.en.md

@@ -0,0 +1,62 @@
+# Install
+
+<p align="center">
+  <samp>
+    <a href="./INSTALL.md">中文</a> ·
+    <strong>English</strong>
+  </samp>
+</p>
+
+Back to the [README](./README.en.md). Requires DeepSeek Harness **0.1.0-rc.8 or newer**. Do not use `npm install`; use `dsh plugin` below.
+
+## Desktop users: do this first
+
+`dsh plugin` installs into the **current** `DSH_HOME`. If unset, that is `.dsh` in your user folder — **not** Desktop’s data directory.
+
+PowerShell:
+
+```powershell
+$env:DSH_HOME = "$env:APPDATA\io.github.hairyf.deepseek-harness-desktop\data\dsh"
+```
+
+Set this before the install command. The profile name is usually `web`.
+
+## From npm (recommended)
+
+```bash
+dsh plugin --profile web add dsh-plugin-effort-declare
+```
+
+Optional: confirm it is loaded:
+
+```bash
+dsh --profile web --dump-config
+```
+
+The output should mention `dsh-plugin-effort-declare`.
+
+## Other methods
+
+GitHub:
+
+```bash
+dsh plugin --profile web add github:zimodzh/dsh-plugin-effort-declare
+```
+
+If pnpm refuses to build, add the package name to `allowBuilds` in that profile’s `pnpm-workspace.yaml`, then `add` again.
+
+Local folder (`lib/` must already exist; on Windows prefer forward slashes):
+
+```bash
+dsh plugin --profile web add file:/absolute/path/to/dsh-plugin-effort-declare
+```
+
+## After install
+
+Restart DSH (on Desktop, restart its backend). Open **Settings → Reasoning efforts**. Add a custom provider on the Models page first; otherwise this page has nothing to edit.
+
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-plugin-effort-declare
+```

package/INSTALL.md

@@ -0,0 +1,62 @@
+# 安装
+
+<p align="center">
+  <samp>
+    <strong>中文</strong> ·
+    <a href="./INSTALL.en.md">English</a>
+  </samp>
+</p>
+
+回到 [README](./README.md)。需要 DeepSeek Harness **0.1.0-rc.8 或更新**。不要用 `npm install`，必须用下面的 `dsh plugin` 命令。
+
+## Desktop 用户请先做这一步
+
+`dsh plugin` 会装进**当前** `DSH_HOME`。没设置时默认是用户目录下的 `.dsh`，**不是** Desktop 自己的数据目录。
+
+PowerShell：
+
+```powershell
+$env:DSH_HOME = "$env:APPDATA\io.github.hairyf.deepseek-harness-desktop\data\dsh"
+```
+
+设好后再跑安装命令。配置档名称一般是 `web`。
+
+## 从 npm 安装（推荐）
+
+```bash
+dsh plugin --profile web add dsh-plugin-effort-declare
+```
+
+可选：确认已经装上：
+
+```bash
+dsh --profile web --dump-config
+```
+
+输出里应出现 `dsh-plugin-effort-declare`。
+
+## 其他方式
+
+GitHub：
+
+```bash
+dsh plugin --profile web add github:zimodzh/dsh-plugin-effort-declare
+```
+
+如果 pnpm 拒绝构建，把包名加进该配置档里 `pnpm-workspace.yaml` 的 `allowBuilds`，再 `add` 一次。
+
+本地文件夹（仓库里需要已有 `lib/`；Windows 建议用正斜杠）：
+
+```bash
+dsh plugin --profile web add file:/绝对路径/dsh-plugin-effort-declare
+```
+
+## 装完之后
+
+重启 DSH（Desktop 请重启其后端）。打开 **设置 → 推理档位**。先在「模型」页添加第三方提供方，本页才会出现可编辑的条目。
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-plugin-effort-declare
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stardust
+
+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.en.md

@@ -0,0 +1,64 @@
+# dsh-plugin-effort-declare
+
+<p align="center">
+  <samp>
+    <a href="./README.md">中文</a> ·
+    <strong>English</strong>
+  </samp>
+</p>
+
+Add reasoning-effort options to OpenAI-compatible models you added yourself, so the Effort row shows up in the composer.
+
+This is a community plugin. It is not an official DeepSeek project and is not endorsed by DeepSeek. Requires DeepSeek Harness **0.1.0-rc.8 or newer**.
+
+## Why
+
+Custom providers you add on the Models page usually have no reasoning levels, so the composer hides Effort. This plugin adds a **Reasoning efforts** page in Settings: you pick which levels a model can offer. The per-turn choice and the HTTP request still go through DSH. This plugin only writes settings, not API keys.
+
+- Does not change models you have not saved
+- Does not change the current or default effort
+- Does not replace the official Models page
+
+## Features
+
+| Feature | What it does |
+| --- | --- |
+| Reasoning efforts page | Choose levels per model; change the gateway spelling if it differs |
+| Presets | DeepSeek compatible, OpenAI compatible, or on/off only. A preset **replaces** that dialect; it does not stack |
+| vs Models | Models owns the endpoint, keys, and model list; this page only declares which reasoning levels are offered |
+
+## Install
+
+Do not use `npm install`. In a terminal:
+
+```bash
+dsh plugin --profile web add dsh-plugin-effort-declare
+```
+
+If you use **DeepSeek Harness Desktop**, set `DSH_HOME` first or the package lands in the wrong folder. See the [install guide](./INSTALL.en.md).
+
+Restart DSH, then open **Settings → Reasoning efforts**. Add a custom provider on the Models page first. GitHub, local folder, and uninstall: [install guide](./INSTALL.en.md).
+
+## Usage
+
+1. Open the provider card, or apply a preset first.
+2. Check the levels that should appear in the picker. Change the spelling if the gateway uses different names. Off (no thinking) can be: not offered; offered without sending a parameter; or send `none` (or another string).
+3. You can usually leave **Advanced** collapsed.
+4. Save. If you selected no thinking level, or only Off, the error is shown on that card.
+
+Saving is disabled when settings are read-only.
+
+## Limits
+
+- Only custom providers you added on Models, using the OpenAI Completions protocol
+- Official DeepSeek, catalog models, and Anthropic endpoints are not edited here
+- **Clear this model’s declaration** hides the Effort row again for that model
+- Will not silently turn thinking on for background work such as titles or compaction
+
+## Development
+
+Code, pull requests, and npm publishing: [CONTRIBUTING.en.md](./CONTRIBUTING.en.md).
+
+## License
+
+[MIT](./LICENSE) © 2026 Stardust

package/README.md

@@ -0,0 +1,64 @@
+# dsh-plugin-effort-declare
+
+<p align="center">
+  <samp>
+    <strong>中文</strong> ·
+    <a href="./README.en.md">English</a>
+  </samp>
+</p>
+
+给自己添加的 OpenAI 兼容模型补上「推理强度」选项，对话里的 Effort 行就会出现。
+
+这是社区插件，不是 DeepSeek 官方项目，也未获官方背书。需要 DeepSeek Harness **0.1.0-rc.8 或更新**。
+
+## 它解决什么
+
+你在「模型」页手工加的第三方接口，通常没有推理档位，所以对话里看不到 Effort。装上本插件后，设置里会多一页 **推理档位**：勾选这个模型能提供哪些档。对话里怎么选、请求怎么发给接口，仍由 DSH 处理。本插件只改设置，不改密钥。
+
+- 不会自动改你没保存过的模型
+- 不会改你当前选中的档位，也不会改默认档位
+- 不会替换官方「模型」页
+
+## 功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 推理档位页 | 按模型勾选可选档位；网关用的名字如果不同，可以改拼写 |
+| 预设 | DeepSeek 兼容、OpenAI 兼容、只开/关思考。点预设会换成那一套，不是叠加上去 |
+| 和「模型」页 | 「模型」管地址、密钥和模型名单；本页只管「能选哪些推理档」 |
+
+## 安装
+
+不要用 `npm install`。在终端执行：
+
+```bash
+dsh plugin --profile web add dsh-plugin-effort-declare
+```
+
+若使用 **DeepSeek Harness Desktop**，必须先设置 `DSH_HOME`，否则会装到另一份目录。步骤见 [安装说明](./INSTALL.md)。
+
+装完后重启 DSH，打开 **设置 → 推理档位**。请先在「模型」页添加过第三方提供方。GitHub、本地文件夹和卸载也在 [安装说明](./INSTALL.md)。
+
+## 使用
+
+1. 打开对应提供方的卡片，或先点一个预设。
+2. 勾选这个模型要出现在选择器里的档位。网关名字不同就改拼写。关闭思考（Off）可以：不提供、提供但不发参数、或发送 `none` 等字符串。
+3. 一般不用打开「高级」。
+4. 点保存。若一个思考档都没选、或只开了 Off，错误会显示在这张卡片上。
+
+当前设置为只读时无法保存。
+
+## 限制
+
+- 只对你在「模型」页**手工添加**、协议为 OpenAI Completions 的提供方生效
+- 官方 DeepSeek、目录自带的模型、Anthropic 接口不在本页编辑
+- 「清除本模型声明」之后，这个模型会重新没有 Effort 行
+- 不会在生成标题、压缩等后台请求里偷偷打开思考
+
+## 开发
+
+改代码、提 PR、发布到 npm：见 [CONTRIBUTING.md](./CONTRIBUTING.md)。
+
+## License
+
+[MIT](./LICENSE) © 2026 Stardust

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Inserts the dual-face plugin row. Host apply is empty in v1; the browser
+# half (package.json dsh.client) registers the settings.section.
+- insert:
+    - id: dsh-plugin-effort-declare
+      name: 'dsh-plugin-effort-declare'