# 验收记录

## 0.2.0（2026-10-19）

- 自动测试 70 项通过，含文件锁互斥、死进程锁接管、图片编辑只提交一次、视频编辑/延长/图生视频各提交一次、后台查询不重复提交。
- 插件详情页「能力」列表与上述工具一致。英文界面断言无中文残留。
- 未在本轮对公网网关或桌面内嵌播放器做新的端到端复测。图片编辑、视频编辑、延长、图生视频的请求体按 xAI REST（2026-04）实现，并用本地 mock 验收。
- 聊天路由仍捕获官方适配器实例后再调用公开 `registerAdapter`。`@deepseek-ai/dsh-llm-pi-ai@0.2.1-rc.2` 导出了 `PiAiAdapter`，但构造它所需的凭据存储和模型集合助手没有导出。

本文件分批记录：`0.1.0-alpha.1` 于 2026-10-16 在 Windows、Node.js 24、DeepSeek Harness `0.2.0-rc.2`、CLIProxyAPI `v8.0.30` 上完成端到端验收；`0.2.0-alpha.1` 于 2026-10-17 补充自动化回归与 dsh `0.2.1-rc.1` 运行环境复核，2026-10-18 补充设置页 GUI 实机验收。

## 0.2.0-alpha.2 复核（2026-10-18）

- 客户端 UI 接入 dsh 官方 locale 服务：设置页/工具卡片/播放器/只读提供商页随宿主语言切换。隔离 Web profile 实机核对：英文界面（en-US）显示 Connection / API address / API key / Get models / Chat models / Media models，中文界面（zh-CN）显示对应中文；两套文案由 106 个 key 的中英字典提供，切换语言无需刷新。README 设置页截图取自英文界面。
- 删除未使用的 `locale/build/*` 资源与导出；`npm pack` 清单不再包含该目录。
- 尝试把 devDependencies 的 `@deepseek-ai/dsh-llm` 升到 `0.2.1-rc.2` 会与 SDK 传递依赖的 peer 范围冲突、`npm ci` 失败，已回退 `0.2.0-rc.2`；运行时兼容仍由 `engines.dsh` 控制，63 项测试与 `npm ci` 全绿。
- 发布工作流新增 `market/index.json` 自动更新（创建 Release 后用 tag commit 更新并推送回 `main`）。

## 0.2.0-alpha.1 复核（2026-10-17 ~ 2026-10-18）

- Windows + Node.js 24：51 项自动测试全部通过，`npm run check` 通过，`npm run build` 产物与提交内容一致（CI 的 `git diff --exit-code -- lib/client.js` 门禁成立）。
- dsh `0.2.1-rc.1` 桌面 profile（本地 link 安装）：插件正常加载，`grok_models` 以 `verify_key=true` 返回 20 个模型，`/models` 返回 HTTP 200；聊天提供方注册与模型发现在该版本可用。
- 设置页保存对话模型会下发配置操作 `unset`；运行时 dsh-settings `0.2.1-rc.1` 的 `applyPathOp` 已实现该操作，清理旧 `media.defaultModel` 有效。
- GUI 实机验收（2026-10-18，chrome-devtools 浏览器工具，独立 CLI profile 复制 desktop 插件配置，不改动真实配置）：
  - 插件详情页正常渲染：显示 `v0.2.0-alpha.1`、连接字段、20 个模型发现成功、对话模型表格、媒体模型下拉，2 个组件运行中。
  - 对话模型删行后保存：配置 `modelOverrides` 真实移除该模型，表格同步减少。
  - 媒体模型：选中 ID 即启用（无独立「启用」勾选框），保存后三个媒体模型保留在配置中。
  - 清空 API 地址：输入框回显默认地址；保存地址成功并写入默认地址。
- GUI 验收发现并修复真实 bug：详情页保存把 `remote.settings.mutate` 返回的 `{ ok, value: namespace view }` 当成配置节写入 `loaded`，导致保存后媒体模型回退显示「不使用」、revision 不前进、下一次保存报配置冲突。`src/client.js` 的 `commit()` 已解包 namespace view，并新增回归测试。
- 2026-10-18 在桌面 dsh `0.2.1-rc.2` 运行环境中复核：插件正常加载，`grok_models`（`verify_key=true`）返回当前网关模型清单，`grok_generate_image` 以显式 image 模型真实生成并保存 1 张 JPEG（用于 README 展示素材）。`engines.dsh` 与 0.2.1 预发布版本在 dsh 的 `includePrerelease` 比较下匹配。
- README 截图来自隔离 DSH_HOME 的独立 Web profile（英文界面）：插件页显示 `Grok ByAPI` 已安装（英文描述、新图标）与两个组件 `grok-byapi`、`dsh-grok-imagine` 均为 Running；亮/暗主题下图标均可见。设置页表单文案本轮仍为中文（客户端 UI 尚未接入 locale 服务，列入待办）。
- 未复测：端到端媒体生成与播放（仍引用下方 `0.1.0-alpha.1` 记录）；桌面 App 内嵌窗口未直接操作，采用同配置独立 Web profile 验收。

## 0.1.0-alpha.1 已通过（2026-10-16）

- 当时的 11 项自动测试：模型分类、手动覆盖、地址校验、官方适配器工具调用往返、图片自动保存、下载失败后的重启恢复、视频原任务恢复、跨会话隔离、提交未知不重发、TTS 保存、无效输入与错误媒体拒绝。
- 独立 headless profile：原生 Grok 提供方实际聊天成功。
- 独立 headless profile：模型实际调用 `grok_models` 工具并继续回答成功。发现 20 个模型：chat 11、image 3、video 3、speech 2、research 1；未声称每个模型都已可用性验证。
- 独立 headless profile：调用图片工具，真实生成 1 张 JPEG 并自动保存本地。
- 媒体模块真实请求：TTS 返回 MP3 并保存；2 秒视频提交、查询至 `done`/100%，下载保存为 MP4，插件状态为 `saved`。
- 独立 Web profile：前端实际加载；聊天选择器显示 Grok 分组，只有 11 个聊天模型，没有图片、视频和 TTS。
- 独立 Web profile：插件详情的配置入口、字段显示与保存成功。真实将测试 profile 的超时改为 31000ms 并回读确认。
- 独立 Web profile：工具调用记录展开后，专用 Grok 模型卡片显示 20 个模型的分类。
- 独立 Web profile：通过 dsh 文件交付打开本地 MP4 与 MP3，在插件侧栏播放器点击播放。视频时长 2.041667 秒、音频时长 2.928 秒，均实际播放至结束，readyState=4，媒体 error=null。

## 安装路径复核（2026-10-16，独立环境）

在另一台环境按发布路径重新走通，并把结果用于修复打包缺陷：

- 仅用提交内容的干净克隆 → `npm install --ignore-scripts` 11.4 秒装好 118 个包（全部来自公共 registry）→ 当时的 11 项测试通过 → `npm run build` 产物与仓库一致。
- 隔离 `DSH_HOME` 的全新 profile：`dsh plugin add <源码目录>` 0.7 秒完成，自动写入该 profile 的 `dsh.profile.bundles`，不需要手工编辑。
- `npm pack` 产物（模拟已发布包）：`dsh plugin add <tgz>` 后启动成功，插件页显示组件 `grok-byapi`（当时名 `grok-all`）运行中，客户端 bundle 正常加载并被 GUI 请求，配置页 8 个字段可读可存，聊天选择器出现 11 个 chat 模型，图片、视频、TTS 未混入。
- `npm publish --dry-run --tag alpha` 通过：`prepublishOnly` 先跑测试与语法检查，再打包。未真正发布。
- 公网仓库安装（提交 `4e96636`、标签 `v0.1.0-alpha.1`；仓库当时名为 `dsh-grok-all`，现为 `dsh-grok-byapi`）：`dsh plugin add "git+https://github.com/NingYuanLee/dsh-grok-all.git"` 5.8 秒完成，插件组件运行中，客户端 bundle 被 GUI 请求，聊天选择器出现 11 个 chat 模型。
- 本次修复：补 `LICENSE` 与 `license`/`author`/`homepage`；适配器注册失败的真实原因不再被通用提示覆盖并写入 warn 日志；`@deepseek-ai/dsh-llm` 由隐式依赖改为显式 devDependency；新增 `.gitattributes` 固定 LF；CI 增加 Windows 矩阵与发布门禁；测试断言捕获到的是官方 `LlmAdapter` 实例与 `providerInfo`。

## 当前限制与待验收

- 真实请求测试走本地网关；未逐项测试公网媒体接口、极大文件或超时边界。
- 桌面应用中的媒体播放尚未单独验收；已验收独立 Web profile。
- 使用完整字节的侧栏预览，非大视频流式播放；编解码和大小限制取决于 dsh 与浏览器。
- 视频查询由工具显式触发，无自动后台轮询、自动完成通知或持续刷新的任务中心。
- 任务模块支持进程重启后的显式恢复；没有实现多个 Host 进程同时操作同一数据目录的跨进程锁。
- 图片编辑、视频编辑/延长、语音识别、实时语音、直接 OAuth 尚未实现。
- 上游未提供完整能力元数据；规则识别不是端到端验证。特别是历史模型和研究类模型，不保证与普通 Agent 工具兼容。
- 聊天协议复用官方适配器，并捕获其公开入口构建的适配器实例；依赖其注册约定，升级 dsh 时必须重跑集成测试。
- 仅逐版验证指定 dsh 版本。已安装到日常 desktop profile（本地 link 安装，密钥经凭据库 `GROK_ALL_API_KEY` 引用，热加载后无需重启即可发现模型）；未迁移旧 `local-grok`；npm 账号注册受阻，发布到 npm 推迟，当前以仓库安装分发。

## 不公开的测试材料

独立 profile、日志、凭据引用的运行环境和生成物均位于被忽略的本地测试目录。调用密钥不进入源代码、仓库、任务公开结果或第三方媒体下载请求。