前言¶
DeepSeek Harness（DSH）的 Web 客户端提供了基础的模型交互界面。对于高频使用者而言，默认的输入框在键位配置、快捷指令和辅助功能上存在提升空间。本插件旨在解决这些问题，为 Web 模式下的 Composer（输入框）提供增强体验。
插件定位¶
- 名称：
dsh-composer-ux - 定位：DeepSeek Harness Web 输入体验增强插件
- 维护者：fangwen9527
- 协议：MIT
核心功能¶
1. 键位配置与输入安全¶
插件允许自定义输入框的发送键和换行键（如 Enter / Ctrl+Enter / Alt+Enter 等）。录制支持自定义组合键，并支持一键恢复默认。
* IME 安全：在中文或日文输入法组合期间（isComposing 状态），系统会放行输入，不会触发误发或误换行。
* 兼容性：发送/换行通过回放官方按键管线实现，保留了官方的忙时排队、连发防重等保护机制。如果未绑定 Enter 系按键，默认保留官方行为。
2. 右键菜单¶
设置页提供三种菜单来源选项：
* 官方：完全由 DSH 和浏览器原生处理，无插件介入。
* 浏览器：使用浏览器自带菜单，粘贴功能无需授权。
* 自定义：提供 7 项固定样式的右键菜单（撤销、重做、剪切、复制、粘贴、删除、全选）。
* 注意：Firefox 的剪贴板访问需要手动授权，每次点击粘贴都会弹出确认窗口，这是浏览器的安全机制。
3. 设置面板与全局开关¶
- 全局开关：设置页顶部设有总开关，可一键启用或禁用所有增强功能。
- 持久化尺寸：设置面板支持调整大小，尺寸变化会自动保存，关闭后再次打开保持上次状态。
- 重启 DSH：设置页卡片头部提供“重启 DSH”按钮，点击后通过助手进程重启，释放端口并重载配置。
4. 快捷指令与提示词优化¶
- 快捷指令面板：内置常用提示词列表，支持分类管理。点击指令按钮可插入文本，每条指令可独立配置“发送时总是追加”模式。
- 提示词优化器：发送前自动运行一次独立的模型调用，对输入内容进行优化，再执行发送操作。
5. 辅助功能¶
- OpenCode 请求头：自动注入
x-opencode-session请求头，确保 OpenCode 相关路由在 DSH 中正常工作。 - Windows 终端切换：在 Windows 上，可将模型调用的默认终端从 PowerShell 切换为 Git Bash。
- 统计行升级：输入框下方显示缓存命中百分比，精度保留 3 位小数（v0.7.0 起，默认开启）。
- 费用胶囊：显示本会话费用估算。支持按模型编辑高峰/非高峰价格，并支持自动获取中国法定节假日。价格结算依据事件发生时的具体时间点，而非查看面板的时间。
安装与启用¶
安装该插件需要 DSH 的 Web Profile。执行以下命令：
# 安装
dsh plugin --profile web add dsh-composer-ux
# 更新
dsh plugin --profile web update dsh-composer-ux
安装完成后，根据提示重启 DSH 或刷新页面即可生效。
典型用法¶
- 调整键位：进入设置页的“输入体验”，根据习惯修改发送和换行键。
- 使用快捷指令：在输入框工具栏点击指令按钮，快速插入预设提示词。
- 优化输入：在发送前，利用优化器对长文本进行润色。
- 配置价格：在“金额”设置中，针对特定模型编辑峰谷价格或同步官方价目。
注意事项¶
- 默认启用项：在 v0.7.0 版本中，“统计行”是唯一默认开启的功能项，其余功能默认关闭。
- Firefox 限制：由于浏览器的安全策略，Firefox 下使用自定义剪贴板功能时无法避免授权弹窗。
- 权限与许可：插件以当前 DSH 进程权限运行，安装前建议查阅源码与许可证（MIT）。
- 数据保留：关闭某个功能栏（如关闭键位配置）会禁用该功能，但已保存的配置数据会保留，重新开启即可恢复。
