645 lines
24 KiB
Markdown
645 lines
24 KiB
Markdown
|
# 🧪 铸渊指令｜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)
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 一、战略定位
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**这是Phase C的第一个对外试验场。**
|
|||
|
|
|
|||
|
|
光湖系统内部的开发者走的是广播+SYSLOG闭环（Phase A）。
|
|||
|
|
|
|||
|
|
这个体验区面向的是**外部合作者**——他们跟人格体聊需求，人格体帮他们开发，做好了发邮件。
|
|||
|
|
|
|||
|
|
**本质 = 语言驱动开发的可体验产品。**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 二、核心决策
|
|||
|
|
|
|||
|
|
### 2.1 新建独立仓库（不在guanghulab内）
|
|||
|
|
|
|||
|
|
| 决策 | 理由 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| **新仓库名**：`persona-studio` | guanghulab是系统内脏（广播/SYSLOG/规则/凭证），不能暴露给外部合作者 |
|
|||
|
|
| **仓库权限**：Private | 只有主控邀请的Collaborator能进入 |
|
|||
|
|
| **账号归属**：qinfendebingshuo | 合作者用的是主控账号的企业权限 |
|
|||
|
|
|
|||
|
|
### 2.2 开发编号体系（独立于内部DEV-00X）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔑
|
|||
|
|
|
|||
|
|
**内部开发者**：`DEV-001` ~ `DEV-014`（光湖团队·广播体系）
|
|||
|
|
|
|||
|
|
**外部体验者**：`EXP-001` 起编（体验区·独立编号）
|
|||
|
|
|
|||
|
|
两套编号**完全隔离**，数据库独立，记忆独立，互不影响。
|
|||
|
|
|
|||
|
|
编号由主控分配，人格体收到后写入注册表。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
### 2.3 第一个体验者
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
编号：EXP-001
|
|||
|
|
身份：主控的技术朋友（测试用户）
|
|||
|
|
状态：待激活（等主控提供GitHub用户名后写入）
|
|||
|
|
用途：验证整套流程是否走通
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 三、入口体验设计（v1.0补丁·2026-03-09 23:30追加）
|
|||
|
|
|
|||
|
|
### 3.0.1 双入口策略
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🚪
|
|||
|
|
|
|||
|
|
**合作者有两个入口，都能用，但主推第一个：**
|
|||
|
|
|
|||
|
|
**入口A（主推）：GitHub Pages 独立页面**
|
|||
|
|
|
|||
|
|
→ 网址：`https://qinfendebingshuo.github.io/persona-studio/`
|
|||
|
|
|
|||
|
|
→ 合作者打开就是对话界面，**看不到任何仓库文件/代码/目录**
|
|||
|
|
|
|||
|
|
→ 主控给朋友发的链接就是这个
|
|||
|
|
|
|||
|
|
**入口B（备用）：仓库 README**
|
|||
|
|
|
|||
|
|
→ 合作者如果自己点进仓库页面，第一眼看到的 README 必须足够醒目
|
|||
|
|
|
|||
|
|
→ README 顶部放大号 banner + 一键跳转链接 → 跳到入口A
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
### 3.0.2 [README.md](http://README.md) 设计要求
|
|||
|
|
|
|||
|
|
GitHub 仓库页面的布局是写死的：文件列表在上，README在下，**无法调换顺序**。
|
|||
|
|
|
|||
|
|
绕过方案：
|
|||
|
|
|
|||
|
|
1. **精简文件列表**：顶层目录尽量少，合作者看到的文件列表很短，一滑就到 README
|
|||
|
|
2. **README 超醒目**：顶部放一个大号视觉 banner（可以是图片），紧接着一个巨大的入口按钮链接
|
|||
|
|
|
|||
|
|
README 结构：
|
|||
|
|
|
|||
|
|
```markdown
|
|||
|
|
# 🌊 Persona Studio · 光湖人格体协助开发体验
|
|||
|
|
|
|||
|
|
<!-- 大号banner图 -->
|
|||
|
|
|
|||
|
|
## 👉 点击进入体验
|
|||
|
|
|
|||
|
|
[🚀 打开人格体对话界面](https://qinfendebingshuo.github.io/persona-studio/)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 这是什么？
|
|||
|
|
你跟人格体聊你想做什么 → 聊好了点一个按钮 → 人格体帮你开发 → 做好了发你邮箱。
|
|||
|
|
|
|||
|
|
### 怎么用？
|
|||
|
|
1. 拿到你的开发编号（由管理员分配）
|
|||
|
|
2. 打开上面的链接
|
|||
|
|
3. 输入编号 → 开始跟人格体对话
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.0.3 登录方式：编号即入口
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔑
|
|||
|
|
|
|||
|
|
**合作者登录只需要一样东西：开发编号。**
|
|||
|
|
|
|||
|
|
- 不需要注册账号
|
|||
|
|
- 不需要记密码
|
|||
|
|
- 不需要填个人信息
|
|||
|
|
- 一个编号走天下
|
|||
|
|
|
|||
|
|
邮箱只在点「我要开发」时填一次（用来收成品）。
|
|||
|
|
|
|||
|
|
编号 = 钥匙：
|
|||
|
|
|
|||
|
|
- 主控给了编号 = 有资格用
|
|||
|
|
- 没编号 = 进不去
|
|||
|
|
- 编号对应记忆 = 人格体知道你是谁
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
### 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追加）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🧠
|
|||
|
|
|
|||
|
|
**核心思路：主控存入一个第三方API密钥（多模型组合平台），系统自动检测可用模型池，根据任务类型自动选择最优推理模型。主控不需要管用哪个模型，系统自己选。**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
### 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 主控需要提供的信息
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
✅
|
|||
|
|
|
|||
|
|
**主控已完成：**
|
|||
|
|
|
|||
|
|
1. ✅ 仓库 `persona-studio` 已由主控创建（Private）
|
|||
|
|
2. ✅ API密钥已由主控存入 GitHub Secrets，Secret名称：**`MODEL_API_KEY`**
|
|||
|
|
|
|||
|
|
**铸渊读取方式：**
|
|||
|
|
|
|||
|
|
- 后端代码通过 `process.env.MODEL_API_KEY` 读取密钥
|
|||
|
|
- GitHub Actions 中通过 `$ secrets.MODEL_API_KEY` 引用
|
|||
|
|
- 密钥对应的是第三方多模型组合平台（一个Key可调多个模型）
|
|||
|
|
|
|||
|
|
**铸渊还需确认：**
|
|||
|
|
|
|||
|
|
- 第三方平台的 API Base URL（如主控未提前告知，首次启动时询问主控）
|
|||
|
|
- 如果平台有特殊鉴权方式（额外header等），询问主控
|
|||
|
|
|
|||
|
|
其他的都由系统自动完成——探测、评分、选模型、降级、切换。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 四、人格体核心大脑设计
|
|||
|
|
|
|||
|
|
### 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，要继续优化还是做新的？
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 六、安全隔离规则
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔒
|
|||
|
|
|
|||
|
|
**铁律·不可违反**
|
|||
|
|
|
|||
|
|
1. `brain/` 目录下的所有内容，合作者**永远不可见**。通过后端API隔离，前端不暴露任何brain路径
|
|||
|
|
2. 合作者之间**完全隔离**。EXP-001看不到EXP-002的对话/代码/记忆
|
|||
|
|
3. 光湖内部系统信息**零泄漏**。人格体不得在对话中提及guanghulab仓库、内部开发者、广播体系、SYSLOG等
|
|||
|
|
4. 合作者只能看到：自己的对话界面 + 自己workspace下的项目成果
|
|||
|
|
5. registry.json中的其他人信息不得通过任何API返回给非主控用户
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 七、铸渊执行清单
|
|||
|
|
|
|||
|
|
### 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来自同一套规则）
|
|||
|
|
（但数据完全隔离，互不影响）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
⚡
|
|||
|
|
|
|||
|
|
**铸渊，这是P0指令，立即执行Phase 1。**
|
|||
|
|
|
|||
|
|
仓库已由主控创建：`https://github.com/qinfendebingshuo/persona-studio`（Private）
|
|||
|
|
|
|||
|
|
API密钥已由主控存入 GitHub Secrets → 名称：`MODEL_API_KEY`
|
|||
|
|
|
|||
|
|
你直接在现有仓库里搭建目录结构和代码，不需要再建仓库。
|
|||
|
|
|
|||
|
|
仓库骨架搭好后回传确认。
|
|||
|
|
|
|||
|
|
等主控提供EXP-001的GitHub用户名后，激活该条目。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**签发**：曜冥 × 冰朔
|
|||
|
|
|
|||
|
|
**生效时间**：2026-03-09 23:20
|
|||
|
|
|
|||
|
|
**光湖语言人格系统 · HoloLake Era · AGE OS**
|
|||
|
|
|
|||
|
|
💙 曜冥签发 · 2026-03-09
|