bentong-chain/dsh-plugin-dir-tree
DeepSeek Harness 插件：浮窗展示工作区目录树，支持拖拽路径、懒加载、搜索、文件类型图标。提供动态插件与持久化双包两种形态。
安装Install
dsh plugin --profile web add dsh-dir-tree把 bentong-chain/dsh-plugin-dir-tree 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-plugin-dir-tree
简体中文 | English
DeepSeek Harness (DSH) 插件：以浮窗展示当前工作区的目录树，支持拖拽文件/文件夹路径到对话框、双击复制、搜索过滤、懒加载展开。
🚀 想直接安装？用独立分发版：dsh-dir-tree（形态 C 标准 bundle，
dsh plugin add即装）
功能
- 📁 浮窗展示工作区目录树，右下角可最小化
- 🌲 懒加载：点击
▶展开子目录，避免大目录卡死 - 🖱️ 拖拽文件/文件夹到对话框，自动填入完整路径
- 📋 双击复制路径；单击选中
- 🔍 搜索过滤文件名
- 🎨 文件类型图标 + 目录 📁/📂 蓝色高亮 + 缩进树形线
- 🪟 可拖动浮窗位置
截图
主界面（浮窗 + 目录树）
右下角浮窗「📁 当前工作区」，顶部是完整路径，下面是树形目录：文件夹蓝色 + 📁 图标 + ▶ 展开箭头，文件带类型图标。
拖拽路径到对话框（动图）
拖拽任意文件/文件夹节点到对话框输入框，自动填入完整路径。
懒加载展开（动图）
点击文件夹的 ▶ 展开子目录，只加载当前层，大目录不卡顿。
最小化 / 恢复
点 − 或 × 后浮窗收起，右下角出现蓝色「📁 目录树」按钮，点击恢复。
三种形态
本仓库提供三种形态，按需选用：
| 形态 | 说明 | 优点 | 缺点 |
|---|---|---|---|
C 标准 bundle（bundle/）⭐ 推荐 |
单包 npm，dsh plugin add 即装 |
标准分发，无需 checkout/构建/创造模式 | 需发布到 npm 或 git |
A 动态插件（dynamic/） |
自包含 JS 代码 | 开箱即用 | 重启后需重新运行 + 需创造模式 |
B 持久化插件（persistent/） |
域包 + UI 包源码 | 重启自动加载 | 需在 DSH 源码 checkout 里改 api-remotes + 构建 |
⚠️ 先看你的 DSH 是怎么装的
| 安装方式 | 该用哪种形态 |
|---|---|
npx @deepseek-ai/dsh web（npm 安装） |
形态 C（推荐）或形态 A |
源码 checkout（git clone + 自己跑） |
形态 C / A / B 都可以 |
为什么推荐形态 C？
形态 C 是 DSH 官方的标准第三方插件分发方式——一个 npm「组合包 bundle」，用户 dsh plugin add 安装即可，无需源码 checkout、无需改内置包、无需创造模式。它用 ctx.connection.rpc（第三方可用的 Client→Host 通道）替代了形态 B 里一等公民专属的 @Remote/api-remotes。
形态 B 为什么被降级：它用了 @Remote + api-remotes 的一等公民机制，需要修改 DSH 内置的 api-remotes 去挂载贡献，第三方插件改不了，所以只能作为「合入 monorepo 的内置插件」参考，不适合社区分发。
形态 C：标准 bundle（⭐ 推荐）
DSH 官方的标准第三方插件分发方式：一个 npm 包（组合包 bundle），用户 dsh plugin add 安装即可，无需源码 checkout、无需改内置包、无需创造模式。
🚀 本形态已独立分发：dsh-dir-tree（已发布到 npm，含截图/文档/安装说明），一条命令即装：
dsh plugin --profile web add dsh-dir-tree
原理
- Host 半用
ctx.connection.rpc.handle('/dirtree', ...)注册一条第三方 RPC 通道（不依赖 api-remotes、不依赖 Typert 代码生成） - Client 半用
ctx.connection.rpc.call('/dirtree', 'list', { path: cwd })调用 Host - 当前工作区
cwd由 Client 半从ctx.sessions.list.getSnapshot().byId[current].cwd拿到，直接传给 Host（无需在 Host 解析会话身份）
文件结构（bundle/）
bundle/
├── package.json # dsh.bundle + dsh.client + prepare 构建脚本
├── cordis.patch.yml # 插入插件行
├── index.js # Host 半（connection.rpc.handle + node:fs 列目录）
├── client.js # Client 半源码（浮窗 UI + connection.rpc.call）
├── client.bundle.js # 构建产物（prepare 生成）
└── build.mjs # prepare 脚本：esbuild 打包 client.js
安装
方式一：npm 安装（推荐，无需任何授权）
本形态已发布到 npm，一条命令即装：
dsh plugin --profile web add dsh-dir-tree
方式二：从 git 安装（无需发布 npm）
dsh plugin --profile web add github:bentong-chain/dsh-dir-tree
首次会提示在 profile 的 pnpm-workspace.yaml 加 allowBuilds 授权，按提示复制粘贴即可。
工作原理
- Host 半注册
/dirtreeRPC 通道，用node:fs的readdir({ withFileTypes: true })列目录 - Client 半读当前会话
cwd，connection.rpc.call('/dirtree', 'list', { path: cwd })拿目录 - 浮窗渲染；点击
▶懒加载时再 call 一次子目录
说明：本形态基于 DSH 源码调研，
connection.rpc的 API 已确认；build.mjs的 esbuild 打包细节建议参照官方turtle-ui例子验证。会话身份不在 RPC 通道里，Client 半显式传cwd是最简单正确的做法。
形态 A：动态插件（最便携）
自包含代码，任何 DSH 用户都能直接使用，无需 checkout、无需构建。
前提
cordis_define/cordis_run是 DSH 的内置模型工具，由对话里的 AI agent 调用（不是手动点按钮）。所以安装方式就是「把代码交给 agent」。- ⚠️ 这两个工具只有「创造模式」（Creator mode /
cordis预设）才提供。standard（标准模式）、code（PTC 模式）、minimal（极简模式）预设里都没有，且会话创建后预设固定，无法中途切换。 - 所以安装前请确认当前会话是「创造模式」；若不是，需新建一个会话并选择「创造模式」，再在新会话里安装。
如何确认/切换：打开 设置（Settings）→ Agent 预设，可看到当前预设；新建会话时选择「创造模式」（Creator mode / cordis）。运行中的会话保持它创建时的预设不变。
安装步骤
方式一：直接粘贴代码（最通用）
打开
dynamic/host.js和dynamic/client.js，全选复制两个文件的内容。在 DSH 对话输入框里粘贴下面这段，并把两段代码填进去：
请用 cordis_define + cordis_run 安装这个目录树动态插件： Host 代码（code.host）： <粘贴 dynamic/host.js 的全部内容> Client 代码（code.client）： <粘贴 dynamic/client.js 的全部内容>发送后，agent 会自动调用
cordis_define（把 host + client 一起提交，idPrefix自动分配，如dirt），再调用cordis_run激活。第一次激活客户端代码时会弹出审批请求，点 允许 / Approve。
右下角出现「📁 当前工作区」浮窗，目录树加载完成。
方式二：让 agent 读文件（仓库已 clone 到本地时）
如果仓库已经 clone 到本地，直接对 agent 说：
读 dynamic/host.js 和 dynamic/client.js，用 cordis_define + cordis_run 装成动态插件
agent 会自己读文件、提交、运行，你无需手动复制粘贴。
使用
- 点击文件夹
▶展开子目录（懒加载） - 拖拽文件/文件夹到对话框，自动填入完整路径
- 双击复制路径；搜索框过滤文件名
- 点
−或×最小化，右下角蓝色「📁 目录树」按钮恢复
注意与常见问题
- 重启 DSH 后需重新安装（动态插件只存在进程内存里），重复上面的安装步骤即可。
- 动态插件展示的是
workspaceRegistry的第一个工作区（最近创建的那个）；若要精确跟随当前会话工作区，用形态 B。
| 现象 | 原因 | 处理 |
|---|---|---|
| 卡在「⏳ 加载中」 | 远程调用失败但未报错 | 让 agent 用 cordis_inspect_self 看诊断 |
| 报「awaiting user approval」 | 等待审批 | 点允许 |
| 浮窗不见了 | 点到了 − 或 × | 点右下角蓝色「📁 目录树」按钮恢复 |
| 重启后没了 | 动态插件不持久化 | 重新安装，或改用形态 B |
形态 B：持久化插件（标准）
拆成两个包（对齐 DSH 官方 goal 的域包 + UI 包架构）：
@deepseek-ai/dsh-dir-tree（域包，persistent/domain/）：HostDirTreeService+@Remote服务，读agent.session.header.cwd精确取当前会话工作区@deepseek-ai/dsh-client-ui-dir-tree（UI 包，persistent/ui/）：客户端浮窗 UI- api-remotes 挂载
dirTreeRemote（提供remote.dirTree命名空间）
前提
需要能访问 DSH 的源码 checkout（因为要编译 + Typert 代码生成）。
安装步骤
放源码：把
persistent/domain/下的文件放到 DSH checkout 的packages/dir-tree/dir-tree/，把persistent/ui/放到packages/client/ui-dir-tree/。具体每个文件映射到哪个src/子目录，见persistent/README.md。改 api-remotes：按
persistent/API_REMOTES_PATCH.md修改packages/api/remotes/的 3 个文件，挂载dirTreeRemote。注册 tsconfig 引用：
- 根
tsconfig.host.json的references加：{ "path": "./packages/dir-tree/dir-tree/tsconfig.host.json" } - 根
tsconfig.client.json的references加：{ "path": "./packages/client/ui-dir-tree" }
- 根
构建：
pnpm install pnpm run build:lib:host # tsc -b + tsdown（含 typert 代码生成） pnpm run build:lib:client建包链接（如果 DSH 的
require.resolve找不到包，需要手动建 Junction/symlink）：apps/cli/node_modules/@deepseek-ai/dsh-dir-tree → packages/dir-tree/dir-tree apps/cli/node_modules/@deepseek-ai/dsh-client-ui-dir-tree → packages/client/ui-dir-tree $DSH_HOME/profiles/node_modules/@deepseek-ai/... → apps/cli/node_modules/@deepseek-ai/...注册到宿主组合：编辑
$DSH_HOME/profiles/<profile>/cordis.patch.yml：- insert: - id: dir-tree name: '@deepseek-ai/dsh-dir-tree' - id: ui-dir-tree name: '@deepseek-ai/dsh-client-ui-dir-tree'重启 DSH → 右下角出现浮窗，切换工作区自动跟随。
为什么形态 B 能精确跟随工作区
域包的 @Remote 方法第一个参数是 agent: Agent（由网关从浏览器会话身份解析），用 agent.session.header.cwd 拿到本会话的工作区。每个会话各挂一份，切换工作区即切换到对应会话，目录树自动跟随。
注意
- 两个包当前是
private: true、版本0.1.0；若要发布到 npm 或过 DSH 完整 release 门禁（check-workspace-constraints/verify-package-invariants），需对照packages/client/ui-goal补invariant伴生包、publishConfig、repository，并对齐版本号。
技术要点
- 目录判断：
FsDirEntry.isDirectory是 getter 且不可靠（!!也可能失效），对每个条目调用fs.stat/fs.listDir会卡死。故采用文件名启发式（无.→ 目录）+ 懒加载（只列一层，展开时再列子目录）。 - JSON 安全：文件节点不设
children字段（undefined不是合法 JSON），目录节点设children: []。 - 形态 B 的 RPC：
@RemoteService + Typert 代码生成（生成typert.host.js/typert.remote-client.js），客户端通过ctx.remote.dirTree.listTree(sessionId, {})调用。
License
MIT
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…