docs: restore user-facing READMEs and add maintainer guide

Restore README.md and README-zh.md to the back-main user installation format, and move release pipeline maintenance details into docs/maintainers.md for maintainers.

Author: HalfSweet

README-zh.md

@@ -2,50 +2,74 @@
 
 [English](README.md) | 中文
 
-用于从 SiliconSchema 构建产物自动生成 SiFli SoC/Module 的 KiCad symbols 与 footprints，并通过 GitHub Release 发布可直接在 KiCad PCM 中安装的 ZIP 包。
+SiFli SoC 和模组的官方 KiCAD 符号、封装和 3D 模型库。
 
-## 📦 安装方法（用户侧）
+## 📦 安装方法
 
-1. 从 [Releases](https://github.com/OpenSiFli/kicad-libraries/releases) 下载最新 `sifli-kicad-libraries-<tag>.zip`。
-2. 打开 KiCad → **工具** → **拓展内容管理器**。
-3. 选择 **从文件安装...** 并选中 ZIP。
+### 方法一：KiCAD 拓展内容管理器（暂不支持）
 
-> 用户安装入口保持为 Release ZIP + PCM Install from file。
+1. 打开 KiCAD
+![PCM-home](./docs/image-cn/PCM-home.png)
+2. 转到 **工具** → **拓展内容管理器**
+3. 搜索 "SiFli Library"
+4. 点击 **安装**
 
-## 🔧 开发环境
+### 方法二：手动安装
 
-- Python >= 3.13
-- `uv`
-- 已拉取 submodule：`SiliconSchema`、`kicad-footprint-generator`、`kicad-library-utils`
+1. 从 [Releases](https://github.com/OpenSiFli/kicad-libraries/releases) 下载最新版本
+2. 转到 **工具** → **拓展内容管理器**
+![PCM-home](./docs/image-cn/PCM-home.png)
+3. PCM 窗口将显示可用的插件、库和颜色主题列表。您可以浏览分类或使用搜索栏查找特定包。
+![PCM](./docs/image-cn/PCM.png)
+4. 要使用最新版本的 ZIP 文件手动安装库，您需要从"从文件安装..."中选择文件
+![PCM-install](./docs/image-cn/install-from-file.png)
+5. 安装包后，您将在"已安装"选项卡中看到 SiFli Library。
+![PCM-SiFli](./docs/image-cn/SiFli.png)
+6. 现在您可以使用该库了。请注意，该库将在符号和封装中列为 PCM_SiFli。
 
-## 🏗️ 本地生成
+## 🔧 支持的芯片
 
-```bash
-uv sync --frozen
-uv run --directory SiliconSchema build-schema
-uv run kicad-generator --output-dir build
-```
+| 型号 | 封装名称  | 符号 | 封装 | 3D 模型 |
+|-------------|-------------|--------|-----------|----------|
+| SF32LB52XUx | QFN68 | ✅ | ✅ | ✅ |
+| SF32LB52xUx | QFN68 | ✅ | ✅ | ✅ |
 
-关键顺序：**必须先构建 SiliconSchema，再运行生成器**。
+**图例：**
 
-## 🚀 自动发布（Tag 驱动）
+- ✅ 可用
+- ⚠️ 即将推出
+- ❌ 不可用
 
-推送 tag 后，`/.github/workflows/release.yml` 自动执行：
+## 📡 支持的模组
 
-1. checkout + recursive submodules
-2. 安装 `uv`
-3. `uv sync --frozen`
-4. `uv run --directory SiliconSchema build-schema`
-5. `uv run kicad-generator --output-dir build`
-6. 整理发布目录（`symbols/`、`footprints/`、`resources/`、`metadata.json`）
-7. `uv run scripts/build_release.py --source-dir release-staging --tag <tag>`
-8. 上传 ZIP 与 `metadata-upstream.json` 到 GitHub Release
+| 型号 | 符号 | 封装 | 3D 模型 |
+|-------------|--------|-----------|----------|
+| SF32LB52-MOD-1 |  ✅ | ✅ | ❌ |
+
+**图例：**
+
+- ✅ 可用
+- ⚠️ 即将推出
+- ❌ 不可用
+
+## 📚 文档资料
+
+- [SiFli 硬件设计指南](https://wiki.sifli.com/hardware/index.html)
+- [SiFli 官方网站](https://www.sifli.com/)
+- [维护者文档](docs/maintainers.md)
 
 ## 🤝 贡献
 
-推荐贡献入口：
+欢迎贡献！请随时提交 Pull Request。
+
+## 📄 许可证
+
+此库采用 [CC-BY-SA-4.0](LICENSE) 许可证。
+
+## 📞 技术支持
 
-- schema / module / template（`SiliconSchema`、`modules`、`templates`）
-- 生成器代码（`src/kicad_generator`）
+如需技术支持和咨询：
 
-发布产物以 CI 自动生成为主，不再依赖手工维护。
+- 访问 [SiFli Wiki](https://wiki.sifli.com/)
+- 在此仓库中创建 issue
+- 联系：[GitHub Issues](https://github.com/OpenSiFli/kicad-libraries/issues)

README.md

@@ -1,51 +1,75 @@
-# SiFli KiCAD Generator
+# SiFli KiCAD Libraries
 
 English | [中文](README-zh.md)
 
-用于从 SiliconSchema 构建产物自动生成 SiFli SoC/Module 的 KiCad symbols 与 footprints，并通过 GitHub Release 发布可直接在 KiCad PCM 中安装的 ZIP 包。
+Official KiCAD symbol, footprint and 3D model libraries for SiFli SoC and modules.
 
-## 安装与使用（用户侧）
+## 📦 Installation
 
-1. 从 [Releases](https://github.com/OpenSiFli/kicad-libraries/releases) 下载最新 `sifli-kicad-libraries-<tag>.zip`。
-2. 打开 KiCad → **Tools** → **Package and Content Manager**。
-3. 选择 **Install from file...** 并选中该 ZIP。
+### Method 1: KiCAD Package and Content Manager (Not yet supported)
 
-> 用户安装入口保持为 Release ZIP + PCM Install from file。
+1. Open KiCAD
+![PCM-home](./docs/image-en/PCM-home.png)
+2. Go to **Tools** → **Package and Content Manager**
+3. Search for "SiFli Library"
+4. Click **Install**
 
-## 开发依赖
+### Method 2: Manual Installation
 
-- Python >= 3.13
-- [uv](https://docs.astral.sh/uv/)
-- 已初始化 submodules（`SiliconSchema`、`kicad-footprint-generator`、`kicad-library-utils`）
+1. Download the latest release from [Releases](https://github.com/OpenSiFli/kicad-libraries/releases)
+2. Go to **Tools** → **Package and Content Manager**
+![PCM-home](./docs/image-en/PCM-home.png)
+3. The PCM window will display a list of available plugins, libraries, and color themes. You can browse through the categories or use the search bar to find a specific package.
+![PCM](./docs/image-en/PCM.png)
+4. To install the library manually using the ZIP file from the latest release, you need to select the file from "Install from file..."
+![PCM-install](./docs/image-en/install-from-file.png)
+5. Once the package is installed, you will see the SiFli Library listed on the Installed tab.
+![PCM-SiFli](./docs/image-en/SiFli.png)
+6. Now you are ready to use the library. Note that the library will be listed as PCM_SiFli in the Symbol and Footprint.
 
-## 本地生成流程
+## 🔧 Supported Chips
 
-```bash
-uv sync --frozen
-uv run --directory SiliconSchema build-schema
-uv run kicad-generator --output-dir build
-```
+| Part Number | Package Name  | Symbol | Footprint | 3D Model |
+|-------------|-------------|--------|-----------|----------|
+| SF32LB52XUx | QFN68 | ✅ | ✅ | ✅ |
+| SF32LB52xUx | QFN68 | ✅ | ✅ | ✅ |
 
-关键顺序：**先构建 SiliconSchema，再运行生成器**。
+**Legend:**
 
-## 自动发布流程（Tag 驱动）
+- ✅ Available
+- ⚠️ Coming Soon
+- ❌ Not Available
 
-`/.github/workflows/release.yml` 在 tag push 时自动执行：
+## 📡 Supported Modules
 
-1. `actions/checkout` + `submodules: recursive`
-2. 安装 `uv`
-3. `uv sync --frozen`
-4. `uv run --directory SiliconSchema build-schema`
-5. `uv run kicad-generator --output-dir build`
-6. 将生成结果整理为发布结构（`symbols/`、`footprints/`、`resources/`、`metadata.json`）
-7. `uv run scripts/build_release.py --source-dir release-staging --tag <tag>`
-8. 通过 `ncipollo/release-action` 上传 ZIP 和 `metadata-upstream.json`
+| Part Number | Symbol | Footprint | 3D Model |
+|-------------|--------|-----------|----------|
+| SF32LB52-MOD-1 |  ✅ | ✅ | ❌ |
 
-## 贡献方式
+**Legend:**
 
-推荐贡献入口：
+- ✅ Available
+- ⚠️ Coming Soon
+- ❌ Not Available
 
-- schema/module/template 变更（`SiliconSchema` / `modules` / `templates`）
-- 生成器逻辑变更（`src/kicad_generator`）
+## 📚 Documentation
 
-发布产物不再以手工维护为主，而是由 CI 自动生成并随 tag 发布。
+- [SiFli Hardware Design Guidelines](https://wiki.sifli.com/hardware/index.html)
+- [SiFli Official Website](https://www.sifli.com/)
+- [Maintainer Guide](docs/maintainers.md)
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+This library is licensed under [CC-BY-SA-4.0](LICENSE).
+
+## 📞 Support
+
+For technical support and questions:
+
+- Visit [SiFli Wiki](https://wiki.sifli.com/)
+- Create an issue in this repository
+- Contact: [GitHub Issues](https://github.com/OpenSiFli/kicad-libraries/issues)

docs/maintainers.md

@@ -0,0 +1,63 @@
+# Maintainer Guide
+
+本指南面向仓库维护者，说明生成与发布链路。用户安装方式请以 `README.md` / `README-zh.md` 为准。
+
+## Prerequisites
+
+- Python >= 3.13
+- [uv](https://docs.astral.sh/uv/)
+- submodules initialized (`SiliconSchema`, `kicad-footprint-generator`, `kicad-library-utils`)
+
+## Local Generation Workflow
+
+关键顺序：**先构建 SiliconSchema，再运行本仓库生成器**。
+
+```bash
+uv sync --frozen
+uv run --directory SiliconSchema build-schema
+uv run kicad-generator --output-dir build
+```
+
+## Release Packaging Workflow
+
+发布结构由 CI staging 目录整理而来，包含：
+
+- `symbols/MCU_SiFli.kicad_sym`
+- `footprints/*.pretty/*.kicad_mod`
+- `resources/*`
+- `metadata.json`
+
+打包脚本：
+
+```bash
+uv run scripts/build_release.py --source-dir release-staging --tag <tag>
+```
+
+输出包括：
+
+- `sifli-kicad-libraries-<tag>.zip`
+- `metadata-upstream.json`
+- `package_path.txt`
+- `metadata_path.txt`
+- `package_size.txt`
+- `install_size.txt`
+- `package_sha256.txt`
+
+## GitHub Actions Release Workflow
+
+`/.github/workflows/release.yml` 在 tag push 时执行，固定顺序：
+
+1. `actions/checkout@v4` with `submodules: recursive`
+2. `astral-sh/setup-uv@v6`
+3. `uv sync --frozen`
+4. `uv run --directory SiliconSchema build-schema`
+5. `uv run kicad-generator --output-dir build`
+6. staging 发布目录整理
+7. `uv run scripts/build_release.py --source-dir release-staging --tag <tag>`
+8. `ncipollo/release-action` 上传 ZIP 与 `metadata-upstream.json`
+
+## Notes
+
+- CI 与本地都必须使用 `uv` 运行命令，不使用裸 `python`。
+- 只要涉及 schema 变更，请优先验证 `SiliconSchema/out/<series>/series.yaml` 是否已刷新。
+- 发布产物应由 CI 生成并上传，不建议手工维护 release ZIP。