dsh-message-copy-enhance
将助手消息中选中的内容复制为 Markdown，保留链接、LaTeX 源码与代码块语言信息。
READMEdsh-message-copy-enhance
DeepSeek Harness 客户端 UI 插件：划选模型输出并复制时，把剪贴板内容改写为 Markdown，链接、LaTeX 公式源码、代码块语言等信息不再丢失。
工作原理
DSH 的模型输出由 dsh-client-ui-conversation → dsh-client-ui-primitives 渲染：
| 内容 | DOM 形态 | 恢复方式 |
|---|---|---|
| 链接 | <a href="https://github.com/Asianfleet/dsh-message-copy-enhance/blob/HEAD/..."> | 直接取 href，输出 [label](https://github.com/Asianfleet/dsh-message-copy-enhance/blob/HEAD/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 特征元素时接管：
- 把选区扩展到完整的
.katex元素（选中公式中间也能拿到完整源码） Range.cloneContents()克隆选区 DOM- 用内置的零依赖 DOM→Markdown 转换器（
src/client/toMarkdown.ts，TypeScript 编写、类型擦除后内联进 bundle）还原 markdown preventDefault()后写入text/plain与text/markdown
其余选区（用户气泡、工具卡片、普通文本）与空选区完全不受影响；转换失败时自动回退默认复制。
项目结构
▼text复制代码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/包结构
构建与测试
▼bash复制代码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 分支、工作区干净时执行：
▼bash复制代码pnpm release
它是交互式的：先打印自上个 tag 以来的提交预览（按类型分组，并给出 conventional 推荐版本号），随后弹出提示让你选择下一个版本号（patch / minor / major / 预发布变体 / 自定义）。流程依次为：
- 检查（
npm run check:release）：版本号是合法 SemVer、版本号未与 npm 已发布版本重复、已设置GITHUB_TOKEN、npm 已登录；随后运行类型检查与测试套件。 - 交互选择版本——打印 changelog 预览后由你选择下一个版本号（提示中会显示 conventional 推荐值：
feat→ minor、fix/perf/revert→ patch、破坏性变更 → major）。 - 生成 CHANGELOG——基于自上个 tag 以来的提交、按所选版本重新生成
CHANGELOG.md。 - 构建——
npm run build（DSH 模块加载器格式的客户端 bundle）。 - 发布——提交
chore(release): vX.Y.Z、打 tagvX.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 规范；脚本只识别这些类型。
常用变体：
▼bash复制代码pnpm release:dry # 预演：只预览全部流程，不产生任何变更 pnpm release -- --increment=patch # 跳过提示，强制 patch 递增（也可用 minor/major） pnpm release -- --ci # 完全非交互（CI 用，默认退回 patch）
注意：若环境中设置了 CI 环境变量，release-it 会自动切换到非交互模式。
安装启用
▼bash复制代码dsh plugin --profile desktop add dsh-message-copy-enhance
升级
▼bash复制代码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
