dsh-multiline-input 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0 — 2026-10-28
+
+首个版本。
+
+- 对话输入框单行 / 多行双态切换，模式按设备持久化。
+- 通过 DSH 官方快捷键服务注册 `multiline-input.toggle`：桌面默认 `Cmd+E`（macOS）/ `Ctrl+E`（Windows / Linux），可在「设置 → 通用 → 快捷键」改绑、恢复默认、查看冲突。
+- 卡片顶部常驻提示条（与卡片同底色、底部淡分割线）：实时显示当前生效键位与目标模式；点击可切换。
+- 多行模式最小高度 4 行，内容变多自动长高（沿用 DSH 的 336px 滚动上限）。
+- 多行模式 Enter 换行、Shift+Enter 发送；`Cmd/Ctrl+Enter`、斜杠 / 引用菜单、输入法组合态保持原有语义。
+- 卸载 / 禁用后恢复原生输入框，无 DOM、样式、监听残留。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZilongYang
+
+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,128 @@
-# Temporary Holding Version
+# dsh-multiline-input
 
-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.
+把 DeepSeek Harness 的对话输入框在**单行 / 多行**之间切换的 Web 客户端插件。
+
+- 默认快捷键 **Cmd+E（macOS）/ Ctrl+E（Windows / Linux）**；输入框上沿有一个与输入框同底色的小 **tab** 显示当前快捷键与目标模式，点击即可切换。
+- 多行模式输入框默认 **4 行高**（3–5 行区间内），内容变多自动长高，到原生 336px 上限后滚动。
+- 多行模式 **Enter 换行、Shift+Enter 发送**；单行模式保持 DSH 原生行为（Enter 发送、Shift+Enter 换行）。
+- 快捷键可在 **设置 → 通用 → 快捷键**里改成任意组合（冲突校验、恢复默认都由 DSH 官方界面负责）。
+- 模式按设备记住，刷新 / 重启后保持。
+
+![单行模式：输入框上沿的 tab](assets/screenshot-1-single-line.png)
+
+![多行模式：输入框变高，tab 显示 Shift+Enter 提交 · Cmd+E 单行输入](assets/screenshot-2-multiline.png)
+
+## 安装
+
+```sh
+# 市场 / CLI 管理的 profile
+dsh plugin --profile <profile> add dsh-multiline-input
+
+# 或在应用内「插件」页搜索 / 用绝对路径安装后启用
+```
+
+桌面版使用的 `desktop` profile 由应用独占（`dsh plugin --profile desktop` 会被拒绝），请在应用「插件」页安装或手动 link：
+
+```sh
+cd ~/.dsh/profiles/desktop
+pnpm add link:/absolute/path/to/dsh-multiline-input
+# 再把 "dsh-multiline-input" 追加到 package.json 的 dsh.profile.bundles
+```
+
+启用后刷新页面即可；插件清单变化不需要重启应用。
+
+**卸载**：插件页关闭 / 卸载，或 `dsh plugin --profile <profile> remove dsh-multiline-input`。
+
+## 使用
+
+| 操作 | 单行模式 | 多行模式 |
+|---|---|---|
+| `Enter` | 发送 | 换行 |
+| `Shift+Enter` | 换行 | 发送 |
+| `Cmd/Ctrl+Enter` | 加速提交（不变） | 加速提交（不变） |
+| `/`、`@` 菜单打开时的 `Enter` | 选中菜单项 | 选中菜单项 |
+| 输入法候选态的 `Enter` | 交给输入法 | 交给输入法 |
+
+- 按 `Cmd+E` / `Ctrl+E`（或点击 tab）在两种模式间循环；切换不清空草稿、不抢焦点。
+- tab **常驻显示**，输入文字时也不隐藏；多行时显示 `Shift+Enter 提交 · Cmd+E 单行输入`，单行时显示 `Cmd+E 多行输入`。
+
+## 修改快捷键
+
+1. 打开 **设置 → 通用 → 快捷键**；
+2. 搜索「多行输入」（命令名：**切换多行输入**，id `multiline-input.toggle`）；
+3. 点击右侧键位进入录制，按下新组合即可；冲突时官方界面会提示，可随时恢复默认。
+
+tab 实时跟随当前生效的组合；把绑定清空后只显示「多行输入 / 单行输入」，点击仍可切换。
+
+## 与相近插件的区别
+
+| 插件 | 它做什么 | 本插件 |
+|---|---|---|
+| `dsh-composer-expand` | 工具行按钮把输入框撑到 70vh | 双模式 + 快捷键 + Enter/Shift+Enter 互换 + 常驻 tab |
+| `dsh-fullscreen-input` | 另开全屏面板写多行，Enter 换行、Ctrl+Enter 发送 | 内联在原生输入框，多行时 Shift+Enter 发送（带输入法保护） |
+| `dsh-ctrl-enter-submit` | 全局把 Enter 改成换行、Ctrl/Cmd+Enter 发送 | 单行保持原生 Enter 发送，多行才交换 |
+| `dsh-composer-ux` | 可配置发送/换行键位 + 右键菜单 + 快捷指令面板 | 只专注输入模式与高度 |
+| `dsh-keyboard-manager` | Ctrl+Q / **Ctrl+E** / Ctrl+S 切栏、开设置 | Windows/Linux 上它的 Ctrl+E 与本插件默认冲突；可在设置里改键（macOS 本插件用 Cmd+E，不冲突） |
+
+## 实现说明
+
+插件遵守 DSH 的第三方客户端插件契约（`dsh.client` + `dsh.bundle.patch`），Host 半只保留一个可安装 / 启停的 bundle row，功能全部在 `client.js`：
+
+- **模式状态**：模块级 store + `localStorage['dsh-multiline-input.mode.v1']`，投影为 `<html data-dsh-ml-input="multi">`；
+- **高度**：一条 CSS 规则给 `[data-composer-card] [data-composer-input][contenteditable="true"]` 设 `min-height: calc(4 * 1lh + 8px)`，不碰 DSH 的滚动上限；
+- **tab 提示**：注册到 `conversation.input.overlay` 座位，绝对定位到卡片上沿右侧（`bottom: 100%`，同底色 + 底部 0.5px 细线），宽度随文字；
+- **Enter / Shift+Enter**：在 document 捕获阶段拦下多行模式下的 `Enter`，向编辑器重放一个翻转了 `shiftKey` 的合成按键——仍由 DSH 自己的 composer keymap 决定「换行」还是「提交」，撤销历史、输入法保护、busy-enter（queue/steer）、菜单仲裁全部保持原逻辑；
+- **快捷键**：通过 `ctx.shortcuts.register()` 注册命令，编辑与持久化完全交给 DSH。
+
+源码依据（DSH `0.2.1-rc.3`，commit `22ddee3`）：
+
+| 契约 | 源码文件 |
+|---|---|
+| 输入卡片 / 覆盖层锚点 | `packages/client/ui-conversation/src/client/skeleton/InputBar.tsx` |
+| 可编辑面 / 占位符 | `packages/client/ui-conversation/src/client/input/editor/DraftEditor.tsx`、`ComposerContentEditable.tsx` |
+| Enter 语义 | `packages/client/ui-conversation/src/client/input/editor/keymap.ts` |
+| 公开输入动作面 | `packages/client/ui-conversation/src/client/contract/input.ts` |
+| 座位与标准 props | `packages/client/ui-conversation/src/client/contract/slots.ts` |
+| 快捷键命令契约 | `packages/client/shortcuts/src/client/types.ts`、`binding.ts` |
+| 客户端清单 | `packages/util/package-manifest/src/types.ts`、`packages/client/modules/README.zh.md` |
+
+## 兼容性
+
+- 在 DSH **0.2.1-rc.3**（桌面版 / Web）验证；`dsh.compatibility.dsh` = `>=0.2.1-rc.3 <0.3.0-0`。
+- 依赖 composer 的 `data-*` 锚点与 `role="listbox"`，属 DSH 内部实现；升级 DSH 后需要回归（锚点缺失时插件只 warn，不会崩）。
+- Web + Linux 没有默认快捷键（DSH 对 Web 可选组合有白名单限制），需在设置里自行指定。
+
+## 开发
+
+```
+dsh-multiline-input/
+├── package.json            # dsh.bundle.patch + dsh.client(platform: web)
+├── cordis.patch.yml        # 1 个 Host row
+├── index.js                # Host 半（空实现，仅为 bundle 契约）
+├── client.js               # Client 半（手写，无构建、无第三方依赖）
+├── icon.svg / assets/      # 插件图标与市场截图
+├── locale/{zh,en}.json     # 插件展示元数据
+├── test/                   # node --test
+└── docs/                   # 计划、发版清单
+```
+
+- 测试：`npm test`（`node --test`，当前 12 条用例）。
+- 语法：`node --check client.js && node --check index.js`。
+- 调试：HMR 默认忽略 `**/node_modules`，链接安装的 `client.js` 改动不会被热加载；改完客户端代码后在插件页关/开一次（或重启应用），再刷新页面。
+
+## 已知限制
+
+- 仅作用于 Web GUI（桌面版与浏览器），TUI / CLI 不适用。
+- 多行起始高度是代码常量 4 行，暂不提供配置项。
+- 若默认键位与其它插件的命令默认值冲突，插件会降级为「点击 tab 切换」并在控制台输出一次警告。
+
+## 文档
+
+- [实施计划（2026-10-27）](docs/PLAN-2026-10-27.md)
+- [发版检查清单 0.1.0](docs/RELEASE-CHECKLIST-0.1.0.md)
+- [路线图](ROADMAP.md)
+- [变更记录](CHANGELOG.md)
+
+## License
+
+MIT

package/ROADMAP.md

@@ -0,0 +1,23 @@
+# ROADMAP
+
+## 0.1.0（当前）
+
+- [x] 单行 / 多行双态切换，模式按设备持久化（`localStorage`）
+- [x] 官方快捷键命令（`multiline-input.toggle`，桌面默认 Ctrl+E，可在设置中改绑）
+- [x] 右上角提示（仅空输入时显示，实时显示当前生效键位）
+- [x] 多行模式 4 行起高，随内容长高，沿用 DSH 336px 滚动上限
+- [x] 多行模式 Enter 换行 / Shift+Enter 发送，保留撤销、输入法、菜单、busy-enter 语义
+- [x] 与 composer 其它输入框、设置弹窗、斜杠菜单互不干扰
+- [x] 单元测试（`node --test`）与静态检查
+
+## 0.2.0 候选
+
+- [ ] 起始行数可配置（3–5 行），通过 Host `Config` + 插件详情页
+- [ ] 按会话记忆模式（当前为全局 / 按设备）
+- [ ] 若 DSH 提供公开的 composer 输入扩展点，替换现有的 DOM 事件接管
+- [ ] DSH 下一个版本线的兼容回归（DOM 锚点 / `Shortcuts` 契约）
+
+## 文档
+
+- 计划：[docs/PLAN-2026-10-27.md](docs/PLAN-2026-10-27.md)
+- 发版清单：[docs/RELEASE-CHECKLIST-0.1.0.md](docs/RELEASE-CHECKLIST-0.1.0.md)

package/client.js

@@ -0,0 +1,571 @@
+/**
+ * Client half of dsh-multiline-input.
+ *
+ * Single/multi-line composer toggle for the DSH Web GUI:
+ *
+ *   - a shortcut command (default Ctrl+E) registered through `ctx.shortcuts`,
+ *     so the binding appears in Settings → General → Keyboard shortcuts and
+ *     every edit there is validated and persisted by DSH itself;
+ *   - a top-right hint inside the composer card (`conversation.input.overlay`),
+ *     shown only while the draft is empty;
+ *   - a taller composer floor in multi-line mode, driven by
+ *     `<html data-dsh-multiline-input="multi">` and one CSS rule;
+ *   - Enter / Shift+Enter swapped in multi-line mode by re-dispatching the
+ *     same keydown with the opposite `shiftKey`. DSH's own composer keymap
+ *     keeps deciding newline vs submit, so undo history, the IME guard,
+ *     busy-enter (queue / steer) and menu arbitration all stay intact.
+ *
+ * Hand-written bundle: the module loader materializes `factory(require)` and
+ * takes its return value as the module exports. React comes from the browser
+ * module table; no Harness Client package is imported.
+ *
+ * Reference contracts (source checkout, 0.2.1-rc.3):
+ *   - packages/client/ui-conversation/src/client/skeleton/InputBar.tsx
+ *   - packages/client/ui-conversation/src/client/input/editor/DraftEditor.tsx
+ *   - packages/client/ui-conversation/src/client/input/editor/keymap.ts
+ *   - packages/client/ui-conversation/src/client/contract/input.ts
+ *   - packages/client/ui-conversation/src/client/contract/slots.ts
+ *   - packages/client/shortcuts/src/client/types.ts
+ *   - packages/client/modules/README.zh.md
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-multiline-input',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+
+    /** Locale namespace and the style element id (a reload must not stack styles). */
+    const NS = 'dsh-multiline-input'
+    const STYLE_ID = 'dsh-multiline-input-style'
+
+    /** Device-local mode preference; the mode itself is not Session data. */
+    const MODE_STORAGE_KEY = 'dsh-multiline-input.mode.v1'
+    /** `<html>` marker read by the height rule. */
+    const MODE_ATTRIBUTE = 'data-dsh-multiline-input'
+
+    /** Shortcut command id; dotted form so DSH can persist user overrides. */
+    const COMMAND_ID = 'multiline-input.toggle'
+    /** Composer seats: after the slash menu (order 0), above the card content. */
+    const HINT_ORDER = 10
+    /** Multi-line floor in text lines (the requested 3–5 range). */
+    const MIN_LINES = 4
+
+    const MODE_SINGLE = 'single'
+    const MODE_MULTI = 'multi'
+
+    /**
+     * Default bindings. Desktop may bind any combination (the native keyboard
+     * bridge outranks editors). Web only accepts the documented allowlist, so
+     * it uses Primary+Shift+E; Linux Web has no allowed letter chord and stays
+     * unbound until the user picks one in Settings.
+     */
+    const DEFAULTS = {
+      'desktop:macos': { code: 'KeyE', modifiers: ['primary'] },
+      'desktop:windows': { code: 'KeyE', modifiers: ['primary'] },
+      'desktop:linux': { code: 'KeyE', modifiers: ['primary'] },
+      'web:macos': { code: 'KeyE', modifiers: ['primary', 'shift'] },
+      'web:windows': { code: 'KeyE', modifiers: ['primary', 'shift'] },
+    }
+
+    const DICT = {
+      zh: {
+        toMulti: '多行输入',
+        toSingle: '单行输入',
+        submitHint: 'Shift+Enter 提交',
+        toggleLabel: '切换多行输入',
+        hintTitle: '点击切换输入模式；快捷键可在「设置 → 通用 → 快捷键」中修改',
+        ariaLabel: '{action}（{keys}）',
+      },
+      en: {
+        toMulti: 'Multiline input',
+        toSingle: 'Single-line input',
+        submitHint: 'Shift+Enter to send',
+        toggleLabel: 'Toggle multiline input',
+        hintTitle: 'Click to switch the input mode. Edit the shortcut in Settings → General → Keyboard shortcuts.',
+        ariaLabel: '{action} ({keys})',
+      },
+    }
+
+    const CSS = `
+/* A small tab riding on the card's top shoulder: same fill as the card, so it
+   reads as one piece, with the card's own hairline continuing under it. */
+.dmi-hint {
+  position: absolute;
+  right: calc(var(--dsw-radius-panel) + 4px);
+  bottom: 100%;
+  z-index: 2;
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  box-sizing: border-box;
+  /* Hug the text: the tab and its hairline only span the hint. */
+  width: max-content;
+  max-width: 100%;
+  height: 24px;
+  padding: 0 12px;
+  background: var(--dsw-specific-input-major);
+  border-bottom: 0.5px solid var(--dsw-alias-border-l2);
+  border-radius: var(--dsw-radius-md) var(--dsw-radius-md) 0 0;
+  pointer-events: none;
+  white-space: nowrap;
+}
+.dmi-hint-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin: 0;
+  padding: 1px 6px;
+  border: 0;
+  border-radius: var(--dsw-radius-sm, 6px);
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+  font: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  cursor: pointer;
+  pointer-events: auto;
+}
+.dmi-hint-button:hover {
+  background: var(--dsw-alias-interactive-bg-hover);
+  color: var(--dsw-alias-label-secondary);
+}
+.dmi-hint-key {
+  color: var(--dsw-alias-label-secondary);
+  font-weight: 500;
+}
+.dmi-hint-sep {
+  color: var(--dsw-alias-label-caption);
+  opacity: 0.6;
+}
+html[${MODE_ATTRIBUTE}="multi"] [data-composer-card] [data-composer-input][contenteditable="true"] {
+  min-height: calc(${MIN_LINES} * 1lh + 8px);
+}
+@supports not (height: 1lh) {
+  html[${MODE_ATTRIBUTE}="multi"] [data-composer-card] [data-composer-input][contenteditable="true"] {
+    min-height: ${MIN_LINES * 24 + 8}px;
+  }
+}
+@media (max-width: 720px) {
+  .dmi-hint-sep,
+  .dmi-hint-meta {
+    display: none;
+  }
+}
+`
+
+    //#region Pure helpers (also exported for node --test)
+
+    /**
+     * Coerce any stored value into a known mode.
+     * @param value - raw preference value.
+     * @returns the normalized mode.
+     */
+    function normalizeMode(value) {
+      return value === MODE_MULTI ? MODE_MULTI : MODE_SINGLE
+    }
+
+    /**
+     * Cycle between the two modes.
+     * @param mode - current mode.
+     * @returns the other mode.
+     */
+    function nextMode(mode) {
+      return normalizeMode(mode) === MODE_MULTI ? MODE_SINGLE : MODE_MULTI
+    }
+
+    /**
+     * Read the persisted mode, treating unavailable storage as single-line.
+     * @param store - `localStorage`-like object, or undefined.
+     * @returns the stored mode or the default.
+     */
+    function readMode(store) {
+      try {
+        return normalizeMode(store?.getItem(MODE_STORAGE_KEY))
+      } catch {
+        return MODE_SINGLE
+      }
+    }
+
+    /**
+     * Persist one mode; a blocked storage backend only costs the preference.
+     * @param store - `localStorage`-like object, or undefined.
+     * @param mode - mode to persist.
+     */
+    function writeMode(store, mode) {
+      try {
+        store?.setItem(MODE_STORAGE_KEY, normalizeMode(mode))
+      } catch {
+        /* Preference persistence is best-effort. */
+      }
+    }
+
+    /**
+     * Project the mode onto the document root consumed by the height rule.
+     * @param element - document root, or null in non-DOM tests.
+     * @param mode - mode to apply.
+     */
+    function applyModeAttribute(element, mode) {
+      if (element === null || element === undefined) return
+      if (typeof element.setAttribute !== 'function' || typeof element.removeAttribute !== 'function') return
+      if (normalizeMode(mode) === MODE_MULTI) element.setAttribute(MODE_ATTRIBUTE, MODE_MULTI)
+      else element.removeAttribute(MODE_ATTRIBUTE)
+    }
+
+    const MODIFIER_LABELS = { control: 'Ctrl', meta: 'Cmd', alt: 'Alt', shift: 'Shift' }
+
+    /**
+     * Human label for one physical key code (`KeyE` → `E`, `Digit1` → `1`).
+     * @param code - KeyboardEvent.code value.
+     * @returns the key label, or an empty string.
+     */
+    function keyLabel(code) {
+      if (typeof code !== 'string' || code === '') return ''
+      return code.replace(/^Key/u, '').replace(/^Digit/u, '')
+    }
+
+    /**
+     * Render a binding as `Ctrl+E` style text.
+     * @param binding - `{ code, modifiers }` or null.
+     * @param platform - `macos`, `windows`, or `linux`.
+     * @returns the label, or null when there is no binding.
+     */
+    function formatShortcut(binding, platform) {
+      if (binding === null || binding === undefined || typeof binding.code !== 'string') return null
+      const modifiers = Array.isArray(binding.modifiers) ? binding.modifiers : []
+      const labels = modifiers.map((modifier) => {
+        if (modifier === 'primary') return platform === 'macos' ? 'Cmd' : 'Ctrl'
+        return MODIFIER_LABELS[modifier] ?? modifier
+      })
+      const key = keyLabel(binding.code)
+      if (key === '') return null
+      return [...labels, key].join('+')
+    }
+
+    /**
+     * Find this command in the DSH shortcut catalog and render its binding.
+     * @param rows - `ctx.shortcuts.catalog` snapshot.
+     * @param platform - `ctx.shortcuts.platform`.
+     * @returns the label, or null when unbound / not registered yet.
+     */
+    function labelFromCatalog(rows, platform) {
+      if (!Array.isArray(rows)) return null
+      const row = rows.find((entry) => entry !== null && entry !== undefined && entry.id === COMMAND_ID)
+      if (row === undefined) return null
+      return formatShortcut(row.binding, platform)
+    }
+
+    /**
+     * Decide whether the multi-line keymap should take over one keydown.
+     * @param input - flattened event and composer facts.
+     * @returns `newline` (Enter), `submit` (Shift+Enter), or null to pass.
+     */
+    function shouldIntercept(input) {
+      const {
+        mode, key, shiftKey, ctrlKey, metaKey, altKey,
+        isComposing, keyCode, inComposer, editable, phase, menuOpen,
+      } = input
+      if (normalizeMode(mode) !== MODE_MULTI) return null
+      if (key !== 'Enter') return null
+      if (ctrlKey === true || metaKey === true || altKey === true) return null
+      if (isComposing === true || keyCode === 229) return null
+      if (inComposer !== true || editable !== true) return null
+      if (phase !== 'plain') return null
+      if (menuOpen === true) return null
+      return shiftKey === true ? 'submit' : 'newline'
+    }
+
+    //#endregion
+
+    //#region Stores and DOM helpers
+
+    /**
+     * Minimal snapshot store: one value, stable identity until it moves.
+     * @param initial - first snapshot.
+     * @returns a store consumable by `useSyncExternalStore`.
+     */
+    function createValueStore(initial) {
+      let value = initial
+      const listeners = new Set()
+      return {
+        getSnapshot: () => value,
+        subscribe(listener) {
+          listeners.add(listener)
+          return () => {
+            listeners.delete(listener)
+          }
+        },
+        set(next) {
+          if (Object.is(next, value)) return
+          value = next
+          for (const listener of [...listeners]) listener()
+        },
+      }
+    }
+
+    const COMPOSER_CARD = '[data-composer-card]'
+    const COMPOSER_INPUT = '[data-composer-input]'
+    const COMPOSER_OVERLAY = '[data-composer-overlay]'
+    const TRIGGER_MENU = '[role="listbox"]'
+    const EDITABLE_SELECTOR = 'input, textarea, select, [contenteditable="true"], [contenteditable=""]'
+
+    /** @returns the device `localStorage`, or undefined when blocked. */
+    function localStore() {
+      try {
+        return window.localStorage
+      } catch {
+        return undefined
+      }
+    }
+
+    /** @returns whether the page runs inside the Desktop shell. */
+    function isDesktopShell() {
+      try {
+        return window.dshDesktop !== undefined
+      } catch {
+        return false
+      }
+    }
+
+    /** @returns `macos`, `windows`, or `linux`, from the visiting device. */
+    function osPlatform() {
+      try {
+        const platform = typeof navigator.userAgentData?.platform === 'string'
+          ? navigator.userAgentData.platform
+          : navigator.platform
+        if (/mac/i.test(platform)) return 'macos'
+        if (/win/i.test(platform)) return 'windows'
+        return 'linux'
+      } catch {
+        return 'linux'
+      }
+    }
+
+    /** @returns the label to show before the shortcut catalog is ready. */
+    function initialShortcutLabel() {
+      const platform = osPlatform()
+      const profile = `${isDesktopShell() ? 'desktop' : 'web'}:${platform}`
+      return formatShortcut(DEFAULTS[profile] ?? null, platform)
+    }
+
+    //#endregion
+
+    //#region Hint component
+
+    /**
+     * Composer hint on the right shoulder above the card: current shortcut plus
+     * the target mode, click to toggle. Always visible, so the binding stays
+     * discoverable while typing.
+     * @param props - injected stores, dictionary and toggle callback.
+     * @returns the hint element.
+     */
+    function MultiLineHint({ t, modeStore, shortcutStore, toggle }) {
+      const mode = React.useSyncExternalStore(modeStore.subscribe, modeStore.getSnapshot, modeStore.getSnapshot)
+      const shortcut = React.useSyncExternalStore(shortcutStore.subscribe, shortcutStore.getSnapshot, shortcutStore.getSnapshot)
+      const action = mode === MODE_MULTI ? t('toSingle') : t('toMulti')
+      const meta = mode === MODE_MULTI ? t('submitHint') : null
+      return h(
+        'div',
+        { className: 'dmi-hint' },
+        h(
+          'button',
+          {
+            type: 'button',
+            className: 'dmi-hint-button',
+            title: t('hintTitle'),
+            'aria-label': shortcut === null ? action : t('ariaLabel', { action, keys: shortcut }),
+            onMouseDown: (event) => {
+              event.preventDefault()
+            },
+            onClick: (event) => {
+              event.preventDefault()
+              event.stopPropagation()
+              toggle()
+            },
+          },
+          meta !== null && h('span', { className: 'dmi-hint-meta' }, meta),
+          meta !== null && h('span', { className: 'dmi-hint-sep', 'aria-hidden': true }, '·'),
+          shortcut !== null && h('span', { className: 'dmi-hint-key' }, shortcut),
+          h('span', { className: 'dmi-hint-label' }, action),
+        ),
+      )
+    }
+
+    //#endregion
+
+    /**
+     * Register the dictionaries, styles, stores, keyboard takeover, shortcut
+     * command and the composer hint.
+     * @param ctx - client plugin context.
+     */
+    function apply(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, DICT), 'ml-input: dictionaries')
+
+      ctx.effect(() => {
+        const element = document.createElement('style')
+        element.id = STYLE_ID
+        element.setAttribute('data-plugin', NS)
+        element.textContent = CSS
+        document.head.appendChild(element)
+        return () => {
+          element.remove()
+        }
+      }, 'ml-input: styles')
+
+      const t = ctx.locale.bind(NS)
+      const modeStore = createValueStore(readMode(localStore()))
+      const shortcutStore = createValueStore(initialShortcutLabel())
+
+      const setMode = (next) => {
+        const normalized = normalizeMode(next)
+        modeStore.set(normalized)
+        writeMode(localStore(), normalized)
+        applyModeAttribute(document.documentElement, normalized)
+      }
+      const toggle = () => {
+        setMode(nextMode(modeStore.getSnapshot()))
+      }
+
+      ctx.effect(() => {
+        applyModeAttribute(document.documentElement, modeStore.getSnapshot())
+        return () => {
+          applyModeAttribute(document.documentElement, MODE_SINGLE)
+        }
+      }, 'ml-input: mode attribute')
+
+      // Enter / Shift+Enter takeover. Capture on the document so the original
+      // keydown never reaches Lexical's root, then replay the opposite gesture
+      // on the editor; DSH's composer keymap owns both outcomes.
+      let replaying = false
+      ctx.effect(() => {
+        const onKeyDown = (event) => {
+          if (replaying || !(event instanceof KeyboardEvent)) return
+          const target = event.target instanceof Element
+            ? event.target
+            : (document.activeElement instanceof Element ? document.activeElement : null)
+          if (target === null) return
+          const editor = target.closest(COMPOSER_INPUT)
+          if (editor === null || !(editor instanceof HTMLElement)) return
+          if (editor.getAttribute('contenteditable') !== 'true') return
+          const card = editor.closest(COMPOSER_CARD)
+          if (card === null) return
+          const decision = shouldIntercept({
+            mode: modeStore.getSnapshot(),
+            key: event.key,
+            shiftKey: event.shiftKey,
+            ctrlKey: event.ctrlKey,
+            metaKey: event.metaKey,
+            altKey: event.altKey,
+            isComposing: event.isComposing,
+            keyCode: event.keyCode,
+            inComposer: true,
+            editable: true,
+            phase: editor.getAttribute('data-phase'),
+            menuOpen: card.querySelector(`${COMPOSER_OVERLAY} ${TRIGGER_MENU}`) !== null,
+          })
+          if (decision === null) return
+          event.preventDefault()
+          event.stopPropagation()
+          replaying = true
+          try {
+            editor.dispatchEvent(new KeyboardEvent('keydown', {
+              key: 'Enter',
+              code: 'Enter',
+              bubbles: true,
+              cancelable: true,
+              composed: true,
+              shiftKey: decision === 'newline',
+            }))
+          } finally {
+            replaying = false
+          }
+        }
+        document.addEventListener('keydown', onKeyDown, true)
+        return () => {
+          document.removeEventListener('keydown', onKeyDown, true)
+        }
+      }, 'ml-input: multiline enter')
+
+      // Shortcut command. The service may materialize after this plugin, so the
+      // registration waits for it; a conflicting default only costs the hotkey.
+      ctx.inject(['shortcuts'], (scope) => {
+        scope.effect(() => {
+          const refresh = () => {
+            shortcutStore.set(labelFromCatalog(scope.shortcuts.catalog.getSnapshot(), scope.shortcuts.platform))
+          }
+          const off = scope.shortcuts.catalog.subscribe(refresh)
+          refresh()
+          return () => {
+            off()
+          }
+        }, 'ml-input: shortcut label')
+
+        scope.effect(() => {
+          let dispose = () => {}
+          try {
+            dispose = scope.shortcuts.register({
+              id: COMMAND_ID,
+              label: () => t('toggleLabel'),
+              aliases: ['多行输入', '单行输入', 'multiline', 'multi-line', 'multiline-input', 'input mode'],
+              defaults: DEFAULTS,
+              regions: ['page', 'editable'],
+              modals: [],
+              resolve: (context) => {
+                if (context.modal !== null) return { status: 'pass' }
+                const target = context.target
+                if (target !== null
+                  && target.closest(COMPOSER_CARD) === null
+                  && target.closest(EDITABLE_SELECTOR) !== null) {
+                  return { status: 'pass' }
+                }
+                return {
+                  status: 'handled',
+                  run: () => {
+                    toggle()
+                  },
+                }
+              },
+            })
+          } catch (error) {
+            console.warn('[dsh-multiline-input] shortcut registration skipped:', error)
+          }
+          return () => {
+            dispose()
+          }
+        }, 'ml-input: shortcut command')
+      })
+
+      ctx.slots.inject('conversation.input.overlay', () => ctx.slots.register({
+        name: 'conversation.input.overlay',
+        id: 'ml-input-hint',
+        order: HINT_ORDER,
+        locale: NS,
+        inject: () => ({ t, modeStore, shortcutStore, toggle }),
+      }, MultiLineHint))
+    }
+
+    return {
+      inject: ['slots', 'locale'],
+      apply,
+      /**
+       * Pure internals for `node --test`; the module loader ignores this key.
+       */
+      __test: {
+        COMMAND_ID,
+        MODE_ATTRIBUTE,
+        MODE_STORAGE_KEY,
+        MODE_SINGLE,
+        MODE_MULTI,
+        MIN_LINES,
+        DEFAULTS,
+        normalizeMode,
+        nextMode,
+        readMode,
+        writeMode,
+        applyModeAttribute,
+        formatShortcut,
+        labelFromCatalog,
+        shouldIntercept,
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# Bundle layer of dsh-multiline-input: one Host row.
+#
+# The feature is browser-only; this row exists so the package is a real bundle
+# (the plugin manager refuses a package without a bundle patch) and so
+# client-modules discovers the package's `dsh.client` declaration and serves
+# `client.js` to the Web GUI.
+- insert:
+    - id: multiline-input
+      name: 'dsh-multiline-input'

package/docs/PLAN-2026-10-27.md

@@ -0,0 +1,215 @@
+# dsh-ml-input 0.1.0 实施计划（按 DSH 源码修订）
+
+> 本文件按获批时的内容原样存档，不再随实施更新；实施与计划的差异记录在文末「实施偏差（事后补记）」小节。
+
+## 0. 先回答两个问题
+
+**Q1：为什么之前把目标写成「DSH 0.2.1-rc.3 / 桌面版 / profile main / 52043」？**
+写窄了，已改。目标应是 **DSH 插件契约本身**：一个遵循 `dsh.client` + Slots + Shortcuts 契约的第三方客户端插件，兼容当前发布线（源码 master 即 `0.2.1-rc.3`）。版本号只用于声明兼容边界与回归范围；`profile main`、端口、桌面版 2.0.20-next 只是本机验收环境，不再进入目标定义。
+
+**Q2：为什么去拆 app.asar？**
+我的错误。运行上下文把 app.asar 标成了 checkout，我顺手用了它；既然本机有完整源码克隆 `/Users/zilong/zWork/frontend/deepseek-harness`（master，`22ddee3`，2026-10-23，与运行版构建同日；根版本 `0.2.1-rc.3`），就该直接读源码。该路径已记入长期记忆；本修订版的所有依据都改为源码路径，不再引用解包结果。
+
+## 1. 目标与验收标准
+
+**目标**：纯客户端第三方插件 `dsh-ml-input`，不改 DSH 源码，把对话输入框在「单行（现状）/ 多行」之间循环切换：
+
+1. 输入框右上角显示当前生效的切换快捷键（默认 `Ctrl+E`）+「多行输入」；输入框为空时显示，有草稿/附件时隐藏，避免压字。
+2. 按快捷键循环：单行 → 多行 → 单行。
+3. 多行模式默认高度 **4 行**（落在需求的 3–5 行区间），内容变多继续长高，到原生 336px 上限后滚动。
+4. 多行模式下 **Enter 换行、Shift+Enter 提交**；单行模式保持 DSH 现状（Enter 提交、Shift+Enter 换行）。
+5. 快捷键可在官方「设置 → 通用 → 快捷键」里改绑，提示实时跟随。
+
+**验收标准**：
+
+- 空输入右上角出现 `Ctrl+E 多行输入`；输入后消失，清空重现。
+- `Ctrl+E` 在编辑器内、页面空白处都能切换；设置/其它输入框里不抢键。
+- 多行最小高度 4 行；切回单行立即恢复；草稿不丢。
+- 多行：Enter 换行（可撤销）、Shift+Enter 发送；`Cmd/Ctrl+Enter` 仍是加速提交；`/`、`@` 菜单打开时 Enter 仍是选中菜单项；输入法候选态不误触。
+- 刷新后模式保持；设置里改键后提示立即变化、冲突有官方提示。
+- 禁用/卸载后无 `<html data-dsh-ml-input>`、无 `<style>`、无键盘监听、无快捷键命令残留。
+
+## 2. 源码依据（`/Users/zilong/zWork/frontend/deepseek-harness`，commit `22ddee3`）
+
+| 事实 | 源码位置 |
+|---|---|
+| 输入卡片 `<div data-composer-card>`（`position:relative`）与覆盖层锚点 `<div data-composer-overlay>`（`position:absolute; inset:0 0 auto; height:0`） | `packages/client/ui-conversation/src/client/skeleton/InputBar.tsx`（~423 行）、`InputBar.module.css`（`.overlayAnchor`） |
+| 可编辑面是 Lexical contenteditable：`data-composer-input`、`role="textbox"`、`aria-multiline="true"`，带 `data-phase`、`data-placeholder` | `.../input/editor/ComposerContentEditable.tsx`、`.../input/editor/DraftEditor.tsx` |
+| 占位符 `[data-composer-placeholder]` 只在 `draft === '' && 无附件 && 无命令 claim` 时渲染 | `.../input/editor/DraftEditor.tsx` + `InputBar.tsx` 的 `showPlaceholder` |
+| 高度：`.input { min-height:36px }`、hero 52px；滚动上限 `--dsh-composer-text-max-height:336px`（约 14 行） | `InputBar.module.css`、`ConversationRoot.module.css`（~411 行） |
+| Enter 语义：`KEY_ENTER_COMMAND` 注册在 `COMMAND_PRIORITY_CRITICAL`；**`event.shiftKey === true` 时 return false**（落到 `@lexical/plain-text` 的换行默认），否则提交 | `.../input/editor/keymap.ts`（~257-270 行，文件头注释写明该回退语义） |
+| 公开输入动作面：`InputActions` 提供 `captureInsertion / insertText / setDraft / submit` 等 | `.../contract/input.ts`（~250-285 行） |
+| Session 级座位标准 props：`sessionId`、`useSession`、`useConversation`、`useInput`、`inputActions`；`conversation.input.overlay` 为 `{kind:'list', scope:'session'}`（"Floating entries rendered inside the resident composer card"） | `.../contract/slots.ts`（~292、~350-365 行） |
+| 斜杠/引用菜单在覆盖层内渲染 `[role="listbox"]`，且以 `[data-composer-card]` 为定位锚点 | `packages/client/ui-input-trigger/src/client/MenuView.tsx`（~86、132 行） |
+| 快捷键命令契约：`ShortcutCommand{id,label,aliases,defaults,regions,modals,resolve}`；`ShortcutContext{source,region,modal,target}`；Web 白名单 `isWebBindingAllowed` 允许 `primary+shift+字母` | `packages/client/shortcuts/src/client/types.ts`、`packages/client/shortcuts/src/binding.ts`（~96-112 行）、`packages/client/shortcuts/README.zh.md` |
+| 客户端插件清单：`DshClientManifest{platform, inject?, immediately?, external?}`；包需 `exports['./client']` + `dsh.bundle.patch`（无 bundle patch 会被标 `not-bundle`） | `packages/util/package-manifest/src/types.ts`、`packages/client/modules/README.zh.md`、`packages/boot/plugin-manager/src/index.ts`（~459 行） |
+| 第三方手写 bundle 的可行样本：`dsh-session-titler`（`window.__ModuleLoader__.load({id, factory})`，React 走 `require('react')`，模块级 store + `useSyncExternalStore`） | 已装插件 `~/.dsh/profiles/web/node_modules/dsh-session-titler/client.js` |
+
+补充：源码 master 与运行中的桌面版（2.0.20-next，内置 dsh 0.2.1-rc.3，构建于 10-23）为同一版本线；`ShortcutCommand` 所需的 `regions/modals/aliases` 都已核对。现有已装插件里没有占用 `KeyE` 的默认绑定（唯一命中是 `apiKeyEnv` 文本）。
+
+## 3. 交付物（工作区即插件包根目录）
+
+```
+dsh-ml-input/
+├── package.json               # name=dsh-ml-input, dsh.bundle.patch + dsh.client
+├── cordis.patch.yml           # insert 一行 host 插件（id: ml-input）
+├── index.js                   # Host 半：空实现，满足 bundle patch 契约
+├── client.js                  # 手写 Client 半（状态 / 快捷键 / 提示 / 键位接管 / CSS）
+├── icon.svg
+├── locale/zh.json             # {"meta":{title,description}}
+├── locale/en.json
+├── test/core.test.js          # node --test
+├── test/harness.js            # Node 里的 __ModuleLoader__ 垫片
+├── README.md / ROADMAP.md / CHANGELOG.md / LICENSE / .gitignore
+└── docs/
+    ├── PLAN-2026-10-27.md
+    └── RELEASE-CHECKLIST-0.1.0.md
+```
+
+无第三方依赖、无构建。插件仍放在 `zl-plugins/dsh-ml-input`（与 dsh-session-titler 等一致），DSH 仓库只作契约依据与回归参考。
+
+## 4. 实现设计
+
+### 4.1 清单与 Host 半
+
+```json
+{
+  "name": "dsh-ml-input",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": { ".": "./index.js", "./client": "./client.js",
+               "./package.json": "./package.json", "./locale/*.json": "./locale/*.json" },
+  "dsh": {
+    "bundle": { "patch": "./cordis.patch.yml" },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": ["@deepseek-ai/dsh-client-locale", "@deepseek-ai/dsh-client-ui-conversation"]
+    },
+    "compatibility": { "dsh": ">=0.2.1-rc.3 <0.3.0-0" }
+  }
+}
+```
+
+`cordis.patch.yml`：
+
+```yaml
+- insert:
+    - id: ml-input
+      name: 'dsh-ml-input'
+```
+
+`index.js` 只导出 `name` 与空的 `apply(){}`，让包成为可安装/启停的 bundle row；客户端半由 `dsh.client` 自动发现。
+
+### 4.2 模式状态
+
+- `'single' | 'multi'`，默认 `single`；`localStorage['dsh-ml-input.mode.v1']`（读写 try/catch，失败退化内存态）。
+- 生效：`<html data-dsh-ml-input="multi">`，单行时移除；`apply()` 时同步设置，卸载时清理。
+- 模块级 store：`getSnapshot / subscribe / toggle`，提示组件用 `useSyncExternalStore` 订阅（与 dsh-session-titler 同款）。
+- 切换不清空草稿、不抢焦点；点提示时 `mousedown.preventDefault()` 保焦点。
+
+### 4.3 快捷键（官方命令，可编辑）
+
+- id `ml-input.toggle`（满足 `a.b` 持久化格式）；label zh「切换多行输入」/ en「Toggle multiline input」；aliases 含「多行输入 / 单行输入 / multiline / ml-input」。
+- 默认：`desktop:macos|windows|linux` = `{code:'KeyE', modifiers:['control']}`（显示 `Ctrl+E`）；`web:macos|windows` = `{code:'KeyE', modifiers:['primary','shift']}`（Web 白名单允许）；`web:linux` 不设默认。
+- `regions: ['page','editable']`，`modals: []`。
+- `resolve(context)`：`modal !== null` → pass；目标在 composer 之外的输入框 → pass（保留系统/浏览器原生 Ctrl+E）；否则 handled → `toggle()`。
+- 注册放在 `ctx.inject(['shortcuts'], scope => scope.effect(() => scope.shortcuts.register(...)))`，try/catch：与其它插件默认组合冲突时降级为「点击切换」+ console.warn，不让插件激活失败。
+- 修改入口即官方设置：注册后自动出现在「设置 → 通用 → 快捷键」弹窗（可搜索、录制、冲突提示、按设备持久化）。
+- 提示键位来自 `ctx.shortcuts.catalog` 快照，自绘格式（control→Ctrl、meta→Cmd、alt→Alt、shift→Shift，code 去 `Key` 前缀），macOS 也显示 `Ctrl+E`。
+
+### 4.4 右上角提示
+
+- 座位 `conversation.input.overlay`（list，`order:10`），渲染 `<button class="dml-hint">`。
+- 可见性用标准 hook `useInput(s => s.draft === '' && s.attachmentIds.length === 0)`，与 `showPlaceholder` 语义一致；不做订阅机制。
+- 内容：`<span class="dml-key">Ctrl+E</span><span class="dml-label">多行输入</span>`；多行模式加 `<span class="dml-meta">Shift+Enter 提交</span>`，label 变「单行输入」。
+- 定位 `position:absolute; top:8px; right:12px`（相对 `[data-composer-overlay]`），12px 字，key 用 `--dsw-alias-label-secondary`、label 用 `--dsw-alias-label-tertiary`。
+- 点击切换；`click.stopPropagation()` 防止 hero 卡片触发工作区选择；`title` 说明可在设置中修改。
+
+### 4.5 多行高度
+
+```css
+html[data-dsh-ml-input="multi"] [data-composer-card] [data-composer-input] {
+  min-height: calc(4 * 1lh + 8px);  /* 4 行正文 + 上下 padding；不支持 lh 时回退 calc(4 * 24px + 8px) */
+}
+```
+
+只依赖 `data-*` 锚点；specificity 高于 `.input` 与 hero 的 52px；不提高 336px 的滚动上限（4 行起步、最多约 14 行后滚动）。
+
+### 4.6 Enter / Shift+Enter
+
+document 捕获阶段 keydown（`ctx.effect` 卸载），全部满足才接管：多行模式；`key==='Enter'` 且无 `ctrl/meta/alt`；非输入法（`isComposing` / `keyCode 229`）；目标在 `[data-composer-card]` 内且是 `[data-composer-input][contenteditable="true"]`；`data-phase === 'plain'`；覆盖层内无 `[role="listbox"]`。
+
+接管：`preventDefault + stopPropagation`，向编辑器派发翻转 `shiftKey` 的合成 `KeyboardEvent`（打标防递归）：
+
+- Enter → 派发 Shift+Enter：走 DSH 自己的换行分支（LineBreak，进 undo）；
+- Shift+Enter → 派发 Enter：走 DSH 自己的提交分支（busy-enter / canSubmit / 菜单仲裁全部保留）。
+
+兜底（实机若合成事件不生效）：改用 `inputActions.captureInsertion()` + `insertText('\n', span)` 换行、`inputActions.submit()` 提交，判定条件不变。
+
+## 5. 边界与失败模式
+
+| 场景 | 处理 |
+|---|---|
+| 输入法候选态 Enter | 放行 |
+| `/`、`@` 菜单打开 | 检测 `[role=listbox]`，放行 |
+| 命令 claim / 提交中 | `data-phase !== 'plain'` 放行 |
+| Cmd/Ctrl+Enter、Alt+Enter | 放行 |
+| 其它输入框里的 Ctrl+E | resolve 返回 pass |
+| 设置弹窗/录制中 | `modal !== null` → pass |
+| 快捷键冲突 | catch 降级，提示仍可点 |
+| 快捷键被清空 | 提示只显示文案 |
+| 无 shortcuts 服务 | `ctx.inject` 不触发，其余功能照常 |
+| localStorage 不可用 | 内存态 |
+| 两个 composer | 高度统一生效，提示各自渲染，监听一份 |
+| 只读 composer | `contenteditable="true"` 才接管 |
+| DSH DOM 锚点变化 | 首次挂载自检，缺锚点只 warn 一次，不崩 |
+| 卸载 | 移除 style / 属性 / 监听 / 命令 |
+
+## 6. 测试与验收
+
+**自动**（`npm test` = `node --test`）：harness 垫 `window.__ModuleLoader__` 与 `require('react')`，取 `client.js` 的 `__test` 纯函数，覆盖：模式循环与非法值归一；存储异常；`formatShortcut`；默认组合常量（桌面 control+KeyE、web primary+shift+KeyE、web:linux 无）；`shouldIntercept` 全分支（多行/单行、Shift、修饰键、IME、phase、菜单、目标）；属性 set/remove。
+**静态**：`node --check`、locale JSON 解析、`npm --cache .npm-cache pack --dry-run` 文件清单。
+**实机**（安装后逐条）：提示出现/隐藏；切换高度 4 行；Enter 换行、Shift+Enter 发送；Cmd/Ctrl+Enter 不变；斜杠菜单 Enter 不变；输入法不误触；刷新保持；设置改键生效；禁用后恢复原样。
+
+## 7. 安装与验证
+
+- 先重新读一遍第 2 节源码文件，确认 master 未漂移。
+- 装进正在使用的 profile（当前 `main`）：优先应用内「插件」页 → 添加插件 → 绝对路径 `/Users/zilong/zWork/ai/zl-plugins/dsh-ml-input` → 安装 → 启用 → 刷新；备选 `dsh plugin --profile main add link:/Users/zilong/zWork/ai/zl-plugins/dsh-ml-input`（执行前单独确认）。
+- 之后改 `client.js`/CSS 刷新页面即可；清单变更才需重启。
+- 回滚：插件页关闭/卸载，或 `dsh plugin --profile main remove dsh-ml-input`。
+
+## 8. 文档与存档（按既有规则）
+
+- 获批后把本方案原文存到 `docs/PLAN-2026-10-27.md`，实施后追加「实施偏差（事后补记）」。
+- 新建 `docs/RELEASE-CHECKLIST-0.1.0.md`；README 加文档索引，ROADMAP 挂链接；CHANGELOG 记 0.1.0。
+- README 写明源码依据文件与 commit，便于 DSH 升级后回归。
+
+## 9. 不做（v0.1.0）
+
+不改 DSH 源码；不做内联录制器（用官方设置页）；不做 Host 路由/配置页；不做按会话记忆；不发 npm、不做市场条目、不建远端；不处理 TUI/CLI。
+
+## 10. 假设与风险
+
+- 合成键盘事件能触发 Lexical 根监听（源码已确认监听在编辑根节点、Enter handler 只看 `shiftKey`）；不成立则走 `InputActions` 兜底。
+- 依赖的 `data-*` 锚点与 `role=listbox` 属内部实现，已在 rc.3 源码确认；升级 DSH 需回归，插件做缺锚点 warn。
+- `Ctrl+E` 默认组合与已装插件不冲突（已查）；运行期冲突仍由 try/catch 兜底。
+- `1lh` 需要较新 Chromium；桌面版满足，且保留固定 px 回退。
+- 我无法直接操作你屏幕上的 Electron 窗口，UI 观感与交互需你按第 6 节确认，我按反馈迭代。
+
+---
+
+## 实施偏差（事后补记）
+
+> 本节为实施后补记，与上方计划原文分开看。
+
+1. **目标 profile 判断错误**：计划里写「当前 `main`」，实际当前运行的是 **DeepSeek Harness.app + `desktop` profile**。依据：运行中的 Host 进程 cwd 与打开的 `~/.dsh/profiles/desktop/package.json`、`cordis.patch.yml`；本会话可用的 zotero / im / univer 工具只出现在 desktop 的 bundle 列表；desktop profile 的 `.plugin-manager` 日志显示最近的本地 link 安装。`main` 属于同时运行的 DSH NEXT（监听 58501，日志 `desktop-next.log`），与当前 GUI 不是同一实例。
+2. **安装方式**：`dsh plugin --profile desktop add ...` 被应用独占拒绝（`profile "desktop" is managed exclusively by the Electron application`）。改为等价的手动 link：用应用自带的 pnpm 11.28.5 在 desktop profile 执行 `pnpm add link:/Users/zilong/zWork/ai/zl-plugins/dsh-ml-input`，并把 `dsh-ml-input` 追加进 `dsh.profile.bundles`。profile 的 `patchReload: live` 让 HMR 监听 `package.json`，改动后自动 reconcile。
+3. **Host 行激活验证**：曾临时在 `index.js` 的 `apply()` 里写文件哨兵，并在 profile 补丁里临时加 `- id: ml-input` 的 disable/enable 行强制重载；哨兵于 `2026-10-27T16:30:37Z` 出现，证明 Host 已组合并激活插件行。随后已删除哨兵、恢复补丁文件并还原 `index.js`。
+4. **浏览器半验证**：曾临时在 `apply()` 写 `localStorage['dsh-ml-input.selfcheck']`，在 Electron 的 LevelDB 中读到该键，证明客户端 bundle 已加载且 `apply()` 真正执行；随后用一次性 removeItem 版本清除并恢复最终代码。
+5. 实现与计划一致：单文件手写 `client.js`、`conversation.input.overlay` 提示、`ctx.shortcuts` 命令、捕获阶段翻转 `shiftKey` 的 Enter 接管、`data-*` 锚点。（计划里“用 `useInput` 判断空草稿”在后续样式调整中已移除，提示改为常驻。）
+10. **改名（2026-10-28）**：开源前把包名从 `dsh-ml-input` 改为 **`dsh-multiline-input`**（`ml` 在 LLM 插件市场易被读成 machine learning；新名与 `dsh-composer-*` 命名簇一致、可搜索）。同步改了模块 id、locale NS、快捷键命令 id（`multiline-input.toggle`）、storage key、宿主 row id、CSS 前缀（`dml-`→`dmi-`）、profile 依赖与 bundle 列表；本地目录名保持 `dsh-ml-input`（会话工作区不便改名，包名以 package.json 为准）。
+6. **开发热更新更正**：计划第 7 节写「改 client.js 刷新页面即可」，实测不成立——HMR 默认忽略 `**/node_modules`（`packages/boot/hmr/src/index.ts`），链接安装的 `client.js` 改动不会被 `rebuilt()` 拾取。实际做法：在插件页把本插件关/开一次（或重启应用）触发客户端 bundle 重组，再刷新页面；`package.json` / 补丁文件的改动仍会被 profile 监听自动 reconcile。README 已同步。
+7. **验收后的用户调整（2026-10-28）**：按子龙反馈——① 桌面默认键从字面 `Control+E` 改为 `primary+KeyE`（macOS 显示并生效为 `Cmd+E`，Windows/Linux 为 `Ctrl+E`）；② 提示改为**常驻**，不再随输入隐藏。
+8. **提示样式再调整（2026-10-28）**：试过“与卡片一体的顶部窄条”（同底色、底部淡线、给卡片预留 `padding-top`），但子龙要的是**贴着输入框上沿、像给输入框加一个 tab** 的形态。
+9. **最终形态（2026-10-28）**：提示改为输入框上沿右侧的小 tab——`position:absolute; right: calc(var(--dsw-radius-panel) + 4px); bottom: 100%`（浮在卡片上方、不占输入区布局）、背景 `--dsw-specific-input-major`（同卡片底色）、宽度 `max-content`（只包文字）、顶部 `--dsw-radius-md` 圆角、底部 `0.5px solid --dsw-alias-border-l2`（与卡片描边同色，视觉上连成一体）；原先的卡片 `padding-top` 预留已移除。

package/docs/RELEASE-CHECKLIST-0.1.0.md

@@ -0,0 +1,60 @@
+# dsh-multiline-input 0.1.0 发版 / 执行检查清单
+
+> 每次发版或装到本机验收时逐条勾选；未勾选的项目要写明原因。
+
+## 1. 代码与静态检查
+
+- [x] `node --check client.js`
+- [x] `node --check index.js`
+- [x] `npm test`（`node --test`）全绿
+- [x] `locale/zh.json`、`locale/en.json`、`package.json` 可被 JSON 解析
+- [x] `npm --cache .npm-cache pack --dry-run` 文件清单包含 `client.js`、`cordis.patch.yml`、`locale/*`、README、docs
+- [x] `package.json` 版本 = `0.1.0`，`dsh.compatibility.dsh` = `>=0.2.1-rc.3 <0.3.0-0`
+
+## 2. 安装
+
+> 本机运行中的 DeepSeek Harness 使用 `desktop` profile，由应用独占；`dsh plugin --profile desktop` 会报
+> `profile "desktop" is managed exclusively by the Electron application`。
+
+- [x] 方式一（应用内）：「插件」页 → 添加插件 → 绝对路径本目录 → 安装 → 启用
+- [x] 方式二（开发期手动 link，已在 2026-10-28 执行）：
+  `cd ~/.dsh/profiles/desktop && pnpm add link:<本目录>`，
+  再把 `dsh-multiline-input` 追加进 `package.json` 的 `dsh.profile.bundles`；
+  profile 的 `patchReload: live` 会自动 reconcile（曾用临时文件哨兵验证 Host 行于 2026-10-27T16:30:37Z 激活）
+- [ ] 插件出现在已安装列表，且能启用 / 禁用
+- [ ] 刷新页面后插件加载（无控制台报错；若报错记录完整堆栈）
+
+## 3. 实机验收（空会话 + 有内容会话各一次）
+
+- [ ] 输入框上方右侧常驻显示 `Cmd+E 多行输入`（macOS；Windows / Linux 为 `Ctrl+E`）
+- [ ] 输入文字后提示仍在（常驻，不隐藏）
+- [ ] `Cmd+E` / `Ctrl+E` 在编辑器内可切换；在页面空白处也可切换
+- [ ] 多行模式输入框最小高度 4 行；切回单行恢复原高度
+- [ ] 多行模式 `Enter` 换行（`Cmd/Ctrl+Z` 可撤销）
+- [ ] 多行模式 `Shift+Enter` 发送
+- [ ] 多行模式 `Cmd/Ctrl+Enter` 仍为加速提交
+- [ ] 输入 `/` 打开菜单后 `Enter` 仍选中菜单项，不换行
+- [ ] 输入 `@` 打开引用菜单后 `Enter` 仍选中菜单项
+- [ ] 中文输入法候选态按 `Enter` 不误触，选词正常
+- [ ] 在设置搜索框 / 会话重命名输入框内按 `Ctrl+E` 不切换模式
+- [ ] 刷新页面后模式保持；重启应用后模式保持
+- [ ] `设置 → 通用 → 快捷键` 中出现「切换多行输入」，可改绑、可恢复默认
+- [ ] 改绑后右上角提示立即更新；清空绑定后提示只显示文案且可点击
+- [ ] 禁用插件后：提示消失、高度恢复、`Ctrl+E` 不再切换、无残留 DOM / 控制台报错
+
+## 4. 回滚
+
+- [ ] 插件页关闭或卸载；或 `dsh plugin --profile <profile> remove dsh-multiline-input`
+- [ ] 回滚后与安装前一致（原输入框行为、快捷键设置里的条目消失）
+
+## 5. 存档
+
+- [ ] `docs/PLAN-2026-10-27.md` 已保存获批原文
+- [ ] 实施偏差已回填到计划文末
+- [ ] README 文档索引、ROADMAP 链接已更新
+- [ ] git 首次提交完成（本地）
+
+## 备注
+
+- 本版本不发布 npm、不做市场条目、不建远端。
+- 依赖 DSH `0.2.1-rc.3` 的 composer DOM 锚点；升级 DSH 后按第 3 节重新验收。

package/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none">
+  <rect x="3" y="4" width="18" height="16" rx="4" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M7 9h10M7 12h10M7 15h6" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
+</svg>

package/index.js

@@ -0,0 +1,17 @@
+/**
+ * Host half of dsh-multiline-input.
+ *
+ * The feature is browser-only. This row exists so the package is a real
+ * bundle row that the Plugins page can install, enable and disable; the
+ * browser half is discovered through package.json's `dsh.client`
+ * declaration and served by client-modules.
+ *
+ * Reference contracts (source checkout `deepseek-harness`, 0.2.1-rc.3):
+ *   - packages/client/modules/README.zh.md
+ *   - packages/util/package-manifest/src/types.ts (DshClientManifest)
+ *   - packages/boot/plugin-manager/src/index.ts ("not-bundle")
+ */
+export const name = 'multiline-input'
+
+/** The Host half owns no services; it only keeps the bundle row alive. */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Multiline input",
+    "description": "Toggle the conversation composer between single-line and multi-line: Ctrl+E by default (editable in Settings → General → Keyboard shortcuts), Enter inserts a newline and Shift+Enter sends while multi-line."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "多行输入",
+    "description": "把对话输入框在单行 / 多行之间切换：默认 Ctrl+E（可在「设置 → 通用 → 快捷键」中修改），多行时 Enter 换行、Shift+Enter 发送。"
+  }
+}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "dsh-multiline-input",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Single/multi-line composer toggle for DeepSeek Harness: an editable Cmd/Ctrl+E shortcut, a tab hint on the composer, a 4-line floor for multi-line drafts, and Shift+Enter to send.",
+  "license": "MIT",
+  "author": "ZilongYang",
+  "icon": "./icon.svg",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "client-plugin",
+    "composer",
+    "multiline",
+    "input",
+    "keyboard-shortcut",
+    "web"
+  ],
+  "engines": {
+    "node": ">=20.3"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "icon.svg",
+    "locale/zh.json",
+    "locale/en.json",
+    "screenshots.json",
+    "assets",
+    "README.md",
+    "ROADMAP.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "docs"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
+    },
+    "compatibility": {
+      "dsh": ">=0.2.1-rc.3 <0.3.0-0"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZilongYang/dsh-multiline-input.git"
+  },
+  "homepage": "https://github.com/ZilongYang/dsh-multiline-input#readme",
+  "bugs": {
+    "url": "https://github.com/ZilongYang/dsh-multiline-input/issues"
+  }
+}

package/screenshots.json

@@ -0,0 +1,4 @@
+[
+  "assets/screenshot-1-single-line.png",
+  "assets/screenshot-2-multiline.png"
+]