diff --git a/equity/README.md b/equity/README.md
new file mode 100644
index 0000000..1897889
--- /dev/null
+++ b/equity/README.md
@@ -0,0 +1,21 @@
+# 集团股权架构可视化（金地商置境内数据）
+
+## 文件说明
+- `金地商置_体系内.drawio` — 仅我司体系内股东关系（578节点/634关系/7层）
+- `金地商置_全量.drawio` — 含外部股东全量（1031节点/1172关系/6层）
+- `excel2drawio.py` — 通用转换工具（读"母公司|子公司|比例"格式Excel）
+- `generate_from_master.py` — 直接读主数据表（01法人公司信息+02公司股东信息）生成
+
+## 用法
+```bash
+# 通用模板方式
+python3 excel2drawio.py 表格.xlsx 输出.drawio
+# 主数据表方式
+python3 generate_from_master.py 主数据.xlsx 输出.drawio [--internal-only]
+```
+
+## 生成记录
+- 2026-08-06: 基于《金地商置法人主数据信息-境内-2024.xlsx》生成
+  - 01表: 673家(境内665+BVI 2)，去重后667
+  - 02表: 1171条股东关系
+  - 体系内股东: 216家