@lklkuu/dsh-prompt-optimizer 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.1.1] - 2026-11-15
+
+### 修复
+
+- 插件介绍页（详情页）此前总是显示英文 README，与界面语言无关。原因是包内没有声明
+  `meta.detail`，DSH 只能回退到写死的 `README.md`；而 `README.zh.md` 不在它的候选名单里，
+  永远不会被选中。
+- 现在 `locale/en.json` 与 `locale/zh.json` 各自声明了 `meta`（`title` / `description` /
+  `detail`），中文界面读 `docs/DETAIL.zh.md`，英文界面读 `docs/DETAIL.md`，日文等其它语言
+  按 DSH 的语言回退链落到英文文档。
+
+### 新增
+
+- `docs/DETAIL.zh.md`（中文版详情文档），`docs/DETAIL.md` 改写为英文版，两份内容一一对应。
+- `docs/preview.svg`（640×300，无文字、无脚本、无外部资源，明暗主题都可读），
+  两张详情文档顶部各引用它一次。
+- 插件列表里的名称与一句话说明改为随界面语言切换，不再显示裸包名。
+
 ## [0.1.0] - 2026-11-15
 
 首个发布版本。

package/README.md

@@ -28,10 +28,10 @@ usage only — no code was copied.
 dsh plugin --profile desktop add @lklkuu/dsh-prompt-optimizer
 ```
 
-Or straight from this repository (works before the npm release is live):
+Or from the tarball attached to the latest Release:
 
 ```bash
-dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer
+dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/releases/latest/download/dsh-prompt-optimizer.tgz
 ```
 
 Restart DSH (or reload the page) so the client module loads.

package/README.zh.md

@@ -28,7 +28,7 @@ dsh plugin --profile desktop add @lklkuu/dsh-prompt-optimizer
 或从 Release 里的 tarball 安装：
 
 ```bash
-dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/releases/download/v0.1.0/dsh-prompt-optimizer-0.1.0.tgz
+dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/releases/latest/download/dsh-prompt-optimizer.tgz
 ```
 
 安装后需要重启 DSH（或刷新页面）让客户端模块加载。

package/docs/DETAIL.md

@@ -1,57 +1,65 @@
+![A loose draft on the left, a star-shaped Optimize button in the composer, and a structured prompt on the right](preview.svg)
+
 # dsh-prompt-optimizer
 
-在 DeepSeek Harness 的对话框右侧加一个「优化」按钮：拿输入框里的草稿，交给当前选中的模型，按
-[linshenkx/prompt-optimizer](https://github.com/linshenkx/prompt-optimizer) 的「基础优化」
-（`user-optimize/user-prompt-basic`，v2.0.0）模板改写，然后把结果写回输入框。
+Adds an **Optimize** button to the right of the DeepSeek Harness composer: it takes the draft
+you have typed, hands it to the model currently selected in the conversation, rewrites it with the
+"basic optimize" template from
+[linshenkx/prompt-optimizer](https://github.com/linshenkx/prompt-optimizer)
+(`user-optimize/user-prompt-basic`, v2.0.0), and writes the result straight back into the composer.
 
-不安装 prompt-optimizer 本体，不依赖 Docker / Bun / 浏览器扩展，也不需要任何额外的 API Key ——
-用的是你在 DSH 里已经选好的那个模型。
+It does not install prompt-optimizer itself, and it needs no Docker, Bun, browser extension, or
+extra API key — it uses the model you already have selected in DSH.
 
-## 用法
+## Usage
 
-1. 在输入框里写点东西（空的时候按钮是灰的）。
-2. 点「优化」。按钮变成「优化中…」，再点一次可以取消。
-3. 结果直接替换输入框内容，旁边出现「已优化 · 撤销」，点一下回到原文。
+1. Type something into the composer (the button is greyed out while it is empty).
+2. Click **Optimize**. The button turns into "Optimizing…"; click it again to cancel.
+3. The result replaces the composer content, and an "Optimized · Undo" chip appears next to it —
+   one click restores the original text.
 
-超过 150 秒没返回会自己取消并提示超时。
+If no answer comes back within 150 seconds the request cancels itself and reports a timeout.
 
-## 它做了什么
+## What it does
 
-| 环节 | 实现 |
+| Step | Implementation |
 | --- | --- |
-| 按钮位置 | `conversation.input.right` 槽位，`order: 12`（在图片提供方 10 与 Codex 配额 15 之间） |
-| 读草稿 | 槽位标准 prop `useInput(s => s.draft)` |
-| 调模型 | host 半 `POST /api/prompt-optimizer/optimize` → `ctx.get('llm').stream()` |
-| 选模型 | `agentDefaultModel.currentSelection()`，即你当前对话选中的模型 |
-| 写回 | `inputActions.setDraft(text)` + `persistDraft()` |
+| Button placement | `conversation.input.right` slot, `order: 12` (between the image-provider pill at 10 and the Codex quota at 15) |
+| Read the draft | The slot's standard prop `useInput(s => s.draft)` |
+| Call the model | Host half `POST /api/prompt-optimizer/optimize` → `ctx.get('llm').stream()` |
+| Pick the model | `agentDefaultModel.currentSelection()`, i.e. the model selected for this conversation |
+| Write back | `inputActions.setDraft(text)` + `persistDraft()` |
 
-提示词就是 linshenkx/prompt-optimizer 的原文，唯一改动是把模板里的 Mustache
-`{{#helpers.toJson}}{{{originalPrompt}}}{{/helpers.toJson}}` 换成本地 `JSON.stringify(draft)`
-—— 效果一样，但不需要引入模板引擎。
+The prompt is the linshenkx/prompt-optimizer text verbatim; the only change is replacing the
+Mustache placeholder `{{#helpers.toJson}}{{{originalPrompt}}}{{/helpers.toJson}}` with a local
+`JSON.stringify(draft)` — same effect, without pulling in a template engine.
 
-这一路是**旁路调用**，不进会话记录，不消耗会话轮次，不改动任何会话文件。
+The call runs **out of band**: it is not appended to the session transcript, does not consume a
+conversation turn, and does not touch any session file.
 
-## 配置
+## Configuration
 
-没有配置项。想做更激进的改写（分析型、结构化、面向输出格式等），改 `index.js` 里的
-`SYSTEM_PROMPT` 与 `renderUserPrompt` 即可 —— 上游仓库有 144 个模板可选。
+There are no settings. To try a more aggressive rewrite (analytical, structured, output-format
+oriented, …), edit `SYSTEM_PROMPT` and `renderUserPrompt` in `index.js` — the upstream repository
+ships 144 templates to choose from.
 
-## 已知边界
+## Known limits
 
-- 只在**有浏览器界面**的 profile 生效（desktop / web）。headless、tui、sdk 下 host 半照常加载，
-  但 `/api` 路由不注册，前端也拿不到按钮。
-- 依赖宿主的 `llm`、`agentDefaultModel`、`connection` 三个服务；任何一项缺失时按钮不渲染或报错，
-  不会静默失败。
-- `inputActions.setDraft` 会整段替换草稿，光标位置不保留。
+- Only works in a profile **with a browser UI** (desktop / web). Under headless, tui and sdk the
+  host half still loads, but the `/api` route is never registered and the front end has no button.
+- Depends on the host's `llm`, `agentDefaultModel` and `connection` services; if one is missing the
+  button is not rendered or an error is reported — it never fails silently.
+- `inputActions.setDraft` replaces the whole draft, so the caret position is not preserved.
 
-## 卸载
+## Uninstall
 
 ```bash
 dsh plugin --profile desktop remove @lklkuu/dsh-prompt-optimizer
 ```
 
-或在本机 profile 的插件管理里停用该条目。
+Or disable the entry in the plugin manager of your local profile.
 
-## 许可
+## License
 
-MIT。提示词模板来自 linshenkx/prompt-optimizer（AGPL-3.0），此处仅作提示词文本引用。
+MIT. The prompt template comes from linshenkx/prompt-optimizer (AGPL-3.0); only the prompt text is
+quoted here.

package/docs/DETAIL.zh.md

@@ -0,0 +1,59 @@
+![左边是一段随手写的草稿，输入框里有一颗星形的「优化」按钮，右边是整理好的提示词](preview.svg)
+
+# dsh-prompt-optimizer
+
+在 DeepSeek Harness 的对话框右侧加一个「优化」按钮：拿输入框里的草稿，交给当前选中的模型，按
+[linshenkx/prompt-optimizer](https://github.com/linshenkx/prompt-optimizer) 的「基础优化」
+（`user-optimize/user-prompt-basic`，v2.0.0）模板改写，然后把结果写回输入框。
+
+不安装 prompt-optimizer 本体，不依赖 Docker / Bun / 浏览器扩展，也不需要任何额外的 API Key ——
+用的是你在 DSH 里已经选好的那个模型。
+
+## 用法
+
+1. 在输入框里写点东西（空的时候按钮是灰的）。
+2. 点「优化」。按钮变成「优化中…」，再点一次可以取消。
+3. 结果直接替换输入框内容，旁边出现「已优化 · 撤销」，点一下回到原文。
+
+超过 150 秒没返回会自己取消并提示超时。
+
+## 它做了什么
+
+| 环节 | 实现 |
+| --- | --- |
+| 按钮位置 | `conversation.input.right` 槽位，`order: 12`（在图片提供方 10 与 Codex 配额 15 之间） |
+| 读草稿 | 槽位标准 prop `useInput(s => s.draft)` |
+| 调模型 | host 半 `POST /api/prompt-optimizer/optimize` → `ctx.get('llm').stream()` |
+| 选模型 | `agentDefaultModel.currentSelection()`，即你当前对话选中的模型 |
+| 写回 | `inputActions.setDraft(text)` + `persistDraft()` |
+
+提示词就是 linshenkx/prompt-optimizer 的原文，唯一改动是把模板里的 Mustache
+`{{#helpers.toJson}}{{{originalPrompt}}}{{/helpers.toJson}}` 换成本地 `JSON.stringify(draft)`
+—— 效果一样，但不需要引入模板引擎。
+
+这一路是**旁路调用**，不进会话记录，不消耗会话轮次，不改动任何会话文件。
+
+## 配置
+
+没有配置项。想做更激进的改写（分析型、结构化、面向输出格式等），改 `index.js` 里的
+`SYSTEM_PROMPT` 与 `renderUserPrompt` 即可 —— 上游仓库有 144 个模板可选。
+
+## 已知边界
+
+- 只在**有浏览器界面**的 profile 生效（desktop / web）。headless、tui、sdk 下 host 半照常加载，
+  但 `/api` 路由不注册，前端也拿不到按钮。
+- 依赖宿主的 `llm`、`agentDefaultModel`、`connection` 三个服务；任何一项缺失时按钮不渲染或报错，
+  不会静默失败。
+- `inputActions.setDraft` 会整段替换草稿，光标位置不保留。
+
+## 卸载
+
+```bash
+dsh plugin --profile desktop remove @lklkuu/dsh-prompt-optimizer
+```
+
+或在本机 profile 的插件管理里停用该条目。
+
+## 许可
+
+MIT。提示词模板来自 linshenkx/prompt-optimizer（AGPL-3.0），此处仅作提示词文本引用。

package/docs/RELEASE-NOTES-0.1.0.md

@@ -9,11 +9,13 @@
 
 ## 安装
 
+npm（推荐）：
+
 ```bash
-dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer
+dsh plugin --profile desktop add @lklkuu/dsh-prompt-optimizer
 ```
 
-或直接用本页附件（版本无关的稳定链接，推荐）：
+或直接用本页附件（版本无关的稳定链接）：
 
 ```bash
 dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/releases/latest/download/dsh-prompt-optimizer.tgz
@@ -21,6 +23,8 @@ dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/
 
 安装后重启 DSH（或刷新页面）让客户端模块加载。
 
+> 注意：npm 上的 `dsh-prompt-optimizer`（不带 scope）是**别人的同名包**，不是本插件。
+
 ## 用法
 
 1. 输入框写点东西（空时按钮是灰的）。
@@ -51,6 +55,8 @@ dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/
 | `dsh-prompt-optimizer.tgz` | 版本无关，`latest/download/` 可直接引用 |
 | `dsh-prompt-optimizer-0.1.0.tgz` | 钉住本版本，内容相同 |
 
-SHA-256（`.tgz`，两者相同）：`7cf95d36ca059a7dc58fa2f4549b2fa59baa58313e7f3df25f6504a5140833ed`
+SHA-256（`.tgz`，两者相同）：`14b8fdf5f0cd6fe3dc90baf06c28e626b4c73bb2732c2d1b4526f33fe22b5751`
+
+与 npm 上 `@lklkuu/dsh-prompt-optimizer@0.1.0` 的 tarball 字节完全一致。
 
 MIT License.

package/docs/RELEASE-NOTES-0.1.1.md

@@ -0,0 +1,57 @@
+# dsh-prompt-optimizer 0.1.1
+
+「优化」按钮的功能与 0.1.0 完全一致，这一版只修了一件事：**插件介绍页不再一律显示英文**。
+
+## 修了什么
+
+装好插件后点开它的介绍页，之前不管界面语言是什么，看到的都是英文 `README.md`。
+
+原因不在本插件，而在 DSH 的查找顺序：详情页会先读 `locale/<语言>.json` 里的 `meta.detail`，
+只有那里没声明时，才回退到包里的 README。而那个兜底名单是写死的
+`README.md` / `readme.md` / `Readme.md` / `README.markdown` / `README` ——
+`README.zh.md` 既不在名单里，也不匹配它的匹配规则，所以中文版永远轮不到。
+
+这一版按 DSH 的约定，把文案和文档分开声明：
+
+| 界面语言 | 读哪份文档 |
+| --- | --- |
+| 简体中文 | `docs/DETAIL.zh.md` |
+| English | `docs/DETAIL.md` |
+| 其它语言 | 按回退链落到 `docs/DETAIL.md` |
+
+插件列表里显示的名称与一句话说明也一并跟着界面语言切换，不再显示裸包名。
+
+## 顺带加的
+
+- `docs/DETAIL.zh.md`：中文版详情文档（原有内容）。
+- `docs/DETAIL.md`：改写为英文版，与中文版逐段对应。
+- `docs/preview.svg`：640×300 示意图，不含文字、脚本与外部资源，明暗主题下都能看。
+  两份详情文档顶部各引用它一次。
+
+## 安装 / 升级
+
+```bash
+dsh plugin --profile desktop add @lklkuu/dsh-prompt-optimizer
+```
+
+也可以直接指向本 Release 里的 tarball：
+
+```bash
+dsh plugin --profile desktop add https://github.com/lklkuu/dsh-prompt-optimizer/releases/download/v0.1.1/dsh-prompt-optimizer.tgz
+```
+
+升级后刷新页面即可看到中文介绍页，不需要重启 DSH。
+
+## 校验
+
+- `npm test` → 15 tests / 15 pass / 0 fail
+- `npm pack --dry-run` → 15 个文件，包体 18.0 kB，含 `docs/DETAIL.md`、`docs/DETAIL.zh.md`、
+  `docs/preview.svg`、`locale/en.json`、`locale/zh.json`
+- 用 DSH 自己的语言链规则离线复算：`zh-CN → zh-cn > zh > en → docs/DETAIL.zh.md`，
+  `en-US → en-us > en → docs/DETAIL.md`，`ja-JP → ja-jp > ja > en → docs/DETAIL.md`
+
+## 许可
+
+本插件代码 MIT。改写用的提示词模板逐字取自
+[linshenkx/prompt-optimizer](https://github.com/linshenkx/prompt-optimizer) 的
+`user-optimize/user-prompt-basic`（AGPL-3.0），本仓库不含该项目的代码。

package/docs/preview.svg

@@ -0,0 +1,32 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="300" viewBox="0 0 640 300">
+  <rect width="640" height="300" rx="20" fill="#f3f5f9"/>
+
+  <!-- left: the loose draft -->
+  <rect x="48" y="82" width="248" height="136" rx="16" fill="#ffffff" stroke="#b7c3d2" stroke-width="2"/>
+  <rect x="72" y="108" width="150" height="8" rx="4" fill="#d6dde7"/>
+  <rect x="72" y="130" width="196" height="8" rx="4" fill="#e0e5ed"/>
+  <rect x="72" y="152" width="112" height="8" rx="4" fill="#e0e5ed"/>
+  <rect x="72" y="174" width="164" height="8" rx="4" fill="#e8edf3"/>
+  <circle cx="262" cy="192" r="16" fill="#e7edf5"/>
+  <path d="M262.00 182.00 L264.25 188.91 L271.51 188.91 L265.63 193.18 L267.88 200.09 L262.00 195.82 L256.12 200.09 L258.37 193.18 L252.49 188.91 L259.75 188.91Z" fill="none" stroke="#63758c" stroke-width="1.8" stroke-linejoin="round"/>
+
+  <!-- middle: the action -->
+  <path d="M312 150h24" fill="none" stroke="#9aa9bb" stroke-width="2" stroke-linecap="round"/>
+  <path d="M330 144l6 6-6 6" fill="none" stroke="#9aa9bb" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- right: the structured prompt -->
+  <rect x="352" y="82" width="240" height="136" rx="16" fill="#ffffff" stroke="#247bbf" stroke-width="2"/>
+  <circle cx="376" cy="110" r="4" fill="#247bbf"/>
+  <rect x="390" y="106" width="128" height="8" rx="4" fill="#c8d6e5"/>
+  <circle cx="376" cy="134" r="4" fill="#247bbf"/>
+  <rect x="390" y="130" width="164" height="8" rx="4" fill="#d6e0ea"/>
+  <circle cx="376" cy="158" r="4" fill="#247bbf"/>
+  <rect x="390" y="154" width="146" height="8" rx="4" fill="#d6e0ea"/>
+  <circle cx="376" cy="182" r="4" fill="#247bbf"/>
+  <rect x="390" y="178" width="112" height="8" rx="4" fill="#e0e8f0"/>
+  <circle cx="568" cy="192" r="16" fill="#247bbf"/>
+  <path d="M568.00 182.00 L570.25 188.91 L577.51 188.91 L571.63 193.18 L573.88 200.09 L568.00 195.82 L562.12 200.09 L564.37 193.18 L558.49 188.91 L565.75 188.91Z" fill="#ffffff"/>
+
+  <!-- orbit ring: the call goes out and comes back -->
+  <path d="M176 236c60 34 228 34 288 0" fill="none" stroke="#c3cede" stroke-width="2" stroke-linecap="round" stroke-dasharray="7 9"/>
+</svg>

package/locale/en.json

@@ -1,4 +1,9 @@
 {
+  "meta": {
+    "title": "Prompt Optimizer",
+    "description": "Adds a star-shaped Optimize button to the right of the composer: with a draft in the input, one click has the model currently selected for this conversation rewrite it using the \"basic optimize\" template from linshenkx/prompt-optimizer, and the result is written straight back into the composer with an \"Optimized · Undo\" chip to restore the original. Click again to cancel; it times out after 150 seconds. It uses the model you already selected, needs no extra API key, and never enters the session transcript. The button is greyed out while the draft is empty, and it only appears in a profile with a browser UI (desktop / web).",
+    "detail": "docs/DETAIL.md"
+  },
   "btn.label": "Optimize",
   "btn.title": "Rewrite this prompt with prompt-optimizer basic-optimize",
   "btn.running": "Optimizing…",

package/locale/zh.json

@@ -1,4 +1,9 @@
 {
+  "meta": {
+    "title": "提示词优化",
+    "description": "在对话框右侧加一个星形「优化」按钮：输入框有草稿时点它，当前选中的模型会按 linshenkx/prompt-optimizer 的「基础优化」模板改写这段提示词，结果直接写回输入框，旁边出现「已优化 · 撤销」可一键还原。再点一次按钮可取消，超过 150 秒自动超时。用的是你已选好的模型，不需要额外 API Key，也不会写进会话记录。输入框为空时按钮是灰的；只在有浏览器界面的 profile（desktop / web）显示。",
+    "detail": "docs/DETAIL.zh.md"
+  },
   "btn.label": "优化",
   "btn.title": "用 prompt-optimizer 的「基础优化」改写这段提示词",
   "btn.running": "优化中…",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lklkuu/dsh-prompt-optimizer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "publishConfig": {
     "access": "public"
   },