lengduan
dsh-815-skin
1945-08-15 世界名画 dsh皮肤
- Stars
- 0
- Language
- TypeScript
- Created
- Aug 15, 2026
- Updated
- Aug 15, 2026
Introduction
一九四五年八月十五日 · dsh-815-skin
DeepSeek Harness Web GUI 史料皮肤。对话区底图是陈坚油画《公元一九四五年九月九日九时》：1945-09-09 南京受降，日军代表弯腰递交投降书。侧栏挂《终战诏书》印刷件。
加载即生效，卸载即还原 DOM / CSS / document.title。不改会话、不调模型、不访问网络。
| 包名 | @lengduan/dsh-client-ui-skin-815 |
| 插件 id | ui-skin-815 |
| 平台 | web（dsh.client.platform） |
| 许可证 | MIT（代码）；油画著作权见 NOTICE |
文档结构对齐 awesome-dsh-plugins「给插件开发者」对合格 README 的最低要求。
Overview
解决什么： Web UI 默认浅色/默认底换成 1945 终战史料外观（油画底、诏书侧栏牌、选中会话青天白日小旗、标题栏品牌）。
适合谁： 本机跑 dsh web / --profile web、只想换皮的人。
不适合： TUI / headless；要改 agent 行为、工具权限或主题引擎配置的场景。宿主 apply() 为空，效果全在 client bundle。
Compatibility
| 项 | 声明 |
|---|---|
| 运行时 peer | @deepseek-ai/cordis ^4.0.1 |
| DSH 形态 | Web GUI profile（dsh web） |
| 最后本机验证 | 2026-08-15，Windows，加载后对话区油画可见、卸载后还原 |
| 静态检查 | pnpm test（jsdom：body 属性、背景、owned 节点撤回） |
| 未声称 | 未对照 awesome-dsh-plugins 某日 mainline SHA 做四维雷达；收录 ≠ 兼容 |
DSH mainline 几乎每日变。DOM class / token 漂移会导致皮失效或叠层。升级 DSH 后请再看一眼对话列是否被主题底色盖住。
Install / Uninstall
装进 web profile（从 npm 拉已构建包，不必 clone）：
dsh plugin --profile web add @lengduan/dsh-client-ui-skin-815
dsh plugin 把参数转给 profile 目录里的 pnpm，成功后把带 dsh.bundle 的包写进 dsh.profile.bundles。本包 patch 插入 id ui-skin-815。
升级：
dsh plugin --profile web update @lengduan/dsh-client-ui-skin-815
从源码开发：clone 后 pnpm install、pnpm build，再 dsh plugin --profile web add .。相对路径相对你执行命令时的当前目录。本地 link: / file: 安装时，改源码后重新 pnpm build；HMR 是否立刻刷皮取决于宿主 client 热更新。
禁用（不删依赖）： 在 web profile 的 cordis.patch.yml（或能盖过 bundle 层的 patch）把 ui-skin-815 设 disabled: true。effect 会整份撤回。
彻底移除：
dsh plugin --profile web remove @lengduan/dsh-client-ui-skin-815
依赖和 dsh.profile.bundles 层一并拿掉。重启 dsh web 后不应再有 data-dsh-815、史料牌、内嵌油画。
固定版本：用 commit / tag，不要依赖会漂移的未钉死分支。建议先在隔离 profile 试加载，再进日常 web profile。
Quick start
pnpm build且dsh plugin --profile web add .成功。dsh web，打开 GUI。- 最小验收：
document.body有data-dsh-815；对话区能看见南京受降油画；侧栏底部有诏书缩略；点卸载/禁用后上述全部消失。
无需额外配置文件、无需环境变量。
Configuration
无配置项、无环境变量、无密钥。外观写死在 client CSS / skin.json。
skin.json 只描述元数据（名称、作者、bodyAttr、wiring.id），运行时不读用户覆盖。
Permissions & data
| 面 | 行为 |
|---|---|
| 网络 | 无。底图与诏书在构建期 embed 进 client bundle（data URL） |
| 文件系统 | 运行时不读用户文件；构建读本仓 assets/ |
| 凭据 / 会话 | 不读 token、密钥、聊天内容 |
| DOM | 写 body 样式与 data-dsh-815；插入标题栏品牌、侧栏诏书图、宽度 stylesheet；给选中会话行打 data-vj-session* |
| 权限模型 | dsh.client.inject 为空；不申请宿主服务 |
卸载走 Cordis ctx.effect 销毁器：断 observer、还原 style、删 data-skin-owner="815" 节点、清会话标记。
Troubleshooting
| 现象 | 处理 |
|---|---|
| 装了没皮 | 确认装的是 web profile，且已 pnpm build（lib/client.js 存在）。headless 不会出这层 UI |
| 对话区一条水平线 / 油画被切 | 主题 token --dsw-alias-bg-base 盖住底图。确认本仓 CSS 已把 [data-phase='active'] 设透明；升级 DSH 后 class 名变了就要改选择器 |
| 禁用后还留着 | 硬刷新；查是否还有别的皮肤插件也在写 body 背景 |
加载报错缺 @deepseek-ai/cordis | peer 未满足。对齐 DSH 自带 cordis ^4.0.1 |
| 回滚 | remove 包或 disabled: true，保留 profile 原 package.json / lockfile 再装 |
日志：浏览器控制台 + 启动 dsh web 的终端。本插件不写独立日志文件。
Development
pnpm install
pnpm build
pnpm test
pnpm build 先 embed-art 再 tsdown。底图来自 assets/，生成 src/client/art.generated.ts（gitignore，勿手改）。
贡献：最小 diff；皮肤选择器跟着 Web GUI DOM 走。Issue / PR 请写清 DSH 版本或 mainline commit、本插件 commit、操作系统。
公开收录：仓库加 topic dsh-plugin；包名 @lengduan/*，不要占 @deepseek-ai/*。目录侧流程见 awesome-dsh-plugins 给插件开发者。