dsh-theme-splat-ui 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/LICENSE +21 -0
  3. package/README.ja.md +160 -0
  4. package/README.ko.md +160 -0
  5. package/README.md +159 -2
  6. package/README.zh.md +160 -0
  7. package/THIRD_PARTY_NOTICES.md +50 -0
  8. package/assets/icon-256.png +0 -0
  9. package/cordis.patch.yml +5 -0
  10. package/docs/acceptance-results.json +343 -0
  11. package/docs/acceptance.md +50 -0
  12. package/docs/compatibility.md +34 -0
  13. package/docs/design.md +84 -0
  14. package/docs/screenshots/appearance-dark.png +0 -0
  15. package/docs/screenshots/appearance-light.png +0 -0
  16. package/docs/screenshots/attachment-dark.png +0 -0
  17. package/docs/screenshots/attachment-light.png +0 -0
  18. package/docs/screenshots/boot-light.png +0 -0
  19. package/docs/screenshots/composer-light.png +0 -0
  20. package/docs/screenshots/hero-dark.png +0 -0
  21. package/docs/screenshots/hero-light.png +0 -0
  22. package/docs/screenshots/input-menu-dark.png +0 -0
  23. package/docs/screenshots/input-menu-light.png +0 -0
  24. package/docs/screenshots/input-menu-mobile-dark.png +0 -0
  25. package/docs/screenshots/input-menu-mobile-light.png +0 -0
  26. package/docs/screenshots/plugin-disabled.png +0 -0
  27. package/docs/screenshots/plugin-reenabled.png +0 -0
  28. package/docs/screenshots/regression-tool-before.png +0 -0
  29. package/docs/screenshots/runtime-reading-dark.png +0 -0
  30. package/docs/screenshots/runtime-reading-light.png +0 -0
  31. package/docs/screenshots/runtime-reading-mobile-dark.png +0 -0
  32. package/docs/screenshots/runtime-reading-mobile-light.png +0 -0
  33. package/docs/screenshots/settings-dark.png +0 -0
  34. package/docs/screenshots/settings-light.png +0 -0
  35. package/docs/screenshots/settings-mobile-dark.png +0 -0
  36. package/docs/screenshots/settings-mobile-light.png +0 -0
  37. package/docs/screenshots/sidebar-light.png +0 -0
  38. package/docs/screenshots/theme-poster.webp +0 -0
  39. package/docs/screenshots/tool-result-dark.png +0 -0
  40. package/docs/screenshots/tool-result-light.png +0 -0
  41. package/docs/screenshots/tool-result-tail-dark.png +0 -0
  42. package/docs/screenshots/tool-result-tail-light.png +0 -0
  43. package/docs/screenshots/workspace-dark.png +0 -0
  44. package/docs/screenshots/workspace-light.png +0 -0
  45. package/lib/client.js +5211 -0
  46. package/lib/index.js +6 -0
  47. package/lib/palette.js +149 -0
  48. package/lib/tokens.js +381 -0
  49. package/lib/types/client/appearance.d.ts +78 -0
  50. package/lib/types/client/components/appearance-tab.d.ts +5 -0
  51. package/lib/types/client/components/brand.d.ts +9 -0
  52. package/lib/types/client/context.d.ts +47 -0
  53. package/lib/types/client/font-layer.d.ts +17 -0
  54. package/lib/types/client/index.d.ts +4 -0
  55. package/lib/types/client/install-appearance.d.ts +12 -0
  56. package/lib/types/client/install.d.ts +12 -0
  57. package/lib/types/client/slots.d.ts +9 -0
  58. package/lib/types/index.d.ts +2 -0
  59. package/lib/types/palette.d.ts +26 -0
  60. package/lib/types/tokens.d.ts +8 -0
  61. package/lib/types/types.d.ts +47 -0
  62. package/licenses/Nunito-OFL.txt +88 -0
  63. package/locale/en.json +6 -0
  64. package/locale/zh.json +6 -0
  65. package/package.json +118 -3
  66. package/screenshots.json +12 -0
package/README.zh.md ADDED
@@ -0,0 +1,160 @@
1
+ <div align="center">
2
+
3
+ <img src="assets/icon-256.png" width="96" height="96" alt="SPLAT-STREET icon" />
4
+
5
+ # SPLAT-STREET · DSH 墨街主题
6
+
7
+ [English](README.md) · **简体中文** · [日本語](README.ja.md) · [한국어](README.ko.md) · [宣传页与组件图鉴](https://shirolin.github.io/dsh-theme-splat-ui/) · 作者:[Shirolin](https://github.com/Shirolin)
8
+
9
+ [![check](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml/badge.svg?branch=main)](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/check.yml)
10
+ [![pages](https://github.com/Shirolin/dsh-theme-splat-ui/actions/workflows/pages.yml/badge.svg?branch=main)](https://shirolin.github.io/dsh-theme-splat-ui/)
11
+ [![version](https://img.shields.io/badge/version-0.1.0-1edc00?labelColor=141413)](CHANGELOG.md)
12
+ [![npm](https://img.shields.io/npm/v/dsh-theme-splat-ui?color=1edc00&logo=npm&logoColor=white&labelColor=141413)](https://www.npmjs.com/package/dsh-theme-splat-ui)
13
+ [![DSH Target](https://img.shields.io/badge/DSH_Web-0.2.2--rc.1_·_Desktop_0.2.2--rc.5-ff2d8a?labelColor=141413)](docs/compatibility.md)
14
+ [![license: MIT](https://img.shields.io/badge/license-MIT-d3f510?labelColor=141413)](LICENSE)
15
+
16
+ [![Node.js](https://img.shields.io/badge/Node.js-%E2%89%A522.13.0-5FA04E?logo=nodedotjs&logoColor=white&labelColor=141413)](package.json)
17
+ [![pnpm](https://img.shields.io/badge/pnpm-11.1.2-F69220?logo=pnpm&logoColor=white&labelColor=141413)](package.json)
18
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.8.2-3178C6?logo=typescript&logoColor=white&labelColor=141413)](package.json)
19
+ [![esbuild](https://img.shields.io/badge/esbuild-0.25.6-FFCF00?logo=esbuild&logoColor=black&labelColor=141413)](package.json)
20
+ [![Biome](https://img.shields.io/badge/Biome-2.6.4-60A5FA?logo=biome&logoColor=white&labelColor=141413)](package.json)
21
+ [![ThemeRuntime](https://img.shields.io/badge/dsh--client--ui--theme-0.1.5--rc.3-1edc00?labelColor=141413)](docs/compatibility.md)
22
+
23
+ </div>
24
+
25
+ `SPLAT-STREET` 是 DeepSeek Harness(Web)的主题插件,用斯普拉遁 2 的涂地语言重绘工作台:近黑侧栏配洋红「新会话」胶囊,官方绿/奶油/洋红三色条纹画布铺白色鱿鱼纹、洋红/官方绿泼溅与网点,空会话 Hero 是一整幅自由漂浮的墨街插画,启动加载圈复刻特殊武器(大招)能量槽,Composer 是带洋红滴墨的黑色描边卡片。夜间模式保留同一套霓虹墨色,把广场换成炭黑。
26
+
27
+ 在线展示与组件图鉴:https://shirolin.github.io/dsh-theme-splat-ui/
28
+
29
+ > [!NOTE]
30
+ > 非官方粉丝主题,与 Nintendo(任天堂)及 DeepSeek 官方无隶属或背书关系。主题使用项目原创矢量鱿鱼/章鱼素材、基于游戏截图参考生成的广场插画,以及 SVG 装饰;素材来源、授权范围与第三方声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。插件仅消费 DSH 公开的 ThemeRuntime Token 与 Slot 接缝,上游升级后可安全降级回退。
31
+
32
+ ---
33
+
34
+ ## 界面预览
35
+
36
+ ![DSH 墨街主题 · SPLAT-STREET](docs/screenshots/theme-poster.webp)
37
+
38
+ > 2026-11-20,在真实 DSH `0.2.2-rc.1` Web 隔离 profile 中,安装本地 `.tgz` 后重新验收与截图。会话是确定性验收历史,未调用模型。首版验收范围为 Web;检查范围、限制及证据见 [验收记录](docs/acceptance.md)。
39
+
40
+ <details>
41
+ <summary>展开查看:日间 / 夜间工作台、设置、阅读面与 390px 窄屏实拍(真实 DSH DOM)</summary>
42
+
43
+ | 浅色模式 (Light) | 深色模式 (Dark) |
44
+ | --- | --- |
45
+ | ![真实 DSH 浅色工作台](docs/screenshots/workspace-light.png) | ![真实 DSH 深色工作台](docs/screenshots/workspace-dark.png) |
46
+ | ![真实 DSH 浅色设置](docs/screenshots/settings-light.png) | ![真实 DSH 深色设置](docs/screenshots/settings-dark.png) |
47
+ | ![浅色阅读面](docs/screenshots/runtime-reading-light.png) | ![深色阅读面](docs/screenshots/runtime-reading-dark.png) |
48
+ | ![浅色 390px 窄屏](docs/screenshots/runtime-reading-mobile-light.png) | ![深色 390px 窄屏](docs/screenshots/runtime-reading-mobile-dark.png) |
49
+
50
+ </details>
51
+
52
+ 真实 CSS 组件图鉴位于 `site/showcase/index.html`(在线访问:https://shirolin.github.io/dsh-theme-splat-ui/showcase/ ),基于版本固定的 DOM 夹具生成,可在其中交互查看大招能量槽启动卡及各状态边界。
53
+
54
+ ---
55
+
56
+ ## 设计与实现机制
57
+
58
+ - **昼夜两套战场**:日间是官方绿/奶油/洋红三色条纹画布,压着白色鱿鱼纹、洋红/官方绿泼溅与网点,右下角是白鱿鱼 + 条形码贴纸;夜间是炭黑画布,同一组泼溅与鱿鱼纹压暗后保留霓虹感。
59
+ - **侧栏即主场**:近黑底、透明品牌头(洋红鱿鱼 + 白色 `SPLAT-STREET` + 官方绿斜纹)、独立洋红「新会话」胶囊、官方绿选中行(右端带墨点尾)、底部危险条纹与硬偏移阴影。选中行用黑字,保证对比度。
60
+ - **Hero 场景与大招能量槽启动页**:SVG 场景中嵌入基于 Inkopolis Square 游戏截图参考生成的透明 PNG 广场插画,叠加 `2` 招牌、`SPLAT-STREET` 胶带与墨迹装饰(夜间两侧鱿鱼),搭配白色描边硬偏移标题与 `>>>` 速度块;启动页保留顶部鱿鱼印章,并将进度圈设计为 24 格斯普拉遁特殊武器(大招)能量槽。
61
+ - **Composer**:黑色 2.5px 描边 + 内圈细线、网点、硬阴影、右上洋红滴墨;附件是白纸圆盘,官方绿圆形发送键带洋红涟漪。
62
+ - **外观设置**:`设置 → 插件 → 墨街外观` 提供「纸白 20% / 均衡 50% / 涂地 100%」三档、`0%–100%` 正向画布墨度滑杆(自动映射到 `--splat-canvas-veil`)、三档主墨色(默认官方绿 `#1edc00` / 荧光绿 `#9ae528` / 黄绿 `#d3f510`)、diff 语法(霓虹/中性)、装饰/网纹/字体开关与重置。偏好保存在当前客户端的 `localStorage`。
63
+ - **构建期内嵌**:Nunito Latin WOFF2(400–900)及主题使用的 SVG、PNG 素材在构建时内嵌到 `lib/client.js`,运行时无需外部下载。
64
+
65
+ ---
66
+
67
+ ## 安装
68
+
69
+ 同一 profile 下建议只启用一个主题插件。
70
+
71
+ ### npm 安装(推荐)
72
+
73
+ ```sh
74
+ cd <DSH_Profile_目录>
75
+ pnpm add dsh-theme-splat-ui
76
+ ```
77
+
78
+ 安装后完整重启 DSH 服务(桌面版请重启 DeepSeek Harness)并刷新页面。
79
+
80
+ ### GitHub Release / 离线 `.tgz`
81
+
82
+ 从 [GitHub Releases](https://github.com/Shirolin/dsh-theme-splat-ui/releases) 下载 `dsh-theme-splat-ui-<version>.tgz`(或在本仓库执行 `pnpm run release 0.1.0` 生成安装包):
83
+
84
+ ```sh
85
+ cd <DSH_Profile_目录>
86
+ pnpm add file:<下载目录>/dsh-theme-splat-ui-<version>.tgz
87
+ ```
88
+
89
+ ### 本仓库安装
90
+
91
+ ```sh
92
+ pnpm install
93
+ pnpm run build
94
+ cd <DSH_Profile_目录>
95
+ pnpm add file:<本仓库绝对路径>
96
+ ```
97
+
98
+ `cordis.patch.yml` 负责把包挂进 profile 的插件列表;`package.json` 的 `dsh.client.inject` 声明对 Theme / Renderer / Sidebar / Conversation 的依赖顺序。
99
+
100
+ ---
101
+
102
+ ## 开发与验证
103
+
104
+ 环境要求:**Node.js ≥ 22.13.0**,**pnpm 11.1.2**(工具链版本:`TypeScript 5.8.2`、`esbuild 0.25.6`、`Biome 2.6.4`、`lightningcss 1.29.2`)。流程细节见 [CONTRIBUTING.md](CONTRIBUTING.md)。
105
+
106
+ ```sh
107
+ pnpm install --frozen-lockfile
108
+ pnpm run check # 完整门禁:站点检查 + 类型 + 构建 + 单元/契约测试 + DSH 兼容性核对
109
+ pnpm run format:check # Biome 格式检查
110
+ pnpm run lint # Biome 静态检查
111
+ pnpm run check:fixtures -- --expect-dsh 0.2.2-rc.1
112
+ pnpm run showcase # 重新构建 site/showcase/generated/
113
+ pnpm run audit # 覆盖率诊断
114
+ pnpm run release 0.1.0
115
+ pnpm run install:local -- --dry-run
116
+ ```
117
+
118
+ `pnpm run demo` 仍可生成设计演示至 `artifacts/demo/`,不会覆盖真实宿主截图。
119
+
120
+ 子路径导出:
121
+
122
+ ```ts
123
+ import { SPLAT_UI_PALETTES } from 'dsh-theme-splat-ui/palette'
124
+ import { buildTokenOverrides, contrastRatio } from 'dsh-theme-splat-ui/tokens'
125
+ ```
126
+
127
+ ---
128
+
129
+ ## 文档导航
130
+
131
+ - [设计语言与样式边界 (docs/design.md)](docs/design.md):实现分层、主墨色预设、对比度门槛与部件设计
132
+ - [DSH 兼容性契约 (docs/compatibility.md)](docs/compatibility.md):公开 Slot、`data-*` / ARIA 接缝清单与降级矩阵
133
+ - [验收范围与证据 (docs/acceptance.md)](docs/acceptance.md):真实 DSH `0.2.2-rc.1` Web 全量验收记录与边界说明
134
+ - [版本变更日志 (CHANGELOG.md)](CHANGELOG.md):各版本演进与修复记录
135
+ - [第三方与素材声明 (THIRD_PARTY_NOTICES.md)](THIRD_PARTY_NOTICES.md):原创矢量与参考素材来源及授权边界
136
+
137
+ ---
138
+
139
+ ## 贡献与问题反馈
140
+
141
+ - 参与开发前请先阅读 [贡献指南 (CONTRIBUTING.md)](CONTRIBUTING.md),了解接缝契约登记、夹具命令与发版校验流程。
142
+ - 欢迎通过 [GitHub Issues](https://github.com/Shirolin/dsh-theme-splat-ui/issues) 提交缺陷报告或改进建议。
143
+
144
+ ---
145
+
146
+ ## 许可与致谢
147
+
148
+ 项目代码与原创矢量素材按 [MIT License](LICENSE) 分发;内嵌的 Nunito 字体遵循 [SIL Open Font License 1.1](licenses/Nunito-OFL.txt)。其余素材来源、非 MIT 范围与第三方声明见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
149
+
150
+ ---
151
+
152
+ ## 支持与相关项目
153
+
154
+ 如果这套主题让你的日常编码环境更带感,欢迎点亮一颗 **Star**,或通过以下方式支持维护:
155
+
156
+ - **爱发电 (Afdian)**:[https://ifdian.net/a/shirolin](https://ifdian.net/a/shirolin)
157
+ - **Ko-fi**:[https://ko-fi.com/shirolin](https://ko-fi.com/shirolin)
158
+ - **作者的其他开源项目**:
159
+ - [Animal Island UI](https://github.com/Shirolin/dsh-theme-animal-island-ui) —— 动物森友会手账风 DeepSeek Harness 主题插件。
160
+ - [PostPress(印推)](https://github.com/Shirolin/postpress) —— 将 X(Twitter)推文与长串排版为纸质卡片的浏览器扩展。
@@ -0,0 +1,50 @@
1
+ # Third-party notices
2
+
3
+ ## Nunito
4
+
5
+ The client bundle embeds Nunito Latin WOFF2 files (weights 400–900) from
6
+ [`@fontsource/nunito`](https://fontsource.org/fonts/nunito) 5.2.7.
7
+
8
+ Copyright 2014 The Nunito Project Authors (https://github.com/googlefonts/nunito).
9
+
10
+ Nunito is licensed under the SIL Open Font License, Version 1.1. The full
11
+ license text is included at [`licenses/Nunito-OFL.txt`](licenses/Nunito-OFL.txt).
12
+
13
+ ## Splatoon
14
+
15
+ Splatoon and Splatoon 2 are trademarks of Nintendo. This project is an
16
+ unofficial, non-commercial fan theme. It is not affiliated with, endorsed by,
17
+ or sponsored by Nintendo.
18
+
19
+ The sidebar squid sticker (`brand-squid-pink.svg`), boot badge (`boot-squid.svg`),
20
+ squid/octopus vector silhouettes (`squid-solid.svg`, `squid-outline.svg`,
21
+ `octo-solid.svg`, `octo-outline.svg`), background patterns (`squid-pattern*.svg`,
22
+ `arena-bands.svg`), watermark (`squid-watermark.svg`), barcode sticker
23
+ (`sticker-barcode.svg`), website squids, and package icon (`assets/icon-256.png`)
24
+ are original project vector artwork covered by this repository's MIT license.
25
+ The earlier Nintendo raster placeholder (`brand-squid-official.png`) has been
26
+ removed.
27
+
28
+ `src/client/assets/inkopolis-square.png` is generated monochrome fan artwork created
29
+ with the built-in image generation tool using a user-supplied *Splatoon 2*
30
+ Inkopolis Square screenshot as a reference, and quantized to a `2172×724`
31
+ 16-color indexed transparent PNG (`~72 KB`). The raw reference screenshot
32
+ (`inkopolis-square-reference.png`) and intermediate generation drafts have been
33
+ excluded from the repository. The reference screenshot's original creator,
34
+ acquisition URL, and redistribution permission were not recorded, and the
35
+ artwork depicts *Splatoon 2* plaza silhouettes.
36
+
37
+ Accordingly, **`src/client/assets/inkopolis-square.png` is NOT covered by this
38
+ repository's MIT license**; it is included solely as unofficial, non-commercial
39
+ fan-theme artwork. The MIT license applies only to original project code and
40
+ original project assets, and does not grant rights to Nintendo trademarks, visual
41
+ designs, or third-party material.
42
+ ## Validation tooling and static component catalogue
43
+
44
+ The runtime extractor, fixture runner, compatibility and coverage checks,
45
+ local installer, release verifier and catalogue shell are adapted from
46
+ Shirolin's `dsh-theme-animal-island-ui` project (MIT).
47
+ The generated catalogue includes CSS extracted from DeepSeek Harness
48
+ 0.2.2-rc.1 packages, whose package metadata declares MIT.
49
+ These files are prefixed with source notices.
50
+ Nunito embedded by the catalogue remains covered by the OFL notice above.
Binary file
@@ -0,0 +1,5 @@
1
+ # This package is mounted as an out-of-tree profile plugin.
2
+ # Keep both id and name: a bare id can override an existing row and no-op.
3
+ - insert:
4
+ - id: dsh-theme-splat-ui
5
+ name: 'dsh-theme-splat-ui'
@@ -0,0 +1,343 @@
1
+ {
2
+ "status": "pass",
3
+ "runtime": "DSH 0.2.2-rc.1 Web",
4
+ "profile": "isolated local profile, tarball install",
5
+ "modelRequests": 0,
6
+ "generatedAt": "2026-11-20T09:12:29.059Z",
7
+ "results": [
8
+ {
9
+ "name": "packed-bundle-loaded",
10
+ "passed": true,
11
+ "bundleSha256": "72a8511c5dc30ea5723079675075d88472709dabaa2ea2d96776be2b5b2c4b8e",
12
+ "build": "0.1.0 2026-11-20 07:43 UTC",
13
+ "installedFromTarball": true,
14
+ "runtimeCssMatchesSource": true
15
+ },
16
+ {
17
+ "name": "reading-light",
18
+ "passed": true,
19
+ "width": 1440,
20
+ "scrollWidth": 1440,
21
+ "code": true,
22
+ "table": true,
23
+ "bannerRatios": [17.214204737644273, 17.214204737644273, 17.214204737644273],
24
+ "codeRatio": 17.214204737644273,
25
+ "composer": {
26
+ "x": 469.296875,
27
+ "y": 826,
28
+ "width": 774.390625,
29
+ "height": 144,
30
+ "top": 826,
31
+ "right": 1243.6875,
32
+ "bottom": 970,
33
+ "left": 469.296875
34
+ }
35
+ },
36
+ {
37
+ "name": "input-menu-light",
38
+ "passed": true,
39
+ "arrowDownChangesSelection": true,
40
+ "escapeCloses": true
41
+ },
42
+ {
43
+ "name": "settings-light",
44
+ "passed": true,
45
+ "visible": true,
46
+ "outline": "2px",
47
+ "offset": "-2px",
48
+ "mask": "none",
49
+ "clip": "none",
50
+ "width": 920,
51
+ "right": 1180,
52
+ "left": 260
53
+ },
54
+ {
55
+ "name": "appearance-light",
56
+ "passed": true,
57
+ "presets": [
58
+ {
59
+ "preset": "纸白",
60
+ "ink": 20
61
+ },
62
+ {
63
+ "preset": "涂地",
64
+ "ink": 100
65
+ },
66
+ {
67
+ "preset": "均衡",
68
+ "ink": 50
69
+ }
70
+ ]
71
+ },
72
+ {
73
+ "name": "attachment-light",
74
+ "passed": true,
75
+ "uploaded": true,
76
+ "removed": true,
77
+ "messageSent": false
78
+ },
79
+ {
80
+ "name": "tool-result-light",
81
+ "passed": true,
82
+ "expanded": true,
83
+ "finalLineVisible": true,
84
+ "contrastRatios": [15.576081165662153],
85
+ "tail": {
86
+ "scrolled": true,
87
+ "scrollTop": 570,
88
+ "scrollHeight": 744,
89
+ "clientHeight": 174,
90
+ "lastLine": {
91
+ "x": 542.296875,
92
+ "y": 564.5,
93
+ "width": 342.375,
94
+ "height": 13,
95
+ "top": 564.5,
96
+ "right": 884.671875,
97
+ "bottom": 577.5,
98
+ "left": 542.296875
99
+ },
100
+ "viewport": {
101
+ "top": 417.5,
102
+ "bottom": 591.5
103
+ },
104
+ "visible": true
105
+ }
106
+ },
107
+ {
108
+ "name": "reading-dark",
109
+ "passed": true,
110
+ "width": 1440,
111
+ "scrollWidth": 1440,
112
+ "code": true,
113
+ "table": true,
114
+ "bannerRatios": [18.076901057546227, 18.076901057546227, 18.076901057546227],
115
+ "codeRatio": 18.076901057546227,
116
+ "composer": {
117
+ "x": 469.296875,
118
+ "y": 828,
119
+ "width": 774.390625,
120
+ "height": 142,
121
+ "top": 828,
122
+ "right": 1243.6875,
123
+ "bottom": 970,
124
+ "left": 469.296875
125
+ }
126
+ },
127
+ {
128
+ "name": "input-menu-dark",
129
+ "passed": true,
130
+ "arrowDownChangesSelection": true,
131
+ "escapeCloses": true
132
+ },
133
+ {
134
+ "name": "settings-dark",
135
+ "passed": true,
136
+ "visible": true,
137
+ "outline": "2px",
138
+ "offset": "-2px",
139
+ "mask": "none",
140
+ "clip": "none",
141
+ "width": 920,
142
+ "right": 1180,
143
+ "left": 260
144
+ },
145
+ {
146
+ "name": "appearance-dark",
147
+ "passed": true,
148
+ "presets": [
149
+ {
150
+ "preset": "纸白",
151
+ "ink": 20
152
+ },
153
+ {
154
+ "preset": "涂地",
155
+ "ink": 100
156
+ },
157
+ {
158
+ "preset": "均衡",
159
+ "ink": 50
160
+ }
161
+ ]
162
+ },
163
+ {
164
+ "name": "attachment-dark",
165
+ "passed": true,
166
+ "uploaded": true,
167
+ "removed": true,
168
+ "messageSent": false
169
+ },
170
+ {
171
+ "name": "tool-result-dark",
172
+ "passed": true,
173
+ "expanded": true,
174
+ "finalLineVisible": true,
175
+ "contrastRatios": [12.657403751095565],
176
+ "tail": {
177
+ "scrolled": true,
178
+ "scrollTop": 570,
179
+ "scrollHeight": 744,
180
+ "clientHeight": 174,
181
+ "lastLine": {
182
+ "x": 542.296875,
183
+ "y": 564.5,
184
+ "width": 342.375,
185
+ "height": 13,
186
+ "top": 564.5,
187
+ "right": 884.671875,
188
+ "bottom": 577.5,
189
+ "left": 542.296875
190
+ },
191
+ "viewport": {
192
+ "top": 417.5,
193
+ "bottom": 591.5
194
+ },
195
+ "visible": true
196
+ }
197
+ },
198
+ {
199
+ "name": "mobile-light",
200
+ "passed": true,
201
+ "width": 390,
202
+ "scrollWidth": 390,
203
+ "composer": {
204
+ "x": 16,
205
+ "y": 694,
206
+ "width": 351,
207
+ "height": 120,
208
+ "top": 694,
209
+ "right": 367,
210
+ "bottom": 814,
211
+ "left": 16
212
+ },
213
+ "menu": {
214
+ "x": 19,
215
+ "y": 293,
216
+ "width": 345,
217
+ "height": 400,
218
+ "top": 293,
219
+ "right": 364,
220
+ "bottom": 693,
221
+ "left": 19
222
+ }
223
+ },
224
+ {
225
+ "name": "settings-mobile-light",
226
+ "passed": true,
227
+ "left": 0,
228
+ "right": 390,
229
+ "scrollWidth": 386,
230
+ "clientWidth": 386
231
+ },
232
+ {
233
+ "name": "mobile-dark",
234
+ "passed": true,
235
+ "width": 390,
236
+ "scrollWidth": 390,
237
+ "composer": {
238
+ "x": 16,
239
+ "y": 696,
240
+ "width": 351,
241
+ "height": 118,
242
+ "top": 696,
243
+ "right": 367,
244
+ "bottom": 814,
245
+ "left": 16
246
+ },
247
+ "menu": {
248
+ "x": 18,
249
+ "y": 294,
250
+ "width": 347,
251
+ "height": 400,
252
+ "top": 294,
253
+ "right": 365,
254
+ "bottom": 694,
255
+ "left": 18
256
+ }
257
+ },
258
+ {
259
+ "name": "settings-mobile-dark",
260
+ "passed": true,
261
+ "left": 0,
262
+ "right": 390,
263
+ "scrollWidth": 386,
264
+ "clientWidth": 386
265
+ },
266
+ {
267
+ "name": "plugin-lifecycle",
268
+ "passed": true,
269
+ "disabled": {
270
+ "styles": 0,
271
+ "brand": 0,
272
+ "attributes": []
273
+ },
274
+ "enabled": {
275
+ "styles": 1,
276
+ "brand": 1
277
+ }
278
+ }
279
+ ],
280
+ "sourceDateEpoch": 1795160586,
281
+ "baselineCommit": "7b43fe33eef114a6ab3812ae3d0e80be4e71b5a1",
282
+ "scope": {
283
+ "web": "real-host UI acceptance passed",
284
+ "desktop": "isolated tarball installation only; native GUI not accepted",
285
+ "modelAndToolCalls": "synthetic session history; no live provider calls"
286
+ },
287
+ "gates": {
288
+ "unitAndContractTests": 18,
289
+ "fixtureGroups": 18,
290
+ "fixtureVariants": 41,
291
+ "fixtureAssertions": 113,
292
+ "siteBrowserCases": 3,
293
+ "lintWarnings": 4
294
+ },
295
+ "siteBrowser": [
296
+ {
297
+ "page": "landing",
298
+ "width": 1440,
299
+ "scrollWidth": 1440,
300
+ "errors": [],
301
+ "video": true,
302
+ "badResources": [],
303
+ "installation": {
304
+ "visible": "cd <DSH_Profile_目录>\npnpm add file:/path/to/dsh-theme-splat-ui.tgz",
305
+ "copied": "cd <DSH_Profile_目录>\npnpm add file:/path/to/dsh-theme-splat-ui.tgz",
306
+ "label": "已复制"
307
+ }
308
+ },
309
+ {
310
+ "page": "landing",
311
+ "width": 390,
312
+ "scrollWidth": 390,
313
+ "errors": [],
314
+ "video": true,
315
+ "badResources": [],
316
+ "installation": {
317
+ "visible": "cd <DSH_Profile_目录>\npnpm add file:/path/to/dsh-theme-splat-ui.tgz",
318
+ "copied": "cd <DSH_Profile_目录>\npnpm add file:/path/to/dsh-theme-splat-ui.tgz",
319
+ "label": "已复制"
320
+ }
321
+ },
322
+ {
323
+ "page": "showcase",
324
+ "cards": 18,
325
+ "filtered": 1,
326
+ "width": 390,
327
+ "scrollWidth": 390,
328
+ "errors": [],
329
+ "frameErrors": [],
330
+ "darkSwitch": true,
331
+ "filter": true,
332
+ "appearanceBridge": true
333
+ }
334
+ ],
335
+ "release": {
336
+ "status": "local-pre-release-accepted",
337
+ "npm": "deferred by maintainer request",
338
+ "publicDistribution": "repository, CI, and Pages prepared; npm publish and v* tag deferred",
339
+ "pages": "pending workflow_dispatch deployment after push",
340
+ "commitAndPush": "pending commit and push to main",
341
+ "designGate": "GATE: OFF (no build active); project checks and browser acceptance recorded separately"
342
+ }
343
+ }
@@ -0,0 +1,50 @@
1
+ # 上线前验收记录
2
+
3
+ 2026-11-20 完成 DSH `0.2.2-rc.1` Web 全量验收与本地出包复验;2026-11-22 针对升级后的 DSH `0.2.2-rc.5` Windows 桌面端补充排查并修复侧栏「新会话」槽位包装、`[data-sidebar-scrollport]` 滚动容器背景遮挡与 `nav[aria-label]` 分隔线选择器,经 headless Chrome 实染(明/暗模式)与 Windows Desktop 实装验证通过,同步更新展示站、README 与发布文档以备打标发布。Web 逐项矩阵与几何数据以 [acceptance-results.json](acceptance-results.json) 为准。
4
+
5
+ ## 构建与宿主
6
+
7
+ - 真实宿主:DSH `0.2.2-rc.1` Web,独立配置目录与 Chromium profile;桌面补充验证:DSH `0.2.2-rc.5` Windows Desktop(`install:local -- --only desktop`)。
8
+ - 安装来源:`pnpm run release 0.1.0` 生成的 tgz,经 `install:local` 安装到隔离 profile;已确认不是源码目录链接。
9
+ - 验收前核对安装目录和仓库的 `lib/client.js` 字节,以及页面实际加载的完整 Skin CSS。
10
+ - 构建及最终重打包使用同一个 `SOURCE_DATE_EPOCH`。构建标记、bundle 指纹和逐项几何数据见机器结果;指纹指向客户端 bundle,不是 tgz 校验和。最终包会重新安装并核对同一 bundle。
11
+ - 会话历史由宿主的 Session、AssistantStreamAccumulator 和当前格式编码器生成,经严格恢复校验,共 32 轮。模型调用、工具结果均为合成历史;本轮没有模型请求或消息发送。
12
+
13
+ ## 真实宿主矩阵
14
+
15
+ | 范围 | 结果与证据 |
16
+ | --- | --- |
17
+ | 浅色 / 深色工作台 | 欢迎页招牌为 2,品牌与输入区正常:[浅色](screenshots/workspace-light.png) / [深色](screenshots/workspace-dark.png) |
18
+ | 长会话、代码与宽表格 | 正文、Markdown、代码操作栏可读;代码正文与操作栏对比度达到 4.5:1,页面未被宽表格撑宽:[浅色](screenshots/runtime-reading-light.png) / [深色](screenshots/runtime-reading-dark.png) |
19
+ | 设置页 | 墨黑导航、纸面表单与墨迹选中正常,键盘焦点环完整内收:[浅色](screenshots/settings-light.png) / [深色](screenshots/settings-dark.png) |
20
+ | 墨街外观 | 纸白 20%、均衡 50%、涂地 100% 的按钮与滑杆值一致,恢复默认后复验:[浅色](screenshots/appearance-light.png) / [深色](screenshots/appearance-dark.png) |
21
+ | 输入菜单 | 方向键改变选择,Escape 关闭:[浅色](screenshots/input-menu-light.png) / [深色](screenshots/input-menu-dark.png) |
22
+ | 附件上传 | 合成文本完成上传并可移除,未发送:[浅色](screenshots/attachment-light.png) / [深色](screenshots/attachment-dark.png) |
23
+ | 工具结果 | 轮次、工具分组和工具行可展开,45 行结果的末行可访问:[浅色](screenshots/tool-result-light.png) / [深色](screenshots/tool-result-dark.png) |
24
+ | 390px 阅读 | 页面无横向溢出,输入区保留在视口内:[浅色](screenshots/runtime-reading-mobile-light.png) / [深色](screenshots/runtime-reading-mobile-dark.png) |
25
+ | 390px 菜单 | 菜单四边位于视口内:[浅色](screenshots/input-menu-mobile-light.png) / [深色](screenshots/input-menu-mobile-dark.png) |
26
+ | 390px 设置 | 弹窗未横向溢出:[浅色](screenshots/settings-mobile-light.png) / [深色](screenshots/settings-mobile-dark.png) |
27
+ | 停用 / 重启用 | 停用后根属性、自有样式、外观属性和品牌清理;重启用后样式和品牌各一份:[停用](screenshots/plugin-disabled.png) / [恢复](screenshots/plugin-reenabled.png) |
28
+
29
+ 宿主插件开关异步保存期间会禁用。验收脚本等待开关状态提交并恢复可操作后再重启用,避免在资源刚清理时点到禁用按钮。
30
+
31
+ ## 离屏夹具与门禁
32
+
33
+ 离屏夹具使用同版本真实 CSS,覆盖代码作用域、真实工具输入输出卡片、纯文本预览、diff、模型搜索、长技能列表、设置导航、输入壳、启动/失败、toast 等边界。图鉴由同一套夹具重新生成;截图等待有限过渡完成,并保留实际使用的 SVG 图标定义。执行数量见机器结果的 `gates`。
34
+
35
+ 11 月 14 日修正的通用 pre 作用域、原始工具载荷底色、侧栏纯文本前景和深色 toast 对比度问题,本轮通过同一套夹具复验。
36
+
37
+ 真实工具结果保留已知回归的对照,并再次检查对比度和末行可访问性:[历史回归](screenshots/regression-tool-before.png) / [当前结果](screenshots/tool-result-light.png)。
38
+
39
+ 常规门禁的执行方法见 [CONTRIBUTING.md](../CONTRIBUTING.md),本轮通过结果见机器记录。新增一条安装复制回归测试:点击按钮后,剪贴板内容必须等于页面显示的本地 tgz 安装命令。展示站在 1440px 和 390px 下另行验证资源加载、横向溢出与复制反馈,并检查图鉴的日夜切换、筛选和外观桥接。Lint 命令通过,保留既有选择器顺序警告;覆盖审计用于定位后续排查线索。
40
+
41
+ ## 验收边界与上线条件
42
+
43
+ - 静态 API 门禁针对锁定的 UI 开发依赖;桌面分发的运行时不附完整类型声明,因此没有将它冒充为完整的新版 ABI 门禁。
44
+ - Web 矩阵验证范围为 DSH `0.2.2-rc.1`;Desktop profile 已安装验收并完成 Windows 原生标题栏与侧栏(`0.2.2-rc.5`)的明/暗实机验证,独立用量 WebView 仍未做自动化桌面 GUI 验收。
45
+ - 未验证真实模型流式输出、实际工具执行、附件发送后的模型处理、登录账户和计费接口。
46
+ - 覆盖率审计仍列出未覆写语义 Token 与未进夹具的组件;具体清单由 `pnpm run audit` 生成,优先补模型设置、插件库存与附件等表面。
47
+ - 远程仓库、常规 GitHub 检查与 Pages 展示站均已就绪;`v0.1.0` 公开 npm 发布需在仓库配置 `NPM_TOKEN`(并确认素材边界与声明无异议)后,由维护者授权推送与打标触发 `release.yml`。
48
+ - 旧官方光栅占位图已移除。广场底图原始游戏参考截图 `inkopolis-square-reference.png` 已从仓库移除,`src/client/assets/inkopolis-square.png` 已压为 16 色索引透明 PNG;其原始参考来源未记录且涉及原作广场剪影,已按非商用粉丝二创在 [第三方声明](../THIRD_PARTY_NOTICES.md) 中明确排除于 MIT 授权之外。
49
+
50
+ 本地候选包 `0.1.0` 已验证就绪,等待维护者确认发布凭据后提交、推送与打标上线。
@@ -0,0 +1,34 @@
1
+ # DSH 兼容性说明
2
+
3
+ ## 验证基线
4
+
5
+ 构建依赖锁定的客户端 UI 包与实际运行的 DSH 应用有不同版本号。兼容性门禁读取锁定 UI 包的声明与源码;Web 全量验收基线使用 DSH `0.2.2-rc.1`,并补充验证了 DSH `0.2.2-rc.5` Windows 桌面端侧栏结构与原生标题栏兼容性。实际验收范围见 [acceptance.md](acceptance.md)。
6
+
7
+ `pnpm run check:compat` 检查 ThemeRuntime 的 Token 覆写与 disposer、服务注入顺序、公开 Slot、CSS 消费的 data/ARIA 接缝、Token 是否存在,以及私有导入与 DOM 回退。登记及证据的单一事实源是 [seam-contract.mjs](../scripts/seam-contract.mjs),具体结果由命令输出。
8
+
9
+ ## 样式边界
10
+
11
+ 主题使用公开 Token、语义属性和自有 Slot 标记,生产选择器不依赖宿主构建哈希类名。品牌、欢迎页和设置页有结构选择器,宿主改动这些结构时需要重验布局。
12
+
13
+ - Markdown 的深色代码岛只落在 `data-code-block-banner` 和 `data-code-block-content`;插件原始 `pre` 载荷保留宿主文字和排版,其代码底色跟随日夜表面。
14
+ - 文档代码预览与纯文本预览保持独立排版;深色侧栏中的纯文本使用可读前景。
15
+ - 组合输入框由外壳承担描边与焦点,内部输入不重复套框。
16
+ - 设置导航的墨迹是按钮背景,焦点环位于按钮内部,点击区域保持矩形。
17
+ - 未匹配的可选接缝自然退回 Token 和宿主样式;必需接缝缺失使兼容性门禁失败。
18
+
19
+ ## 生命周期与 Windows 例外
20
+
21
+ 根标记、外观属性、内嵌样式、Token 覆写和品牌 Slot 随安装建立,随 dispose 恢复。真实宿主停用/重启用检查这些资源是否清理及是否只安装一次。宿主切换开关有异步保存阶段,应等待其状态提交并解除 disabled 后再操作。
22
+
23
+ Windows 原生标题栏需要同步宿主主题来源。安装器保留一个受限的 `MutationObserver`:仅观察 root 的主题来源和标题栏属性,以及 body 的深色属性;不监听子树或节点插入,dispose 时 disconnect。兼容性门禁检查这一边界。
24
+
25
+ Web 验收不覆盖原生 Windows 菜单、标题栏和其他独立 WebView;这些需要桌面客户端的补充验收。
26
+
27
+ ## DSH 升级时怎么处理
28
+
29
+ 1. 更新锁定依赖后运行 `pnpm run check:compat`,核对失效的探针及上游声明。
30
+ 2. 指定新运行时运行 `pnpm run check:fixtures -- --expect-dsh <version>`。夹具使用真实 DSH CSS,DOM 片段保留对应版本结构。
31
+ 3. 断言失败时先在真实宿主复现:接缝变了则更新契约和夹具;主题规则误伤则先修选择器。保留位置、对比度和焦点完整性等行为要求。
32
+ 4. 重生成 `pnpm run showcase`,运行 `pnpm run audit`,再更新真实宿主截图与验收记录。
33
+
34
+ 完整命令与发布步骤见 [CONTRIBUTING.md](../CONTRIBUTING.md)。`audit` 是诊断,列出的未覆盖组件不等于已确认缺陷,也不能作为这些界面已经通过的证据。