前言¶
DSH Web Composer 提供了基础的交互能力。对于需要精细控制 Markdown 渲染和上下文可视化的开发者，基础版往往缺乏对复杂语法的实时预览以及对长文本的便捷管理。dsh-better-composer 插件通过利用 DSH 的公共接口（seams），在不接管源代码所有权的前提下，增强了编辑器的 Markdown 渲染效果，并引入了长粘贴剪贴板和交互式上下文地图。
功能概览¶
该插件通过 dsh.bundle.patch 配置文件层注入增强功能。核心能力包括：
- Markdown 视觉增强：支持标题、强调、链接、任务列表、引用、表格、围栏代码块以及保留源标签的附件展示。
- 本地确定性补全：提供围栏语言、任务标记、标题间距等候选词的本地补全。
- 交互式上下文地图：通过 Composer 圆环打开右侧边栏，展示主机投影占用/模型窗口、结构统计及每轮增长情况。
- 长粘贴剪贴板：将长文本转换为可编辑的引用芯片，支持文件落地。
安装与启用¶
安装前需确保环境满足依赖要求：DSH 版本 0.1.7-alpha.2 或更高，Node.js >=20，pnpm >=10。
- 检查 DSH 版本与 Web 界面：
dsh --version
dsh web --no-open
- 安装插件：
pnpm dsh plugin --profile web add @cheesefox/dsh-better-composer@1.0.0
- 验证安装：
打开 Web UI，进入 Settings → Built-in plugins → Better Composer，确认插件卡片存在。新建会话后，确认 Composer 覆盖层和+菜单可用。
使用方法¶
长粘贴剪贴板¶
- 在 Web UI 中打开新会话。
- 粘贴超过配置阈值的文本，确认其变为
粘贴文本芯片。 - 打开该芯片，选择 文件送达。
- 在 文件类型 选择器中选择文本或代码扩展。
- 保存编辑并确认文件被写入
.dsh/pastes/目录。
编辑与撤销¶
在芯片编辑器中，测试 撤销 和 重做：
- 手动编辑后。
- 应用 LLM 重写预览后。
调整配置¶
进入 Settings → Built-in plugins → Better Composer，调整长粘贴阈值。文件扩展名在单个芯片中设置，而非全局设置。
技术实现与注意事项¶
- 插件架构：客户端入口仅加载于 Web 平台，依赖 DSH 官方声明的心跳、渲染、设置等公共接口。DSH Core 仍保留对源、选择、历史、Context 对象及发送/队列/引导的控制权。
- 上下文医生（Context Doctor）：实验性功能，需 DSH
0.1.7-alpha.2。它将诊断集成到上下文地图工作区，提供概览、诊断、分析和反馈页面。 - 统计数据：插件提供的统计数据不调用模型，也不会激活冷 Agent。
- 卸载：移除插件会移除覆盖层、设置卡片、剪贴板源和侧边栏标签，但不会修改现有的 DSH 会话历史或 Core 源代码。
结语¶
dsh-better-composer 适合希望在 Web 端获得更细致 Markdown 展示和上下文管理能力的 DSH 用户。更多细节可参考插件目录或 GitHub 仓库。
