dsh-plugin-choice-refresh 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## [0.1.4] - 2026-08-29
+
+- 文档：兼容性补实测版本声明（DSH 0.1.1-rc.2）；
+- 元数据：description 加「生态唯一」钩子，keywords 10 → 16；
+- 新增英文版 README.en.md 与双语切换行；CHANGELOG.md 纳入 npm files。
+## [0.1.3] - 2026-08-25
+
+- 相关插件段新增 dsh-plugin-windows-guard（Windows 环境防坑守则 skill 插件，互相引流）。
+
+
+## [0.1.2] - 2026-08-21
+
+- README 新增「相关插件」互相引用段（列出同系列已发布插件，npm / GitHub 链接 + 一句话说明），互相引流。
+
+## [0.1.1] - 2026-08-19
+
+- 首发：选择增强（「重新生成选项」/「更多选项」按钮），纯前端实现，支持文字与图片选项卡。
+- 发布 npm、GitHub topics、dsh-market 收录（issue #40）。

package/README.en.md

@@ -0,0 +1,117 @@
+[中文](./README.md) | **English**
+
+# dsh-plugin-choice-refresh
+
+![npm version](https://img.shields.io/npm/v/dsh-plugin-choice-refresh)
+![License](https://img.shields.io/github/license/Pasumao/dsh-plugin-choice-refresh)
+![AI Assisted](https://img.shields.io/badge/AI-Assisted-8A2BE2)
+
+**The only choice-enhancement plugin in the dsh plugin market**: it adds two buttons to the choice cards of `ask_user_question` / `ask_user_choice` —
+not happy with any of the options? One click has the model come back with a completely different batch. Too few options? One click has the model add more.
+
+| Button | Scenario | Effect |
+| --- | --- | --- |
+| 🔄 **Regenerate options** (「重新生成选项」) | None of the offered options works for you | One click has the model re-ask with a completely different batch of options (new angle / style / dimension, 5–8 options) |
+| ➕ **More options** (「更多选项」) | Too few options to choose from | One click has the model re-ask while keeping the original options and adding new ones (6–10 options in total) |
+
+Purely client-side interaction, **registers no new tools and modifies no core packages**; works on both native text option cards and the
+[dsh-plugin-image-tools](https://github.com/Pasumao/dsh-plugin-image-tools) image option cards (image cards are rendered directly by this plugin, reusing its image routes).
+
+## Screenshot
+
+![choice-refresh in action: two buttons appear at the bottom of the choice card](docs/choice-buttons.png)
+
+Two extra buttons appear automatically at the bottom of the card:
+
+![choice-refresh in action: after clicking "More options", the model adds options and re-asks](docs/choice-more-options.png)
+
+After clicking "➕ More options": the model keeps the original options, adds new ones up to 6–10 total, and re-asks.
+
+> Real Web GUI screenshots.
+
+## Features
+
+- 🔄 **Regenerate options**: when none of the options offered by `ask_user_question` / `ask_user_choice` works for you, one click cancels the current question and has the model re-ask with a completely different batch of options (new angle / style / dimension, 5–8 options);
+- ➕ **More options**: when the options are too few to choose from, one click has the model keep the original options and add new ones (6–10 in total);
+- Purely client-side interaction, **registers no new tools and modifies no core packages**;
+- Works on native text option cards and `dsh-plugin-image-tools` image option cards alike;
+- Compatible with the `plan-review` plan review card, without affecting the native flow.
+
+## Configuration
+
+No configuration needed — install and it works:
+
+- Reads no environment variables, needs no API key / token, writes no config files;
+- Button labels follow `ctx.locale` (zh / en bilingual), with no extra setup;
+- Behavior is driven by the `【系统 · 选项刷新】` (system · option refresh) / `【系统 · 更多选项】` (system · more options) messages injected by the buttons; the model re-asks according to those instructions.
+
+## Installation
+
+```powershell
+# npm (recommended)
+dsh plugin --profile web add dsh-plugin-choice-refresh
+# or GitHub
+dsh plugin --profile web add github:Pasumao/dsh-plugin-choice-refresh
+```
+
+Install from source (local development / debugging):
+
+```bash
+git clone https://github.com/Pasumao/dsh-plugin-choice-refresh.git
+cd dsh-plugin-choice-refresh
+npm install        # or pnpm install
+# Mount into the profile via link:, see 设计说明.md (design notes) for details
+```
+
+Once installed, refresh the browser and it takes effect (hot-reloads automatically when the profile already has dsh-client-hmr — no restart needed).
+For local development, you can mount the plugin via `link:` instead — see `设计说明.md` (design notes) for details.
+
+## Usage
+
+When the model asks a question as usual via `ask_user_question` / `ask_user_choice` (e.g. following the novel-* skills), two extra buttons — **Regenerate options** and **More options** — appear at the bottom of the choice card:
+
+- Click **Regenerate options**: the current question is cancelled, and a `【系统 · 选项刷新】` user message is injected for the model, which immediately re-asks with a fresh set of options;
+- Click **More options**: same as above — a `【系统 · 更多选项】` message is injected, and the model keeps the original options and adds more.
+
+> The injected message stays short (one or two lines) and remains in the session as a user message so the model can understand the instruction;
+> the UI displays it verbatim.
+
+> Note: the refresh / top-up is done by the model, which re-invokes the question tool after reading the instruction — this is a "soft" enhancement, and the model may occasionally adjust the question itself. If you are still not satisfied with the result, click the button again or simply type what you want.
+
+## Self-check
+
+```powershell
+# In the plugin directory (local dev clone / link mount)
+npm run smoke   # selfcheck + smoke-client
+```
+
+## Compatibility
+
+- Tested on DSH `0.1.1-rc.2`; requires the DSH web GUI (an entry in the `conversation.composer` chain, priority -300).
+- Directly compatible with the image cards of a co-installed `dsh-plugin-image-tools`; without it, plain text options work as usual.
+- `plan-review` intents (plan review cards) are passed through to the native `PlanReviewPanel`, unaffected.
+- Depends on the client services `slots` / `locale` / `sessions` / `remote`.
+
+## Related plugins
+
+This plugin is part of **Pasumao's dsh plugin ecosystem**; the other published plugins in the series pair well with it:
+
+| Plugin (npm) | GitHub | Description |
+|---|---|---|
+| [dsh-notify](https://www.npmjs.com/package/dsh-notify) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-notify) | Native Windows notifications + system tray |
+| [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-dev-kb) | Plugin development knowledge base (full mirror of the official docs + skill) |
+| [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-image-tools) | Image choice cards + inline images in replies + image handoff for text-only models |
+| [dsh-plugin-table-zoom](https://www.npmjs.com/package/dsh-plugin-table-zoom) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-table-zoom) | Floating-window viewer for long chat tables + one-click Markdown copy |
+| [dsh-plugin-windows-guard](https://www.npmjs.com/package/dsh-plugin-windows-guard) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-windows-guard) | Windows environment guard: rule skills + mojibake detection / dangerous-write blocking / encoding diagnostics & repair |
+| [dsh-plugin-workbench](https://www.npmjs.com/package/dsh-plugin-workbench) | [GitHub repo](https://github.com/Pasumao/dsh-plugin-workbench) | VS Code-style file explorer + editable preview |
+
+> For the rest of the series, see [Pasumao · dsh plugins](https://github.com/Pasumao); if you find them useful, a ⭐ on GitHub is always appreciated.
+
+## AI generation disclosure
+
+Code and documentation are AI-assisted (DeepSeek Harness), all human-reviewed and verified on a live install
+(`npm run smoke`: selfcheck + fake-client smoke test).
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -4,6 +4,8 @@
 ![License](https://img.shields.io/github/license/Pasumao/dsh-plugin-choice-refresh)
 ![AI Assisted](https://img.shields.io/badge/AI-Assisted-8A2BE2)
 
+[**中文**](./README.md) | [English](./README.en.md)
+
 **dsh 插件市场里唯一的选择增强插件**：给 `ask_user_question` / `ask_user_choice` 的选择卡加上两个按钮——
 选项都不满意？一键让模型换一批完全不同的。选项太少？一键让模型补充。
 
@@ -16,6 +18,18 @@
 [dsh-plugin-image-tools](https://github.com/Pasumao/dsh-plugin-image-tools) 的
 图片选项卡都生效（图片卡由本插件直接渲染，复用其图片路由）。
 
+## 效果图
+
+![choice-refresh 实机截图：选择卡底部出现「重新生成选项 / 更多选项」按钮](docs/choice-buttons.png)
+
+选择卡底部自动多出两个按钮：
+
+![choice-refresh 实机截图：点「更多选项」后模型补充选项并重新提问](docs/choice-more-options.png)
+
+点「➕ 更多选项」后：模型保留原选项、补充到 6~10 个并重新提问。
+
+> 真实 Web GUI 截图。
+
 ## 功能
 
 - 🔄 **重新生成选项**：`ask_user_question` / `ask_user_choice` 给出的选项都不满意时，
@@ -78,7 +92,7 @@ npm run smoke   # selfcheck + smoke-client
 
 ## 兼容性
 
-- 需要 DSH web GUI（`conversation.composer` 链条目，priority -300）。
+- 实测于 DSH `0.1.1-rc.2`；需要 DSH web GUI（`conversation.composer` 链条目，priority -300）。
 - 与 `dsh-plugin-image-tools` 共存的图片卡直接兼容；未安装时纯文字选项照常。
 - `plan-review` 意图（计划审阅卡）放行给原生 `PlanReviewPanel`，不受影响。
 - 依赖客户端服务：`slots` / `locale` / `sessions` / `remote`。
@@ -93,7 +107,7 @@ npm run smoke   # selfcheck + smoke-client
 | [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-dev-kb) | 插件开发知识库（官方文档完整镜像 + 技能） |
 | [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-image-tools) | 图片选择卡 + 回复内嵌图片 + 盲模型收图 |
 | [dsh-plugin-table-zoom](https://www.npmjs.com/package/dsh-plugin-table-zoom) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-table-zoom) | 聊天长表格浮窗查看 + 一键复制 Markdown |
-| [dsh-plugin-windows-guard](https://www.npmjs.com/package/dsh-plugin-windows-guard) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-windows-guard) | Windows 环境防坑守则 skill（编码/转义/路径/进程/乱码预防） |
+| [dsh-plugin-windows-guard](https://www.npmjs.com/package/dsh-plugin-windows-guard) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-windows-guard) | Windows 环境防坑：守则技能 + 乱码检测 / 危险写拦截 / 编码诊断修复 |
 | [dsh-plugin-workbench](https://www.npmjs.com/package/dsh-plugin-workbench) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-workbench) | VS Code 风格文件浏览器 + 可编辑预览 |
 
 > 本系列其余插件见 [Pasumao · dsh 插件](https://github.com/Pasumao)；觉得好用欢迎到 GitHub 点 ⭐。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-choice-refresh",
-  "description": "DSH 选择增强插件：在 ask_user_question / ask_user_choice 的选择卡上提供「重新生成选项」（都不满意一键刷新）与「更多选项」（选项太少一键补充）按钮。纯前端交互实现（取消当前问题 + steer 提示模型重新提问），不改核心包、不新增工具。",
-  "version": "0.1.3",
+  "description": "DSH 选择增强插件（生态唯一）：给 ask_user_question / ask_user_choice 的选择卡加「重新生成选项 / 更多选项」两个按钮——选项都不满意一键换一批（换角度/维度，5~8 个），选项太少一键补充到 6~10 个。纯前端交互实现，不改核心包、不新增工具，原生文字卡与图片选择卡通吃。",
+  "version": "0.1.4",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -12,8 +12,11 @@
   "files": [
     "lib",
     "scripts",
+    "docs",
     "cordis.patch.yml",
     "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
     "LICENSE",
     "设计说明.md"
   ],
@@ -45,7 +48,13 @@
     "plugin",
     "choice",
     "refresh",
-    "regenerate",
+    "regenerate-options",
+    "more-options",
+    "ask-user",
+    "question",
+    "ux",
+    "chat-ui",
+    "frontend",
     "options"
   ],
   "license": "MIT",