← 返回列表
D

dsh-workspace-files

v0.1.0 · 2 天前发布

为 DSH Web 提供当前工作区文件树右侧栏

deepseek-harnessdshdsh-pluginworkspacefile-tree

README

DSH Workspace Files

DSH Workspace Files 是一个精简的 DeepSeek Harness（DSH） Web 插件。它在 DSH Web 右侧显示当前会话工作区的文件树；点击目录可展开下一层，点击文件会调用 DSH 已有的 openPath 能力，由宿主操作系统使用默认应用打开。侧栏默认关闭，可通过会话右上角的面板图标打开或关闭。

功能

  • 在 DSH Web 的 details 右侧栏显示当前工作区。

  • 在会话右上角提供侧栏开关图标，默认不占用右侧空间。

  • 文件树按需逐层读取，不会启动时递归扫描整个项目。

  • 每层最多返回 1000 个条目，避免超大目录产生无界响应。

  • 目录在前、文件在后，同类按名称排序。

  • 文件通过 DSH 的宿主接口打开，不在浏览器中读取或预览内容。

  • 目录读取以当前会话记录的工作区为根，并校验真实路径；.. 和越界符号链接不能读取工作区外部目录。

  • 插件卸载后，路由、样式和右栏注册会由 Cordis 生命周期自动清理。

    • 兼容性

  • DSH：0.1.0-rc.5 至 0.1.x

  • Node.js：^22.19.0 或 >=24

  • 界面：DSH Web

    • DSH 仍处于开发者预览阶段，Web 插槽接口可能发生不兼容变更。插件使用 DSH 0.1.0-rc.6 的发布类型构建，并在同级源码检出 0.1.0-rc.5 上完成了真实 Web 组合验证。

    安装

    从本地目录安装

    ```bash
    dsh plugin --profile web add /absolute/path/to/dsh-workspace-files

    查看完整 README →

    版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ✅ 兼容 cordis patch ✅
    dsh@0.1.0 ✅ 兼容 标准 patch ✅
    dsh@0.2.0 ⚠️ 待验证 待实测（API 可能在变）
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

    元数据

    License
    MIT
    npm
    dsh-workspace-files
    Repo
    git+https://github.com/brickmaker/dsh-workspace-files.git
    Engines
    {"node":"^22.19.0 || >=24.0.0"}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {"bundle":{"patch":"./cordis.patch.yml"},"client":{"inject":["@deepseek-ai/dsh-client-runtime","@deepseek-ai/dsh-client-ui-layout","@deepseek-ai/dsh-client-ui-conversation"],"platform":"web"}}