Files
markbase/docs/APP_ID_CREATION_GUIDE.md
Warren 1300a4e223
Some checks failed
Test / test (push) Has been cancelled
Test / build (push) Has been cancelled
MarkBase架构升级:Multi-Volume Virtual Tree + Dual-View Management + Git Remote修正
核心功能:
-  Categories/Series双视图管理(category_view.rs + import_markdown.rs)
-  FUSE Multi-Volume支持(tree_type参数)
-  SSH/SFTP/SCP/rsync协议完整实现(4042行)
-  NFS/SMB Module Phase 1-3完成
-  Archive Module Phase 1-4完成(2916行)
-  Download Center API完整实现
-  S3兼容API实现(560行)

Git配置修正:
-  删除错误origin(gitea.momentry.ddns.net)
-  删除m5max128(指向机器名)
-  设置origin = m5max128gitea.momentry.ddns.net/admin/markbase
-  设置m4minigitea = m4minigitea.momentry.ddns.net/warren/markbase

数据清理:
-  删除38个临时SQLite(保留accusys.sqlite、demo.sqlite)
-  删除.bak、test_*.bin、调试脚本等临时文件
-  删除临时目录(build/、download files/、raid_test/等)
-  更新.gitignore排除临时文件

架构优化:
- 52个文件修改,2434行新增,4739行删除
- Workspace成员整合(16个crate)
- 数据库状态:accusys.sqlite保留(主demo测试)

远程同步:
-  准备推送到m5max128gitea(远程Gitea)
-  准备推送到m4minigitea(本地Gitea)
2026-06-12 12:59:54 +08:00

143 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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