diff --git a/README.md b/README.md
index 1e9abfd..d3c42e9 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,12 @@ Reusable GitHub Actions for installing and running OpenCode in other repositorie
 
 This repository is licensed under Apache 2.0.
 
+## Migration Notice
+
+This project is no longer actively maintained. We have migrated to [sun-praise/pi-review-agent](https://github.com/sun-praise/pi-review-agent).
+
+The reason is [issue #278](https://github.com/sun-praise/opencode-actions/issues/278): opencode records `tokens_cache_read = 0` for litellm/deepseek, which distorts cost measurement and makes v2 session-resume savings unobservable. Fixing this requires changes in the upstream opencode codebase, which we cannot modify.
+
 ## TLDR
 
 Write this in your CI.yaml
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 57ed2f6..0a36420 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -6,6 +6,12 @@
 
 本仓库基于 Apache 2.0 许可证。
 
+## 迁移说明
+
+本项目已不再积极维护。我们已迁移到 [sun-praise/pi-review-agent](https://github.com/sun-praise/pi-review-agent)。
+
+原因是 [issue #278](https://github.com/sun-praise/opencode-actions/issues/278)：opencode 对 litellm/deepseek 记录 `tokens_cache_read = 0`，导致成本统计失真且无法观测 v2 会话恢复带来的节省。该问题需要在上游 opencode 代码中修复，而我们无法修改上游代码。
+
 ## 快速开始
 
 在你的 CI.yaml 中写入：