DSH 的核心理念是「一切皆插件」。对于 Web 客户端，聊天输入卡片通常是原生输入框。dsh-vditor 插件使用 Vditor 3.11.3（IR 即时渲染模式）接管这一组件，将用户消息渲染为完整的 Markdown，提供所见即所得的输入体验。
插件信息¶
该插件由用户 zhy201810576 维护，遵循 MIT 许可证。它旨在解决原生输入框在 Markdown 渲染、代码高亮及文件引用方面功能不足的问题，让开发者可以在输入框内直接编写复杂格式的消息。
核心功能¶
Markdown 渲染与即时反馈¶
插件接管输入卡片后，启用 IR 模式，支持 Markdown 所见即所得。
* 代码与公式：代码块支持语法高亮和语言徽标；支持 KaTeX 数学公式和 Mermaid 图表即时渲染。
* 主题适配：界面会跟随系统的亮色/暗色主题自动切换。
* 动态 Placeholder：根据会话状态（如计划模式、被阻塞原因）智能切换提示文案。
附件与文件交互¶
- 路径胶囊：选择工作区文件后，以胶囊形式展示路径。插件修复了中文文件名及 Windows 反斜杠路径的显示问题，发送消息时会自动附入路径。
- 粘贴图片：剪贴板图片可直接落盘到工作区，并生成对应的路径胶囊。
- 内容引用：附件仅引用文件路径，不拷贝文件内容，模型会自行读取文件。
交互增强¶
- 斜杠命令：输入
/可快速唤起命令列表（如/goal、/compact、/permission、/plan、/export、/feedback、/model），输入过程中支持实时过滤。 - 文件引用：输入
@可在工作区文件中进行实时搜索，并一键插入。
工具栏与状态¶
插件自带完整的工具行，包含以下功能：
* 模型选择器：切换模型与推理等级。
* 权限菜单：切换审批/访问模式，包含 Full access 的二次确认。
* 命令目录：一键唤起上述斜杠命令。
* 上下文用量环：实时显示上下文占用百分比及构成。
安装与启用¶
版本要求：DeepSeek Harness (DSH) 版本需 ≥ 0.1.2-rc.1。该版本将 conversation.composer.bar 重构为常驻输入区，是本插件依赖的客户端 API 基础。
命令行安装（推荐）¶
dsh plugin --profile web add github:zhy201810576/dsh-vditor
NPM 安装¶
在 profile 目录（如 ~/.dsh/profiles/web）下执行：
pnpm add dsh-vditor
随后在 profile 的 package.json 中将 "dsh-vditor" 加入 dsh.profile.bundles 数组，重启 DSH 生效。
典型用法¶
- 命令过滤：在输入框输入
/，列表会出现/goal、/compact等选项，输入字符可实时筛选。 - 引用文件：输入
@触发文件搜索，选择文件后路径以胶囊形式展示。 - 插入图片：直接粘贴截图，文件会自动保存至工作区并生成路径胶囊。
注意事项¶
- 网络依赖：Vditor 库通过
https://unpkg.com/vditor@3.11.3动态加载，运行环境需保持联网。 - 版本冲突：若同时启用本插件的动态（会话内）版本，会与正式版重复注册，请停用其中一个。
- 文件读取：插件仅提供路径引用，模型会自行读取文件内容进行推理。
生态与源码¶
DSH 插件生态强调社区贡献，本插件收录在独立社区目录中，与 DeepSeek / 幻方无官方从属关系。源码与更多细节可参考：
* GitHub 仓库
* 社区目录页
