引用选中文本 naletko/dsh-quote

为 DeepSeek Harness 引用

在对话中选中文本，把它以 markdown 块引用的形式放进输入框——就像 Codex 那样，而且不会动你已经写好的草稿。

选中文本旁边会出现一个低调的 Quote 按钮。点它，或者按 Ctrl+Shift+.（macOS 上是 Cmd+Shift+.），选中的内容就会以这样的形式落进输入框：

first line of the quoted text
second line of the quoted text

引用和你已经写好的内容之间空一行。引用是追加到草稿后面的，绝不会替换掉草稿。

✨ 功能

- 引用选中内容。 助手消息和用户消息都行——对话记录里任何能选中的东西。
- 绝不丢失草稿。 插入走的是输入框自己的 captureInsertion() / insertText()，在光标处插入一次可撤销的编辑。如果这条路径不可用，就从输入框读回草稿，把引用追加到后面——插件绝不会覆盖你写的内容。
- 键盘优先。 Windows 和 Linux 上是 Ctrl+Shift+.，macOS 上是 Cmd+Shift+.，组合键可以在设置里重新录制。
- 该消失时就消失。 选区折叠、点击空白处、按 Esc、滚动、调整窗口大小、切换标签页或切换会话，都会让按钮消失。
- 不会误触发。 input、textarea 或 contenteditable 区域内的选区——包括输入框本身——一律忽略。
- 文本整洁。 选中内容会去掉首尾空白，CRLF 会归一化，连续空行会合并成一行引用，引用长度有可配置的上限。
- 贴合主题。 每个颜色都是 DSH token（--dsw-alias-）并带兜底值，所以按钮和设置卡片在深色、浅色主题下都好看。它遵循 prefers-reduced-motion，带 aria-label，还有焦点环。
- 英语和俄语。 界面跟随 document.documentElement.lang（ru → 俄语，否则英语）。
- 无依赖，无构建步骤。 一个宿主文件，一个浏览器文件。

📦 安装

挑一条符合你使用 DSH 方式的路径。

从桌面应用安装

1. 打开 Plugins。
2. 选择 Add plugin，输入 dsh-quote——如果你安装的是本地检出，就填这个文件夹的绝对路径。
3. 如果安装后处于禁用状态，就启用它。设置卡片会出现在插件自己的页面上。

从命令行安装

dsh plugin --profile web add dsh-quote

想安装本地检出而不是已发布的包，就传它的绝对路径：

dsh plugin --profile web add /absolute/path/to/dsh-quote

从源码安装

不需要构建或安装任何东西：

git clone https://github.com/naletko/dsh-quote.git
cd dsh-quote
node test/metadata-check.mjs
node test/quote-logic-check.mjs

🚀 用法

1. 在对话中选中一些文本——消息的一部分、一整段、好几段都行。
2. 点选区旁边的 Quote，或者按快捷键。
3. 引用块会追加到输入框，前面空一行，草稿的其余部分原样不动。

典型用法：选中答案里你不认同的那段，引用它，然后在下面接着写你的追问。

⌨️ 键盘快捷键

| 平台 | 默认值 |
| Windows、Linux | Ctrl+Shift+. |
| macOS | Cmd+Shift+. |

设置里存的是可移植组合键 Mod+Shift+.，其中 Mod 在 Windows 和 Linux 上解析为 Ctrl，在 macOS 上解析为 Cmd。只要组合键里至少有一个修饰键，就能在设置卡片里录制；插件按物理键码匹配字母键，所以换到非拉丁键盘布局，快捷键照样能用。

⚙️ 设置

设置卡片在 Plugins 里插件自己的页面上，也可以从那一行的 Configure 控件进入。

| 设置 | 默认值 | 作用 |
| Enable quoting | 开 | 关掉按钮和快捷键，但不用卸载插件。 |
| Add an attribution line | 关 | 在引用末尾多补一行，> — quote（俄语：> — цитата）。 |
| Maximum quote length | 4000 | 从选中内容里保留的字符数；可填 200–20000。超出的部分按字符边界截断。 |
| Keyboard shortcut | Mod+Shift+. | 点一下输入框，按下你想用的组合键。Restore default 恢复默认值。 |

卡片里会实时预览将要插入的内容，所见即所得。

设置的读写走插件自己的路由 GET/POST /api/dsh-quote/config，存成 DSH 主目录下的 dsh-quote-config.json——设了 $DSH_HOME 就用它，否则用 ~/.dsh。浏览器在 localStorage 里留一份副本，纯粹是为了让输入框在首次渲染时就知道你的设置。

🔒 隐私

- 不访问网络。 插件的宿主端只提供一个本地路由，别的什么都不做；从不调用任何服务。
- 没有密钥，没有遥测，没有分析。 除了四项显示偏好，没有别的可配。
- 只写本地文件。 唯一写入的文件是 $DSH_HOME 下的 dsh-quote-config.json。
- 只接受本地请求。 /api/dsh-quote/config 会拒绝任何来源不明确为回环地址的请求，并拒绝超过 16 KiB 的请求体。
- 什么都不离开页面。 选中的文本在浏览器里格式化后插入输入框；本插件从不上传、记录或持久化它。

🔄 更新

插件会自己更新：Settings → Plugins → Quote 里有一块 Updates 区域，向 GitHub 查询分支修订，把已安装版本和 main 上的版本并排显示，列出改动内容，一键把锁定的提交交给 harness 插件管理器。之后刷新页面；如果版本没变，就重启应用——宿主端只在启动时加载。

如果部署环境没有插件管理器，这里会改为打印手动安装说明，供 Plugins → Add plugin 使用：github:naletko/dsh-quote。

🧩 环境要求与兼容性

- DeepSeek Harness 核心 0.2.0-rc.2（Desktop 应用的 Web 客户端，或浏览器会话）。
- 用到 conversation.input.activity、plugins.bundle.config 和 plugins.row.config 这几个插槽，以及输入框的 captureInsertion() / insertText() / setDraft() 动作。
- 支持 Windows、macOS 和 Linux。 路径用 node:path 拼接，热键能识别 metaKey，没有使用任何平台专属 API。
- 没有 npm 依赖，不用打包器，也没有构建步骤。

🧪 测试

node --check index.js client.js
node test/metadata-check.mjs # exports map, icon, locales, slot registrations
node test/quote-logic-check.mjs # quoting rules, hotkeys, settings, placement

client.js 不是模块——它自己注册到 DSH 的浏览器模块加载器——所以两个测试都通过伪造的 window.__ModuleLoader__ 加载它，跟浏览器里的做法完全一样，再借助插件暴露的 __test 钩子驱动插件自身的函数。宿主那一半是真正的 ES 模块，直接 import 即可。

📄 许可证

MIT © 2026 Alex Naletko