@kksw/dsh-my-files

Readme

# My Files for DeepSeek Harness

`@kksw/dsh-my-files`

一个 DeepSeek Harness（dsh）Web 插件：在侧边栏添加一个 **我的文件** 入口，集中查看**所有会话**里 Agent 创建或修改过的文件——按会话分组，点击即可打开文件或定位所在目录。

![My Files 面板](docs/dsh_myfiles.png)

## 功能

- **侧边栏入口**：设置齿轮上方新增"我的文件"（文件夹图标），与设置按钮同尺寸同风格
- **跨会话索引**：自动记录每个会话中工具调用创建/修改的文件（`write`、文件编辑等），历史会话在插件加载时自动回放补齐
- **两栏面板**：左侧按会话列出（含文件数），点击会话右侧显示该会话的文件；背后有灰色蒙版，点击蒙版或 × 关闭
- **文件交互**：文件名悬停变蓝 + 下划线，点击用系统默认应用打开；路径为纯文本；行尾文件夹图标打开所在目录
- **持久化**：索引存于 dsh 的 storage 领域，重启后仍在

## 安装

需要 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（Web 版，dsh ≥ 0.1.0-rc.5）。

```sh
dsh plugin --profile web add @kksw/dsh-my-files
```

然后重启 dsh：

```sh
dsh --profile web
```

刷新页面后，侧边栏底部（设置齿轮上方）出现"我的文件"入口。

### 从源码运行 dsh 时

从源码 checkout 跑 dsh 时同样可用 `dsh plugin --profile web add @kksw/dsh-my-files`（需先完成源码环境的依赖安装）。

## 使用

1. 点击侧边栏"我的文件"
2. 左侧选择会话，右侧查看该会话产出的文件
3. 点击文件名打开文件；点击行尾文件夹图标打开所在目录
4. 面板右上角刷新按钮重新拉取最新索引

## 兼容性

- 依赖 dsh 框架包（`@deepseek-ai/dsh-*`）`>= 0.1.0-rc.0`（npm 当前 `0.1.0-rc.7`）
- 前端为**预构建产物**（基于 0.1.0-rc.5 框架 API），随包发布，无需用户构建
- 打开文件/目录依赖宿主的原生 opener（macOS / Windows 桌面环境）；无原生 opener 的部署（headless/远程）点击无反应

## 开发与构建

`lib/` 为预构建产物（含宿主入口与浏览器 bundle），修改 `src/` 后需要在 DSH 源码环境中重建：

```sh
# 在 DeepSeek Harness checkout 中（提供 workspace 依赖与 tsdown 预设）
pnpm install
pnpm --filter @kksw/dsh-my-files run bundle   # 需要本仓库的构建配置
```

社区开发者如希望改进前端，请 Fork 本仓库并在 DSH 源码环境下构建后提交 `lib/` 与 `src/`。

## 测试

```sh
pnpm install
pnpm test
```

## 已知限制

- 终端命令间接创建的文件不计入索引（与 dsh 官方 deliverables 相同的词汇边界：只识别工具声明为"创建/修改"的文件）
- 冷会话回放时，仅注册在某 agent preset 内的工具可能缺失 presenter（实时调用不受影响）
- 查询路由以 loopback 为信任边界

## License

MIT