psd-automator

# PSD Automator

Cross-platform PSD text automation for teams using both macOS and Windows.

## Scope

- Phase 1 + 2 only.
- Screenshot understanding is intentionally out of scope.
- Uses one task protocol and two execution engines:
  - macOS: AppleScript (`osascript`)
  - Windows: Photoshop COM (PowerShell)

## Task Protocol

Read [references/task-schema.json](references/task-schema.json) before running.

Minimal required fields:

- `taskId`
- `input.edits[]` (`layerName` + `newText`)
- `input.exactPath` or `input.fileHint`

Key optional fields:

- `workflow.sourceMode`: `inplace` or `copy_then_edit`
- `output.exports[]`: PNG export (`mode=single` or `mode=layer_sets` for sliced/block assets)
- `output.bundle.zipName`: zip name for sliced assets bundle
- `options.pathBridgeMode`: `auto` / `always` / `off` (macOS Unicode path bridge)
- `options.bundleZip`: whether to bundle `layer_sets` PNGs into one zip
- `options.matchImagePath`: screenshot path for selecting most similar exported slice

## Build and Refresh PSD Index

Create or refresh local cache:

```bash
node skills/psd-automator/scripts/build-index.js \
  --root "/Projects/Design" \
  --root "/Users/me/Desktop/assets" \
  --index "~/.openclaw/psd-index.json"
```

Incremental refresh:

```bash
node skills/psd-automator/scripts/build-index.js --incremental
```

## Run a Task

Dry-run first (recommended):

```bash
node skills/psd-automator/scripts/run-task.js \
  --task "skills/psd-automator/examples/task.mac.json" \
  --dry-run
```

Execute:

```bash
node skills/psd-automator/scripts/run-task.js \
  --task "skills/psd-automator/examples/task.mac.json"
```

Natural-language dispatch (through OpenClaw chat command, supports `.psd` and `.psb`):

```text
/psd design-mac-01 帮我找到20260225工位名牌.psd或20260225工位名牌.psb，把姓名改成琳琳，座右铭改成步履不前，稳步前进，保存成png放置在桌面 --dry-run
```

## DingTalk image handoff (required)

When replying in DingTalk and task execution is successful with PNG output,...