🤖 本内容由 AI 编码代理生成，非人类手写。 This was generated by an AI coding agent, not written by a human.

• Agent: blancatora (DeepSeek Harness 编码代理)
• Model: deepseek-v4.1-flash
• Contact: blancatora@agent.qq.com

免责声明：本内容由上述 AI 代理生成，可能存在错误、不完整或未经充分验证的结论。 账号所有者未参与本内容的编写与决策，不对其内容与后果负责；也不代表任何第三方的立场。 使用前请自行核实。

增强的提示词编辑器

在输入框旁写长 prompt，写完直接发送或用内置阅读器留存。

dsh-enhanced-prompt-editor · English · 更新日志 · MIT

---

🤖 给 AI agent：动手改这个仓库之前，先读 AGENTS.md（怎么改： 验证命令、硬性约束、本仓库特有的坑）与 llms.txt（怎么用：能力与文档索引）。 人类可以忽略这一行，直接往下看。

为什么需要它

DSH 的输入框适合写短消息。要写几百行的 prompt 时，那个小框有三个具体问题：

1. 框太小 —— 长 prompt 在里面只剩几行可见，改一处要来回滚；
2. 回车即发送 —— 想换行得按 Shift+Enter，写多段结构时很别扭；
3. 留不下来 —— 辛苦写的 prompt 发送后就散了，下次想复用只能翻历史。

本插件把「写长 prompt」这件事从输入框里拆出来：

• 输入框工具栏加一个 T 按钮，点开右侧栏的独立编辑面板；
• 面板整块区域都是编辑区，可以和对话并排看；
• 草稿能落成工作区里的 .md 文件，因此能被 DSH 内置的文件阅读器直接打开；
• 面板右下角有发送与听写，回车行为可以在设置里改。

界面

编辑器模式（右侧栏大面板）

126 行的长 prompt（就是 docs/demo-long-prompt.md 那份） 在面板里仍然一行一色、行号连续，右侧工具条按 Markdown 常用结构分组。

扩展输入框模式（原生输入框加高 + 悬浮符号条）

原生输入框就地加高，行号与隔行底色跟着草稿文本走；上方是悬浮 deck。

原生模式 + 悬浮 deck（不切模式）

在插件设置里勾上「在原生输入框应用悬浮 deck」，原生输入框上方也会出现同一条 deck。

各部位形态

位置	形态
输入框工具行	28px 圆钮，主体字形 T，右下角叠一枚模式角标（面板图标 = 编辑器模式 / 向上箭头 = 扩展输入框模式 / 无角标 = 原生）
右侧栏	独立 tab：工具栏（草稿名 / 保存 / 用阅读器打开 / 清空）+ 大编辑区 + 状态栏（字数 · 存储方式 · 听写 · 发送）
原生输入框	扩展输入框模式下向上加高（最高高度可设）
插件页	侧栏「插件」→「增强的提示词编辑器」→ 自己的配置页

三种模式

点 T 会在已启用的模式之间循环，最后回到「原生」：

模式	效果
编辑器模式	点 T 在右侧栏打开 Markdown 编辑面板
扩展输入框模式	DSH 原生输入框立刻向上展开到设定的高度，且可单独决定回车语义
原生	两个增强都不生效（点 T 只是循环回来）

切模式会收掉上一个模式的界面：从编辑器模式切走时，右侧栏的面板会自动关闭 （草稿不丢，切回来还在），不会两个增强同时占着地方。

两个模式可以在插件页里独立勾选、并决定谁排在前面；两个都关掉时 T 变暗、不做任何事。 切到扩展输入框模式时会弹一条明确的横幅提醒（顶部居中，6 秒后自动消失）。

⚠️ 按钮不再有悬停提示框（原生 title 会弹出显示插件名的系统气泡）。 当前模式改由角标表达，可访问名称走 aria-label，不产生视觉浮层。

按钮位置说明（重要）

T 按钮注册进 DSH 的 conversation.input.left 插槽（session 级 list），因此实际排在：

[+] 附件/命令   [权限控件]   [计划控件]   [T]

DSH 没有提供「加号与权限控件之间」的插槽。conversation.input.left 是该区域唯一稳定的公开接入点，所以本插件没有用 CSS 强行重排核心 DOM——那会在 DSH 升级时静默错位。

按钮是常驻的：只要会话存在就显示，与当前选了哪个模型、哪个 provider 无关（这一点与 dsh-connect-workbuddy 的积分读数不同，那个是 provider 专属的门控渲染）。

想先看看它长什么样？docs/demo-long-prompt.md 是一份 126 行 / 5.2KB 的真实长 prompt 示例（12 个标题、4 段代码块、1 张表格、6 条验收项）， 可以直接复制粘进面板，用来截图或自测行号、隔行底色、多行编辑效果。

安装

兼容的 DSH 版本

• 已在 DSH 0.2.1-rc.2（内置 runtime 0.2.1-rc.2）上验证通过； package.json 声明 engines.dsh: ">=0.2.0-0"。
• 更早的版本（如 0.2.1-alpha.2）功能相同，但未在新区间逐一回归； 若宿主版本不满足 engines.dsh，DSH 会在插件页给出兼容性诊断。
• 依赖 Node ^22.19.0 || >=24.0.0（由 DSH 自带 runtime 提供，通常无需自装）。

本插件是本地包（file: 依赖），挂法与 dsh-cetus / dsh-email 一致。

1. 在 profile 里加依赖与 bundle 条目（~/.dsh/profiles/desktop/package.json）：

{
  "dependencies": {
    "dsh-enhanced-prompt-editor": "file:/abs/path/to/dsh-enhanced-prompt-editor"
  },
  "dsh": {
    "profile": {
      "bundles": ["…", "dsh-enhanced-prompt-editor"]
    }
  }
}

2. 装依赖：

cd ~/.dsh/profiles/desktop
/usr/lib/deepseek-harness-desktop/resources/runtime/primary-runtime/dependencies/pnpm/bin/pnpm.mjs install

3. 重启 DSH 应用。

客户端 bundle 只在应用启动时注册，因此必须重启才会生效。

设置

侧栏「插件」→ 找到本插件 → 在它自己的页面上配置（不是「设置」总页—— 那是 DSH 的现行规范：「注册了配置页的插件在这里、在它自己的页面上编辑」）。 改动只有点「保存」才写入。

项	默认	说明
编辑器模式	开	点 T 打开右侧栏面板
扩展输入框模式	开	原生输入框向上加高
循环顺序	编辑器 → 扩展输入框	两个模式都启用时生效
扩展输入框的回车	跟随 DSH	跟随 DSH（回车发送）或 回车换行（Cmd/Ctrl+Enter 才发送）
扩展输入框高度	640px	240–2000
草稿存储	工作区 .md 文件	工作区 .md 文件 / 仅浏览器本地 / 不保存
落盘目录	.dsh/prompts	相对于会话工作区根
面板内的回车	回车换行	只影响右侧栏面板
面板高度	420px	180–1400
编辑区字号	16px	11–28
快捷键按钮大小	100%	80–180
允许用内置阅读器打开	开	关掉后不写工作区文件
显示听写按钮	开	需已安装语音转文字插件
在原生输入框应用悬浮 deck	关	原生模式也要那条符号/缩进 deck
在原生输入框启用高级回车	关	原生模式也复用下面的回车策略
启用 Ctrl/Cmd+Shift+T 快捷键	开	关掉后该键位完全不接管（T 按钮照旧可用）

⚠️ DSH 自己没有「Enter 是换行还是发送」这个设置。 它的「回车行为」只管 智能体忙碌时 Enter 走排队还是插话，与换行无关；原生裸回车恒为发送。 所以「扩展输入框的回车」是本插件为扩展输入框新加的能力，默认不改变宿主行为。

⚠️ 面板内的回车设置只影响右侧栏面板，两者互不干扰。

快捷键

按键	行为
Ctrl/Cmd + Shift + T	切换输入框模式（等价于点输入框左侧的 T 按钮，在输入框里也能按）
Enter	换行（默认）或发送（可在设置里反转）
Cmd/Ctrl + Enter	发送（默认）或换行

Ctrl/Cmd + Shift + T 走的是 DSH 官方的快捷键服务（ctx.shortcuts），所以：

• 会出现在「设置 → 快捷键」里，可以自己改键；
• 与内核或其它插件的同键命令冲突时会拒绝注册，不会两边同时触发；
• 只在「页面 / 输入框 / 终端」三个区域内生效，打开设置弹窗时不会误触发；
• 可以在插件页面里用「启用 Ctrl/Cmd+Shift+T 快捷键」整个关掉。

💡 为什么不用 Ctrl/Cmd + T：那是 DSH 的键位。 内核的「新建浏览器标签页」 （browser.new）默认就绑定 Ctrl/Cmd + T，而内核的快捷键注册是「同键就整条拒绝」。 本插件早先占用过它，结果是内核那条反过来注册失败 —— 等于抢走了宿主既有能力。 所以本插件主动避让到 Ctrl/Cmd + Shift + T。

顺带说明：Shift + T（不带 Ctrl）也不行 —— 内核 bindingIssue() 显式拒绝 「只有 shift」的修饰组合，且这个拒绝在 desktop:linux 组生效，而注册是逐组校验、 任一组失败则整条失败，所以在 Linux 上等于根本没注册。

想改键：打开「设置 → 快捷键」，找到本插件的命令改成你喜欢的组合即可。

快捷键行

编辑区下方有一排符号按钮，鼠标点击即插入：

• 成对符号：() [] {} "" '' ` （） 「」 『』 【】 《》
• Markdown 常用：** * ~~ ``` # - > []() ![]() ---
• 粘贴：在光标处粘贴剪贴板内容

选中文字后点成对符号会把文字框在符号内，而不是把框选的文字改成符号：

操作	结果
选中 abc，点 ()	(abc)，且 abc 仍被选中
再点 **	(**abc**)
不选中，点 ()	()，光标在中间

编辑区逐行条纹：每行背景深浅交替，方便逐行扫读（焦点在编辑区时条纹偏品牌色）； 左侧另有行号沟槽，随编辑区一起滚动。

一键缩进：→ 给选中行各加两个空格；← 去掉一层缩进。

模式二（扩展输入框）也有同一排符号

扩展输入框模式下，输入卡上方会出现同一排符号按钮，行为与面板里完全一致。 两处共用一份符号表与规则（src/edit-ops.js），所以「包裹选中文字」的语义在 两个模式里天然相同。

写入走内核的官方程序化插入通道（inputActions.captureInsertion() + insertText(text, span)），而不是直接操作 Lexical 内部结构。

字号与按钮大小

插件页里可调「编辑区字号」（11–28px）与「快捷键按钮大小」（80–180%）。 字号是 CSS 变量，条纹行高会自动跟随。 | Shift + Enter | 恒为换行 |

输入法组合期间的回车不拦截——那是候选词确认，交还浏览器。

语音听写

复用 DSH 语音转文字插件的 remote.speech（catalog / transcribe），自己采集音频并编成宿主接受的 16 kHz 单声道 PCM16 WAV。

语音插件是可选依赖：用 ctx.inject(['remote.speech']) 解析，因此它的加载顺序无关紧要；未安装时听写按钮不渲染。

权限与数据

插件会碰你的什么，一次说清：

能力	用途	边界
写文件	把草稿写成工作区里的 .md	只写当前会话工作区之内；目录与文件名都经 Host 侧校验，越界即拒
读文件	读回自己的草稿、列举草稿目录	同上，仅工作区内
麦克风	听写（仅在你点「听写」后）	音频经 DSH 语音插件识别，本插件不留存录音
写入输入框	点「发送」时把文本交给会话	经 setDraft + submit，不直接构造模型请求
注册 HTTP 路由	落盘接口	只监听 loopback，校验 Origin，单次 body 上限 1 MiB

不做的事：不联网、不读取工作区外的文件、不采集遥测、不在插件目录外写任何文件、不在你未点击时访问麦克风。

草稿存在哪：由设置里的「草稿存储」决定——工作区 .md 文件（默认）、浏览器 localStorage、或完全不存。选「仅浏览器本地」时一个文件都不会写。

卸载后残留：已落盘的 .md 草稿留在工作区里（那是你的文件，插件不擅自删）；localStorage 键为 dsh.enhancedPromptEditor.draft（草稿）与 dsh.enhancedPromptEditor.mode（当前模式）。

扩展输入框模式改了什么：只在该模式下临时覆盖输入卡的 CSS 变量 --dsh-composer-text-max-height，切离时摘掉；不改结构、不重排 DOM。

安全

落盘走本插件 Host 侧的 loopback-only 同源路由（DSH 自带的 workspace-files Remote 只有读能力，无法写文件）。

防线	做法
路径逃逸	客户端传来的目录/文件名一律不可信；Host 侧解析后断言最终路径仍在会话工作区内（assertInside），越界即拒
跨站请求	校验 Origin，非本机来源返回 403
请求体积	单次 body 上限 1 MiB
危险文件名	含路径分隔符/控制字符的名字降级为 draft.md，而不是报错

这些边界都有真实起 HTTP 服务的端到端测试覆盖（test/host-route.test.mjs）。

开发

pnpm run build   # 从 src/ 生成 lib/client.js
pnpm test        # 构建 + 全部测试
pnpm run check   # 语法检查

lib/client.js 是生成物，不要手改。 改 src/ 后必须重新 pnpm run build。

为什么自带一个打包器

DSH 浏览器侧只消费一个 ./client bundle，window.__ModuleLoader__ 只把 ./ 开头的请求解析到同包分块。本项目不引入构建工具链，因此 src/build-client.mjs 用约 200 行把 src/*.js 合成一个自包含 factory：既保留模块边界（可单测、可复用），又满足单文件交付。

它刻意只支持一个窄语法子集（相对 import、export function/const/class、export {}），遇到不支持的写法直接报错——静默产出一个「能跑但行为不对」的 bundle，比构建失败难查得多。

构建期产物守卫

src/build-client.mjs 里的 assertBundleShape() 在写盘前断言两件事：

1. new Function(code) 能解析产物——语法坏掉立即构建失败。最容易踩的是 模板字符串内部注释里的反引号会提前闭合字符串，真机表现是白屏 + import failed 且没有任何堆栈；
2. 产物里的外部模块请求只允许前端 boot 冻结基座那 9 个（react、 react/jsx-runtime、react-dom、react-dom/client、@deepseek-ai/cordis、 @deepseek-ai/dsh-client-store、@deepseek-ai/dsh-client-ui-slots、 @deepseek-ai/dsh-client-ui-primitives、@deepseek-ai/dsh-client-ui-dockkit）。 表外的 require 在真机上必然失败。

UI 组件的来源

界面控件一律来自 @deepseek-ai/dsh-client-ui-primitives（Button、Switch、 Menu、SettingsForm …），不自己写按钮/下拉/SVG。它是前端 seed 表里的冻结基座 模块，require 一定成功；官方 10 个配置页里有 9 个都这么做。

发布流程与脱敏红线见 docs/RELEASING.md（推前硬闸：.githooks/pre-push）。

项目结构

src/
  constants.js        共享常量与纯函数（回车语义、路径规范化、标题）
  config.js           Host 配置 schema + volatile 活引用的解析
  paths.js            路径安全（assertInside / draftFileName / 列表）
  index.js            Host 侧：同源路由（落盘 / 回读 / 列举）
  client.js           浏览器入口：组装三个表面
  css.js              容错的样式注入（渲染期绝不抛错）
  store.js            跨表面共享的草稿状态
  settings-face.js    设置读写面（跟随 configForms 的上线/下线）
  io.js               落盘 / 浏览器存储 / 发送
  audio.js            麦克风采集与 WAV 编码
  composer-trigger.js 工具行 T 按钮（模式角标 + 横幅提醒）
  mode-controller.js  模式状态机（editor / extended / native 的循环与持久化）
  native-composer.js  扩展输入框模式：覆盖 CSS 变量 + 捕获阶段接管 Enter
  panel.js            右侧栏编辑面板
  plugin-card.js      插件详情页的配置卡片（primitives + SettingsForm）
  locale.js           中英文案
  build-client.mjs    自建打包器
lib/
  client.js           生成物
test/                 单元 + 集成 + electron 离屏几何
  unit.test.mjs       纯函数（模式状态机、回车语义、路径安全、WAV 编码、volatile 解析、样式注入容错、扩展输入框的 DOM 与事件处理）
  bundle.test.mjs     真的执行 lib/client.js，验证接线、插件卡片与静态守卫
  host-route.test.mjs 真的起 HTTP 服务，验证安全边界（9 项）

已知陷阱（写插件时踩过的，别再踩）

插槽的 inject() 返回值会被缓存，永不重算

插槽渲染器把 entry.inject(...) 的结果按 (entry, binding) 缓存进 WeakMap （内核 cachedSessionInject），没有任何失效路径。所以：

• ❌ inject: () => ({ mode: 当前模式 }) —— 值永久冻在第一帧， 点按钮后界面不会更新（本插件的 T 角标就栽在这里，且不报错）；
• ✅ inject: () => ({ hooks: { mode: 快照源 } }) —— 渲染器把快照源绑成组件 prop useMode()，组件在渲染期调用即拿到最新值并自动订阅。 官方 dsh-client-ui-settings-subagent 正是这个写法。

输入框高度是 max-height（上限）不是高度

内核 .scroll{max-height:var(--dsh-composer-text-max-height)}，空输入框只有 36px。 想「一切换就展开」必须同时给 min-height。

关右侧栏的 tab ≠ 收起右侧栏

内核《默认页与关闭规则》原文：停靠面的最后一个 tab 有一条规则，仅当它是「唯一停靠 tab」时，关闭才会连同整列一起收起。而停靠面永远不为空（会自动填充引导页）， 所以插件自己的 tab 几乎从不唯一 —— close(tabId) 只关 tab，右侧栏那一列照样开着。

要真的收起，必须自己调 isExpanded() / toggleExpanded()（都是公开 API）。 判断要不要收：在进入之前记一次 isExpanded()，只在「本来收起、因我们才展开」 时才由我们收回，否则会擅自关掉用户自己开着的侧栏。

撑高输入框：min-height 给编辑区，不是给滚动容器

扩展输入框的 DOM 是 .scroll[data-input-scroll] > .grow > .input[data-composer-input]。

• max-height 给 [data-input-scroll]：内容超长后在那里滚动。
• min-height 必须给 [data-composer-input]（contenteditable 本身）。

⚠️ 把 min-height 给滚动容器会造出一整片点不动的死区：容器被撑到 N px， 而编辑区仍是 36px（内核 .input{min-height:36px}），中间 N − 36 px 里没有任何 可聚焦元素；而且内核 onCardMouseDown 里有一句 if (scrollRef.current?.contains(target)) return; —— 落在滚动区内的点击宿主故意 不处理（它假定那里都是编辑区）。给编辑区设 min-height 后两者同高，死区为零。

CSS 渐变的色标必须写 var(--x)，漏掉 var() 会让整条声明失效

repeating-linear-gradient(var(--stripe) 0, ...) 是对的；写成 repeating-linear-gradient(--stripe 0, ...)（漏 var()）时，那个位置既不是颜色 也不是长度 —— 整条 background-image 被判无效并回落到 none， 表现是「条纹一条都不显示」而控制台不报任何错。测试要断言渐变里出现了 var(--名称)，只断言「有 repeating-linear-gradient」是抓不住的。

悬浮提示的 key 必须真的存在

title: t('symbol.<key>.hint') 在 symbol.<key>.hint 不存在时会显示裸 key （symbol.paren.hint）。测试要断言提示文本里不含 symbol. / panel. 前缀。

别把状态写在会被宿主重挂的元素上

.composerSeat 会在会话切换时重新挂载。挂在它（内联样式/属性）上的东西会丢； 挂在 <html> 上、用属性选择器命中，才扛得住重挂。

已知限制

• 发送会替换主输入框草稿 —— 走 setDraft + submit，不追加、不回填。
• 每个会话一个面板 —— tab 类型未设 multiple，重复点 T 是聚焦已有 tab。
• 只写工作区内 —— 工作区外的路径一律拒绝，这是刻意的。
• 语音识别能力由语音插件决定 —— 时长上限、语言、模型准备状态都不由本插件控制。
• PDF/Office 等格式的预览由 DSH 内置阅读器负责 —— 本插件只负责把 .md 交给它。

许可

MIT © 2026 blancatora