# 0.2.1：上架包装 / Marketplace packaging（2026-10-05）

0.2.1 只更新包元数据与中英文说明；全部 src/lib 与 local.9 一致，没有增加缓存迁移或改变宽松 DSH peer 准入。三份运行入口逐字节对照 2026-10-03 最终验收包与公开 v0.2.1-local.9 资产。公开旧 tgz 的 SHA256 为 `a85e5fdda47aeb7922eb943822d54a022ef240a335935a48daf338251712b39e`；发布说明变化导致它与早期验收 tgz 的整体哈希不同，不代表运行代码改变。

Version 0.2.1 changes package metadata and documentation only. All source/runtime bytes match local.9. The earlier UI evidence is reused through runtime-byte parity; it is not described as a new native or cross-platform test.

| 层级 / Layer | 范围 / Scope |
| --- | --- |
| 本轮包装 / Packaging | Bundle manifest、三入口、依赖、双语 README、三份 MIT 许可及 provenance；不包含 SDK/开发链接、绝对运行路径或安装构建脚本 |
| 本轮安装 / Installation | 固定 tgz 在独立 rc.2 profile 上通过实际 CLI、Loader/快照及安装生命周期检查；精确哈希与机器回执随发布交付 |
| 复用统计逻辑 / Reused logic | 2026-10-03 local.8 的 77 项测试与 local.9 的 30 项客户端检查；Host/Typert 与 local.8 一致 |
| 复用界面 / Reused UI | 2026-10-03 最终 local.9，371 颗粒、24 小时、准确悬停和零用量、移出关闭、深浅主题；640px 下小时区宽度/滚动宽度均为 351 |
| 宿主来源 / Host | 基于 DSH 0.2.0-rc.2 的 Missher SDK/桌面；使用官方公开接口，不调用 SDK 新增的私有删除或插件清单扩展 |
| 平台 / Platform | macOS Intel；Windows/Linux/Apple Silicon、纯官方完整应用和官方 alpha.1 未独立验收 / not independently verified |

本次不更改日常应用、profile、会话、学习库或凭据，不调用真实模型。新版本发布与市场合并由协调者处理；准备好安装包不等于已经上架。

No daily installation or user data is changed by this packaging task. A prepared archive, a published Release, a merged catalog PR and a searchable listing are separate acceptance stages.

以下保留历史验证，旧路径和当时安装状态不表示当前状态。

# 0.2.1-local.9：小时活动去框（2026-10-03，历史）

本次只修改小时活动区域的 CSS，去掉边框、底色、圆角和内边距；保留原生 Tooltip、24 小时数据、刷新和配色。验证重点为隔离类型检查/客户端测试/构建、实际 Host 加载、鼠标移入即显示准确数值、移出关闭，以及深浅主题和桌面窄窗口。精确包校验值、当轮结果与截图见独占回执 `coordination/2026-10-03/usage-hourly-frameless/DELIVERY.md`。

下面的 .8 记录为上一轮完整功能验证；不冒充本轮重测。日常 Electron 安装和原生点击由协调会话负责，本会话的浏览器检查仅代表隔离 Host。测试数据不是用户实际用量。

# 0.2.1-local.8：今日小时活动与配色（2026-10-03，历史）

本轮仅使用 0.2.0-rc.2 已构建 SDK，日常仍是 0.2.1-local.7；没有更新日常应用/profile 或调用模型。证据和精确交付路径见协调目录 `coordination/2026-10-03/usage-hourly/DELIVERY.md`。

- 静态/逻辑：隔离类型检查、构建、77 项测试通过。覆盖本地零点、DST 重复/跳过时段、继承前缀、重复结算去重、非法用量、跨会话汇总、24 桶及日期切换；新 UI 覆盖空图、准确用量、键盘、刷新与配色保留。
- Loader/通信：实际 CLI 在隔离 profile 安装，0.2.0-rc.2 Host 服务和 Client 资源正常；快照为 30,000 Token、76% 缓存命中，小时合计同为 30,000。把旧 v3 派生行交给新版后重建到 v4；重启/卸载/重装保持会话原始字节，域版本仍为 1。
- 受控 UI：IAB 通过正常认证入口连接实际隔离 Host，设置中可见 371 个原颗粒与 24 小时图；三种颗粒模式、精确小时提示、方向键、配色菜单/Escape 归焦、预设/恢复主题色、刷新、重载后保留颜色均通过。深浅主题、默认 1280×720 和 760/640 像素桌面窄窗口检查通过；640 像素时图表 clientWidth/scrollWidth 同为 349，菜单在视口内。浏览器 error/warn 为零。
- 本地目录：裸解压目录因缺少 Cordis 等运行依赖无法加载；交付的本机目录补齐 7 个只读 SDK 依赖链接。目录安装复验使用该已准备目录；分发到其他电脑仍推荐 tgz。验收脚本回执改为临时文件写完后原子改名，避免把刚创建的空文件当成完整 JSON。
- 边界：390 像素外层窗口下，宿主固定设置侧栏把内容压至约 100 像素，未作为通过项。本插件不改宿主设置布局。自定义颜色的状态/持久化经组件验证，操作系统原生取色器未单独自动化。日常 Electron 原生 UI 和真实模型调用没有验收；受控浏览器不冒充原生点击。

首次使用新版会重建统计派生缓存；不清理原始会话或沿用缺失小时数据的旧浏览器快照。现有颜色键保留。界面示例和测试数据来自隔离 fixture，不是用户账户账单。

以下为历史验证记录，版本和状态不代表本轮。

# 0.2.1-local.3 颗粒改色验证

2026-09-29，UI-04 最新范围仅改色，保留 DSH 0.2.0-rc.1 兼容升级。0.2.1-local.2 因扩大界面范围作废，其包和证据保留，不作为本候选验收。

- 基于开始备份恢复原组件、语言、控件、布局、月份标签、依赖和构建脚本，65 个文件逐一校验。
- 产品补丁仅调整原颗粒颜色分档和背景：零用量透明，正值由淡到深；三种视图仍是原 53 × 7 颗粒，不新增图例和说明。
- 隔离候选类型检查、构建及 22 项相关测试通过（图表 3、样式 3、原组件 11、兼容准入 5）。
- 真实 CLI/Loader、原版与改色版同数据界面对照及冻结包 SHA，分别记录于候选 `verification/profile-tarball.json`、`verification/ui-color-comparison.json`，并汇总至维护源码 `verification/ui-20260929-color-only.json` 和 UI-04 独占协调回执。以这些本轮证据为准，不复用作废包结果。
- 原生 Electron、日常数据和多插件组合验收由协调会话接手；本会话不调用真实模型，不改日常安装，不进行 Git 发布。

# 0.2.1-local.1 兼容升级验证记录（历史）

2026-09-29。目标 **DSH 0.2.0-rc.1**，统一源码及只读构建 SDK 基线 `c7c457e5e07fa11a04bf8764d5f89585d789f258`，上游基线 `4878cdabd87d4041bdaff61d04c966883b9fd07a`。候选位于 `.verification/upgrade-020/candidate`；本轮不重建维护目录或旧日常链接目录的 `lib`，不安装到日常应用。

| 层级 | 结果 | 范围 |
| --- | --- | --- |
| 类型检查 | 通过 | 原统计源码直接对匹配 SDK 做 `tsc --noEmit`，无需修改业务实现 |
| 既有行为测试 | 61/61 通过，10 个文件 | 聚合、日期、重试/继承去重、服务、组件、样式、快照缓存、通信描述和真实 Loader 组合 |
| 真实宿主版本检查 | 5/5 通过，1 个文件 | 接受 0.2.0-rc.1；拒绝 0.1.7-rc.2、0.2.0、0.2.1-rc.1；旧 0.2.0 插件仍被新版宿主拒绝，未添加豁免 |
| 隔离构建和打包 | 通过 | 匹配 SDK 生成 Host/Client/Typert 三入口，许可证和 Bundle 配置齐全 |
| tarball / 实际 CLI / Loader | 通过 | pnpm 11.7.0 离线安装到临时 profile；完整 Web profile 启动后读取 `usageStatistics.snapshot()`，得到 30,000 Token、76% 缓存命中率 |
| 重启、卸载和重装 | 通过 | 会话和派生缓存原始字节不变；卸载后服务撤销、配置恢复，重装后统计值恢复 |
| 既有缓存格式 | 保持 | `missher_usage_statistics` 域版本 1、行格式版本 3、浏览器缓存键不变；未加入迁移或清空逻辑 |
| 当前候选的实际页面 / 浏览器 RPC | 未验收 | CUA/IAB 访问隔离 Host 返回 `net::ERR_BLOCKED_BY_CLIENT`，停止尝试并关闭 Host，交前台协调会话验收 |
| 日常原生应用、多插件共存、用户历史库 | 未验收 | 由协调会话统一安装检查；本会话没有操作日常数据或应用 |

66 项测试来自上述两个独立测试组。Host 快照读取和 wire 测试不等同于浏览器 RPC 端到端通过。合成 V4 会话与旧验证同口径，不包含用户真实数据或供应商请求。本轮运行时代码未修改 `src/`，旧入口及日常目录字节保留；最终 tgz 的三入口与隔离构建输出逐字节绑定，具体哈希见外部验收回执及包旁 `SHA256SUMS`。

机器可读汇总为 `verification/upgrade-020.json`，运行日志与 profile 在 `.verification/upgrade-020/candidate`。首次隔离副本同步路径错误曾导致旧清单准入测试失败；该临时输出保留在 `.verification/upgrade-020/first-attempt`，修正同步路径后的 5 项准入测试通过，该旧临时包不交付。

尚未验证其他 DSH 版本、Windows/Linux 原生界面、真实供应商、旧日志迁移或大历史库性能。以下旧验收记录仅保留历史，不能替代 0.2.0-rc.1 的页面和日常安装验收。

## 0.2.0 验证记录（历史）

2026-09-26。目标：macOS x64 **DSH / Desktop 0.1.7-rc.2**。适配参考源码 SHA：`e3409377ac873963595b76c0eb9afd8a8aa241af`。原始统计代码来源仍记录在 `provenance.json`。所有插件修改和验证数据位于本独立仓库，宿主源码未修改。

| 层级 | 结果 | 范围 |
| --- | --- | --- |
| 类型检查 | 通过 | 新版 Cordis Context、api-remotes、Renderer 类型以及 Typert schema 工厂 |
| 自动化测试 | 64/64 通过，11 个文件 | 统计、日期、组件、缓存、真实 Loader/Remote；真实版本检查接受 0.1.7-rc.2，拒绝未适配的旧版和未来版本 |
| tarball 安装与卸载 | 通过 | 匹配版本的实际 CLI 安装包，启动完整 Web profile，移除后配置逐字恢复，独立服务撤销 |
| 本地目录安装与卸载 | 通过 | 实际 CLI 链接当前插件根目录，读取 30,000 Token 与 76% 缓存命中率，卸载后合成会话文件哈希不变 |
| 原生界面安装 | 通过 | 插件页输入绝对路径，安装后显示 0.2.0，点击「立即启用」；未添加版本豁免 |
| 原生统计页面 | 通过 | 设置中一个统计入口，371 个格子，每日/每周/累计切换，真实 Remote 返回隔离合成历史的统计值 |
| 原生界面卸载 | 通过 | 从插件详情确认卸载，等待操作完成后统计入口和 CSS 撤销，profile 移除 Bundle，合成会话字节不变 |

原生验收使用 0.1.7-rc.2 的未加自定义启动包装的参考应用，单独设置 DSH_HOME 和 Electron user-data-dir。用户当前 Intel 应用的启动包装固定日常数据目录，因此未用日常实例测试。对应用资源进行了逐文件比较：统计、插件管理和 UI 的运行时代码一致；Desktop Host 的唯一差异是监听端口由 19387 改为随机端口 0。壳层另有数据目录隔离和 URL 协议注册差异，详见 `verification/runtime.json`。原生测试使用 `dsh-app:` 协议。

合成 V4 会话有完整 turn/step 生命周期，包含 30,000 Token、76% 缓存命中率和 90 秒轮次。未加入 request/header，因此模型和推理强度显示「—」。没有调用真实模型、输入密钥或修改日常会话库。截图是测试数据，不是用户实际用量。

兼容性修复包括：DSH peer 固定为 0.1.7-rc.2；宿主提供 Cordis 4.0.4 和 Schemastery 3.18.4；Typert `schema` 改为 `create()` 工厂；Client 使用 Cordis Context 和 api-remotes；移除已经不存在的内置统计页覆盖。0.1.7-rc.2 卸载后撤销新增页面，不恢复旧版内置页面。

机器可读报告在 `verification/`，原生截图在 `output/playwright/0.2.0/`。`entrySha256` 绑定原生测试和最终安装包的运行时代码。原 0.1.0 的验证归档在 `verification/0.1.0/`，只适用于旧版宿主。

未验证 Windows/Linux 原生 UI、其他 DSH 版本、其他统计插件共存、用户真实历史库或大量历史记录的首次扫描性能。旧日志格式的读取和迁移行为属于宿主持久化服务，不以合成 V4 测试推断其结果。