# dsh-session-id · DeepSeek Harness (DSH) 会话 ID 快速复制与定位辅助插件

[English](README.md) | 中文

<p align="center">
  <img src="https://img.shields.io/npm/v/@linxin666/dsh-client-ui-session-id?style=flat-square" alt="Version">
  &nbsp;
  <img src="https://img.shields.io/badge/DSH-%3E%3D0.2.2--rc.1-4c6ef5?style=flat-square&amp;labelColor=454a54" alt="DSH">
  &nbsp;
  <img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License">
</p>

<p align="center">
  <strong>DeepSeek Harness（DSH）官方 Web GUI 与桌面客户端会话 ID 复制与检索工具</strong><br>
  <em>侧边栏底栏入口 · 实时全量会话 ID · 一键复制到剪贴板 · 本地极速过滤 · 零 Host 开销</em>
</p>

纯浏览器端的 DSH Web GUI 插件：在侧边栏底部加入口，打开面板列出全部会话的会话 ID，一键复制。挂载到官方侧边栏底部席位（`sidebar.footer.action`），不改任何 DSH 源码，host 侧零行为。

## 是什么

- 在侧边栏底部的设置行旁边新增「会话 ID」入口：收起态与展开态都只显示
  图标按钮（文字保留为无障碍名称与悬停提示）。
- 收起态下与遥控/更新入口同列纵向堆叠、对齐轨道中轴；展开态下与其他底部
  入口同行横排。
- 点击打开居中面板，列出全部会话：显示标题、完整会话 ID（等宽字体），每行
  一个「复制」按钮；当前会话有标记。
- 面板顶部有搜索框，按标题或 ID 子串**本地**过滤（只读、不发起 host 查询），
  会话多时也能快速定位。
- 数据来自官方 `ctx.sessions.list` 实时数据源，会话开始、结束或归档时面板
  自动跟随刷新，无需手动刷新。
- 点击「复制」通过官方剪贴板助手（`writeClipboard`）写入 ID，按钮短暂显示
  「已复制」。

## 安装

### 从 npm 安装（推荐）

```sh
dsh plugin --profile web add @linxin666/dsh-client-ui-session-id@latest
```

重启 `dsh web`（或等待热更新生效）后，点击侧边栏底部的「会话 ID」入口即可。

### 从仓库安装（开发调试）

```sh
git clone https://github.com/zhu1090093659/dsh-web.git
cd dsh-web
pnpm install
pnpm -r build
dsh plugin --profile web add link:$(pwd)/packages/dsh-session-id
```

## 安全模型

- 会话 ID 是**定位 / 自动化标识，不是认证凭据**：它本身无法访问会话、
  文件或宿主。面板只展示与复制 ID，绝不写入会话日志、agent prompt 或任何
  持久化存储，也绝不自动复制。
- 复制始终由用户手势触发；剪贴板写入失败时按钮显示可操作的「复制失败，请
  重试」状态，不额外申请剪贴板权限、不做后台重试。
- 分享会话 ID 仍可能**暴露工作流关联信息**（标题、运行时间、在 workspace
  中的位置），请只在确实需要在别处引用会话时按需复制。

## 已知限制

- 需要声明了 `sidebar.footer.action` 席位的 DSH Web 外壳（0.1.0-rc.8 及更新版本）；
  旧版外壳上入口不会渲染。
- 只读查看器：只展示与复制 ID，不打开或管理会话。

## 数据遥测

浏览器半区每个 UTC 日向 dsh-market.com 发送一次匿名安装心跳：仅含一个 localStorage 随机 ID 与本包名，无其他数据。服务端只存储该 ID 的加盐哈希，不存 IP，且只暴露聚合计数。完整契约见 [docs/telemetry.md](../../docs/telemetry.md)。

## 许可证

BSD-3-Clause。