前言¶

DeepSeek Harness（DSH）的插件生态旨在通过模块化扩展满足各类开发与创作需求。在进行长文本创作或智能体文档管理时，单纯依赖对话窗口的上下文窗口往往难以容纳完整内容，而将资料与正文混排则容易造成上下文混乱。本地优先的写作工具是解决这一痛点的常见方案。

dsh-writing-desk 是一款面向 DSH 的本地优先写作工作台插件，由 nousag 维护。它将工作区 .dsh-notes/ 目录下的 Markdown 笔记作为资料库，内置卷/章文件管理与正文编辑器，支持在 DSH 界面中直接调用本地资料进行写作。

插件定位¶

dsh-writing-desk 作为一个 DSH 插件，旨在提供轻量级的写作环境。它通过半窗面板呈现，打开后占据窗口右半边，让位给左侧的 DSH 对话窗口，实现资料查看与 AI 协作的并行操作。

安装前需确保已安装 dsh CLI，并目标 profile 为 web。

1、使用官方源安装：

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

2、本地开发安装（需使用绝对路径）：

dsh plugin --profile web add <本目录绝对路径>

安装完成后，需重启 dsh web 才能生效。卸载命令如下：

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

插件主要包含以下功能模块：

1、卷/章文件管理
正文按「卷 → 章」两级组织在 <工作区>/写作/ 目录下。新建卷会自动生成“第一卷”、“第二卷”等，新建章会自动生成“第一章”、“第二章”等，且每卷独立重置编号。章节与卷支持点击 ✎ 重命名。

2、正文编辑器
提供 Markdown 格式化编辑功能，支持字号与字体设置。具备自动保存与手动保存（Ctrl/Cmd+S）能力，并提供实时字数统计与写作目标打卡。

3、资料预览与引用
侧栏提供资料列表与实时预览双栏视图。支持全文搜索。核心交互为“选中即引用”：在预览区选中一段文字，点击弹出的“添加到正文中”，即可以引用块形式插入至当前章节光标处。

4、书籍与导出
支持多本书籍独立保存与管理。提供导出功能，支持 Markdown、TXT、Word、PDF 等格式。

5、数据安全
采用原子写入机制与自动保存策略，防止因切换或崩溃导致的数据丢失。

1、编辑正文
点击侧边栏底部的「写作工作台」入口，切换到「写作」标签。点击具体的卷或章文件，编辑器加载后，使用 Ctrl/Cmd+S 保存，或等待停顿自动保存。

2、引用资料
在「资料」标签中查看本地笔记。选中一段文字后，使用鼠标点击弹出的“添加到正文中”按钮，文字将以引用块格式直接插入到当前编辑章节的光标位置。

3、搜索调用
在编辑器下方的“插入资料”搜索框中输入关键词，可快速查找并调用本地笔记。

插件对文件系统与网络有明确的权限限制：

1、文件系统权限
仅读取工作区 .dsh-notes/ 下的资料文件；读写工作区 写作/ 目录下的卷目录与 .md 章节文件。

2、网络权限
仅建立本机回环 HTTP API，无外部网络请求与遥测数据发送。

3、凭据管理
不收集或传输任何用户凭据。

dsh-writing-desk 为 DSH 用户提供了从资料管理到正文撰写、再到最终导出的闭环本地工作流。适合需要频繁查阅本地笔记并利用 AI 进行辅助创作的场景。项目源码与文档详见 GitHub 仓库。