前言¶
DSH 的插件生态强调「一切皆插件」,社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。在写作类智能体场景里,常见拆分方式是:host 侧引擎负责项目、书库、检索与编排;浏览器侧面板负责展示与操作。两者之间需要一层协议适配,避免把生成能力和完整写操作直接暴露给客户端。
dsh-writing-remote 就是这一层:它把 host 侧写作引擎的数据能力,以 Typert remote 的形式接给客户端面板使用。
这是什么¶
dsh-writing-remote 由 x2802490130-prog 维护,是 DSH 写作三件套中的 host 侧数据通道。
它解决的问题是:
dsh-tool-writing引擎跑在 host 侧,拥有项目、书库、检索和编排能力;dsh-client-ui-writing面板跑在客户端,需要读取这些数据并进行展示;- 两者之间通过 Typert 协议交互,remote 包负责把引擎能力适配成面板可调用的 Remote 方法。
这个包的边界比较明确:提供只读数据和编排触发,所有写操作仍在 host 侧引擎里完成,不把生成能力暴露给客户端。
核心功能¶
dsh-writing-remote 暴露的主要是 dsh-tool-writing 引擎中的项目、书库与检索数据,并提供少量编排触发方法。
数据读取¶
面板可以通过 Remote 方法获取以下内容:
| 方法 | 面板用途 |
|---|---|
workspaceIndex |
索引视图、项目 tab |
projectStatus |
项目概览 |
chaptersList |
章节列表 |
chapterText |
单章正文预览 |
loreList |
设定浏览 |
projectSearch |
项目全文检索 |
libraryList |
书库列表 |
librarySearch |
书库检索 |
evolutionList |
演化版本链 |
threadGraph |
多线叙事线索图谱数据 |
这些方法面向的是「面板要什么,remote 就提供什么」的只读场景。
编排触发¶
dsh-writing-remote 还提供两个触发类方法:
| 方法 | 用途 |
|---|---|
syncNow |
章末自动编排,包括摘要、抽取、演化和伏笔提醒 |
scaffoldNow |
非破坏式铺骨架,空目录可一键初始化 |
这里需要注意:remote 只负责触发,真正执行仍由 host 侧引擎完成。
方法定位¶
所有 Remote 方法都以 projectRoot 为第一参数定位小说工程。
面板侧通常传入当前工作区作为 projectRoot,host 侧再基于该目录实例化对应引擎。
安装与启用¶
可以使用 DSH 插件方式安装:
dsh plugin --profile web add dsh-writing-remote
也可以按 npm 包安装:
npm install dsh-writing-remote
配置项只有 libraryRoot。
libraryRoot
默认值是:
$DSH_HOME/writing-library
这个目录与引擎共享书库根,用于指定 dsh-tool-writing 引擎使用的书库位置。
典型用法¶
下面是一个典型的接入流程。
1、先安装 remote 包:
dsh plugin --profile web add dsh-writing-remote
2、如需调整书库位置,配置 libraryRoot:
libraryRoot=$DSH_HOME/writing-library
3、在客户端面板调用 Remote 方法时,把当前小说工程目录作为 projectRoot 传入。
例如:
- 查看项目索引:调用
workspaceIndex - 查看项目状态:调用
projectStatus - 查看章节:调用
chaptersList - 预览单章:调用
chapterText - 浏览设定:调用
loreList - 检索项目内容:调用
projectSearch - 查看书库:调用
libraryList - 检索书库:调用
librarySearch - 查看演化:调用
evolutionList - 查看线索图:调用
threadGraph - 触发章末编排:调用
syncNow - 触发初始化骨架:调用
scaffoldNow
这些调用都依赖 projectRoot 定位具体小说工程,面板传入的是当前工作区。
适用场景与注意¶
dsh-writing-remote 适合以下场景:
- 已经有
dsh-tool-writing写作引擎; - 有
dsh-client-ui-writing客户端面板; - 需要在 Web 面板中查看项目、章节、设定、书库、检索、演化和线索图;
- 希望只把只读数据和编排触发暴露给客户端,写操作仍留在 host 侧。
使用时需要注意:
- 它提供的是 host 侧数据通道,不是独立写作引擎;
- 只读数据和编排触发,生成与写操作仍在 host 侧引擎完成;
- 插件以当前
dsh进程权限运行,安装前应检查源码和许可证; - 许可证为 MIT;
- 社区插件目录是独立站点,不应理解为官方应用商店。
链接¶
GitHub:
https://github.com/x2802490130-prog/dsh-writing-remote
插件目录线索地址:
https://www.skillhub.cn/plugins/x2802490130-prog/dsh-writing-remote
该目录页地址来自插件线索,未在本次已抓取资料中验证。