初始化

README.md

@@ -0,0 +1,55 @@
+# Python-MVVM
+
+这是一个用 Python 实现的极简 MVVM 示例项目。它通过“发布-订阅”模式实现
+Model 与 View 的数据绑定，并用 PyQt5 做了一个日志窗口 demo。
+
+## 项目结构
+
+```text
+Python-MVVM-master/
+├── framework.py                 # 可单独复制使用的 MVVM 小框架
+├── demo/
+│   ├── start_up.py              # demo 程序入口
+│   ├── design/
+│   │   ├── main_win.ui          # Qt Designer 原始界面文件
+│   │   └── main_win.py          # 由 .ui 生成的 Python 界面代码
+│   └── mvvm/
+│       ├── framework.py         # demo 内使用的框架代码
+│       ├── model.py             # Model 层
+│       ├── view.py              # View 层
+│       ├── view_model.py        # ViewModel 层
+│       └── binder.py            # 绑定 View 与 ViewModel
+└── docs/
+    └── MVVM学习教程.md          # 详细学习文档/课件
+```
+
+## 运行 demo
+
+进入 `demo` 目录运行：
+
+```bash
+python start_up.py
+```
+
+如果提示缺少 PyQt5，需要先安装：
+
+```bash
+pip install PyQt5
+```
+
+## 核心思想
+
+MVVM 的目标是让 View 不直接处理业务逻辑，让 ViewModel 不直接操作界面控件。
+本项目中，一次按钮点击的大致流程是：
+
+```text
+用户点击按钮
+-> PyQt clicked 信号
+-> ViewModel.event_log_yes/event_log_no
+-> 修改 StringModel.value
+-> Model 发布 log_to_view 事件
+-> EventChannel 分发事件
+-> LogView.signal_proxy 刷新 QTextBrowser
+```
+
+详细讲解见 [docs/MVVM学习教程.md](docs/MVVM学习教程.md)。