dsh-novel-writer 5.1.1 → 5.5.0

package/README.en.md

@@ -16,7 +16,9 @@ Sentence, emotion and semantic analysis all run **on your machine**: a 24MB Chin
 **zero API cost, your manuscript never leaves the device**. Built for DeepSeek Harness (DSH); the same engine is also
 exposed as a **stdio MCP server** for Claude Desktop / Cursor.
 
-[Install](#install) · [The writing loop](#the-writing-loop-end-to-end) · [60-second start](#60-second-start) · [See the output](#see-the-output) · [The 18 tools](#provided-tools-18) · [MCP server](#mcp-server-usable-outside-dsh)
+🔗 **Website**: <https://siweina.github.io/dsh-novel-writer/> · **Technical docs (parameters and examples for all 18 tools)**: <https://siweina.github.io/dsh-novel-writer/tools/>
+
+[Website](https://siweina.github.io/dsh-novel-writer/) · [Technical docs](https://siweina.github.io/dsh-novel-writer/tools/) · [Install](#install) · [The writing loop](#the-writing-loop-end-to-end) · [60-second start](#60-second-start) · [See the output](#see-the-output) · [The 18 tools](#provided-tools-18) · [MCP server](#mcp-server-usable-outside-dsh)
 
 ---
 
@@ -35,6 +37,8 @@ exposed as a **stdio MCP server** for Claude Desktop / Cursor.
 > **Token-saving mode (new in v5.1.0)**: the sidebar's **Lean workflow** switch (or `novel_sentence_config` with `leanWorkflow=true`) keeps exactly one rule — **call tools on demand**: no automatic self-checks, no re-checking fix lists, no registry updates; report tools return the brief form unless you explicitly pass `brief` (style report: 181 chars vs 1725 for the full one).
 >
 > **v5.1.0 cost & feel fixes**: v5.0.0 had turned "always run a self-check after writing + the closing trio" and "mark every item + verify repeatedly" into mandatory checklists — one chapter went from 3 tool calls to 6, and revising took 30+. Together with "build sentences to the skeletons" and "fix any out-of-band dimension", that made prose stiff. This release makes all of it **on demand**: a chapter now takes **2 calls and up**, the fix-list cap dropped **40 → 12** with only the worst paragraph per dimension, and it now says plainly that **out-of-band ≠ defect** (keep lyrical / psychological / elliptical passages when they read fine — `mark` them `skip`).
+>
+> **v5.2.0 official sidebar integration**: the browser half no longer injects DOM into the host. It uses the DSH 0.2.0 seats — `ctx.sidebarRightTabs.register` declares the tab type, `sidebar.right.pane.tab` provides the body (tab chip, docking, splitting, per-session layout and theming all belong to the host), `sidebar.footer.action` adds the left-sidebar entry, and `sidebar.right.pane.tab.title` keeps an open tab's label following language changes. Hosts without these services fall back to the old path automatically; tools, parameters and the state file are unchanged (still 18 tools).
 
 ## What problem does it solve
 
@@ -171,7 +175,7 @@ fixAnchors：3 条原著锚段（对话 / 心理 / 描写各一条，供逐句
 6. **Emotion purification & quantification**: strong/weak emotion-word grading, pollution detection, caveat warning + AI re-verification; Valence sliding window → variance V / delta Δ / conflict index C + implicit imagery carriers.
 7. **Worldview & pragmatics detection**: auto cultural-baseline detection with confidence; speechStyle title/honorifics/rituals/tone norms; genre & theme + webnovel signals.
 8. **Writing toolkit**: plot tracking / five settings tables (characters·locations·items·timeline·worldview) / chapter summaries / continuity audit / batch import / style check / continuation writing.
-9. **Per-tool UI toggles**: 「写作助手功能」 ("Writing Assistant") sidebar panel (master + grouped tool toggles + feature toggles + prompt mode/scene/**lean workflow**), plain-language labels, data-dir usage & semantic-engine status display.
+9. **Per-tool UI toggles**: 「写作助手功能」 ("Writing Assistant") sidebar panel (master + grouped tool toggles + feature toggles + prompt mode/scene/**lean workflow**), plain-language labels, data-dir usage & semantic-engine status display.**Since v5.2.0 the panel uses the official DSH 0.2.0 seats** — it is a regular tab in the right sidebar (dock, split, float; layout persists per session), opened from an icon next to Settings in the left sidebar (icon + label when wide, icon only in the 56px rail) and listed on the “+ → guide” page; hosts older than 0.2.0 fall back to the previous mounting path automatically.
 10. **Style Baseline**: Six writing metrics (syntactic complexity / modifier density / abstraction / action density / hedging / gap index) + per-chapter μ±σ baseline band; `novel_style_report` outputs the band, `novel_style_check` compares new chapters (in-band ✓ / out-of-band ⚠); per-metric ±% tolerance configurable in the sidebar (**recommended = 1.5× σ of the book's chapter variance**, rounded, clamped to ±10%~100%; leave blank to use recommended) — free theme, writing style kept inside the band.
 11. **Writing sentinels**: `novel_continuity_check` extended — ①**bridge check** (`chapter`: time jumps / semantic distance / character continuity / hook handoff, with quoted evidence) ②**OOC check** (`ooc`: per-character emotion baseline deviation) ③**outline drift** (`outline`: direction vs body keyword overlap); **brief mode** for report tools.
 12. **Original mode & creation files**: fill in creation settings in the sidebar (worldview/characters/forbidden/main conflict/genre/extras, blank = model decides, per-book profile library); novel_outline maintains creation files (bible/characters/outline/hooks/status), enforcing the bible → outline → hook chain with dynamic batches (10→20→30 chapters) to prevent plot jumps and OOC.
@@ -181,6 +185,8 @@ fixAnchors：3 条原著锚段（对话 / 心理 / 描写各一条，供逐句
 
 ## Provided Tools (18)
 
+> Parameters, return shapes and worked examples for every tool live in the [online tool manual](https://siweina.github.io/dsh-novel-writer/tools/).
+
 | Tool | Description |
 |------|-------------|
 | `novel_books` | List all books in library |
@@ -292,3 +298,7 @@ tool results; a plugin load failure cannot affect the DSH host process.
 ## License
 
 [MIT](./LICENSE)
+
+---
+
+🔗 [Website](https://siweina.github.io/dsh-novel-writer/) · [Technical docs](https://siweina.github.io/dsh-novel-writer/tools/) · [GitHub](https://github.com/siweina/dsh-novel-writer) · [npm](https://www.npmjs.com/package/dsh-novel-writer) · [MCP server manual](./mcp/README.md)

package/README.md

@@ -15,7 +15,9 @@
 句式 / 情感 / 语义全部**在本地算**：24MB 中文模型随包分发，**零 API 花费、正文不出本机**。
 为 DeepSeek Harness（DSH）打造；同一套能力也可作为 **MCP 服务器**给 Claude Desktop / Cursor 使用。
 
-[安装](#安装) · [写作流程](#写作流程一条能走完的闭环) · [60 秒上手](#60-秒上手) · [看看输出](#看看输出长什么样) · [18 个工具](#提供的工具18-个) · [MCP 服务器](#mcp-服务器非-dsh-用户也能用)
+🔗 **官网**：<https://siweina.github.io/dsh-novel-writer/> · **技术文档（18 个工具的参数与示例）**：<https://siweina.github.io/dsh-novel-writer/tools/>
+
+[官网](https://siweina.github.io/dsh-novel-writer/) · [技术文档](https://siweina.github.io/dsh-novel-writer/tools/) · [安装](#安装) · [写作流程](#写作流程一条能走完的闭环) · [60 秒上手](#60-秒上手) · [看看输出](#看看输出长什么样) · [18 个工具](#提供的工具18-个) · [MCP 服务器](#mcp-服务器非-dsh-用户也能用)
 
 ---
 
@@ -34,6 +36,8 @@
 > **省 token 模式（v5.1.0 新增）**：侧边栏「精简工作流」开关（或 `novel_sentence_config` 传 `leanWorkflow=true`）打开后只保留一条原则——**工具按需调用**：不主动跑自检、不复测清单、不登记伏笔/钩子/摘要；报告类工具未显式传 `brief` 时默认走精简输出（风格画像实测 181 字符 vs 完整 1725 字符）。
 >
 > **v5.1.0 成本与手感修复**：v5.0.0 曾把「写完必须自检 + 收尾三件」「改稿逐条 mark + 反复 verify」写成必做清单，一章从 3 次调用涨到 6 次、改稿要 30+ 次；同时"照骨架造句"与"任一维度出带必改"会让文章越改越僵。本版全部改回**按需**：写一章 **2 次调用起**，改稿清单上限 **40 → 12 条**、同一维度只报最严重的 1 段，并明确了**出带不等于缺陷**（抒情/心理/留白段读起来不别扭就保留，可用 `mark` 标 `skip`）。
+>
+> **v5.2.0 官方侧边栏适配**：浏览器半边不再往宿主 DOM 里塞东西。改用 DSH 0.2.0 的官方席位——`ctx.sidebarRightTabs.register` 声明 tab 类型 + `sidebar.right.pane.tab` 提供正文（tab chip、停靠、分栏、每会话布局、深浅主题全归宿主）+ `sidebar.footer.action` 放左栏入口 + `sidebar.right.pane.tab.title` 让已打开的 tab 跟随语言切换。检测不到这些服务的宿主自动回退旧路径；工具、参数、状态文件完全不变（仍 18 个工具）。
 
 ## 它解决什么问题
 
@@ -168,7 +172,7 @@ fixAnchors：3 条原著锚段（对话 / 心理 / 描写各一条，供逐句
 6. **情感净化 + 量化**：强/弱情绪词分级、污染源检测、caveat 预警 + AI 复核；Valence 滑动窗口 → 方差 V / 斜率 Δ / 矛盾指数 C + 隐性意象载体。
 7. **世界观与语用检测**：文化基准自动判断（西/东/混合）+ 置信度；speechStyle 称谓/客套/仪式/语气规范；题材流派 + 网文信号。
 8. **写作辅助全家桶**：伏笔登记表 / 设定五张表（人物·地点·道具·时间线·世界观）/ 章节摘要 / 连贯性审计 / 批量导入 / 风格自检 / 续写辅助。
-9. **全工具 UI 开关**：侧边栏「写作助手功能」面板（总开关 + 工具开关分组 + 功能开关 + 提示词档位/场景/**精简工作流**），大白话文案，显示数据目录占用与语义引擎状态。
+9. **全工具 UI 开关**：侧边栏「写作助手功能」面板（总开关 + 工具开关分组 + 功能开关 + 提示词档位/场景/**精简工作流**），大白话文案，显示数据目录占用与语义引擎状态。**v5.2.0 起面板走 DSH 0.2.0 官方席位**——作为右栏的一个正规 tab（可停靠 / 分栏 / 浮动，布局随会话持久化），入口是左栏设置旁的图标（宽栏 = 图标 + 文字、56px 轨道 = 纯图标），侧栏「+ → 引导页」里也有入口；老宿主（< 0.2.0）自动回退旧的侧栏挂载方式。
 10. **风格基线**：文笔六维测量（句法复杂度/修饰密度/抽象度/动作密度/不确定性/留白指数）+ 按章节 μ±σ 基线带；`novel_style_report` 输出基线带，`novel_style_check` 对照新章偏差（带内 ✓ / 出带 ⚠）；侧边栏可自定义每维 ±% 容差（**推荐值 = 原著章节波动的 1.5 倍 σ**，自动取整、限 ±10%~100%；输入框留空即用推荐）——原创/续写时主题自由、写法保持在基线带内。
 11. **写作哨兵三件套**：`novel_continuity_check` 扩展——①**衔接检查**（chapter 参数：时间硬跳/语义距离/人物延续/钩子承接四路检测，带原文引用）②**OOC 检测**（ooc 参数：角色情绪基线偏离）③**大纲走偏**（outline 参数：方向行 vs 正文关键词重合）；报告工具支持 **brief 精简模式**。
 12. **原创模式与创作资料**：侧边栏填写创作设定（世界观/角色/禁忌/主线/题材/额外要求，留空=模型自定，多书独立设定库）；novel_outline 维护创作资料（创作设定/人物/剧情大纲/钩子记录/创作状态卡），原创强制「设定书→大纲→钩子」链，动态批次（10→20→30 章）防剧情跳跃与角色 OOC。
@@ -178,6 +182,8 @@ fixAnchors：3 条原著锚段（对话 / 心理 / 描写各一条，供逐句
 
 ## 提供的工具（18 个）
 
+> 每个工具的参数、返回结构与示例，见[在线工具手册](https://siweina.github.io/dsh-novel-writer/tools/)。
+
 | 工具 | 说明 |
 |------|------|
 | `novel_books` | 列出章节库全部作品 |
@@ -290,3 +296,7 @@ npx -y -p dsh-novel-writer dsh-novel-writer-mcp --root /你的小说库路径
 ## 许可证
 
 [MIT](./LICENSE)
+
+---
+
+🔗 [官网](https://siweina.github.io/dsh-novel-writer/) · [技术文档](https://siweina.github.io/dsh-novel-writer/tools/) · [GitHub](https://github.com/siweina/dsh-novel-writer) · [npm](https://www.npmjs.com/package/dsh-novel-writer) · [MCP 服务器手册](./mcp/README.md)

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-novel-writer v5.0.0 bundle patch: 18 tools (incl. novel_semantic_search) + local embedding engine.
+# dsh-novel-writer v5.2.0 bundle patch: 18 tools (incl. novel_semantic_search) + local embedding engine.
 # dsh-novel-writer bundle patch: mounts the novel-writing assistant plugin
 # into the profile's loader tree. The entry's name is the plugin package
 # itself, resolved from the profile's node_modules.
@@ -6,8 +6,13 @@
 # v0.3.0: the same row now carries BOTH halves — the node half (exports ".")
 # runs in the host process (novel_* tools + /api/dsh-novel-writer/state
 # routes for the UI switch), and the dsh.client declaration in package.json
-# makes the browser half (exports "./client") load in the web GUI, mounting
-# the 「写作助手功能」 sidebar entry with the enable switch.
+# makes the browser half (exports "./client") load in the web GUI.
+#
+# v5.2.0: the browser half no longer injects DOM into the host's sidebar
+# column. It registers official seats instead — a right-sidebar tab type
+# (ctx.sidebarRightTabs.register + sidebar.right.pane.tab) plus a footer
+# entry (sidebar.footer.action). Hosts without those services (pre-0.2.0)
+# fall back to the old DOM-injection path automatically.
 - insert:
     - id: novel-writer
       name: 'dsh-novel-writer'