前言¶

在 DSH 插件生态里，写作类任务通常不只依赖浏览器侧界面，还需要 host 侧数据服务和写作引擎配合。对智能体开发者来说，如果项目目录、书库、检索结果、设定与人物演化分散在不同入口，查看和定位成本会比较高。

dsh-client-ui-writing 是一个 Web 客户端插件，由 x2802490130-prog 维护，许可证为 MIT。它当前 package.json 版本为 0.6.2，在 DeepSeek Harness 的写作预设会话中提供侧边栏写作面板和会话内全书索引视图。

这个插件本身不直接生成正文。它的职责是读取数据、展示信息、触发编排；重活由 host 侧引擎完成。

定位与边界¶

这个插件的定位比较明确：

• 面向 DSH 客户端写作场景。
• 提供侧边栏写作面板。
• 提供会话内全书索引视图。
• 支持项目、书库、搜索、演化四类信息查看。
• 支持触发 novel_sync 等编排动作。
• 只在写作预设会话中显示。

它的运行边界也很清楚：

• 面板只读数据并触发编排。
• 不直接生成正文。
• 生成、检索、书库、编排等重活由 host 侧完成。
• host 侧需要安装 dsh-writing-remote，并且该链路依赖 dsh-tool-writing。
• 写作引擎使用独立的 DSH_WRITING_API_KEY。

模式门控条件如下：

agentPreset === "writing"

也就是说，只有写作预设会话会显示面板与索引视图，其他会话中隐藏。

核心功能¶

侧边栏写作面板¶

侧边栏写作面板包含四个 tab：项目、书库、搜索、演化。

项目¶

项目 tab 用于查看当前写作项目结构，包括：

• 分卷/章节目录。
• 字数、状态、摘要。
• 全书统计。
• 情节日志尾部预览。
• 空项目初始化入口。

空项目可以一键初始化写作工程，对应动作是：

scaffoldNow

书库¶

书库 tab 用于展示饲料区中的小说信息，包括：

• 书名。
• 作者。
• 分类。
• 章数。
• 字数。

如果书库为空，面板会提示使用导入动作：

novel_library_import

搜索¶

搜索 tab 提供项目与书库联合全文检索。

命中后可以直接定位到对应章节。这个入口适合查找人名、设定、情节等分散在项目和书库中的内容。

演化¶

演化 tab 用于查看设定和人物演化信息，包括：

• 设定/人物演化版本链。
• 内联 diff。
• SVG 线索图谱。

如果演化信息为空，面板会提示先登记：

novel_sync
novel_threads

章末编排¶

面板提供章末编排入口，可以一键触发：

novel_sync

该动作包含：

• 章节摘要。
• 设定抽取。
• 演化检测。
• 伏笔提醒。

会话内全书索引视图¶

在写作预设会话中，除了侧边栏面板，还提供会话内全书索引视图。

这个视图用于快速查看和定位当前书：

• 分卷目录。
• 字数、状态、摘要。
• 快速定位。
• 章节预览。
• 打开原文。

操作方式包括：

• 用数字直达第 N 章。
• 用 /、Ctrl+/ 或 Alt+K 聚焦搜索框。
• 用 ↑↓ 选择。
• 用 Enter 预览。
• 用 Esc 关闭。
• 触摸或拖拽左右滑动切换模块。

安装与启用¶

安装前先确认 host 侧依赖已经就绪：

dsh-writing-remote
dsh-tool-writing

其中 dsh-writing-remote 是 host 侧数据通道，dsh-tool-writing 是 host 侧写作引擎依赖。写作引擎使用独立的 API key：

DSH_WRITING_API_KEY

安装 dsh-client-ui-writing 可以使用 DSH 插件命令：

dsh plugin --profile web add dsh-client-ui-writing

也可以使用 npm 安装：

npm install dsh-client-ui-writing

该插件的 peerDependencies 如下：

{
  "react": "^18.2.0",
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
  "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6"
}

官方包走 peer，不内嵌这些依赖。

典型用法¶

下面是几个比较直接的使用路径。

空项目初始化¶

如果当前项目还没有写作工程结构，可以先在面板中使用：

scaffoldNow

这一步用于初始化写作工程，方便后续继续管理分卷、章节和摘要。

导入书库¶

如果书库为空，可以使用：

novel_library_import

导入后，书库 tab 会展示书名、作者、分类、章数、字数等信息。

章末同步¶

完成一章内容后，可以触发：

novel_sync

该动作会执行章节摘要、设定抽取、演化检测、伏笔提醒。

登记演化线索¶

如果演化 tab 还没有数据，可以先运行：

novel_sync
novel_threads

完成登记后，再查看版本链、内联 diff 和 SVG 线索图谱。

会话内快速定位¶

在写作预设会话里，可以直接用数字跳转到章节：

12

也可以用快捷键聚焦搜索框：

/
Ctrl+/
Alt+K

选中条目后，用 Enter 预览，用 Esc 关闭。

适用场景与注意¶

适合这类使用方式：

• 你已经在 DSH 中维护写作项目。
• 你需要在浏览器侧查看项目目录、书库、搜索和演化。
• 你需要在会话内快速定位章节、预览章节、打开原文。
• 你需要一个只负责查看和触发编排的客户端入口。
• 重活希望交给 host 侧 dsh-writing-remote 和 dsh-tool-writing 处理。

需要注意几点：

• 该插件以当前 dsh 进程权限运行。
• 安装前应检查源码与许可证。
• 它不直接生成正文。
• 它依赖 host 侧写作链路。
• 它只在 agentPreset === "writing" 的会话中显示。
• 当前许可证为 MIT。

链接¶

GitHub 仓库：

https://github.com/x2802490130-prog/dsh-client-ui-writing

插件目录页（如所在目录站收录该插件）：

https://www.skillhub.cn/plugins/x2802490130-prog/dsh-client-ui-writing