dsh-better-chat/README.md

97 lines
5.1 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 聊天增强插件。v0.4.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 0.3.12)
给对话加一个 **阅读** 页签:执行时能看到步骤、思考与进度;整轮成功结束后把过程
收起来,留下最终回答。原版「对话 / 轨迹」、输入框、模型选择、工具和审批都还在。
- 阅读列保留宿主 ChatView 的 `data-chat-flow` 钩子,依赖该标记显示输入框的第三方
皮肤不会把阅读页当成仅检视视图。
- 最终回答里的 ````mcp-app` 代码块会挂成交互卡片(`<iframe sandbox="allow-scripts allow-forms">`)。
- 设置里的 **Better Display**:产物右侧预览、半透明毛玻璃(默认关)、过程自动折叠
(默认开),并检测 `generative-mcpapps` 技能是否已装进宿主技能目录。
- 上游的设计说明、扩展点文档与开发 runbook 一并保留在 [`docs/`](docs/)。
## 功能二:审批卡片的回车批准 / Esc 拒绝(v0.1.0,v0.4.1 加提示与始终允许快捷键)
DSH 官方审批卡本身支持 Enter 批准、Esc 拒绝,但前提是焦点先落在卡内。本插件补上:
1. **自动送入焦点**:审批卡出现时,若没有正在别处输入,把焦点送进卡片详情区。
2. **全局兜底路由**:焦点不在卡内时,在 document 捕获阶段接住回车 / Esc —— 回车
永远点「允许(单次)」(不会误触「始终允许」),Esc 点「拒绝」。
3. **键盘提示**:操作行左侧显示 `Enter 允许(单次) · Ctrl+Enter 始终允许 · Esc 拒绝`
的键帽提示,文案取卡片按钮的实际文字,卡片作答后自动消失;只做说明,不占焦点、
不可点击。Mac 上显示 Cmd+Enter。
4. **Ctrl+Enter / Cmd+Enter = 始终允许**:仅当卡片有第三个按钮时生效。官方卡片对带
修饰键的按键不作答,所以这条即使在卡片内也由本插件处理;正在输入控件里打字时
不拦截。
防误触:正在输入控件里打字、焦点已在卡内(Ctrl/Cmd+Enter 除外)、带 Shift/Alt、
长按连发、输入法组词、回车落在别的按钮或链接上、卡片已作答或按钮禁用时,都不拦截。
## 功能三:权限 UI(v0.2.0,v0.3.1 收紧)
- 去掉「完全权限 / Full access」选项:`/permission` 弹出菜单、composer 权限菜单与
通用设置的默认权限下拉里都会被摘除。只动界面,手动输入命令仍可达。
- 不覆盖已有会话权限:页面加载、刷新、插件重载都不会遍历会话改权限;默认权限交给
宿主的新建会话流程。
## 功能四:插件商店「更新」按钮(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 / skill-status / 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/)。