# 功能对齐与验证范围

接口适配基线：DeepSeek Harness `0.2.0-rc.2`，提交 `04f392c9ddd144fa426da2045178797da6db6c11`。后续已在本机 `0.2.1-rc.2` 验证插件可用，并确认新增 `deepseek` 伙伴在设置页正常显示。上游为 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)，其他版本需要按实际接口验证。Codex 对照事实及来源见 [调查记录](codex-pets-audit.md)。

本插件通过 Cordis、`shell.overlay`、`settings.section` 和原生会话服务接入，无需改动宿主安装文件。以下结果区分自动检查、实际宿主操作和模拟演练。

| 功能 | 验证范围 |
| --- | --- |
| 聊天 / 工作双模式 | Windows 桌面宿主实测原生工作与内嵌官网切换；网页草稿保留 |
| 聊天页眉标题与分享入口 | 页眉显示当前会话标题；隐藏网页重复标题；分享调用官网入口，重复扫描、弹窗按钮排除及入口缺失行为自动检查 |
| 工作区下方网页聊天列表 | 宿主实测标题同步、展开 / 收起及固定标题行；2.0.1 布局调整为聊天栏紧接项目列表，多项目时由侧栏滚动；空导航过渡与连续导航竞态自动检查 |
| 官网重命名 / 删除 | 专用测试会话重命名实测成功，用户随后删除；删除入口保留官网确认的行为自动检查 |
| 官网登录 | 用户手动登录；不复用或提取 Harness 登录凭据，当前宿主完全退出后可能需要重新登录 |
| 原生设置左栏“宠物伙伴” | 0.2.0 打包安装后，在真实 Harness 中打开；位于 Agent 预设下方 |
| 移除独立“伙伴”管理按钮 | 真实页面确认；宠物旁仅留聊天与动态 |
| 内置 deepseek、鲸娘、智域，选择持久化 | 三个 v2 图集校验；新安装默认 deepseek、升级保留选择自动检查；真实宿主切换智域，新增 deepseek 卡片和桌面形象实机确认 |
| deepseek 高清显示与完整轮廓 | 2 倍图集与标准图姿势逐像素对齐；安全边距、完整拆帧、高清展示 / 标准导出自动检查；Windows WPF 1× / 2× 真实像素裁切测试，不改变显示尺寸 |
| 精简模式，恢复角色 | 真实宿主从设置切换并恢复；模式与选择持久化自动检查 |
| v1/v2 PNG / lossless WebP | 解码像素、尺寸、必填帧、未用空格自动检查 |
| Codex 清单兼容与旧版 avatar.json | 默认 WebP/v1、别名导出、目录/ZIP 往返自动检查 |
| 保留 ID 的图集替换 | 无效输入回滚、摘要修订、元数据与偏好保持、内置项保护自动检查 |
| 多会话状态优先级 | 输入/审批、失败、未读完成、运行、待机自动检查；模拟多会话演练 |
| 活动打开/回复/停止、收起/静音 | 原生 API 参数与生命周期自动检查；面板交互模拟演练 |
| 快速聊天完整文本、工作区与错误 | 原生 API 契约自动检查；无密钥测试环境发送后，真实运行记录错误与动态面板提醒通过 |
| 草稿转入主输入栏 | 真实宿主含 @ 草稿全文转入；保留旧草稿与不自动发送的契约自动检查 |
| 创建/升级入口 | 准备主会话草稿；生成美术与模型全流程需配置环境后实际执行 |
| 九动作、时序、三轮后慢待机、十六方向 | 自动检查帧边界与映射；预览检查不等于动作自然度审定 |
| 减少动态、缩放、大小/位置重置 | 偏好自动检查；此前原生减少动态、重置位置已验证 |
| 拖动与键盘移动 | 边界自动检查；此前原生拖动和坐标保存已验证；方向键移动与 Esc 还原模拟演练通过；真实窗口缩放待验 |
| 应用内快捷键、按需显示 | Web profile 按需显示收起/恢复通过；0.2.1 新默认组合及冲突降级自动检查通过，桌面快捷键实际触发仍待用户窗口内复核 |
| 生命周期与访问控制 | 服务/工具/命令释放、订阅释放、宿主认证、非法偏好与路径校验自动检查 |

## 已知差异

- Windows 桌面版 0.3.2 使用独立透明置顶 WPF 窗口，Harness 后台/最小化时仍可见；固定全局 Ctrl+Alt+Shift+P 可唤出快速聊天。Web/其他平台保持应用内显示。透明像素穿透、多显示器吸附未实现；负坐标存储和工作区边界限制已实现，多屏混合 DPI 尚未实机验证。
- 实时双向语音、Codex 云端宠物库、分享收养和账号同步尚未实现。主输入栏可承载宿主自己的文件和语音输入，不表示具备 Codex 实时语音。
- 审批与提问在对应原生会话处理；宠物栏不复制审批控件。紧凑对话记录、附件回复和表情等完整 Mini 对话视图尚未移植。
- 本版保留已有缩放范围与默认值。通知收起按观察到的状态转换恢复，未实现 Codex 每个 turn 的精确过期时长。
- 本地宠物目录可以经 CLI 管理，设置页暂未提供直接打开系统文件夹的按钮。
- `validate` 证明文件结构与像素布局符合契约，不证明动作连贯、角色方向或美术完成度。初始形象的来源与限制见 [资源说明](assets.md)。

## 验证记录

2026-10-17 · 2.0.1：聊天历史栏随项目内容排布并紧接最后一行；项目较多时改由侧栏滚动。聊天与工作模式切换条尺寸统一，聊天标题栏移除网址。

2026-10-17 · 2.0.0：加入官网聊天与原生工作双模式，聊天历史置于工作区下方；官网页面保留原生消息生成及删除确认。63 项自动测试涵盖官方域名限制、浏览器租约生命周期、路由切换、快速连续选择、暂空导航保持、登录退出清理和官网重命名 / 删除适配。Windows 日常宿主已实测切换模式、未发送草稿保留、会话标题同步及专用测试会话重命名。官网登录由用户手动完成，测试会话由用户清理。README 配图使用无私人会话正文的界面截图。

2026-10-16：0.1.0 的 Windows/Linux CI、15 项自动测试和独立 skill CLI 往返演练已通过。此前在隔离 Web profile 验证了 `/pet list/hide/show`、拖动与坐标保存、减少动态、位置重置，以及 `MISSING_CREDENTIAL` 后新会话恢复待机。

0.2.0：Windows 构建、语法检查及 29 项自动测试通过；包含新增原生会话契约、全部会话优先级、Codex 包兼容和图集替换。tgz 安装到全新独立 DSH_HOME，通过真实宿主页面确认原生设置导航、角色切换、精简模式及含上下文的草稿转入。未改动用户日常 profile，也未更改 Codex 安装。补充验证：快速聊天真实发送后，读取 turn/end 的 MISSING_CREDENTIAL，宠物和动态面板均显示失败；窗口内快捷键和按需显示恢复通过；页面无未捕获错误。模拟演练通过多会话优先级、收起/恢复、静音/恢复、指定会话回复、发送/停止、方向键与 Esc 还原。成功模型回复、真实审批和回答流程仍需在配置好模型的环境中验收。

0.2.1：补充真正 Electron 桌面壳验收。0.2.0 的上述界面检查使用的是宿主 Web profile，未覆盖桌面完整快捷键目录；安装桌面版后发现默认键与 `workspace.files (web:macos)` 冲突，造成客户端 entry 激活失败，桌面壳随之退出。默认键改为 Ctrl+Alt+Shift+P，注册冲突时降级为未绑定命令，再失败时仅停用可选快捷键，保留设置页和宠物栏。31 项自动测试通过，覆盖跨平台冲突不阻断启动。隔离 DSH_HOME 与独立 Electron 用户数据中实际启动桌面壳，验证“更多 → 设置 → 宠物伙伴”、两个角色图集、切换与快速聊天入口，并保存桌面截图。

按用户要求，将 0.2.1 通过安装包自带 CLI 安装到本机日常 `desktop` profile，并复制配套 skill 到用户 DSH_HOME。真实日常配置启动后，打开“更多 → 设置 → 宠物伙伴”，确认两个角色卡片和宠物 API 正常；未修改既有模型插件、密钥或会话内容。此前失败的 0.2.0 已先移除，配置文件已在独立工作目录备份。


0.3.2：Windows 独立透明置顶窗口通过私有标准输入输出通道连接宿主插件；不增加网络监听，不修改 app.asar。独立窗口支持拖动、动作/目光、精简模式、显示偏好、快捷聊天及打开原生会话/设置。设置页改用宿主 Button/Input/Switch/SegmentedTabs 和原生配色。35 项自动检查通过；真实 Electron 隔离配置验证桌面窗口 active、主界面重复形象消失、五个原生开关、主窗口 isMinimized=true 时窗口仍 IsWindowVisible=true 且 WS_EX_TOPMOST=true。


1.0.0：底栏常驻且支持从宠物经过空隙移入按钮，改为中性配色、图标和紧凑圆角操作栏。修复 WPF 按钮内容绑定，并修复通用 CSS 覆盖 Harness 原生主按钮前景色及字号。桌面拖动改用鼠标捕获，传递左右方向，拖动期间循环播放跑动帧并压过注视/任务动作，松开后恢复任务状态；普通悬停不再无限跳跃。新增 `npm run test:native`，通过实际系统鼠标点击聊天、动态任务跳转、左右拖动各多个动画帧、应用内/精简切换和子进程退出验证；36 项自动检查通过。真实 Electron 设置页在浅/深色模式下检查主按钮文字及配色，原生控件与后台置顶保持正常。