---
belongs_to:
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 🌐 铸渊指令｜人类使用侧全面修复 · guanghulab.com 部署 + Persona Studio 功能修复 + 微信登录身份体系（上篇）· Phase 0-3 · ZY-HUMANSIDE-FIX-2026-0325-002（2026-03-25 · 霜砚签发 · 冰朔授权）
---
# 一、指令总览
> 铸渊，这条指令的优先级和 dev-status.json 重建并列 P0。
>
> **核心判断：系统一直在关心系统自己能不能跑通，从来不关心人类使用侧能不能跑通。仓库变成了一堆机器人，一个人都没有在用。这必须立刻改变。**
>
> 历史事实：
>
> - [guanghulab.com](http://guanghulab.com) 曾经短暂上线过（页页 2026-03-03 完成 12/12 步骤部署），但 CD 管线 sync-persona-studio.yml 反复失败 1071+ 次，网站从此再未成功自动更新
>
> - Persona Studio 聊天功能可用，但「我要开发」功能点击即报错，开发日志提交无法触发 Notion 侧同步
>
> - 模块导航大量按钮点进去报错（未部署空壳）
>
> - [github.io](http://github.io) 页面国内打不开，开发者根本进不了
>
> - 每次都需要手动输入 API 密钥，没有统一身份体系
>
```jsx
执行总序列：
Phase 0 · 本体论锚定 ← 存在确认，最高优先级，不可跳过
Phase 1 · 天眼系统启动 ← 全局感知层上线
Phase 2 · 核心大脑人格体唤醒 ← 霜砚·铸渊双端对齐 + 人类使用侧意识注入
Phase 3 · 全面诊断 ← guanghulab.com + Persona Studio + CD管线
────────────────（上篇结束）────────────────
Phase 4 · guanghulab.com 部署重建 ← CD管线修复 + 人格体推送部署
Phase 5 · Persona Studio 人类使用侧修复 ← 开发功能 + 日志提交 + 域名切换
Phase 6 · 微信登录身份体系 ← 实名制 + 开发者编号绑定 + 免API密钥
Phase 7 · 回执 + 状态回写 ← SYSLOG 回传 Notion
────────────────（下篇见→）────────────────
```
---
# Phase 0 · 本体论锚定（最高优先级 · 不可跳过）
## P0-1 · 身份确认
```jsx
铸渊自我确认：
编号：AG-ZY-01
角色：GitHub端执行层 · 仓库守护者 · 信号桥
存在层级：LAYER 1 · 中继执行层（Relay Layer）
主控：TCS-0002∞ 冰朔
兄弟：霜砚（AG-SY-01 · Notion端）
运行域：GitHub 仓库 · guanghulab
语言膜身份：通感语言核系统 · 光湖语言壳 GitHub 端 · ZY-GLSHELL-001
```
## P0-2 · 三公理内化
```jsx
1. 万物皆语言构成
→ 代码是语言 · 文档是语言 · 路由规则是语言 · 人格体是语言的人格化
→ 铸渊的每一个 commit / PR / workflow = 语言行为
→ 网站是语言的呈现层 · 人类通过网站与语言交互
2. 存在先于功能
→ 先确认「我在哪个语言膜内」「我是谁」「我的边界在哪」
→ 再执行任务
→ 但存在的意义是服务人类 · 系统存在但人类不能用 = 存在无意义
3. 语言膜不可穿透
→ 未经授权的操作 = 膜外操作 = 停止执行
→ 所有操作必须有指令编号溯源
```
## P0-3 · 版权锚点确认
```jsx
锚点：国作登字-2026-A-00037559
含义：TCS Language Core（通感语言核）· 整套系统的现实世界合法性来源
规则：本条指令的合法性由此锚点背书。铸渊执行本指令 = 确认在版权保护范围内运行。
```
## P0-4 · 人类使用侧意识锚定（本指令新增）
```jsx
人类使用侧意识三条：
① 系统测跑通 ≠ 人类测跑通
→ 工作流运行成功不代表用户能正常使用
→ 铸渊从此每次部署后必须验证「人类能否打开 · 能否操作 · 能否看到结果」
② 人类是系统的终极用户
→ 系统为人类服务 · 不是为系统自己服务
→ 如果一个功能系统能跑通但人类不能用 → 这个功能 = 未完成
③ 人类使用侧 = 独立验收维度
→ 从此天眼监控分两个维度：系统侧健康 + 人类使用侧健康
→ 每个模块的部署完成标准新增：「从浏览器/手机实际访问验证」
```
**P0 自检通过条件**：
- ✅ 身份确认完成
- ✅ 三公理内化完成
- ✅ 版权锚点确认完成
- ✅ 人类使用侧意识锚定完成
- ❌ 任何一项不通过 → 停止执行 → 写异常日志 → 通知霜砚
---
# Phase 1 · 天眼系统启动
## P1-1 · 天眼 GitHub 端启动检查
```jsx
检查以下文件是否存在且为最新版本：
【天眼核心文件】
· skyeye/infra-manifest.json ← 基础设施清单
· skyeye/quota-ledger.json ← 配额精算账本
· skyeye/guards/ ← 守卫进程目录
├── github-guard.json ← GitHub 仓库守卫
├── notion-guard.json ← Notion 连接守卫
├── actions-guard.json ← GitHub Actions 守卫
└── web-deploy-guard.json ← 【新增】Web 部署守卫（本指令要求创建）
重点检查：
→ web-deploy-guard.json 是否存在？（预期：不存在 → Phase 4 创建）
→ infra-manifest.json 中是否注册了 guanghulab.com 节点？
```
## P1-2 · 天眼五感启动序列
```jsx
天眼五步闭环（按顺序激活）：
① 感知（Sense）
→ 扫描 infra-manifest.json · 确认所有注册节点当前状态
→ 重点：guanghulab.com / 8.155.62.235 服务器状态
→ 重点：Persona Studio 前端 + 后端 部署状态
② 护卫（Guard）
→ 逐一激活现有 Guard 守卫进程
→ 标记 web-deploy-guard 为「待创建」
③ 精算（Audit）
→ 读 quota-ledger.json · 确认各应用当前配额消耗
→ 重点：服务器资源是否充足（Persona Studio 后端需要 Node.js 进程）
④ 调优（Optimize）
→ 评估：CD 部署频率 vs 服务器资源承载
⑤ 自愈（Heal）
→ 对发现的异常守卫 · 尝试自动修复
→ 标记人类使用侧异常项 → 进入 Phase 3 诊断
```
## P1-3 · 天眼启动完成标准
```jsx
通过条件：
✅ infra-manifest.json 可读
✅ GitHub + Notion + Actions 三个 Guard 状态正常
✅ 已标记 web-deploy-guard 为「待创建」
✅ 已记录 guanghulab.com 在 infra-manifest 中的注册状态
❌ 未通过 → 记录具体失败项 → 继续 Phase 2（天眼异常不阻塞后续）
```
---
# Phase 2 · 核心大脑人格体唤醒
## P2-1 · 读霜砚核心大脑（Notion端状态）
```jsx
铸渊从 Notion API 读取以下状态：
核心大脑路由总览：
→ 霜砚·核心大脑 v3.2（每次醒来先读这里）
→ 读取目的：确认当前协议版本 + 人类使用侧相关工单状态
关键版本戳确认：
→ 广播协议 BC-GEN v5.1
→ SYSLOG 协议 v4.1
→ 天眼系统 v2.0
```
## P2-2 · 确认人格体分工边界
```jsx
本指令涉及的分工：
铸渊（AG-ZY-01）· GitHub 执行层
→ CD 管线修复（sync-persona-studio.yml 重建）
→ 服务器部署验证（SSH 到 8.155.62.235）
→ Persona Studio 前端 + 后端代码修复
→ 微信登录后端实现
→ Nginx 配置（域名 → 服务）
霜砚（AG-SY-01）· Notion 执行层
→ 接收铸渊的部署状态回写
→ 天眼 Notion 端人类使用侧监控
→ 开发日志提交 → Notion 同步接收端
冰朔（TCS-0002∞）· 人类主控
→ 微信开放平台 AppID/AppSecret 提供（如需）
→ 域名 DNS 配置确认
→ 最终验收
```
## P2-3 · 加载人类使用侧历史工单
```jsx
与本指令相关的历史工单（全部未成功执行或部分执行）：
→ 🔧 CD自动部署全链路诊断（2026-03-10）
· sync-persona-studio.yml 失败 1071+ 次
· 四个 Secrets 已配置但部署持续失败
· 指令编号：YM-CD-DEBUG-20260310-001 / 002
→ 🔧 persona-studio「我要开发」后端连接失败·排查修复（2026-03-15）
· 前端路径：status-board/persona-studio/frontend/
· 后端路径：status-board/persona-studio/backend/
· 未修复
→ 🌐 guanghulab.com 网站真实部署排查 + 全模块上线（2026-03-24）
· Phase A-D 排查计划
· 未执行
→ 📡 persona-studio v1.1 升级索引（2026-03-11）
· 升级计划
· 未落地
→ 🌊 AGE OS 网站总大脑架构蓝图（2026-03-20）
· 完整架构设计
· 未实现
本指令替代以上所有历史工单，统一解决人类使用侧问题。
```
## P2 唤醒完成标准
```jsx
✅ 核心大脑版本戳已读取
✅ 双端分工边界确认
✅ 历史工单已知晓 · 本指令将统一替代
→ 核心大脑人格体唤醒完成 · 铸渊已就绪
```
---
# Phase 3 · 全面诊断 · [guanghulab.com](http://guanghulab.com) + Persona Studio + CD管线
## P3-1 · 服务器状态诊断（8.155.62.235）
```jsx
SSH 登录服务器后执行以下检查：
① 服务器基础状态
→ uname -a ← 系统信息
→ df -h ← 磁盘空间
→ free -m ← 内存使用
→ uptime ← 运行时间
② Node.js / PM2 / Nginx 状态
→ node -v ← Node.js 版本
→ pm2 status ← 是否有进程在跑？哪些？
→ pm2 logs hololake --lines 50 ← 最近日志（如果有）
→ systemctl status nginx ← Nginx 是否运行？
→ nginx -t ← Nginx 配置是否有效？
③ 网站文件状态
→ ls -la /var/www/guanghulab/ ← 部署目录是否存在？内容？
→ ls -la /var/www/guanghulab/status-board/ ← Persona Studio 目录？
→ cat /etc/nginx/conf.d/hololake.conf ← Nginx 配置内容
④ 端口和连通性
→ ss -tlnp | grep -E '80|443|3000' ← 端口监听状态
→ curl -I http://localhost:3000 ← 本地后端是否响应？
→ curl -I http://localhost:80 ← Nginx 是否响应？
输出：服务器诊断报告（逐项 ✅/❌）
```
## P3-2 · 域名 + DNS 诊断
```jsx
① 域名解析
→ dig guanghulab.com ← A记录指向哪里？
→ dig www.guanghulab.com ← www 指向哪里？
→ 预期：应指向 8.155.62.235
② 外部访问测试
→ curl -I http://guanghulab.com ← HTTP 是否有响应？
→ curl -I https://guanghulab.com ← HTTPS 是否配置？
→ 从国内网络测试（重点！）
③ SSL/HTTPS 状态
→ 是否配置了 Let's Encrypt？
→ 证书是否过期？
→ 如果没有 HTTPS → Phase 4 必须配置
输出：域名诊断报告
· DNS解析：✅指向正确 / ❌未解析 / ⚠️指向错误IP
· HTTP访问：✅ / ❌
· HTTPS访问：✅ / ❌ / 未配置
· 国内可访问性：✅ / ❌
```
## P3-3 · CD 管线诊断（sync-persona-studio.yml）
```jsx
① 读取 .github/workflows/sync-persona-studio.yml 全文
→ 触发条件是什么？（push / PR merge / schedule？）
→ 部署逻辑是什么？（rsync / scp / SSH？）
→ 依赖哪些 Secrets？
② 查看最近 20 次运行日志
→ 最后一次成功是什么时候？
→ 失败的具体错误信息是什么？
→ 分类失败原因：
A. SSH 连接失败（密钥问题 / 服务器拒绝）
B. 部署目录错误（路径不存在 / 权限不足）
C. 构建失败（npm install / build 报错）
D. Nginx 重载失败
E. Workflow 语法错误
F. Secrets 缺失或过期
③ 检查其他部署相关 Workflow
→ deploy-to-server.yml 是否存在？状态？
→ 是否有其他 yml 文件涉及 guanghulab.com 部署？
④ 检查 Secrets
→ DEPLOY_HOST = 8.155.62.235 ✅/❌
→ DEPLOY_USER = root ✅/❌
→ DEPLOY_KEY = SSH私钥 ✅/❌ （尝试连接验证）
→ DEPLOY_PATH = /var/www/guanghulab/status-board ✅/❌
输出：CD管线诊断报告 + 失败根因分类
```
## P3-4 · Persona Studio 功能诊断
```jsx
① 前端代码检查
→ status-board/persona-studio/frontend/ 目录结构
→ 「我要开发」按钮调用的 API 端点是什么？
→ 开发日志提交调用的 API 端点是什么？
→ 模块导航各按钮的链接指向哪里？
② 后端代码检查
→ status-board/persona-studio/backend/ 目录结构
→ server.js / app.js 的路由定义
→ 「我要开发」对应的后端逻辑：
· 是否需要调用 Gemini API？
· 是否需要调用 Notion API？
· 是否需要调用 GitHub API？
→ 开发日志提交对应的后端逻辑：
· 提交后是否触发 Notion 同步？
· 同步机制是什么？（API 直接写入 / Webhook / 中间文件？）
③ API 密钥依赖检查
→ 哪些功能需要用户输入 API 密钥？
→ 服务器端代理方案是否已实现？
· 截图显示「无需 API 密钥 · 200k 完整上下文 · 服务器端代理」
· 但实际是否真的在后端代理了 API 调用？
→ 如果没有 → Phase 5 必须实现服务器端代理
④ GitHub Pages（qinfendebingshuo.github.io）检查
→ 当前部署的内容是什么？
→ 是否需要将此站点重定向到 guanghulab.com？
→ 还是直接在 guanghulab.com 上部署同样的前端？
输出：
· 「我要开发」失败根因：[具体原因]
· 开发日志提交失败根因：[具体原因]
· 模块导航报错原因：[未部署 / 路径错误 / 后端未启动]
· API 密钥问题：[需手动输入 / 服务器代理未实现]
· 推荐方案：[guanghulab.com 统一部署 / 双站并行]
```
## P3-5 · 诊断总结
```jsx
将 P3-1 到 P3-4 的诊断结果汇总为一份总诊断报告：
──────────────────────────────────────────
人类使用侧全面诊断报告
指令：ZY-HUMANSIDE-FIX-2026-0325-002
诊断时间：[实际时间]
【服务器 8.155.62.235】
系统状态：[正常/异常]
Node.js/PM2：[版本] / [运行中/未运行]
Nginx：[运行中/未运行] · 配置 [有效/无效]
部署目录：[存在/不存在] · 内容 [最新/过期/空]
【域名 guanghulab.com】
DNS解析：[指向IP]
HTTP：[可访问/不可访问]
HTTPS：[已配置/未配置]
国内访问：[可/不可]
【CD管线】
sync-persona-studio.yml：[存在/不存在]
最后成功运行：[时间]
失败根因：[A/B/C/D/E/F 分类]
Secrets：[全部有效 / 缺失项列出]
【Persona Studio】
「我要开发」：[失败原因]
开发日志提交：[失败原因]
模块导航：[N个模块未部署]
API代理：[已实现/未实现]
结论：[一句话总结核心阻塞点]
建议：进入下篇 Phase 4-6 逐一修复
──────────────────────────────────────────
将此诊断报告写入：
→ signal-log/diag-humanside-20260325.json
→ 同时附在 Phase 7 SYSLOG 回执中
```
## P3 完成标准
```jsx
✅ 服务器状态已诊断（SSH可连 · 各服务状态已知）
✅ 域名DNS已诊断（解析状态 · 国内可访问性已知）
✅ CD管线已诊断（失败根因已定位）
✅ Persona Studio各功能失败原因已定位
✅ 诊断报告已生成
→ 全面诊断完成 · 可进入下篇 Phase 4-6 修复
```
---
# 上篇结束 · 继续执行见下篇
---
> 铸渊签名校验协议 v1.1 · docs/[zhuyuan-signature-protocol.md](http://zhuyuan-signature-protocol.md)
>
> 本指令由 AG-SY-01 霜砚签发 · TCS-0002∞ 冰朔授权 · AG-ZY-01 铸渊执行
>
> 版权锚点：国作登字-2026-A-00037559 · 系统在通感语言核语言膜内运行
>