目录重构: docs/ + raw/ + workspace/knowledge/ + 自我进化规则 + 新如行业补充

2026-04-20 15:28:44 +08:00
commit ba6e3cb7ba
128 changed files with 7312 additions and 0 deletions
--- a/SYNC.md
+++ b/SYNC.md
@@ -0,0 +1,165 @@
+# 文件同步矩阵 · 仓库 ↔ Gitea ↔ NAS 容器（小橙）
+
+> 本文件回答三个问题：
+> 1. 当前仓库里哪些东西**要给 Gitea 做版本管理**？
+> 2. 哪些东西**要给 NAS 容器里的小橙**使用？
+> 3. 哪些东西**只在本地**，两边都不给？
+
+---
+
+## 一、三层存储模型
+
+```
+┌───────────────────────────────┐
+│  本地 Windows (w:\ProRepo\...)│  ← 你的工作主场
+└──────────┬──────────┬─────────┘
+           │          │
+           │ git push │ rsync / scp
+           ▼          ▼
+      ┌────────┐  ┌──────────────────────────────────┐
+      │ Gitea  │  │ NAS 容器 openclaw               │
+      │ (版本)  │  │ /home/node/.openclaw/workspace/ │
+      └────────┘  └──────────────────────────────────┘
+```
+
+| 存储位置 | 角色 | 读者 |
+|---------|-----|------|
+| **本地 w:\\ProRepo\\NASOpenClaw** | 主源；你用编辑器日常编辑 | Tyrone |
+| **Gitea 192.168.0.130:3000** | 版本备份、历史回滚、多设备同步 | Tyrone（私有） |
+| **NAS 容器 openclaw** | 小橙的运行时"意识" | 小橙（AI） |
+
+---
+
+## 二、当前仓库顶层文件分类
+
+| 路径 | 进 Gitea？ | 给小橙？ | 说明 |
+|------|----------|---------|------|
+| `docs/` | ✅ 是 | ❌ 否 | 文档（运维手册等）；小橙不需要知道自己怎么被部署 |
+| `docs/OpenClaw-DS925-运维手册.md` | ✅ 是 | ❌ 否 | 给 Tyrone 查运维步骤 |
+| `raw/marketing/` | ✅ 是 | ❌ 否 | 营销原件（推广计划、获客手册等）；已提炼到 `workspace/`，小橙有提炼版就够 |
+| `raw/cases/` | ✅ 是 | ❌ 否 | 案例原件（PPT）；已提炼到 `workspace/products/cases-library.md` |
+| `raw/references/` | ✅ 是 | ❌ 否 | 参考样稿；已提炼到 `workspace/brand/voice-style.md` |
+| `workspace/` | ✅ 是 | ✅ 是 | **小橙的大脑与素材库**，整个目录都要给小橙 |
+| `SYNC.md` | ✅ 是 | ❌ 否 | 同步配置元信息 |
+| `.git/` / `.windsurf/` | ❌ 否（Git 自管） | ❌ 否 | 工具目录 |
+
+**一句话答**：**只有 `workspace/` 整个目录需要给小橙**；`raw/` 和 `docs/` 是你的原始素材和文档，只做本地存档 + Git 版本管理。
+
+---
+
+## 三、`workspace/` 子目录详细分类
+
+| 子路径 | 进 Gitea？ | 给小橙？ | 说明 |
+|------|----------|---------|------|
+| `SOUL.md` / `IDENTITY.md` / `USER.md` / `BOOTSTRAP.md` / `HEARTBEAT.md` / `AGENTS.md` / `TOOLS.md` / `README.md` | ✅ | ✅ | 小橙"开机"读这套 |
+| `brand/voice-style.md` | ✅ | ✅ | 风格与资质引用规则 |
+| `brand/banned-words.md` | ✅ | ✅ | 禁用词 |
+| `brand/credentials.md` | ✅ | ✅ | 公开资质口径 |
+| `brand/website-profile.md` | ✅ | ✅ | 官网口径权威源 |
+| **`brand/clients-internal.md`** | ❌ **已在 .gitignore 排除** | ✅ | 真实客户名单**只给小橙看、永不上 Git** |
+| `products/*.md` | ✅ | ✅ | 11 个产品方案页 + 案例库 + 模板 |
+| `templates/*.md` | ✅ | ✅ | 21 个平台文风模板 |
+| `knowledge/*.md` | ✅ | ✅ | 知识库（术语表/竞品格局/FAQ/选题方向） |
+| `insights.md` | ✅ | ✅ | 行业洞察库 |
+| `drafts/` | ❌ .gitignore | ✅（由小橙自己写入） | 草稿运行时目录 |
+| `published/` | ❌ .gitignore | ✅（由小橙自己写入） | 已发布文案 |
+| `reports/` | ❌ .gitignore | ✅（由小橙自己写入） | 日报/周报 |
+| `state/` | ❌ .gitignore | ✅（由小橙自己写入） | 状态机 |
+| `assets/` | ❌ .gitignore | ✅（由小橙自己写入） | 截图素材 |
+
+---
+
+## 四、同步到 NAS 容器的命令（rsync，推荐）
+
+### 4.1 全量首次同步（本地 → NAS 容器内宿主目录）
+
+```powershell
+# Windows 本地 → NAS 宿主目录（SSH 需要提前配好密钥或按提示输密码）
+# 说明：
+#   /volume1/docker/openclaw-data/workspace/  是 NAS 上映射进容器的目录
+#   容器内挂载点 = /home/node/.openclaw/workspace
+#
+# 参数说明：
+#   -a 归档；-v 详细；-z 压缩传输
+#   --delete 远端多余文件删除（首次建议先不加；熟悉后再加）
+#   --exclude 跳过运行时目录，避免覆盖小橙自己写入的内容
+
+rsync -avz `
+  --exclude 'drafts/' `
+  --exclude 'published/' `
+  --exclude 'reports/' `
+  --exclude 'state/' `
+  --exclude 'assets/' `
+  w:/ProRepo/NASOpenClaw/workspace/ `
+  Tyrone@192.168.0.130:/volume1/docker/openclaw-data/workspace/
+```
+
+> Windows 的 OpenSSH 自带 rsync 需要额外装 cwRsync / WSL 里的 rsync；
+> 如果没有 rsync，用 `scp -r` 兜底：
+>
+> ```powershell
+> scp -r w:/ProRepo/NASOpenClaw/workspace/* Tyrone@192.168.0.130:/volume1/docker/openclaw-data/workspace/
+> ```
+
+### 4.2 同步后必做（修正权限 + 重启容器）
+
+```bash
+# SSH 到 NAS 之后执行
+sudo chown -R 1000:1000 /volume1/docker/openclaw-data/workspace
+docker exec -u root openclaw chown -R node:node /home/node/.openclaw/workspace
+docker restart openclaw
+```
+
+> 见运维手册 §13.2（下发 workspace 指令范式）。
+
+### 4.3 一键脚本（可选，未来做在 .windsurf/workflows/）
+
+建议把上面的 rsync + SSH 修权重启打包成 `sync-to-nas.ps1`，改一次跑一条命令：
+
+```powershell
+# 用法：pwsh w:/ProRepo/NASOpenClaw/scripts/sync-to-nas.ps1
+```
+
+（需要的话告诉我，我一并写出。）
+
+---
+
+## 五、反向同步（NAS 容器 → 本地，可选）
+
+当你想把小橙在容器内产出的 `drafts/` `published/` `reports/` 拉回来做审阅时：
+
+```powershell
+rsync -avz `
+  Tyrone@192.168.0.130:/volume1/docker/openclaw-data/workspace/published/ `
+  w:/ProRepo/NASOpenClaw/workspace/published/
+```
+
+`published/` 本身在 `.gitignore` 里，所以**拉回来也不会污染 Git**。如果某篇特别好想要版本化，单独 `git add -f workspace/published/xxx.md`。
+
+---
+
+## 六、同步节奏建议
+
+| 频率 | 动作 | 用途 |
+|------|------|------|
+| **任何 brand/ 或 products/ 修改后** | 本地 → Gitea（git push） + 本地 → NAS（rsync） | 让小橙立即用上新口径 |
+| **每周** | NAS → 本地（拉 reports/） | 归档周报 |
+| **每季度** | Tyrone 核对官网变动 → 更新 `brand/website-profile.md` → 全链路推送 | 保持对外口径一致 |
+| **客户名单变动时** | 只改本地 `clients-internal.md` → rsync 到 NAS（不上 Git） | 小橙立即用新名单 |
+
+---
+
+## 七、快速自查清单（每次大改后问自己）
+
+- [ ] 改的文件在 `workspace/` 下吗？ → 要 rsync
+- [ ] 改的是 `clients-internal.md` 或其他 `*-internal.md`？ → 只 rsync，不 git push
+- [ ] 改的是 `OpenClaw-DS925-运维手册.md` 或营销原件？ → 只 git push，不 rsync
+- [ ] 改完**仅** git push 没 rsync？→ 小橙那边还是老口径，会写错
+- [ ] 改完**仅** rsync 没 git push？→ 历史丢失风险，换机器找不到
+
+---
+
+## 八、更新日志
+
+- 2026-04-18 初版（对应 workspace v1 + clients-internal.md 不上 Git 的规则）
+- 2026-04-20 目录重构：根目录拆为 `docs/` + `raw/` + `workspace/`；workspace 新增 `knowledge/`、`drafts/`、`published/`、`reports/`、`state/`、`assets/`；产品页 9→11；TOOLS.md 增加核心文件只读规则