dsh-stealth-reader

在 DeepSeek Harness 的会话界面里看小说。屏幕上永远是「一个正在跑的长任务」。

上图的右侧会话区里，小说正文和工作痕迹行交错出现，正一个字一个字长出来 —— 顶部的标题栏与 Tab、底部的输入框、左侧的栏，全都是真实的界面，插件只占据中间那段消息区。

它是什么

一个 DSH 客户端插件（纯前端，宿主侧不做任何事）。导入 .txt / .epub， 按一下快捷键，右侧会话区就变成一股正在流式输出的日志流：

> Read 第一章 山雨                                     [1/3]

  沈砚背着书箱走到半山腰时，雨已经落下来了。

  起初只是几点，落在青石板上洇开小小的圆。

  "前面有座亭子。"走在后面的老仆喘着气说。

                    check why the deploy script is slow

  沈砚抬头。雾气正从谷底涌上来，把山路吞掉了一半。

  他加快了脚步。

小说段落以 DSH 自己的两种身份出现：AI 回复正文，或者带左侧细竖线的子内容 （约七成是后者，视觉上就是"工具输出"）。章节标题伪装成一次 Read 工具调用 —— DSH 的消息流里没有"章节标题"这种东西。

三个不显然的设计

工作痕迹行是真的。 日志流里那些工具调用、命令摘要、用户提问，来自你当前会话的真实历史， 不是编出来的假日志。"这看起来就是我的会话"这件事因此是真的 —— 编出来的日志经不起多看两眼。

退出只认鼠标。 鼠标移动 1px 或点一下，立刻回到 DSH 真实界面。键盘不会退出 —— 否则读到一半会被自己按没（翻页、跳章都要用键盘）。唯一例外是书单：它要靠鼠标点， 所以在书单里鼠标不触发退出，出口是快捷键（见 ADR-0007）。

没有"书页模式"。 衬线字体 + 居中 + 大留白的排版一眼就是小说阅读器，那本身就是最大的暴露面。 所以只有一种形态：伪装成日志流的正文。

安装

需要 DeepSeek Harness 的 dsh CLI，以及一个启用了 Web 客户端的 profile（下面以 web 为例）。

从 GitHub 安装（推荐） —— 固定到一个具体 commit，装到的内容永远可复现：

dsh plugin --profile web add 'github:Tonited/dsh-stealth-reader#<40 位 commit>'

从 npm 安装：

dsh plugin --profile web add dsh-stealth-reader

从本地目录安装（改源码时）：

dsh plugin --profile web add 'file:/path/to/dsh-stealth-reader'

三种方式都不需要手工登记：dsh plugin add 会把任何声明了 dsh.bundle 的依赖 自动加进 profile 的 dsh.profile.bundles 层列表，卸载时也会自动移出。

装完重启 dsh web（新增插件行需要重启；之后的改动都是热替换，刷新页面即可）。

权限与风险

项目	情况
网络	不发起任何网络请求，无遥测、无外部服务
文件	只读你主动拖进窗口的书文件；不写工作区目录，不改 profile 文件
存储	书与进度只存在浏览器 IndexedDB（库名 dsh-stealth-reader），清除浏览器数据即消失
会话数据	会只读当前会话的消息历史（用来取真实工作痕迹行），仅在本地渲染，不外发
DSH 本体	只挂 shell.overlay 与 conversation.input.dock 两个槽位；不修改、不替换任何 @deepseek-ai/* 官方包
依赖	零运行时依赖（epub 解压库在构建期打进 lib/client.js）
生命周期脚本	无 preinstall / install / postinstall / prepare

已知风险，请务必理解：

• 这是"紧急遮屏"，不是访问控制。 它只覆盖 DSH 的会话区。任务栏、窗口标题、 浏览器标签页、历史记录、以及 DSH 之外的任何东西，它都管不了。不要把它当成对付技术审计的手段。
• 快捷键没有仲裁。 DSH 客户端插件没有键位绑定 API，插件只能自己挂 window 的 keydown 监听。 如果别的插件也用了 Ctrl+Shift+Alt+Z，按下时两边都会响应。要改键位见下方「手感旋钮」。
• stream 态下鼠标一动就退出，包括你只是想挪一下鼠标。这是刻意的：被撞见时没有时间判断状态。 书单是例外 —— 在书单里鼠标不触发退出（否则点不到书），此时要靠快捷键收场； 而且书单里的书名是明文的，别让它长时间挂在屏幕上。
• 屏幕上会出现你真实在做的事。 工作痕迹行取自真实会话历史（路径会被脱敏）， 但它终究是你的会话内容 —— 在共享屏幕时请自行判断。

用法

你想做的事	操作
开始看书 / 藏起来	Ctrl+Shift+Alt+Z（同一个键来回切）
回到工作界面	动一下鼠标或点一下（书单里除外，那儿只能用快捷键）
翻页	滚轮 / 空格 / PageDown
上下微调	↑ ↓（一次滚十行正文）
看得比它写得快	按住 Shift + ↓ / → 快进，松开回到正常速度
跳章	← →（也可用 [ ]），一次一章
快速跳章	按 L 打开书架，点书行右侧的 ≡ 展开步骤清单，滚动点选
换书 / 导入	按 L 打开任务列表；把文件拖进窗口即可添加

任务列表伪装成一份「最近的任务」，进度就是百分比：

阅读进度

进度记的是你读到哪儿（已输出字符占全章的比例），不是滚到哪儿。

关掉再打开，会精确停在上次离开的地方，视口自动跟过去，从那儿继续长出来。 读到章末关掉就停在章末，想继续按 → 翻下一章。

导入

• .txt：自动识别 UTF-8 / GBK。
• .epub：插图会保留（渲染成占位图），DRM 加密的书会明确报错且不入库。
• 书只存在本机浏览器的 IndexedDB 里，不上传、不进入工作区目录。

手感旋钮

节奏、键位、占比都是源码常量，各自只有一处：

想调什么	去哪
逐字输出的节奏（速度 / 每行最短最长）	src/client/typing.ts → DEFAULT_TEMPO
快捷键	src/client/keys.ts → DEFAULT_SHORTCUT
↑ ↓ 一次滚几行	src/client/scroll.ts → LINES_PER_ARROW
工作痕迹的占比	src/client/stream.ts → DEFAULT_TOOL_OUTPUT_RATIO

改完跑 pnpm run check && pnpm run deploy。

一个必须知道的取舍

伪装阅读牺牲了阅读舒适度：等宽字体、行间插着工作痕迹行，比在阅读器里读书累。 这是刻意的取舍 —— 目标是"屏幕任何时候看起来都像在工作"，而不是"读得舒服"。

开发

pnpm install
pnpm run check     # 类型检查 + 构建 + 测试（171 个）
pnpm run build     # 只构建
pnpm run deploy    # 构建并拷进已装好的 DSH profile
pnpm run watch     # 构建并监听

契约与设计理由在 SPEC.md、CONTEXT.md 与 docs/adr/； DSH 界面的实测数据（选择器、样式、事件形状）在 docs/dsh-conversation-ui.md。

为什么 lib/ 进版本库

构建产物 lib/ 是提交进仓库的，而不是发布时才生成。

从 git 安装第三方 DSH 插件时不应该执行构建脚本 —— 仓库里的 prepare 脚本是典型的供应链攻击面， pnpm 默认就拒绝执行（ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED）。所以安装时直接消费仓库里 已经构建好的 lib/，全程没有任何生命周期脚本。

代价是产物可能与源码脱节，所以 CI 里有一条检查：源码改了但 lib/ 没重新构建会直接失败。 改完源码请务必提交重新构建后的 lib/。

许可

MIT。

截图与文档中的书籍《云中记》是为演示虚构的文本，不是真实出版物。