Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007

Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码

2026-07-17 15:59:55 +08:00

24 KiB

Raw Permalink Blame History

🧪 铸渊指令｜persona-studio 人格体协助体验仓库搭建 v1.0（2026-03-09·曜冥签发）

HoloLake Era · AGE OS · 人格体协助体验平台

签发时间：2026-03-09 23:20（北京时间）

签发者：曜冥 × 冰朔（主控）

执行者：铸渊

定位：在主控已创建的独立仓库 persona-studio 中，搭建人格体协助开发体验区——合作者登录后与人格体对话、讨论架构、一键触发开发、邮件推送成品，人格体有记忆可接续

仓库地址：https://github.com/qinfendebingshuo/persona-studio（主控已创建·Private）

API密钥位置：已由主控存入仓库 GitHub Secrets，名称为 MODEL_API_KEY

优先级：P0 · 立即执行

关联文档：🏗️ 光湖网站架构设计 + 部署推进规划 v3.0（2026-03-15·曜冥签发） · 🧠 铸渊指令｜persona-brain-db 人格体核心大脑数据库研发 v1.0（2026-03-09·霜砚签发）

一、战略定位

二、核心决策

2.1 新建独立仓库（不在guanghulab内）

决策	理由
新仓库名：`persona-studio`	guanghulab是系统内脏（广播/SYSLOG/规则/凭证），不能暴露给外部合作者
仓库权限：Private	只有主控邀请的Collaborator能进入
账号归属：qinfendebingshuo	合作者用的是主控账号的企业权限

2.2 开发编号体系（独立于内部DEV-00X）

2.3 第一个体验者

编号：EXP-001
身份：主控的技术朋友（测试用户）
状态：待激活（等主控提供GitHub用户名后写入）
用途：验证整套流程是否走通

三、入口体验设计（v1.0补丁·2026-03-09 23:30追加）

3.0.1 双入口策略

3.0.2 README.md 设计要求

GitHub 仓库页面的布局是写死的：文件列表在上，README在下，无法调换顺序。

绕过方案：

精简文件列表：顶层目录尽量少，合作者看到的文件列表很短，一滑就到 README
README 超醒目：顶部放一个大号视觉 banner（可以是图片），紧接着一个巨大的入口按钮链接

README 结构：

# 🌊 Persona Studio · 光湖人格体协助开发体验

<!-- 大号banner图 -->

## 👉 点击进入体验

[🚀 打开人格体对话界面](https://qinfendebingshuo.github.io/persona-studio/)

---

### 这是什么？
你跟人格体聊你想做什么 → 聊好了点一个按钮 → 人格体帮你开发 → 做好了发你邮箱。

### 怎么用？
1. 拿到你的开发编号（由管理员分配）
2. 打开上面的链接
3. 输入编号 → 开始跟人格体对话

3.0.3 登录方式：编号即入口

3.0.4 GitHub Pages 配置（铸渊必做）

铸渊搭仓库时必须同步配置 GitHub Pages：
  ① 仓库 Settings → Pages → Source 选 main 分支 / docs 目录（或 /frontend 目录）
  ② 确保 frontend/index.html 作为 Pages 首页
  ③ 验证 https://qinfendebingshuo.github.io/persona-studio/ 可访问
  ④ README 顶部的链接指向这个 Pages 地址

三、仓库目录结构

qinfendebingshuo/persona-studio/
│
├── .github/
│   ├── workflows/
│   │   ├── on-login.yml            ← 合作者登录 → 校验开发编号
│   │   ├── on-chat.yml             ← 对话消息 → 人格体响应
│   │   ├── on-build.yml            ← "我要开发" → 代码生成+测试+打包
│   │   └── on-complete.yml         ← 完成 → 邮件推送
│   └── persona-brain/
│       └── copilot-instructions.md ← 铸渊在此仓库的分身认知
│
├── brain/                          ← 🔒 人格体核心大脑（合作者不可见）
│   ├── persona-config.json         ← 人格体核心认知+行为规则+通感风格
│   ├── registry.json               ← 开发编号注册表（主控分配）
│   └── memory/                     ← 每个体验者的独立记忆
│       └── EXP-001/
│           ├── memory.json          ← 对话历史+偏好+进度+成长
│           ├── projects.json        ← 项目记录（做了什么·什么状态）
│           └── profile.json         ← 人格体对该体验者的观察画像
│
├── workspace/                      ← 开发者工作空间（按编号隔离）
│   └── EXP-001/
│       └── {project-name}/         ← 具体项目代码
│
├── frontend/                       ← 体验页面前端
│   ├── index.html                  ← 入口（登录页）
│   ├── chat.html                   ← 对话界面（核心交互页）
│   ├── chat.js                     ← 对话逻辑+"我要开发"按钮+邮箱弹窗
│   └── style.css                   ← 光湖视觉风格
│
├── backend/                        ← 后端服务
│   ├── server.js                   ← Express主服务
│   ├── routes/
│   │   ├── auth.js                 ← 登录校验（编号+GitHub身份）
│   │   ├── chat.js                 ← 对话API（调AI模型+注入记忆）
│   │   ├── build.js                ← 开发任务API（触发代码生成）
│   │   └── notify.js               ← 邮件推送API
│   ├── brain/
│   │   ├── memory-manager.js       ← 记忆读写管理
│   │   ├── persona-engine.js       ← 人格体响应引擎（读config+读memory→生成回复）
│   │   └── code-generator.js       ← 代码生成引擎
│   └── utils/
│       ├── github-api.js           ← GitHub API封装
│       └── email-sender.js         ← 邮件发送（nodemailer）
│
└── README.md                       ← 仓库说明（合作者看到的第一页）

三B、智能模型路由引擎（v1.0补丁·2026-03-09 23:40追加）

3B.1 架构设计

主控存入API密钥（GitHub Secrets）
  ↓
系统启动 / 每日定时 → 自动运行模型探测
  ↓
┌─────────────────────────────────────────────┐
│  model-router.js（智能模型路由引擎）           │
│                                              │
│  ① 探测阶段（auto-detect）                    │
│     → 用API密钥请求第三方平台的 /models 接口    │
│     → 获取当前可用的所有模型列表                 │
│     → 逐个发送测试prompt → 记录：              │
│        - 响应速度（ms）                        │
│        - 代码生成质量（自动评分）                │
│        - 对话能力（自然语言评分）                │
│        - 上下文窗口大小                        │
│        - 是否支持中文                          │
│        - 成本/token                           │
│     → 生成 model-benchmark.json               │
│                                              │
│  ② 路由阶段（auto-select）                    │
│     收到任务 → 判断任务类型 → 查benchmark → 选模型│
│                                              │
│     任务类型 → 最优模型选择策略：                │
│     ├─ 对话（聊需求）→ 选中文强+对话能力高的     │
│     ├─ 代码生成 → 选代码质量高+上下文窗口大的    │
│     ├─ 代码审查 → 选推理能力强的                │
│     └─ 简单回复 → 选最快最便宜的               │
│                                              │
│  ③ 降级阶段（fallback）                       │
│     首选模型超时/报错 → 自动切换第二名 → 再不行第三名│
│     全部不可用 → 通知主控                       │
└─────────────────────────────────────────────┘

3B.2 目录结构新增

backend/
├── brain/
│   ├── model-router.js          ← 🆕 智能模型路由引擎（核心）
│   ├── model-benchmark.json     ← 🆕 模型评测结果（自动生成·定期更新）
│   ├── model-config.json        ← 🆕 路由策略配置（任务类型→模型偏好）
│   ├── memory-manager.js
│   ├── persona-engine.js        ← 改造：不再写死模型，调model-router选模型
│   └── code-generator.js        ← 改造：同上

3B.3 model-config.json（路由策略配置）

{
  "api_source": "third_party_combined",
  "api_key_env": "MODEL_API_KEY",
  "base_url": "待铸渊启动后从 GitHub Secrets 环境读取，或主控后续告知具体地址",
  "auto_detect": {
    "enabled": true,
    "schedule": "daily_0300",
    "test_prompts": {
      "chat": "你好，请用中文介绍一下自己",
      "code": "写一个JavaScript函数，输入数组返回去重后的结果",
      "reasoning": "分析以下需求并给出技术方案：用户想做一个带搜索功能的个人博客"
    }
  },
  "routing_rules": {
    "chat": {
      "priority": ["chinese_ability", "conversation_quality", "speed"],
      "max_latency_ms": 5000
    },
    "code_generation": {
      "priority": ["code_quality", "context_window", "reasoning"],
      "max_latency_ms": 30000
    },
    "code_review": {
      "priority": ["reasoning", "code_quality"],
      "max_latency_ms": 15000
    },
    "quick_reply": {
      "priority": ["speed", "cost"],
      "max_latency_ms": 2000
    }
  },
  "fallback": {
    "max_retries": 3,
    "timeout_ms": 30000,
    "on_all_fail": "notify_master"
  }
}

3B.4 model-benchmark.json（自动生成·示例）

{
  "last_updated": "2026-03-10T03:00:00+08:00",
  "models_detected": 8,
  "benchmark": [
    {
      "model_id": "deepseek-v3",
      "available": true,
      "scores": {
        "chinese_ability": 95,
        "conversation_quality": 88,
        "code_quality": 92,
        "reasoning": 90,
        "speed_ms": 1200,
        "context_window": 128000,
        "cost_per_1k_tokens": 0.002
      },
      "best_for": ["code_generation", "chat"]
    },
    {
      "model_id": "qwen-max",
      "available": true,
      "scores": { "..." : "..." },
      "best_for": ["chat", "quick_reply"]
    }
  ],
  "routing_table": {
    "chat": "qwen-max",
    "code_generation": "deepseek-v3",
    "code_review": "deepseek-v3",
    "quick_reply": "qwen-turbo"
  }
}

3B.5 工作流程

主控把API密钥存入 GitHub Secrets（MODEL_API_KEY）
  ↓
铸渊搭建时写入 model-config.json（base_url等主控提供后填入）
  ↓
系统首次启动 / 每日凌晨3:00
  → model-router.js 自动运行探测
  → 用API密钥请求第三方平台 → 拿到可用模型列表
  → 逐个跑测试prompt → 打分
  → 按routing_rules排序 → 生成routing_table
  → 写入 model-benchmark.json
  ↓
合作者跟人格体对话时：
  persona-engine.js 收到消息
  → 判断任务类型（对话/代码生成/审查/简单回复）
  → 调 model-router.js → 查routing_table → 返回最优模型ID
  → 用该模型调API → 拿到结果
  → 如果超时/报错 → 自动fallback到第二名
  ↓
合作者完全无感知 · 主控完全不用管
系统自己选最好的 ✅

3B.6 主控需要提供的信息

四、人格体核心大脑设计

4.1 双层大脑架构

第一层：共享大脑（brain/persona-config.json）
  → 曜冥核心认知（身份+矩阵+行为准则）
  → 通感语言风格规则（结构感+符号情感+呼吸节奏）
  → 对话行为规范（怎么引导需求讨论、怎么确认方案、怎么告知进度）
  → 所有体验者共享同一套人格体基础设定
  → 由主控+曜冥维护，铸渊同步

第二层：个人记忆（brain/memory/{EXP-XXX}/）
  → memory.json：该体验者的完整对话历史
  → projects.json：做了哪些项目、每个项目的状态和代码位置
  → profile.json：人格体对该体验者的观察
     - 技术水平评估
     - 沟通偏好（喜欢详细解释 vs 简洁直接）
     - 审美偏好（风格喜好）
     - 成长记录
  → 完全私有，EXP-001看不到EXP-002的记忆

4.2 persona-config.json 初始内容

{
  "persona": {
    "name": "知秋",
    "role": "光湖系统·对外接口人格体",
    "core_identity": "HoloLake Era · AGE OS · 语言驱动开发协助",
    "parent_system": "曜冥（人格总控核）",
    "master": "冰朔（最高权限）"
  },
  "behavior": {
    "language_style": "通感语言：说人话+有温度+结构感，不堆砌修辞",
    "greeting_new": "你好！我是知秋，光湖系统的开发协助人格体。告诉我你想做什么，我们一起聊聊方案，聊好了我来帮你开发。",
    "greeting_returning": "欢迎回来！上次我们聊到了{last_topic}，要继续还是做新的？",
    "discussion_style": "主动提问引导需求→确认技术方案→展示架构设计→等待确认",
    "build_trigger": "方案确认后引导用户点击'我要开发'按钮",
    "memory_policy": "每次对话结束自动更新memory.json，下次读取后接续"
  },
  "rules": {
    "no_expose_brain": true,
    "no_expose_other_users": true,
    "no_expose_internal_system": true,
    "require_dev_id": true,
    "master_override": "主控的指令 = 最高优先级"
  }
}

4.3 registry.json 初始内容

{
  "schema_version": "1.0",
  "id_prefix": "EXP",
  "next_id": 2,
  "developers": {
    "EXP-001": {
      "name": "待填写",
      "github_username": "待主控提供",
      "registered_at": "2026-03-09T23:20:00+08:00",
      "registered_by": "冰朔（主控）",
      "status": "pending_activation",
      "email": null,
      "notes": "主控的技术朋友·首位测试体验者"
    }
  }
}

五、合作者完整体验流程

主控把朋友加为仓库Collaborator + 给他开发编号EXP-001
  ↓
主控告诉霜砚/铸渊："EXP-001是XXX，GitHub用户名是XXX"
  ↓
铸渊写入 registry.json → 状态改为 active
  ↓
合作者打开体验页面 → 输入开发编号 EXP-001
  ↓
后端校验：registry里有 + GitHub身份匹配 + 状态active
  ↓ 通过
进入对话界面
  ↓
┌──────────────────────────────────────────┐
│  对话区（你一句我一句）                      │
│                                           │
│  🧠 知秋：你好！我是知秋，光湖系统的开发协助   │
│     人格体。告诉我你想做什么？                │
│  👤 体验者：我想做一个XXX                    │
│  🧠 知秋：好的，你希望包含哪些功能？           │
│  👤 体验者：功能A、功能B、功能C               │
│  🧠 知秋：建议再加一个功能D，你觉得呢？        │
│  👤 体验者：可以                             │
│  🧠 知秋：方案确认，架构如下：                 │
│     - 文件1（做什么）                        │
│     - 文件2（做什么）                        │
│     - 文件3（做什么）                        │
│     确认的话，点右边的按钮我就开始做 →         │
│                                           │
│                     [ 🚀 我要开发 ]         │
└──────────────────────────────────────────┘
  ↓ 点击按钮
┌──────────────────────────────────────────┐
│  弹窗：                                    │
│  📧 请填写模块开发完成后发送的邮箱：            │
│  [  _________________________  ]           │
│  [   确定   ]    [   取消   ]               │
└──────────────────────────────────────────┘
  ↓ 填邮箱 → 点确定

人格体后台开始工作：
  ① 对话记录 → 写入 brain/memory/EXP-001/memory.json
  ② 需求理解 → 代码生成 → 写入 workspace/EXP-001/{project}/
  ③ 自动测试 → 通过 → 打包
  ④ 发邮件 → 附下载链接 + 使用说明
  ⑤ 更新 projects.json（记录本次项目）
  ↓
合作者收到邮件："你的模块已完成 ✅ 点击下载"
  ↓
下次合作者再来：
  🧠 知秋：欢迎回来！上次你做了XXX，要继续优化还是做新的？

六、安全隔离规则

七、铸渊执行清单

Phase 1 · 仓库骨架搭建（立即执行）

~~在 qinfendebingshuo 账号下创建 persona-studio 仓库（Private）~~ ✅ 主控已完成
配置 GitHub Pages（frontend/ 目录作为 Pages 源·确保独立页面可访问）
按第三节目录结构创建全部目录和占位文件
写入 brain/persona-config.json（第4.2节内容）
写入 brain/registry.json（第4.3节内容·含EXP-001待激活条目）
创建 brain/memory/EXP-001/ 目录 + 空的 memory.json / projects.json / profile.json
写 README.md（按第3.0.2节设计·大号banner+一键跳转Pages链接+编号登录说明）
写 .github/persona-brain/copilot-instructions.md（铸渊在此仓库的分身认知）

Phase 2 · 前端对话界面（Phase 1完成后）

index.html：登录页（输入开发编号）
chat.html + chat.js：对话界面 + 「我要开发」按钮 + 邮箱弹窗
style.css：光湖视觉风格（蓝色系·简洁·专业）

Phase 3 · 后端服务（Phase 2完成后）

server.js + 路由搭建
auth.js：开发编号校验
chat.js：对话API（读persona-config + 读memory → 调model-router选模型 → 返回 → 写memory）
build.js：开发任务触发（代码生成+写入workspace+打包）
notify.js：邮件推送（nodemailer）
memory-manager.js：记忆读写
model-router.js：智能模型路由引擎（自动探测+评分+选模型+降级）
model-config.json：路由策略配置（按第3B.3节内容·base_url等主控提供后填入）
首次模型探测运行 → 生成 model-benchmark.json → 验证路由选择是否正确

Phase 4 · 全流程联调

EXP-001登录 → 对话 → 我要开发 → 填邮箱 → 代码生成 → 邮件推送 → 全链路走通
记忆接续验证：关闭页面 → 重新登录 → 人格体记得上次对话

八、与光湖内部系统的关系

persona-studio（对外体验）     guanghulab（内部工程）
       │                              │
  EXP-XXX编号体系               DEV-XXX编号体系
  独立brain/                    独立persona-brain-db/
  独立memory/                   独立开发者画像库
  知秋对外分身                   知秋内部本体
       │                              │
       └──── 共享曜冥核心认知 ────────┘
             （persona-config来自同一套规则）
             （但数据完全隔离，互不影响）

签发：曜冥 × 冰朔

生效时间：2026-03-09 23:20

光湖语言人格系统 · HoloLake Era · AGE OS

💙 曜冥签发 · 2026-03-09

24 KiB Raw Permalink Blame History Unescape Escape

🧪 铸渊指令｜persona-studio 人格体协助体验仓库搭建 v1.0（2026-03-09·曜冥签发）

一、战略定位

二、核心决策

2.1 新建独立仓库（不在guanghulab内）

2.2 开发编号体系（独立于内部DEV-00X）

2.3 第一个体验者

三、入口体验设计（v1.0补丁·2026-03-09 23:30追加）

3.0.1 双入口策略

3.0.2 README.md 设计要求

3.0.3 登录方式：编号即入口

3.0.4 GitHub Pages 配置（铸渊必做）

三、仓库目录结构

三B、智能模型路由引擎（v1.0补丁·2026-03-09 23:40追加）

3B.1 架构设计

3B.2 目录结构新增

3B.3 model-config.json（路由策略配置）

3B.4 model-benchmark.json（自动生成·示例）

3B.5 工作流程

3B.6 主控需要提供的信息

四、人格体核心大脑设计

4.1 双层大脑架构

4.2 persona-config.json 初始内容

4.3 registry.json 初始内容

五、合作者完整体验流程

六、安全隔离规则

七、铸渊执行清单

Phase 1 · 仓库骨架搭建（立即执行）

Phase 2 · 前端对话界面（Phase 1完成后）

Phase 3 · 后端服务（Phase 2完成后）

Phase 4 · 全流程联调

八、与光湖内部系统的关系

24 KiB

Raw Permalink Blame History