Zalpha263/dsh-file-explorer

README 摘要

dsh-file-explorer DeepSeek Harness Web UI 侧边文件浏览器（持久插件）。 功能 - 目录树 ：懒加载展开工作区目录，目录在前、文件带大小；默认隐藏 node modules 、 .git 等（可切换） - 文件预览 ：点击文件在面板内预览；超大文件截断、二进制识别、智能换行；预览区高度可拖动调整（树区自动压缩出滚动条） - 工作区自动跟随 ：切换会话/工作区后约 1 秒内自动切换到对应目录树（DOM 探测 + Host 信号双保险） - 停靠模式 ：浮动（四边四角自由调整大小）/ 右侧（挤压对话栏，不遮挡）/ 中间，宽度记忆 - 悬浮球 ：侧边可拖动入口按钮，可随时开关 - 记忆 ：面板位置/尺寸/停靠模式/预览高度/悬浮球开关全部本地记忆（localStorage） 入口 - 会话标题栏右侧「📁 文件」按钮 - 侧边悬浮球「📁」（可拖动，工具栏「🪁 悬浮球」可开关） 架构（v2：Typert Remote 源模式） 持久版 Client 没有动态插件的 harness / host.call 内置，通信走官方 Typert Remote 桥： - Host 半区 （ lib/index.js ）： FileExplorerService extends TypertRemoteService ， super(ctx, 'fileExplorer') 自动完成两件事—— ctx.reflect.provide 注册服务、 typertRemote 绑定（Gateway 源模式发现：遍历 ctx.reflect.props → 读 typertRemote → 匹配 remoteMethods() 标记）。方法签名必须是 简单标识符参数 （Gateway 从函数 源码解析参数名作为 wire 名）。 agent/status + session/event 维护最近活跃工作区。 - Client 半区 （ lib/client.js ）： ModuleLoader .load 加载； inject 只声明 ["slots", "remote"] （ 绝不能 声明 remote.fileExplorer ——命名空间由本入口自己挂载， 静态注入会自锁）。apply 中先 await ctx.remote.$mount(贡献) 挂载 fileExplorer 命名空间（strict codec 使用透传 schema，Host 侧由 SRC 标记兜底校验），随后 必须用 ctx.get("remote.fileExplorer") 取命名空间 （属性访问 ctx.remote.fileExplorer 走 fiber 祖先链解析，对自挂载命名空间会抛错并导致面板条目崩溃退役； ctx.get 直读共享 store 始终…

分类