Files

T

eaiadminandClaude Code ddd2d2cbd8 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

17 KiB

Raw Blame History

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 那种政企成品。

更准确地说：

AionUi = 强助手包装 + 强技能包 + 强 Office 交付 + 弱企业底座
博昇 pj0235 = 强企业底座 + 中等场景化 + 正在补办公交付
MyGPT = 强企业成品化 + 强办公场景 + 强私有化销售形态

我的源码实读后的核心判断是：

之前把 AionUi 理解成“桌面玩具”已经偏旧了。 它现在实际是一个 桌面优先、但已经长出 WebUI、独立 Web CLI、移动端、远程渠道、多 Agent 团队模式 的 AI 工作台。
但它仍然不是政企办公平台。 它更像一个 个人/小团队的 AI Cowork 工作台，不是 MyGPT 那种“私有化一体机 + 多用户权限 + 行业交付”的标准产品。
AionUi 最值得学的不是技术栈，而是“助手如何封装成产品”。 它把一个助手拆成：
- 助手目录元数据
- Markdown 规则
- 绑定技能
- 默认模型/权限/MCP
- 可预览的最终交付物
对 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 移动端

也就是说，它的真实形态更接近：

桌面端主产品
    + 独立 WebUI
    + 独立 Web CLI
    + 移动端
    + IM 渠道远程接入

所以如果现在再简单说它是“Electron 桌面壳”，就失真了。

3. 它后端不是 Node 业务后端，而是 AionCore 二进制

这里有个很关键的点：

AionUi/package.json 里钉住了 aioncoreVersion: v0.2.2
scripts/prepareAioncore.js
scripts/resolveAioncoreVersion.js

说明桌面壳之外，真正的能力核心已经下沉到 AionCore 后端二进制。

也就是说它不是“前端非常厚，后端几乎没有”，而是：

AionUi 前端壳 + AionCore 能力后端 + AionCore 资产目录

这个结构比“纯 Electron 玩具”要成熟很多。

五、AionUi 的 21 个助手到底是什么

assistants.json 明确给出了 21 个内置助手。

1. 办公交付型助手

这一批是最值得 pj0235 学的：

Word Creator
PPT Creator
Excel Creator
Word Form Creator
Morph PPT
3D Morph PPT
Pitch Deck Creator
Dashboard Creator
Academic Paper
Financial Model Creator
Beautiful Mermaid

它们的共同特点是：

目标非常清晰
交付物非常明确
不是闲聊型助手，而是“产物型助手”

也就是：

输入需求 -> 调用技能 -> 生成 .pptx / .docx / .xlsx / 图表

这正是办公生产力平台最有价值的那条线。

2. 通用协作 / 系统型助手

这一批更像方法层和系统层：

Cowork
Planning with Files
AionUi Butler
OpenClaw Setup Expert
HUMAN 3.0 Coach

其中最值得学的是前三个：

Cowork：通用任务执行器
Planning with Files：持久化 markdown 规划法
AionUi Butler：产品内管家

3. 创意 / 社交 / 娱乐型助手

这批对你当前办公对标价值不大：

3D Game
UI/UX Pro Max
Social Job Publisher
moltbook
Story Roleplay

所以如果是对标微趣办公平台，这部分可以基本不学或后置。

六、AionUi 的“员工”不是写死按钮，而是可装配对象

从 assistantTypes.ts 和 assistants.json 看，AionUi 的助手本质不是一个写死页面，而是一个可装配数据对象：

id
name
description
agent
enabled_skills
custom_skill_names
disabled_builtin_skills
prompts
defaults
preferences
rules

这意味着一个助手本质上是：

助手 = 角色元数据 + 规则文件 + 技能绑定 + 默认运行配置

这是它最值得学的地方。

助手规则怎么存

规则文件不是硬编码在前端组件里，而是：

目录在 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 的技能并不只是“做文档”的工具包，它已经变成：

办公技能 + 系统技能 + 会话编排技能

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，而是通过技能挂载来缩小能力边界。

这对你现在的项目非常有参考价值：

专员 = 负责任务理解与编排
技能 = 负责真正执行
应用 = 负责给用户一键入口

九、AionUi 其实已经有“团队模式”而不是单助手模式

这也是旧认识里容易低估的地方。

从数据库 schema 和 migrations 可以直接看到：

teams
mailbox
team_tasks

也就是说它的 Team Mode 不是 PPT 里的概念，而是真有落库结构：

团队表
代理邮箱
团队任务板

数据库字段也很直白：

lead_agent_id
to_agent_id
from_agent_id
subject
status
blocked_by
blocks

这说明它的团队协作机制不是“前端上摆几个头像”，而是已经走到了：

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 强在哪

助手包装很强
技能包体系很强
Office 文件交付很强
多 Agent 协作很强
远程/跨端能力很活

AionUi 弱在哪

没有看到成熟的政企知识库/RAG 产品层
没有看到 MyGPT 式办公场景成品化深度
没有看到政企组织/权限/RBAC 那种交付级治理
没有 MyGPT 那种“私有化一体机”标准售卖形态
行业垂直办公包明显不足

所以它更像：

强个人工作台
强 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 个：

Word Creator
PPT Creator
Excel Creator
Word Form Creator
Pitch Deck Creator
Dashboard Creator
Academic Paper
Financial Model Creator
Morph PPT
Planning with Files

这 10 个基本能组成一套很强的办公产能骨架：

文档生成
表格分析
演示汇报
表单模板
方案包装
长文写作
计划执行

而这些正好和你现在要补的办公生产力方向高度一致。

十五、最终判断

最终我会这样给 AionUi 定位：

AionUi 不是 MyGPT，也不是博昇现有 Web 平台。

它本质上是：
一个以助手规则和技能包为核心的 AI 工作台操作层。

所以对 pj0235 最正确的学习姿势不是：

学 Electron
学它的界面长相
学它的个人工具调性

而是学这三件事：

助手怎么产品化
技能怎么封装成包
产物怎么形成闭环

最后一句话：

博昇不该变成 AionUi。 博昇应该成为：有 AionUi 助手/技能包装能力的企业级 Web MyGPT。

17 KiB Raw Blame History Unescape Escape