AtomStudio

AtomStudio 是可执行文档的文档工程环境（Document Engineering Environment，DEE），负责开发、调试、验证和发布可执行文档。

它以本地 Project 为工作壳，通过同一个 Headless Engine 支持 GUI、TUI 与命令行，并显式呈现 AtomDocs 的 Ingestion、Data、Composition、Publication 四层编译状态。文件系统是项目存储；Build Snapshot、Preview 和索引都是可重建的派生观察结果。

当前版本为 alpha，公共合同和界面仍可能在正式版前调整。

能力

• 检查 Dataset、Connector Run、JSON Record Sequence 与来源诊断；
• 检查 Pydantic Model、Instance、对象关系和 Policy Diagnostic；
• 开发 Template Block Definition、Slot Binding 与 Content Block Graph；
• 验证 Presentation Profile、Target Document、Artifact 与 Evidence；
• 在本地 GUI 中使用 Agent、命令中心、源码编辑和文档预览；
• 通过同一 Engine API 驱动 Headless、GUI 与 TUI 工作流。

仓库结构

products/atom-studio/      Python Engine、CLI、测试、Web 源码与发行资产
packages/atomlab-ui/       构建所需的 AtomLab 共享 UI 可执行资产
design/identity/           AtomStudio canonical 品牌资产
fixtures/compiler-project/ 最小可运行 AtomDocs Project
examples/minimal-project/  可直接打开的示例 Project

公开仓库保留与 AtomLab canonical monorepo 一致的路径，以便同一份产品源码和架构门禁可以确定性验证。

开始使用

需要 Python 3.14+、uv 和 Bun。

uv sync --locked --all-packages
uv run atom-studio status examples/minimal-project
uv run atom-studio gui examples/minimal-project

GUI 默认监听 http://127.0.0.1:4180/，Backend 只监听 loopback 地址。

验证 Backend

uv run pytest products/atom-studio/tests

验证 Web

cd products/atom-studio/web
bun install --frozen-lockfile
bun run check
bun run test
bun run build

License

MIT