白舟水面Circleyan/whiteboat-dsh

面向 DeepSeek Harness 的 Whiteboat

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

第一片切片：水面

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

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

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.0/whiteboat-dsh-0.1.0.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 客户端 bundle 包含所需的核心代码，运行时并不依赖该私有子模块。

迁移基线固定为 whiteboat-core@daf4122，它负责共享的非整数高度水面环绕修复、通用小船速度归一化契约以及候选设计系统基础。宿主安装和运行时验收仍然独立于该核心证明。
当前兼容性目标是 @deepseek-ai/dsh 0.1.1-rc.2。DSH 仍处于开发者预览阶段，因此每个版本都会独立验证宿主兼容性。

路线图边界

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