READMESource: main@7b63e71d
水墨天空 · dsh-plugin-ink-wash
一个 DeepSeek Harness 的 Web UI 插件:把整个界面背景换成国风水墨山水(白天 / 夜晚两幅原作), 太阳与月亮按本机时间沿同一条弧线移动,日落时天空泛红,入夜后换月亮登场。
- 插件包名:
@local/ink-wash-background - 插件显示名:水墨天空 / Ink Wash Sky
- 形态:纯浏览器端视觉插件(无工具、无网络请求、无会话读写)
效果
| 时间 | 画面 |
|---|---|
| 06:00–18:00 | 白天原作,日轮自左侧升起、正午高悬、右侧沉落 |
| 16:48–19:12 | 两张原作在 2.4 小时内缓慢交叉溶解,暖红霞光于 18:12 达到峰值 |
| 18:00–06:00 | 夜晚原作,月牙自左侧升起、午夜高悬、黎明前右沉 |
| 全天 | 日/月位置每 10 秒按真实时钟推进并以 10 秒线性补间,连续漂移 |
亮色主题在夜间加纸色薄罩、暗色主题整体压暗,保证文字可读;弹层、菜单、卡片保持不透明。
安装
在 Harness 中通过插件管理器安装(本仓库目录即插件包):
plugin_manager install_bundle target = <本仓库绝对路径>
或写入 profile 的 cordis.patch.yml:
- insert:
- id: ink-wash-background
name: '@local/ink-wash-background'
安装后浏览器端模块会自动生效;若界面未更新,刷新一次页面。
调试
浏览器控制台:
__inkWash.state() // { hour, phase, scheme, sun: {x,y}, moon: {x,y}, preview }
__inkWash.preview('18:00') // 冻结到某个时刻,便于核对日出/正午/夕阳/月夜
__inkWash.preview(7.5) // 也接受小时数或 Date
__inkWash.live() // 回到实时
目录结构
client.js 浏览器端模块(含内联的 4 张 WebP 资产,由构建脚本生成)
index.js Host 半,仅用于挂载 Loader 行
package.json 插件清单(dsh.bundle.patch / dsh.client)
cordis.patch.yml Loader 行
locale/{zh,en}.json 插件管理器显示文案
icon.svg 图标
assets/*.webp 裁剪/抠图后的派生资产(day / night / sun / moon)
src/client.template.js 客户端源码模板
src/build-assets.py 资产裁剪、抠图并内联进 client.js
src/assets.json 抠图几何比例
重新生成资产
client.js 里的图片由脚本内联,仓库只提交裁剪后的 assets/*.webp。若要重新裁剪,需要把四张原图
(背景(白天).jpeg、背景晚上.jpeg、太阳.jpeg、月亮.jpeg)放在本仓库的上一级目录,然后:
python src/build-assets.py
原图缺失时脚本会跳过裁剪、保留已提交的 assets/,只重新生成 client.js。
可调参数
均在 src/client.template.js 顶部,改完重新运行构建脚本:
HALF_TRANSITION(默认 1.2):昼夜溶解窗口的半宽,单位小时,窗口 16:48–19:12 / 04:48–07:12TICK_MS(默认 10000):场景刷新间隔,与 CSS 补间时长一致,保证连续过渡VEIL:亮/暗主题下的纸色、墨色薄罩强度TOKEN_OVERRIDES:外壳表面的透明度(--dsw-alias-bg-base、--dsw-specific-sidebar-fill)SUN_LAYER_VMIN/MOON_LAYER_VMIN:日月图层尺寸TINT_FRAMES:朝霞 / 晚霞的色温关键帧
说明
- 本插件不发起任何网络请求,也不包含任何凭证、密钥或用户数据。
- 原图不在本仓库内(体积较大);仓库内的
assets/*.webp是供插件直接使用的裁剪结果。 - 未附带 LICENSE 文件;如需公开发布或再分发其中的画面素材,请自行确认授权并补充许可证。
No comments yet. Be the first to write one.