docs: 对象命名规范 AR09 与标准化讨论文档入库

- 新增 docs/02_Architecture/AR09_Object_Naming_Standard.md（规范性文件，非设计稿）：十节结构 —— 原理 / 判据 / 对象术语表 / 五层命名规范 / 命名模式库 / 如何检查（人工五问 + 6 个机器守卫）/ 如何修复（迁移顺序 + 改名六步法）/ 现状问题登记（逐条带 file:line）/ 反例库 / 修订记录。核心判断：名称即契约，改名前先查已靠名字建立的协议表 - 02_Architecture/README.md 登记 AR09，并说明其规范性定位（约束新增代码，与 TOP_CODING_RULES.md 的 G03 配套），与 AR01–AR08 设计稿区别 - 收入本轮讨论与调研文档：对象命名标准化清单、对象标准化与解耦总则、六层架构与三对象建设重点阶段性复盘、目录结构化迁移说明、 AionUi 对照分析两篇 Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 23:38:42 +08:00
parent d0d7b3588c
commit ddd2d2cbd8
8 changed files with 2655 additions and 0 deletions
@@ -0,0 +1,681 @@
+# AionUi 源码深度扫描与办公智能体架构对比
+
+> 扫描对象：`/home/eaiadmin/eaifiles/codebase/AionUi`
+>
+> 关联资产：`/home/eaiadmin/eaifiles/codebase/AionCore-assets/crates/aionui-app/assets`
+>
+> 参考对标：`/home/eaiadmin/eaifiles/codebase/pj0235-eai_agentplatform-ubu/docs/微趣MyGPT调研与办公智能体架构对比.md`
+
+---
+
+## 一、结论
+
+**AionUi 不是简单的 Electron 桌面壳了，但它依然不是 MyGPT 那种政企成品。**
+
+更准确地说：
+
+```text
+AionUi = 强助手包装 + 强技能包 + 强 Office 交付 + 弱企业底座
+博昇 pj0235 = 强企业底座 + 中等场景化 + 正在补办公交付
+MyGPT = 强企业成品化 + 强办公场景 + 强私有化销售形态
+```
+
+我的源码实读后的核心判断是：
+
+1. **之前把 AionUi 理解成“桌面玩具”已经偏旧了。**
+   它现在实际是一个 **桌面优先、但已经长出 WebUI、独立 Web CLI、移动端、远程渠道、多 Agent 团队模式** 的 AI 工作台。
+
+2. **但它仍然不是政企办公平台。**
+   它更像一个 **个人/小团队的 AI Cowork 工作台**，不是 MyGPT 那种“私有化一体机 + 多用户权限 + 行业交付”的标准产品。
+
+3. **AionUi 最值得学的不是技术栈，而是“助手如何封装成产品”。**
+   它把一个助手拆成：
+   - 助手目录元数据
+   - Markdown 规则
+   - 绑定技能
+   - 默认模型/权限/MCP
+   - 可预览的最终交付物
+
+4. **对 pj0235 最有价值的是三层结构，不是 Electron。**
+   最该学的是：
+   - `Assistant/Expert` 规则层
+   - `Skill` 工具层
+   - `Application` 成品入口层
+
+一句话总结：
+
+**AionUi 该学“怎么把 AI 员工做成可复用的产品单元”；MyGPT 该学“怎么把这些单元卖成政企标准化办公平台”；pj0235 不该倒回 Electron，而该在现有 Go/Web 底座上吸收这两者。**
+
+---
+
+## 二、这次扫描看了什么
+
+这次不是只看 README，而是把几类关键源码都扫了一遍：
+
+- **产品入口与技术栈**
+  - `AionUi/package.json`
+  - `AionUi/readme.md`
+  - `AionUi/packages/web-host/package.json`
+  - `AionUi/packages/web-cli/package.json`
+  - `AionUi/mobile/package.json`
+
+- **助手目录与规则**
+  - `AionCore-assets/crates/aionui-app/assets/builtin-assistants/assistants.json`
+  - `AionCore-assets/crates/aionui-app/assets/builtin-assistants/rules/*.md`
+
+- **技能目录**
+  - `AionCore-assets/crates/aionui-app/assets/builtin-skills/*`
+  - 包括 `auto-inject/*` 子技能
+
+- **桌面端助手/技能装载与数据结构**
+  - `AionUi/packages/desktop/src/common/types/agent/assistantTypes.ts`
+  - `AionUi/packages/desktop/src/process/utils/initStorage.ts`
+  - `AionUi/packages/desktop/src/renderer/pages/settings/SkillsSettings/SkillsHubSettings.tsx`
+
+- **团队模式 / 定时任务 / 预览 / 浏览器 / 远程**
+  - `AionUi/packages/desktop/src/process/services/database/schema.ts`
+  - `AionUi/packages/desktop/src/process/services/database/migrations.ts`
+  - `AionUi/packages/desktop/src/process/utils/runBackendMigrations.ts`
+  - `AionUi/packages/desktop/src/renderer/pages/conversation/Preview/README.cn.md`
+  - `AionUi/packages/web-host/src/index.ts`
+  - `AionUi/packages/web-cli/src/index.ts`
+  - `AionUi/scripts/webui.ts`
+
+---
+
+## 三、纠正一个旧判断
+
+之前那份对比稿里有一句：
+
+> “内置技能只有 5 个：pptx / docx / pdf / xlsx / mermaid”
+
+**这个说法现在已经不够准确。**
+
+按这次源码扫描，`builtin-skills` 顶层目录已经有 **22 个**：
+
+- `aionui-troubleshooting`
+- `aionui-webui-public`
+- `aionui-webui-setup`
+- `auto-inject`
+- `mermaid`
+- `moltbook`
+- `morph-ppt`
+- `morph-ppt-3d`
+- `officecli-academic-paper`
+- `officecli-data-dashboard`
+- `officecli-docx`
+- `officecli-financial-model`
+- `officecli-pitch-deck`
+- `officecli-pptx`
+- `officecli-word-form`
+- `officecli-xlsx`
+- `openclaw-setup`
+- `pdf`
+- `story-roleplay`
+- `weixin-file-send`
+- `xiaohongshu-recruiter`
+- `x-recruiter`
+
+而且 `auto-inject` 下面还至少包含这些系统级子技能：
+
+- `skill-creator`
+- `officecli`
+- `cron`
+- `aionui-config`
+- `conversation-create`
+- `session-message`
+
+所以更准确的说法应该是：
+
+**AionUi 最核心的显式通用技能，仍然集中在 OfficeCLI/PDF/Mermaid 这条线上；但完整源码资产里的技能体系，已经明显比“5 个技能”厚得多。**
+
+---
+
+## 四、AionUi 现在到底是什么形态
+
+### 1. 它仍然是桌面优先
+
+主仓库依然是：
+
+- Electron
+- React 19
+- TypeScript
+- Bun
+- Arco Design
+- better-sqlite3
+
+这一点没有变，桌面端仍然是主入口。
+
+### 2. 但它已经不只是桌面端
+
+源码里已经清楚分成：
+
+- `packages/desktop`：Electron 主产品
+- `packages/web-host`：WebUI Host，负责拉起后端和静态站点
+- `packages/web-cli`：独立 Web 运行时 CLI
+- `mobile/`：Expo / React Native 移动端
+
+也就是说，它的真实形态更接近：
+
+```text
+桌面端主产品
+    + 独立 WebUI
+    + 独立 Web CLI
+    + 移动端
+    + IM 渠道远程接入
+```
+
+所以如果现在再简单说它是“Electron 桌面壳”，就失真了。
+
+### 3. 它后端不是 Node 业务后端，而是 AionCore 二进制
+
+这里有个很关键的点：
+
+- `AionUi/package.json` 里钉住了 `aioncoreVersion: v0.2.2`
+- `scripts/prepareAioncore.js`
+- `scripts/resolveAioncoreVersion.js`
+
+说明桌面壳之外，**真正的能力核心已经下沉到 AionCore 后端二进制**。
+
+也就是说它不是“前端非常厚，后端几乎没有”，而是：
+
+```text
+AionUi 前端壳 + AionCore 能力后端 + AionCore 资产目录
+```
+
+这个结构比“纯 Electron 玩具”要成熟很多。
+
+---
+
+## 五、AionUi 的 21 个助手到底是什么
+
+`assistants.json` 明确给出了 21 个内置助手。
+
+### 1. 办公交付型助手
+
+这一批是最值得 pj0235 学的：
+
+1. `Word Creator`
+2. `PPT Creator`
+3. `Excel Creator`
+4. `Word Form Creator`
+5. `Morph PPT`
+6. `3D Morph PPT`
+7. `Pitch Deck Creator`
+8. `Dashboard Creator`
+9. `Academic Paper`
+10. `Financial Model Creator`
+11. `Beautiful Mermaid`
+
+它们的共同特点是：
+
+- **目标非常清晰**
+- **交付物非常明确**
+- **不是闲聊型助手，而是“产物型助手”**
+
+也就是：
+
+```text
+输入需求 -> 调用技能 -> 生成 .pptx / .docx / .xlsx / 图表
+```
+
+这正是办公生产力平台最有价值的那条线。
+
+### 2. 通用协作 / 系统型助手
+
+这一批更像方法层和系统层：
+
+1. `Cowork`
+2. `Planning with Files`
+3. `AionUi Butler`
+4. `OpenClaw Setup Expert`
+5. `HUMAN 3.0 Coach`
+
+其中最值得学的是前三个：
+
+- `Cowork`：通用任务执行器
+- `Planning with Files`：持久化 markdown 规划法
+- `AionUi Butler`：产品内管家
+
+### 3. 创意 / 社交 / 娱乐型助手
+
+这批对你当前办公对标价值不大：
+
+1. `3D Game`
+2. `UI/UX Pro Max`
+3. `Social Job Publisher`
+4. `moltbook`
+5. `Story Roleplay`
+
+所以如果是对标微趣办公平台，这部分可以基本不学或后置。
+
+---
+
+## 六、AionUi 的“员工”不是写死按钮，而是可装配对象
+
+从 `assistantTypes.ts` 和 `assistants.json` 看，AionUi 的助手本质不是一个写死页面，而是一个可装配数据对象：
+
+- `id`
+- `name`
+- `description`
+- `agent`
+- `enabled_skills`
+- `custom_skill_names`
+- `disabled_builtin_skills`
+- `prompts`
+- `defaults`
+- `preferences`
+- `rules`
+
+这意味着一个助手本质上是：
+
+```text
+助手 = 角色元数据 + 规则文件 + 技能绑定 + 默认运行配置
+```
+
+这是它最值得学的地方。
+
+### 助手规则怎么存
+
+规则文件不是硬编码在前端组件里，而是：
+
+- 目录在 `builtin-assistants/rules/*.md`
+- 运行时由后端目录和 SQLite 目录统一管理
+- `initStorage.ts` 里已经明确写了：
+  - built-in assistant 和 built-in skill 由 backend 负责
+  - 不再从 renderer 资源里同步
+
+也就是说：
+
+**AionUi 的助手，本质上是“数据化角色 + Markdown 规则”。**
+
+这非常适合迁移到 pj0235。
+
+---
+
+## 七、AionUi 的技能体系，已经是产品骨架
+
+### 1. 显式技能
+
+用户可感知、可挂载的主要技能包括：
+
+- `officecli-pptx`
+- `officecli-docx`
+- `officecli-xlsx`
+- `officecli-word-form`
+- `officecli-pitch-deck`
+- `officecli-data-dashboard`
+- `officecli-academic-paper`
+- `officecli-financial-model`
+- `morph-ppt`
+- `morph-ppt-3d`
+- `mermaid`
+- `pdf`
+- `story-roleplay`
+- `moltbook`
+- `openclaw-setup`
+- 招聘发布类技能等
+
+### 2. 自动注入技能
+
+这一层很关键，因为它代表 **系统级能力并不一定通过前台显式勾选出现**。
+
+源码里可以看到自动注入技能承担了这些事：
+
+- `officecli`：通用 Office 操作基础能力
+- `cron`：定时任务
+- `skill-creator`：技能创建器
+- `aionui-config`：修改 AionUi 自己
+- `conversation-create`：创建新会话
+- `session-message`：跨会话通信
+
+这说明 AionUi 的技能并不只是“做文档”的工具包，它已经变成：
+
+```text
+办公技能 + 系统技能 + 会话编排技能
+```
+
+### 3. 技能不是说明书，而是可执行工作包
+
+从这些 `SKILL.md` 能看到一个很明显的产品思路：
+
+- 不是一句“你会做 PPT”
+- 而是把工作流写清楚
+- 必要时附带脚本、参考资料、模板
+- 强调什么时候触发、怎么执行、失败怎么处理
+
+也就是说它的技能不是 UI 标签，而是真正的 **可落地操作包**。
+
+---
+
+## 八、AionUi 助手和技能是怎么绑定的
+
+`assistants.json` 里每个助手都带 `enabled_skills`。
+
+几个典型映射如下：
+
+- `Word Creator -> officecli-docx`
+- `PPT Creator -> officecli-pptx`
+- `Excel Creator -> officecli-xlsx`
+- `Word Form Creator -> officecli-word-form`
+- `Pitch Deck Creator -> officecli-pitch-deck`
+- `Dashboard Creator -> officecli-data-dashboard`
+- `Academic Paper -> officecli-academic-paper`
+- `Financial Model Creator -> officecli-financial-model`
+- `Morph PPT -> morph-ppt`
+- `3D Morph PPT -> morph-ppt-3d + morph-ppt`
+- `Beautiful Mermaid -> mermaid`
+- `Story Roleplay -> story-roleplay`
+- `Social Job Publisher -> xiaohongshu-recruiter + x-recruiter`
+- `AionUi Butler -> aionui-config + aionui-troubleshooting + aionui-webui-public`
+
+这个结构特别重要，因为它说明：
+
+**AionUi 的“员工”不是直接把所有能力塞进 prompt，而是通过技能挂载来缩小能力边界。**
+
+这对你现在的项目非常有参考价值：
+
+```text
+专员 = 负责任务理解与编排
+技能 = 负责真正执行
+应用 = 负责给用户一键入口
+```
+
+---
+
+## 九、AionUi 其实已经有“团队模式”而不是单助手模式
+
+这也是旧认识里容易低估的地方。
+
+从数据库 schema 和 migrations 可以直接看到：
+
+- `teams`
+- `mailbox`
+- `team_tasks`
+
+也就是说它的 Team Mode 不是 PPT 里的概念，而是真有落库结构：
+
+- 团队表
+- 代理邮箱
+- 团队任务板
+
+数据库字段也很直白：
+
+- `lead_agent_id`
+- `to_agent_id`
+- `from_agent_id`
+- `subject`
+- `status`
+- `blocked_by`
+- `blocks`
+
+这说明它的团队协作机制不是“前端上摆几个头像”，而是已经走到了：
+
+```text
+Leader
+  -> 发任务
+  -> 队友并行执行
+  -> 邮箱回传结果
+  -> 任务板追踪
+```
+
+这块比我们原先理解的 AionUi 要更成熟。
+
+---
+
+## 十、它还有定时任务、远程访问、预览和内置浏览器
+
+### 1. 定时任务是实装的
+
+`cron_jobs` 表字段很完整：
+
+- `schedule_kind`
+- `schedule_value`
+- `schedule_tz`
+- `payload_message`
+- `conversation_id`
+- `next_run_at`
+- `last_run_at`
+- `last_error`
+
+说明这不是“以后可能做”，而是完整的已落地能力。
+
+### 2. 预览面板比普通聊天产品强很多
+
+Preview 模块文档和目录显示，它支持：
+
+- Markdown
+- 代码
+- 图片
+- Diff
+- PDF
+- Word
+- Excel
+- PPT
+- HTML
+
+而且不是单纯查看，还支持：
+
+- 多 Tab
+- 实时流式更新
+- 分屏编辑
+- 快捷键保存
+- 脏检测
+- 滚动同步
+
+这对“办公交付型 Agent”非常重要，因为它让用户看得见产物迭代。
+
+### 3. AionUi 还有内置浏览器 MCP
+
+`runBackendMigrations.ts` 里直接写了内置 browser MCP：
+
+> Control AionUi's built-in browser (the side preview panel)
+
+这意味着它的网页操作不是完全依赖外部浏览器，而是和侧边预览面板打通了。
+
+### 4. 远程访问已经成体系
+
+源码里明确支持：
+
+- WebUI Host
+- 独立 `aionui-web` CLI
+- Telegram
+- Lark / 飞书
+- DingTalk
+- Weixin
+- Slack
+- Discord
+
+再加上 `mobile/` 目录，AionUi 的交付边界已经比“本地桌面软件”宽很多。
+
+---
+
+## 十一、但它依然离 MyGPT 很远
+
+虽然 AionUi 比我们之前以为的更厚，但它依然和 MyGPT 不是一类产品。
+
+### AionUi 强在哪
+
+1. **助手包装很强**
+2. **技能包体系很强**
+3. **Office 文件交付很强**
+4. **多 Agent 协作很强**
+5. **远程/跨端能力很活**
+
+### AionUi 弱在哪
+
+1. **没有看到成熟的政企知识库/RAG 产品层**
+2. **没有看到 MyGPT 式办公场景成品化深度**
+3. **没有看到政企组织/权限/RBAC 那种交付级治理**
+4. **没有 MyGPT 那种“私有化一体机”标准售卖形态**
+5. **行业垂直办公包明显不足**
+
+所以它更像：
+
+```text
+强个人工作台
+强 AI 助手容器
+强文档交付器
+弱企业办公平台
+```
+
+---
+
+## 十二、AionUi vs pj0235 vs MyGPT
+
+| 维度 | AionUi | 博昇 pj0235 | MyGPT |
+|---|---|---|---|
+| 产品形态 | 桌面优先 + WebUI + Web CLI + Mobile | Web 企业系统 | Web 一体机 |
+| 前端 | React + Electron + Arco | Vue3 + Element Plus | 未公开 |
+| 后端 | AionCore 二进制 + SQLite | Go + Gin + GORM + SQLite | 未公开 |
+| 助手体系 | **很强**，21 个内置助手 + 规则 Markdown | 有基础，但产品化还在补 | 强 |
+| 技能体系 | **很强**，Skill 包 + auto-inject | 正在成型 | 强 |
+| Office 交付 | **很强**，OfficeCLI 路线成熟 | 正在补齐 | 强 |
+| 预览链路 | **很强**，多格式实时预览 | 中等 | 强 |
+| 团队多 Agent | **有实装** | 有任务平台，但不是这个范式 | 未公开 |
+| 知识库/RAG | 未见强产品层 | **强** | **强** |
+| 组织/权限/治理 | 弱 | **强于 AionUi** | 强 |
+| 政企私有化售卖形态 | 弱 | 中 | **强** |
+| 行业办公场景成品化 | 中 | 中 | **强** |
+
+一句话判断：
+
+**AionUi 在“AI 员工怎么做”上很强；pj0235 在“企业系统怎么交付”上更强；MyGPT 在“办公产品怎么卖成标准化政企成品”上最强。**
+
+---
+
+## 十三、对 pj0235 最值得抄的 6 件事
+
+### 1. 抄“助手对象模型”
+
+把专员做成：
+
+- 名称
+- 简介
+- 规则
+- 默认技能
+- 默认连接器/MCP
+- 默认模型
+- 默认权限
+
+而不是仅仅一个目录卡片。
+
+### 2. 抄“规则文件化”
+
+把复杂办公专员的工作逻辑写成 Markdown 规则，而不是只塞到后端 prompt 模板里。
+
+最适合迁移的就是：
+
+- PPT
+- Word
+- Excel
+- 合同/表单
+- 方案汇报
+- 长文写作
+- 项目规划
+
+### 3. 抄“技能包”而不是“功能按钮”
+
+把技能做成：
+
+- `SKILL.md`
+- 脚本
+- 参考资料
+- 模板
+
+这样你的技能才会变成真正的“可执行能力单元”。
+
+### 4. 抄“专员绑定技能”的结构
+
+不是每个专员都能做所有事，而是：
+
+- 汇报专员绑定 PPT / Mermaid / Word
+- 合同专员绑定 PDF / Word / 比对
+- 会议专员绑定转写 / 摘要 / PPT
+- 数据专员绑定 Excel / 图表 / 报表
+
+### 5. 抄“产物预览链路”
+
+这一点很关键。
+
+办公智能体不是只要会说，而是要让用户：
+
+- 看到产物
+- 快速改产物
+- 多格式预览
+- 保持文件在工作流中流动
+
+### 6. 抄“系统级隐藏技能”
+
+`auto-inject` 这层特别值得学。
+
+对 pj0235 来说，可以对应成：
+
+- 项目创建
+- 会话创建
+- 文档汇总
+- 项目内跨任务消息
+- 自动归档
+- 定时执行
+
+这些不一定要前台显式出现，但应该成为系统内的底层能力。
+
+---
+
+## 十四、如果只看办公生产力，AionUi 该优先学哪一批
+
+如果目标是对标微趣，而不是做娱乐型 AIGC，那我建议优先学这 10 个：
+
+1. `Word Creator`
+2. `PPT Creator`
+3. `Excel Creator`
+4. `Word Form Creator`
+5. `Pitch Deck Creator`
+6. `Dashboard Creator`
+7. `Academic Paper`
+8. `Financial Model Creator`
+9. `Morph PPT`
+10. `Planning with Files`
+
+这 10 个基本能组成一套很强的办公产能骨架：
+
+- 文档生成
+- 表格分析
+- 演示汇报
+- 表单模板
+- 方案包装
+- 长文写作
+- 计划执行
+
+而这些正好和你现在要补的办公生产力方向高度一致。
+
+---
+
+## 十五、最终判断
+
+最终我会这样给 AionUi 定位：
+
+```text
+AionUi 不是 MyGPT，也不是博昇现有 Web 平台。
+
+它本质上是：
+一个以助手规则和技能包为核心的 AI 工作台操作层。
+```
+
+所以对 pj0235 最正确的学习姿势不是：
+
+- 学 Electron
+- 学它的界面长相
+- 学它的个人工具调性
+
+而是学这三件事：
+
+1. **助手怎么产品化**
+2. **技能怎么封装成包**
+3. **产物怎么形成闭环**
+
+最后一句话：
+
+**博昇不该变成 AionUi。**
+**博昇应该成为：有 AionUi 助手/技能包装能力的企业级 Web MyGPT。**
+