From 1c0e8d74dffebad2d4758354a87bef79f325ee05 Mon Sep 17 00:00:00 2001
From: claude_dev <claude-dev@sanguo.local>
Date: Mon, 6 Jul 2026 13:08:37 +0800
Subject: [PATCH] =?UTF-8?q?docs(claude):=20=E8=AE=B0=E5=BD=95=20NAS=20?=
 =?UTF-8?q?=E9=83=A8=E7=BD=B2=E7=9B=AE=E5=BD=95=EF=BC=88=E5=AE=89=E8=A3=85?=
 =?UTF-8?q?/=E6=95=B0=E6=8D=AE=E8=B7=AF=E5=BE=84=20+=20rsync=20=E6=B5=81?=
 =?UTF-8?q?=E7=A8=8B=20+=20SSH/docker=20=E8=AE=BF=E9=97=AE=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .claude/CLAUDE.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index d91ce23..d03b98f 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -121,6 +121,38 @@ Linus 三问过滤
 - 完成标记：`@main-agent ✅ 阶段_DONE`
 - 偏差报告：`@main-agent ❌ CONSISTENCY_ISSUE`
 
+## NAS 部署目录
+
+NAS 上用于本项目部署的目录有两个（容器挂载源）：
+
+| NAS 路径 | 容器内 | 用途 |
+|---------|--------|------|
+| `/volume1/homes/admin/.sanguo_projects/sanguo_vnpy_v2` | `/app` | **代码安装目录**（容器 entrypoint 工作目录）|
+| `/volume1/stock` | `/volume1/stock` | **数据目录**（quant_trading.db + A 股 K 线）|
+
+### 关键路径
+- vnpy 源码：`/app/vnpy_v4.4.0/`（通过 `sys.path.insert(0, _VNPY_SRC)` 引用，不 pip install）
+- quant_trading.db：`/volume1/stock/sanguo_vnpy/data/quant_trading.db`（Phase 1 `read_db_daily` 读取）
+- A 股数据：`/volume1/stock/A股数据/`、`/volume1/stock/minute_kline/`
+- 回测结果库：`/volume1/stock/sanguo_vnpy/data/backtest_results.db`（Phase 2，config/backtest.yaml 配置）
+
+### 部署流程（开发 → 安装 → 运行）
+1. 本机改代码（`~/.openclaw/sanguo_projects/sanguo_vnpy_v2` = `/Users/chufeng/.openclaw/...`）
+2. rsync 到 NAS 安装目录：
+   ```
+   rsync -avz -e ssh --exclude='.git' --exclude='vnpy_v4.4.0' --exclude='__pycache__' --exclude='.superpowers' --exclude='docs' --exclude='tests/data' ./ sanguo-nas:/volume1/homes/admin/.sanguo_projects/sanguo_vnpy_v2/
+   ```
+3. 容器 `sanguo_vnpy_v2` 挂载安装目录为 `/app`（bind-mount），代码改完即生效；若需重载进程 `docker restart sanguo_vnpy_v2`
+
+### NAS SSH / Docker 访问
+- SSH：`ssh sanguo-nas`（key 免密，`~/.ssh/config` 配置；不用密码 sshpass）
+- docker 完整路径：`/var/packages/Docker/target/usr/bin/docker`（Synology，**不在默认 PATH**，命令需用全路径）
+
+### 目录约定对应（CLAUDE.md global）
+- 开发（本机 Mac，`chufeng` 家）：`~/.openclaw/sanguo_projects/` = `/Users/chufeng/.openclaw/sanguo_projects/`
+- 安装（NAS，`admin` 家）：`~/.sanguo_projects/` = `/volume1/homes/admin/.sanguo_projects/`
+- 同一约定路径 `~/.sanguo_projects/` 在两台机器指向不同位置（用户家不同）
+
 ## 参考文档
 
 - 项目参考：`sanguo_moziplus_v3` 设计文档