humblebanana/dsh-record-replay

Name: humblebanana/dsh-record-replay
Author: humblebanana

插件Plugin 原生Native ⭐ 10 MIT cat_label.computer-usecat_label.computer-use cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.macoscat_label.macos cat_label.record-replaycat_label.record-replay

DeepSeek Harness 通过演示记录 macOS 桌面工作流，并将其转化为智能体技能（open-record-replay 技能 + orr_* 工具）

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-record-replay 是一个 DeepSeek Harness 客户端插件，把 Open Record/Replay macOS 工作流录制器接入智能体。它注册 open-record-replay 技能与六个 orr_* 工具，让智能体录制、校验并打包用户在 macOS 上的演示操作，生成原生技能素材。适用于把人工示范转化为可复用技能。需 macOS、Xcode 命令行工具、Node.js ≥22.19 以及 open-record-replay 检出目录。

dsh-record-replay is a DeepSeek Harness client plugin that integrates the Open Record/Replay macOS workflow recorder into agents. It registers the open-record-replay skill and six orr_* tools, enabling an agent to record, validate, and package a user's macOS demonstration into native skill material. Use it to convert manual walkthroughs into reusable skills. Requires macOS, Xcode Command Line Tools, Node.js ≥22.19, and a local open-record-replay checkout.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-record-replay】【https://github.com/humblebanana/dsh-record-replay】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:humblebanana/dsh-record-replay

把 humblebanana/dsh-record-replay 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.3 KB · 缓存于 2026-08-23 03:41:14 · 4.3 KB

dsh-record-replay

A DeepSeek Harness plugin that turns the Open Record/Replay macOS workflow recorder into first-class harness capabilities.

It registers the open-record-replay skill and six model-facing orr_* tools, so an agent can learn a user-demonstrated desktop workflow: record the user's real macOS actions, validate the evidence, and package it for the host agent's native skill creator.

user demonstrates a workflow
  -> orr_record_start            (capture session.json + events.jsonl)
  -> orr_record_stop             (finalize)
  -> orr_session_validate        (check the evidence against the contract)
  -> orr_session_events          (read what the user actually did)
  -> orr_skill_prepare           (package a skill-input directory)
  -> host skill creator

Requirements

macOS (the recorder's native backend is Swift; it needs Xcode Command Line Tools).
Node.js >= 22.19 (the Harness runtime).
A DeepSeek Harness installation.
An open-record-replay checkout whose bin/orr.js the plugin invokes.

Install

Build the package and add it to a profile as a bundle:

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

dsh plugin add records the package in the profile's package.json dependencies and dsh.profile.bundles, and the harness heals the profiles/node_modules fallback so the bundle resolves. The shipped cordis.patch.yml mounts a neutral row; point it at your checkout by overlaying the row from your profile's cordis.patch.yml:

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

The profile patch file is hot-reloaded, so the running GUI picks the plugin up without a restart. Restart the Harness if you are not on a live profile.

Configuration

Key	Default	Meaning
`cliPath`	env `ORR_CLI_PATH`	Explicit path to `bin/orr.js`. Overrides `repoRoot`.
`repoRoot`	env `ORR_REPO_ROOT`	Path to an open-record-replay checkout; the CLI is `<repoRoot>/bin/orr.js`.
`runsOut`	`runs`	Workspace-relative recordings directory.
`skillInputsOut`	`skill-inputs`	Workspace-relative skill-input packages directory.

The CLI runs with the session workspace as its working directory, so recordings and skill packages land where the agent's filesystem tools can read them.

Tools

Tool	CLI mapping	Purpose
`orr_permissions_check`	`permissions check`	Verify Accessibility / Input Monitoring before recording.
`orr_record_start`	`record start`	Begin capturing the user's demonstration.
`orr_record_stop`	`record stop`	Finalize the session after the user finishes.
`orr_session_events`	`session events`	Read the evidence stream (`events.jsonl`), capped at `limit` events.
`orr_session_validate`	`session validate-recording`	Check the recording against the official contract.
`orr_skill_prepare`	`skill prepare`	Build the evidence package for the host skill creator.
`orr_skill_create`	— (built-in)	Built-in skill creation fallback. Generates a SKILL.md skeleton from a recorded session following the Anthropic skills spec (kebab-case name + description frontmatter, progressive-disclosure body, `evals/evals.json`), validates agent-authored drafts, and installs to `~/.agents/skills/<name>/`. Prefer a host-native Skill Creator when one exists; this is the fallback.

Development

pnpm install
node scripts/link-dsh.mjs    # links @deepseek-ai/* from a DSH checkout/harness
pnpm build                   # tsc
pnpm test                    # vitest
pnpm validate                # build + test

Tests assert the registration contract and exercise the CLI runner through a stubbed subprocess service; node scripts/link-dsh.mjs --path <dir> points the @deepseek-ai scope at an explicit DSH checkout.

License

MIT — see LICENSE.

渲染基于仓库 humblebanana/dsh-record-replay 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install