dsh-composer-lists 1.0.0 → 1.0.1

package/README.md

@@ -1,64 +1,69 @@
 # dsh-composer-lists
 
-DSH（DeepSeek Harness）聊天输入框的列表编排插件：自动续号与重排、标记感知的光标移动、层级升降，以及一个可撤销的 AI 提示词优化按钮。
+[![CI](https://github.com/wangjianghu/dsh-composer-lists/actions/workflows/ci.yml/badge.svg)](https://github.com/wangjianghu/dsh-composer-lists/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/dsh-composer-lists)](https://www.npmjs.com/package/dsh-composer-lists)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 
-Ordered/unordered list editing for the DeepSeek Harness message composer: automatic numbering and renumbering, marker-aware caret moves, level promotion, and an undoable AI prompt-polish button.
+**一键把粗糙的想法改写成结构化的 Agent 提示词**，再把输入框变成顺手的多级列表编辑器。Turn a rough idea into a structured agent prompt in one click — plus ordered/unordered list editing in the DSH composer.
 
-## 安装 / Install
+## ✨ AI 提示词结构化改写（核心功能）
 
-```sh
-dsh plugin add dsh-composer-lists
+写 Agent 提示词最耗时的不是措辞，是结构：目标、步骤、约束混成一团，模型只能猜。点一下输入框旁的 ✨，当前草稿会被改写为「**一句话任务目标 + 有序步骤列表（含子层级）+ 无序约束与验收标准**」的结构化提示词——正是 Agent 最容易准确执行的形态。
+
+改写效果示例 / What the rewrite looks like:
+
+```text
+✨ 改写前                                          改写后 ↩
+帮我做个周报，要包含这周做了什么，              1. 生成本周工作周报，按项目分组。
+下周的计划，还有些数据要整理一下，                 1. 汇总本周各项目进展与关键结果；
+老板喜欢看图表，别太长                            2. 整理下周计划，标注优先级。
+                                              - 输出包含进度图表，正文控制在 500 字内；
+                                              - 只使用草稿中提到的事实，不补充假设。
 ```
 
-Requires dsh 0.2.1+. 刷新页面后生效 / takes effect after a page refresh.
+工程上为「点一下就完事」做了完整闭环：
+
+- **一键撤销**：改写完成后 ✨ 变 ↩，一键恢复原文；手动编辑过结果后撤销自动退场，绝不吞你的修改
+- **跨模型自适应**：自动选用当前默认模型自己声明的**最轻思考档**（改写不需要推理，速度从十几秒降到 2–5 秒；模型未声明档位则自动跳过）
+- **自愈与防护**：思考耗尽生成预算时自动加倍重试；请求 90 秒硬超时，优化中按 Esc 立即中止；草稿含引用/命令 chip 时自动禁用；无意义输入（过短、纯符号、复读）直接拦截
+- **透明失败**：出错时明确提示原因（超时/模型拒绝/无可用模型），输入框永不锁死
 
-## 行为 / Behavior
+## 列表编排（第二能力）
 
-遵循 DSH 原生按键约定（Enter 发送、⌘Enter 加速发送均不改动）：
+结构化提示词里全是列表——所以输入框本身也需要顺手的列表编辑。遵循 DSH 原生按键（Enter 发送、⌘Enter 加速发送不改动）：
 
 | 手势 | 行为 |
 |---|---|
-| **Shift+Enter** | 列表行内换行并自动续号（沿用当前行样式：`1.`→`2.`、`a.`→`b.`、`①`→`②`）；空列表项上按 = 退出列表并入上一行行尾（不留空行） |
-| **Backspace** | 光标紧跟标记后：二级及更深 → 升一级（如 `b. `→`2. `，光标停在新标记右侧）；一级 → 整个标记一步删掉；空列表项 → 删整行并入上一行行尾 |
-| **← / →** | 标记前缀（缩进+编号/符号+空格）作为一步跨过：标记右侧按 ← 一次到行首，行首按 → 一次到标记右侧 |
-| **⌘← / Home** | 跳到行首；列表行落在标记右侧，再按一次到最左 |
-| **Tab / Shift+Tab** | 仅列表行：降 / 升一级，所在块按新层级重排样式与编号；多行选中批量 |
-| **⌘⇧8 / ⌘⇧7** | 当前行或选中行：加无序 / 有序标记；再按取消，可反复循环 |
-| **⌘⇧B** | 选中文本加 `**粗体**`（⌘B 被 DSH 菜单占用，无法到达页面） |
-| 输入/删除/粘贴 | 有序编号自动重排（多行块内顺序归一；手改编号不会被覆盖） |
+| **Shift+Enter** | 列表行内换行并自动续号（沿用当前行样式）；空项上按 = 退出列表 |
+| **Backspace** | 光标紧跟标记后：二级及更深 → 升一级（`b. `→`2. `，光标停在当前行）；一级 → 整个标记一步删掉；空项 → 退出 |
+| **← / →** | 标记前缀作为一步跨过（标记右侧 ← 一次到行首，行首 → 一次到标记右侧） |
+| **⌘← / Home** | 跳到行首；列表行落在标记右侧，再按到最左 |
+| **Tab / Shift+Tab** | 降 / 升一级，所在块按新层级重排样式与编号；层级改变时光标保持原字符位置 |
+| **⌘⇧8 / ⌘⇧7** | 当前行或选中行：加无序 / 有序标记；再按取消 |
+| **⌘⇧B** | 选中文本加 `**粗体**`（⌘B 被 DSH 菜单占用） |
+| 输入/删除/粘贴 | 有序编号自动重排；手改编号不会被覆盖 |
 
-## 层级样式（默认，⚙ 中可自定义）
+默认六级样式：有序 `1.` → `a.` → `①` → `(1)` → `α.` → `1.`，无序 `- * + • ○ ▪`；每层可在 ⚙ 设置中自定义，缩进宽度 2/4/8 可选。手写 `a.` `α.` `(3)` `①` 同样被识别并参与重排。
 
-| 层级 | 有序 | 无序 |
-|---|---|---|
-| 一级 | `1. 2. 3.` | `-` |
-| 二级 | `a. b. c.` | `*` |
-| 三级 | `① ② ③` | `+` |
-| 四级 | `(1) (2) (3)` | `•` |
-| 五级 | `α. β. γ.` | `○` |
-| 六级 | `1. 2. 3.` | `▪` |
-
-每层有序样式可选 `1.` / `a.` / `α.` / `(1)` / `①`，无序符号可选 `- * + • ○ ▪ –`，缩进宽度 2/4/8，另有自动重排与优化按钮开关。手写 `a.` `α.` `(3)` `①` 同样被识别并参与重排。设置存于浏览器 localStorage，即时生效。
-
-## AI 提示词优化（✨ 按钮）
+## 安装 / Install
 
-点击将当前草稿交由 Host 侧当前默认模型改写为「任务目标 + 有序步骤 + 无序约束」的结构化列表，完成后可一键 ↩ 撤销恢复原文；手动编辑过优化结果后撤销自动退场。请求 90 秒超时、优化中可按 Esc 中止，生成失败有明确提示。
+```sh
+dsh plugin add dsh-composer-lists
+```
 
-## 实现说明
+Requires dsh 0.2.1+. 已收录于 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 市场目录 / listed in the plugin catalog. 刷新页面生效。
 
-- 浏览器半挂载于 `conversation.input.left` 槽位，所有编辑经会话 `inputActions.insertText / setDraft`（一次手势 = 一步撤销）
-- 含引用 chip / 命令 chip / 引用块时键盘编排自动停用；触发菜单（`/`、`@`）打开时不拦截按键；IME 组词期间不处理
-- Host 半注册 `POST /composer-lists/optimize` 路由：跨域精确校验、请求体 256KB 上限、思考档自动取模型最轻档、断连与卡流超时保护
+AI 改写使用你当前配置的默认模型，经 Host 本地路由（`POST /composer-lists/optimize`）完成，不引入额外密钥或第三方服务。
 
 ## 开发 / Development
 
 ```sh
-node test-pure.cjs   # 纯函数回归 + 确定性混沌测试（7000+ 断言）
+node test-pure.cjs   # 8000+ 断言：纯函数回归 + 确定性混沌测试
 node test-host.cjs   # Host 路由集成测试（假 req/res 驱动）
-node bench-pure.cjs  # 性能基准
+node bench-pure.cjs  # 性能基准（每按键路径 <1ms）
 ```
 
-改 `client.js` 后用插件管理停用→启用一次即同步页面；改 `index.js`（Host 半）需重启 dsh。
+改 `client.js` 后停用→启用插件即同步页面；改 `index.js`（Host 半）需重启 dsh。
 
 ## License
 

package/client.js

@@ -12,6 +12,10 @@
  *   Tab / Shift+Tab  → on list lines only: indent / outdent one level
  *   Cmd/Ctrl+Shift+8 → toggle unordered list on the caret line / selection
  *   Cmd/Ctrl+Shift+7 → toggle ordered list on the caret line / selection
+ *                      (a collapsed caret keeps its content offset; the
+ *                      renumbering the toggle implies on the surrounding
+ *                      block folds into the same edit, so the auto-renumber
+ *                      reaction never moves the caret afterwards)
  *
  * Ordered numbers are renumbered automatically after deletions or pastes.
  * Keyboard-only by design: the runtime renders no UI (a null component
@@ -313,12 +317,25 @@ window.__ModuleLoader__.load({
     /**
      * Toggle a list kind over the line range [a, b]: every line already of
      * that kind turns it off; otherwise lines convert, using each level's
-     * configured style. Pressing repeatedly cycles on/off. The replacement
-     * covers only marker prefixes so the caret lands right after the marker.
+     * configured style. Pressing repeatedly cycles on/off.
+     *
+     * The conversion is then converged to the auto-renumber state (numbers
+     * continue across the surrounding block, later siblings shift) inside
+     * THIS edit: the renumber reaction's own insertText would park the
+     * caret at ITS replacement end, dragging it away from the caret line.
+     * With a collapsed `caret` the plan ends exactly at the caret's content
+     * offset, so insertText parks it on the same content character (the
+     * Tab/Shift+Tab treatment); marker rewrites the convergence needs
+     * strictly AFTER the caret line are split into `pre`, which the caller
+     * applies first so the caret edit goes last. Rewrites BEFORE the caret
+     * line fold into the plan itself — its span may start earlier, the
+     * caret target is unaffected.
      * @param {'bullet'|'ordered'} kind
-     * @returns {null|{start:number,end:number,text:string}}
+     * @param {number} [caret] collapsed caret offset in `text` coordinates
+     * @returns {{pre:{start:number,end:number,text:string}|null,
+     *   plan:{start:number,end:number,text:string}}}
      */
-    function togglePlan (text, a, b, kind, settings) {
+    function togglePlan (text, a, b, kind, settings, caret) {
       const unit = settings.indentUnit
       const lines = text.split('\n')
       const last = Math.min(b, lines.length - 1)
@@ -351,7 +368,43 @@ window.__ModuleLoader__.load({
           out[k] = withMarker(lines[k], renderOrderedCore(settings.orderedStyles[level], counters.get(lead)))
         }
       }
-      return markerScopePlan(text, a, last, out)
+      // Converge to what the auto-renumber reaction would settle on; doing
+      // it here keeps the reaction idle after the edit.
+      const norm = renumberLines(out, 0, out.length - 1, settings, false).out
+      let from = a
+      for (let k = 0; k < a; k += 1) {
+        if (norm[k] !== lines[k]) { from = k; break }
+      }
+      let firstTrail = -1
+      let lastTrail = -1
+      for (let k = last + 1; k < lines.length; k += 1) {
+        if (norm[k] !== lines[k]) {
+          if (firstTrail < 0) firstTrail = k
+          lastTrail = k
+        }
+      }
+      if (caret === undefined) {
+        // Selection: one marker-scope replacement reaching back/forward to
+        // every line the convergence touched; the caret parks after the
+        // final marker as before.
+        return { pre: null, plan: markerScopePlan(text, from, Math.max(last, lastTrail), norm) }
+      }
+      const lastStart = lineRange(text, last, last).start
+      const lastEnd = lineRange(text, last, last).end
+      // The handler always passes a caret on line `last`; clamp anyway so
+      // an off-line caret can never pull the '\n' past the line end into
+      // the replacement (which would overlap `pre`).
+      const caretOnLine = Math.min(Math.max(caret, lastStart), lastEnd)
+      const oldEnd = lastStart + markerEndOf(lines[last])
+      const contentOffset = Math.max(0, caretOnLine - oldEnd)
+      const newEnd = markerEndOf(norm[last])
+      const pieces = []
+      for (let k = from; k < last; k++) pieces.push(norm[k])
+      pieces.push(norm[last].slice(0, Math.min(norm[last].length, newEnd + contentOffset)))
+      return {
+        pre: firstTrail >= 0 ? markerScopePlan(text, firstTrail, lastTrail, norm) : null,
+        plan: { start: lineRange(text, from, from).start, end: Math.max(caretOnLine, oldEnd), text: pieces.join('\n') },
+      }
     }
 
     /**
@@ -946,7 +999,19 @@ window.__ModuleLoader__.load({
             const sel = selectionLines(editable)
             if (sel === null) return
             const kind = e.code === 'Digit7' || e.code === 'Numpad7' ? 'ordered' : 'bullet'
-            if (!applyPlan(togglePlan(sel.text, sel.a, sel.b, kind, settingsRef.current), editable)) return
+            // Collapsed caret: the plan ends at the caret's content offset,
+            // so the toggle parks it on the same content character.
+            const caret = sel.collapsed ? Math.max(sel.span.start, sel.span.end) : undefined
+            const { pre, plan } = togglePlan(sel.text, sel.a, sel.b, kind, settingsRef.current, caret)
+            // Renumbering past the caret line goes FIRST — the caret edit
+            // must be the last insertText, which is where the caret parks.
+            const preApplied = pre !== null && applyPlan(pre, editable)
+            if (!applyPlan(plan, editable)) {
+              if (!preApplied) return // edit refused: keep the native key
+              e.preventDefault()
+              e.stopPropagation()
+              return
+            }
             e.preventDefault()
             e.stopPropagation()
             return
@@ -1371,7 +1436,7 @@ window.__ModuleLoader__.load({
 }
 .clp-popover {
   position: fixed; z-index: 2147483000; width: 340px; height: min(432px, calc(100vh - 24px));
-  overflow: auto; padding: 10px 12px 10px; box-sizing: border-box;
+  overflow: hidden; padding: 10px 12px 10px; box-sizing: border-box;
   background: var(--dsw-alias-bg-overlay); color: var(--dsw-alias-label-primary);
   border: 1px solid var(--dsw-alias-border-l1); border-radius: 10px;
   box-shadow: 0 8px 28px rgba(0,0,0,.22);
@@ -1393,7 +1458,12 @@ window.__ModuleLoader__.load({
 }
 .clp-tab + .clp-tab { border-left: 1px solid var(--dsw-alias-border-l1); }
 .clp-tab-on { background: var(--dsw-alias-brand-primary); color: #fff; font-weight: 600; }
-.clp-tab-body { display: flex; flex-direction: column; gap: 8px; }
+/* The popover shell never scrolls; the title and the tab bar stay pinned
+   and only this body scrolls (min-height:0 lets the flex child shrink). */
+.clp-tab-body {
+  display: flex; flex-direction: column; gap: 8px;
+  overflow-y: auto; min-height: 0; overscroll-behavior: contain;
+}
 .clp-keys-head { display: flex; align-items: baseline; gap: 8px; padding-top: 2px; }
 .clp-keys-title { font-size: 13px; font-weight: 600; color: var(--dsw-alias-label-primary); }
 .clp-keys-scope { color: var(--dsw-alias-label-secondary); font-size: 11px; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-composer-lists",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Ordered and unordered list editing in the DeepSeek Harness message composer: auto numbering and renumbering, marker-aware caret moves, level promotion, and an AI prompt-polish button.",
   "author": "wangjianghu",