dsh-novel-studio-lyjs

Novel Studio

一个独立于任务与聊天之外的小说分区，作为 DeepSeek Harness 插件运行。

侧栏出现一本书的图标；点开后是两块：左边书架（每部小说一个条目，标题旁一个箭头可以把它折成 一条竖边、把宽度全让给正文，选择记在浏览器里，没记录时默认收起），右边当前作品的十一个分区 （总览 · 人物 · 世界观 · 大纲 · 面板 · 正文 · 素材 · 草稿）加上 检索 · 进度 · 导入 · 设置 与 关系图 · 校验 · AI · 导出 八个工具标签。

检索在一个地方找遍整本书：正文（带行号）、每一条记录、每个字段、素材文件名、原始 YAML。 搜到的条目点一下就跳到它所属的分区并高亮，所以「这个名字到底在哪写过」不用挨个标签翻。

进度把写作量画出来：总字数、今日与本周、连续写作天数、30 天历史曲线，以及设了目标之后的 「还差多少 / 每天要写多少 / 按当前速度哪天写完」。它按每日净产出记账（progress.yaml）， 所以删掉一段正文是负的，不是「今天写了 0 字」。

关系图把人物、势力、地点、物品画成一张网：名字旁边的字段（势力的 leader、地点的 region、 物品的 owner）会自动连边，手写的边存在 relationships.yaml 里。只看人物时，各人所属的势力仍会 作为灰色上下文节点画出来，所以不会看到一堆孤立的点。

校验跑一遍书的内部一致性：悬空的边、指向未知条目的 [[链接]]、重号或断号的章节、还没回收的 伏笔、空分区等等，分「错误 / 提醒 / 提示」三档列出来。它只读，不会改任何文件。

导出把整本书渲染成一份可读的稿子：Markdown 手稿、纯文本、可打印的单页 HTML，或者一份完整的 JSON 备份（含所有分区数据与素材正文，且不含本地路径）。可以在面板里预览、复制、下载，也能落盘到该书的 publish/ 目录并留下 manifest.yaml 记录；扩展可以再添自己的格式。

导入与恢复是导出的回程：一份 JSON 备份可以整体恢复（逐分区报告会写什么、跳过什么、删什么） 或恢复成一本书；一段粘贴进来的 Markdown 手稿可以按它自己的 # 第一章 切章，追加或整本替换； 书里 materials/、publish/、import/ 下已有的 .md / .txt / .json 也能直接读进来。默认只预览， 确认之后才落盘，替换整本书还要再确认一次。

草稿箱在改章节之前先留快照，改坏了能退回去；从草稿恢复时会先自动存一份「恢复前的样子」， 所以退回一步本身也是可退的。

它同时是一块留给 AI 继续加东西的地盘：新分区、新路由、新工具都是 lib/extensions/ 下的一个 .js 文件，写完下一个请求就生效。见 EXTENSIONS.md。

为什么是插件而不是一堆文件夹

小说数据本身就是纯文件——每部作品在书库根目录下拥有一个完全独立的目录，结构化记录用 YAML， 正文用 Markdown。你可以直接打开文件夹阅读、手改、丢进 git，插件只是一层透镜。 多部作品之间不共享任何东西：人物、世界观、大纲、面板、正文互不干扰。

~/.dsh/novels//
  book.yaml                作品元信息
  settings.yaml
  characters/.yaml     人物
  relationships.yaml       关系
  world/                   世界观：rules / locations / factions / timeline / items / races / cultures / economy / glossary
  outline/                 大纲：tree / threads / scenes / foreshadowing / beats / hooks
  panels/                  面板：status / skills / equipment / tasks / reputation + custom/
  chapters/.md         正文（YAML front matter + Markdown 正文）
  meta/                    章节元信息
  drafts/                  草稿
  materials/               素材
  publish/                 发布产物

书库根目录默认 ~/.dsh/novels。位置按四层决定，先匹配先生效：显式参数 → 环境变量 DSH_NOVEL_ROOT → 面板上保存的位置（写到 ~/.dsh/novel-studio.yaml 的 root）→ 默认位置。 环境变量故意压过面板设置：部署或测试拿 DSH_NOVEL_ROOT 钉住书库时，面板就改不动它 （GET /root 回 locked: true），否则一次面板操作就能把测试的书写进真实书库。

面板书架底部写着当前位置、来源和一个「更改」：点「浏览」会打开系统自己的文件夹选择框（和「打开 工作空间」用的是同一个 Host 对话框，任意磁盘都能去），选好就填进输入框，再按「切换」才真正生效 ——浏览本身什么都不改。没有那个服务时（或直接手填路径也可以）会退回到面板内置的只读文件夹浏览器： 从「这台电脑」逐级点下去（只列文件夹，另有「上一级 / 磁盘 / 主目录」三个快捷跳转），按 「用这个文件夹」填进输入框。也可以勾上「把现有的书 一起搬过去」，确认后下一个请求就生效，不用重启——lib/api.js 每个请求都重新解析一次位置。 搬运用逐本 rename（跨盘退回拷贝 + 删除），撞名的书留在原处并在结果里记 target-exists， 永不覆盖。 新位置必须是绝对路径，且不能是当前位置的上层或子目录：两个书库互相套住，下次扫描就会把同一批 书数两遍。

路由	作用
GET /root	书库在哪、为什么在那（source）、是否被环境变量钉住、配置文件路径
POST /root	{ root, move? } 换位置（move: true 连书一起搬）；{ reset: true } 交还给默认
GET /folders	?path= 逐级列文件夹：不给 path 列这台电脑的盘符，给了就列该目录下的子文件夹（parent/home 供跳转）。只在这台 Host 没有原生文件夹对话框时给面板「浏览」当回落（有对话框时走 uiWorkspace.pickDirectory()）；只读，从不写盘

结构

文件	半边	作用
lib/index.js	host	稳定载体：注册前缀路由 + agent 工具，递归按 mtime 热重载 lib/ 下所有 .js
lib/api.js	host	HTTP 路由分发（/ping、/bootstrap、/schema、/root、/folders、/library[...]、/ext/...）
lib/ops.js	host	统一操作层：invoke(operation, payload)，HTTP / 工具 / 扩展共用，从不抛异常
lib/library.js	host	数据层：书库扫描、建书脚手架、原子写、计数、增删改查
lib/schema.js	host	声明式分区树（六种 kind）+ 扩展发现与合并
lib/records.js	host	通用条目读写（records / doc / chapters / files / raw）
lib/graph.js	host	关系图：节点、边、字段自动连边、图内异常（只读）
lib/edges.js	host	关系图的写方：增删改一条关系（手写行 or 记录字段）
lib/validate.js	host	一致性校验：13 条内置规则 + 扩展规则（只读）
lib/export.js	host	导出与发布：四种内置格式 + 扩展格式、publish/ 产物清单
lib/search.js	host	全库检索：正文（带行号）、记录字段、文件名、原始 YAML，同一个字段只报一次
lib/chapters.js	host	章节的读序与改名：排序计划、断号 / 重号 / 未编号诊断、重排、重编号，以及草稿箱
lib/progress.js	host	写作进度：progress.yaml 里的每日净产出、目标、节奏推算与 30 天历史
lib/import.js	host	导入与恢复：JSON 备份回灌、Markdown 切章、书内文件直读，默认 dry-run
lib/usage.js	host	每本书一本 token 账本（usage.yaml）：拼写归一化、累加、归零
lib/extract.js	host	写回正文后的补材料：把一段正文里新出现的人 / 地 / 物列成清单，交回前按 schema 校验，落库只填空字段
lib/prompt.js	host	纯函数的提示词装配：五个 AI 任务、设定渲染、预算截断、buildPrompt
lib/ai.js	host	AI 联动：取书里的真实数据 → 拼提示词 → 认路由 → 调 llm.stream 流式回吐
lib/tools.js	host	模型可见工具的定义（含扩展贡献的工具）
lib/extensions/	host	扩展目录；_ 开头的文件保留但不加载
lib/client.js	browser	唯一浏览器入口：注册 sidebar.panellist 与 main 两个 seam
EXTENSIONS.md	—	扩展开发指南
tests/*.mjs	—	冒烟测试，独立于 DSH 运行

为什么要 lib/index.js 这一层。 DSH 在进程启动时加载一次 host 半边，直接写在里面的代码改完必须 重启 App 才生效。所以除它以外的一切都放进会被重新 import 的模块里——index.js 每次请求递归扫描 lib/**/*.js 算指纹，指纹变了就换一个 ?v= 重新加载，下一个请求就是新代码。指纹是递归的， 所以新增一个扩展文件本身就会触发重载。只有 index.js 自身改动才需要重启。

浏览器半边由模块加载器在页面加载时取用，改完刷新页面即可。

给 AI 的接口

插件向 DSH 的 tools 服务注册十六个工具（经 ctx.inject(['tools'], …)，没有该服务时面板照常工作）：

工具	作用
novel_guide	读插件手册：overview / data / extend
novel_library	建书、列书、改元信息、删书
novel_records	读写真个分区里的条目；action: 'schema' 先看分区在哪
novel_graph	取关系网；kinds: 'list' 看有哪些节点类型，传数组则只取那几类
novel_link	增删改一条关系；派生边改的是记录字段，各分区同步
novel_validate	跑一致性校验，返回错误 / 提醒 / 提示三档清单（只读）
novel_export	渲染整本书并交回文本（md / txt / html / json），不写盘
novel_publish	落盘到 publish/：formats / list / write / delete
novel_extension	装扩展：scaffold 出模板 → write 写入 lib/extensions/
novel_ai	在聊天里跑这本书的 AI 任务：list 看菜单 / context 预览会读到什么 / run 真跑一轮（同样支持 pick 与 history）
novel_search	在整本书里找词：正文（含行号）、记录字段、文件名、原始 YAML，返回命中位置与片段
novel_chapters	读序计划（编号风格、断号 / 重号 / 未编号）、reorder 重排、renumber 重编号（dryRun 先看）
novel_drafts	草稿箱：list / read / save（改章节前的快照）/ restore（冲突要 force）/ delete
novel_progress	进度：get 拿总字数、今日 / 本周、连续天数、30 天历史与节奏；set 定目标字数与截止日
novel_import	导入：list 书内可导入的文件 / backup 读 JSON 备份（describe 先看内容）/ markdown 按标题切章
novel_extract	读一段正文并列出新条目：recognize 只给清单（不写盘）/ apply 把选中的条目补进各分区，只填空字段

novel_extension 的 write 会真的 import 一次做校验——语法错、顶层抛错、导出形状不对，都会把文件 回滚删除并说明原因。工具集合在指纹变化时重新同步，所以扩展新增的工具同样不需要重启。

AI 联动

面板的「AI」标签把这本书的真实数据喂给模型，做本章续写、新章节续写、润色、大纲推演、一致性审稿。 取的是当前书的关系图、人物、世界规则、术语、故事线、情节节拍、章节索引和校验问题，不是让模型凭记忆猜。

跑一轮之前可以勾选要喂进去的条目：面板会按分区列出这本书已有的内容（人物、地点、势力、物品、 种族、文化、规则、术语、经济、年表事件、卷章结构、线索、伏笔、节拍、钩子、场景、面板各项……）， 默认全选，取消勾选的条目不会进入提示词。分区列表由 lib/schema.js 推导，所以之后新增的分区 （包括扩展贡献的）会自动出现在勾选面板里。

路由	作用
GET /library/:book/ai/tasks	五个任务的可序列化菜单（key / zh / needs / hint）
GET /library/:book/ai/context	「AI 会读到什么」的预览计数 + 勾选目录（?pick= 反映当前选择，不含正文）
POST /library/:book/ai	跑一个任务，text/event-stream 逐块回吐（body 里的 pick 决定读哪些条目）

pick 的形状是 { 分区键: [条目 id, …] }：数组表示只留这些条目，空数组或 false 表示整段不要， true 表示整段都要，没提到的分区按默认（全要）处理。分区键就是分区路径（characters、 world/locations、world/timeline、outline/beats…）。形状不对会被在开流之前用 400 bad-pick 答掉，指向旧目录的未知分区键会被忽略。

多轮对话：body 里还可以带 history: [{ role: 'user' | 'assistant', content: '…' }]—— 上几轮的问答会排在这次提示词之前一起交给模型，所以「续写」能顺着上一轮接着写。只保留最近 12 轮、每轮最多 4000 字符（超出截断并加 …）；角色只能是 user 或 assistant。同样在 开流之前校验：形状不对用 400 bad-history 答掉。面板的 AI 标签自己维护这份对话（每本书各自 一本账，换书即新账，可一键清空），HTTP 调用方自行传 history 即可。

续写分成两条：continue（本章续写）从当前章节的正文末尾接着往下写；continue-new（新章节续写） 从这一章的结尾往后另起一章——不写章节标题、不复述上一章，篇幅也给得更宽（2400 token 对 1600）。 选中哪一条，下面「存到」就跟着换：本章续写默认追加进这一章，新章节续写默认写成新章节，并 按这本书现有的编号猜一个下一章名（第三章-… 往后数）填在可编辑的输入框里。章节文件由宿主的建章 路由落盘，重名自动加后缀，所以猜错也不会覆盖任何已有章节。

答案是你可以改的：右侧答案框是文本框，不是打印件——名字写错、句子别扭，直接在上面改。写回章节、 存成素材、写成新章节、「识别材料」读的都是你改过的这一版（走的是同一份文字）。答案框有高度上限 并可上下拖动调整，所以一致性审稿那种长回答也不会把下面的按钮顶出屏幕。

每本书自己的模型：AI 默认跟着 agentDefaultModel 当前选的 provider / model 走，但每本书可以在 面板「AI」标签顶部换成自己的，存进 book.yaml 的 aiModel: { provider, model, reasoningEffort? }。 书与书之间、书与全局选择之间互不影响：lib/ai.js 的 bookSelection(book, default) 只把这本书的 选择并到默认之上，且 reasoningEffort 只在路由完全相同时才继承（同 provider 同 model）—— effort id 属于某个具体模型，搬到别的模型上只是猜。记录只填一半（有 provider 没 model）按「没选」 处理，于是这本书照旧跑默认。

思考强度（reasoningEffort）：模型能跑的档位由部署自己的模型登记表决定（本机 deepseek-* 是 off / low / high / max，模型自带默认 high），面板在模型选择旁列出「跟随模型默认」+ 这些档位。 选一档就照上面那样写进 book.yaml；选「跟随模型默认」就是不带这个字段、交回模型自己——这也是清除 的办法。档位来自 GET /library/:book/efforts，面板既不问也不猜；问不到（模型不可描述、旧宿主没有 这个接口）就不显示这一栏，而不是拿一个可能被 provider 拒掉的 id 去试。日常续写调低一档，省时间也省 token。

路由	作用
GET /library/:book/model	这本书自己的路由 + 它此刻会继承的默认 + 本机可用的模型目录
POST /library/:book/model	{ provider, model, reasoningEffort? } 保存；{ clear: true } 交还给默认
GET /library/:book/efforts	这个模型能跑的思考强度档位 + 它自己的默认档（带 ?provider=&model= 可查正在挑选、尚未保存的模型）

篇幅与用量：body 里可以带 words（1–20000 的整数），提示词会追加一段「### 篇幅要求」，这一轮 的 maxTokens 也随之抬到 min(8000, max(任务默认, N × 2))；不是整数、或超出范围，用 400 missing-argument 答掉（空着就是不要求）。start 事件回传这一轮的 words，done 事件回传 usage。开着流花的钱也算钱：每本书一本 usage.yaml，只要这一轮报了 token 就记一笔，失败收尾 的那轮同样记；拼写按 provider 常见的几种归一化（input_tokens / promptTokens …），没有 total 就自己加。面板上分两层看：正文下面那行是本轮（跑完就刷新，下一轮开始时清零），累计藏在一个 可折叠的子面板里（「累计用量 Σ …」，展开时才重新读一遍账本，里面还有轮次、起始 / 最近时间与一键 归零）——写作时盯的是一轮花了多少，不是这本书一辈子的总数。

费用面板里的归属：usage.yaml 是面板自己的账，跟部署里的计价插件（dsh-cost-meter）是两本账。 插件挂在全局的 llm/stream 上，把每一次调用按 options.sessionId 分进「一个会话一行」，没有 sessionId 的调用只进日 / 月合计、没有会话行——小说区的调用是手搓的（没有 agent loop 认领），所以 过去只能趴在「无归属」里，按会话看费用时根本看不见。lib/ai.js 的 attributionId(book, bookDir) 现在给这类调用一个自己的会话 id（novel-studio:），补材料那次调用同样记在所属书的名下。 这个 id 会被 provider 直接写成 HTTP 头 x-deepseek-harness-session-id，而头值只能是 Latin-1 —— 非 ASCII 的书名（例如中文）会让每一次调用都以 transport failed 失败，所以字符集容不下的书名 统一落到共享的 novel-studio 一行（ASCII 书名自成一行）。每本书一行看起来更细，但费用面板对没有 标题的会话只显示 id 的前 14 个字符，novel-studio: 前缀就占了 13 个，所以强行编码成乱码反而更读不懂。

路由	作用
GET /library/:book/usage	这本书累计的输入 / 输出 / 缓存读 / 缓存写 / 合计 token 与轮次
POST /library/:book/usage	{ reset: true } 把账本归零（别的 body 一律 400 bad-request）

写回正文后补材料：AI 标签的写回条旁边有个默认勾上的「顺便补材料」开关——写回成功后，立刻用这 本书自己的模型读一遍刚写进去的那段，把新出现的人 / 地 / 物 / 规则列成清单。清单默认全勾，只有点 「补充到各区域」才落盘；落盘时只填空字段、tags 取并集，作者已经写好的那一行永不覆盖。识别这 一步本身不写任何东西，但它花的 token 同样记进这本书的账本。

正文里的「识别材料」：章节面板的动作行上多了一个同名按钮，勾选要读的章节再开始——一次读一章， 不必先把正文交给 AI 写回，也不用把整本书扫一遍。正在编辑的那一章读编辑器里的文字（含还没保存的 改动），其它章读已保存的正文；每一章各算一次调用、都记进同一本账，读回来的清单合并成一张表：同一个 条目在几章里都出现时并成一行，先出现那一章给出的值不会被后面的覆盖，只补它没写的字段。清单同样默认 全勾，只有点「补充到各区域」才落盘。

一次提交的正文会被切片读：一次调用要求模型给出一份长 JSON，而长回答正是最容易坏的一种—— 回话被截断或裹上解释，整份清单就解析不出来（表现就是「模型没有按要求给出 JSON」）。所以正文按 1200 字（SLICE_MAX_CHARS）切成片、每片单独问、各自拿回一小份 JSON，再合并成上面那张表。某一片 读不懂就再问一次（SLICE_TRIES）；仍然读不懂时它被记成「有 N 个片段没能读懂」写在清单上方， 不影响其它片段——只有所有片段都读不懂才整批报错。plan 上因此多了 slices（片数）与 skipped（哪些片没读懂）。

勾选章节的抽屉里也能换模型：抽屉顶上就是这本书的模型与思考强度表单，和「AI」标签里的是 同一个组件，改一处两处同步；写回正文那一步用的也是这本书的路由。换书或换标签都不会碰到别 的书的设置。

路由	作用
POST /library/:book/extract	{ chapter?, passage } 或 { chapters: [{ id, passage }] }（一章一次调用，再合并）→ 用本书模型读出 plan（entries / dropped / counts / slices / skipped），不写盘
POST /library/:book/extract/apply	{ entries: [...] } 把选中的条目写进各分区，返回 written / updated / skipped

哪些分区是候选由 schema 决定：records 或 doc 且声明了标题字段的单元，章节 / 素材 / 草稿不在其中； 扩展新加的分区自动成为候选。模型给出的区域名或字段名不在 schema 里就丢掉并记进 dropped，select 字段的值必须命中它自己的选项表，一次最多 60 条。

目录来自 host 的 llm.listProviders() / llm.listModels(provider)，在 lib/index.js 里由 shapeCatalog() 归一化（30 秒缓存）；没有 llm 服务、或某个 provider 列不出来时降级成空目录， 绝不影响已经保存的路由。LlmProviderInfo / LlmModelInfo 的字段名没有钉在宿主契约里，所以 id / key / provider 与 id / model / key 两种写法都读。

命中的 host 服务是 llm（ctx.llm.stream(options)）与 agentDefaultModel（currentSelection() 给出当前选的 provider / model）。两个都经 ctx.inject(…) 取得，不进 inject 声明—— 可选依赖不该能让整个面板消失；lib/index.js 把句柄交给可重载的 api 层，所以它们随时可以缺席。

两条设计约束：

• 开流之前可能失败的一切，先用普通 JSON 答掉。 SSE 头一旦发出，未知章节或未选模型就只能 报成「被截断的回答」。所以 prepareTask（取数 → 拼词 → 认路由）和 streamPrepared（开流） 是分开的，后者只在万事俱备后才被调用。
• 请求先于部署被判断。 缺参数、未知任务是调用方自己能改的（400）；这台机器上没有可用的 llm 服务不是（503）。顺序因此是「取数 → 拼词 → 认路由 → 查服务」，坏请求永远不会被 说成「服务缺失」。

提示词装配在 lib/prompt.js 里是纯函数：同样的输入永远得到同样的提示词，测试不需要联网。 每个区段都有字符预算，且把截断讲给模型听（…（已截断，原文还有 N 字）），避免它自信地编造 被切掉的人物。

检索、章节、草稿、进度、导入

这几块共用同一套约定：读走 GET，写走 POST，凡是会大改文件的都先给一份 dry-run， 业务拒绝一律是普通 JSON（400 参数问题 / 404 没有这个条目 / 409 需要确认），不是半截结果。

路由	作用
GET /library/:book/search	?q=&limit=&section= 找词；每命中给分区、条目、字段、正文行号与片段
GET /library/:book/chapters	读序计划：章节、字数、编号风格，以及断号 / 重号 / 未编号
POST /library/:book/chapters/reorder	{ ids: [...] } 把章节摆成这个顺序（必须是当前章节的一个排列）
POST /library/:book/chapters/renumber	{ start, style, width, separator, dryRun, retitle } 重编号
GET /library/:book/drafts	快照列表，新在前，带章节标题、字数、大小与时间
POST /library/:book/drafts	{ chapter, body?, note? } 存一份；body 省略即取章节现文
POST /library/:book/drafts/restore	{ name, force? } 退回去；内容有变先答 409，force 才覆盖
DELETE /library/:book/drafts/:name	删一份快照
GET /library/:book/progress	目标、总字数、今日 / 本周、连续天数、30 天历史、节奏推算
POST /library/:book/progress	{ words, deadline } 设目标（null 清除；日期要 YYYY-MM-DD）
GET /library/:book/settings	这本书的偏好
POST /library/:book/settings	{ theme, autosave, fontSize, wordGoal } 浅合并保存
GET /library/:book/import	书里可导入的文件（materials/、publish/、import/ 下的 md / txt / json）
POST /library/:book/import	{ kind: 'backup' | 'markdown' | 'file', … }，默认 dryRun: true

检索不是全文搜索的简化版，而是把「这本书里所有能写东西的地方」都扫一遍：正文按行报位置， 记录按字段报，素材按文件名报，原始 YAML 按整段报；同一个字段里多个词都命中才算一条， 所以结果不会同一句话报两遍。?section= 可以只看一个分区。

章节顺序是文件名的一部分，所以重排与重编号真的会改文件名——因此采用两阶段改名 （先全部改成临时名再改成目标名），避免两个章节互换时撞名。style 支持 cn（第一章）、 arabic（第1章）、prefix（01-）；带着编号的标题只在原标题自带序号时才跟着改， 免得把「第一章 落幕」改成「第三章 落幕」。改完会同步平移 progress.yaml 里的章节键， 不动历史产量，否则重命名会被记成一次亏损。

草稿箱的存在理由是「改之前先留一份」。所以从草稿恢复时若章节已经被改过，先答 409 让你确认； 确认之后它做的第一件事是把当前正文再存成一份自动快照，然后才写回——退一步永远可退。

进度按每日净产出记账，而不是看文件 mtime（mtime 分不清「改了这一段」和「重写了整章」）。 删章节是负数。没有目标时只报已有的事实；设了目标才有「每天要写多少 / 哪天写完」。

设置存 settings.yaml（theme / autosave / fontSize / wordGoal），面板里改的是这几项； 未知键原样留着，所以扩展可以往同一个文件里加自己的偏好而不被清掉。fontSize 是阅读字号： 章节正文、AI 结果、AI 多轮记录、导出预览都跟着它走，所以「字太小」只需要改一个数字。

放大预览给每一处文本一个整窗的读法。面板本身是别人分给它的一个窄列，长文没地方展开—— 导出预览本来就截到 4000 字、AI 结果只能在自己的小框里滚。现在 AI 结果、AI 多轮的每一轮答案、 章节正文、素材文件、整份 YAML、记录里的长字段、导出预览旁边都有一个「⤢ 放大」按钮，点开是一层 覆盖整个窗口的只读视图：按窗口宽度折行、滚动阅读，Esc 或点空白处关闭，A－ / A＋（或键盘 + / -）调字号、恢复回 1:1、复制全文拿走。字号以本书设置里的阅读字号为基准再乘一个倍数， 倍数存在浏览器的 localStorage（dsh-novel-studio.zoom），下次打开还是这个大小。只读是刻意的： 它是一个视图，不是第二个编辑器，不可能从这里误写回正文。

开发

# 全部 12 套顺序跑一遍（约 10 秒，输出每套自己的逐项结果）
npm test

# 冒烟测试（不需要 DSH 在跑）
node tests/library.smoke.mjs   # 57 项 · 数据层与文件夹浏览
node tests/units.smoke.mjs     # 52 项 · 条目读写
node tests/ops.smoke.mjs       # 99 项 · 操作层与扩展
node tests/graph.smoke.mjs     # 80 项 · 关系图与校验
node tests/export.smoke.mjs    # 70 项 · 导出格式与发布
node tests/edges.smoke.mjs     # 59 项 · 关系的增删改与字段回写
node tests/prompt.smoke.mjs    # 66 项 · 提示词装配、接地、可勾选分区的渲染与预算截断
node tests/ai.smoke.mjs        # 198 项 · 取数、勾选、多轮历史、路由、流式回吐、篇幅要求、token 账本、调用归属、AI 扩展缝（假 llm 桩，不联网）
node tests/extract.smoke.mjs   # 148 项 · 补材料：候选分区取舍、严格 JSON 解析与丢弃、只填空字段、tags 并集、长文切片与重试、按章连读与合并、账本（假 llm 桩）
node tests/bindings.smoke.mjs  # 23 项 · 多值字段（势力成员 / 物品持有者 / 面板归属）与多对多绑定、派生边
node tests/model.smoke.mjs     # 46 项 · 每书独立模型：归一化、继承规则、目录归一化、路由真的进了调用
node tests/studio.smoke.mjs    # 79 项 · 检索、章节重排与重编号、草稿箱、进度记账、导入 dry-run、设置、浏览器半边的文本契约与装载

# 对运行中的 DSH 打真实 HTTP
node tests/http.e2e.mjs        # 207 项 · 真实路由（含 /library/:book/model、/efforts、/extract（单段与按章）、/root 与 /folders）+ 热重载

# 安装到 desktop profile（本地 link）
dsh plugin --profile desktop add link:

npm 包名是 dsh-novel-studio-lyjs（dsh-novel-studio 这个名字在 npm 上已被别人的另一个插件 占用），GitHub 仓库名仍是 dsh-novel-studio。装的时候命令里写的是目录，所以名字差别不影响本地安装。

安装后 dsh.profile.bundles 会加入 dsh-novel-studio-lyjs，node_modules/dsh-novel-studio-lyjs 是指回本目录的