前言¶
在 DSH 里用 Agent 改 HTML 原型、报告或作品集时，常见流程是：在编辑器里改文件、在浏览器里另开标签核对版式，批注散落在聊天或外部文档里，导出 PDF 又要再跑一遍检查。dsh-deliver-studio（交付工作台）把「预览 → 批注 → 修改 → 导出」收进 DSH 右侧文件预览，并与本机 Chromium 内核浏览器联动做分类 QA 和 PDF 导出，数据默认留在本机。
下面按插件定位、能力、安装与用法说明，事实均来自仓库 README 与 package.json（版本 0.2.1，MIT，维护者 passenfall）。
这是什么¶
dsh-deliver-studio 是 DeepSeek Harness（DSH）0.2.x 的工作流类插件：针对 .html / .htm 交付物，提供视口预览、就地批注（可导出带批注 HTML 供对方在浏览器里回答）、可停靠面板，以及按类别分组的交付 QA 与 PDF 导出。
- 仓库：github.com/passenfall/dsh-deliver-studio
- 社区目录：skillhub.cn/plugins/passenfall/dsh-deliver-studio
- 插件无运行时 npm 依赖，
client.js已预先构建
核心功能¶
视口预览¶
在右侧文件预览打开 HTML 时，渲染器可选「交付工作台」。视口可在下拉菜单中切换：桌面 1440、笔记本 1280、平板 768、手机 390、A4 794，并按面板宽度自动缩放。页面自身的 #/ 路由与锚点可用；同目录其它 HTML 链接在预览内打开，站外链接在新窗口打开。
批注与面板¶
工具栏可在「浏览 / 批注」间切换。批注模式下点选元素（Shift 多选），就地输入意见并选标记颜色；首次可填昵称。批注列表、QA、元素样式合在一个分页面板里，可停靠底部 / 顶部 / 左右或浮动，位置与尺寸会记住。支持回复、定位、删除，以及「发给 Agent」：将全部批注（含目标元素、路由、回复）整理成结构化消息放进输入框。
导出带批注的 HTML¶
在 HTML 同目录生成 <原名>.annotated.html（源文件已带批注时写回自身）。打开后可通过标记气泡查看批注、写回答；「保存副本」可把批注与回答写入新 HTML，传回后在台里打开即可看到。
交付 QA¶
检查项包括：图/表编号与正文引用（中英文常见写法）、孤字、文字截断与横向溢出、A4/幻灯片留白、标题落页底、WCAG AA 对比度、字体种类、图片问题、页内死链、禁用字样与字数等。结果按视觉、文本、版式、编号、资源、交付规范等类别分组，可筛选、只看必改。每条结果带级别（必改 / 建议）、CSS 选择器与修复建议，支持定位、加入批注、忽略，或把筛选结果一次发给 Agent。界面 QA 与命令/模型工具共用 runtime.js，结果一致。
导出 PDF¶
使用本机 Edge / Chrome / Chromium / Brave 无头打印：A4、保留背景色、无浏览器页眉页脚。默认导出前先跑 QA；有必改项时需确认，或加 --force。
安装与启用¶
任选一种方式（来自官方 README）：
- Git 地址：打开 DSH Web，进入「插件 → 添加插件」，输入：
https://github.com/passenfall/dsh-deliver-studio
- 本地文件夹：从 Releases 下载
dsh-deliver-studio-<版本>.zip并解压，在「插件 → 添加插件」里输入该文件夹的绝对路径。
装好后在插件列表找到「交付工作台」，可在设置页调整配置。在右侧预览中打开 .html，渲染器选「交付工作台」即可。Git 方式升级可在插件列表更新；本地文件夹方式需替换内容后停用再启用，并刷新 DSH 页面。
环境与配置¶
环境要求¶
- DSH 0.2.x
- 本机任一 Chromium 内核浏览器（Edge、Chrome、Chromium、Brave）
浏览器查找顺序：插件设置 browserPath → 环境变量 DELIVER_STUDIO_BROWSER / CHROME_PATH → 按平台自动查找。设置页会显示是否已找到浏览器。
常用配置项¶
| 键 | 默认值 | 说明 |
|---|---|---|
bannedWords |
TODO、TBD、FIXME 等 | 页面出现记为必改 |
targetChars |
0 |
目标字数；0 表示只统计，偏差超 10% 给建议 |
defaultViewport |
desktop |
默认视口 |
qaBeforeExport |
true |
导出 PDF 前是否强制 QA |
browserPath |
空 | 浏览器可执行路径，留空自动查找 |
典型用法¶
工作台入口¶
在预览里将渲染器选为「交付工作台」；或用命令提示打开：
/deliver <文件>
路径可为绝对路径，或相对当前会话工作目录。
命令¶
/deliver qa <文件>
对指定 HTML 跑交付 QA，输出问题清单。
/deliver export <文件> [--force]
导出与 HTML 同目录同名的 PDF；有必改项且未加 --force 时不导出。
Agent 工具¶
deliver_qa：参数path，可选viewport；无头渲染并返回带级别、选择器与修复建议的清单。deliver_export_pdf：参数path，可选out、force；默认先 QA，有必改且未force=true时返回清单而不导出。
适用场景与注意¶
适合需要在 DSH 内闭环审阅 HTML 交付物、把批注结构化回灌 Agent、并在出 PDF 前做一轮启发式规范检查的场景。插件以当前 DSH 进程权限运行，安装前应自行查看源码与 MIT 许可证；README 写明渲染、QA、导出均在本地完成，bridge 仅接受本机 loopback 的 JSON POST。
使用上需注意：QA 为启发式规则（如图表编号、英文引用句式有明确识别范围）；工作台打包本地资源有数量与体积上限；批注按选择器与元素文字前 40 字定位，大幅改版后旧批注可能无法定位；macOS / Linux 上浏览器自动查找有单测但未在真机全面实测；预览 iframe 沙箱会拦截 alert、表单提交等。
结尾¶
dsh-deliver-studio 把 HTML 交付物的预览、协作式批注、分类 QA 与本机 PDF 导出放进 DSH 工作台，并与 /deliver 命令和 deliver_qa / deliver_export_pdf 工具对齐。进一步了解可从社区目录 passenfall/dsh-deliver-studio 进入，或直接查阅 GitHub 仓库 的 README、CHANGELOG 与隐私说明。
