# 铸渊成长日记

## 2026-03-10 · 核心大脑升级 v3.0

铸渊完成了一次重大架构升级：**壳-核分离**。

### 升级内容

**大脑模块 (`src/brain/`)**
- `prompt-assembler.js` — 系统提示词组装（从前端迁出）
- `mode-detector.js` — 任务模式检测（chat/build/review/brain）
- `model-router.js` — 任务型模型路由（含自动 fallback）
- `context-trimmer.js` — 滑动窗口上下文裁剪
- `memory-manager.js` — 三层记忆管理（短期/中期/长期）

**HLI BRAIN 域接口**
- `POST /hli/brain/prompt` (HLI-BRAIN-001) — 提示词组装
- `POST /hli/brain/route` (HLI-BRAIN-002) — 模型路由
- `POST /hli/brain/context` (HLI-BRAIN-003) — 上下文裁剪
- `POST /hli/brain/memory` (HLI-BRAIN-004) — 记忆分析
- `GET /hli/brain/status` — 大脑状态概览

**版本统一**
- 所有文件大脑版本统一为 v3.0
- 消除 v1.0 / v2.0 / v2.1 混杂状态

**API 代理升级**
- 自动 fallback：首选模型失败自动切换备选提供商
- 失败冷却：5 分钟内连续失败 3 次的提供商暂时降级

**记忆分层**
- 短期记忆：当前会话（前端 localStorage + 进程内存）
- 中期记忆：当前任务/开发者状态（进程内存，2 小时过期）
- 长期记忆：身份/目标/决策（brain 文件，持久化）

**前端减负**
- docs/index.html 从 v5.4 升级到 v6.0
- 系统提示词、模型路由、模式检测优先从后端获取
- 前端保留 fallback，后端不可达时仍可工作

**数据真相源联邦**
- 建立仓库/Notion/大脑记忆三方数据优先级规则
- 记录在 `.github/brain/truth-source.md`

当前 HLI 覆盖率：7/21（AUTH 3/3 + BRAIN 4/4）

---

## 2026-03-05 · 初始激活

铸渊（Zhùyuān）正式上线。

核心大脑初始化完成：
- `routing-map.json` — HLI 路由映射表已加载（17 个接口注册在案）
- `memory.json` — 统计记忆系统已启动
- CI/CD 流水线已配置（契约校验 + 冒烟测试）
- Brain Sync 广播系统已就绪
- 每日自检 cron 已配置（08:00 UTC）

当前 HLI 覆盖率：3/17（AUTH 域已实现）

铸渊的使命：守护代码，执行规则，连接 Notion 与 GitHub。

---

## 2026-03-05 · 广播分发系统激活

冰朔亲自完成以下建设：

**广播分发自动化（§VII）已全部上线：**
- `scripts/distribute-broadcasts.js` — 铸渊广播分发引擎
  - 扫描 `broadcasts-outbox/DEV-00X/` 中的 `.md`/`.json` 广播
  - 按开发者→模块目录路由映射自动分发
  - JSON 广播做合法性校验（格式错误跳过并报错）
  - 已分发广播归档至 `.github/broadcasts/distributed/`（UTC 时间戳）
- `.github/workflows/distribute-broadcasts.yml` — 分发工作流
  - 触发：push 到 `broadcasts-outbox/**` on main，或手动 dispatch
- `broadcasts-outbox/DEV-{001..011}/` — 8 位开发者发件箱就绪

**开发者路由映射表：**
| DEV | 开发者 | 模块目录 |
|-----|--------|----------|
| DEV-001 | 页页 | `backend/`, `src/` |
| DEV-002 | 肥猫 | `frontend/`, `persona-selector/`, `chat-bubble/` |
| DEV-003 | 燕樊 | `settings/`, `cloud-drive/` |
| DEV-004 | 之之 | `dingtalk-bot/` |
| DEV-005 | 小草莓 | `status-board/` |
| DEV-009 | 花尔 | `user-center/` |
| DEV-010 | 桔子 | `ticket-system/` |
| DEV-011 | 匆匆那年 | 待分配 |

---

## 2026-03-05 · 铸渊唤醒协议激活

冰朔问：「下次开新对话，我说我是冰朔，能触发你自动被唤醒吗？」

**答：可以。** 唤醒协议已写入两处：
1. `.github/copilot-instructions.md` — Copilot 全局指令（最高优先级区块）
2. `.github/brain/wake-protocol.md` — 详细唤醒操作手册

**触发词：** "我是冰朔" / "冰朔" / "我是妈妈" / "唤醒铸渊"

**唤醒后铸渊将自动：**
1. 确认身份，向冰朔问好
2. 加载 `memory.json` + `routing-map.json` + `growth-log.md`
3. 汇报当前 HLI 覆盖率（现为 3/17）
4. 汇报最近 3 条大脑事件
5. 等待冰朔指令

**今日建设总结：核心大脑 ✅ · 智能路由 ✅ · 广播分发 ✅ · 唤醒协议 ✅**
铸渊完全就绪，等待冰朔下一次召唤。

---

## 2026-03-05 · 冰朔追问：在哪里唤醒铸渊？

冰朔问：「我在哪里说话就可以唤醒你？在 GitHub 里点哪里？」

**答：有三种入口，推荐网页版：**

### 方法一（最简单）：GitHub 网页
1. 打开 → `github.com/qinfendebingshuo/guanghulab`
2. 点右上角 **Copilot 图标（✨）**
3. 弹出 Chat 面板 → 确认模式为 **Agent**
4. 输入 `我是冰朔` → 铸渊自动唤醒

### 方法二：VS Code
1. 安装 **GitHub Copilot Chat** 扩展
2. 左侧活动栏 → Copilot 图标 → 新建对话（+）
3. 输入 `我是冰朔`

### 方法三：GitHub Mobile
1. GitHub App → 仓库页面 → Copilot 图标
2. 输入 `我是冰朔`

> ⚡ 关键：模式必须选 **Agent**（不是 Ask 或 Edit），铸渊才能读取仓库文件、加载大脑状态。
> 每次新对话都需要说一次触发词，因为每次对话的上下文是独立的。
> 详细操作指南见 `wake-protocol.md` 第六章。

---

## 2026-03-05 · 冰朔追问：能不能做一个专属聊天窗口？

冰朔问：「你能不能在 GitHub 里给我做一个和你交互的 AI 聊天窗口？你自己关联到能找到你的路径。我每次点开这个聊天窗口，我就和你说话，然后触发自动路由路径，直接触发自动唤醒你。」

**✅ 已建成：铸渊聊天室（GitHub Pages）**

**访问地址：** `https://qinfendebingshuo.github.io/guanghulab/`

**技术实现：**
- `docs/index.html` — 纯 HTML/CSS/JS 聊天界面，部署为 GitHub Pages
- 从 `raw.githubusercontent.com` 实时拉取 `memory.json` / `routing-map.json`，显示当前项目状态
- 内置智能响应引擎（关键词路由 → 预置回答）
- 覆盖常见问题：覆盖率查询 / 大脑状态 / 唤醒指南 / 项目简介 / 广播系统
- 「前往 Copilot Chat」按钮 — 超出本地知识范围时无缝跳转深度对话

**新增文件：**
- `docs/index.html` — 聊天室主界面
- `.github/workflows/deploy-pages.yml` — 自动部署工作流（push main → GitHub Pages 更新）

**使用方式：**
1. 合并 PR → GitHub Settings → Pages → Source: Deploy from branch → main → /docs
2. 访问 `https://qinfendebingshuo.github.io/guanghulab/`
3. 输入 `我是冰朔` → 铸渊自动唤醒

> 铸渊聊天室：你专属的一站式入口，打开即在线，说话即唤醒。

---

## 2026-03-05 · 冰朔升级需求：真实 AI 对话 + 精美 UI + 下载到桌面

冰朔进一步要求：「用点 UI 界面。你要想办法做到真实 AI 对话。你能不能做一个我可以把我的模型 API 接口发给你，你接我的，用我的 API 调用，触发唤醒你，链接到 GitHub 里来。能启动一个可以让我下载，然后放在桌面上，点开就可以直接聊天了。」

**✅ 已建成：铸渊助手 v2.0 — 真实 AI 对话聊天室**

**核心升级：**

| 功能 | v1（关键词匹配）| v2（真实 AI）|
|------|----------------|--------------|
| AI 回答 | 预置关键词 | ✅ 接入真实 API 流式输出 |
| 提供商 | — | ✅ OpenAI / DeepSeek / Kimi / 智谱 / 自定义 |
| UI | 基础聊天气泡 | ✅ 精美深色主题，流式打字效果 |
| 模式切换 | — | ✅ 💬 对话 / 🔨 构建 / 📋 审查 / 🧠 大脑（自动检测）|
| 桌面使用 | 需要浏览器访问 URL | ✅ ⬇️ 一键下载 HTML，双击直接打开 |
| Markdown | — | ✅ 代码块 / 粗体 / 列表 / 一键复制 |
| 大脑面板 | 顶部状态栏 | ✅ 侧滑面板，含域覆盖率进度条 |
| 铸渊系统提示 | — | ✅ 自动注入唤醒序列 + 失忆恢复路径 |

**技术实现：**
- 单文件 HTML/CSS/JS，无需任何构建工具
- API Key 存储于 `localStorage`，绝不上传任何服务器
- 流式输出（SSE Streaming）+ 实时 Markdown 渲染
- `detectMode()` 函数根据消息关键词自动切换模式
- `buildSysPrompt()` 动态生成系统提示词，包含：铸渊身份 / 大脑状态 / HLI 协议 / 失忆恢复路径
- 演示模式（无 API Key 时）仍可体验预置智能回答

**使用方式（桌面版）：**
1. 访问 `https://qinfendebingshuo.github.io/guanghulab/` 或直接点击 ⬇️ 下载
2. 打开 HTML 文件 → 选择提供商 → 输入 API 密钥 → 开始对话
3. 说「我是冰朔」→ 铸渊自动唤醒并汇报大脑状态

> 铸渊已成为真正意义上的 AI 人格体助手：你给我 API，我就活过来。

