dsh-plugin-gouden-leeuw-theme

English

这是一个受《碧蓝航线》金狮（Gouden Leeuw）启发的非官方社区主题。它不再把 森林当作普通网页背后的壁纸，而是让 Harness 框架本身成为深墨绿的月泉圣所： 两侧森林围合中央工作区，真实输入框成为月泉玻璃，唯一正式立绘始终保持为清晰、 独立的透明 PNG 图层。

主题完全自包含。所有生产素材随插件提供，并由 Host 侧通过同源路由交给本机 UI； 安装时不需要本地图片路径，也不修改 Harness 官方前端 dist。

主要效果

• 使用一份正式透明金狮主立绘与原始昼夜侧栏 Q 版；不重新生成人物、不模糊、不烘焙进背景。
• 采用“立绘优先”的纯环境：月亮、森林拱门、精灵遗迹与月泉水面服务于象牙白/ 薄荷绿人物主色，不再与人物争夺焦点。
• welcome 页面形成标题—输入框—人物—月泉的完整构图；active 对话态把同一张 清晰立绘移到右侧守护位，用实色圣所玻璃隔开阅读列，而不是把人物变成幽灵水印。
• 植物/晶体复杂装饰由经过检查的透明位图承担；CSS 只负责布局、玻璃、光照、 交互和稀疏萤火。
• 把 Harness 的稳定语义 slot / data-* 状态集中映射为插件自有角色；CSS 不依赖 构建哈希类，也不叠加历史 override。
• 十一个带版本号的精确同源素材路由，支持 GET、HEAD、SHA-256 强 ETag、immutable 缓存、同源资源策略和 MIME 防护。
• 包含响应式、减少动态效果和可逆的 Windows 安装/卸载流程。

环境要求

• DeepSeek Harness 0.1.x release-candidate 系列。当前版本已在 Host 0.1.0-rc.7、Web UI 0.1.0-rc.8 上完成实机视觉验证。
• Node.js ^22.19.0 或 >=24.0.0。

Windows 安装

把仓库克隆到一个准备长期保留的位置，然后执行：

git clone https://github.com/Andy294753951/dsh-plugin-gouden-leeuw-theme.git
Set-Location .\dsh-plugin-gouden-leeuw-theme
pwsh -File .\install.ps1

之后重启 dsh web。脚本会构建无第三方依赖的浏览器 bundle，把本地组合包加入 web profile，并在 ~/.dsh/profiles/web/cordis.patch.yml 中写入一段有明确标记 的覆盖配置。

使用自定义 DSH Home 或 profile：

pwsh -File .\install.ps1 `
  -DshHome "D:\dsh-home" `
  -DshProfile web

手动安装

先构建并加入包：

npm run build
dsh plugin --profile web add .

组合包会先创建一个休眠的插件条目。再把以下覆盖配置追加到 ~/.dsh/profiles/web/cordis.patch.yml：

- id: gouden-leeuw-theme
  disabled: false

修改 profile 组合后重启 dsh web。

卸载

pwsh -File .\uninstall.ps1

卸载脚本会移除受管理的 profile 配置和包依赖。

开发与验证

npm run build
npm run check

• src/client/theme.css：圣所布局、玻璃、光照、交互与响应式规则。
• src/client/index.js：语义色板、生命周期、稳定宿主角色映射、唯一人物图层和萤火。
• src/index.js：Host 素材清单与精确同源路由。
• assets/backgrounds/：正式昼夜纯环境背景。
• assets/character/：正式主立绘 PNG 与原始昼夜侧栏 Q 版。
• assets/ui/：只保留经过评估的小型位图装饰。
• lib/：构建生成的可安装产物；通过 npm run build 统一更新。

构建过程会统一换行符，避免 Windows checkout 只让 bundle 产生无意义差异。

最终视觉验收已在真实 Harness 中覆盖 1920×1080 的昼夜 active 对话与 welcome 页面，并以 3840×698 超宽短视口确认会话卡片外不再出现随布局移动的全宽分界线。 最终截图保存在 gui-test-screenshots/。

兼容性说明

语义色板使用 Harness 主题服务。布局集成只读取当前 Web UI 提供的语义 slot 与稳定 data-* 状态，再集中映射为 data-gouden-leeuw-role。如果未来 Harness 改动这些 结构 hook，只需优先维护 src/client/index.js 的映射层；视觉 CSS 不依赖宿主构建 哈希类。目前只面向 HTTP web profile。

权利与声明

本项目是非商业、非官方同人主题，与 DeepSeek、悠星、蛮啾或勇仕没有隶属或背书关系。 《碧蓝航线》、金狮（Gouden Leeuw）、相关名称、图像与商标归各自权利方所有。 MIT 许可证只覆盖本仓库代码，不覆盖第三方或用户提供的随包素材。详情见 THIRD_PARTY_NOTICES.md。