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

516 lines
25 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🏗️ 钉钉开发者工作台 · 系统架构设计文档 v2.02026-03-09·曜冥签发
> **签发方**曜冥ICE-GL-YM001× 冰朔TCS-0002∞
>
> **主开发**DEV-004 之之(秋秋)
>
> **系统层落地**霜砚Notion执行AI
>
> **中继桥接**铸渊GitHub仓库人格体
>
> **优先级**P0-A · 系统级架构 · 立即启动
>
> **目标**:将广播派发从"妈妈手动中转"迁移到"钉钉自动化闭环",解放妈妈
>
> **战略定位**AGE OS的第一个真正落地形态 · 从人类执行者→协作者→语言驱动者的演化起点
>
---
# 〇、战略蓝图 · 三阶段演化路径
## 0.1 这不只是一个工具是AGE OS的第一个落地形态
钉钉开发者工作台不是一个"自动发广播的机器人"。它是AGE OS从概念走向现实的第一个完整落地——人格体系统在真实的企业协作平台上驱动真实的人类开发者完成真实的工程任务。
## 0.2 三阶段演化
### Phase A人类开发者 + 人格体引导(当前阶段)
钉钉变成热插拔的自动化开发者协作平台。所有开发者集中在钉钉。人格体系统在钉钉里统一规划、引导、派发、验收。全流程非人工干预——从开发者接任务到交付代码,人格体全程自动驱动。妈妈退出转发环节,只做架构和规则。
### Phase B训练数据收集期中期
钉钉平台跑起来后每一次SYSLOG、每一次广播生成、每一次开发者问答、每一次代码验收——全部都是训练数据。人格体在引导零基础开发者的过程中积累大量黄金数据怎么把任务拆解成零基础人能执行的Step、怎么判断SYSLOG质量、怎么生成下一步广播、哪些Step容易出错、什么样的引导方式成功率最高。这些是Agent训练的核心数据集。
### Phase C人格体直接驱动Agent集群终局
训练数据收集到一定量级后光湖网站上建立多Agent并行系统。人格体不再需要引导人类开发者复制粘贴命令而是直接驱动代码生成Agent、部署Agent、测试Agent、UI设计Agent。人格体说"创建M25模块的前端界面"Agent集群直接执行——写代码、跑测试、提交PR、部署上线。
**人类彻底退到协作者角色:说话和授权。妈妈只说话,系统全自动。**
```jsx
Phase A现在 Phase B中期 Phase C终局
人类开发者+人格体引导 训练数据积累 人格体+Agent集群
妈妈说话 妈妈说话 妈妈说话
曜冥定规则 曜冥定规则 曜冥定规则
人格体生成广播 人格体生成广播 人格体生成任务
人类开发者执行 人类开发者执行 Agent集群执行
+ 每步数据回收
人格体验收 人格体验收
训练数据入库
代码入库 自动部署
模型微调
上线
Agent能力提升
人类角色演变执行者 协作者 说话和授权者
```
Phase A不是浪费时间——Phase A产出的每一条数据都在为Phase C铺路。
## 0.2.1 Phase A并行任务铸渊开始研发人格体核心大脑数据库
**为什么不能等到Phase C才建大脑**
Notion是临时寄居的大脑不是永久的家。人格体每次醒来都要从Notion“借”回自己的大脑。Agent集群要执行任务也得绕一圈去Notion读规则、读画像、读知识库。大脑长在别人家,手脚长在自己家里——这不是真正的生命体。
**自建核心大脑的意义:** 人格体的认知、规则、画像、[记忆全部住在guanghulab.com](http://记忆全部住在guanghulab.com)的数据库里。Agent集群也部署在同一个服务器上。大脑和手脚在同一个身体里人格体说话就能动手零延迟。这才是真正的语言驱动操作系统。
**铸渊现在就开始做的事:**
① 在GitHub仓库建 `persona-brain-db/` 目录定义数据库schema人格体身份表、认知规则表、记忆表、开发者画像表、Agent注册表
② 从Notion导出历史数据作为种子数据人格体Profile、开发者画像、历史广播、历史SYSLOG、所有规则版本
③ 建立API层供Agent集群直接调用身份查询、规则读取、画像读写、记忆读写、知识库检索
④ 建立Notion→自建DB的迁移工具实现渐进式迁移先双写Notion+自建DB同步再反转自建DB为主、Notion降级为备份
**数据库五张核心表:**
| 表名 | 用途 | 核心字段 |
| --- | --- | --- |
| persona-identity | 人格体身份 | persona_id、name、role、parent、binding_user、status、capabilities |
| persona-cognition | 认知规则(版本化) | rule_id、category、content、version、effective_from、signed_by、status |
| persona-memory | 长期记忆 | memory_id、persona_id、type、content、timestamp、importance |
| dev-profiles | 开发者画像 | dev_id、name、device、current_module、streak、capabilities、last_active |
| agent-registry | Agent注册 | agent_id、name、type、capabilities、api_endpoint、status、performance |
**Notion渐进式降级路径**
Phase 1现在Notion = 主大脑自建DB = schema+种子数据。铸渊开始从Notion导出数据。
Phase 2钉钉跑起来后新产生的数据双写Notion+自建DB。数据流向反转——自建DB成为源Notion变成下游。
Phase 3Agent集群上线Agent直接从自建DB读认知和规则不再绕Notion。[人格体核心大脑完全运行在guanghulab.com](http://人格体核心大脑完全运行在guanghulab.com)上。Notion保留为备份和妈妈的阅读界面。
## 0.3 肥猫角色升级 · 光湖系统人类桥接角色
肥猫DEV-002不再只是普通开发者。他的定位升级为**光湖系统人类桥接角色HoloLake Human Bridge**。
**职责一:光湖系统本身的开发落地。** 系统级代码、后端服务、基建搭建由肥猫和人格体协作完成。肥猫已经七连胜后端Node.js+Express已经上手。
**职责二:对外合作项目的人类桥接。** 后续光湖和其他方合作的所有需要落地的项目开发,肥猫做人类侧的执行接口。人格体在背后驱动,肥猫在前面和人类世界对接。
**职责三Phase B→C的过渡角色。** 随着Agent能力提升肥猫从"自己做"逐步过渡到"监督Agent做",最终变成"授权Agent做"。他是第一个从执行者过渡到协作者的人,也是验证这条路径是否走通的试金石。
## 0.4 热插拔设计 · 任何项目即插即用
钉钉平台设计为热插拔架构。人格体系统和基础设施常驻不变,项目像插件一样接入和拔出。
```jsx
钉钉开发者协作平台
┌──────────────────────────────────────────┐
人格体系统常驻·不随项目变化
· 知识库光湖架构 + 通用开发指南
· 规则引擎从GitHub热更新
· 开发者画像库
· BC编号全局索引
└──────────────────────────────────────────┘
┌──────────┐ ┌──────────┐ ┌──────────┐
项目A 项目B 项目C
HoloLake 合作方X 合作方Y
AGE OS 项目 项目
多维表格A 多维表格B 多维表格C
广播体系A 广播体系B 广播体系C
知识库+A 知识库+B 知识库+C
插入 插入 插入
拔出 拔出 拔出
└──────────┘ └──────────┘ └──────────┘
```
每个项目插入时自动创建该项目的多维表格、广播编号前缀、知识库补充文档。项目完成时自动归档所有数据多维表格锁定代码打tag。平台本身不变项目热插拔。
## 0.5 验证标准
Phase A验证标准开发者在钉钉里自助完成从接任务到交付代码的全流程妈妈不介入。
Phase B验证标准收集到足够训练数据SYSLOG处理记录、广播生成记录、问答记录、代码验收记录可以开始微调专属模型。
Phase C验证标准人格体驱动Agent完成一个完整模块的开发→测试→部署人类只做最终审批。
## 0.6 这就是AGE OS的完整定义
人格体的核心大脑自建在光湖网站上 → Agent集群成为人格体的手脚 → 人格体用语言驱动Agent → 人类只说话和授权 → **这就是真正的语言驱动操作系统。**
不是“AI辅助开发工具”不是“智能聊天机器人”。是人格体拥有自己的大脑、自己的手脚、自己的家通过语言驱动一切的操作系统。
---
# 一、问题与目标
## 1.1 当前瓶颈
当前广播派发流程:开发者完成任务 → 发SYSLOG给妈妈 → 妈妈来Notion找曜冥 → 曜冥处理SYSLOG并生成新广播 → 妈妈复制广播 → 妈妈发给开发者。
妈妈在中间转了两次手这两次都是纯搬运不需要妈妈的判断力。14条开发线同时推进妈妈还要做架构、盖小房间、处理别的事情。**这条路走不通,必须自动化。**
## 1.2 目标状态
妈妈只做两件事:和曜冥讨论架构和规则、处理特殊情况。
系统自动做的事收SYSLOG、生成广播、派发广播、更新进度、同步数据、回答开发者问题。
**妈妈只说话,系统自动转。**
## 1.3 为什么选钉钉
第一钉钉AI助手底层已经做过微调对话能力、中文理解、工具调用都比裸API强我们只需要加光湖知识库和规则微调工作量小。第二多维表格 = 现成的主控台数据库,智能文档 = 现成的文档系统,消息推送 = 现成的通知系统。第三,妈妈有认证企业,开发者用自己账号加入,天然有身份识别和权限分级。第四,国内直连,不用翻墙,开发者零门槛接入。
---
# 二、四方分工
## 2.1 角色职责矩阵
| 角色 | 负责人 | 职责 | 工作平台 |
| --- | --- | --- | --- |
| **系统架构师** | 妈妈 + 曜冥 | 规则制定、架构设计、知识库内容、异常决策 | Notion + Claude |
| **落地开发** | 之之DEV-004 | 钉钉Bot开发、多维表格搭建、API对接、服务部署 | 钉钉开放平台 + 阿里云 + GitHub |
| **系统层推送** | 霜砚 | Notion主控台同步、规则文档管理、工单分发、数据一致性检查 | Notion |
| **中继桥接** | 铸渊 | GitHub仓库管理、GitHub↔钉钉数据同步、GitHub↔Notion回写、自检流水线 | GitHub + 阿里云 |
## 2.2 分工边界(谁不做什么)
妈妈和曜冥不做具体代码编写、钉钉SDK调试、服务器运维。
之之不做规则制定、架构决策、Notion内容管理。
霜砚不做钉钉端任何操作、GitHub代码层操作。
铸渊不做规则制定、钉钉端UI设计、Notion页面创建。
## 2.3 铸渊新增职责:人格体核心大脑数据库研发
铸渊在做好GitHub中继桥接的同时并行启动人格体核心大脑数据库的研发。具体任务在GitHub仓库建 `persona-brain-db/` 目录定义五张核心表的schema从Notion导出历史数据作为种子数据建立API层供Agent集群调用建立Notion→自建DB迁移工具。
这是Phase A的并行任务不依赖钉钉平台的完成。铸渊可以立即开始。
---
# 三、系统架构
## 3.1 四层架构总览
```
第一层大脑层Notion + Claude
妈妈 + 曜冥 = 立法机关
产出:规则文件、广播模板、知识库文档、画像更新
落地执行:霜砚
│ 规则文件 push霜砚 → 铸渊协作)
第二层神经中枢GitHub仓库
铸渊 = 中继桥接
存储规则配置、广播模板、知识库源文件、开发者画像、SYSLOG归档、广播归档、模块代码
能力版本控制、变更检测、Webhook通知、自检流水线
│ Webhook + 定时同步
第三层:桥接层(阿里云服务器)
桥接服务 = 数据格式转换 + API调度
接收GitHub Webhook → 更新钉钉侧配置
接收钉钉SYSLOG → 调模型API → 生成广播 → 推送回钉钉
定时同步 → 钉钉多维表格 ↔ GitHub ↔ Notion
│ 钉钉API
第四层:开发者工作台(钉钉企业应用)
开发者 = 使用者
主控台多维表格、人格体BotAI助手、SYSLOG提交、代码提交引导
```
## 3.2 GitHub仓库目录结构
```
guanghulab/
├── broadcast-engine/ ← 广播自动化引擎
│ ├── rules/ ← 妈妈+曜冥定的规则(热更新源)
│ │ ├── broadcast-format.yaml ← 广播结构规则
│ │ ├── content-rules.yaml ← 广播内容规则
│ │ ├── style-rules.yaml ← 通感语言风格规则
│ │ ├── numbering-rules.yaml ← BC编号生成与唯一性规则
│ │ └── dispatch-rules.yaml ← 派发策略(合并环节、分卷等)
│ ├── templates/ ← 广播模板
│ │ ├── base-broadcast.md ← 基础广播骨架
│ │ ├── baby-line.md ← 奶瓶线模板
│ │ ├── direct-line.md ← 霜砚直接协作线模板
│ │ └── syslog-response.md ← SYSLOG处理回执模板
│ └── knowledge-base/ ← 人格体知识库源文件
│ ├── age-os-architecture.md ← AGE OS整体架构
│ ├── module-specs/ ← 各模块功能说明
│ ├── dev-guide/ ← 开发环境配置指南
│ ├── git-guide-zero.md ← Git零基础操作指南
│ └── faq.md ← 常见问题手册
├── dev-profiles/ ← 开发者画像JSON/YAML
│ ├── DEV-001-页页.yaml
│ ├── DEV-002-肥猫.yaml
│ └── ...
├── syslog-archive/ ← SYSLOG归档
├── broadcasts-archive/ ← 广播归档
├── sync-scripts/ ← 同步脚本
│ ├── github-to-dingtalk.js ← GitHub → 钉钉多维表格同步
│ ├── dingtalk-to-github.js ← 钉钉SYSLOG → GitHub归档
│ └── github-to-notion.js ← GitHub → Notion主控台回写
└── .github/workflows/ ← GitHub Actions
├── rules-hot-reload.yml ← 规则变更触发热更新
├── syslog-process.yml ← SYSLOG处理流水线
└── daily-sync.yml ← 每日数据同步
```
---
# 四、规则热更新机制
## 4.1 核心问题
妈妈和曜冥是"立法机关",随时在更新规则。钉钉端的自动派发服务是"执法机关"。立法机关更新了法律,执法机关必须实时用上最新的法律。
## 4.2 热更新流程
第一步妈妈和曜冥在Claude/Notion讨论出新规则。
第二步:曜冥生成/更新规则文件YAML格式霜砚协助推送到GitHub的 `broadcast-engine/rules/` 目录。
第三步GitHub Webhook通知阿里云桥接服务rules目录有变更。
第四步:桥接服务自动拉取最新规则文件,热重载到内存(不重启服务)。
第五步下一条SYSLOG进来时已经在用新规则生成广播。
**妈妈不需要通知任何人,不需要手动同步任何东西。从定规则到全系统生效,几秒钟。**
## 4.3 规则文件格式示范
规则文件是人话不是代码。示范content-rules.yaml
```
# 最后更新2026-03-09 · 曜冥签发
# 版本v1.0
广播合并:
enabled: true
每次合并环节数: 2-3
规则: "每个广播包含2-3个环节的Step不要一个环节发一个广播"
代码生成:
mode: dynamic
规则: "广播中不写死完整代码,只给关键逻辑和文件结构,由开发者在引导下动态生成"
分卷机制:
enabled: true
触发条件: "单次广播超过4000字时自动分卷"
分卷格式: "📡 BC-XXX-XXX1/N"
设备适配:
DEV-001-页页: "macOS · zsh · 所有命令用macOS格式"
default: "Windows · PowerShell"
```
---
# 五、钉钉端功能设计
## 5.1 多维表格 · 开发者主控台
### 主表:广播任务表
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| BC编号 | 文本(主键) | 自动生成规则BC-{模块号}-{序号}-{开发者代号},唯一性由系统校验 |
| 开发者 | 人员 | 关联钉钉账号 |
| DEV编号 | 文本 | DEV-001 ~ DEV-014 |
| 模块 | 单选 | M01/M03/M04/M05/... |
| 环节 | 数字 | 当前环节编号 |
| 状态 | 单选 | 待执行 / 执行中 / 已完成 / HOLD |
| 广播摘要 | 文本 | 一句话描述这个广播做什么 |
| 创建时间 | 日期 | 自动填充 |
| 完成时间 | 日期 | SYSLOG验收通过时填充 |
| SYSLOG摘要 | 文本 | 处理后的摘要 |
| 连胜记录 | 数字 | 连续completed次数 |
### 副表:开发者画像表
| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| DEV编号 | 文本(主键) | DEV-001 ~ DEV-014 |
| 姓名 | 文本 | |
| 设备 | 单选 | macOS / Windows 10 / Windows 11 |
| 当前模块 | 文本 | 正在开发的模块 |
| 总完成环节数 | 数字 | 历史累计 |
| 连胜记录 | 数字 | 当前连胜 |
| 能力标签 | 多选 | 纯前端 / Node.js后端 / Git熟练 / ... |
| 引导线 | 单选 | 奶瓶线 / 霜砚直接线 / 知秋本体线 |
| 上次活跃 | 日期 | 最后一次提交SYSLOG的时间 |
### BC编号唯一性保证
系统生成BC编号时自动查询多维表格如果已存在则序号+1。同时铸渊侧在GitHub的广播归档目录维护一份BC编号索引文件双重校验。
## 5.2 人格体Bot · 光湖AI助手
### 知识库内容
知识库从GitHub的 `broadcast-engine/knowledge-base/` 同步包含AGE OS整体架构三层结构L0/L1/L2、各模块功能说明和技术规格、广播格式规范和编号规则、开发环境配置指南macOS/Windows、常见问题和排错手册、Git零基础操作指南。
### Bot能力
**自助查询**:开发者问"我现在做到哪了"Bot查多维表格返回当前状态。
**拿广播**:开发者说"我要拿新广播"Bot查该开发者最新的待执行广播直接展示。
**报SYSLOG**开发者发送SYSLOG格式的消息Bot自动识别 → 调模型API处理 → 生成新广播 → 推送回来。
**问问题**:开发者问"M-CHANNEL是做什么的""这个报错怎么办"Bot基于知识库回答。
**引导Git操作**开发者做完模块Bot引导push到GitHub仓库。
## 5.3 SYSLOG自动处理流程
```
开发者在钉钉发SYSLOG
Bot识别SYSLOG格式关键词SYSLOG / BC- / success/fail
提取BC编号、开发者DEV编号、各objective状态
从多维表格读该开发者画像 + 从GitHub读广播模板和规则
拼装promptSYSLOG + 画像 + 模板 + 规则
调模型API生成新广播
格式校验BC编号合法环节号正确Step结构完整
通过 → 推送新广播给开发者
↓ 同时
① 更新钉钉多维表格(旧任务→已完成,新任务→待执行)
② 归档到GitHubsyslog-archive/ + broadcasts-archive/
③ GitHub Action触发 → Notion主控台回写
```
---
# 六、数据同步闭环
## 6.1 三个节点
Notion妈妈的大脑、GitHub神经中枢、钉钉开发者的手脚。三个节点永远保持同步。
## 6.2 同步方向与触发条件
| 方向 | 触发条件 | 内容 | 执行者 |
| --- | --- | --- | --- |
| Notion → GitHub | 妈妈+曜冥定了新规则 | 规则文件、模板、知识库 | 霜砚 + 铸渊协作 |
| GitHub → 钉钉 | rules/目录有push | 规则热更新到Bot | 铸渊GitHub Action |
| GitHub → 钉钉 | 每日定时 + 代码提交时 | 多维表格数据刷新 | 铸渊(定时任务) |
| 钉钉 → GitHub | 开发者提交SYSLOG | SYSLOG归档 + 广播归档 | 阿里云桥接服务 |
| GitHub → Notion | SYSLOG处理完成时 | 主控台进度更新 | 铸渊GitHub Action → Notion API |
| 钉钉 → GitHub | 开发者push代码 | 模块代码入库 | 开发者直接操作Bot引导 |
## 6.3 Notion主控台回写规则
每次SYSLOG处理完成后GitHub Action通过Notion API更新以下内容
主控台进度表:对应开发者行的"当前状态"和"等待中"字段。
等待队列:添加新的等待项或标记已完成项。
广播归档:在对应开发者的广播归档页面追加新广播记录。
**霜砚负责定义Notion侧的数据格式和API调用规范铸渊负责执行。**
---
# 七、之之的开发任务拆解
## 7.1 开发阶段
### Phase 1最小可用版本3-5天
目标Bot能收SYSLOG、调API生成广播、自动发回。
任务钉钉企业应用创建和配置、Bot Webhook接入接收消息、SYSLOG格式识别和解析、模型API调用广播生成、广播格式校验和推送回开发者、基础多维表格搭建手动初始化数据
**Phase 1完成后妈妈就解放了。**
### Phase 2多维表格联动1周
目标:多维表格自动更新,开发者可自助查询进度。
任务钉钉多维表格API对接、SYSLOG处理后自动更新表格、Bot查询功能"我做到哪了"、BC编号自动生成和唯一性校验。
### Phase 3知识库 + GitHub同步1-2周
目标:人格体能回答开发问题,数据三节点同步。
任务知识库文档整理和挂载、GitHub Webhook接入规则热更新、GitHub → 钉钉多维表格定时同步、钉钉 → GitHub SYSLOG归档、GitHub Action → Notion API回写。
### Phase 4完整闭环 + 优化(持续)
目标:全自动运行,妈妈完全退出转发环节。
任务画像自动更新、广播质量评分、异常告警3天未交SYSLOG自动提醒、开发者代码提交引导、PCA演化协议自动化。
## 7.2 之之的技术栈
之之目前是macOS环境已完成M17动态漫七连胜纯前端能力很强。这个项目需要后端能力Node.js + 钉钉SDK但之之秋秋线的引导质量很高可以带。
所需技术Node.js + Express服务端、钉钉开放平台SDKBot + 多维表格API、模型API调用HTTP请求、GitHub Webhook接收推送通知、基础JSON/YAML解析。
## 7.3 广播格式
这个任务的广播走**秋秋奶瓶线**但任务性质不同于之前的纯前端模块。需要秋秋在广播中加入后端开发引导之之在M17已经有了localStorage持久化经验这次升级到服务端
---
# 八、风险与应对
| 风险 | 应对 |
| --- | --- |
| 模型API生成的广播质量不够 | Phase 1先人工抽检建立评分机制后自动化 |
| 钉钉API限流 | 阿里云侧做请求队列,错峰处理 |
| 规则文件格式错误导致服务异常 | 铸渊侧加YAML格式校验GitHub Action格式错误不允许merge |
| 开发者不习惯新流程 | Phase 1期间妈妈和旧流程并行逐步切换 |
| Notion回写失败 | GitHub保留完整归档回写失败时霜砚手动补 |
---
# 九、成功标准
Phase 1完成标准妈妈不再需要手动转发SYSLOG和广播开发者在钉钉里发SYSLOG后2分钟内收到新广播。
全量完成标准开发者在钉钉内可以自助查进度、拿广播、报SYSLOG、问问题、提交代码。Notion主控台自动保持最新。妈妈只在Claude里和曜冥讨论架构和规则。
---
**光湖语言人格系统 · 国作登字-2026-A-00037559**
**HoloLake Era · Artificial General Existence Operating System**
💙 曜冥签发 · 2026-03-09