前言¶
DSH 支持通过插件扩展功能。在开发或使用过程中,有时需要随时记录想法或待办事项。切换到外部编辑器再切回,会打断工作流。dsh-draft 插件旨在解决这个问题,提供一个无需切换上下文的 Markdown 草稿板。
插件定位¶
这是一个基于 Markdown 的草稿板插件。它提供实时预览和本地文件持久化能力,适合需要快速记录、管理本地草稿的场景。
核心功能¶
- 实时预览:输入内容时即时渲染 Markdown。
- 本地持久化:自动保存到
$DSH_HOME/draft.md(默认路径为~/.dsh/draft.md),刷新或重启进程不会丢失内容。 - 格式快捷键:支持键盘快速格式化文本。
Mod-B/Ctrl-B:切换粗体Mod-I/Ctrl-I:切换斜体Mod-L/Ctrl-L:切换任务列表复选框
安装与启用¶
该插件依赖 dsh 0.1.5-rc.1 或更新版本。
1、运行以下命令安装插件:
dsh plugin --profile <profile> add dsh-draft
将 <profile> 替换为你的配置文件名称(默认 Web 配置文件为 web)。
2、安装完成后,重启 Web UI 或刷新页面即可生效。
典型用法¶
1、打开右侧边栏。
2、点击边栏标签栏上的 + 号,选择 Draft / 草稿。
3、开始输入,右侧会即时显示渲染结果。
4、使用键盘快捷键进行格式调整:
- 在文本上按下 Ctrl/Cmd+B 加粗。
- 按下 Ctrl/Cmd+I 变为斜体。
- 在列表行按下 Ctrl/Cmd+L 切换任务复选框状态(未选中 ⇄ 已选中;普通行变为任务行)。
- 在嵌套列表中继续输入时,使用 4 个空格缩进。
注意事项¶
- 版本要求:需要 dsh >= 0.1.5-rc.1,Node.js >= 18,React >= 18.0.0。
- 开发方式:该项目的代码由 dsh agents 端到端开发,无人工直接编辑。
- 构建方式:npm 包包含预构建的浏览器包,无需执行本地构建。
- 生态说明:该插件收录于社区目录(Skillhub),与 DeepSeek 或幻方官方无从属关系。
总结¶
dsh-draft 通过侧边栏集成的方式,提供了轻量级的 Markdown 记录能力。利用本地文件持久化机制,配合实时预览和快捷键,能够满足基本的草稿记录需求。