前言¶
DeepSeek Harness (DSH) 采用插件化架构，社区开发者可以针对特定场景扩展功能。hw-cola/dsh-message-enhancer 专注于提升 Web 客户端的交互体验，解决长对话中的定位困难、计划审批流程繁琐以及消息发送后的反馈延迟等问题。
核心功能¶
消息与计划索引标尺¶
在聊天输入框上方的 Dock 中添加一条垂直索引，用于快速扫描和定位当前已加载的用户消息与最终计划。
* 内容过滤：仅展示用户消息和 steering 消息，识别 exit_plan_mode 提交的最终计划。
* 状态着色：刻度颜色按用户操作结果着色。确认执行显示绿色，空反馈拒绝显示红色，提交反馈或去聊天显示暖黄色，普通消息显示灰色。
* 交互预览：悬浮或键盘聚焦时显示白色圆角预览卡片，支持轻量 Markdown 渲染，底部显示类型与时间。
* 滚动定位：点击刻度将对应聊天节点滚动到聊天区域中部。有更早历史时顶部显示 ···，每次点击加载一页。
计划审批卡与历史计划卡¶
对原生计划审批功能进行样式替换与交互增强。
* 卡片样式：保留原生计划审批位置、Markdown 内容和审批协议，样式替换为主题自适应的中性卡片。
* 内容调整：标题栏提供复制完整 Markdown 的图标按钮。卡片底部可直接输入需调整的内容，非空时“拒绝”变为“提交反馈”。
* 历史记录：每次“去聊天里说”、“拒绝/提交反馈”或“确认执行”后，聊天时间线都会保留该版计划的历史卡（固定高度、底部渐变虚化提示内容未完整展示）。历史卡可“放大窗口”悬浮阅读。
回复完成提醒¶
在模型整轮回复正常完成时提醒用户，适合切到别的窗口等回复的场景。
* 设置入口：设置 → 通用设置，提供“回复完成提示音”、“提示音类型”、“Windows 系统通知”三行设置。
* 触发机制：触发时机为整个回合完成（completed / max-tokens）。点“停止”、模型报错或计划被退回时不提醒。
* 通知方式：系统通知走浏览器 Notification API，窗口最小化或切到别的应用也会弹。通知标记静音，声音统一由提示音播放。
最后一条消息气泡编辑重发¶
针对最后一条用户消息提供编辑与重新生成能力。
* 编辑入口：最后一条用户消息气泡的复制按钮左侧出现铅笔按钮。
* 操作流程：点击后气泡原位变成输入框，改完直接发送。模型基于编辑后的文本重新回答，旧回复不出现。
* 机制说明：发送走 DSH 原生 fork 机制，从该消息之前的 completed turn 边界创建子会话并自动切换。单轮会话时改为新建会话重发。发送前自动把父会话当前的模型选择与权限预设同步到子会话。
安装与启用¶
安装插件：
dsh plugin --profile web add "git+https://github.com/hw-cola/dsh-message-enhancer.git"
钉到指定版本（按 tag 锁定）：
dsh plugin --profile web add "git+https://github.com/hw-cola/dsh-message-enhancer.git#v1.0.0"
生效步骤：
安装后需重启 dsh web（让插件的 cordis 补丁层生效）并刷新浏览器页面。
典型用法¶
- 快速定位：在长对话中，利用聊天输入框上方的垂直索引快速扫描或定位特定的计划节点。
- 审批调整：点击计划审批卡标题栏的复制按钮导出 Markdown，或直接在卡片底部输入框修改内容后提交。
- 接收提醒：在设置 → 通用设置中开启回复完成提示音和系统通知，避免错过模型回复。
- 修正输入：点击最后一条用户消息气泡的铅笔按钮，修改错别字后直接重发，模型将基于新文本重新生成。
适用场景与注意¶
- 适用场景：需要频繁审批计划、进行长对话管理、希望收到回复完成提醒、以及需要修正上一条消息再重新生成的开发者。
- 兼容性：插件在 DSH 0.1.1-rc.2 上开发测试。
- 权限要求：系统通知需要浏览器权限；页面非 localhost/https 访问时可能受限。
- 许可证：MIT 许可证。
短结尾¶
该插件通过索引标尺、审批优化、通知提醒和消息重发四个维度，增强了 DSH Web 的日常使用体验。所有功能均基于 DSH 原生机制实现，不依赖额外的后端服务。
