dsh-my-files

My Files for DeepSeek Harness

@kksw/dsh-my-files

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

功能

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

安装

需要 DeepSeek Harness（Web 版，dsh ≥ 0.1.0-rc.5）。

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

然后重启 dsh：

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 源码环境中重建：

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

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

测试

pnpm install
pnpm test

已知限制

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

License

MIT