# 验证记录

当前目标宿主：DeepSeek Harness Desktop 0.2.1-rc.5，Windows。v0.5.1 至 v0.3.4 记录对应 rc.3，v0.3.3 及更早记录对应 rc.2。

## v0.5.2 适配桌面端 0.2.1-rc.5

2026-10-30：宿主升级到 0.2.1-rc.5 后，v0.5.1 的精确 rc.3 兼容声明会被宿主版本检查拒绝。将宿主、LLM 和 Typert Protocol 兼容声明同步更新到 rc.5，保留精确版本约束，不使用版本豁免。v0.5.1 未发布到 npm，功能与 v0.5.1 相同。

对照 npm 发布的 rc.3 与 rc.5：`@deepseek-ai/dsh` 的依赖集合不变，Cordis 仍为 ~4.0.5。插件用到的三个运行依赖、七个客户端注入包以及 `dsh-app-boot`、`dsh-agent-default-model`、`dsh-fs-sandbox` 中，除 package.json 外只有 `dsh-client-ui-conversation` 有改动：会话头部「更多会话视图」按钮的标签提示框改为按文字宽度显示，并删除 `session.moreViewsCurrent` 文案。插件不使用会话头部 View 标签，无需调整业务流程。

## v0.5.1 请求精简、记录稳健性、逐行改动与本机保存

2026-10-27：发给模型的选区数据改为紧凑 JSON；图片请求只保留原图坐标系下的轮廓（像素 1 位小数、归一化 4 位小数），不再重复屏幕坐标轮廓；文字候选的说明只出现一次。按 120 点图片圈选测算，请求从约 29,500 字符降到约 6,400；HTML 点选请求从约 4,800 降到约 3,300。提示语与字段含义不变。

修改记录的内部任务链不再向外抛错：读取宿主变更列表失败、核对或备份过程出错时记为记录问题并停用这条记录的回滚，宿主的工具调用照常执行。未发送的「等待开始」记录在同一会话发起新修改时自动替换；被替换的请求若仍与新请求同一消息发出，新记录标明不能单独回滚。正在执行或保存对比的记录仍阻止新请求。

预览同一资源多次引用时复用一次编码结果，并删除重复的 CSP 插入；悬停高亮不再占用元素标识，只有点击选择时分配。`engines` 改为 Node.js 22.18+，与直接运行 TypeScript 测试的要求一致。

第一批新增 4 项逻辑检查（请求精简、替换未发送记录、同消息混入旧请求、宿主变更列表异常），其中后 3 项已确认在 v0.5.0 代码上失败。交互检查改为按请求中的分隔说明读取 JSON，不依赖缩进格式。

同一版本内的第二批改动：

- 修改记录接口拆分：`changeDetail` 只返回状态和两侧是否已保存，冻结内容通过新增的 `changeContent`（before / after / texts）按需读取。面板按记录缓存内容，静态预览按快照缓存生成结果；轮询、状态变化、关闭重开和切换视图都不再重复传输或重新编码。文件是否变化在本轮保存时计算一次，列表轮询不再逐字节比较。
- 预览与修改记录共用 `src/resources.ts` 中的资源规则。修复两处不一致：无 `.css` 扩展名的 `@import` 目标此前不会继续收集其中引用的图片和字体；`rel="StyleSheet"` 等大小写写法及 `<noscript>` 中的资源此前不会进入记录。三种情况都会让记录中的修改前预览缺文件。
- 匹配样式规则从最后加载的样式表倒序查找，找到 8 条即停止，并先用 class、id、标签做粗筛；扫描上限从 1000 条提高到 20000 条。此前页面先加载大型框架时，自定义样式可能完全不被检查。
- 圈选文字时，整行都在选区内且未被裁剪的文字只测量可能折叠的空白和零宽字符。与旧实现在 6 种选区形状（含中英文换行、连续空格、pre、软连字符、滚动裁剪、透明祖先、凹多边形）上比对，结果逐字段一致；整段圈选耗时约降低 45%，其余形状持平。
- 回滚只在本会话或工作区重叠（同一目录或互为上下级）的会话运行时等待，其他文件夹中的会话不再阻止回滚。
- 视觉识别按工作区、路径和文件版本复用已保存的原图附件（宿主附件按内容哈希存储），重新识别不再重复读取和规范化原图；共享读取不受首个请求取消的影响。
- 修改记录未保存修改结果时，界面说明“没有保存修改结果”，不再显示等待提示。
- 未采用：发送前核对改为只比版本号。逐字节核对是有意的第二道检查，每轮最多读取一次 16 MiB 以内的本地文件，不值得为此放宽。

第二批新增 3 项逻辑检查（内容接口、资源规则一致、工作区重叠）与 2 项 Chromium 交互检查（内容只传一次、框架之后的自定义规则）；资源规则与样式规则两项已确认在改动前的代码上失败。宿主契约检查同步加入 `changeContent`。服务端原图缓存另用替身宿主单独验证（同版本只读取一次、版本变化重新读取、首个请求取消不影响共享读取）。

第三批改动：

- 「文件内容」改为逐行差异：Myers 算法（与 git diff 同类），红色删除、绿色新增，未改动的连续段折叠为可展开的提示；单独标出仅换行符（CRLF/LF）或 BOM 的变化。超过 20 万行或 2000 处改动时不逐行比较，显示完整前后内容。与动态规划最长公共子序列结果对照 500 组随机输入，改动均为最少且能还原两侧；5 万行文件约 0.1 秒。
- 已结束、已回滚和“记录未完成”的记录保存到本机应用数据目录（`%APPDATA%\dsh-region-edit\history`，可用 `DSH_REGION_EDIT_HISTORY_DIR` 改到别处），重启后载入。文件内容按 SHA-256 只存一份，记录与内容都先写临时文件再改名；载入时校验哈希和每个字段，损坏或格式不符的记录被丢弃，不影响其他记录。尚未发送或正在执行的请求不保存。
- 宿主的会话可按原 id 恢复（`resumeSessionId`），记录因此能对应回原会话；`session/disposed` 只表示会话从内存释放，现在只丢弃未结束的记录。
- 重启后回滚不再比较上次运行的版本标记，改为逐字节核对文件仍是保存时的修改后内容，写入仍以刚读到的版本为条件。同一次运行中的记录仍要求版本标记一致。
- 记录满（8 条或 64 MiB）时自动删除已回滚的记录和结束超过 7 天的记录，最旧的优先；7 天内和进行中的记录不自动删除，仍提示手动移除。保存失败时面板说明“重启后这条记录会丢失”，不阻止回滚。
- 记录列表中不是今天的记录显示日期。

第三批新增 6 项逻辑检查（逐行差异、重启后保留与按字节回滚、同次运行仍核对版本、损坏记录丢弃与释放会话、自动清理顺序、内容去重与清理）和 2 项 Chromium 交互检查（逐行高亮与折叠、旧记录日期与保存失败提示）。宿主契约检查改为把记录写到 `.work` 下的临时目录，并加入“插件重新载入后仍能列出、读取并拒绝冲突回滚”的检查；这项需要在本机运行。

交互检查中“移动鼠标后等待悬停边框”的一步偶发超时：在 v0.5.0 原始代码上 10 次运行中失败 3 次，与本次改动无关。诊断显示坐标、遮罩层与预览连接均正常，单次合成的指针移动偶尔没有产生悬停结果，再移动 1 像素即恢复；真实鼠标连续产生移动事件，不受影响。测试改为未出现边框时微移重试（最多 7 次）。

严格 TypeScript、生产构建、43 项逻辑检查与 50 项 Chromium 交互检查在 Linux 环境通过；真实宿主契约检查需在装有 Harness 的 Windows 本机运行 `npm run check`。

## v0.5.0 修改记录、冻结对比与安全回滚

2026-10-24：为本地 HTML 请求建立有界原内容记录，通过会话消息中的随机记录标识匹配本轮要求，并在 `turn/end` 后保存修改结果。原生 `tools/pre-execute` 核对发送前文件，`fs/write-intent` / `fs/edit-intent` 保存额外文件；复用 `workspaceChanges.summary` 发现未备份变动。恢复使用宿主 `fs.writeText` 的 `replaceIfVersion` / `createIfAbsent` 条件及原会话文件权限。

新增 13 项逻辑检查覆盖 HTML/CSS 冻结、精确 BOM/CRLF、后续修改整批拦截、部分失败与重试、草稿延迟导致的旧基线、原生工具额外文件、未备份文件、会话隔离、越界资源、二进制、新增和删除文件、并发准备、同轮混入其他要求与取消。

新增 Chromium 检查覆盖生成记录后放入输入框、移除未发送记录、备份失败不发送、发送失败清理记录、两侧不同 CSS 的冻结显示、文字内容查看、回滚状态、冲突提示与小窗口滚动。截图 `docs/images/comparison-v0.5.0.png` 来自测试环境；模型修改由测试替身模拟。

严格 TypeScript、生产构建、30 项逻辑检查、46 项 Chromium 交互检查与真实宿主契约检查通过。另已目视检查并排预览及 640 × 540 小窗口布局；回滚操作区固定在面板底部，移除记录后焦点返回面板，Esc 可正常关闭。

真实 rc.3 模块契约检查在独立临时目录中使用 `dsh-fs-sandbox` 完成 HTML 与 CSS 实际恢复，逐字节核对 BOM/CRLF，并验证后续人工写入不会被覆盖。临时目录在测试结束后清理。没有调用真实模型；此检查不等同于模型修改质量验收。

2026-10-25 桌面安装验收：官方 CLI 已将 desktop profile 更新到 v0.5.0，保留 dsh-orb 与 dsh-timeband。真实窗口显示「修改记录」，打开时能读取服务记录。对独立演示 HTML 点选按钮并点击「放入输入框」后，实际生成记录标识，面板显示「等待开始」和冻结的修改前页面，修改后区域等待本轮完成，回滚按钮保持禁用。随后通过两次点击移除这条未发送记录，恢复空列表。未发送验收请求、未调用模型或修改演示文件；续作检查时当前输入框已无验收标识，因此没有替换用户当前输入。

已安装程序文件与工作区构建一致：`dist/client.js` SHA-256 为 `dcfcd5f6a4b74c6fe067f11c3b6fe9c9c080ee0192df4df9bcedacc4a9126e45`，`dist/index.js` 为 `0af1ed406c69acdb6d67a5f621aa649c6c586420d030695fba7c38a99f0ed197`。演示源文件 SHA-256 仍为 `0f4b55b3ae97b1c6ba667bf008216817373e3974f1e94b4f3c894ad5f27ea912`。本段在安装后补充；安装包重新整理说明文件不会改变已安装运行代码。

范围限制：静态 HTML 对比、UTF-8 文件恢复；二进制写回、新文件删除、目录或重命名事务、持久化历史不包含在本阶段。文件逐个带版本条件恢复，多文件之间不是全局原子事务；中途失败保留逐文件恢复状态。无 Git 工作区中的额外命令行修改可能不在宿主列表中，界面不声称覆盖整个工作区。

## v0.4.0 本地 HTML 点选、源码位置与样式上下文

2026-10-24：新增 HTML 默认点选、悬停边框、外层/内层切换和折叠定位面板；保留图片、文字及 HTML 的自由圈选。parse5 在改写预览资源前记录原始标签行列及开始标签片段，文字相同的按钮分别定位。新增 class、关键计算样式、匹配 CSS 规则、引用变量和父容器布局；请求优先复用已有 class 与变量。

新增检查覆盖重复标签文字、注释和引号中的伪标签、浏览器补全节点、保留属性伪造、过大上下文拒绝、嵌套按钮点选且不触发点击、外层/内层切换保留要求、相同节点替换拦截、样式变化拦截、动态克隆不继承源码位置、预览与文件版本不一致，以及运行原页面脚本时取消精确静态位置声明。

TypeScript 严格检查、生产构建、17 项基础检查、40 项 Chromium 交互检查及本机 rc.3 真实宿主契约检查全部通过。补充检查确认展开定位信息后面板保持在窗口内，小窗口中滚动后能访问发送按钮。另用测试页面检查默认与展开面板布局，预览图位于 `artifacts/point-selection-v0.4.0.png` 和 `artifacts/point-selection-details-v0.4.0.png`；这两张图是测试环境界面，不是真实 DSH 桌面截图。

自动验证使用生产构建、真实 Chromium 和宿主服务测试替身，不发送用户消息、不调用真实模型。常规自动检查不截图；上述界面图仅用于开发验收。真实桌面安装验收见下一段；模型最终修改效果、前后图对比和回滚不属于本次验证。

2026-10-24 补充真实桌面安装验收：通过官方 CLI 将 desktop profile 中的插件从 v0.3.4 更新到 v0.4.0，保留 dsh-orb 和 dsh-timeband。已安装的 `dist/client.js`、`dist/index.js` 与工作区构建逐字节一致。启动本机 DSH 后，在独立的新会话预览中打开 `00-region-edit-demo/point-selection-demo.html`，点选第二个同名按钮，实际显示原始 HTML 第 36 行第 9 列、`primary` class、`--brand: #315edd` 与父容器 flex 布局。选择外层后定位到第 34 行的 `actions` 容器，返回内层后恢复第 36 行，修改要求保持。点击「放入输入框」成功；从真实编辑框核对了生成请求中的原文件路径、源码位置、颜色变量与父布局。没有点击发送，也没有调用模型执行文件修改；最终编辑效果及回滚仍未验收。

此次安装的 `dist/client.js` SHA-256 为 `4b5a113dc3e5256e6e32d3f77015aac7f2a5a6bcdac3c7a0a5085e5a1382784a`，`dist/index.js` 为 `6d2cb6a2d7521eded4b9b3c9f136ca615aaa30438829bd3522a54cded5cd44f1`。此记录在安装后补充，不改变已安装构建。

## v0.3.4 适配桌面端 0.2.1-rc.3

2026-10-24：本机桌面程序和内置宿主包均为 0.2.1-rc.3；旧插件的精确 rc.2 兼容声明导致宿主版本检查失败。将宿主、LLM 和 Typert Protocol 兼容声明同步更新到 rc.3，保留精确版本约束。

核对了本机 rc.3 的预览工具栏与渲染插槽、文件读取、预览资源监听、标签有效性判断、会话发送与原图附件、Connection RPC 和模型调用接口；插件所用调用方式仍适用，无需调整业务流程。宿主契约测试新增对实际 `evaluatePluginCompatibility` 的调用，并检查三个运行依赖和七个客户端依赖包的版本，不使用版本豁免。

TypeScript 严格检查、生产构建、13 项基础逻辑检查、32 项浏览器交互检查和 rc.3 真实宿主模块契约检查通过。交互测试采用生产构建与测试替身；宿主检查使用本机新版 Cordis、Remote 和 LLM 模块，文件和模型回复使用测试替身。未调用真实模型，未进行本次升级后的真实桌面交互验收；安装后需要重新打开客户端加载新版。

2026-10-24 功能截图补充验收：在 rc.3 真实桌面端打开独立演示海报，使用 v0.3.4 自由圈选标题，当前模型实际返回「标题文字“让灵感”」。已确认可纠正目标名称、填写修改要求且提交按钮启用；未点击发送或修改原图。应用户本次明确要求，仅为 GitHub 功能说明截取预览区域，生成三张实机截图和一张总览图，见 `docs/screenshots.md`。这不改变插件在定位和识别时直接读取原图的工作方式。

## v0.3.3 可见选区、手动目标恢复与本地样式资源

2026-10-23：文字选区增加祖先透明度、可见性和滚动容器裁剪检查；重选保留手动模式与待确认目标，确认沿用或修改名称后提交；CSS 背景图、字体与嵌套样式按各自文件位置解析、嵌入并加入文件监听；交叉轮廓明确提示重画。

TypeScript 严格检查、生产构建、13 项基础逻辑检查、32 项浏览器交互检查及真实宿主模块契约检查通过。新增回归涵盖透明和裁剪文字过滤、手动目标恢复与确认、显式恢复自动识别、CSS 转义和注释处理、本地背景图实际解码、嵌套和循环导入、字体 URL 转换、资源读取复用与数量上限，以及交叉轮廓后的重新圈选。

字体检查验证引用与字节转换，未评价字体文件的实际字形渲染。自动化使用生产构建和测试替身，不调用真实模型、不发送用户消息。安装包检查核对包内构建文件与工作区产物；真实桌面中的模型识别与修改效果未重新验收。

## v0.3.2 圈选恢复与手动识别

2026-10-23：修复窗口和预览区域尺寸变化时丢失修改要求、文件更新后重选仍持有旧版本、无文字 SVG 和图片无法选择、识别期间无法切换手动目标，以及小窗口面板滚轮被拦截的问题。新增空白背景容器定位；手动纠正目标时清除旧识别文字，避免混入不一致的描述。

TypeScript 严格检查、生产构建、11 项基础逻辑检查、26 项浏览器交互检查及真实宿主模块契约检查通过。7 项新增交互检查覆盖窗口变化保留输入、侧栏变化取消识别并保留输入、重选刷新文件版本与源码行号、隔离页面中的 SVG/图片/背景定位及隐藏对象排除、主动停止识别后带原图提交、忽略迟到识别结果，以及小窗口滚轮滚动。

`npm run check` 和 `npm run pack:plugin` 均包含宿主契约检查，并核对已安装宿主与声明的兼容版本。交互检查使用本机 Chrome 和插件生产构建；宿主服务及模型回复使用测试替身。构建检查完成后，已通过官方 CLI 安装到 desktop profile，安装文件与工作区构建校验一致；未进行真实模型调用或图像修改验收。

## v0.3.1 自由圈选与视觉识别

2026-10-23：TypeScript 严格检查、生产构建、11 项基础逻辑检查、19 项无截图交互检查通过。新增检查涵盖凹多边形排除外接范围内的圈外文字、原图字节作为原生图片附件提交、视觉识别结果纠正、识别失败后的手动目标、低置信度提示，以及重选时中断旧识别。

真实宿主框架契约检查通过：使用已安装 rc.2 的 Cordis、Typert Remote、LLM 消息与流组装类，验证插件加载、Remote 方法发现、原图内容、当前模型选择、图片能力检查、原文件变动、取消和卸载。此检查的文件存储与模型回复使用测试替身，不等同于真实模型识别质量。

视觉识别只读取原图并返回目标描述；修改请求通过宿主原生图片附件发送原图和自由轮廓。没有截图、裁剪图、模型凭据读取或独立常驻服务。v0.3.1 修正原生 Connection RPC 要求的 `payload.args` 包装。

真实桌面与真实模型验收通过：已通过官方 CLI 安装 v0.3.1，并仅重新启用本插件。在现有会话的本地海报 PNG 上，用原生鼠标画自由轮廓，UI Automation 确认出现修改输入框、状态「视觉识别完成」、目标文本框值为「“志愿启航”标题文字」。当前模型选择器显示 DeepSeek-V4.1-Flash。随后取消选区；没有发送修改指令、改动海报或截图。

已安装实现与工作区构建一致：`dist/client.js` SHA-256 为 `4362c508c61c3bc5258ccaf1381e654448197f866ece83a4679faee2dcea69d9`，`dist/index.js` 为 `6d2cb6a2d7521eded4b9b3c9f136ca615aaa30438829bd3522a54cded5cd44f1`。此桌面验收记录在安装后补充，已安装归档中的实现没有变化。真实模型的图像修改结果不属于本次只读识别验收。

## v0.2.1 历史验证

v0.2.1 已通过：TypeScript 严格检查、构建、8 项基础逻辑测试、14 项无截图交互检查。交互检查额外启用了与 Cordis 一致的根服务声明约束。

交互检查覆盖：桌面环境识别、文字圈选、反向拖选、请求绑定原文件、保留聊天草稿与引用、原文件版本变化、会话切换、选区内容变化、发送失败后重试、Esc 取消、图片原图坐标映射、图片选区追加到草稿、图片缩放后阻止旧选区提交、隔离页面的按钮定位、宿主代码工具开关、无截图依赖和无额外运行依赖。

上述交互检查使用真实 Chromium 与插件生产构建，宿主服务使用明确的测试替身。

桌面安装检查已完成：本机宿主的 `evaluatePluginCompatibility` 接受此包；官方 CLI 已成功将插件加入 desktop profile，既有 dsh-timeband 和 dsh-orb 条目保留。没有修改宿主程序或设置版本兼容豁免。

已在真实桌面客户端确认 v0.1.1 的故障原因：当前预览为海报 PNG，UI Automation 返回「圈选修改」控件 Enabled=false，与代码中禁用所有图片按钮的条件一致。

v0.2.1 移除了图片禁用条件，新增读取原图尺寸与选区坐标映射，并修复真实宿主中报出的 `cannot get property "remote" without inject` 服务声明遗漏。

2026-10-23 已完成真实桌面验收：通过官方插件管理重新启用此插件，在用户当前的海报 PNG 预览上以原生鼠标拖选；Windows UI Automation 确认「圈选修改」Enabled=true，出现「修改选中区域」对话框，「想把这里改成什么样？」输入框 Enabled=true，选区摘要为「已选中图片区域 · 353 × 236 像素」。随后取消选区并恢复原窗口状态，没有发送测试消息或修改海报。

安装后的 `dist/client.js` 与工作区构建文件 SHA-256 一致：`8cac012b34b4bdb67df7aa2e79e630276e7b64e51aae76b8fcd706f8ae5eff35`。本记录在桌面验收后补充；已安装归档中的实现没有变化。图像工具的最终修改结果不属于本次无付费模型请求的检查范围。

上述自动化检查均不截图、不调用真实模型、不修改用户既有会话；历史真实桌面与模型验收的范围以各版本记录为准。