ijry/DeepSeek-Harness-Desktop-Ultra--plugins-dsh-plugin-longread ↗★ 2
dsh-plugin-longread
Long-form reader for the DeepSeek Harness web GUI that renders a book as a fake agent session: a prompt, a few tool calls, a streamed reply. Imports .txt and .epub, ships with an original wuxia sample (九阴真经), and keeps the reading position per book. 摸鱼会话:把小说读成一场会话的 dsh 插件,远看像在 vibe coding,近看在看书。纯 GUI 插件,不注册工具、不改系统提示。
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add 'github:ijry/DeepSeek-Harness-Desktop-Ultra#748806201eabfa13ef3ed9168e0f845410eeade5&path:plugins/dsh-plugin-longread'ドキュメント
README 全文を読む ↗dsh-plugin-longread(摸鱼会话)
把一本小说读成一场 dsh 会话:上面是一句你自己敲的需求,中间是几条工具调用,下面是一段正在流式输出的「回复」——那段回复其实是小说正文。远看是在 vibe coding,近看在看书。
支持导入 .txt 与 .epub,按章记住读到哪儿,内置一本原创示例小说《九阴真经》。纯 GUI 插件:不注册任何工具、不改系统提示、agent 侧完全看不见它。 可发布到 dsh 插件市场。
一个插件 = 两个半边:
- host 半边(
exports "."):导入与编码嗅探、书架账本、章节切分,以及把一章正文编排成「假会话」的计划生成器。计划在 host 算完再以 JSON 下发,所以这套逻辑只有一份实现、一套测试。 - 浏览器半边(
exports "./client"):零依赖原生 DOM,一个单文件 IIFE。它只负责播:工具行从「运行中」翻成完成,然后正文一个字一个字打出来。
伪装是怎么搭起来的
一章正文被切成若干「轮」,每一轮长成一次真实的 agent 往返:
| 屏幕上的东西 | 实际是什么 |
|---|---|
| 顶上那句用户消息 | 你在输入框里敲的字(什么都不敲就用生成的那句) |
✳ 思考 3.4s | 随机但可重放的一行 |
● read src/lib/retry.ts + (End of file - total 412 lines) | 假的工具调用,工具名与结果串都是 dsh 真实工具的原话 |
| 正在打字的正文 | 小说 |
—— 上下文已压缩 · 继续 —— | 换章 |
头部右侧的 3/9 · 41% · 12:07 · 8.4k tokens | 章号、进度、开面板到现在的时长、按字数折算的假 token 数 |
头部左侧的 重构 · retry.ts | 伪装身份 + 本轮引用的文件名。书名不出现在任何一处 chrome 上 |
两个细节决定了它像不像:
工具调用引用的是真文件。 host 会扫一遍你自己的 dsh 工作区(有界:深度 4 层、跳过 node_modules/.git/dist、最多 400 个文件、缓存 5 分钟),假的 read / edit / grep 从这个池子里取路径。屏幕上出现的是你这个项目里真实存在的文件。扫不到工作区就退回一份内置路径表——伪装降级,面板照用。
同一章重开一次,伪装一模一样。 计划由 (bookId, 章号, 轮号, 伪装身份) 做种子生成,不是每次随机。否则续读时前后文对不上,一眼就能看出是编的。
代价也写明:这些工具行是假的,它们不读文件、不跑命令、不写任何东西;展开来看到的参数与输出是编的。真要留证据的话,这个插件帮不上忙。
数据存在哪(两个去处,各有理由)
| 数据 | 存法 | 为什么 |
|---|---|---|
| 书架、章节范围、每本书读到哪、阅读设置 | /dsh-plugin-longread.json | 画菜单要读它,所以它必须小 |
| 每本书的正文 | /dsh-plugin-longread-books/.txt | 一本书几 MB;塞进账本就等于每次列书架都要解析一部小说 |
正文与账本是两次写,顺序固定:先落正文,再提交账本行。反过来会出现指向空文件的书。账本坏了就改名留档(.corrupt-),不会让插件起不来。
导入:txt 与 epub
- txt:BOM 优先,然后严格 UTF-8,失败才退到 GB18030、Big5。中文小说有一半是 GB18030,猜错的结果是满屏乱码而不是报错,所以这里宁可多试一轮也不做有损解码。章节按
第N章/第 12 回/卷三/楔子/Chapter 3这些行首形状切;一个标题都没有的文件按 2400 字切成「第 N 节」。 - epub:自己读 zip(
inflateRaw,不引依赖),按container.xml→ OPF → spine 顺序取章,章名优先用toc.ncx。整本塞成一个文档的坏 EPUB 会退回按标题切章。 - 上传发的是文件本身的字节(
POST /import?name=,application/octet-stream),文件名走查询串。字节不在浏览器里解码——编码嗅探只在 host 做一次。单本上限 128 MB:真实的 epub 带封面图和插图扫描件,一本 40 MB 的教材很常见,而早先那版先在浏览器里 base64 一遍再塞进 JSON body,正是那种书一本都进不来的原因(体积涨三分之一,再撞上 24 MB 的 body 上限)。{ name, data: }的 JSON 老形状仍然收,脚本不用改。 - 导入完落在第一段真正的正文上:epub 的头几个 spine 项通常是封面、版权页和目录,落在那儿会让一本 70 万字的书看着像个空面板。
拖一个文件到面板上,或者在书架里点「导入文件…」。导入失败会在书架里留下一行原因(文件太大、切不出章节、不是 epub……),不是只闪一下就没了的提示。
键盘与命令
面板打开时:
Enter/空格/→推进一轮;正在输出时再按一次跳到本段末尾[]上一章 / 下一章Esc收起面板——也就是那个「老板键」,正在打的字立刻停住- 输入框里敲什么都会变成那一轮的用户消息,所以随便敲
斜杠命令(在输入框里):/lib 书架 · /toc 目录 · /next · /prev · /goto N · /speed N(字/秒,600 = 立即显示)· /font N · /persona refactor|debug|review|docs · /density off|low|medium|high · /auto · /stop · /resume · /help
摸鱼节奏:默认逐轮等待
默认情况下每轮正文打完会停在「思考中…」——远看是模型在想,其实是在给你留阅读时间;读完按「继续」(或 Enter)才推进下一轮。输出过程中随时可以 /stop 或点停止:已显示的字原地冻结,/resume 从断点接着演,不重复段落、不提前记进度。想要老的一口气连播行为,在设置里开「自动播放」,或输入 /auto。
可调的分寸
设置里能改:速度、每轮字数、字号、伪装身份(重构 / 排查 / 审阅 / 文档,各有自己的一套提示词与工具组合)、工具调用密度、思考块开关、自动播放、是否引用真实路径。带「下一章生效」标记的项要切章后应用——因为计划是整章一次算好的。
支持暗黑模式:颜色全部取自外壳自己的主题变量(--dsw-alias-*),跟着 dsh 一起亮暗,没有第二套配色需要维护。
内置的《九阴真经》
一部为这个插件原创的武侠中篇,九章,约 1.5 万字,随本包以 MIT 许可发布。除了「九阴真经」这个题目概念,人物、情节、文句全部原创,与任何已有作品无关。
它不是特例数据:种进书架时走的是和导入 txt 完全相同的 normalizeText + 章节切分,所以它同时是那条链路的夹具。第一次打开面板才会写进你的 DSH 家目录;删掉之后不会自己长回来。
已实现 / 尚未实现
已实现:txt/epub 导入、书架与删除、目录跳转、按轮记进度与续读(把已读的最后几轮瞬间补回来)、四种伪装身份、真实路径池、暗黑模式、老板键。
尚未实现(明写出来):
- 不认
.mobi/.azw3/ PDF,也不解密 DRM。 - epub 只取文字:图片、样式、脚注、目录层级一概丢掉。
- 没有搜索、书签、批注、字体族切换。
- 竖排与繁简转换都没有。
- 进度只按「章 + 轮」记,改了「每轮字数」之后,续读的位置会偏。
目录
src/
├── index.js # cordis 入口:账本 + 文件池 + 路由
├── host/
│ ├── sdk.js # dshHomePath —— 挡住 @deepseek-ai/* 运行时依赖的那道墙
│ ├── store.js # 账本(串行写 + 原子改名)与正文文件
│ ├── library.js # 加书 / 删书 / 进度 / 设置 / 种示例
│ ├── import.js # 编码嗅探、txt 与 epub
│ ├── zip.js # 够用的 zip 读取器(epub 用)
│ ├── files.js # 有界的工作区文件池
│ ├── routes.js # /dsh-plugin-longread 的 { ok } 信封
│ └── sample.js # 内置《九阴真经》
├── shared/
│ ├── protocol.js # 账本形状、设置的合法化
│ ├── chapters.js # 归一化与章节切分(纯字符串)
│ └── theater.js # 把一章编排成假会话(可重放)
└── client/index.js # 浏览器半边:座位、播放器、书架与设置
开发与验证
零运行时依赖,无需 npm install:
npm run check # 语法检查 src/ → 重新构建 lib/ → 再查 lib/(含生成的 client 包)
npm run build # 复制 host/shared 到 lib/ 并生成 lib/client.js
npm test # npm run build && node --test
测试里有一份手写 DOM 替身(test/dom-stub.mjs),test/client.test.mjs 把打好的 bundle 塞进去真跑一遍:座位挂载、工具行翻状态、正文逐段出现、Esc 收摊、dispose 收干净。这是唯一能验证「读起来像一场会话」的地方。
安装到 dsh
# 本仓库开发时
dsh plugin --profile
add link:plugins/dsh-plugin-longread
# 发布到 npm 后按包名安装
dsh plugin --profile
add dsh-plugin-longread
重启 dsh web 后侧栏出现「摸鱼会话」入口。包名和数据路径仍为 dsh-plugin-longread,已有书籍与阅读进度不变。
安全须知
- 不开监听端口、不发任何出站请求。 路由挂在 dsh 自己的 web 服务上,和 GUI 同源。
- 导入的书明文存在你的 DSH 家目录下,没有加密。同一台机器上能读你家目录的人就能读这些书。
- 它对 agent 完全透明:不注册工具、不加系统提示段落、不写会话日志。
test/entry.test.mjs里的 ctx 替身在ctx.tools与ctx.systemPrompt上装了地雷——谁顺手加个工具,测试就红。 - 老板键只是收起面板,不清屏、不擦历史:面板再打开还在原处。