initial commit

client/README.md

@@ -0,0 +1,24 @@
+# Client（Qt 桌面端）
+
+## 目录结构（按模块）
+
+**`core/`**（静态库 `core`，include 根为 `client/core`）
+
+- `domain/` — 领域模型：`Project`、`Entity` 等
+- `persistence/` — `PersistentBinaryObject`（统一二进制头与原子写）、`EntityPayloadBinary`（`.hfe` / 旧 `.anim`）
+- `workspace/` — 项目目录、索引 JSON、撤销栈：`ProjectWorkspace`
+- `depth/` — 假深度图生成：`DepthService`
+- `animation/` — 关键帧采样（Hold / 线性插值）：`AnimationSampling`
+
+**`gui/`**（可执行程序 `landscape_tool`，额外 include 根为 `client/gui`）
+
+- `app/` — 入口 `main.cpp`
+- `main_window/` — 主窗口与时间轴等：`MainWindow`
+- `editor/` — 编辑画布：`EditorCanvas`
+- `dialogs/` — `AboutWindow`、`ImageCropDialog`
+
+引用方式示例：`#include "core/workspace/ProjectWorkspace.h"`（以 `client/` 为根）、`#include "editor/EditorCanvas.h"`（以 `client/gui/` 为根）。
+
+## 界面语言
+
+界面文案为中文（无运行时语言切换）。