一款运行在 DSH(DeepSeek Harness)中的工作区文件管理插件

文件管理(dsh-file-manager)

一款运行在 DSH(DeepSeek Harness)中的工作区文件管理插件。左侧栏提供入口,可在中央面板浏览当前工作区的文件、预览与编辑文本,并进行基础的文件/文件夹增删改操作。

插件信息

  • 包名 :@oakzhong/dsh-file-manager
  • 版本:1.0.2
  • 入口:左侧栏「文件管理」
  • 类型:Host + Client 双半部插件(bundle)

使用技术

层面 技术
插件框架 DSH Cordis 作用域 bundle(cordis.patch.yml)
Host 半部 ESM apply(ctx),通过 ctx.connection.fetch.register 注册 7 条 API 路由
文件系统 Node.js fs/promises(readdir/stat/readFile/writeFile/mkdir/rename/rm),零第三方依赖
路径安全 resolveRoot + inside() 校验,所有操作限制在已注册工作区内
HTTP 请求 Client 用 fetch + credentials: same-origin,响应显式 UTF-8 解码避免中文乱码
Client 半部 window.__ModuleLoader__.load 注册,React 无 JSX(React.createElement)
UI 样式 组件内注入 <style>,使用 DSH 主题 token,独立滚动容器
国际化 ctx.locale.register / bind,中英双语(zh / en)

功能

1. 工作区浏览

  • 顶部下拉切换已注册工作区
  • 面包屑路径导航(根目录 / 各级目录),可点击跳转、上一级
  • 搜索:按名称模糊过滤当前目录下的文件/文件夹,方便快速定位
  • 显示隐藏文件 :复选框控制是否显示 . 开头的文件/文件夹(默认隐藏)
  • 文件列表显示名称、大小、修改时间;文件类型用图标区分
  • 列表项过多时左侧可独立滚动,表头固定
  • 自动跳过 node_modules、.git 等无关目录

2. 文件预览

  • 点击文本文件显示内容,支持 UTF-8 / GBK 编码切换
  • 二进制文件(图片/PDF/压缩包等)显示大小提示
  • 底部统计行数、字符数

3. 文件编辑

  • 文本文件可切换「编辑」模式,用 textarea 修改内容后保存
  • 保存写回磁盘并刷新列表与预览

4. 文件与文件夹操作

  • 新建文件夹:在当前目录创建,带输入框
  • 新建文件 :创建空文件并自动进入编辑模式(无扩展名自动补 .txt)
  • 重命名:文件名/文件夹名行内编辑,Enter 保存 / Esc 取消
  • 删除:文件与文件夹均可删除,需二次确认(文件夹递归删除,禁止删根目录)

Host API 路由

所有路由前缀 /api/dsh-file-manager/:

路由 方法 说明
meta GET 获取已注册工作区列表
list GET 列出目录内容(root + path)
read GET 读取文本文件(支持 encoding 参数)
mkdir POST 新建文件夹(root + parent + name)
write POST 写入/创建文件(root + path + content)
rename POST 重命名(root + path + name)
remove POST 删除(root + path,目录递归)

安全与限制

  • 所有路径操作限制在已注册工作区根目录内,越界会被拒绝
  • 单文件读取/写入上限 4MB
  • macOS 上若工作区位于 ~/Documents 等受保护目录,可能因系统 TCC 权限返回 EPERM;此时插件会提示到「系统设置 → 隐私与安全性 → 文件与文件夹」为 DSH 授权
  • 响应统一带 content-type: application/json; charset=utf-8,Client 显式 UTF-8 解码,避免中文名称乱码

目录结构

bash 复制代码
dsh-file-manager/
├── package.json          # 清单(作用域包名)、bundle 配置、client 注入声明
├── cordis.patch.yml      # Loader 插入行
├── index.js              # Host 半部:7 条文件操作路由
├── client.js             # Client 半部:UI、文件列表、编辑、滚动、样式
├── locale/
│   ├── zh.json           # 中文显示元信息
│   └── en.json           # 英文显示元信息
├── icon.svg              # 插件图标
├── README.md             # 英文说明
└── README.zh.md          # 本文档(中文)

安装与使用

  1. 通过插件管理器安装

    1.1 通过github地址安装: github.com/gougou1993/...

1.2 通过npm包名称安装:@oakzhong/dsh-file-manager

  1. 左侧栏点击「文件管理」
  2. 选择工作区,浏览目录、点击文件预览
  3. 用工具栏按钮新建文件/文件夹,用列表项右侧图标重命名或删除
  4. 界面一览
相关推荐
江屿风18 分钟前
AI Agent架构全解析:从规划到记忆的智能跃迁
人工智能·笔记·架构·agent·c/s·mcp工作流
ZONGYUAN-ROOT21 分钟前
【API配额】多源 LLM API 配额池化实战:轮换调度、变化量监控、故障自愈一套方案(Python 完整实现)
人工智能
syso_稻草人31 分钟前
qwen-image-2.1 高清放大拆解:Qwen21LatentUpscale 潜空间 2x + denoise 0.35 修细节,12 组场景实测
人工智能·stable diffusion·prompt·comfyui·qwen-image2.1
羲云网络1 小时前
GPT Image 2.6 动态表情怎么改:从情绪歧义到动作节奏验收
人工智能·gif·图像编辑
EatFan2 小时前
AI Agent 工程化元年:从单体智能到 Agent 集群的架构演进与落地路径
人工智能·架构·ai agent·autogen·crewai·agent集群·记忆工程
泯泷2 小时前
别再“裸聊”大模型了!你家的 AI 为什么总胡说八道?根子在 RAG
人工智能·算法·架构
玖米GEO运营王总监2 小时前
成都AI数字人视频怎么批量生产?流程与合规标注
大数据·人工智能·音视频
f6m274dww2cmd3 小时前
拆一个类目第一的20个曝光词:43% 的搜索量来自第二页
人工智能
RobinDevNotes3 小时前
24GB Mac 做数字人:声音放本地,画面租云端
人工智能·python·macos·开发工具