写作工作台nousag/dsh-writing-desk

dsh-writing-desk · 写作工作台

面向 DeepSeek Harness（DSH）的本地优先写作工作台插件：把工作区 .dsh-notes/ 目录里的 Markdown 笔记当作写作资料，随时查看并调用；并内置正文编辑器 + 卷/章文件管理。

工作台以半窗面板呈现：打开后占窗口右半边，DSH 对话窗口自动让位到左半边，两边可同时操作。

侧边栏底部新增「写作工作台」入口，打开后内含两个标签页：

「写作」标签 —— 卷/章文件管理 + 直接写正文

- 卷/章文件管理：正文按「卷 → 章」两级组织在 /写作/ 下：
- 新建卷：自动得到 第一卷、第二卷……（已有最大卷号 +1）；
- 新建章：在某个卷下自动得到 第一章、第二章……，每一卷都从第一章重新开始；
- 默认章节名「第 X 章」（X 为中文数字，兼容阿拉伯数字），点 ✎ 可重命名章节或卷。
- 示例：写作/第一卷/第一章.md、写作/第一卷/第二章.md、写作/第二卷/第一章.md。
- 输入文本框：点击章节即在编辑器写正文，Ctrl/Cmd+S 保存、停顿自动保存。
- 边写边调用本地资源：编辑器下方「插入资料」搜索框，点「全文」整篇插入光标处、点「引用」插入 标题。

「资料」标签 —— 侧栏预览 + 选中即引用

- 列表 + 预览双栏：左侧是资料列表（按工作区分组、可全文搜索），右侧是选中资料的实时预览（Markdown 渲染）。
- 选中一段话 → 添加到正文：在预览中用鼠标选中一段文字，会在选区上方弹出「添加到正文中」，点击即以引用块（> …）形式直接写入当前章节的正文，无需切换标签。
- 预览区顶部保留：调用到会话（把整篇资料发给 AI 续写）、插入到输入框、复制全文 / 复制引用。

设计

| 半 | 作用 |
|---|---|
| host（lib/index.js） | 通过 webServer 注册回环 HTTP API。资料：list/read/search（只读 .dsh-notes/*.md）；正文：tree/readChapter/writeChapter/createVolume/createChapter/renameVolume/renameChapter（读写 /写作//.md）。不注册额外 agent 工具——模型本身就有文件工具可读这些文件。 |
| client（lib/client.js） | 浏览器半：半窗覆盖层（portal + 给对话 frame 让位）+ 双标签，纯 React.createElement、无构建步骤。 |

目录约定：资料在 /.dsh-notes/，正文在 /写作/。

安装

前置：已安装 dsh CLI，目标 profile 为 web。

dsh plugin --profile web add dsh-writing-desk

本地开发（用绝对路径安装）：

dsh plugin --profile web add

然后重启 dsh web（bundle 层与 client 元数据缓存在进程内，必须重启才生效）。

卸载：

dsh plugin --profile web remove dsh-writing-desk

功能一览

- 书籍管理：多本书独立保存（写作///.md），新建 / 切换 / 重命名书籍
- 正文编辑器：字号 / 中英文字体 + Markdown 格式工具栏（加粗 / 斜体 / 标题 / 引用 / 列表 / 代码）
- 字数统计 + 写作目标：实时字数，每日目标打卡
- 章节大纲：计划章节 + 情节走向，与已成稿分开
- 导出：全书合并导出 Markdown / TXT / Word / PDF
- 资料导入：输入路径或文件选择器，把外部文档导入笔记
- 输出目录：一键打开 / 自定义正文储存目录
- 布局预设：工作区尺寸多存档 + 双击重命名
- 数据安全：原子写入、自动保存、切换防丢、草稿崩溃恢复、请求竞态防护

权限与数据

- 文件系统：只读各工作区 .dsh-notes/ 下的 .md 资料；读写各工作区 写作/ 下的卷目录与 .md 章节（名称强制 basename、禁目录穿越）。
- 网络：仅本机回环 HTTP API（浏览器 ↔ 本地 dsh 服务）与同源图标请求；无外部网络、无遥测。
- 凭据：不收集、不传输任何凭据。