55db79cb8d
实现内容： ✅ archive模块完整架构（10个文件，约900行） ✅ ArchiveProcessor trait统一接口 ✅ ProcessorRegistry插件式架构 ✅ FormatDetector格式自动检测 ✅ ArchiveConfig配置管理系统 ✅ Warning警告系统（RAR/XZ/7z争议格式） ✅ Zip Slip/Zip Bomb安全防护 ✅ 核心格式stub（ZIP/TAR/GZIP等9种） ✅ 可选格式stub（RAR/XZ/7z等3种） ✅ 测试框架基础 支持的格式： 核心格式（默认启用）：ZIP, TAR, GZIP, ZSTD, BZIP2, LZ4, TAR.GZ, TAR.BZ2, TAR.ZST（9种） 可选格式（默认禁用）：RAR（法律风险）, XZ（外部依赖）, 7z（库不稳定）（3种） 总计：12种压缩格式 安全特性： - Zip Slip防护（路径遍历攻击） - Zip Bomb防护（解压比率限制） - 文件大小限制 - 法律风险警告（RAR专利） 下一步：Phase 2 - 核心格式完整实现（ZIP/TAR/GZIP处理器）
MarkBase
Momentry Display Engine - Markdown渲染與檔案樹管理系統
功能特色
- Markdown渲染（支援表格、footnote、tasklist） -檔案樹管理（SQLite持久化）
- REST API（18+路由）
- macOS音訊控制（音訊裝置切換、音量控制） -多種顯示模式（tree, list, grid_sm, grid_lg）
##安裝
###必要條件
- Rust 1.92+
- macOS（音訊功能需 macOS）
- SwitchAudioSource（音訊裝置切換）
#安裝 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
#安裝 SwitchAudioSource（macOS）
brew install switchaudio-source
###建構
cargo build
##使用
###啟動伺服器
cargo run -- display #預設 port 11438
cargo run -- display -p8080 #自訂 port
cargo run -- display README.md #顯示指定檔案
###渲染 Markdown
cargo run -- render README.md #輸出到 stdout
cargo run -- render README.md -o output.html
##測試
cargo test #執行所有測試
cargo test test_insert #執行特定測試
File Tree功能
REST API
| 路由 | 方法 | 功能 |
|---|---|---|
/api/v2/tree/:user_id |
GET | 取得檔案樹 |
/api/v2/tree/:user_id/node |
POST | 建立節點 |
/api/v2/tree/:user_id/node/:node_id |
PUT/DELETE | 更新/刪除節點 |
/api/v2/tree/:user_id/node/:node_id/move |
PUT | 移動節點 |
/api/v2/tree/:user_id/node/:node_id/alias |
PATCH | 更新別名 |
###顯示模式
tree- 樹狀顯示list- 列表顯示grid_sm- 小格狀顯示grid_lg- 大格狀顯示
###範例
curl http://localhost:11438/api/v2/tree/demo?mode=tree
curl http://localhost:11438/api/v2/tree/demo?mode=list
Demo資料
data/users/demo.sqlite- 50節點範例資料data/cache/-範例檔案
##開發
見 AGENTS.md詳細開發指南。
CI/CD
使用 Gitea Actions：https://gitea.momentry.ddns.net
License
MIT