diff --git a/DEPLOY.md b/DEPLOY.md
deleted file mode 100644
index a5f45945..00000000
--- a/DEPLOY.md
+++ /dev/null
@@ -1,115 +0,0 @@
-# 部署说明
-
-## 镜像地址
-
-```
-ghcr.io/zhengchentao/ezbookkeeping:latest
-```
-
-每次向 `myrequirement` 分支推送代码，GitHub Actions 自动构建并推送新镜像。
-
----
-
-## 首次迁移（从官方镜像换成自定义镜像）
-
-### 1. 备份容器内配置文件到宿主机
-
-```bash
-sudo docker cp ezbookkeeping:/ezbookkeeping/conf/ezbookkeeping.ini /opt/ezbookkeeping/ezbookkeeping.ini
-```
-
-> 这样之后删容器也不会丢配置。
-
-### 2. 停止并删除旧容器
-
-```bash
-docker stop ezbookkeeping && docker rm ezbookkeeping
-```
-
-> 只删容器本身，数据目录不受影响。
-
-### 3. 登录 GitHub Container Registry（只需一次）
-
-在 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) 生成 token，勾选 `read:packages`，然后：
-
-```bash
-echo 你的TOKEN | docker login ghcr.io -u zhengchentao --password-stdin
-```
-
-### 4. 拉取新镜像
-
-```bash
-docker pull ghcr.io/zhengchentao/ezbookkeeping:latest
-```
-
-### 5. 启动容器
-
-```bash
-docker run -d \
-  --name ezbookkeeping \
-  --restart unless-stopped \
-  -p 8080:8080 \
-  -v /opt/ezbookkeeping/data:/ezbookkeeping/data \
-  -v /opt/ezbookkeeping/ezbookkeeping.ini:/ezbookkeeping/conf/ezbookkeeping.ini \
-  -e EBK_MCP_ENABLE_MCP=true \
-  -e EBK_SECURITY_ENABLE_API_TOKEN=true \
-  ghcr.io/zhengchentao/ezbookkeeping:latest
-```
-
-**参数说明：**
-| 参数 | 含义 |
-|------|------|
-| `-d` | 后台运行 |
-| `--restart unless-stopped` | 服务器重启后自动启动 |
-| `-p 8080:8080` | 端口映射 |
-| `-v .../data:...` | 挂载数据目录（数据库、图片等） |
-| `-v .../ezbookkeeping.ini:...` | 挂载配置文件 |
-| `-e EBK_*` | 环境变量覆盖配置 |
-
-### 6. 确认运行正常
-
-```bash
-docker ps                        # 确认容器在运行
-docker logs ezbookkeeping        # 查看启动日志，确认无报错
-```
-
----
-
-## 后续更新（代码有改动时）
-
-```bash
-# 拉取最新镜像
-docker pull ghcr.io/zhengchentao/ezbookkeeping:latest
-
-# 停止并删除旧容器
-docker stop ezbookkeeping && docker rm ezbookkeeping
-
-# 重新启动（与首次启动命令相同）
-docker run -d \
-  --name ezbookkeeping \
-  --restart unless-stopped \
-  -p 8080:8080 \
-  -v /opt/ezbookkeeping/data:/ezbookkeeping/data \
-  -v /opt/ezbookkeeping/ezbookkeeping.ini:/ezbookkeeping/conf/ezbookkeeping.ini \
-  -e EBK_MCP_ENABLE_MCP=true \
-  -e EBK_SECURITY_ENABLE_API_TOKEN=true \
-  ghcr.io/zhengchentao/ezbookkeeping:latest
-```
-
----
-
-## 常用运维命令
-
-```bash
-# 查看运行中的容器
-docker ps
-
-# 查看容器实时日志（Ctrl+C 退出）
-docker logs -f ezbookkeeping
-
-# 进入容器内部排查问题
-docker exec -it ezbookkeeping sh
-
-# 查看磁盘占用
-docker system df
-```
diff --git a/MY_REQUIREMENTS.md b/FORK.md
similarity index 95%
rename from MY_REQUIREMENTS.md
rename to FORK.md
index 1ecfc6c9..544ef5f5 100644
--- a/MY_REQUIREMENTS.md
+++ b/FORK.md
@@ -1,6 +1,11 @@
-# ezBookkeeping 个人需求清单
+# ezBookkeeping 个人 fork 改动清单
 
-> 基于 fork 版本的定制开发需求，持续更新。
+> 本文件记录这个 fork 相对上游 [mayswind/ezbookkeeping](https://github.com/mayswind/ezbookkeeping) 的所有定制改动 + 进度状态。
+
+> 关联文档：
+> - [`CLAUDE.md`](CLAUDE.md) —— 仓库分支模型 / 上游同步流程 / CI 排查路径（meta 层）
+> - 部署：见自家 NAS infra repo `git.zhengchentao.win/dev/nas-infra` 的 README（compose-level）
+>
 > 标注：❌ 难/暂缓 | ❓ 待定 | 🔍 调查中 | 🟢 已完成
 
 ---
diff --git a/README.md b/README.md
index d366b2cc..5fb38fb2 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,9 @@
 # ezBookkeeping
+
+> **Personal fork notice**: This is a personal fork of [mayswind/ezbookkeeping](https://github.com/mayswind/ezbookkeeping). For the list of custom changes see [`FORK.md`](FORK.md); for branch model / upstream-sync flow / CI troubleshooting see [`CLAUDE.md`](CLAUDE.md). Upstream README content follows below.
+
+---
+
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/mayswind/ezbookkeeping/blob/master/LICENSE)
 [![Go Report](https://goreportcard.com/badge/github.com/mayswind/ezbookkeeping)](https://goreportcard.com/report/github.com/mayswind/ezbookkeeping)
 [![Latest Release](https://img.shields.io/github/release/mayswind/ezbookkeeping.svg?style=flat)](https://github.com/mayswind/ezbookkeeping/releases)