WSaiOS™ 应用包规范 v1.0
WSaiOS™ 应用包规范 v1.0
王氏智能人工智能操作系统
应用包标准版
版本：1.0
状态：草稿
1. 目的
本规范定义WSaiOS应用包（Application Pack）的标准结构、生命周期、注册机制、依赖关系、权限模型及运行方式。
Application Pack（简称 WAP）是WSaiOS唯一官方支持的应用扩展形式。
任何运行于WSaiOS之上的行业系统、AI应用或企业解决方案均必须遵循本规范。
2. 定义
Application Pack（WAP）是一个可安装、可升级、可卸载的智能应用构件。
Application Pack不是单纯的软件包，而是由Agent、Workflow、Knowledge、UI、API、配置和资源组成的完整智能应用单元。
Application Pack运行于WSaiOS Runtime之上，不得直接访问Kernel。
3. 设计原则
Application Pack遵循以下原则：
单一职责
一个Application Pack应聚焦一个业务领域。
内核隔离
Application不得修改Kernel。
运行时依赖关系
所有系统能力通过Runtime Services提供。
声明式注册
所有能力采用声明式注册。
松耦合
不同Application之间不得直接耦合。
统一通过系统事件和公开接口通信。
4. 标准包装结构
一个标准Application Pack应包含以下目录：
应用程序包/
manifest.json
app.json
代理人/
工作流程/
知识/
记忆/
规则/
用户界面/
api/
配置/
权限/
资源/
资产/
脚本/
日志/
测试/
文档/
所有目录均为可选，但manifest.json必须存在。
5. 清单
Manifest是Application Pack的唯一入口。
至少包含：
应用程序 ID
应用程序名称
版本
小贩
描述
内核版本
运行时版本
依赖关系
权限
入口点
校验和
数字签名
Runtime通过Manifest完成自动注册。
6. 注册
安装Application Pack后，系统自动完成注册：
应用程序注册表
↓
代理人登记册
↓
工作流注册表
↓
知识库
↓
工具注册表
↓
API注册表
↓
UI注册表
↓
权限登记册
无需开发者手动初始化。
7. 代理人登记
Application可注册多个Agent。
每个Agent必须符合：
WSaiOS Agent 标准
注册内容包括：
代理 ID
版本
能力
允许
支持目标
依赖关系
入口
所有Agent由Agent Runtime统一管理。
8. 工作流程登记
Application可注册多个Workflow。
Workflow包含：
扳机
任务
健康）状况
行动
例外
Workflow统一由Workflow Engine执行。
9. 知识注册
Application可携带：
知识库
知识图谱
提示库
本体论
嵌入数据
安装后自动导入Knowledge Service。
10. 规则登记
Application可定义：
业务规则
验证规则
执行规则
安全规则
所有规则统一注册至Rule Engine。
11. 示范政策
Application不得绑定固定模型。
只能声明：
首选能力
例如：
推理
编码
想象
翻译
总结
最终模型由Model Router自动选择。
12. 工具注册
Application可声明需要的工具：
浏览器
搜索
数据库
电子邮件
文件系统
API
代码执行器
Tool统一由Tool Manager授权。
13. 存储器集成
Application不得直接管理长期Memory。
允许：
会话内存
工作区内存
共享Memory由Memory Service统一维护。
14. 用户界面组件
Application可注册：
仪表板
工作区
控制板
小部件
菜单
命令
所有UI通过AI Shell统一加载。
15. API集成
Application可提供：
REST API
GraphQL
WebSocket
事件 API
所有API统一由API Gateway管理。
16. 事件系统
Application必须通过事件总线通信。
标准事件包括：
应用程序已安装
应用程序已启动
应用程序已停止
任务已创建
任务完成
目标已完成
知识更新
工作流程已完成
禁止Application之间直接调用内部模块。
17. 权限模型
Application权限采用最小授权原则。
权限分类：
知识
记忆
模型
工具
工作流程
数据库
文件系统
网络
用户个人资料
权限必须声明。
未经授权不得访问。
18. 依赖关系管理
Application可依赖：
运行时服务
代理库
知识包
功能包
其他Application API
禁止循环依赖。
19. 生命周期
Application统一生命周期：
包裹
↓
安装
↓
核实
↓
登记
↓
初始化
↓
激活
↓
跑步
↓
暂停
↓
恢复
↓
升级
↓
停用
↓
卸载
所有生命周期均产生系统事件。
20. 升级
Application支持：
最新消息
回滚
移民
版本兼容性
升级不得影响Kernel稳定性。
21. 安全性
Application必须通过：
数字签名
权限验证
沙盒运行时
审计日志
诚信检查
未签名Application不得安装。
22. 运行时隔离
每个Application拥有独立运行空间。
包括：
工作区
配置
缓存
日志
临时数据
禁止直接访问其他Application资源。
23. 应用类别
WSaiOS推荐分类：
商务套装
知识包
特工包
工作流程包
自动化包
研究包
内容包
实用包
企业版
开发者包
24. 兼容性
Application应声明支持：
内核版本
运行时版本
代理标准版
工作流程标准版
应用程序包版本
系统根据版本自动判断兼容性。
25. 认证
符合本规范的Application可获得：
WS认证应用程序包
认证标识。
认证Application可运行于所有兼容WSaiOS的平台。
26. 视觉
Application Pack是WSaiOS应用生态的基础单位。
开发者无需关注Kernel实现，也无需绑定特定AI模型。
只需围绕业务目标构建Agent、Workflow、Knowledge和Capability，WSaiOS Runtime将负责调度、执行、安全控制、模型选择和资源管理。
Application Pack使WSaiOS形成统一、开放、可扩展、可持续演进的AI应用生态。