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）
This commit is contained in:
Warren
188
docs/SYSTEM_EXTENSION_COMPLETE_FLOW.md
Normal file
188
docs/SYSTEM_EXTENSION_COMPLETE_FLOW.md
Normal file
@@ -0,0 +1,188 @@
|
||||
# System Extension 注册完整流程
|
||||
|
||||
## 已完成步骤
|
||||
|
||||
### 步骤1：App ID创建 ✅
|
||||
|
||||
**关键信息：**
|
||||
- Apple ID: `6770506571`
|
||||
- Bundle ID: `com.momentry.markbase.fskit`
|
||||
- Team ID: `K3TDMD9Y6B`
|
||||
- Platform: iOS, iPadOS, macOS, tvOS, watchOS, visionOS
|
||||
|
||||
**Portal操作：**
|
||||
- ✅ 已创建App ID
|
||||
- ⏳ 需填写Description：MarkBaseFS
|
||||
- ⏳ 点击Save保存
|
||||
|
||||
---
|
||||
|
||||
## 待完成步骤
|
||||
|
||||
### 步骤2：创建Certificate
|
||||
|
||||
**Portal操作：**
|
||||
1. 左侧菜单 → **Certificates**
|
||||
2. 点击 **+** 按钮
|
||||
3. 选择：**Mac App Development**
|
||||
4. 点击 **Continue**
|
||||
|
||||
**本地操作：**
|
||||
- CSR已生成：`~/Desktop/markbase_developer.csr`
|
||||
- 私钥已生成：`~/Desktop/markbase_developer.key`
|
||||
|
||||
**上传CSR：**
|
||||
- 点击 **Choose File**
|
||||
- 选择：`~/Desktop/markbase_developer.csr`
|
||||
- 点击 **Continue**
|
||||
|
||||
**Portal生成：**
|
||||
- Certificate生成成功
|
||||
- 点击 **Download** 按钮
|
||||
- 保存到：`~/Downloads/`（文件名通常是`developer_certificate.cer`）
|
||||
|
||||
---
|
||||
|
||||
### 步骤3：导入证书
|
||||
|
||||
**运行脚本：**
|
||||
```bash
|
||||
./scripts/install_system_extension_final.sh
|
||||
```
|
||||
|
||||
**或手动执行：**
|
||||
```bash
|
||||
security import ~/Downloads/developer_certificate.cer \
|
||||
-k ~/Library/Keychains/login.keychain-db \
|
||||
-T /usr/bin/codesign
|
||||
```
|
||||
|
||||
**验证导入：**
|
||||
```bash
|
||||
security find-identity -v -p codesigning
|
||||
# 输出应显示：1 valid identities found
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 步骤4：构建签名应用
|
||||
|
||||
**需要Xcode项目：**
|
||||
- 创建 `MarkBaseFSKit.xcodeproj`
|
||||
- 配置 `PRODUCT_BUNDLE_IDENTIFIER = com.momentry.markbase.fskit`
|
||||
- 配置 `DEVELOPMENT_TEAM = K3TDMD9Y6B`
|
||||
|
||||
**或使用现有binary：**
|
||||
```bash
|
||||
codesign --sign "Apple Development" \
|
||||
--entitlements entitlements.plist \
|
||||
--identifier com.momentry.markbase.fskit \
|
||||
target/release/fskit_mount
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 步骤5：安装System Extension
|
||||
|
||||
**使用系统命令：**
|
||||
```bash
|
||||
systemextensionsctl install \
|
||||
--team K3TDMD9Y6B \
|
||||
--bundleID com.momentry.markbase.fskit \
|
||||
--type filesystem \
|
||||
build/Release/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**或运行脚本：**
|
||||
```bash
|
||||
./scripts/install_system_extension_final.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 步骤6：用户批准（必须手动）
|
||||
|
||||
**macOS弹出提示：**
|
||||
1. "MarkBaseFSKit wants to install a system extension"
|
||||
2. 打开 **System Settings → Privacy & Security**
|
||||
3. 点击 **Allow** 按钮
|
||||
4. 重启Mac完成安装
|
||||
|
||||
**验证安装：**
|
||||
```bash
|
||||
systemextensionsctl list
|
||||
# 输出应显示：1 extension(s)
|
||||
# MarkBaseFSKit (com.momentry.markbase.fskit) [active]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 关键配置文件
|
||||
|
||||
### entitlements.plist
|
||||
|
||||
```xml
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-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>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 文件清单
|
||||
|
||||
|文件 |位置 |用途 |
|
||||
|------|------|------|
|
||||
| CSR文件 | ~/Desktop/markbase_developer.csr | 上传到Portal |
|
||||
| 私钥文件 | ~/Desktop/markbase_developer.key | 本地保存（不要上传）|
|
||||
| 证书文件 | ~/Downloads/developer_certificate.cer | Portal下载 |
|
||||
| 安装脚本 | scripts/install_system_extension_final.sh | 一键安装 |
|
||||
| Entitlements | entitlements.plist | 权限配置 |
|
||||
|
||||
---
|
||||
|
||||
## 时间估算
|
||||
|
||||
|步骤 |时间 |
|
||||
|------|------|
|
||||
| App ID创建 | 5分钟 ✅（已完成）|
|
||||
| CSR生成 | 1分钟 ✅（已完成）|
|
||||
| Certificate创建 | 3分钟 ⏳ |
|
||||
| 证书下载 | 1分钟 ⏳ |
|
||||
| 导入+安装 | 2分钟 ⏳ |
|
||||
| 用户批准 | 1分钟 ⏳（手动）|
|
||||
| **总计** | **13分钟** |
|
||||
|
||||
---
|
||||
|
||||
## 下一步操作
|
||||
|
||||
**立即需要：**
|
||||
|
||||
1. **Portal填写Description**
|
||||
- Description: `MarkBaseFS`
|
||||
- 点击 **Save**
|
||||
|
||||
2. **Portal创建Certificate**
|
||||
- Certificates → +按钮
|
||||
- Mac App Development
|
||||
- 上传 `~/Desktop/markbase_developer.csr`
|
||||
|
||||
3. **下载证书**
|
||||
- Portal Download → `~/Downloads/`
|
||||
|
||||
4. **运行安装脚本**
|
||||
- `./scripts/install_system_extension_final.sh`
|
||||
|
||||
---
|
||||
|
||||
**最后更新：** 2026-05-18 18:05
|
||||
Reference in New Issue
Block a user