ZadLoop 全能工具箱 Lucifer-xD/zadloop-ultimate-toolkit

ZadLoop Ultimate Toolkit

一个压缩包，六个集成工具，不用再到处找插件。

ZadLoop Ultimate Toolkit 把 Computer Use、Context Surgery、同会话 Undo、实时会话模式切换、完整聊天转移和 Theme Studio 打包进一个自包含的插件文件。依赖已经内置在发行版里，你的朋友只需安装一个 .tgz，不用再去找一堆单独的包。

社区项目。与 DeepSeek 或 ZadLoop 无隶属关系，也未获其背书。

包含哪些内容

| 功能 | 作用 | 内置版本 |
| Computer Use | 让具备视觉能力的智能体管理自己的访问权限，并操作可见的 Windows 桌面，支持截图、鼠标、键盘、滚动，还有一个会到期的计时器 | 1.1.1 |
| Context Surgery | 编辑回复文本，单独编辑推理内容，把消息从后续模型上下文中移除，并使用 /context 命令 | 0.1.2 fixed-v4 |
| 同会话 Undo | 从对话记录和后续上下文中移除一组用户/助手往返，无需新建会话 | 1.5.1 |
| 模式切换器 | 在 Standard 和 Delegate 模式之间切换当前会话 | 2.0.3 |
| 会话转移 | 导出/导入完整聊天，包含标题、事件、设置、子代理、文件和图片 | 1.0.2 |
| Theme Studio | 50 个深色 + 20 个浅色模式专属主题、渐变、细致控制项，还有实时预览 | 5.0.3 |
| 离线依赖 | 内置运行时包，包括 fflate；安装 tarball 时无需查询 npm | bundled |

紧凑工具栏，含 Themes、Mode 和 Transfer

安装

ZadLoop 界面

1. 从最新的 GitHub release 下载 dsh-zadloop-ultimate-toolkit-1.2.0.tgz。
2. 如果已经装了独立版本，先禁用或卸载下面这些，避免按钮重复：
- @wasd258/dsh-context-surgery
- dsh-zadloop-undo
- dsh-zadloop-mode-switcher
- dsh-zadloop-computer-use
- dsh-zadloop-theme-studio
- dsh-zadloop-session-transfer
3. 打开 Plugins → Add plugin → Tarball。
4. 选择下载好的 toolkit .tgz。
5. 让 ZadLoop 热加载它。只有你的 ZadLoop 版本明确要求重启时才重启。

命令行

cd "$env:APPDATA\ZadLoop\harness\profiles\web"
pnpm add "C:\path\to\dsh-zadloop-ultimate-toolkit-1.2.0.tgz"

如果你的包管理器不会自动处理，就把 dsh-zadloop-ultimate-toolkit 手动加进 dsh.profile.bundles，加一次即可。

功能指南

Computer Use

直接用自然语言提一个桌面任务。智能体会在需要时用 computer_access 开启控制，通过截图操作，做完之后再暂停访问。底部 dock 里的 Computer 仍然提供实时状态、手动 15–120 分钟的控制，以及 Pause now，用来终止正在执行的动作。

然后自然地说出需求，比如：

- “打开设置，开启 Night light。”
- “用浏览器下载我最新的一张发票。”
- “打开这个表格，按日期排序。”

每执行一步，模型都会收到一张新截图，并且可以移动、单击、双击、右键、拖拽、滚动、输入 Unicode 文本，以及按下 CTRL+L、ALT+TAB 这类快捷键。在缩放过的桌面和多显示器桌面上，坐标依然准确。

Computer Use 控制中心

请使用支持视觉的模型。对重要操作要盯着点，遇到密码、支付、账号变更等敏感动作，先暂停。

Context Surgery

在助手消息下方使用这些操作：

- Edit reply 修改可见的回复文本，同时保留推理和工具调用。
- Edit reasoning 只修改推理流。
- Remove 通过只追加的表面替换，把这条消息从模型可见的上下文中遮蔽掉。
- /context list、/context edit、/context think、/context clear-think、/context rewrite、/context delete、/context replace 提供命令级别的控制。

Context Surgery 与 Undo 示例

Context Surgery 很强：它会改变模型下一次请求时看到的内容。原始持久日志会保留，方便审计。

同一会话内撤销

点击某轮对话旁边的 Undo。选中的用户消息及其回复会从可见记录和后续模型上下文中移除，而会话 ID 保持不变。

Undo 不会回滚文件修改、命令、部署或其他外部副作用。

Standard ↔ Delegate 模式

dock 上的紧凑控件会显示当前模式和目标模式，例如 Standard → Delegate。点击它会重新组合现有的实时智能体，并记录 agent-preset/selected；不会开启新会话。

Theme Studio

从底部 dock 打开 Themes。可以从 70 个随模式变化的预设里挑，也可以调整字体排版、表面、强调色、圆角、密度、阴影、渐变和聊天配色，预览始终实时。

Theme Studio 效果图

- 深色预设只在深色模式下出现。
- 浅色预设只在浅色模式下出现。
- 每个预设都会重新着色背景、面板、输入框、消息、文本、边框和交互状态——不只是壁纸。

转移完整聊天

1. 打开你想迁移的会话。
2. 点击 Transfer → Export complete chat。
3. 把生成的 .zadloop-session.zip 复制到另一台 PC 或 RDP。
4. 在那台机器上安装这个工具包。
5. 点击 Transfer → Choose transfer file，选中这个 ZIP。

会话迁移示意图

归档会保留会话标题和身份、模型/模式/访问事件、完整对话、推理、工具调用与结果、子代理会话、文件以及图片。导入时拒绝覆盖已存在的会话 ID。

机器级凭据、API 密钥、服务商登录信息和全局偏好被有意排除在外。请到目标电脑上单独配置这些内容。

实际示例

完整工作流见 examples/WORKFLOWS.md：

- 纠正助手给出的错误回答，同时不丢失工具调用。
- 撤销一次误发的对话轮次，重新发送修正后的提示词。
- 让长时间运行的会话在 Standard 和 Delegate 之间切换。
- 把会话从 PC 迁移到 RDP。
- 构建相互匹配的深色和浅色视觉配置档。

安全与隐私

- 这个工具包不添加任何遥测。
- Session Transfer 只写入本地的 ZadLoop 会话/附件存储。
- 导入归档时会检查路径穿越、加密、ZIP64、条目数量、压缩后大小、解压后大小、JSONL 是否合法、事件序列是否连续、会话 ID 是否重复，以及附件是否完整。
- 上下文编辑和 Undo 都是追加式写入。它们改变模型可见的表面，而不是抹掉持久日志。
- Context Surgery 只暴露回环地址上的本地 API 路由。任何受信任的本地进程都能访问回环地址，所以请在受信任的机器上使用 ZadLoop。
- Computer Use 仅支持 Windows，每次主机启动或插件重载后都处于暂停状态，从不持久保存访问授权，只暴露固定的桌面操作，而不是任意命令执行。
- 智能体可以通过 computer_access 启用或暂停 Computer Use。手动点击 Pause now 会终止正在执行的桌面操作，而截图由 ZadLoop 作为普通会话附件存储，供你查看。

兼容性

已验证环境：

- ZadLoop 0.5.1
- DSH 0.2.0-rc.2
- Node.js 22.19 或更新版本
- Windows 桌面 web 配置档

干净配置档冒烟测试只安装这个 tarball，通过 DSH 的运行时包路由解析每个内置功能，并在操作系统分配的端口上启动独立的 web 主机。Computer Use 还要求 Windows，以及一条接受图像输入的模型路由。

开发

npm ci --ignore-scripts
npm test
npm run check
npm pack

发布包使用 npm bundledDependencies。vendor/ 归档让构建可复现，并让安装保持离线。Computer Use 的完整源码、Windows worker、客户端面板和测试都在 packages/computer-use。

参见 docs/ARCHITECTURE.md、CONTRIBUTING.md 和 SECURITY.md。

致谢

- Context Surgery 基于 WASD258-jpg/dsh-context-surgery，采用 MIT 协议。
- 上下文表层替换沿用 DeepSeek Harness 压缩所用的同一套只追加机制。
- 完整署名见 THIRD_PARTY_NOTICES.md。

许可证

MIT。见 LICENSE。