# App ID 创建指南

## 当前操作：Apple Developer Portal

**用户提供信息：**
- Description: AI Agent for Files Management
- Capabilities: FSKit Module

---

## App ID 创建步骤

### 1. Bundle ID 填写

**推荐命名：**
```
com.momentry.markbase.fskit
```

**命名规则：**
- 反向域名格式（com.company.product.module）
- 全局唯一
- 与Xcode项目PRODUCT_BUNDLE_IDENTIFIER一致

---

### 2. Capabilities（需要勾选）

**必须勾选：**
- ✅ **System Extension**（关键！）
  - Entitlement: `com.apple.developer.system-extension`

**可选勾选：**
- ✅ **App Groups**（如需共享数据）
- ✅ **Hardened Runtime**（安全要求）

---

### 3. Entitlements 配置

**FSKit需要的Entitlements：**
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTD PLIST 1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.system-extension</key>
    <true/>
    <key>com.apple.developer.system-extension.install</key>
    <true/>
    <key>com.apple.security.files.user-selected.read-write</key>
    <true/>
</dict>
</plist>
```

---

## 下一步操作

### 步骤2：创建Developer Certificate

**在Portal操作：**
1. 左侧菜单 → **Certificates**
2. 点击 **+** 按钮
3. 选择：**Mac App Development**
4. 上传CSR文件（Certificate Signing Request）

**创建CSR（本地操作）：**
```bash
# 生成CSR文件
openssl req -new -newkey rsa:2048 -nodes \
  -keyout ~/Desktop/markbase_developer.key \
  -out ~/Desktop/markbase_developer.csr \
  -subj "/emailAddress=warren@momentry.ddns.net/CN=MarkBase Development/O=Momentry/C=TW"

# 上传 markbase_developer.csr 到Portal
```

---

### 步骤3：下载证书

**Portal会生成：**
- `developer_certificate.cer`（下载到 ~/Downloads/）

**导入到Keychain：**
```bash
# 导入证书（我会提供脚本）
security import ~/Downloads/developer_certificate.cer \
  -k ~/Library/Keychains/login.keychain-db \
  -T /usr/bin/codesign
```

---

### 步骤4：创建Provisioning Profile

**Portal操作：**
1. 左侧菜单 → **Profiles**
2. 点击 **+** 按钮
3. 选择：**Mac App Development**
4. 选择App ID: `com.momentry.markbase.fskit`
5. 选择Certificate: 刚创建的证书
6. 选择Device: 当前Mac

**获取Mac UDID：**
```bash
# 运行此命令获取UDID
system_profiler SPHardwareDataType | awk '/Hardware UUID/ {print $3}'
```

---

## 当前填写建议

|字段 |建议填写 |
|------|------|
| **Description** | `AI Agent for Files Management`（已填写）|
| **Bundle ID** | `com.momentry.markbase.fskit` |
| **Capabilities** | System Extension ✅ |

---

## 完成后下一步

**App ID创建完成后：**
1. 告诉我创建成功状态
2. 我准备CSR生成脚本
3. 您上传CSR到Portal
4. Portal生成证书 → 您下载到 ~/Downloads/
5. 我提供一键安装脚本

---

**需要我立即提供：**
- CSR生成脚本？
- Team ID（需要从Portal获取）？

---

**最后更新：** 2026-05-18 17:35