dsh-PdfCraft：在 DeepSeek Harness 中嵌入 PdfCraft

前言¶

DeepSeek Harness（DSH）把对话代理的能力扩展到了 PDF 编辑领域。dsh-PdfCraft 是一个插件，它把 PdfCraft 的 Web 界面放在 DSH 的右侧边栏，同时给对话代理挂载 PdfCraft 的 MCP 工具。两个组件共享同一个工作区目录，但运行在各自独立的上下文中：Panel 直接编辑磁盘上的 PDF，代理通过 pdfcraft-cli mcp 访问同一个文件，并通过版本控制防止互相覆盖。

是什么¶

dsh-PdfCraft 是一个 DeepSeek Harness bundle，它把 PdfCraft 整合进 DSH 的工作流。维护者是 liuke101。分类属于模型推理。插件本身不包含 PdfCraft 的代码或二进制文件，而是从 PdfCraft 的官方 v0.9.0 发布版中下载两个上游制品：命令行引擎和 Web 构建版。

核心功能¶

右侧边栏 Panel：嵌入 PdfCraft 的 Web 应用，使用原生的菜单、工具栏和偏好设置。
代理工具：每个活跃代理都挂载一个 pdfcraft-cli mcp 服务，上下文限定于该对话的工作区目录。
工作区文档：Panel 读取并写回同一个工作区文档，代理工具默认读写同一目录。
容器隔离：Panel 的路径解析只允许访问工作区内的真实路径，拒绝外部请求；代理引擎运行时使用 --root 指定相同目录。
无额外服务：插件不占用端口，不发起出站网络请求，也不需要手动配置 MCP 行。

组件与行¶

插件通过 cordis.patch.yml 注入两个 Loader 行，同时激活：

行名	模块	负责
`pdfcraft-web`	`dsh-pdfcraft`	Web 组件资源、就绪报告、工作区文档读写路由、绑定注册与推送通道服务、`/pdfcraft` 命令、`pdfcraft_open` 工具
`pdfcraft-cli`	`dsh-pdfcraft/cli`	每个代理的 PdfCraft 引擎及其生命周期

包暴露两个入口：exports["."] 和 exports["./web" 解析为 Web 组件（dist/web/index.js）；exports["./cli"] 解析为 CLI 组件（dist/cli/index.js）。显示文本由 locale/*.json 提供：Web 行标题为 dsh-pdfcraft，CLI 行标题为 dsh-pdfcraft-cli。Panel 页面标题为 PdfCraft。禁用 pdfcraft-web 会同时移除 Panel 页面、路由、命令和打开工具；禁用 pdfcraft-cli 只移除代理引擎，Panel 仍然可用。

安装与启用¶

插件需要先从 PdfCraft 官方发布版下载两个制品，再安装到 DSH。

下载制品到下载目录（Linux x86_64 示例）：

mkdir -p "$HOME/pdfcraft-download"
cd "$HOME/pdfcraft-download"
BASE=https://github.com/storytold/pdfcraft/releases/download/v0.9.0
curl -fLO "$BASE/pdfcraft-cli-0.9.0-linux-x86_64.tar.gz"
curl -fLO "$BASE/pdfcraft-web-0.9.0.zip"
curl -fLO "$BASE/SHA256SUMS.txt"

校验下载文件：

cd "$HOME/pdfcraft-download"
CLI=pdfcraft-cli-0.9.0-linux-x86_64.tar.gz
WEB=pdfcraft-web-0.9.0.zip
grep -E "  (${CLI}|${WEB})\$" SHA256SUMS.txt | sha256sum --check

如果输出中两个文件都显示 OK，则校验通过。

解压并安装 CLI 引擎：

cd "$HOME/pdfcraft-download"
tar xzf pdfcraft-cli-0.9.0-linux-x86_64.tar.gz
mkdir -p "$HOME/.local/bin"
install -m 755 pdfcraft-cli-0.9.0-linux-x86_64/pdfcraft-cli "$HOME/.local/bin/pdfcraft-cli"

解压 Web 构建版：

unzip pdfcraft-web-0.9.0.zip

在 DSH 中安装插件（使用官方命令）：

dsh plugin add https://github.com/liuke101/dsh-PdfCraft

安装后，插件在 DSH 中激活为两个组件：右侧边栏的 PdfCraft Panel 和每个代理的 PdfCraft CLI 引擎。

典型用法¶

打开 Panel：在 DSH 右侧边栏点击「PdfCraft」页面，即可使用 PdfCraft 的原生界面编辑 PDF。
代理调用：在对话中让代理使用 pdfcraft_open 工具打开工作区中的 PDF，代理会通过 MCP 工具进行修改。
保存与同步：在 Panel 中保存的更改会写回工作区文档，代理对同一文件的修改也会被保存；版本控制机制防止覆盖。

适用场景与注意¶

适合需要通过对话代理批量处理 PDF、自动生成或修改文档的用户。
插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证（MIT）。
平台要求：DSH 0.2.1-rc.1、PdfCraft 0.9.0、Linux x86_64 为验证环境；需要 WebGPU 或 WebGL2 浏览器支持。

结尾¶

dsh-PdfCraft 让 PdfCraft 成为 DSH 工作流中的原生组件，既保留了 Web 界面的易用性，又让代理能够通过 MCP 工具自动化处理 PDF。如果你在构建基于 DSH 的文档工作流，这个插件可以减少手动操作，提高效率。插件目录与源码见：https://github.com/liuke101/dsh-PdfCraft