dsh-file-browser
DeepSeek Harness 可视化文件浏览插件:会话头部按钮 + 右侧抽屉,浏览当前对话工作目录的文件树、查看文件内容、git 状态标记,支持选中文本提问。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-file-browser@0.1.1File Browser 以 dsh-file-browser 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness (DSH) 的可视化文件浏览插件。不用启动桌面环境,直接在网页里浏览当前对话工作目录的文件树、阅读代码、选中文本向 AI 提问。
设计初衷:在平板 / 低功耗设备上通过网页使用 DSH 时,不启动 xfce 等桌面环境也能随时查看项目文件。
M 修改 / A ?? 新增 / D 删除)../ 路径穿越与符号链接逃逸均被拦截(含 realpath 复核)复制下面整段,发给你的 AI 助手,让它代你安装:
请帮我在 DeepSeek Harness 中安装 npm 包 dsh-file-browser 插件。
安装步骤:
1. 找到 DSH 的 profile 目录(通常是 ~/.dsh/profiles/web/,以 dsh 实际启动时使用的 profile 为准),
打开其中的 package.json 文件;
2. 在 "dsh" 字段下的 "profile.bundles" 数组末尾追加 "dsh-file-browser"
(没有这个数组就新建,保留原有条目);
3. 在 "dependencies" 对象中追加 "dsh-file-browser": "^0.1.0";
4. 在该 profile 目录下执行 pnpm install;
5. 重启 dsh web 进程;
6. 完成后告诉我,并说明如何验证(刷新网页后,会话右上角应出现 📁 按钮)。
~/.dsh/profiles/web/),打开它的 package.json;{
"dsh": {
"profile": {
"bundles": [
"…原有的 bundle 保持不变…",
"dsh-file-browser"
]
}
},
"dependencies": {
"dsh-file-browser": "^0.1.0"
}
}
pnpm install
# 停掉正在运行的 dsh web,再重新启动
dsh web
本地开发/调试也可以把依赖换成
"dsh-file-browser": "file:/path/to/dsh-file-browser",其余步骤相同。
curl "http://127.0.0.1:3080/api/file-browser/list?cwd=$HOME"
"dsh-file-browser" 且 pnpm install 成功,然后重启了进程并强制刷新网页(Ctrl+Shift+R)| 操作 | 效果 |
|---|---|
| 点 📁 | 打开/关闭文件浏览抽屉 |
| 点目录 | 展开 / 收起子目录 |
| 单击文件 | 替换当前 Tab 打开 |
| 双击文件 | 新增 Tab 打开 |
| 选中代码 → 💬 提问 | 输入问题,追加到聊天输入框 |
| 拖抽屉左边缘 | 调整抽屉宽度 |
| 拖中间分隔条 | 调整文件树/内容区比例 |
| 切换左侧会话 | 浏览进度自动跟随新项目 |
浏览器(client 半身) 电脑(host 半身)
┌──────────────────────┐ HTTP ┌───────────────────────────┐
│ 按钮(header.utilities)│ ──────────→ │ GET /api/file-browser/list │
│ 抽屉(shell.overlay) │ ←────────── │ GET /api/file-browser/read │
│ 状态仓库(按 cwd 分片) │ JSON │ GET /api/file-browser/git- │
└──────────────────────┘ │ status │
└───────────────────────────┘
lib/index.js):3 个只读接口 + 路径安全校验(工作区锁定、resolveInside 字符串检查 + realpath 符号链接复核)lib/client.js):注册 conversation.session.header.utilities(按钮)与 shell.overlay(抽屉)两个官方 Slot;浏览状态按项目目录分片存储(带 LRU 上限),组件卸载不丢失fetch 直连 host HTTP 接口,无需额外中间层git clone git@github.com:Liuxin4950/dsh-file-browser.git
cd dsh-file-browser
lib/index.js)后需重启 DSH 进程lib/client.js)后只需刷新网页(DSH 的 bundle rev 机制自动生效)为什么文件旁没有 git 徽标? 只有"当前目录是 git 仓库"且"有未提交变更"的文件才显示徽标,干净仓库不显示任何标记。
为什么是浮层抽屉而不是分栏? DSH 布局是固定三栏,没有"对话区旁再加一栏"的官方插槽,浮层抽屉(方案 A)是最稳定、侵入性最小的实现。
单击文件为什么有 200ms 延迟? 用于区分单击(替换 Tab)与双击(新增 Tab),保证双击时不会先触发两次单击。