前言¶
在 DeepSeek Harness（DSH）Web 对话中，数学公式通常由 KaTeX 渲染。页面上看到的公式不一定适合直接复制，若需要 LaTeX 源文本，还需要额外整理。Blackspace2/dsh-math-copy 针对这个场景，为已渲染的数学公式提供轻量、可访问的复制交互。
这是什么¶
Blackspace2/dsh-math-copy 是面向 DeepSeek Harness Web 客户端的插件，由 Blackspace2 维护，许可证为 MIT。它为 DSH 对话中的 KaTeX 数学公式添加复制操作，帮助使用者获取原始 LaTeX。
核心功能¶
插件会自动识别 DSH 已渲染的行内公式、行间公式以及 KaTeX 错误公式，并提供以下交互：
- 鼠标悬停或键盘聚焦时，公式轻微悬浮，并显示柔和的边缘光影。
- 左键单击公式，直接复制为
$$...$$。 - 右键单击公式，可选择复制为
$...$、$$...$$或 LaTeX 块命令\[...\]。 - 复制成功后，在公式上方显示半透明的
Copied ✓提示。 - 支持键盘操作：
Enter/Space复制，菜单键或Shift+F10打开格式菜单，方向键选择，Escape关闭。 - 支持对话流式输出后新增的公式，并在插件卸载 / HMR 时完整清理事件与 DOM。
安装与启用¶
DSH 插件管理命令会调用 pnpm，安装前先确认 pnpm 可用：
corepack enable
pnpm --version
然后从 GitHub 安装插件：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add "github:Blackspace2/dsh-math-copy"
安装完成后，在希望作为 DSH workspace 的目录中运行 Web 客户端：
dsh web
然后强制刷新浏览器中的 http://127.0.0.1:3080。
如果修改了源码，需要重新构建：
corepack pnpm run build
安装命令引用 GitHub 仓库 Blackspace2/dsh-math-copy，卸载命令使用插件名 math-copy：
dsh plugin --profile web remove math-copy
典型用法¶
1、左键单击公式，或聚焦后按 Enter / Space，复制为 $$原始 LaTeX$$。
2、右键单击公式，或按菜单键 / Shift+F10，打开复制格式菜单。
3、在菜单内用 ↑ / ↓ 切换格式。
4、按 Escape 关闭格式菜单。
适用场景与注意¶
该插件适合在 DSH Web 对话中处理数学公式，并希望直接复制 LaTeX 源文本的使用者或开发者。
需要注意：
- 当前面向 DeepSeek Harness
0.1.0-rc.6Web 客户端。 package.json要求 Node.js>=20，packageManager指定pnpm@11.21.0。- 插件只依赖稳定的客户端模块交接协议和 KaTeX 标准 DOM，不依赖 DSH 内部 React 组件实现。
- DSH 本身负责 Markdown 数学语法识别与 KaTeX 渲染；本插件从 KaTeX 的
application/x-tex注解读取原始 LaTeX，不从视觉文本反向猜测公式。 - 如果现代 Clipboard API 因权限不可用，插件会尝试使用同一用户手势中的
document.execCommand('copy')兼容路径。 - 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
