只读项目文件树 githezhihao/norma-project-explorer

Norma Project Explorer

用于 Norma Harness 会话侧栏的紧凑只读项目文件树。文件夹按钮位于 Workspace 搜索旁边，可将会话列表区域切换为当前项目目录。

截图

| 工作区总览 | 插件源码目录 |
| Norma Harness 项目浏览器展示 DeepSeek Harness 工作区根目录 | Norma Harness 项目浏览器展示 TypeScript 和 CSS 文件徽标 |

功能

- 在 Workspace 范围内按需加载目录。
- 参考 VS Code，为常见源码、配置、文档、数据和图片格式显示彩色徽标。
- 文件名、悬停状态、文件夹和目录折叠标识遵循 Harness 主题。
- 双击文件时调用 Host 已有的 openPath 操作。
- 不编辑文件、不注入模型上下文、不监听文件系统，也不建立独立权限配置。

兼容性

本仓库是 Norma Harness 使用的源码包，目前依赖 DeepSeek Harness norma/custom 分支提供的 Workspace 目录 API 和 sidebar.workspaces.headerAction 列表槽。

它目前不是独立 npm bundle，不能通过 dsh plugin add 安装到未经修改的 DeepSeek Harness profile。先公开源码是为了让实现、安全属性和后续开发可公开审阅，同时不夸大它与上游版本的兼容性。

源码接入

将本仓库放到兼容 Norma Harness 源码树的 packages/client/ui-project-explorer。Host 必须提供 Workspace 范围内的 listFiles 和 openPath 操作，Web 客户端必须暴露 sidebar.workspaces.headerAction。随后在 Web bundle 和客户端 TypeScript aggregate 中注册本包，并构建本包及 Web 前端。

安全

组件不直接读取文件系统。目录穿越检查、Workspace 根目录约束、隐藏项过滤和路径打开仍由 Harness Host 负责。插件不接触凭据、环境变量、文件内容或模型提示词。

开发

本包使用 DeepSeek Harness monorepo 工具链。在兼容源码树中执行：

pnpm exec tsc -p packages/client/ui-project-explorer/tsconfig.json
pnpm exec tsdown --env.DSH_BUILD_FACE client -F '@norma-harness/ui-project-explorer/client'
pnpm exec vitest run packages/client/ui-project-explorer/tests

路线图

- 将所需 Host 能力和客户端组件封装成可安装的 dsh.bundle。
- 增加键盘导航和文件系统刷新事件。
- 文件编辑、删除和模型上下文注入继续保持在该插件范围之外。

许可证

MIT