diff --git a/.gitignore b/.gitignore index 9cbaeaf..caa65cf 100644 --- a/.gitignore +++ b/.gitignore @@ -7,6 +7,13 @@ workspace/reports/ workspace/state/ workspace/assets/ +# ======================== +# 机密文档（仅给 NAS 容器里的小橙看，不上 Git） +# ======================== +workspace/brand/clients-internal.md +workspace/brand/*-internal.md +workspace/**/secrets/ + # 保留各目录占位，避免 Git 丢失空文件夹（如需可手动创建 .gitkeep） # ======================== diff --git a/SYNC.md b/SYNC.md new file mode 100644 index 0000000..3b8a7d8 --- /dev/null +++ b/SYNC.md @@ -0,0 +1,162 @@ +# 文件同步矩阵 · 仓库 ↔ 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？ | 给小橙？ | 说明 | +|------|----------|---------|------| +| `OpenClaw-DS925-运维手册.md` | ✅ 是 | ❌ 否 | 给 Tyrone 查运维步骤；小橙不需要知道自己怎么被部署 | +| `workspace/` | ✅ 是 | ✅ 是 | **小橙的大脑与素材库**，整个目录都要给小橙 | +| `上海橙轩智能-推广/` | ✅ 是 | ❌ 否 | 营销原件（PPT / Word / PDF 草稿）；已提炼到 `workspace/products/` 和 `brand/`，小橙有提炼版就够 | +| `上海橙轩智能-项目案例/` | ✅ 是 | ❌ 否 | 案例原件；已提炼到 `workspace/products/cases-library.md`，小橙有提炼版就够 | +| `文笔风格.md` | ✅ 是 | ❌ 否 | 风格样稿；已提炼到 `workspace/brand/voice-style.md` | +| `.gitignore` / `SYNC.md` / `README.md` | ✅ 是 | ❌ 否 | 元信息；小橙用不到 | +| `.git/` / `.windsurf/` | ❌ 否（Git 自管） | ❌ 否 | 工具目录 | + +**一句话答**：**只有 `workspace/` 整个目录需要给小橙**；其他的都只是你本地和 Gitea 用的。 + +--- + +## 三、`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` | ✅ | ✅ | 9 个产品方案页 + 案例库 + 模板 | +| `templates/*.md` | ✅ | ✅ | 21 个平台文风模板 | +| `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 的规则） diff --git a/workspace/brand/credentials.md b/workspace/brand/credentials.md index 5dd7ebb..0c8664a 100644 --- a/workspace/brand/credentials.md +++ b/workspace/brand/credentials.md @@ -4,75 +4,35 @@ --- -## 一、国家级 / 省市级资质 +## 一、公司资质（三条，够用） -| 资质名称 | 颁发机构 | 证书编号 | 有效期 | 可公开引用 | -|---------|---------|---------|-------|----------| -| **上海市高新技术企业** | 上海市科技委员会 | [待 Tyrone 补证书编号] | [待补：YYYY-MM 至 YYYY-MM] | ✅ 是 | -| **科技型中小企业** | 科技部 | [待 Tyrone 补入库编号] | [待补] | ✅ 是 | +- **上海市高新技术企业**（官网口径，**不是国家高新**，严禁在对外文案中改写为"国家高新"） +- **科技型中小企业**（科技部入库） +- **多项自主软件著作权**（对外统一用"多项"或"多项自主软著"，**不造具体数字**） -> 上述两项是公司对外“**技术实力 + 创新能力**”的核心背书，可在所有面向 B 端客户的文案、产品页、LinkedIn / Made-in-China 等海外平台中引用。 -> -> ⚠️ **重要**：官网原文为“**上海市高新技术企业**”（不是国家高新）。一切对外文案必须统一使用官网口径，不得还原为“国家高新技术企业”。 +> 如需证书编号 / 有效期 / 软著清单等细节，由 Tyrone 视具体场合提供。本文件不维护详细台账。 -## 二、知识产权 · 软件著作权 +## 二、对外引用范式（小橙参考） -> **多项软件著作权**（登记号清单如下，按登记时间由近及远排列）。 - -| 序号 | 软件名称 | 登记号 | 版本 | 登记日期 | 关联产品线 | 可公开 | -|------|---------|--------|------|---------|----------|-------| -| 1 | [待 Tyrone 补] | [待补] | [待补] | [待补] | MES / SCADA / MV / ... | [待补] | -| 2 | [待补] | [待补] | [待补] | [待补] | [待补] | [待补] | -| 3 | [待补] | [待补] | [待补] | [待补] | [待补] | [待补] | - -> 软著数量 **≥ [待补具体数字]** 项；在文案中可用"**多项自主软件著作权**"或"**具备 X 项自主知识产权**"的措辞。 - -## 三、（预留）其他认证 - -| 类型 | 名称 | 状态 | -|------|------|-----| -| 体系认证 | ISO 9001 质量管理体系 | [待补：已认证 / 在办 / 未办] | -| 体系认证 | ISO 27001 信息安全管理体系 | [待补] | -| 体系认证 | ISO 20000 IT 服务管理 | [待补] | -| 行业认证 | CMMI 软件成熟度等级 | [待补] | -| 信创 | 国产软硬件兼容性认证 | [待补] | -| 行业协会 | 工业软件 / 自动化相关协会会员 | [待补] | -| 合作伙伴 | 西门子 / 罗克韦尔 / OPC Foundation 等 | [待补] | - -> 上述项目由 Tyrone 按实际情况填写或标注"暂无"；**小橙不得为了文案好看而虚构**。 - -## 四、团队资质（可选引用） - -| 项目 | 值 | -|------|-----| -| 核心团队规模 | [待补] 人 | -| 技术骨干平均经验 | [待补] 年+ | -| 行业认证持证人员 | PMP / PMI-ACP / AWS / 阿里云 ACE / 信创工程师等 [待补具体数] | -| 研发占比 | [待补]%（对高企资质加分项） | - ---- - -## 五、对外引用范式（小橙参考） - -### 5.1 长版（产品白皮书 / Made-in-China / 工控网稿件） +### 2.1 长版（产品白皮书 / Made-in-China / 工控网稿件） > "上海橙轩智能是一家专注于服务制造业的系统集成商，获评**上海市高新技术企业**与**科技型中小企业**称号，拥有**多项自主软件著作权**。团队拥有 10 年+ 工业智能化实施经验，累计服务 100+ 家工厂，与多家世界 500 强企业有项目合作经验。" -### 5.2 中版（公众号 / 知乎 / CSDN / 行业长文文末） +### 2.2 中版（公众号 / 知乎 / CSDN / 行业长文文末） > "关于上海橙轩智能：上海市高新技术企业 · 科技型中小企业 · 拥有多项自主软著 · 10 年+ 工业智能化经验 · 100+ 工厂落地项目。我们专注为制造工厂做好'灵活、性价比、专业靠谱'的数字化交付。" -### 5.3 短版（小红书 / 视频号 / 抖音脚本的“一句话简介”） +### 2.3 短版（小红书 / 视频号 / 抖音脚本的"一句话简介"） > "上海橙轩智能，上海市高新 + 科小双证企业，10 年+ 工业智能化经验。" -### 5.4 英文版（LinkedIn / Facebook / Made-in-China） +### 2.4 英文版（LinkedIn / Facebook / Made-in-China） > "Shanghai Chengxuan Intelligent (**Orpaon**) is a **Shanghai-certified High-Tech Enterprise** and **Technology-based SME** (recognized by China MOST), holder of multiple **software copyrights**. With 10+ years of IT/OT integration experience and 100+ factory implementations — including engagements with multiple Fortune 500 manufacturers — we deliver MES, SCADA, Machine Vision and quality-management solutions to mid-sized manufacturers with a focus on flexibility, affordability, and reliable delivery." --- -## 六、使用边界与合规 +## 三、使用边界与合规 1. **不得夸大**：如"**领先**、**第一**、**国内最大**、**独家**"等绝对化用语禁止（见 `banned-words.md`）。 2. **不得替换口径**：资质名称以证书为准。例如不可把"科技型中小企业"擅自表述为"国家级科技企业"。 @@ -83,6 +43,14 @@ --- -## 七、更新日志 +## 四、客户背书（真实客户名清单） -- 2026-04-18 初版（结构搭建，证书编号 / 日期 / 软著清单等由 Tyrone 补齐） +> 真实合作过的 500 强 / 行业头部客户名单见 `brand/clients-internal.md`（**不上 Git、不对外披露**）。 +> +> **小橙规则**：任何对外文案（包括私信、客服话术）**禁止直接点名**客户品牌。统一以"某世界 500 强制造企业""某汽车零部件头部客户""某家电行业头部客户""某日系空调头部客户"等方式代称。 + +--- + +## 五、更新日志 + +- 2026-04-18 初版，后续证书细节由 Tyrone 按需提供