dsh-better-chat/README.md

108 lines
6.1 KiB
Markdown
Raw Permalink 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 聊天增强插件。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/)。