DeepSeek Harness 插件

uptoheart/dsh-file-bookmark

Star 数 ★ 0 下载量(近 30 天) 1,255 分类 工具与能力 收录于 2026-09-21 npm dsh-file-bookmark

在 DeepSeek Harness 中管理常用的文件书签,支持保存、列出与跳转,并且可以创建常用的项目,包括管理类项目、代码类项目等。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-file-bookmark

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:uptoheart/dsh-file-bookmark

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

DeepSeek Harness 插件:文件收藏 & 快速打开,支持文件夹、VS Code、IDEA、CMD 四种打开方式。

开发

# 安装依赖
pnpm install

# 构建(tsc + client.js 包装 + ui.html 拷贝到 dist/)
npm run build

# 类型检查(不产出文件)
npm run typecheck

# 启动 DSH web 并加载本插件(必须在插件根目录执行)
dsh web --patch .\cordis.patch.yml

插件通过 symlink 安装在 ~/.dsh/profiles/web/node_modules/dsh-file-bookmark, 指向项目根目录,所以每次 npm run build 后 DSH 自动加载最新 dist,无需重新安装插件。

浏览器打开 DSH 界面后按 Ctrl+Shift+R 可强制刷新 client.js。

项目结构

src/
  server.ts           # HTTP server (127.0.0.1:17319),提供 API + UI
  server-utils.ts     # sendJson / sendHtml / readJsonBody 等工具
  platform.ts         # 跨平台 spawn(explorer / code / idea / cmd)
  client/
    shared.ts         # 浏览器端 discoverServer() — 探测后端端口
    panel.ts          # 官方 panel 模式 iframe 挂载
  routes/
    open.ts           # POST /api/open — 用四种方式打开路径
    bookmarks.ts      # GET/POST/DELETE /api/bookmarks
    workspaces.ts     # GET/POST/DELETE /api/workspaces
  ui.html             # 面板 UI(后端启动时读入内存)
  index.ts            # DSH 插件入口:startServer() + 注册 tool
dist/                 # 构建产物(symlink 到 DSH profiles)

API

所有接口均启用 CORS(动态回写 Origin),仅监听 127.0.0.1。

方法 路径 说明
GET / 返回 ui.html
GET /api/bookmarks 收藏列表
POST /api/bookmarks 新建收藏 { name, path }
DELETE /api/bookmarks/:id 删除收藏
GET /api/workspaces 工作区列表
POST /api/workspaces 新建工作区
DELETE /api/workspaces/:id 删除工作区
POST /api/open 用指定方式打开 { path, method } method ∈ folder / vscode / idea / cmd
POST /api/select-folder 弹出系统文件夹选择对话框

注意事项

  • spawn 异步错误必须 .once('error', () => {}) 吞掉,否则 Node.js 进程会崩溃
  • Windows 下 VS Code spawn 需要 shell: true,因为 code 是 code.cmd
  • cmd.exe / explorer.exe 打开要 windowsHide: false,否则窗口被隐藏
  • ui.html 是 server 启动时读入内存的,改完后需要重启 DSH 才生效

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。