sqfcyily/dsh-workspace-files0

workspace-files

工作区文件插件:提供目录列表、文件读取、Git 状态与差异对比的 HTTP 路由,并集成文件浏览器 UI 标签页。

AI 分析

核心用途是在 DSH 界面中直接浏览、读取工作区文件并查看 Git 差异。适合需要在对话中频繁参考或管理本地项目文件的开发者,无需切出窗口即可直观掌控代码库状态。

包名
workspace-files
版本
0.1.0
许可证
MIT
最近更新
2026年8月25日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:sqfcyily/dsh-workspace-files

使用

  1. 打开 dsh Web GUI(默认 http://127.0.0.1:3080)。
  2. 进入任意会话,在会话视图顶部选择「文件」标签。
  3. 左侧目录树:点击目录展开,点击文件查看内容。
  4. 若工作区是 Git 仓库:文件名右侧显示状态角标;打开文件后,右上角可在「内容 / 改动」间切换查看 diff。

工作区根目录取自当前会话的 cwd(dsh 记录的 session header),插件通过 sessionId 向宿主解析,无需手动指定路径。

配置

apply(ctx, config) 支持覆盖路由前缀(在 patch 配置中传入):

选项默认值说明
filesPrefix/api/workspace-files文件路由前缀
gitPrefix/api/workspace-gitGit 路由前缀

内置上限(源码常量,见 lib/index.js):

常量含义
MAX_READ_BYTES512 KB单文件读取上限,超出截断并标记 truncated
MAX_ENTRIES2000单层目录列举上限,超出标记 truncated
MAX_DIFF_BYTES2 MB单次 git diff 解析上限