前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者根据需求扩展功能。Whiteboat-dsh 是 Whiteboat 生态在 DSH 平台上的适配。它引入了“静水面”作为第一个功能切片，旨在提供一个在开始真实会话前可以暂停或输入的空间，同时复用 Whiteboat 的核心视觉与交互能力。
是什么¶
Whiteboat-dsh 是一个运行在 DSH 上的客户端插件，由 Circleyan 维护，采用 MIT 许可证。它将 Whiteboat 的水面体验集成到 DSH 环境中，使开发者可以在不立即发起 AI 调用的情况下，进行构思、观察或准备。
核心功能¶
静水面¶
静水面是当前版本的核心功能。它提供了一个非品牌化的水面视图，允许用户在开始真实会话前进行暂停或输入操作。仅观看水面不会创建会话、提示词、AI 调用或写入任何数据。
视觉与交互¶
- 3D 小船与主题：3D 小船根据亮色 C / 暗色 E 主题渲染，夜间材质与 Obsidian 保持一致。
- 涟漪效果：发送想法时，会随机扔下一块石头，并在编辑器中心产生圆形涟漪扩散。
- 复用能力：水面复用了 Whiteboat 的共享水域、小船、指针导航、手机漫游、尾迹强度和天体投影。
音频与生命周期¶
- 水面音效：包含柔和的离线水面录音，声音会随小船移动渐弱。DSH 会记住静音选择。
- 原生保持：编辑器、工作区、预设、命令、权限、模型、推理级别、草稿和发送生命周期均保持 DSH 原生状态。
安装与启用¶
安装前请确保环境满足要求：Node.js >= 20.19 与 pnpm。
直接将 GitHub Release 中的预构建包安装到 DSH 的 web profile：
pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add https://github.com/Circleyan/whiteboat-dsh/releases/download/v0.1.2/whiteboat-dsh-0.1.2.tgz
安装完成后，启动 DSH：
pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 --profile web
典型用法¶
调整小船速度¶
在 DSH 设置的“白舟”页面，可以调整“小船跟随速度”。默认值为 100%，可在 50% 到 200% 之间调整。修改后立即生效，用于指针跟随、点击或触控目的地以及手机漫游，设置会保存在 DSH 的设置文档中。
静音音效¶
使用右上角的扬声器按钮，或在 DSH 设置的“白舟 -> 水面 -> 水面音效”中关闭声音。如果浏览器阻止自动播放，通过点击、触摸或按键可开始声音。音频归属在 AUDIO-LICENSE.md 中。
注意事项¶
- 数据安全：仅观看水面不会创建会话、提示词、AI 调用或写入。打开编辑器最多准备一个空白会话，仅非空发送才接受提示词。
- Canvas 限制：Obsidian 的涟漪是 Canvas 节点上下文，不会变成 DSH 节点视图。此包不复制 Canvas 节点、边或涟漪状态。
- 权限与访问：不涉及麦克风访问。安装预构建包的用户不需要私有仓库访问权限，预构建包包含所需核心代码，无私有子模块的运行时依赖。
- 浏览器限制：如果浏览器阻止自动播放，需通过用户交互（点击、触摸或按键）来开始声音。
- 功能演进：未来功能在
src/features/或适配器中，复用whiteboat-core。功能对等不是自动的。
总结¶
Whiteboat-dsh 通过“静水面”为 DSH 提供了一个独特的思考与准备空间，同时完整保留了 DSH 的原生工作流控制能力。对于需要在 AI 调用前进行环境设置或灵感捕捉的开发者，这是一个实用的工具。
- GitHub: https://github.com/Circleyan/whiteboat-dsh
- 目录: https://www.skillhub.cn/plugins/Circleyan/whiteboat-dsh
