108 lines
6.1 KiB
Markdown
108 lines
6.1 KiB
Markdown
# dsh-better-chat
|
||
|
||
DSH 聊天增强插件。v1.0.0 把 **dsh-better-display 的阅读视图**合并进来:一个插件、
|
||
一个 Web 客户端产物,同时提供「阅读页」与「审批 / 权限 / 商店」增强。
|
||
|
||
## 安装
|
||
|
||
```sh
|
||
dsh plugin --profile desktop add dsh-better-chat
|
||
```
|
||
|
||
从本仓库安装(钉住提交):
|
||
|
||
```sh
|
||
dsh plugin --profile desktop add git+https://git.qyhhh.top/DeepsSeekHarness/dsh-better-chat.git#<commit>
|
||
```
|
||
|
||
编译好的 `lib/` 已提交,安装时不需要构建。装完彻底重启 DSH。
|
||
|
||
> 如果之前装过独立的 **dsh-better-display**,请在更新本插件的同时把它从 profile
|
||
> 移除:阅读视图已经并入本插件,两个都装会同时注册两套阅读页与设置节(设置项标题
|
||
> 也会互相覆盖)。
|
||
|
||
## 功能一:阅读视图(合并自 dsh-better-display 0.3.12)
|
||
|
||
给对话加一个 **阅读** 页签:执行时能看到步骤、思考与进度;整轮成功结束后把过程
|
||
收起来,留下最终回答。原版「对话 / 轨迹」、输入框、模型选择、工具和审批都还在。
|
||
|
||
- 阅读列保留宿主 ChatView 的 `data-chat-flow` 钩子,依赖该标记显示输入框的第三方
|
||
皮肤不会把阅读页当成仅检视视图。
|
||
- 最终回答里的 ````mcp-app` 代码块会挂成交互卡片(`<iframe sandbox="allow-scripts allow-forms">`)。
|
||
- 设置里的 **Better Chat**:产物右侧预览、半透明毛玻璃(默认关)、过程自动折叠
|
||
(默认开)、审批卡快捷键。
|
||
- 上游的设计说明、扩展点文档与开发 runbook 一并保留在 [`docs/`](docs/)。
|
||
|
||
## 功能二:审批卡片的回车批准 / Esc 拒绝(v0.1.0,v0.4.1 加提示,v0.4.2 快捷键可配置)
|
||
|
||
DSH 官方审批卡本身支持 Enter 批准、Esc 拒绝,但前提是焦点先落在卡内。本插件补上:
|
||
|
||
1. **自动送入焦点**:审批卡出现时,若没有正在别处输入,把焦点送进卡片详情区。
|
||
2. **全局兜底路由**:焦点不在卡内时,在 document 捕获阶段接住配置的快捷键 —— 默认
|
||
回车点「允许(单次)」(不会误触「始终允许」),Esc 点「拒绝」。
|
||
3. **键盘提示**:操作行左侧显示当前绑定的键帽提示(默认
|
||
`Enter 允许(单次) · Ctrl+Enter 始终允许 · Esc 拒绝`),文案取卡片按钮的实际文字,
|
||
卡片作答后自动消失;只做说明,不占焦点、不可点击。Mac 上 Ctrl 显示为 Cmd。
|
||
4. **Ctrl+Enter / Cmd+Enter = 始终允许**:仅当卡片有第三个按钮时生效。官方卡片对带
|
||
修饰键的按键不作答,所以这条即使在卡片内也由本插件处理;正在输入控件里打字时
|
||
不拦截。
|
||
5. **快捷键可自定义**:设置 → Better Chat → 审批卡快捷键,点键帽后按下新组合键。
|
||
允许类动作固定在 Enter 上、拒绝固定在 Esc 上,修饰键自由;可清除「始终允许」或
|
||
恢复默认。配置持久化在 `dsh.better-chat.v1`,保存后卡片提示立即更新,无需重启。
|
||
|
||
防误触:正在输入控件里打字、裸 Enter/Esc 且焦点已在卡内、与当前绑定不符的修饰键、
|
||
长按连发、输入法组词、回车落在别的按钮或链接上、卡片已作答或按钮禁用时,都不拦截。
|
||
|
||
## 功能三:权限策略(v0.2.0,v1.0.1 补齐默认自动审查)
|
||
|
||
- **去掉「完全权限 / Full access」选项**:`/permission` 弹出菜单、composer 权限菜单与
|
||
通用设置的默认权限下拉里都会被摘除。只动界面,手动输入命令仍可达。
|
||
- **新建/空白会话默认「自动审查(auto)」**:当实验层 `@deepseek-ai/dsh-experimental-auto-review`
|
||
已启用时,新建或首次打开的空白顶层会话会自动切到「自动审查」模式(宿主侧创建监听与
|
||
客户端会话同步双保险)。
|
||
- **不覆盖已有对话与用户手动选择**:已有对话内容的会话(`blank === false`)、子代理会话
|
||
以及已处理过的会话(记录在 `dsh.better-chat.permission-handled.v1`)不会在页面刷新、
|
||
重连或重启时被重置;手动切到「仅可查看」或「工作区内修改」后始终保留。
|
||
|
||
## 功能四:插件商店「更新」按钮(v0.3.0)
|
||
|
||
从自定义索引装的插件在发现页只有「有新版本」标签。本功能补一个「更新到 x.y.z」
|
||
按钮:数据与动作都走宿主自己的 `remote.pluginMarket` / `remote.pluginManager`,
|
||
按索引给出的精确 spec 覆盖安装,不模拟点击。远程服务由子插件单独 inject,未启用
|
||
实验性插件索引时静默关闭。
|
||
|
||
## 开发
|
||
|
||
```sh
|
||
# Windows:pnpm 默认 isolated linker 建 rolldown 原生符号链接会栈溢出,用 hoisted
|
||
pnpm install --config.node-linker=hoisted
|
||
pnpm build # tsdown
|
||
pnpm test # vitest
|
||
```
|
||
|
||
- **单产物**:`lib/host.js` 是宿主入口,`lib/client.js` 是唯一的 Web 客户端产物,
|
||
注册 id `dsh-better-chat`。阅读视图与聊天增强在 `src/client/index.tsx` 里合流。
|
||
- **构建工具链**:[`tools/client-build.js`](tools/client-build.js) 是 dshx 0.9.7 的
|
||
客户端打包适配器(MIT,见第三方声明);目标 DSH 的平台模块表固定为
|
||
`tools/harness/packages/client/web/src/platform.ts`(随仓库,来源 dsh-v0.2.2-rc.2)。
|
||
设置 `DSHX_HARNESS` 可改为构建到别的 Harness 版本。
|
||
- **测试**:`tests/chat/` 覆盖聊天增强;`tests/*.test.ts` 是随阅读视图一并继承的
|
||
上游套件(已按合并后的包结构重新基线)。
|
||
|
||
## 目录
|
||
|
||
```text
|
||
src/host.ts 宿主入口(reveal / metrics 路由)
|
||
src/client/index.tsx 合并后的客户端入口
|
||
src/client/reader-plugin.tsx 阅读视图入口(原 dsh-better-display client)
|
||
src/client/chat/ 审批键盘、权限 UI、商店更新
|
||
tools/ dshx 客户端构建适配器 + 目标平台表
|
||
tests/ 聊天增强 + 阅读视图测试
|
||
```
|
||
|
||
## 许可与来源
|
||
|
||
本仓库 MIT。阅读视图源码与文档来自 [dsh-better-display](https://github.com/aa2246740/dsh-better-display)
|
||
(MIT),版权与许可全文见 [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) 与
|
||
[`licenses/`](licenses/)。
|