Asianfleet/dsh-message-copy-enhance

English · 中文

DeepSeek Harness 客户端 UI 插件：划选模型输出并复制时，把剪贴板内容改写为 Markdown，链接、LaTeX 公式源码、代码块语言等信息不再丢失。

工作原理

DSH 的模型输出由 dsh-client-ui-conversation → dsh-client-ui-primitives 渲染：

内容	DOM 形态	恢复方式
链接	<a href="...">	直接取 href，输出 [label](url)
行内/块级 LaTeX	KaTeX 渲染的 .katex / .katex-display	从 MathML 分支的 <annotation encoding="application/x-tex"> 取回 TeX 源码，输出 $...$ / $$...$$
代码块	.md-code-block（banner 显示语言）+ pre	输出围栏代码块，语言取自 language-* class 或 banner 的 infostring
标题/强调/列表/引用/表格	标准 HTML	还原为 GFM

插件在 document 上以捕获阶段监听 copy 事件，仅当选区起点落在 [data-chat-flow-kind="assistant"] 消息内且包含 markdown 特征元素时接管：

1. 把选区扩展到完整的 .katex 元素（选中公式中间也能拿到完整源码）
2. Range.cloneContents() 克隆选区 DOM
3. 用内置的零依赖 DOM→Markdown 转换器（src/client/toMarkdown.ts，TypeScript 编写、类型擦除后内联进 bundle）还原 markdown
4. preventDefault() 后写入 text/plain 与 text/markdown

其余选区（用户气泡、工具卡片、普通文本）与空选区完全不受影响；转换失败时自动回退默认复制。

项目结构

dsh-message-copy-enhance/
├── package.json            # dsh.client 元数据（客户端插件声明）
├── tsconfig.json           # typecheck 配置（strict，含 src/test/vite.config.ts）
├── vite.config.ts          # vite 构建（DSH 模块加载器输出）+ vitest 配置
├── src/client/
│   ├── index.ts            # 插件入口：copy 拦截 + apply/inject（TS，apply(ctx) 使用官方
│   │                       #   @deepseek-ai/cordis 的 Context 类型，与 dsh-client-ui-* 一致）
│   └── toMarkdown.ts       # DOM→Markdown 转换器（TS，零依赖）
├── lib/
│   ├── index.js            # Host 侧 no-op 插件（DSH Loader 加载的 JS 入口）
│   └── index.d.ts          # Host 入口的类型声明
├── dist/client.js          # 构建产物（预生成）
└── test/                   # vitest（.test.ts），转换器/bundle/包结构

构建与测试

npm install           # 开发依赖：typescript / vite / vitest / @types/node / linkedom / @deepseek-ai/cordis（官方类型）
npm run typecheck     # tsc -p tsconfig.json —— 全量类型检查（strict）
npm run build         # vite build —— 把 src/client 打包为 DSH 模块加载器格式的 dist/client.js
npm test              # vitest run —— 36 个用例（转换器 / 真实 bundle / 包结构）
npm run test:watch    # vitest —— watch 模式
npm run test:coverage # vitest run --coverage —— v8 覆盖率报告

发布

发布流程由 release-it 驱动，基于 Conventional Commits 自动生成 CHANGELOG。在 main 分支、工作区干净时执行：

pnpm release

它是交互式的：先打印自上个 tag 以来的提交预览（按类型分组，并给出 conventional 推荐版本号），随后弹出提示让你选择下一个版本号（patch / minor / major / 预发布变体 / 自定义）。流程依次为：

1. 检查（npm run check:release）：版本号是合法 SemVer、版本号未与 npm 已发布版本重复、已设置 GITHUB_TOKEN、npm 已登录；随后运行类型检查与测试套件。
2. 交互选择版本——打印 changelog 预览后由你选择下一个版本号（提示中会显示 conventional 推荐值：feat → minor、fix/perf/revert → patch、破坏性变更 → major）。
3. 生成 CHANGELOG——基于自上个 tag 以来的提交、按所选版本重新生成 CHANGELOG.md。
4. 构建——npm run build（DSH 模块加载器格式的客户端 bundle）。
5. 发布——提交 chore(release): vX.Y.Z、打 tag vX.Y.Z、推送到 GitHub、创建 GitHub Release（release notes 取自 CHANGELOG）、最后 npm publish。

前置条件：

• 已导出 GITHUB_PAT_TOKEN（GitHub PAT：Classic token 需 repo 权限；Fine-grained token 需对本仓库授予 Contents: Read and write；gh auth token 也可，GITHUB_TOKEN 作为备选同样支持），并执行过 npm login。协作者预检已关闭（github.skipChecks）——细粒度 token 调用该接口会 403，真实权限由 GitHub 在创建 Release 时强制校验。
• 提交遵循 Conventional Commits 规范；脚本只识别这些类型。

常用变体：

pnpm release:dry                   # 预演：只预览全部流程，不产生任何变更
pnpm release -- --increment=patch  # 跳过提示，强制 patch 递增（也可用 minor/major）
pnpm release -- --ci               # 完全非交互（CI 用，默认退回 patch）

注意：若环境中设置了 CI 环境变量，release-it 会自动切换到非交互模式。

安装启用

dsh plugin --profile desktop add dsh-message-copy-enhance

升级

dsh plugin --profile desktop add dsh-message-copy-enhance@latest

本插件尚未发布 1.0，^0.1.0 这类 caret 范围只覆盖 patch 版本（0.1.x）；minor 升级（如 0.1 → 0.2）不在该范围内，dsh plugin update 不会自动升级。请用 @latest（或 @<版本号>）显式升级。

使用

在任意模型回答中划选内容后 Ctrl/Cmd+C，粘贴到 Typora / Obsidian / VS Code / 任意 markdown 编辑器即可得到完整 markdown。

边界与限制

• 选区跨越多条消息时不拦截（只处理起点在 assistant 消息内的选区）。
• 渲染时被白名单过滤掉的链接（如 file:、相对链接）本来就不存在 href，无法恢复。
• 代码块只恢复选中的部分行（不会强制扩展整块）；语言标记在选中区域不包含 banner 时会缺失。
• KaTeX 渲染失败显示为 .katex-error 的元素按 $源码$ 输出。
• 表格以 GFM 管道表输出，| 会被转义。

License

MIT — Copyright (c) 2026 Asianfleet