- Home
- Plugin
- Strumenti e capacità
- dsh-plugin-workspace-backup
dsh-plugin-workspace-backup
threadripper123/dsh-plugin-workspace-backup
One-click workspace backup with per-source results and a durable job record.
Installazione
dsh plugin --profile web add github:threadripper123/dsh-plugin-workspace-backupREADME
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 的结果。
已核对的当前安装源码(解包副本):
- 内置 working_directory 工具:无 cd 时调用
workingDirectory.ensure(exec.agent, exec.signal)。 - 目录投影初始化:从
header.cwd初始化,随后应用working-directory/change事件。 - 有效目录读取与校验:
get(session)读取投影,ensure(agent, signal)校验目录;当前目录消失时按内置规则恢复原始目录。 - 注册工作区列表:
list()同步返回按登记顺序排列的实体,其id、title、path用于批量备份。
独立 Node 查找
启动时按以下顺序寻找独立 Node,逐个用 existsSync 和文件类型检查确认,找不到则明确报错并列出已检查路径:
DSH_HOME/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe。- Electron 的
process.resourcesPath/runtime/primary-runtime/dependencies/node/bin/node.exe。 process.execPath所在安装目录的resources/runtime/primary-runtime/dependencies/node/bin/node.exe。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(来源映射)。
Plugin correlati
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora