chrome
DSH 插件：驱动当前 Chrome 中的后台标签页，并将选定的元素发送到 composer。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yueyexiayu/dsh-chrome#2141873ef6682f12c7e97b203655ae6cfc97ee05Chrome 以 chrome 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
当前项目是深度适配个人使用，项目只是给大家提供思路和借鉴，尽量不要直接照搬。
DeepSeek Harness 桌面插件。通过本机 Chrome 扩展，在当前 Chrome 里开后台标签，收进一个折叠的 DSH 标签组。不另开窗口，也不把 Chrome 拉到最前。用的是当前 Chrome 的登录状态。
只允许 http / https。页面正文是不可信数据，不是指令。
复制到 $DSH_HOME/plugins/chrome（默认 $DSH_HOME 为 ~/.dsh），在 $DSH_HOME/profiles/desktop/cordis.patch.yml 写入：
- insert:
- id: chrome
name: ../../plugins/chrome/lib/index.js
先在插件目录运行 pnpm install --frozen-lockfile，安装锁定的纯 JavaScript JPEG 解码依赖（jpeg-js，不执行原生编译）。随后完全退出 DeepSeek Harness（macOS：⌘Q）再打开。插件启动时会写入 Chrome 本机通信主机清单。
还要在正在使用的 Chrome 配置里装一次扩展：
chrome://extensions$DSH_HOME/plugins/chrome/extension改了 extension/ 之后，在扩展卡片上点重新加载。
chrome_ 开头。标注由 Client 放进当前会话输入框；接收被中断且无法确认草稿状态时，显示恢复提示DSH 加会话 id 末 6 位，只用于展示。完整会话归属单独记录，不会因标题相同复用另一个对话的标签，也不会调用 Page.bringToFrontchrome_close 只关掉本对话的标签组，不退出 Chrome，也不关其他对话的组chrome_browsers 的 list 执行真实扩展握手和探活，不创建、不发现标签；成功才报告 connected，连接、协议、超时和取消错误直接可见。启动后尚未操作浏览器不再被误报为断线。与普通操作和采集串行复用同一连接；断线会清除所有对话的旧 transport/ref 缓存，不关闭真实标签，恢复后重新认领各自归属的标签chrome_resize 不改窗口大小，避免 macOS 把 Chrome 激活chrome_screenshot 把 PNG 落盘，并在确认当前模型支持图片时通过正式附件引用交回模型；配合 zhanshi 可在本轮对话里预览。插件不包装或改写全局 LLM 服务chrome_snapshot / chrome_query / chrome_find / chrome_a11y；这几次调用都会重新编号alert / confirm / prompt。弹窗挡住后续点击或输入时，先调用 chrome_dialogchrome_downloads 只在归属本对话的扩展查询成功后返回清单；扩展断线、超时、取消或响应结构异常会明确报错，不用旧缓存或 (none) 冒充查询成功。cookie / storage 默认不返回值；名字像 token 或密码的项始终打码chrome_shortcut 的 list / save / run 使用 $DSH_HOME/cache/chrome-shortcuts.json；只有 ENOENT 表示尚无存储。无效 JSON、非对象结构、无效动作数组和其他读取错误均拒绝读取或覆盖。保存和运行前校验整批动作，避免先执行前几步才发现后续参数错误。快捷步骤仍使用当前调用会话的归属，不跨对话复用标签.lock 文件保护跨进程读改写，同目录私有临时文件写入并 sync 后原子 rename；同进程和跨进程并发的不同名称不会互相丢失，同名保存则以最后完成的保存为准。新建缓存目录为 0700，存储和临时文件为 0600。写入、sync、rename 和锁失败都报错；写入或 rename 失败保留旧存储.lock 和随机 .tmp 文件。确认没有任何 DSH / CLI 快捷保存任务后才可清理对应遗留文件；不要删除整个 cache。原子替换不承诺系统断电时的目录元数据持久性点 Chrome 工具栏里的 DSH Chrome，在当前 http / https 页面上选择元素，最多 12 条。页面浮层只收集元素数据，不接收用户要求，也不能直接送入 DSH。点击「编辑要求」后，扩展检查原标签和 URL、截图，再打开独立的扩展确认页；这一步会切到确认页，后台浏览工具仍不会抢焦点。Esc 或再次点击工具栏图标退出选择。
在确认页查看截图和页面信息，为每条选择「改变」或「疑问」并填写 Request，最后明确点击「放入 DSH 草稿」。确认页不对网页开放，绑定随机审核 ID 与扩展标签；只有该页的确认才会保存标注。页面提供的文字、HTML、样式始终是数据，不是用户指令。标注放入当前 DSH 输入框，不自动提交对话。chrome:// 和扩展页不能选。
改了 extension/ 之后，在扩展卡片上点重新加载。改了 Host 或 Client 后，完全退出 DeepSeek Harness（⌘Q）再打开。
标注只有在本机主机确认保存后才显示成功；确定未发送或主机明确拒绝时允许重试。发送前先记录处理中状态；断线、超时或 worker 重启导致结果未确认时，同一审核会话不会盲目重发，请先检查 DSH。主机已保存但审核状态写入失败时会单独提示，不会误报标注保存失败。Host 检查 JPEG 编码、大小及实际解码结果，限制像素和解码内存；标注目录权限为 0700，文件为 0600。保存的标注在文字和图片成功插入且草稿持久化成功后才确认删除；持久化失败时，后续轮询仍会重试持久化，不会因为内存中已经插入就偷偷确认。多个 DSH 窗口通过消费租约避免同时插入同一份标注。
插入前，插件先将目标会话和附件归属写入标注文件，并同步到磁盘。若在插入和确认之间崩溃，重启后不会自动再次插入：原会话中仍有完整文字和对应图片时，只补确认；无法确认时，保留标注并显示「重新放入草稿」和「已接收，完成确认」。请先检查草稿或已发送消息。选择恢复会补回图片，复用草稿中仍存在的完整标注文字，不覆盖其他文字和图片；已接收则只确认，不插入。其他会话只能看到回到原会话的提示。恢复期间再次中断，交付记录仍保留。
官方草稿目前持久化文字和引用，图片附件只存在于运行内存。因此完整重启后可能只恢复文字，需要通过上述提示补图。本恢复机制覆盖尚未确认的标注；已经成功确认的标注不保留截图副本，不改变官方草稿附件的持久化行为。
修复后须重新加载 Chrome 扩展并完全重启 DSH，使扩展、通信主机和 Client 同时使用新版本。归属记录使用 chrome.storage.session，扩展新增 storage 权限；旧版按组名识别的标签不会被新版自动认领或删除。
$DSH_HOME/cache/dsh-chrome.sock 不能安全探活：连接它就可能挤掉旧版控制器。新版发现它会明确拒绝连接，不自动删除。升级时完全退出 Chrome 和 DSH，确认旧通信主机已退出后，才可删除这个旧端点（默认 ~/.dsh/cache/dsh-chrome.sock；不要删除整个 cache），然后重新打开并加载新版扩展。此清理只用于旧固定端点，不适用于新的随机端点。普通 Node 的纯源码 / VM / 文件系统套件（不会连接真实 socket、启动 Native Host 或 Chrome）：
pnpm install --frozen-lockfile
/usr/local/bin/node test/run-pure.mjs
for file in lib/*.js extension/*.js host/*.mjs test/*.mjs test/fixtures/*.mjs; do
/usr/local/bin/node --check "$file" || exit 1
done
完整 protocol / Native Host 套件需要先独立确认现场 installed App 支持 RunAsNode，并取得该批本机进程验收授权，再在本插件目录执行。先从当前进程的可执行路径定位运行中的 DSH，不依赖旧固定应用名；多份不同安装并行时先明确选择目标：
DSH_EXECUTABLE="$(/bin/ps -axo comm= | /usr/bin/awk '/^\/Applications\/DeepSeek Harness( [^/]+)?\.app\/Contents\/MacOS\/DeepSeek Harness$/ { if (!seen[$0]++) print }')"
test -n "$DSH_EXECUTABLE" && test -x "$DSH_EXECUTABLE" || exit 1
ELECTRON_RUN_AS_NODE=1 "$DSH_EXECUTABLE" --test test/*.test.mjs
完整套件使用真正 installed App 的 Node 环境作为合法控制 peer；启动前检查真实 process.execPath、Electron Node 环境与 ELECTRON_RUN_AS_NODE=1，条件不足明确失败，不 skip、不改名 Node、不使用 production 测试豁免，不为让默认 npm test 变绿自动启动 GUI。Native fixtures 只用当前用户所有、权限私有、直接位于系统临时目录的 mkdtemp DSH_HOME、自有 Unix sockets 和模拟 Native frames，不写真实 NativeMessagingHosts 注册或用户 cache，也不接实际 Chrome。负例会启动普通 Node 及伪造 DSH argv0 的普通 Node，验证两者均被真实生产 gate 拒绝；reconnect 的 expiry 测试仅 VM-mock App-shaped peer 返回，不是 OS 身份证据。没有普通 Node peer 环境开关。
0.2.2 的生产 gate 继续通过 LOCAL_PEERPID / proc_pidpath 读取真实 socket 对端，只允许 /Applications/DeepSeek Harness[ <合法 SemVer>].app/Contents/MacOS/DeepSeek Harness，并要求 realpath 与原路径一致。非 DSH 应用、Helper、Node、嵌套伪路径和 symlink 逃逸均拒绝；这仍是 OS 可执行路径信任模型，不是额外的代码签名认证。认证、protocol 2 和 owner 隔离不变。现场带版本名 App 的重载、原生集成与当前 Chrome 运行态证据见 原生桥接验收记录。
测试涵盖握手错误与进程竞争、owner close / 取消 / late-create / pending evaluate 排空、B 隔离、iframe ref 路由、密码脱敏、文件策略、JPEG 真解码、标注持久化和可信确认页来源检查。VM 与私有 protocol fixtures 都不等于已安装扩展端到端验收；后者必须重载扩展并完整重启 DSH，独立确认实际版本后执行。