白舟水面 Circleyan/whiteboat-dsh

面向 DeepSeek Harness 的 Whiteboat

Whiteboat 正在 DeepSeek Harness 生态系统中成长。0.1.x 版本从一片宁静的水面开始；后续的 Whiteboat 能力将加入同一个包，而不会成为独立的顶层仓库。

第一部分：水面

第一部分打开一片无品牌标识的水面，你可以在开始真正的 DSH Session 之前暂停或输入。仅仅看着这片水面不会创建任何 Session、Prompt、AI 调用或写入。打开编辑器最多准备一个空白 Session；只有显式发送非空内容才会提交一个 Prompt。

该水面复用了 Whiteboat 共享的水域、小船、指针导航、移动端漫游、唤醒强度以及天体投影。其编辑器、Workspace、Agent 预设、命令、权限、模型、推理级别、草稿以及发送生命周期均保持 DSH 原生。

该水面包含与 Whiteboat Home 相同的轻柔离线水声录音。声音会随小船移动而淡出。使用右上角的扬声器按钮，或在设置中的“白舟 → 水面 → 水面音效”将其静音；DSH 会记住该选择。如果浏览器阻止自动播放，普通的点击、触摸或按键即可启动声音。离开水面或隐藏页面会停止播放。不涉及麦克风访问。音频署名见 AUDIO-LICENSE.md。

Settings / 配置

打开 DSH 设置，在“白舟”页面可调整“小船跟随速度”。默认值为 100%，可在 50% 到 200% 之间调整；修改后会立即用于指针跟随、点击或触控目的地以及手机漫游，并保存在 DSH 的设置文档中。该设置只改变小船的航行速度，不改变水面、投影、Canvas 或 Session 语义。

Installation / 安装

准备环境：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.1/whiteboat-dsh-0.1.1.tgz

然后启动 DSH：

pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 --profile web

DSH 会打开浏览器；也可以按终端打印的本地地址手动访问。若已经全局安装同版本 DSH，可把上面命令中的 pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 替换为 dsh。

更新

从 GitHub Releases 选择新版本，并用对应 tarball URL 再次执行 plugin --profile web add。更新后重新启动 DSH。

卸载时运行：

pnpm dlx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove whiteboat-dsh

移动端输入

DSH 水面在移动端提供文本输入。它不会渲染麦克风控件、请求麦克风权限或调用浏览器语音识别 API。用户操作系统键盘所暴露的功能由操作系统和浏览器控制，而非本包，也不属于 DSH 能力契约的一部分。

开发

源码开发目前需要访问固定的私有 Circleyan/whiteboat-core 子模块。安装预构建 GitHub Release 的运行时用户不需要该仓库访问权限。

克隆时包含共享能力子模块：

git clone --recurse-submodules git@github.com:Circleyan/whiteboat-dsh.git
cd whiteboat-dsh
npm install
npm test
npm run build
npm pack
npm install 会在 DSH 测试或打包之前构建确切的 whiteboat-core 子模块修订版本。发布的 DSH 客户端包包含所需的核心代码，并且对私有子模块没有运行时依赖。

确切的 vendor/whiteboat-core gitlink 拥有共享的非整数高度水面环绕修复、通用船速归一化契约、候选设计系统基础，以及宿主中立的水声音播放。宿主安装和运行时验收仍然独立于该核心证明。

当前的兼容性目标是 @deepseek-ai/dsh 0.1.1-rc.2。DSH 仍处于开发者预览阶段，因此宿主兼容性会针对每个版本独立验证。

路线图边界

水面是第一个发布的特性，而不是本仓库的身份标识。未来的特性位于 src/features/ 或等效的宿主适配器下，并在其产品语义与 Obsidian 真正共享时复用 whiteboat-core。特性对等并非自动实现：每项能力都保留自己的 DSH 生命周期和运行时证明。