dsh-session-intelligence

Readme

# 会话情报 · DSH Session Intelligence

[English](README.en.md)

DeepSeek Harness Web 插件：在右侧工作区常驻显示会话初衷、最近用户需求、运行状态和 Git 信息。适合隔一段时间回到会话时快速找回上下文。

## 功能预览

下图使用**虚构会话数据**渲染实际插件组件；周围演示布局用于说明功能，并非完整 DSH 应用截图。没有使用真实聊天或项目资料。

### 固定在右侧，聊天和输入区保持可用

![右侧会话情报与标题栏摘要条的功能演示](assets/sidebar-overview.jpg)

### 分清最初目标和最近要求

![初衷摘要、最近用户需求与 Git 状态的功能演示](assets/request-summaries.jpg)

## 功能

- **初衷（DSH 摘要）**：使用 DSH 模型总结首条含文字的用户消息，保留主要对象、动作和约束。
- **最近用户消息（DSH 摘要）**：总结最近一条含文字的用户消息，后续助手回复不会覆盖它。
- **主题与活动**：最新会话标题、最近用户消息时间、最近活动、用户/助手消息数和成功完成轮次数。
- **运行状态**：运行中/空闲、活跃子代理数量、agent preset。
- **Git 状态**：分支、worktree 名称、HEAD、未提交文件，以及相对本地 upstream 引用的领先/落后数量；不会执行 fetch。
- **右侧真实布局**：进入会话时自动打开“会话情报”，随后尊重关闭、折叠和标签切换；标题栏摘要条可再次打开它。

摘要不是逐字原文，也不是对整段对话进度的总结。只有一条用户文字消息时，两处共用一个摘要。界面目前为中文，摘要跟随用户消息的语言。

## 兼容性

已在 macOS、Node.js 24、DSH `0.1.1-rc.2`、`dsh-better-sidebar 0.14.0` 上验证原始功能。公开包的自动测试不需要 DSH 或模型凭据。Node.js 最低要求为 22；其他 DSH 版本、操作系统和移动布局尚未完整验证。

依赖原作者的 [DSH-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)。它必须安装并启用；本插件不会复制或重新发布该依赖。由于右侧停靠使用其布局状态，目前将支持范围限制为 `0.14.x`。

## 安装

先确认 `dsh web` 能正常运行，且模型已配置。以下命令用于默认 `web` profile；自定义 profile 请替换名称。

```sh
dsh plugin --profile web add dsh-better-sidebar@0.14.0
dsh plugin --profile web add https://github.com/leechengwei/dsh-session-intelligence/releases/download/v0.1.0/dsh-session-intelligence-0.1.0.tgz
```

已下载发布包时也可安装本地文件：

```sh
dsh plugin --profile web add /absolute/path/to/dsh-session-intelligence-0.1.0.tgz
```

保存进行中的工作、等任务结束后，重启对应的 DSH Web 服务，再硬刷新页面。进入一个有聊天记录的会话，右侧会出现“会话情报”。首次摘要可能需要约 20 秒；模型未配置、请求失败或会话尚未记录模型路由时会显示明确提示。

### 从本地旧版迁移

若已安装 `@local/dsh-client-ui-session-status`，先移除它，再安装本插件：

```sh
dsh plugin --profile web remove @local/dsh-client-ui-session-status
```

两版共用路由和标签 ID，不能同时启用。若曾手工添加挂载行，只移除指向旧包的那一行，不要删除其他插件配置。原来保存在底部的“会话情报”标签会迁回右侧。

### 卸载

```sh
dsh plugin --profile web remove dsh-session-intelligence
```

随后重启 DSH 并刷新页面。不会删除聊天记录，也不会自动移除其他插件共用的 better-sidebar。

## 隐私与费用

安装并打开会话会自动触发辅助模型请求。插件复用该会话最近记录的 DSH provider/model，不要求额外 API key。每条待总结的完整文字会发送给该模型提供商，可能产生额外 token 费用；**没有承诺离线处理或自动脱敏**。

插件不将原始消息作为字段返回侧栏接口、不主动写入聊天事件、不写摘要磁盘缓存；最多在进程内缓存 200 项生成摘要。重启、淘汰缓存或模型变化后可能重新生成。摘要本身也可能包含敏感信息；DSH 和模型提供商自身的日志/数据保留策略不受此插件控制。详见 [PRIVACY.md](PRIVACY.md)。

## 限制

- 仅面向可信用户的本机 DSH Web。接口检查回环连接；不支持直接 LAN 访问，**不要经反向代理暴露到公网**。回环检查不是完整的身份认证。
- 只总结文本块，不理解附件或纯图片消息。图片-only 消息仍计入用户消息数量。
- 摘要是模型生成内容，可能遗漏或误解；应以原会话为准。失败时由后续刷新重试。
- 约每 30 秒刷新，也响应窗口聚焦和会话变化；助手消息计数不等于回答轮次数。
- Git 文件列表最多 40 条；不进行提交、推送、切分支或文件修改。

## 开发与验证

源码即可运行的 JavaScript，没有构建或安装时脚本。单元测试只用 Node.js 内置模块，不需要先安装依赖：

```sh
npm run check
npm pack --dry-run
npm pack
```

`lib/index.js` 是 DSH host 插件，`lib/client.js` 是浏览器模块；`cordis.patch.yml` 提供安装时挂载声明。测试使用合成消息，不包含真实会话数据。

问题反馈请提供 DSH/Node/better-sidebar 版本和脱敏后的复现步骤，不要上传密钥、完整聊天日志或私有项目截图。

## 许可证

[MIT](LICENSE)。依赖的 better-sidebar 和 DSH 保留各自许可证。