返回目录

open-record-replay

维护状态: 活跃

humblebanana/open-record-replay

开源 macOS 记录回放工作流工具,捕获鼠标、键盘与 UI 事件,帮助 computer use 智能体学习、回放并自动化桌面任务。

前往 GitHub
$ git clone https://github.com/humblebanana/open-record-replay.git && cd open-record-replay

145

星标

4

Fork

Swift

语言

MIT

许可证

2026-06-21

创建于

2026-06-22

最近推送

仅限 macOS 的命令行录制器,把演示过的桌面工作流转成证据(session.json / events.jsonl),供 Agent 生成可复用技能。不是 dsh 插件(无 `dsh plugin` 安装);通过内置宿主 Agent SKILL.md 配合 DeepSeek Harness 使用。需要 macOS + Node.js 18+。

DSH 适配

生态相关

作者声明

安全审计

未审计

最后核验

2026-08-23

许可证

MIT

01它能帮你完成什么?

  • Record a macOS desktop workflow once and hand the evidence to an agent to build a reusable skill

    Structured artifacts (session.json, events.jsonl) plus a validated skill-input package (README.md, events.jsonl, session.json) the agent's own skill-creation flow consumes

    Developers/agents who want to teach a Computer Use agent a UI workflow (file pickers, drag-drop, multi-app) that has no clean API, by demonstrating it once

02如何接入 DeepSeek Harness?

前置条件

  • macOS
  • Node.js 18+, Swift toolchain / Xcode Command Line Tools, Accessibility and Input Monitoring permissions

安装步骤

  1. 01

    Clone the repo: `git clone https://github.com/humblebanana/open-record-replay.git && cd open-record-replay`

    $ git clone https://github.com/humblebanana/open-record-replay.git && cd open-record-replay

  2. 02

    Run `npm install` then `npm run check`; grant macOS permissions with `node bin/orr.js permissions request`

    $ npm install

验证接入成功

作者未说明

回滚

  • The README documents install/check and a host-agent skill handoff, but no explicit uninstall command beyond removing the cloned directory.

03DSH 适配与能力边界

DSH 适配生态相关

Not a dsh plugin: a macOS CLI recorder that captures desktop workflows into session.json/events.jsonl so a coding agent (incl. DeepSeek Harness) can turn a demonstration into a reusable Computer Use skill.

  • macOS workflow recorder

    A demonstrated desktop workflowsession.json + events.jsonl capturing window.changed, mouse.click/drag, keyboard.text_input/submit, selection.changed, app/window attribution, UI targets, accessibility tree

    The core recorder does not require Screen Recording; recordings are local by default
  • Validation & skill packaging

    A recorded session`session validate-recording` checks quality; `skill prepare` writes a skill-input package (README.md, events.jsonl, session.json) for the agent

    The final skill is created by the agent's own skill system, not by this tool
  • Host-agent skill

    Agent instructionsAn included SKILL.md tells the agent when to start/stop recording, how to inspect events.jsonl, and how to hand off the evidence package

    The agent should stop its turn while the user demonstrates, then resume after

04适合谁?何时不该用?

适合

  • Developers/agents who want to teach a Computer Use agent a UI workflow (file pickers, drag-drop, multi-app) that has no clean API, by demonstrating it once

不适合

  • Open Record/Replay is a macOS-only, alpha-stage CLI; it requires Node.js 18+, the Swift toolchain / Xcode Command Line Tools, and Accessibility + Input Monitoring permissions. The core recorder does not need Screen Recording.
  • events.jsonl can contain sensitive data (window titles, URLs, typed/selected text, file names, local paths, accessibility-tree text). Review recordings before sharing; do not publish raw recordings with secrets or private data.

05兼容性、维护与安全提示

  • Open Record/Replay is a macOS-only, alpha-stage CLI; it requires Node.js 18+, the Swift toolchain / Xcode Command Line Tools, and Accessibility + Input Monitoring permissions. The core recorder does not need Screen Recording.
  • events.jsonl can contain sensitive data (window titles, URLs, typed/selected text, file names, local paths, accessibility-tree text). Review recordings before sharing; do not publish raw recordings with secrets or private data.
  • This is a generic agent tool, not a DeepSeek Harness plugin — there is no `dsh plugin` install path. It works with any coding agent's skill-creation flow, including DeepSeek Harness, via the included host-agent SKILL.md.
2026-06-212026-06-22作者未说明

MIT · 由 facts pack 抓取(README 分支 main)

06常见问题

Open Record/Replay 是 DeepSeek Harness 插件吗?

不是。它是一个独立的 macOS CLI 工具,没有 `dsh plugin` 安装路径。它配合任何编码 Agent 的技能创建流程使用——包括 DeepSeek Harness——通过内置的宿主 Agent SKILL.md 告诉 Agent 何时录制、如何交接证据。

怎么安装?

克隆仓库,运行 `npm install`,然后 `npm run check`。用 `node bin/orr.js permissions request` 授予 macOS 辅助功能与输入监控权限。需要 macOS、Node.js 18+ 与 Swift 工具链 / Xcode Command Line Tools。

一次录制会产出什么?

session.json 与 events.jsonl,记录窗口变化、鼠标点击 / 拖拽、键盘输入、选择内容与辅助功能树上下文。`session validate-recording` 校验质量,`skill prepare` 写出供 Agent 使用的技能输入包。

我的数据安全吗?

录制默认保存在本地,但 events.jsonl 可能包含敏感信息(窗口标题、URL、输入文本、文件路径、辅助功能树文本)。分享前请先检查,切勿公开含密钥或隐私的原始录制。

08数据与来源

  • 作者声明github.com8eff3fa62178…

    Teach Computer Use agents by demonstration.

  • 作者声明github.com8eff3fa62178…

    git clone https://github.com/humblebanana/open-record-replay.git

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-23。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。