# WeClaw Send 使用说明（给朋友）

> 分享包内同时提供带图解、可直接双击查看的 `使用说明.html`。

原生 macOS 菜单栏小工具：把文件直接发到微信。
**不需要** 微信网页版、命令行，也不需要其它后台程序。

**系统要求：** macOS 14 或更新，支持 Apple 芯片与 Intel 芯片 Mac

---

## 一、安装（最简单）

1. 收到 `WeClaw-Send.dmg` 或 `WeClaw-Send.zip`
2. 打开 DMG；若是 ZIP，先**解压**
3. 把 **WeClaw Send** 拖进 **「应用程序」** 文件夹
   （也可以放进用户目录下的「应用程序」）
4. 第一次打开时，系统会提示无法验证开发者；前往 **系统设置 → 隐私与安全性**，找到 WeClaw Send 后点 **仍要打开**
5. 再次确认 **打开**
6. 看屏幕**右上角菜单栏**是否出现纸飞机图标

> 不需要 Xcode，不需要终端安装脚本。拷贝 `.app` 即可。

---

## 二、第一次使用

1. 点击菜单栏 **纸飞机** 图标
2. 进入 **设置**（齿轮，或点顶部「未登录」）
3. 点 **扫码登录**
4. 用手机微信扫码，并在手机上确认
5. 若提示输入**配对码**，按手机上显示的数字填入并确认
6. 显示「已登录」后，点左上角返回发送页

登录信息只保存在你自己的电脑上，不会上传到别处。

如果 OpenClaw 已经登录微信，可在同一页把 **登录方式** 切换为 **OpenClaw**。单账号会自动选中；多账号需要手动选择。此模式不会再次扫码，但发送时要保持 OpenClaw 运行。

---

## 三、日常发送文件

任选一种方式：

| 方式 | 怎么做 |
|---|---|
| 拖到菜单栏 | 把文件拖到右上角纸飞机图标上 |
| 拖到面板 | 点开纸飞机，拖到虚线区域 |
| 选择文件 | 点开面板 →「选择文件」 |

发送时面板里的 **「最近传输」** 会显示进度（准备 → 加密 → 上传 → 完成）。

### 可选设置（设置页）

- **登录时自动启动**：开机后菜单栏自动出现，不用每次手动开
- **发送时 .mp4 显示为 .m4v**：只改微信里显示的名字，不改你电脑上的文件
- **检查并更新**：从 GitHub Release 下载 App ZIP、校验 SHA-256，并在退出后自动替换并重启 App
- **Premiere Pro 插件 / DaVinci Resolve 脚本**：点击对应按钮即可下载、校验并写入当前用户的编辑器脚本目录；App 会识别、修复或更新本地 Premiere 插件，并防止线上旧版覆盖本地新版；安装后重启对应编辑器。**DaVinci 脚本额外需要本机已安装 Python 3.6+（64-bit）**；设置页可检测 `python3` 并打开“安装指南”，完整步骤见下文「七、DaVinci Resolve 脚本」
- **反馈**：设置页「反馈」区块可打开 [产品交流与反馈](https://my.feishu.cn/docx/ZBq3dUnj1o55Q3xfJrpc9hfRnlh) 飞书文档，提交问题、建议或查看更新说明
- **帮助入口**：设置页底部可打开 [GitHub](https://github.com/double2tea/WeClawSend)、[个人作品集](https://zeezhi.pages.dev/) 或发送邮件

> 在线更新要求 App 所在目录可写。若提示目录不可写，请把 App 移到当前用户的「应用程序」目录后重试。

### 使用限制

- 单文件上限默认 **200 MB**，可在设置中选择 100 MB、200 MB、500 MB、1 GB 或 2 GB；较大文件仍可能被微信服务拒绝
- 最多同时处理 **3 个文件**；加密和 CDN 上传可并行，微信消息提交保持串行且间隔约 **2 秒**
- 微信会话有时效和发送额度限制；触发限制时 App 会提示你给 **ClawBot 发一条消息**，收到后自动重试原文件
- 请保持应用在运行（菜单栏有图标）；退出后无法发送

---

## 四、打不开 / 菜单栏没有图标（解决方法）

按顺序试，多数情况前两步就能解决。

### 1. 系统提示“无法验证开发者”（首次打开）

1. 先尝试打开一次 WeClaw Send，让系统记录拦截
2. 打开 **系统设置 → 隐私与安全性**
3. 往下找到 WeClaw Send 被阻止的提示
4. 点 **仍要打开**，输入登录密码或使用触控 ID
5. 在确认框中再点 **打开**

这是未加入 Apple Developer Program 的版本，首次打开必须由电脑所有者手动批准。

### 2. 系统提示“已损坏，无法打开”

删除当前 App，重新打开原始 DMG 或解压原始 ZIP，再拖入「应用程序」并按上一步批准。不要使用来源不明的终端命令绕过系统检查。

### 3. 双击后好像没反应

- 看**菜单栏右侧**（Wi‑Fi、电池附近）有没有纸飞机
  本应用**不会**固定出现在程序坞（Dock）
- 若菜单栏图标太多，点 `>>` 展开再找
- 到「应用程序」里再开一次 WeClaw Send
- 若仍没有：退出后重开
  菜单栏图标 → 设置 → 退出，再双击 App

### 4. 能打开，但发不了 / 提示未登录

1. 设置里确认是否 **微信已登录**
2. 未登录则重新 **扫码登录**
3. 网络需能访问微信服务；公司网/代理异常时可能失败
4. 文件是否超过设置中的「单文件大小上限」；过大请提高档位，或先压缩、切片
5. 若 App 提示会话需要刷新，给 ClawBot 发任意消息；App 获取新会话后会自动重试，不必再次选择文件

### 扫码确认后一直等待

这通常表示二维码已经扫到，但微信还没有返回最终登录确认。先在微信里给 **ClawBot 发一条任意消息**；不少情况下登录会随即完成。

如果仍未完成，取消本次登录并重新扫码，同时暂时关闭 VPN、代理或网络过滤工具。若选择了 OpenClaw 登录方式，确认 OpenClaw 正在运行且所选账号仍然有效。App 最多等待 5 分钟，超时后会结束转圈并显示处理建议。

### 5. 发送排队或耗时较久

- 同时处理数已满 3 个时，其余文件会排队
- 大文件加密、上传本身需要时间，可在「最近传输」查看“加密 / 上传 / 等待提交 / 提交”状态
- 失败项可点击「重新发送」再次入队
- 若一直失败：看失败原因文字；可尝试重新登录微信

### 6. 换电脑 / 重装后

- 需要在新电脑上**重新扫码登录**（登录态不会跟着 App 拷贝走）
- 把旧的 `.app` 删掉，换成新发的版本即可

### 7. Intel 芯片 Mac

- 当前分享包同时包含 `arm64` 与 `x86_64`，支持运行 macOS 14 或更新系统的 Intel Mac

---

## 五、Premiere Pro 25+ 面板（可选）

项目只提供 CEP 12 版本，不需要 UXP Developer Tool：

1. 推荐：在 WeClaw Send **设置 → 更新与编辑器集成 → Premiere Pro 插件 → 一键安装**
2. 重新打开 Premiere Pro
3. 前往 **窗口 → 扩展 → WeClaw Send**
4. 从面板下拉框选择用户或系统导出预设
5. 选择「完整序列」或「入点到出点（I/O）」；I/O 未设置或范围无效时面板会提示
6. 若要导出后自动发送，先在 WeClaw Send 设置中开启「本地接口」

也可以手动解压 `WeClaw-Send-Premiere-CEP12.zip` 并双击 `安装.command`。

面板会自动扫描预设并记住上次选择，不需要手动查找 `.epr` 文件。面板重新获得焦点时会同步当前序列名，手动修改过的文件名不会被覆盖；同名输出已存在时会阻止覆盖，完成后可在 Finder 中显示。修改导出参数时，在 Premiere 原生导出页保存预设，再回到面板点击「刷新」。

自动发送默认关闭；关闭时只执行导出。开启后面板会在导出前检查本机接口，渲染完成即允许继续操作并在后台发送；一个或多个发送失败时可逐个仅重试发送，不会重复渲染。

## 六、Final Cut Pro 自动发送（可选）

Final Cut Pro 使用系统原生的分享完成动作，不需要安装插件，也不需要开启 WeClaw Send 的「本地接口」。此功能需要 **WeClaw Send 1.6.8 或更高版本**。

![Final Cut Pro 目的位置设置：导出文件的操作已设为 WeClaw Send](images/final-cut-settings.jpg)

1. 把最新版 WeClaw Send 放进 `/Applications`，打开并确认微信已登录
2. 打开 **Final Cut Pro → 设置 → 目的位置（Destinations）**
3. 选择 **导出文件（Export File）**
4. 在右侧把 **操作（Action）** 设为 **其他（Other）**，选择 `/Applications/WeClaw Send.app`
5. 返回后确认「操作」显示 **WeClaw Send**
6. 使用这个目的位置分享项目；Final Cut Pro 提示分享成功后，WeClaw Send 会弹出并开始发送

建议选择 H.264 或 HEVC，把单个成片控制在 **200 MB** 以内。如果不想让所有默认导出都自动发送，可以先复制一个「导出文件」目的位置并命名为「导出并发送微信」；如果希望 `Command-E` 直接发送，则把它设为默认。

如果 Final Cut Pro 显示分享成功，但 WeClaw Send 没有新增传输记录，请确认 App 版本不低于 1.6.8，并在「操作 → 其他」中重新选择 `/Applications/WeClaw Send.app`，避免仍指向旧版本或另一份 App。

## 七、DaVinci Resolve 脚本（可选）

1. 先确认本机已安装 **Python 3.6+（64-bit）**。脚本是 Python 后渲染脚本，没有 Python 3 时可能无法运行。推荐安装最新稳定版 **Python 3.11 或 3.12**。

   **检查是否已安装：**

   ```bash
   python3 --version
   ```

   若能显示版本号（例如 `Python 3.12.x`），可跳过安装，直接进入下一步。

   **方式 A：Homebrew（推荐，后续更新也方便）**

   1. 若还没有 Homebrew，先安装：

      ```bash
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
      ```

   2. 安装 Python 3：

      ```bash
      brew install python
      ```

   3. 再检查：

      ```bash
      python3 --version
      ```

   4. （可选）若 `python3` 仍指向旧版本，可执行：

      ```bash
      brew link --overwrite python
      ```

   **方式 B：官方安装包**

   1. 打开 [python.org/downloads/macos](https://www.python.org/downloads/macos/)
   2. 下载 macOS 安装程序并双击安装
   3. 安装完成后在终端再执行 `python3 --version` 确认

   也可在 App 设置页查看 Python 检测结果，并点「安装指南」。**App 不会卸载系统或 Homebrew 的 Python**，以免误清环境。

2. 在 WeClaw Send **设置 → 更新与编辑器集成 → DaVinci Resolve 脚本** 点击安装 / 修复 / 更新；不需要时可点「卸载」。Premiere 插件同样支持卸载。
3. 安装成功后，设置页会显示安装路径；可点「显示路径」在 Finder 中打开并确认两个 `.py` 文件存在
4. 在 WeClaw Send 设置中开启「本地接口」
5. **完全退出并重新打开** DaVinci Resolve（`Cmd + Q`），脚本只在启动时扫描
6. 打开项目，进入 Deliver 页，在「在渲染作业结束时触发脚本」中选择：
   - `自动发送ClawBot_M4V文件`
   - 或 `自动发送ClawBot_MP4视频`

也可在菜单 `工作区 → 脚本 → Deliver` 中确认脚本是否已加载。

脚本安装到当前用户目录，不会写入系统目录，也不会修改项目文件或导出预设：

```text
~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Deliver/
```

若脚本下拉只有「无」：

1. 先点「显示路径」，确认上述目录里已有两个 `自动发送ClawBot_*.py`
2. 确认已彻底重启 DaVinci Resolve
3. 确认安装脚本与打开 Resolve 使用的是同一个 macOS 用户

---

## 八、安全与隐私（简要）

- 登录态保存在本机：
  `~/Library/Application Support/WeClawSend/`
  仅当前用户可读
- 文件经加密后上传微信通道，与微信客户端同类能力
- 可选的本机接口 `127.0.0.1:18790` 默认关闭，只给脚本和剪辑软件自动发送使用，**普通使用可以忽略**

---

## 九、怎么退出 / 卸载

**退出：** 菜单栏纸飞机 → 设置 → **退出**

**卸载：**

1. 先退出应用
2. 把「应用程序」里的 WeClaw Send 移到废纸篓
3. （可选）删除登录数据：
   `~/Library/Application Support/WeClawSend`

---

## 十、发给朋友的三句话版

1. 把 WeClaw Send 拖进「应用程序」，尝试打开一次。
2. 系统设置 → 隐私与安全性 → 找到拦截提示 → 仍要打开。
3. 菜单栏点纸飞机 → 设置 → 扫码登录，再把文件拖到纸飞机图标发送。
