大黑塔天才书房 KshineKX/the-herta-atelier

The Herta Atelier · 大黑塔·天才书房

代码许可：MIT · 允许使用、修改、分发与再许可；角色与第三方权利见 NOTICE

Kshine 的非官方 DSH 主题作品 · Windows

源码版本：0.4.0-beta.14

本版是输入区定点修复 Beta，移除输入框多层花框及遮挡，保留编辑器和发送按钮原有布局。开发会话已完成本次输入区实机观察，并得到用户确认；完整测试、两种包门禁和 CI 按最终提交执行，结果见 beta.14 发行页及每包验证回执。本发布阶段不再次安装或重启真实 DSH，长期性能和未测原生功能仍未验收。见交付状态和单一源码入口。

紫黑与晨光双主题，三组内置场景画像，以及银纹、紫花、宝石与钥匙的层叠框饰。观赏模式保留人物与场景；专注模式在宿主原有正文列背后增加柔边衬底，切换保留消息与输入框布局。面板、代码与输入框使用统一的紫调玻璃材质。

完整主题包含 10 张背景变体、3 个场景、13 段无声视频，共 102 秒。书房 5 段为 1820×1138，另两场景 8 段为 1212×758，均为 30fps。已完成多轮生成、书本连续性、闭嘴定位和动作衔接修订，以及安装、升级、失败恢复和精确回退验证。制作范围与费用口径见制作记录。

本项目为非官方同人主题，与 miHoYo / HoYoverse、DeepSeek 无隶属关系。角色相关权利属于相应权利方；项目许可只覆盖作者有权授权的贡献。

预览

以下前两图使用已审阅 beta.14 视觉代码和内置书房画像，展示深浅观赏模式。它们是使用虚构欢迎页内容的皮肤代码隔离预览，不是原生 DSH 截图，不含真实账号或聊天；不代表新增美术或完整原生功能验收。

beta.14 深色观赏模式隔离预览

beta.14 浅色观赏模式隔离预览

阅读示例（历史隔离演示）

以下为 beta.11 的阅读示例，使用虚构内容，同样不是原生 DSH 实机截图。

beta.11 浅色阅读隔离演示

beta.11 深色阅读隔离演示

三场景动态预览：

三场景原片压缩预览

打开 MP4 预览。动态图取现有原片每场景 3 秒拼接为 9 秒，并缩放压缩便于网页查看；不是原生 DSH 录屏，也不是完整动作周期。以上预览不代替跨机、长时间运行或每个动作的完整验收。

第一次使用

一条命令安装（推荐，先完全退出 DSH）：

irm https://raw.githubusercontent.com/KshineKX/the-herta-atelier/main/install.ps1 | iex

- 默认下载完整主题（约 296MB）；irm ... -OutFile install.ps1; .\install.ps1 -Core 只下核心包（0.4MB），-NoInstall 只下载解压不安装。
- 也可以手动去 beta.14 发行页 下载 zip + .sha256，核对后解压运行 Install.cmd。

1. 打开 beta.14 发行页，下载 The-Herta-Atelier-0.4.0-beta.14-theme.zip 和对应 .sha256，核对后解压。仓库已公开，可直接下载（无需申请权限）。
2. 先运行一次 DSH，保存工作并完全退出，再双击 Install.cmd。安装器校验并备份配置，联合安装代码和 13 段视频。
3. 重新打开 DSH，展开右上工具条，用四角星打开设置；选择静态／动态、画像场景、观赏／专注和深浅外观。
4. 镜子按钮固定保留在工具条，点击才打开图库。OpenGallery.cmd 打开自己的图库目录，增删图片后重开藏镜刷新。

需要 Node.js 22.19+（22.x）或 24+，入口优先寻找 DSH 自带运行时。普通使用不要求编辑 JSON/YAML、安装 npm 依赖，或启动作者的预览服务器。

Code → Download ZIP 是开发源码；安装用户优先使用预构建的 -theme.zip。源码构建方法见下方开发说明；--core 是显式不带画像的基础版选项，不作为默认交付。

特殊动作怎样触发

先在设置中选择动态模式：

- 长待机：人物在 150–240 秒的随机低频等待后行动；输入、滚动或点击等活动会重新开始待机等待。
- 故意触碰背景：在同一块空白背景约 1.6 秒内连续轻触 3 次；单击或双击不触发，正文、输入区、按钮等控件和真实文本选区会被排除。互动冷却为 45 秒。
- 书房离席后：20–30 秒后自动返回并落座。私室的仰躺与歪头动作轮换，不需要逐次点动作按钮。

后台、系统减少动画、静态模式和卸载会取消低频等待；恢复后重新等待，不累计补播。素材缺失或加载失败时显示静态画像。设置不再显示「动作播放中」等状态行或离席等动作按钮。

右上工具条平时收起，点击或停留片刻展开，闲置四秒后收起；设置或键盘操作期间保持展开。镜子入口常驻工具条，图库由用户自己管理。

安装、升级与回退

- 默认使用当前用户的 DSH desktop profile，支持自定义 DSH_HOME、profile 和数据目录。
- 配置和旧链接先备份；升级保留个人图库、个人开屏、无关插件配置及首次安装前的恢复基线。
- Rollback.cmd 精确回到本次升级前的状态；Uninstall.cmd 恢复首次安装前的配置，两者用途不同。实际安装、升级、回退和卸载前，先完全退出 DSH。
- Check.cmd 只报告状态，不修复、不重启、不改配置。宿主升级后先检查状态，再验证兼容性。

beta.10 因标记注释消失而无法回退

beta.11 已修复一个问题：宿主删除两行受管标记注释后，回退会被误拒绝。本版完整包继续保留 RecoverBeta10.cmd。beta.11 发行页另有约 22KB 的 beta10-rollback-repair.zip：无需先安装 beta.11，可从原 beta.10 备份直接恢复它记录的升级前版本，例如 beta.8。先核对 SHA 并执行只读预检，DSH 退出后再应用。其他用户改动、配置或媒体变化仍会拒绝覆盖，原 before 备份保留，原回执另存。

完整步骤见安装与回滚，环境边界见兼容范围，执行记录见验收记录。

当前状态与验证范围

当前 main（2026-10-28 起）：作者有权授权的代码、文档与素材采用 MIT，仓库公开；一条命令安装脚本见上。已发布 v0.4.0-beta.14 的 theme/core 附件仍按发布时的 PolyForm NC / CC BY-NC-SA 许可有效，不追溯变更。

beta.14 发布准备完成最终包 30 项测试、7 组隔离浏览器检查，并复验 8 项关键恢复测试；真实后端 13 段视频、26 个首尾 Range 请求与 3 场景背景检查通过；GitHub 回下载核对一致。真实 DSH 的长期性能、跨机与未测原生功能仍未验收。

发布阶段最终包 30 项测试、7 组隔离浏览器检查通过；GitHub 回下载核对一致，另复验 8 项关键恢复测试。浏览器长等待用 timer harness 提前回调，部分动作结尾 seek；这些不是自然时长全程或自动原生帧测量。

各版安装包与标签固定在其发布提交。首页、预览和制作说明可在 main 持续更新，不覆盖已发布的同名安装包；安装包内的说明保留发布时快照。

可选开屏

分享包不附官方 PV。将自己可使用的 MP4/WebM/M4V/MOV 拖到 ImportVideo.cmd，再运行 InstallWithBoot.cmd。开屏模块沿用 lxj5820/dsh-boot-animation 的 MIT 代码与原许可证。

正常提示为 PRESS ANY KEY TO ENTER；任意非输入法组合键可进入，声音由单独按钮控制。推荐 H.264/AAC 并做 faststart，清晰度取决于用户导入片源。

开发与维护

npm ci --ignore-scripts --no-audit --no-fund
npm test
node tools/verify.mjs
node tools/preview.mjs
修改完成后先提交，发布入口只接受干净的 Git 提交
node tools/release.mjs
显式基础版：node tools/release.mjs --core

开发者安装的 Playwright 是测试依赖；Windows 浏览器回归默认使用本机 Microsoft Edge。它不进入安装包的运行依赖，也不调用生成模型。npm test 会先构建，避免用过期清单测试新源码。

发布入口从干净提交执行 git archive，在独立目录构建、检查媒体清单及隐私、运行测试，再打包、解压并复验；任一关卡失败都不产出成功发行件。同名 ZIP 不覆盖。

源码先构建本地清单，再使用安装器。tools/preview.mjs 是开发预览入口，终端会报告本机地址；普通安装和使用不依赖它。历史候选审阅文件保留作过程记录，不代表当前版本仍未安装或未发布。

维护方式见贡献指南、支持、安全和维护流程。

制作记录

这个版本保留了三场景共 13 段、102 秒的生成视频，以及多轮重做和校正后的结果。书房从起身、离席、返回到落座，需要处理书本与姿势连续性；另两场景修订过嘴部角度、闭嘴定位、翻转残影及动作复位。成片之外，还包括静态回退、预载、暂停清理、媒体 Range 读取、升级与数据保留、失败恢复和精确回退的实现与检查。

截至本版，视频生成累计原价估算约 192 元，包括此前多轮生成、探针与书本修订；另有本地后期、开发调试与验收投入，未计入此数。实际优惠、代金券抵扣及实付未知，这不是项目总成本。计算范围见制作记录与费用口径，不编造未记录的工时或 token 总量。

来源与许可

自 2026-10-28 起，作者有权授权的代码、文档、独立原创 SVG 框饰与随项目分发的素材采用 MIT 许可证（见 LICENSE）：允许使用、修改、分发、再许可与商业使用。历史发行版（beta.14 及以前）仍按当时发布的许可证继续有效；本次变更不追溯撤销已发布版本的授权。

可选开屏仍为上游 MIT 许可，字体仍为 SIL OFL，第三方 MIT/OFL 部分保留原有权利。MIT 许可只覆盖 Kshine 有权授权的贡献，不转移角色或商标权利，也不表示官方合作或获得单独角色授权。

独立美术的署名、许可链接与字体修改状态见素材署名表。

许可与来源详见LICENSE、许可摘要、NOTICE、素材台账及源码与 AI 说明。

这些文件说明现有许可边界，不等于已经核实全部第三方权利或取得角色官方授权。

Required Notice: Copyright (c) 2026 Kshine. The Herta Atelier. https://github.com/KshineKX/the-herta-atelier

第三方集成与素材许可见上游与独立插件。DeepSeek 余额小鲸鱼为 MeteorNOX 维护的独立插件，需另行安装，不属于本主题原创或内置功能；它的代码 MIT 许可不覆盖其全部美术素材。