前言¶
在 DeepSeek Harness（dsh）里写长提示时，输入框往往只是一段纯文本：标题、列表、代码块都要靠肉眼对齐符号，发送后气泡里也不一定会按 Markdown 呈现。对习惯用 Markdown 组织思路的开发者来说，这和 Obsidian、常见 IDE 里的「边写边看效果」体验差一截。dsh 的扩展模型允许客户端插件接管对话输入区；下面介绍社区插件 dsh-markdown-input（维护者 long6177），它把输入框换成带实时渲染的编辑器，并让已发送的用户消息在会话里按 Markdown 显示。
这是什么¶
dsh-markdown-input 是一个面向 dsh Web UI（桌面客户端） 的客户端插件：核心能力是在 composer（输入框）里做 Markdown 实时渲染，方便在 dsh 里写结构化提示。项目自述为 alpha、仍在积极开发；与 DeepSeek / 官方无隶属关系，采用 MIT 许可证。目录页：SkillHub；源码：GitHub long6177/dsh-markdown-input。
核心功能¶
实时渲染的 composer¶
插件通过宿主 conversation.composer 选举链上的低优先级入口接管输入区（设计见仓库 ADR-0005），内置 CodeMirror 6 编辑器，输入时即渲染，风格接近 Obsidian Live Preview：粗体、斜体、行内代码、删除线显示为真实样式；光标离开当前行后，语法标记会折叠隐藏。可切换到 源码模式，所有 *、# 等标记保持可见。
交互约定（与 README 一致）：
- Enter 发送（兼容 IME）
- Shift+Enter 换行
- 输入内容会同步到宿主 draft，刷新页面后草稿仍在
用户消息按 Markdown 展示¶
发送后的用户消息，以及排队中的 steering 消息，在聊天记录里通过 宿主自带的渲染管线 显示为 Markdown，而不是整段纯文本。@ 提及与 skill 芯片保留；你输入的换行按硬换行渲染。
富文本粘贴转 Markdown¶
从网页或 Word 等粘贴富文本时，会把剪贴板中的 text/html 转为较干净的 Markdown：在接管的编辑器中于光标处插入；在原生 composer 上则通过宿主带版本守卫的插入 API 处理。Ctrl/Cmd+Shift+V 仍粘贴纯文本；纯文本、文件、图片粘贴保持原生行为。
分 surface 优雅降级¶
各能力在激活前会探测宿主是否具备对应接口：内置接管面板（审批、提问、子 agent 等）优先级更高，需要时仍用原生 composer；缺少某 surface 时只关闭该特性，不关掉整个输入面；卡片级错误边界失败时静默回退到原生 composer，草稿不丢。
安装与启用¶
需要带 Web UI 的 dsh（桌面应用）。README 写明在真机上验证过 dsh 0.2.0-rc.2；安装较新版本前请先查看仓库 Compatibility 矩阵。
在终端执行（任选其一，命令来自官方 README）：
dsh plugin --profile web add dsh-markdown-input
dsh plugin --profile web add github:long6177/dsh-markdown-input
npm 包名同为 dsh-markdown-input；截至资料中的 package.json，插件版本为 0.2.0-alpha.20，peerDependencies 对 @deepseek-ai/dsh 为 ^0.2.0-rc.2。
典型用法¶
安装并启用 Web profile 后，无需额外配置文件即可使用，用法即「在对话输入框里写 Markdown」：
- 在 composer 中输入标题、列表、代码块等，观察实时渲染；需要核对原始符号时切换到源码模式。
- 发送消息后，在会话气泡中查看 Markdown 渲染结果（含代码高亮等宿主能力）。
- 从浏览器或文档复制带格式的段落，用普通粘贴（非 Ctrl/Cmd+Shift+V）得到 Markdown 源码后再编辑或发送。
适用场景与注意¶
适合谁： 经常在 dsh 里写长提示、规范、步骤清单或带代码块的说明，希望输入与历史消息都保持 Markdown 可读性的开发者。
兼容性： 项目不提供宽泛的版本承诺，只维护「真机跑过」的矩阵。资料中记录：dsh 0.2.0-rc.2 与插件 0.2.0-alpha.0 至 0.2.0-alpha.20 在 2026-10-07 验证通过；上游 0.2.1-alpha.1 在资料中标注为 Not verified，且 semver 预发布规则下当前 peer 范围不接受该版本，在未通过验证前不应假定可用。
安全与信任： 客户端插件随 dsh 进程权限运行。安装前建议阅读 GitHub 源码 与 MIT 许可证；问题与功能请求可走 Issues。
结尾¶
dsh-markdown-input 把「写 Markdown」从纯文本编辑变成 composer 内实时预览，并统一了发送后的展示与富文本粘贴路径；在 dsh 仍以开发者预览、版本间可能 breaking 的前提下，它用能力探测与降级尽量不影响原生输入。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
