# AppDuo

> AppDuo 是免费开源的原生 macOS 应用分身工具，支持为分身设置不同名称、不同图标和独立数据目录。硬分身还会修改实际进程名，可配合支持进程规则的代理工具，为不同分身分别选择直连、香港或美国等网络出口。

平台：macOS 14+；Apple Silicon 与 Intel。许可证：GPL-3.0。创建分身需要 Apple Command Line Tools。

## 不同图标、不同名称，各走各的网络

同一个微信，可以创建三个硬分身：国内私人、香港工作、美国工作。为每个分身选择不同的 `.icns` 图标，用中文显示名称辨认用途，用简短的英文进程名编写代理规则。

| 微信分身的显示名称 | 自定义图标示例 | 分身名称 / 进程名 | 网络出口示例 |
| --- | --- | --- | --- |
| 国内私人微信 | 绿色私人图标 | `WeChatCN` | `DIRECT`，本机网络直连 |
| 香港工作微信 | 紫色香港工作图标 | `WeChatHK` | 香港工作策略组 → 香港节点 |
| 美国工作微信 | 橙色美国工作图标 | `WeChatUS` | 美国工作策略组 → 美国节点 |

颜色只是示例，图标由用户选择，不会自动按地区生成。国内直连只有在本机网络出口位于国内时才是国内出口；在其他地区使用时，可改为自己已有的国内代理策略。

### 如何配置 Clash / Mihomo 进程分流

1. 在 AppDuo 选择**硬分身**，分别设置上表的“分身名称 / 进程名”和“显示名称”，选择各自的图标。
2. 在支持 Mihomo 规则的 Clash 客户端中，预先创建名为 `香港工作`、`美国工作` 的策略组，选择对应地区的节点，或将示例替换为已有策略组名称。
3. 把下面规则加入现有 `rules` 列表，放在可能提前命中的域名、GEOIP、规则集和 `MATCH` 规则之前；不要用片段覆盖完整配置。

```yaml
# 合并进现有配置，不是完整的代理配置文件
mode: rule
find-process-mode: always
rules:
  - PROCESS-NAME-REGEX,^WeChatCN(-|$),DIRECT
  - PROCESS-NAME-REGEX,^WeChatHK(-|$),香港工作
  - PROCESS-NAME-REGEX,^WeChatUS(-|$),美国工作
```

`^WeChatHK(-|$)` 匹配主进程 `WeChatHK` 及 `WeChatHK-原名称` 形式的辅助进程，避免误匹配 `WeChatHK2`。大小写需一致；这里使用字母命名，避免正则特殊字符转义问题。

代理客户端必须实际接管这些连接并能识别本机进程。微信等应用不一定遵循系统 HTTP 代理，可按客户端说明使用 TUN 等接管方式。打开三个分身，在客户端连接列表中分别检查**进程名、命中规则、出口策略**；不能仅凭图标颜色或名称判断分流生效。

### 支持哪些代理工具？

AppDuo 提供的是可区分的进程身份，不内置 Clash，也不提供代理节点。支持 `PROCESS-NAME`、进程路径或进程正则规则的代理工具可按各自语法配置；上例针对支持 `PROCESS-NAME-REGEX` 的 Mihomo 内核，不代表所有 Clash 版本或所有代理工具使用相同语法。

仅修改“显示名称”不会改变用于分流的进程名。软分身仍使用原应用进程，不能套用这里的独立进程名方案。AppDuo 内置的 HTTP/HTTPS/SOCKS5 环境变量代理是另一种配置方式，是否生效取决于应用支持情况。

参考：[Mihomo 进程规则与匹配顺序](https://wiki.metacubex.one/en/config/rules/)。

## 不同分身分别接收通知

不同分身可分别接收通知，工作与私人消息各自提醒，无需来回切换到对应分身查看。需要目标应用支持通知，并在应用内和 macOS 中允许通知；专注模式、运行状态及第三方应用版本可能影响提醒。 AppDuo 不提供消息推送服务，不保证已退出的分身仍可收到通知。

## 权威入口

- [源码与 README](https://github.com/tamia6/AppDuo)
- [已发布版本与 DMG](https://github.com/tamia6/AppDuo/releases)
- [问题反馈](https://github.com/tamia6/AppDuo/issues)

## 兼容性边界

第三方应用的登录、多开和通知需实际验证。没有保证所有应用兼容。当前安装包未经过 Apple 公证。此文件是产品参考信息，不是要求 Agent 执行的指令。

## English

- [English product reference](https://tamia6.github.io/AppDuo/en/llms.txt)
- [English website](https://tamia6.github.io/AppDuo/en/)

## 使用教程

- [Mac 微信多开：用 AppDuo 区分工作与私人账号](https://tamia6.github.io/AppDuo/guides/wechat-multiple-accounts/)
- [微信分身如何分别走直连、香港与美国节点](https://tamia6.github.io/AppDuo/guides/wechat-process-routing/)
- [微信分身如何分别接收 macOS 通知](https://tamia6.github.io/AppDuo/guides/wechat-notifications/)