1.0.6 — 羊皮纸便笺、语音与翻译气泡，修图片预览 ✕ 误触

新增

• 羊皮纸便笺（记录板）：右下角一枚麦穗环徽章，点开是一张能打字、能粘图的便笺。
  文字存 localStorage（400ms 防抖），粘贴的图片存 IndexedDB——图片体积大，
  localStorage 装不下几张就超限。徽章可拖，面板可拖可调大小。
• 便笺的第二个入口：设置里开启「简化写字板按钮」后，徽章隐藏，改在顶部工具条
  「提示词」左边放一个「写字板」按钮。
• 语音与翻译气泡：九条台词接到按钮（查询用量 / 充值 / 新会话 / 插件 / 打开侧边栏）、
  探头、挂件鲸鱼、便笺徽章与右栏待机画面，每条都在探头右上角浮出中文译文。
  按钮类滞留「音频时长 + 3 秒」，触发类滞留「固定时长 + 3 秒」，点气泡立即消失。
• 点右栏待机画面里的立绘应答一句。热区取画面宽度的 608×1080 比例、上部 62%，
  是一块固定位置的矩形，不按角色轮廓描——六段动画可替换，她站的位置各不相同。
• 气泡跟着探头走：显示期间每帧重算锚点，拖她、她倾斜或点头时气泡都跟着。

修复

• 打开图片后，点右上角 ✕ 反而播了赫萝的语音。 图片预览是 createPortal 到 <body>
  的文档级浮层（role="dialog" aria-modal="true"），它不替换右栏开始页；
  待机画面的点击热区浮在内容之上又只按「开始页在不在」判断，于是盖住浮层、
  把 ✕ 的点击吃掉了。现在热区在文档出现 [role="dialog"] / [aria-modal="true"] 时
  立即隐藏，点击时再兜底确认一次。判断只认 dialog 与 aria-modal，不查下拉菜单。
• 点立绘有声音、没字幕气泡。 createScene 的签名改成了 createScene(announce)，
  但调用点没跟着传参，announce 是 undefined 被类型判断挡掉。
• 侧栏「新会话」折叠时点不到。 折叠态只有图标、没有可见文字，按文本匹配会失效；
  新增按 aria-label 回退匹配。
• 记录板图层由 2147482810 提到 2147482998，压在探头之上。

其它

• index.js 白名单由 18 项增至 27 项。
• README 按实测数字全面更新（体积、素材计数、白名单项数、设置项表、assets 表、
  已知边界），并新增「羊皮纸便笺」与「语音与翻译气泡」两节功能详解。
• 测试规模：scene_test 70→92、voice_bubble_test 42→73、planner_test 57→88、
  src_integrity_test 10→18（新增「签名与调用点一致」护栏，专防改了签名漏改调用点，
  上面第二条 bug 正是这一类，原先两套测试都查不到）。

完整更新记录见 CHANGELOG.md。

1.0.5 — 市场展示图可自管，README 的不实声明改正

1.0.5 — 市场展示图可自管，README 的不实声明改正

新增

• screenshots.json：为插件市场声明四张展示图（整页概览、六组待机动画拼图、开场动画末帧、侧栏麦田特写）。市场规则要求截图声明在插件自己的仓库里，路径相对、不能以 / 开头、不能含 ..；不声明则市场会从 README 自动抽图。之后换图只要推仓库，不用再提 PR。
• assets/icon-market.jpg（256×256）：插件市场卡片图标。原来的 assets/icon.jpg 只有 64×64，市场按约 96px 显示会被放大发糊。源图没有更高清的版本，这里是 4 倍 Lanczos 上采样加轻量锐化（半径 2、强度 80%），不新增细节，只是把硬边磨顺。package.json 的 icon 字段同步指向新文件。

修复

• README 有两处声明与代码不符，已改正。 横幅 alt 文本和设计原则第 2 条原先写「装饰性组件全部可以单独关掉」，但设置页实际只有六个开关（开场动画、偷看的她、探头语音、黑夜模式、右栏待机动画、浮动字标显隐）；动态档案卡、日志标签、侧栏麦田三项没有开关。现在如实写明哪六项可关、哪三项常驻以及常驻的原因（纯展示层、不拦截点击、不占布局）。中英双语同时改。

这一条会被插件市场的人工评审对着代码逐条核，夸大是打回的主要原因。所以它不只是文档更正，也是过审的必要条件。

---

安装

在 DSH 里打开「设置 → 插件 → 添加插件」，输入：

github:1015677515/dsh-theme-holo

装好点「立即启用」，然后重启 DSH。

github: 简写尚未在隔离环境中逐步验证过。若解析失败，请改用 INSTALL.md 里的本地安装法。

环境要求

项目	要求
DeepSeek Harness	>=0.2.0-rc.1 <0.3.0-0
Node.js	>=22
系统	Windows / macOS / Linux（在 Windows 11 + DSH 0.2.1-rc.2 上测试）
磁盘	约 16 MB
运行时依赖	无

完整说明见 README，安装与排错见 INSTALL.md，全部历史见 CHANGELOG。

本项目由 holoiallo 最初创立，1015677515 完善更新，由 DeepSeek Harness 的 AI 智能体协助开发。素材均来自网络的二创，仅供学习和交流使用。

1.0.4 — 右侧待机动画可以关掉了

1.0.4 — 右侧待机动画可以关掉了

新增

右侧待机动画多了「关闭动画」选项。 设置页那一栏现在有七项：前六项仍是六段动画的文件名，最后一项 关闭动画 是关掉的开关。选中后右侧栏开始页不再显示待机画面，进入开始页时连视频都不加载（不占解码器），也不用重启 —— 选回任意一段立即恢复。

修复

「关闭动画」原本只能单向。 scene-change 的监听原先注册在图层入场时，一旦关掉，图层被撤、监听随之下线，再选回某个动画就没有人接手，必须重启才生效。现在监听挂在图层的整个生命周期上，关闭与恢复都可以当场来回切。

---

安装

在 DSH 里打开「设置 → 插件 → 添加插件」，输入：

github:1015677515/dsh-theme-holo

装好点「立即启用」，然后重启 DSH。

github: 简写尚未在隔离环境中逐步验证过。若解析失败，请改用 INSTALL.md 里的本地安装法。

环境要求

项目	要求
DeepSeek Harness	>=0.2.0-rc.1 <0.3.0-0
Node.js	>=22
系统	Windows / macOS / Linux（在 Windows 11 + DSH 0.2.1-rc.2 上测试）
磁盘	约 16 MB
运行时依赖	无

完整说明见 README，安装与排错见 INSTALL.md，全部历史见 CHANGELOG。

本项目由 holoiallo 最初创立，1015677515 完善更新，由 DeepSeek Harness 的 AI 智能体协助开发。素材均来自网络的二创，仅供学习和交流使用。

1.0.3 — 许可证可识别、安装文档成形、README 大改

1.0.3 — 许可证可识别、安装文档成形、README 大改

这一版对应 v1.0.3 tag。因为 1.0.1 与 1.0.2 没有单独打 tag，它们的内容一并记在这里。

修复

• LICENSE 被 GitHub 识别成 NOASSERTION。 原因不是缺少许可证，而是 MIT 正文前插了一段「适用范围（Scope）」把标准模板切断，GitHub 的 licensee 模板比对失败，于是落到 NOASSERTION。现在 LICENSE 恢复为纯 MIT 模板（21 行），GitHub 徽章会显示 MIT license，依赖图与合规扫描也能正确归类；那段适用范围挪到独立的 NOTICE.md。法律效力原本就与 MIT 一致，变的只是机器可识别性。
• 首次安装不再落在黑夜模式。 DSH 的外观偏好出厂值是「跟随系统」，系统为深色的机器一装好就解析成深色，再叠上「星夜麦田」，容易被误读成「装了插件就被切成黑夜模式」。现在插件在首次运行时若发现宿主已解析为深色，会通过主题服务把外观偏好改回 light 一次，并把 localStorage['dsh-theme-holo.dark-defaulted'] 置为 1 落闩；此后不再干预，只有设置卡片里的开关能重新打开深色。本来就是浅色的机器不受影响。宿主没有 theme 服务时，退化为摘掉 body[data-ds-dark-theme]（仅本次会话有效）。

新增

• INSTALL.md：环境要求表、三种安装方式（github: 应用内安装 / 本地 link: + mklink /J（含 Linux、macOS 的 ln -s）/ ZIP 解压）、装好之后的样子、自检（确认装对了：三处特征 + 两种典型失败模式）、卸载（含清理 localStorage 与挂件目录）、常见问题。
• NOTICE.md：中英双语说明 MIT 只覆盖源代码，不覆盖 assets/ 与 素材/ 的音视频图像；素材不主张权利、有异议提出即移除、不得商用。
• README「界面预览」节：一张 1600×862 的真实运行截图（余额、今日消耗、账号名已打码），下附 5 行「位置 → 看到什么」对照表。
• README「环境要求」节：DSH >=0.2.0-rc.1 <0.3.0-0、Node >=22、三平台、约 16 MB、无第三方依赖、安装需联网运行时不需要，并附 package.json 的 engines / compatibility 片段。
• README「出处声明」节：本项目由 holoiallo 最初创立，1015677515 完善更新，由 DeepSeek Harness 的 AI 智能体协助开发；素材来自网络二创，仅供学习交流。中英双语。
• README「相关链接」节：INSTALL / CHANGELOG / NOTICE / Issues / Releases。
• README 英文节（精简版）：Preview、Features 十一条、Requirements、Install、Credits、Links。不做全文双语，只做一份能读懂「这是什么、怎么装」的摘要。
• README「这是什么」重写：顶部依次是 logo 与 75% 透明度的小麦图；首段改为「本插件为 DeepSeek Harness 的《狼与香辛料（狼と香辛料）》主题插件……」的正式表述。
• 配图目录 docs/（不参与运行时）：gui-overview.png（1600×862）、intro-final.webp（开场动画末帧，1920×1080）、scene-grid.png（六段右栏待机动画各取一帧拼成一条）、wheat-75.png（75% 透明的小麦）、readme-banner.png（1800×600 首屏横幅）。
• README FAQ 两条：「安装后自动变成了黑夜模式？」说明成因（DSH 默认跟随系统）与自查两步；「README 页面的底色和文字颜色，为什么不能也做成主题色？」附消毒器实测对照表。

变更

• README 首屏换成主题配色的横幅图。 GitHub 会剥掉 README 里所有 style 与 color（渲染器跑 github/html-pipeline 的消毒白名单，里面没有 style），页面底色与文字颜色改不了，能承载配色的只有图片。因此首屏改为一张 1800×600 的横幅：米黄 #FBF7EF 底、深米色 #DCC9A8 双线圆角外框、logo、金色 #A2701F 分隔线、三行正文。只做浅色一版。
• 目录改用两列表格（章节 / 功能详解的十个小节），并注明表格底色由 GitHub 主题决定。
• README 安装节重写：从 60 行压到 20 行，先给 github:1015677515/dsh-theme-holo 一行安装，再指向 INSTALL.md；github: 这条标了【未验证】，解析失败请回退本地安装。
• README 概览表：「浏览器半体积」改为「插件大小」（约 16 MB，其中 client.js 与 index.js 合计约 198 KB，其余全是素材；docs/ 的 1.7 MB 配图不参与运行时）；素材改为按图片 32 张 + 视频 6 组计数；配色一行标注「开发中，测试功能」。
• 设置卡片的「黑夜模式」小节新增提示：黑夜模式未完全做好适配，请谨慎打开。
• package.json：版本 1.0.2 → 1.0.3；files 补入 INSTALL.md、NOTICE.md（现 12 项）；engines 增加 "dsh": ">=0.2.0-rc.1 <0.3.0-0"；新增 dsh.compatibility（含 dshReleases 逐版本兼容表，写法与 dsh-cost-meter 等官方插件一致）。
• 修正版本徽章（1.0.1 → 1.0.2 → 1.0.3），与 package.json 对齐。

说明

• 本轮没有增加「它会动你的哪些文件」节与「运行时验证记录」表——按决定暂时跳过。

---

安装

在 DSH 里打开「设置 → 插件 → 添加插件」，输入：

github:1015677515/dsh-theme-holo

装好点「立即启用」，然后重启 DSH。

github: 简写尚未在隔离环境中逐步验证过。若解析失败，请改用 INSTALL.md 里的本地安装法。

环境要求

项目	要求
DeepSeek Harness	>=0.2.0-rc.1 <0.3.0-0
Node.js	>=22
系统	Windows / macOS / Linux（在 Windows 11 + DSH 0.2.1-rc.2 上测试）
磁盘	约 16 MB
运行时依赖	无

完整说明见 README，安装与排错见 INSTALL.md，全部历史见 CHANGELOG。

本项目由 holoiallo 最初创立，1015677515 完善更新，由 DeepSeek Harness 的 AI 智能体协助开发。素材均来自网络的二创，仅供学习和交流使用。

1.0.0 — 首个公开发布

1.0.0 — 首个公开发布

赫萝主题的第一版公开发布。版本号从 1.0.0 重新起算——此前的 1.1.0～1.13.2 是本机内部迭代，功能已全部并入本版。

配色

• 浅色「麦秋晨光」：羊皮纸底 #FBF7EF、暖棕正文 #33291C、麦金点缀 #B8822B。全局重绘 DeepSeek Harness 的 110 个调色板 token，菜单、弹窗、代码块、表格、滚动条、选中与焦点环一并换色。
• 深色「星夜麦田」：夜色底 rgba(21,17,12,.945)、暖金高光 #E0AE5C。默认关闭，在插件设置里切换。
• 两套都只在对应主题模式下生效；切到没做过的那一侧时回退到出厂配色，不会出现半深半浅的混搭。

装饰

• 开场动画（12 秒）：canvas 逐帧实时渲染，不是视频。可按设置彻底关掉（关掉后连 canvas 都不建）。
• 浮动字标：可拖动、可缩放，位置与不透明度记在本地；也可以整个关闭。
• 偷看的她：贴在输入框上沿的探头立绘，可左右拖动且不出界，待机自动下沉，点击出声，能整只关闭。
• 动态档案卡：指针悬停账号行时展开的羊皮纸卡片。
• 日志标签分类：思考 / 读取 / 图片 / 搜索 / 运行命令 / 工具调用 / 写入 / 编辑，按类别上色。
• 侧栏脚下的麦田：独立浮动层，宽度随侧栏自适应，顶部锚在账号行中线。
• 右栏待机画面：六段 608×1080 的 VP9 动画，仅在本插件右栏自己的开始页显示，左右边缘做渐隐过渡。
• 插件详情页横幅：仅本插件详情页可见，随内容滚动。

联动

• 小鲸鱼挂件（dsh-whale-widget）联动：同时安装时可一键导入「赫萝」「赫萝Q版」两个可替换角色与一条替换语音「赫萝震惊」。按名字比对，已有的一律不动，只补缺的，重复执行安全。

安全

• 三条静态资源路由全部改为确切文件名白名单。 此前是整目录放行，素材/ 下未修白边的原件、封面草稿、字形切图都会跟着可访问。现在只送出 index.js 里 ALLOW 表列出的文件，其余一律 404，子目录不可达，路径穿越仍被拦截。

工程

• 零第三方依赖，只用 Node 内置模块与宿主注入的 react。
• node --check 与四套自测脚本全绿。

已知边界

• 深色「星夜麦田」尚未适配全部宿主界面，设置页里也有同样的提示：黑夜模式未完全做好适配，请谨慎打开。
• 插件对 <video> 只写 opacity / object-fit / mask-image / 色相滤镜 / mix-blend-mode，本身不做雾化；若待机画面看着「糊」，通常来自 wallpaper 插件（dsh-plugin-wallpaper-engine）的液态玻璃 backdrop-filter，把它的雾化强度调低即可。

---

安装

在 DSH 里打开「设置 → 插件 → 添加插件」，输入：

github:1015677515/dsh-theme-holo

装好点「立即启用」，然后重启 DSH。

github: 简写尚未在隔离环境中逐步验证过。若解析失败，请改用 INSTALL.md 里的本地安装法。

环境要求

项目	要求
DeepSeek Harness	>=0.2.0-rc.1 <0.3.0-0
Node.js	>=22
系统	Windows / macOS / Linux（在 Windows 11 + DSH 0.2.1-rc.2 上测试）
磁盘	约 16 MB
运行时依赖	无

完整说明见 README，安装与排错见 INSTALL.md，全部历史见 CHANGELOG。

本项目由 holoiallo 最初创立，1015677515 完善更新，由 DeepSeek Harness 的 AI 智能体协助开发。素材均来自网络的二创，仅供学习和交流使用。