diff --git a/README.main.md b/README.main.md
deleted file mode 100644
index 134fbda..0000000
--- a/README.main.md
+++ /dev/null
@@ -1,61 +0,0 @@
-# mcu-codegen-template
-
-见宝科技 **MCU 代码生成模板仓库**。见宝工具箱生成/分发 MCU 工程时，从此仓库按分支拉取对应芯片模板。
-
-**远程地址：** https://git.jianbao-tech.com/pets-device/mcu-codegen-template.git
-
----
-
-## 分支说明
-
-本仓库 **`main` 分支仅作索引**，不含具体芯片工程。
-
-每个 MCU 模板对应一个独立分支，命名规则：**`厂商-型号`**（默认含 OTA）。
-
-| 分支 | 说明 |
-|------|------|
-| **`main`** | 本页：分支索引与使用说明 |
-| **`Puya-PY32F040`** | 普冉 PY32F040 · OTA 双工程框架（Bootloader + App + jb_protocol） |
-
-完整分支表见 [`docs/branch-index.md`](docs/branch-index.md)。
-
----
-
-## 快速使用
-
-```bash
-# 克隆并切换到 PY32F040 模板
-git clone https://git.jianbao-tech.com/pets-device/mcu-codegen-template.git
-cd mcu-codegen-template
-git checkout Puya-PY32F040
-```
-
-切换后阅读该分支根目录 **`README.md`** 了解构建、OTA 配置与打包方式。
-
----
-
-## 仓库结构（MCU 分支通用）
-
-```
-<MCU分支>/
-├── App/           APP Keil 工程
-├── Bootloader/    Bootloader Keil 工程
-├── Shared/        OTA 契约（ota_config.h 等，单一真源）
-├── Drivers/       厂商 HAL/CMSIS
-├── tools/         构建与打包脚本
-└── Doc/           设计文档
-```
-
----
-
-## 维护者
-
-- 新增 MCU：新建 `厂商-型号` 分支，更新 `docs/branch-index.md` 与本 README 表格
-- 模板发版：在对应 MCU 分支打 tag，如 `Puya-PY32F040/v1.0.0`
-
----
-
-## 相关链接
-
-- [分支索引详情](docs/branch-index.md)
-- [Gitea 仓库](https://git.jianbao-tech.com/pets-device/mcu-codegen-template)
diff --git a/docs/branch-index.md b/docs/branch-index.md
deleted file mode 100644
index f7460a6..0000000
--- a/docs/branch-index.md
+++ /dev/null
@@ -1,63 +0,0 @@
-# MCU 代码生成模板 — 分支索引
-
-本仓库按 **「厂商-型号」** 组织分支，每个分支是一套完整的 MCU 工程模板（默认含 OTA + Bootloader）。
-
-远程仓库：[mcu-codegen-template](https://git.jianbao-tech.com/pets-device/mcu-codegen-template)
-
----
-
-## 分支列表
-
-| 分支 | 厂商 | 型号 | Flash | 默认能力 | 状态 |
-|------|------|------|-------|----------|------|
-| [`Puya-PY32F040`](https://git.jianbao-tech.com/pets-device/mcu-codegen-template/src/branch/Puya-PY32F040) | 普冉 Puya | PY32F040 | 128KB | OTA 三模式 + Bootloader + jb_protocol | ✅ 可用 |
-
-> 新模板上线后在此表追加一行即可。
-
----
-
-## 如何获取某 MCU 模板
-
-### 见宝工具箱 / 自动化脚本
-
-```bash
-git clone https://git.jianbao-tech.com/pets-device/mcu-codegen-template.git
-cd mcu-codegen-template
-git checkout Puya-PY32F040
-```
-
-### 仅下载指定分支（浅克隆）
-
-```bash
-git clone --branch Puya-PY32F040 --single-branch \
-  https://git.jianbao-tech.com/pets-device/mcu-codegen-template.git py32f040-template
-```
-
----
-
-## 分支命名规范
-
-```
-<厂商>-<型号>
-```
-
-示例：`Puya-PY32F040`、`ST-STM32F103C8`
-
-- 默认包含 OTA，分支名**不加** `-ota` 后缀
-- 同一芯片多种工程结构（如裸机 vs OTA）差异过大时，再考虑加后缀：`Puya-PY32F040-bare`
-
----
-
-## 新增 MCU 模板（维护者）
-
-1. 从 `main` 拉新分支：`git checkout -b <厂商>-<型号> main`
-2. 合入该 MCU 完整工程（App + Bootloader + Shared + Drivers + tools）
-3. 更新本文件分支表 + `main/README.md` 快速索引
-4. 推送分支并在 Gitea 设为受保护分支（可选）
-
----
-
-## 各分支 README
-
-每个 MCU 分支根目录有独立的 `README.md`（构建、打包、OTA 配置说明）。
-设计细节见各分支 `Doc/` 目录。