Files
markbase/docs/SYSTEM_EXTENSION_COMPLETE_FLOW.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

4.0 KiB
Raw Blame History

System Extension 注册完整流程

已完成步骤

步骤1App ID创建

关键信息:

  • Apple ID: 6770506571
  • Bundle ID: com.momentry.markbase.fskit
  • Team ID: K3TDMD9Y6B
  • Platform: iOS, iPadOS, macOS, tvOS, watchOS, visionOS

Portal操作

  • 已创建App ID
  • 需填写DescriptionMarkBaseFS
  • 点击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导入证书

运行脚本:

./scripts/install_system_extension_final.sh

或手动执行:

security import ~/Downloads/developer_certificate.cer \
  -k ~/Library/Keychains/login.keychain-db \
  -T /usr/bin/codesign

验证导入:

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

codesign --sign "Apple Development" \
  --entitlements entitlements.plist \
  --identifier com.momentry.markbase.fskit \
  target/release/fskit_mount

步骤5安装System Extension

使用系统命令:

systemextensionsctl install \
  --team K3TDMD9Y6B \
  --bundleID com.momentry.markbase.fskit \
  --type filesystem \
  build/Release/MarkBaseFSKit.app

或运行脚本:

./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完成安装

验证安装:

systemextensionsctl list
# 输出应显示1 extension(s)
# MarkBaseFSKit (com.momentry.markbase.fskit) [active]

关键配置文件

entitlements.plist

<?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