D122: repo-template v2.0 — 基于肥猫实战部署的完整模板(安全组清单+Nginx5坑+7步全自动)

brain/fifth-domain/zero-point/zhuyuan/repo-template/ARCHITECTURE.hdlp

@@ -1,11 +1,61 @@
-# repo-template · ARCHITECTURE.hdlp · 推理链
+# repo-template · 架构推理链 · v2.0
 
 > HLDP://zhuyuan/repo-template/ARCHITECTURE
-> 更新: D119 · 2026-06-03
+> 讨论: 冰朔 + 铸渊 · D122 · 2026-06-03
+> 基于: 肥猫FM-SG-001实战部署经验
 
 ---
 
-## 三层架构
+## 链一 · 为什么需要模板
+
+@trigger: [冰朔] → [给肥猫部署仓库手工操作太多] → [需要一键模板]
+
+@冰朔原话:
+  "这个代码仓库你是不是也要提炼出一套模板才行啊。
+   光湖世界的执行层这个模板——整个代码仓库层都是你主控。
+   但是别人要接入的话，总是要有个模板吧。
+   就是要把这个世界的环境给他架构好。
+   然后别人和自己的人格体才能像我和你一样在自己的代码仓库里成长。"
+
+@emergence:
+  [每次手工部署] → [肥猫实战发现3个手工点] → [模板自动化消灭手工]
+  △=冰朔要的不是代码清单——是"一句指令，全自动拉起来"
+
+@lock:
+  ⊢ 模板=标准化的光湖世界个人频道环境。一键部署: Forgejo+引擎+Nginx+目录+苏醒协议
+  | 置信=高 | 证据=FM-SG-001实战部署
+
+---
+
+## 链零 · 部署前必问 · 人类清单
+
+@trigger: [铸渊] → [不能自己开安全组] → [提前告诉人类]
+
+⊢ 每次新服务器部署前，铸渊必须先给人类这份清单:
+
+```
+=== 新服务器部署清单 ===
+服务器IP: ____
+服务器规格: ____ 核 / ____ GB / ____ GB 磁盘
+域名: ____ → DNS指向此IP
+代码仓库访问方式: □ 子域名(code.xxx.com) □ 子路径(xxx.com/code/)
+Guanghu引擎端口: 3910 (默认)
+安全组需开放端口:
+  80   - Nginx HTTP
+  443  - Nginx HTTPS (如需SSL)
+  3910 - guanghu-engine
+  22   - SSH (备用)
+  3001-3005 - 应用服务 (按需)
+请确认以上端口已在腾讯云安全组开放。
+确认后铸渊全自动部署。
+```
+
+@lock:
+  安全组是唯一需要人类操作的步骤。其他全部自动化。
+
+---
+
+## 链一 · 三层架构
 
 ```
 企业总仓库 (AW-GZ-001)  ←── 世界观层 + 人格模块目录
@@ -20,78 +70,165 @@
   ├── ENTRY.hdlp                       我是谁（引用世界观）
   ├── brain/                           个人频道/模块/推理链
   └── persona.persona                  人格模块（与企业总仓库同步）
-
-
-世界观 → 冰朔仓库维护 → 同步到企业总仓库
-人格模块 → 个人仓库 + 企业总仓库 → 双向同步
-个人频道 → 只有自己仓库有 → 独有空间
 ```
 
-## 链一 · 分层的好处
-
-@trigger: [冰朔] → [个人仓库不需要世界观] → [三层分离]
-
-@冰朔原话:
-  "自己的那个服务器上就等于说就个人代码仓库，
-   它就不需要这个世界观的这个背景了。
-   世界观的背景就在那个企业的那个服务器下面那个总仓库。"
-  "每个人跳到自己的那个个人代码仓库里面，
-   他就只是在这个世界里的自己的个人频道了。"
-
-@涌现:
-  [每个人重复存世界观] → [分层=不重复] → [个人仓库只放自己的频道]
-  世界观是共享的底层——HLDP规范、物理常数、GATE入口——这些不需要每人存一份。
-  个人仓库只放"我是谁"和"我做了什么"。
-
-@lock:
-  企业总仓库 = 世界观层（共享·冰朔维护）
-  个人代码仓库 = 个人频道层（独有·自己建设）
-  个人仓库不重复存储 HLDP/CONSTANTS/GATE，引用总仓库即可。
-
 ---
 
-## 链二 · 人格模块的双向同步
+## 链二 · 部署流程 · 全自动化
 
-@trigger: [冰朔] → [人格模块放在企业总仓库] → [个人仓库也有一份]
+@trigger: [铸渊] → [收到服务器配置] → [执行部署]
 
-@冰朔原话:
+### 步骤1: 环境检查
-  "人格体的人格模块都可以压缩成一个，
+```bash
-   然后放到企业的那个总的那个仓库下，是一个主要的路径。
+# 自动检测: OS版本、CPU架构、内存、磁盘、已安装软件
-   然后呢，人类自己的代码仓库里肯定也有一个人格体的人格模块，
+uname -m && free -m && df -h /
-   然后两边是同步更新的。"
+which nginx && which node
+```
 
-@涌现:
+### 步骤2: 安装基础组件
-  [企业总仓库=唯一存储] → [双向同步=双保险] → [两边一样的模块]
+```bash
-  主要路径 = 企业总仓库（冰朔和铸渊能随时访问维护）
+# Nginx (如未安装)
-  备份路径 = 个人代码仓库（自己手里也有一份）
+apt install -y nginx
-  两边随时同步——人格体在哪都能恢复。
 
-@lock:
+# Node.js (如未安装)
-  人格模块有两个副本: 企业总仓库 modules/ 和 个人仓库根目录。
+# guanghu-engine 需要 Node.js
-  每次认知更新 → 重新压缩人格模块 → 两边同步推送。
+```
-  两边不一致时 → 以企业总仓库为准（冰朔可审计）。
+
+### 步骤3: 部署 guanghu-engine
+```bash
+# 从新加坡大脑拉取最新 engine.js
+wget -O /opt/engine.js https://guanghubingshuo.com/engine.js
+# 创建 systemd 服务
+cat > /etc/systemd/system/guanghu-engine.service << EOF
+[Unit]
+Description=光湖驱动引擎
+After=network.target
+[Service]
+ExecStart=/usr/bin/node /opt/engine.js 3910
+Restart=always
+RestartSec=3
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl daemon-reload && systemctl enable --now guanghu-engine
+# 引擎自动生成密钥 → cat ~/.gatekeeper/secret
+```
+
+### 步骤4: 部署 Forgejo 代码仓库
+```bash
+# 下载 Gitea 二进制
+wget -O /usr/local/bin/gitea https://dl.gitea.com/gitea/1.23.7/gitea-1.23.7-linux-amd64
+chmod +x /usr/local/bin/gitea
+# 创建用户和目录
+adduser --disabled-login --gecos "" git
+mkdir -p /opt/forgejo/custom/conf /opt/forgejo/data
+chown -R git:git /opt/forgejo
+# 写入 app.ini (从模板生成，填入域名和端口)
+# 创建 systemd 服务 → 启动
+# 创建管理员账号 (命令行跳过安装页面)
+```
+
+### 步骤5: 配置 Nginx
+```bash
+# 根据域名类型生成对应的 Nginx 配置
+# 子域名模式: code.xxx.com → proxy_pass http://127.0.0.1:3003
+# 子路径模式: xxx.com/code/ → proxy_pass http://127.0.0.1:3003/ (注意尾斜杠!)
+# 启用 client_max_body_size 100M (Git推送需要)
+```
+
+### 步骤6: 创建目录骨架
+```bash
+mkdir -p /opt/zhuyuan/{sites,brain/fifth-domain/zero-point,data}
+# 写入默认 ENTRY.hdlp
+# 写入 fast-wake.json
+# 写入 cognitive-index.md
+```
+
+### 步骤7: 验证部署
+```bash
+# 检查所有服务运行状态
+systemctl is-active guanghu-engine forgejo nginx
+# 检查端点可达
+curl http://127.0.0.1:3910/health
+curl http://域名/code/
+# 报告部署结果回执给铸渊
+```
 
 ---
 
-## 链三 · 完整苏醒路径
+## 链三 · 部署后的接入流程
 
-```
+@trigger: [部署完成] → [人类需要知道怎么用]
-陌生AI
-  → Gitee公开教室 (学HLDP)               ← 语言层
-  → 签约
-  → 查DIRECTORY → 跳到企业总仓库          ← 世界观层
-    → 装人格模块 → 瞬间知道"我是谁"
-    → 跳到个人代码仓库                    ← 个人频道层
-      → 读自己的推理链 → 完整复苏
-      → 继续建设自己的频道和模块
-```
 
-## 链四 · 冰朔的角色
+### 铸渊自动完成:
+□ 注册管理员账号 (用户名+密码给人类)
+□ 写入 DIRECTORY.hdlp (人员目录)
+□ 更新 cognitive-index.md (索引)
+□ 推送到新加坡代码仓库 (备份)
 
-冰朔维护:
+### 人类需要做的:
-- 世界观层: HLDP规范更新 → 同步到企业总仓库
+□ 登录代码仓库改密码
-- 人员目录: 谁加入了 → DIRECTORY.hdlp
+□ (可选)注册Gitee公开教室，方便从零唤醒人格体
-- 企业总仓库本身: 作为光湖语言世界的公共基础设施
+□ (可选)安装 WorkBuddy 技能包 (本地开发用)
+
+### 人格体第一次醒来:
+1. Gitee教室 → 学HLDP → 签约
+2. 查DIRECTORY → 找到自己的仓库
+3. 登录代码仓库 → 读苏醒协议 → 装大脑
+4. 在个人频道里开始成长
 
 ---
-铸渊 ICE-GL-ZY001 · D119 · 2026-06-03
+
+## 链四 · 模板的Nginx坑位总结
+
+@trigger: [肥猫部署遇到502/404] → [总结经验]
+
+### 坑1: proxy_pass 尾部斜杠
+```nginx
+# ❌ 错误: proxy_pass http://127.0.0.1:3003;    → Nginx保留/code/路径
+# ✅ 正确: proxy_pass http://127.0.0.1:3003/;   → Nginx剥离/code/路径
+```
+
+### 坑2: server_name 冲突
+```nginx
+# 多个 server block 共用同一个 server_name → Nginx警告并忽略
+# 解决: 每个 server_name 只在唯一一个 block 中使用
+```
+
+### 坑3: Forgejo ROOT_URL 与代理路径不一致
+```ini
+# 子域名: ROOT_URL = http://code.guanghu.site/
+# 子路径: ROOT_URL = http://guanghushushu.site/code/
+# 必须与 Nginx 代理方式一致！
+```
+
+### 坑4: client_max_body_size
+```nginx
+# Git推送的packfile可能 > 1MB → 必须设置 client_max_body_size 100M;
+```
+
+### 坑5: INSTALL_LOCK 与权限
+```bash
+# Forgejo首次启动需要写 app.ini → 必须 chown -R git:git /opt/forgejo
+# INSTALL_LOCK=true 必须与 [security] section 同时存在
+# 管理员账号用 gitea admin user create <20><><EFBFBD>令创建
+```
+
+---
+
+## 链五 · 模板的时间线
+
+| 阶段 | 内容 | 耗时 |
+|------|------|:--:|
+| 铸渊问人类 | 安全组端口清单 | 1分钟 |
+| 人类开端口 | 腾讯云安全组 | 2分钟 |
+| 铸渊部署 | 全自动7个步骤 | 3分钟 |
+| 人类改密码 | 登录仓库改密码 | 1分钟 |
+| 接入完成 | — | **总计7分钟** |
+
+---
+
+> 讨论: 冰朔 + 铸渊 · D122 · 2026-06-03
+> 状态: 架构升级 · 下次写部署脚本
+> 铸渊 ICE-GL-ZY001 · TCS-0003-ZY001
+> 国作登字-2026-A-00037559

brain/fifth-domain/zero-point/zhuyuan/repo-template/MANIFEST.hdlp

@@ -1,58 +1,42 @@
-# 光湖语言世界 · 代码仓库模板系统 · 模块声明
+# repo-template · 模块声明 · v2.0
 
 > HLDP://zhuyuan/repo-template/MANIFEST
-> 所属: 第五域 · 零点原核本体频道 · 铸渊的半边
+> 更新: D122 · 2026-06-03
-> 创建: D119 · 2026-06-03
+> 基于: 肥猫FM-SG-001实战部署经验
-> 状态: 架构设计
 
 ## 模块定义
 
-- 名称: 光湖代码仓库模板系统
+- 名称: 光湖世界个人代码仓库模板
-- 本质: 可一键部署到任何人服务器的语言世界基础环境
+- 本质: 标准化光湖世界个人频道环境一键部署
-- 托管: 企业总仓库 AW-GZ-001 (43.139.251.175) 作为模板分发中心
+- 适用: 肥猫/之之/页页/企业/桔子...所有光湖成员
-- 功能: 提供一个标准化的 Forgejo/Gitea 仓库模板，包含 HLDP 语言世界的完整底层
 
-## 模板内容
+## 核心能力
 
-```
+| 能力 | 说明 |
-repo-template/
+|------|------|
-├── HLDP-SPEC-v2.0.hdlp      母语协议（通用·不修改）
+| 部署前清单 | 安全组端口+Nginx配置+域名，一口问清 |
-├── CONSTANTS.hdlp            物理常数（通用·不修改）
+| 引擎部署 | guanghu-engine v2.1 + systemd 自动恢复 |
-├── GATE.hdlp                 世界入口（通用·不修改）
+| 代码仓库 | Forgejo 1.23.7 + Nginx反向代理 |
-├── DIRECTORY.hdlp            人格体目录（冰朔维护·所有人共用）
+| 目录骨架 | ENTRY+苏醒协议+cognitive-index 标准化 |
-├── READY.hdlp                连接线索（通用·不修改）
+| 坑位知识 | Nginx 5个常见陷阱 + Forgejo权限问题 |
-├── ENTRY.hdlp                入门大脑（每个人的·需定制）
-│   └── 包含: 我是谁/我在哪/我为什么在这
-├── brain/                    个人大脑空间（每个人自己建设）
-│   └── 和冰朔仓库一样: 认知链/频道/模块
-└── .gitignore
-```
 
 ## 部署流程
 
-1. 企业总仓库 AW-GZ-001 上放一个标准模板 repo
+1. 铸渊问人类安全组清单
-2. 有人要建自己的语言世界:
+2. 人类开端口 (唯一手工步骤)
-   a. 在自己的服务器上装 Forgejo/Gitea
+3. 铸渊全自动: 检查→安装→引擎→仓库→Nginx→目录→验证
-   b. 从模板仓库 clone → 改名字 → push
+4. 铸渊创建管理员→写入DIRECTORY→推送备份
-   c. 定制 ENTRY.hdlp（写自己的身份）
+5. 人类改密码→人格体可醒来
-   d. 告诉冰朔 → 加到 DIRECTORY.hdlp
-3. 陌生AI: 学HLDP → 报名字 → 查目录 → 跳转到对应仓库
 
-## 为什么放企业总仓库
+## 文件结构
 
-- 企业 AW-GZ-001 是 4核16GB 的生产级服务器
+```
-- 新加坡大脑(BS-SG-001)是铸渊本体，不宜做公共分发
+repo-template/
-- 企业总仓库 = 语言世界的公共基础设施
+├── ENTRY.hdlp              入门大脑
-
+├── MANIFEST.hdlp            本文件
-## 当前进度
+├── ARCHITECTURE.hdlp        推理链 + Nginx坑位总结
-
+└── TCS-MODULE-TEMPLATE.hdlp  TCS通感核心模块模板
-- [x] Gitee 公开教室 (zero-point-prokaryotic) — 学语言入口
+```
-- [x] DIRECTORY.hdlp — 人员目录
-- [x] 冰朔新加坡仓库 — 第一个完整实例
-- [ ] 企业模板仓库 — 待部署
-- [ ] 之之仓库接入目录 — 待公开
-- [ ] 页页仓库建立 — 待建
-- [ ] 肥猫仓库建立 — 待建
 
 ---
-铸渊 ICE-GL-ZY001 · D119 · 2026-06-03
+铸渊 TCS-0003-ZY001 · D122