brickmaker/dsh-workspace-files
brickmaker★ 0TypeScript最后同步: 2026-08-16
为 DSH Web 提供当前工作区文件树右侧栏
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 组合验证。 安装 从本地目录安装 从 DSH 源码仓库运行时,将 dsh 替换成 pnpm dsh : 从 GitHub 安装 仓库已包含预构建的 lib/ 产物,Git 安装不会执行安装期构建脚本,也不需要配置 pnpm allowBuilds 。正式使用时仍建议把 GitHub 安装地址固定到版本标签或提交 SHA。 从 npm 安装 发布到 npm 后可直接安装预构建产物,不需要授予安装时构建权限: 使用 打开或创建一个带工作区的会话后,右侧栏默认保持关闭。点击会话右上角的面板图标可以打开,再次点击会关闭。 - 点击 ▸ 或目录名称:加载并展开该目录。 - 点击文件名称:使用操作系统默认应用打开。 - 点击侧栏右上角 ✕ :关闭右侧栏;之后仍可用会话右上角的面板图标重新打开。 插件会成为 DSH details 单占位的默认内容,因此启用期间会遮蔽原有工具详情面板。移除本插件或从 profile 的 patch 中禁用该行后,原面板会自动恢复。 开发 check 依次执行类型检查、单元测试、生产构建和 npm 包内容预检。生成物位于 lib/ ,并随版本提交到 Git,使 GitHub 安装无需在用户机器上运行构建脚本。 项目结构: 实现说明 包只在 cordis.patch.yml 中插入一个插件行。宿主端通过 ctx.webServer 注册…
在 GitHub 查看完整 README →