diff --git a/docs/decompile-progress.md b/docs/decompile-progress.md
new file mode 100644
index 0000000..bd59a30
--- /dev/null
+++ b/docs/decompile-progress.md
@@ -0,0 +1,27 @@
+# 反编译进度
+
+新仓库: https://gitee.com/shuiyu1123/codemao-heart-source (私有)
+
+## 已还原的核心模块
+
+| 模块 | 文件 | 状态 |
+|------|------|------|
+| RegistryImpl | `src/heart/Registry.js` | ✅ 完成 |
+| BlockPredicatesImpl | `src/heart/BlockPredicates.js` | ✅ 完成 |
+| CompilerImpl | `src/heart/Compiler.js` | ✅ 完成 |
+| InterpreterImpl | `src/heart/Interpreter.js` | ✅ 完成 (完整) |
+| RuntimeManagerImpl | `src/heart/RuntimeManager.js` | ✅ 完成 |
+
+## 完整文档
+
+- `docs/player-source-analysis.md` - 1.8MB bundle 完整架构分析
+- `docs/module-map.md` - webpack 模块映射表
+- `docs/domain-functions.md` - 80+ 积木实现清单
+- `TASKS.md` - 反编译任务清单
+
+## 下一步
+
+1. 还原 RuntimeDataImpl, BlockPoolImpl, EventBus
+2. 还原 Domain Functions (积木实际实现)
+3. 还原渲染层 (PIXI.js 集成)
+4. JIT 编译器与还原的 Interpreter 对接