dsh-nocturne · 缮写室

DeepSeek Harness 的 WebGL2 古典纸张与物理光影主题插件。

它不是简单的 CSS 调色板覆盖，也不是一张静态贴图，而是把一盏桌前台灯与带纤维肌理的纸张引入了 DeepSeek Harness。

项目移植自 Typewriter Nocturne 的光学与材质渲染管线，剥离了拟物打字机外壳，专注于日常舒适的阅读与书写。纸面纤维与漫射光影由 WebGL2 着色器实时演算，以 mix-blend-mode: multiply 叠在文字之上；所有的文本排版、滚动物理与会话交互仍完整交给 DSH 原生处理。

---

纸张与空间

材质与光照彼此解耦，支持 6 款纸张 × 3 组空间（共 18 种光学组合）。每种搭配均经过针对性调校，确保正文对比度舒适耐读。

• 纸张材质：

  • 葱皮纸 (Onionskin)：轻薄韧挺，几近无皱，还原经典洋葱纸的通透质感。
  • 棉浆纸 (Cotton)：冷压水彩纸手感，圆润毡压纸齿间夹杂着零星长纤维。
  • 帘纹纸 (Laid)：呈现古法抄纸特有的横向帘线与纵向链线肌理。
  • 亚麻纸 (Linen)：微密交织的经纬布纹与天然亚麻竹节感。
  • 羊皮纸 (Parchment)：富有做旧沉淀的微瑕云斑、水渍与边缘浸痕。
  • 夜纸 (Night)：为暗光环境定制的深色纸底，搭配柔和月白墨色，护眼耐读。

• 空间与光影：

  • Paper & Ink：字锤便携小灯，聚拢聚焦，背景深沉古朴。
  • Midnight Study：深夜书斋暖调台灯，温润宽阔的光锥笼罩桌面。
  • Moonlit Poetry：自轩窗倾泻而下的清冷漫射月光，静谧舒展。

查看全部 18 张独立效果图 →

---

交互细节与原生保护

视觉增强服务于文字，绝不牺牲基础输入体验。所有动态效果均内置严谨的原生避让与降级逻辑：

墨迹光标 (Ink Caret)	羽毛笔光标 (Quill Caret)

• 光标跟随与输入法避让：提供「墨迹」与「羽毛笔」两款定制光标，紧随输入落点。中文输入法（IME）组合输入中、鼠标划词拖选或坐标测量异常时，毫秒级自动退回系统原生光标，杜绝候选框遮挡或打字跳闪。
• 纸夹滚动条：右侧滚动条模拟为别在纸缘的回形针（支持银、黄铜、金、黑四种质地），随滚动伴随细微的物理倾角与弹簧回弹。滚动物理与滑动惯性完全保留原生浏览器行为。
• 漫射微光与无障碍：光锥内的微弱尘埃粒子与光晕仅占用极低算力，且严格遵循系统的「减少动态效果」（prefers-reduced-motion）设置，开启后自动冻结动画粒子。
• 硬件降级保障：在无 WebGL2 支持或显卡驱动崩溃等环境中，自动退回平滑静态纸色，确保核心交互与文字可读性不中断。

---

原生设置集成

插件无缝嵌入 DSH 官方设置体系。打开 设置 → 缮写室，即可直接调整全部视觉项：

• 复用宿主 React：直接接入官方设置槽，零二次注入运行时，布局风格与 DSH 及 claude-style 保持统一。
• 参数即调即显：纸张切换、台灯开关、光照强度、光锥广角、颗粒与尘埃微调均即时响应并自动保存。
• 桌面端设置可靠持久化：针对 DSH 桌面端随机端口导致 localStorage 容易失效的问题，内置本地文件存储机制（$DSH_HOME/cache/dsh-nocturne/settings.json），同时向后兼容 Web 端的浏览器缓存回退。
• 皮肤共存策略：与第三方主题（如 dsh-claude-style）并存时，可在设置中选择「自动适配」、「仅叠纸张材质（保留其配色）」或「完全接管配色」。

---

免安装离线预览

无需启动服务或安装插件，直接用浏览器打开内置的单文件样张即可预览全套视觉效果（英文字体均已本地化）：

sample/nocturne-desk.html

支持通过 URL 参数直接查看指定组合：

?paper=cotton&theme=moonlit-poetry     # 棉浆纸 + 月光主题
?studio=1&cursor=quill                 # 羽毛笔光标与调参台
?lamp=0                                # 熄灭台灯，仅看纸纹

---

安装与卸载

前提条件

• DeepSeek Harness 0.2.x
• Node.js 18.0 或更高版本

安装

cd packages/dsh-nocturne

# 预检安装变更
node install.cjs --dry-run

# 执行正式安装（写入桌面版档案，支持通过 --profile web 切换）
node install.cjs

安装完成后重启 DSH，即可在「设置 → 缮写室」中看到配置面板。

卸载

cd packages/dsh-nocturne
node install.cjs --revert

提示：卸载脚本具备幂等与干净回滚特性，仅精确移除本插件的注册登记与 bundle，不影响其他插件在 package.json 中的后续修改。

---

控制台快捷 API

在控制台可通过全局对象 __dshNocturne 快速调整参数：

__dshNocturne.use('cotton');                                      // 切换纸张材质
__dshNocturne.use('parchment', { intensity: 1.35, grain: 0.25 }); // 调整光照与颗粒强度
__dshNocturne.theme('midnight-study');                             // 切换环境光主题
__dshNocturne.lamp(false);                                         // 临时关灯
__dshNocturne.off();                                               // 暂时停用纸面渲染

---

本地开发与构建

npm ci            # 安装开发依赖
npm run build     # 重新构建客户端、宿主脚本与样张
npm test          # 运行测试（包含基于真实无头 Edge 的多材质渲染回归）
npm run check     # 产物漂移检查与全量测试

• 核心渲染管线位于 packages/dsh-nocturne/src/core/
• 原生设置页位于 packages/dsh-nocturne/src/settings-page.js
• 架构设计、着色器推导与渲染细节参见 移植与设计说明 与 开发文档。

---

许可与致谢

• 本项目采用 MIT License 授权。
• 纸张与光影配方移植自 Typewriter Nocturne（MIT License，© Chaosnap）。
• EB Garamond、Cormorant Garamond 和 Courier Prime 字体遵循 SIL Open Font License 1.1。