CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)

Add complete French (fr) and Chinese (zh) translations for all documentation:

- Root files: README, CHANGELOG, SECURITY, BETA-RELEASE
- docs/: All 16 core documentation files
- DOCS/: All 19 deep-dive documents including embedded/ and archive/
- package/secubox/: All 123+ package READMEs
- Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/

Total: 346 translation files created

Each file includes language switcher links for easy navigation between
English, French, and Chinese versions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-03-20 10:00:18 +01:00

6.4 KiB

Raw Blame History

Metabolizer 博客管道

Languages: English | Francais | 中文

为 SecuBox OpenWrt 集成 Gitea、Streamlit 和 HexoJS 的完整 CMS 管道。

┌─────────────────────────────────────────────────────────────────────────┐
│                      METABOLIZER 管道                                    │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐               │
│  │   GITEA      │───►│  STREAMLIT   │───►│   HEXOJS     │───► PORTAL   │
│  │   存储       │    │   CMS 应用   │    │   生成器     │    (静态)    │
│  └──────────────┘    └──────────────┘    └──────────────┘               │
│        │                    │                    │                       │
│   从 GitHub              编辑文章           clean →                      │
│   URL 克隆              + 媒体           generate →                      │
│                                            publish                       │
└─────────────────────────────────────────────────────────────────────────┘

功能特性

Gitea 集成 - 镜像 GitHub 仓库，本地存储博客内容
Streamlit CMS - 带实时预览的 Web markdown 编辑器
HexoJS 生成器 - 带赛博朋克主题的静态站点生成
Webhook 自动化 - git push 时自动重建
Portal 访问 - 静态博客服务于 /blog/

安装

opkg install secubox-app-metabolizer
metabolizerctl install

依赖

secubox-app-gitea - Git 仓库服务器
secubox-app-streamlit - Streamlit 应用服务器
secubox-app-hexojs - 静态站点生成器
rsync - 文件同步
git - 版本控制

快速开始

1. 安装管道

metabolizerctl install

这将：

在 Gitea 中创建 blog-content 仓库
将 CMS 应用部署到 Streamlit
配置自动重建的 webhooks

2. 从 GitHub 镜像（可选）

metabolizerctl mirror https://github.com/user/my-blog.git

3. 访问 CMS

在浏览器中打开 http://<路由器IP>:8501。

4. 查看您的博客

导航到 http://<路由器IP>/blog/

命令

命令	描述
`metabolizerctl install`	设置仓库、webhooks，部署 CMS
`metabolizerctl uninstall`	移除 metabolizer 设置
`metabolizerctl status`	显示管道状态（JSON）
`metabolizerctl mirror <url>`	将 GitHub 仓库克隆到 Gitea
`metabolizerctl sync`	从所有仓库拉取最新内容
`metabolizerctl build`	运行 Hexo clean → generate → publish
`metabolizerctl publish`	将静态站点复制到 portal
`metabolizerctl cms deploy`	将 CMS 应用部署到 Streamlit
`metabolizerctl cms update`	拉取并重启 CMS

CMS 页面

编辑器（`/pages/1_editor.py`）

双栏 markdown 编辑器，具有：

实时预览
YAML front matter 编辑器（标题、日期、分类、标签）
保存为草稿或直接发布
从 UI 触发 Hexo 构建

文章（`/pages/2_posts.py`）

管理您的内容：

查看已发布的文章和草稿
编辑、删除、发布/取消发布
从 Git 同步
重建博客

媒体（`/pages/3_media.py`）

媒体库：

拖放图片上传
带缩略图的画廊视图
复制 markdown 代码以嵌入
自动同步到博客

设置（`/pages/4_settings.py`）

管道控制：

服务状态（Gitea、Streamlit、HexoJS）
Git 操作（pull、status、mirror）
构建管道（clean、generate、publish）
Portal 配置

配置

UCI 配置位于 /etc/config/metabolizer：

config metabolizer 'main'
    option enabled '1'
    option gitea_url 'http://127.0.0.1:3000'
    option webhook_port '8088'

config content 'content'
    option repo_name 'blog-content'
    option repo_path '/srv/metabolizer/content'

config hexo 'hexo'
    option source_path '/srv/hexojs/site/source/_posts'
    option public_path '/srv/hexojs/site/public'
    option portal_path '/www/blog'
    option auto_publish '1'

config portal 'portal'
    option enabled '1'
    option url_path '/blog'

数据流

1. 作者在 Streamlit CMS 中写文章
         │
         ▼
2. CMS commit + push 到 Gitea
         │
         ▼
3. Gitea webhook 触发 metabolizer-webhook
         │
         ▼
4. Webhook 运行：sync → build → publish
         │
         ├─► git pull 内容仓库
         ├─► rsync 文章到 Hexo source
         ├─► hexoctl clean
         ├─► hexoctl generate
         └─► rsync public/ 到 /www/blog/
                  │
                  ▼
5. 博客可在 http://路由器/blog/ 访问

目录结构

/srv/metabolizer/
├── content/              # 博客内容 git 仓库
│   ├── _posts/          # 已发布的 markdown 文件
│   ├── _drafts/         # 草稿
│   └── images/          # 媒体文件

/srv/hexojs/site/
├── source/_posts/       # Hexo source（从 content 同步）
└── public/              # 生成的静态站点

/www/blog/               # Portal 静态文件（已发布）

Webhook 集成

Webhook 监听器运行在端口 8088（可配置），处理：

内容仓库 push → Sync + Build + Publish
CMS 仓库 push → 更新 Streamlit 应用

Webhook URL：http://<路由器IP>:8088/webhook

故障排除

检查服务状态

metabolizerctl status

查看日志

logread | grep metabolizer

手动重建

metabolizerctl sync
metabolizerctl build

重置管道

metabolizerctl uninstall
metabolizerctl install

许可证

MIT License - CyberMind Studio

6.4 KiB Raw Blame History Unescape Escape