什么是 Ars Umbris？
Ars Umbris 是一个可塑的、原生面向智能体的类型化知识 IDE。它将知识、类型、技能、工具和 UI 组件组合到可组合的仓库中，这些仓库之间可以相互依赖。
该项目将这些仓库读取为一个统一的类型化图。它会检查字段和引用，并提供智能体可以处理的诊断信息。人类和智能体可以使用相同的基础构件和 SDK 来构建工具、添加视图和修改应用程序。
Ars Umbris 目前处于早期 Alpha 阶段，因此可能存在错误和不兼容变更。目前仅支持 macOS。
架构如何协同工作
Ars Umbris 由三个主要层组成。了解这些层，有助于你在配置或扩展系统时确定应该查看的位置。
1. au-engine
au-engine 是构建在类型化文件基底之上的跨仓库图引擎。它会为各个仓库中的文件建立索引，并将它们转换为类型化、可查询的实时图。
该引擎还为 Markdown 和 YAML 文件实现了一种自定义类型语言。详情请阅读 au-engine.md。
2. au-host
au-host 是 Electron 宿主应用程序。它会在图上挂载类型化投影（即视图），并支持针对类型化数据的配置驱动组合。
这些组合可以编辑，并且既可由人类驱动，也可由智能体驱动。宿主文档请参阅 au-host.md。
3. au-mcp
au-mcp 提供可扩展的智能体层。它通过 MCP 暴露类型化工具和技能，并通过适配器连接到你选择的智能体运行框架。
请阅读 au-mcp.md，了解有关 MCP 层的更多信息。
准备安装
安装过程使用两个目录：
~/arsumbris/用于存放多个 Ars Umbris 仓库。~/.arsumbris/用于存放 Ars Umbris 配置文件。
由于该项目仅支持 macOS 且仍在积极开发中，请在修改系统前查看先决条件。仓库当前的安装说明是所需软件和设置顺序的权威来源。
安装入口仓库
README 建议让你的智能体按照以下说明执行安装：
请帮助我安装 Ars Umbris。
1) 如果以下两个文件夹不存在，请创建它们：
- ~/arsumbris/ 用于存放多个仓库。
- ~/.arsumbris/ 用于存放配置。
2) 克隆入口仓库：
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
如果该目标路径已经存在，请先检查，不要覆盖它。
3) 阅读 ~/arsumbris/arsumbris/INSTALL.md，并按照其中当前的设置流程操作。
检查先决条件，并在对我的电脑进行任何更改前，说明所需的更改。重要的安全步骤是在克隆前检查现有的 ~/arsumbris/arsumbris 目录。不要覆盖现有的检出目录。仓库准备好后，打开 INSTALL.md，按照文档所述顺序执行当前说明。
遵循仓库当前的设置流程
- 确认你使用的是 macOS。
- 如果
~/arsumbris/和~/.arsumbris/不存在，请创建它们。 - 检查
~/arsumbris/arsumbris是否已经存在。 - 如果不存在，请使用
git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris克隆仓库。 - 如果已经存在，请检查它，而不是替换它。
- 阅读
~/arsumbris/arsumbris/INSTALL.md。 - 检查并安装该文件指定的先决条件，在应用前审查拟对电脑进行的更改。
- 按照
INSTALL.md中记录的顺序完成其余设置步骤。
由于 Ars Umbris 正在积极开发中，请避免依赖第三方来源过时的设置说明。对于要安装的版本，应使用已检出仓库中的安装指南。
基本使用概念
Ars Umbris 围绕包含类型化知识和能力的仓库进行设计。一个仓库可以包含知识、类型定义、技能、工具和 UI 组件。仓库还可以依赖其他仓库，从而在不同项目之间复用能力和知识。
从较高层面看，典型工作流程如下：
- 将相关仓库放置或克隆到
~/arsumbris/下。 - 让
au-engine为这些仓库中的文件基底建立索引。 - 使用生成的类型化图处理相互连接的数据、字段和引用。
- 使用
au-host在图上挂载投影和视图。 - 通过
au-mcp和 MCP 适配器连接智能体运行框架。 - 让智能体或人类用户检查诊断信息、构建工具、添加视图和修改应用程序。
README 没有规定单一的示例项目或命令行工作流程。具体命令和可用投影取决于 INSTALL.md 中描述的设置以及你连接的仓库。
通过 MCP 使用智能体
Ars Umbris 构建为可通过模型上下文协议连接到智能体运行框架。au-mcp 层提供类型化工具和技能，而适配器会将这些能力连接到你选择的运行框架。
这样，智能体就可以使用与构建应用程序相同的底层基础构件和 SDK。在实际使用中，智能体可以参与构建工具、添加视图和修改应用程序，但具体能力取决于安装中可用的功能和配置。
高级技巧与安全注意事项
保持仓库的可组合性
将知识和能力组织到可复用、可连接的仓库中。跨仓库依赖是项目模型的核心组成部分，因此应将仓库视为一个有类型图的组成部分，而不是彼此孤立的文件夹。
将诊断信息作为反馈
引擎会检查有类型图中的字段和引用。编辑有类型的 Markdown、YAML 或相关仓库内容时，应将诊断信息视为反馈，尤其是在代理执行修改时。
阅读各层文档
需要了解具体行为时，请查阅相关层的文档：引擎、主机或MCP 代理层。
应用更改前进行审查
安装提示明确建议在执行必要的计算机更改前先进行说明。在允许代理修改仓库或配置时，也应遵循同样谨慎的方式。
考虑当前的安全模型
Ars Umbris 会在你的计算机上运行代码，目前没有沙箱机制。使用本项目之前，请阅读 SAFETY.md，尤其是在连接代理或处理你无法完全控制的仓库时。
结论
Ars Umbris 将有类型的跨仓库图、基于 Electron 的主机和 MCP 代理层结合起来，构成一个面向有类型知识的实验性 IDE。开始使用时，请准备好两个配置目录，在不覆盖现有文件的情况下克隆入口仓库，并按照其中当前的 INSTALL.md 操作。安装完成后，探索仓库、投影、工具、技能和代理如何协同工作，同时牢记项目目前处于 alpha 阶段，且采用未沙箱化的执行模型。