dsh-better-chat/README.md

71 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# dsh-better-chat
DSH 聊天增强插件。
## 功能一:审批时回车批准、Esc 拒绝(v0.1.0)
DSH 官方审批卡(`@deepseek-ai/dsh-client-ui-approval`)本身就支持
Enter 批准、Esc 拒绝,但前提是**焦点先落在审批卡里**。审批弹出时焦点
通常还在对话区,回车按下去没有反应,得先拿鼠标点一下卡片。
本插件补上这一段,不改官方逻辑:
1. **自动送入焦点**:审批卡出现时,如果你没有正在别处输入,就把焦点
送进卡片的详情区,官方的回车/Esc 立即生效。
2. **全局兜底路由**:焦点不在卡片内时(比如点了别处又想作答),在
document 捕获阶段接住回车/Esc,点击卡片上的按钮。回车永远点
「允许(单次)」,不会误触「始终允许」;Esc 点「拒绝」。
防误触(与官方卡片内部规则对齐):
- 正在任何输入框/编辑区打字时不拦截;
- 焦点已在卡片内时完全交给官方处理,不重复作答;
- 带 Ctrl/Meta/Alt/Shift、长按连发、输入法组词中不拦截;
- 回车落在某个按钮/链接上时,保留那个按钮自己的行为;
- 卡片已作答或按钮禁用时不动作。
已知边界:焦点停在另一个面板的输入框里时(例如设置页搜索框),为防
误触不会抢焦点、也不会路由按键,需要先点一下审批卡——与原生行为一致。
## 安装(DSH 桌面端)
```
dsh plugin --profile desktop add dsh-better-chat
```
完全重启 DSH 后生效。本地验证:`npm test`(判定逻辑单元测试)。
## 真机验收点
- 触发一次工具审批:不点鼠标,直接按回车应批准(单次)、Esc 应拒绝;
- 审批等待时在输入框打字,回车应照常发送/换行,不被劫持;
- 审批等待时点开别处按钮,回车应执行那个按钮而不是批准。
## 功能二:权限 UI(v0.2.0,v0.3.1 收紧)
- **去掉「完全权限」选项**:权限选择器(`/permission` 弹出菜单、composer
权限菜单)和通用设置的默认权限下拉里,标签为「完全权限 / Full access」
的选项会被摘除。只动界面:手动输入 `/permission danger-full-access`
命令仍可达,那是宿主行为。
- **不覆盖已有会话权限**:插件不再在页面加载、刷新或重载时遍历会话改
权限。已有会话的只读/工作区/完全权限选择完全由用户与宿主决定;默认
自动审查只属于宿主自己的新建会话流程,本插件没有可靠的新建扩展点,
因此不拿轮询补偿。需要自动审查时,请在宿主的权限选择器里显式选择。
真机验收点(功能二):
1. 打开权限选择器 → 没有「完全权限」一项;设置里的默认权限下拉同样没有。
2. 手动把某个会话切到「仅可查看」→ 刷新、重连、插件重载后仍是「仅可查看」。
3. 新建会话的默认权限由宿主/用户选择决定,插件不替用户改写。
## 功能三:插件商店「更新」按钮(v0.3.0)
DSH 只给官方插件原地更新;从自定义索引装的插件在发现页只有「有新版本」标签、没有按钮,只能手动卸载重装。本功能在发现页给每个「有新版本」的条目补一个「更新到 x.y.z」按钮:
- 数据与动作都走宿主自己的远程服务:`remote.pluginMarket` 查各索引的安装状态与每版的精确安装 spec,`remote.pluginManager.installBundle` 按 spec 覆盖安装——与官方安装流程同一套接口,不模拟点击、不动官方状态。覆盖安装经实测可直接把已装旧版换成新版。
- 点击先弹确认框(插件名、旧版 → 新版),完成后按钮显示「已更新,重启 DSH 后生效」;失败显示「更新失败,点此重试」并把宿主错误打到控制台。
- 远程服务由一个子插件单独声明 inject 取用,主插件保持 inject 为空;未启用实验性「自定义插件索引」时子插件不生效,本功能静默关闭,审批与权限功能不受影响。
- 更新后需重启 DSH 才加载新版(与官方流程一致)。插件数据在 `$DSH_HOME` 的边车文件里,覆盖安装不影响。
顺带修复(v0.3.0):v0.2.x 里权限策略的定时器默认值把浏览器原生 `setInterval` 等函数摘出来当普通对象方法调用,Chrome 下抛 `TypeError: Illegal invocation`,会让独立安装的客户端条目激活失败(DSH 报 “entry did not activate”、整页白屏)。已改为箭头函数包裹调用,本功能的定时器同样处理。