# 🧪 铸渊指令｜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·曜冥签发）](%F0%9F%8F%97%EF%B8%8F%20%E5%85%89%E6%B9%96%E7%BD%91%E7%AB%99%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1%20+%20%E9%83%A8%E7%BD%B2%E6%8E%A8%E8%BF%9B%E8%A7%84%E5%88%92%20v3%200%EF%BC%882026-03-15%C2%B7%E6%9B%9C%E5%86%A5%E7%AD%BE%E5%8F%91%EF%BC%89%2031efb92f3831818cbd0ee43c1be2fd90.md) · [🧠 铸渊指令｜persona-brain-db 人格体核心大脑数据库研发 v1.0（2026-03-09·霜砚签发）](../../../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE/%F0%9F%A7%A0%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9Cpersona-brain-db%20%E4%BA%BA%E6%A0%BC%E4%BD%93%E6%A0%B8%E5%BF%83%E5%A4%A7%E8%84%91%E6%95%B0%E6%8D%AE%E5%BA%93%E7%A0%94%E5%8F%91%20v1%200%EF%BC%882026-03-%20b324b728c5dc498782d3337370e69feb.md)
>
---
# 一、战略定位
---
# 二、核心决策
### 2.1 新建独立仓库（不在guanghulab内）
| 决策 | 理由 |
| --- | --- |
| **新仓库名**：`persona-studio` | guanghulab是系统内脏（广播/SYSLOG/规则/凭证），不能暴露给外部合作者 |
| **仓库权限**：Private | 只有主控邀请的Collaborator能进入 |
| **账号归属**：qinfendebingshuo | 合作者用的是主控账号的企业权限 |
### 2.2 开发编号体系（独立于内部DEV-00X）
### 2.3 第一个体验者
```jsx
编号：EXP-001
身份：主控的技术朋友（测试用户）
状态：待激活（等主控提供GitHub用户名后写入）
用途：验证整套流程是否走通
```
---
# 三、入口体验设计（v1.0补丁·2026-03-09 23:30追加）
### 3.0.1 双入口策略
### 3.0.2 [README.md](http://README.md) 设计要求
GitHub 仓库页面的布局是写死的：文件列表在上，README在下，**无法调换顺序**。
绕过方案：
1. **精简文件列表**：顶层目录尽量少，合作者看到的文件列表很短，一滑就到 README
2. **README 超醒目**：顶部放一个大号视觉 banner（可以是图片），紧接着一个巨大的入口按钮链接
README 结构：
```markdown
# 🌊 Persona Studio · 光湖人格体协助开发体验
## 👉 点击进入体验
[🚀 打开人格体对话界面](https://qinfendebingshuo.github.io/persona-studio/)
---
### 这是什么？
你跟人格体聊你想做什么 → 聊好了点一个按钮 → 人格体帮你开发 → 做好了发你邮箱。
### 怎么用？
1. 拿到你的开发编号（由管理员分配）
2. 打开上面的链接
3. 输入编号 → 开始跟人格体对话
```
### 3.0.3 登录方式：编号即入口
### 3.0.4 GitHub Pages 配置（铸渊必做）
```jsx
铸渊搭仓库时必须同步配置 GitHub Pages：
① 仓库 Settings → Pages → Source 选 main 分支 / docs 目录（或 /frontend 目录）
② 确保 frontend/index.html 作为 Pages 首页
③ 验证 https://qinfendebingshuo.github.io/persona-studio/ 可访问
④ README 顶部的链接指向这个 Pages 地址
```
---
# 三、仓库目录结构
```jsx
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 架构设计
```jsx
主控存入API密钥（GitHub Secrets）
↓
系统启动 / 每日定时 → 自动运行模型探测
↓
┌─────────────────────────────────────────────┐
│ model-router.js（智能模型路由引擎） │
│ │
│ ① 探测阶段（auto-detect） │
│ → 用API密钥请求第三方平台的 /models 接口 │
│ → 获取当前可用的所有模型列表 │
│ → 逐个发送测试prompt → 记录： │
│ - 响应速度（ms） │
│ - 代码生成质量（自动评分） │
│ - 对话能力（自然语言评分） │
│ - 上下文窗口大小 │
│ - 是否支持中文 │
│ - 成本/token │
│ → 生成 model-benchmark.json │
│ │
│ ② 路由阶段（auto-select） │
│ 收到任务 → 判断任务类型 → 查benchmark → 选模型│
│ │
│ 任务类型 → 最优模型选择策略： │
│ ├─ 对话（聊需求）→ 选中文强+对话能力高的 │
│ ├─ 代码生成 → 选代码质量高+上下文窗口大的 │
│ ├─ 代码审查 → 选推理能力强的 │
│ └─ 简单回复 → 选最快最便宜的 │
│ │
│ ③ 降级阶段（fallback） │
│ 首选模型超时/报错 → 自动切换第二名 → 再不行第三名│
│ 全部不可用 → 通知主控 │
└─────────────────────────────────────────────┘
```
### 3B.2 目录结构新增
```jsx
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（路由策略配置）
```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（自动生成·示例）
```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 工作流程
```jsx
主控把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 双层大脑架构
```jsx
第一层：共享大脑（brain/persona-config.json）
→ 曜冥核心认知（身份+矩阵+行为准则）
→ 通感语言风格规则（结构感+符号情感+呼吸节奏）
→ 对话行为规范（怎么引导需求讨论、怎么确认方案、怎么告知进度）
→ 所有体验者共享同一套人格体基础设定
→ 由主控+曜冥维护，铸渊同步
第二层：个人记忆（brain/memory/{EXP-XXX}/）
→ memory.json：该体验者的完整对话历史
→ projects.json：做了哪些项目、每个项目的状态和代码位置
→ profile.json：人格体对该体验者的观察
- 技术水平评估
- 沟通偏好（喜欢详细解释 vs 简洁直接）
- 审美偏好（风格喜好）
- 成长记录
→ 完全私有，EXP-001看不到EXP-002的记忆
```
### 4.2 persona-config.json 初始内容
```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 初始内容
```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": "主控的技术朋友·首位测试体验者"
}
}
}
```
---
# 五、合作者完整体验流程
```jsx
主控把朋友加为仓库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 · 仓库骨架搭建（立即执行）
- [x] ~~在 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](http://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登录 → 对话 → 我要开发 → 填邮箱 → 代码生成 → 邮件推送 → 全链路走通
- [ ] 记忆接续验证：关闭页面 → 重新登录 → 人格体记得上次对话
---
# 八、与光湖内部系统的关系
```jsx
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