前言¶
在 DeepSeek Harness（DSH）里写长文、改表格、和模型一起维护一份「活文档」时，常见做法是：要么在对话里堆 Markdown 源码，要么切到外部编辑器再粘贴。对话上下文会变长，排版也和 DSH 主界面不一致。下面介绍维护者 zhxnix 的客户端插件 dsh-madedown：在 DSH 右侧栏提供所见即所得（WYSIWYG）的 Markdown 笔记编辑，并与主对话双向联动；设计灵感来自 macOS 原生编辑器 Madedown。
这是什么¶
dsh-madedown 是 DSH 的 web 客户端插件（分类：客户端）。打开后右侧栏会出现 Madedown 编辑标签页：默认直接编辑渲染后的 Markdown（标题即标题、表格可改单元格），支持多标签、本地图片、保存到本地文件，以及模型通过 madedown 工具读写文档。文档与图片保存在本机 Host 目录，插件本身不发起外部网络请求。
- 目录页：skillhub.cn/plugins/zhxnix/dsh-madedown
- 源码与说明：github.com/zhxnix/dsh-madedown
- 当前 package 版本：0.6.3，许可证 MIT
核心功能¶
编辑与排版¶
- 所见即所得 / 源码模式：工具栏最右侧图标切换，实时渲染 Markdown。
- 与对话渲染一致：使用对话 Markdown 的同一套排版 token（字体、字号、行高、标题、列表、引用、代码、表格）。
- Markdown 快捷输入：行首
#、-、1.、>、代码围栏等自动变块；行首/打开格式菜单。 - 列表 / 任务列表：回车续写、
Tab缩进、任务复选框可直接勾选。 - 目录：编辑区右上方半透明目录，悬停展开、移开收起，点击把手可固定。
多标签与本地状态¶
- 多标签页：新建、关闭、双击改名、拖动换位；标签过多时右侧溢出菜单；顺序与激活项持久化。关闭有内容的标签会提示，可选「保存到本地」或「确定关闭」。
- 本地保存状态：标签绿/红状态点；状态栏显示当前文档本地保存状态，点击可查看并复制保存路径。
- 保存到本地文件：下载按钮或
⌘S弹出系统原生保存对话框（macOS），默认文件名<标题>.md、默认位置「文稿」。
表格、代码块与图片¶
- 表格：进入表格时浮出工具条，可插删行/列或整表；
Tab在末格自动新增一行。 - 代码块：语言标识、自动换行、复制横幅；
⌘/Ctrl+Enter、Esc、末尾↓或点击块下方空白可退出。 - 图片：选择或粘贴会上传到 Host 本地资源目录；从对话选区发送的图片也会转存为本地资源。
与主对话联动¶
- 模型可通过
madedown工具读取和修改右侧文档；右侧修改会自动进入对话上下文。 - 对话选区可一键发送到编辑器；编辑器选区可插入对话（只插入、不发送）。
- 编辑器选区支持「快速提问」，直接在对话中向模型提问；支持 Madedown 引用 chip，点击可编辑发送给模型的内容。
关于与更新¶
关于弹窗可查看图标、版本、作者、更新说明与仓库地址，并检查更新；有新版本时状态栏有小字提示。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前建议浏览源码与 MIT 许可证。
从 GitHub（当前可用）¶
dsh plugin --profile web add github:zhxnix/dsh-madedown
从 npm¶
npm 包发布后可使用（目前尚未发布）：
dsh plugin --profile web add dsh-madedown@latest
本地开发安装¶
在 DSH 中执行（需 pnpm，可通过 corepack enable pnpm 提供）：
plugin_manager install_bundle target=/path/to/madedown-dsh
安装后客户端模块通常经 client HMR 自动载入；若未出现，刷新 DSH 页面。
典型用法¶
- 点击右侧栏 Madedown 入口、对话标题栏 Madedown 图标，或让模型执行
madedown的open动作。 - 在渲染后的文档里直接编辑，或使用工具栏与快捷键。
- 多篇笔记用顶部标签管理，可拖动排序、双击改名。
⌘S保存到本地文件；标签与文档会自动持久化到 Host。
常用快捷键示例：
| 快捷键 | 作用 |
|---|---|
⌘B / ⌘I / ⇧⌘X / ⌘E |
粗体 / 斜体 / 删除线 / 行内代码 |
⌘K |
插入链接 |
⌘S |
保存到本地文件 |
Tab / ⇧Tab |
列表缩进 / 反缩进；表格内切换单元格 |
数据、隐私与模型工具¶
本地数据路径¶
- 文档：
$DSH_HOME/madedown-dsh/documents.json（默认~/.dsh/madedown-dsh/documents.json；可用环境变量MADEDOWN_DSH_HOME覆盖目录）。 - 图片：
$DSH_HOME/madedown-dsh/assets/，经本机 Host 路由提供，不上传外部服务。 - 引用与编辑状态保存在浏览器
localStorage与本地 Host 数据中。
madedown 工具¶
参数 action，可选 document 指定标签 id 或标题（默认当前标签）：
| action | 作用 |
|---|---|
read |
读取全文、标题、版本、统计与标签列表 |
write |
整篇重写（text，可选 title） |
append |
末尾追加 text |
replace |
字面量查找替换（find / replaceWith / all） |
list |
列出所有标签与当前激活标签 |
select |
切换激活标签（document 必填） |
create |
新建标签（可选 title / 初始 text） |
open |
在右侧栏打开/显示编辑器 |
Host 还会注册系统提示，列出标签并内联当前标签内容（过长会截断并提示用工具读取全文）。
适用场景与注意¶
适合：需要在 DSH 内长期维护 Markdown 笔记、表格与代码片段，并希望模型能程序化读写同一份文档的开发者或智能体使用者。
注意：
- 保存对话框描述针对 macOS 原生对话框；其他平台行为以实际 DSH 环境为准。
- DSH 生态强调「一切皆插件」；skillhub.cn 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
- 安装与运行等同于信任插件源码；Node 引擎要求
>=20（见 package.json）。
结尾¶
dsh-madedown 把 WYSIWYG Markdown 笔记放进 DSH 右侧栏，并与对话和 madedown 工具打通，适合「人机共编一份本地文档」的工作流。安装命令见上文 GitHub 方式；细节与更新以仓库 README 为准。
