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 插件,不注册工具、不改系统提示。

套件
dsh-plugin-longread
相容性
待驗證
版本
0.1.0
授權
MIT
最近更新
2026年9月19日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add 'github:ijry/DeepSeek-Harness-Desktop-Ultra#748806201eabfa13ef3ed9168e0f845410eeade5&path:plugins/dsh-plugin-longread'

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 上装了地雷——谁顺手加个工具,测试就红。
  • 老板键只是收起面板,不清屏、不擦历史:面板再打开还在原处。