概念层（concepts）

跨子系统的核心心智模型——第一次写 Aalis 插件前应通读。这一层定义了服务层、消息管线、 存储文法、安全模型等贯穿全框架的词汇；服务契约层的每篇文档都建立在它们之上。

文档	讲什么
service-model	服务描述符、按名仲裁（本插件偏好 > 全局偏好 > 优先级 > 注册序）、provide / 选择层与业务层 / services.prefer、per-entry 与 entryId。领域能力挂在实例/句柄上，由各 -api helper 过滤。
lazy-service-access	业务句柄 use 是活的，每次访问重新解析、存起来也跟着换人；一段操作固定同一家取 list() 里选中那一条。有状态资源用 follow；登记型业务层由描述符随提供者换人重挂。动态查询拿到的原始实例不受关停边保护。
manifest-metadata	两套独立元数据源——package.json 的 aalis.service（市场装前披露）vs definePlugin 的 provides / uses（运行时真相）——须对齐。对账守卫读 default 定义。
storage-uri-grammar	<root>:/path 存储 URI 文法；保留 scheme（http/https/file）；data:/（storage）vs data:<mime>;base64,（data-URI）；权威 helper isStorageUri/parseUriRoot/toStorageUri；存储不是沙箱。
security-model	单 owner 威胁模型；authority 数字双轴（等级 + 确认）；safeFetch 作为 SSRF 防护出口；code-sandbox-os 的 OS 级边界；readExternalFile confused-deputy 面。插件作者的安全清单。
message-llm-pipeline	一条聊天消息如何流向 LLM：role × kind 正交、出口必调 prepareLLMMessages、attachment-ref 占位符、<at id="X"> 提及文法。写 LLM provider 或发消息的插件必读。

其它入口：插件作者隐式契约指南 · 服务契约层 · 工具库（utils） · 脚手架上手