humblebanana/dsh-record-replay

dsh-record-replay

把 Open Record/Replay（macOS
桌面工作流录制器）接入 DeepSeek Harness
的插件。

它注册 open-record-replay skill 和 6 个面向模型的 orr_ 工具，让 Agent
通过一次真实演示学会一个 macOS 工作流：录制用户操作 → 校验证据 → 打包交给宿主 Agent
的 skill 创建流程。

用户演示工作流
-> orr_record_start         (生成 session.json + events.jsonl)
-> orr_record_stop          (收尾)
-> orr_session_validate     (按官方契约校验录制质量)
-> orr_session_events       (读取用户实际做了什么)
-> orr_skill_prepare        (打包 skill 输入目录)
-> 宿主 skill creator

环境要求

- macOS（原生录制器是 Swift，需要 Xcode Command Line Tools）。
- Node.js >= 22.19（Harness 运行时）。
- 已安装 DeepSeek Harness。
- 一个 open-record-replay
检出目录，插件调用其 bin/orr.js。

安装

git clone https://github.com//dsh-record-replay.git
cd dsh-record-replay
pnpm install
pnpm build
pnpm pack                      # 生成 dsh-record-replay-0.1.0.tgz
dsh plugin --profile web add ./dsh-record-replay-0.1.0.tgz

dsh plugin add 会写入 profile 的 package.json（dependencies + dsh.profile.bundles），
并由 harness 维护 profiles/node_modules 符号链接。随后在 profile 的 cordis.patch.yml
里叠加该行、指向你的检出目录：

- id: record-replay
config:
repoRoot: '/absolute/path/to/open-record-replay'
runsOut: 'runs'
skillInputsOut: 'skill-inputs'

profile patch 文件会被热加载，运行中的 GUI 无需重启即可生效。

配置

| 键 | 默认 | 含义 |
|---|---|---|
| cliPath | 环境变量 ORR_CLI_PATH | 显式指定 bin/orr.js 路径，优先于 repoRoot。 |
| repoRoot | 环境变量 ORR_REPO_ROOT | open-record-replay 检出目录；CLI 为 /bin/orr.js。 |
| runsOut | runs | 工作区相对录制目录。 |
| skillInputsOut | skill-inputs | 工作区相对 skill 输入包目录。 |

CLI 以会话工作区为工作目录运行，因此录制产物与 skill 包落在 Agent 的文件系统工具可见的位置。

工具

| 工具 | CLI 映射 | 用途 |
|---|---|---|
| orr_permissions_check | permissions check | 录制前校验 Accessibility / Input Monitoring 权限。 |
| orr_record_start | record start | 开始捕获用户演示。 |
| orr_record_stop | record stop | 用户演示结束后收尾。 |
| orr_session_events | session events | 读取证据流 events.jsonl，按 limit 截断。 |
| orr_session_validate | session validate-recording | 按官方契约校验录制。 |
| orr_skill_prepare | skill prepare | 打包证据目录，交给宿主 skill creator。 |

开发

pnpm install
node scripts/link-dsh.mjs    # 从 DSH 检出/harness 链接 @deepseek-ai/
pnpm build                   # tsc
pnpm test                    # vitest
pnpm validate                # build + test

License

MIT —— 见 LICENSE。