Перейти к основному содержимому
T

dsh-plugin-workspace-backup

threadripper123/dsh-plugin-workspace-backup

One-click workspace backup with per-source results and a durable job record.

Установка

dsh plugin --profile web add github:threadripper123/dsh-plugin-workspace-backup

README

DSH 工作区备份插件

为 root session 提供四个备份工具。目标固定为 G:/工作区备份,任务状态保存在 DSH_HOME/workspace-backup-jobs;未设置 DSH_HOME 时使用用户目录下的 .dsh。

工具参数行为
workspace_backup无备份当前会话的当前工作目录
workspace_backup_all无备份 ctx.workspaceRegistry.list() 登记的所有工作区
workspace_backup_status{id}读取任务记录和各来源结果
workspace_backup_cancel{id}请求取消,再用 status 确认实际终态

所有工具均在 ctx.tools.register 的 when 条件和 execute 入口验证 root session;不存在 agent 或会话头、或 parentSession !== undefined 时拒绝使用。输出使用开放对象 Schema,并由 render(_args, v) 渲染真实返回值。

当前目录 API

入口注入 tools、systemPrompt、workspaceRegistry 和 workingDirectory。当前备份调用 await ctx.workingDirectory.ensure(exec.agent, exec.signal),与内置 working_directory 工具一致,支持用户通过 working_directory({cd: ...}) 切换后的目录。不要使用不存在的 agent.cwd;agent.session.header.cwd 是会话原始目录,不能代表后续 cd 的结果。

已核对的当前安装源码(解包副本):

独立 Node 查找

启动时按以下顺序寻找独立 Node,逐个用 existsSync 和文件类型检查确认,找不到则明确报错并列出已检查路径:

  1. DSH_HOME/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe。
  2. Electron 的 process.resourcesPath/runtime/primary-runtime/dependencies/node/bin/node.exe。
  3. process.execPath 所在安装目录的 resources/runtime/primary-runtime/dependencies/node/bin/node.exe。
  4. G:/REA/node.exe。

不把桌面 Electron EXE 本身当作 Node。查询与取消不依赖 Node 重新发现。

核心模块契约

入口 从相邻核心模块导入:

import { startBackup, readStatus, cancelBackup } from "./manager.mjs";

await startBackup({ sources: [{ id, title, path }], nodePath, root, stateDir });
await readStatus({ id, stateDir });
await cancelBackup({ id, stateDir });

startBackup 返回 Promise 任务记录。当前目录若与登记工作区路径一致,使用该工作区 id/title;否则使用会话 id 和目录名。全部备份准确映射登记列表的 id/title/path,未登记目录不在全部备份范围中。备份复制、任务持久化、取消和完成判定由核心模块负责。

使用与状态解释

用户提出备份当前目录或全部工作区后,直接调用对应的一键工具,保存返回的 id,随后调用 status。任务提交、运行中或取消请求接受均不等于备份完成。只有状态明确成功且全部所选来源成功才报告完成;部分成功、取消、错误、失联或未知状态必须如实报告。启动结果不明时先按已有 id 查询,不盲目重复启动。系统提示词已包含这些约束。

交付范围

包描述 声明 ESM 入口和 DSH bundle;Cordis patch 使用顶层 insert 数组。已安装到 desktop profile 并登记 bundle。新增插件需要 DSH 重新加载 bundle 后使用。备份核心包含所有常规文件(含隐藏文件、.git、node_modules)与空目录,逐文件 SHA256 校验;目录链接保留为链接,不递归跟随,权限失败会明确记录为 partial。嵌套工作区共用父工作区中的一份内容,workspaces.json 给出各工作区对应路径。每次生成独立快照,不覆盖和删除旧备份;复制期间仍在变化的文件会记录错误,不能当作完整快照。普通备份任务随 DSH 退出可能中断,不能保证跨宿主退出存活;状态与已有文件会保留。每次任务包含 manifest.jsonl(文件哈希及错误)、result.json(汇总)和 workspaces.json(来源映射)。

Похожие плагины