Agentaily

「聊天 × 万物」—— 一个聊天 Agent:你跟它聊,它帮你把东西(表单 / 幻灯片 / 网页 / …)造出来。

🔁 架构收敛中(2026-06-19 起)。 目标态:一个【应用】= aml(声明式后端数据模型 → 框架自动建 D1 表 + 自描述数据接口)+ index.html(LLM 自由写、沙箱跑)+ 描述 + 预览;市场(marketplace)是核心价值,Agent 靠市场 skill 搜 / 截图 / fork,不从零写。当前重构真相源 = REFACTOR.md(M0–M8 工单)。下文如实标注「已落地」与「重构中」。

完整设计见 ARCHITECTURE.md(设计 / 理由),精确契约见 SPEC.md(协议 / 数据形状 / op 语义 / 不变量),能力进度见 ROADMAP.md —— 加包、加能力前先读它们(均挂 banner 指向 REFACTOR.md 为当前真相源)。

仓库地图

基建 / 平台层

aml             @agentaily/aml           声明式后端数据模型 DSL(参考 Prisma,不重名);emit() → 表 + DDL + 数据接口描述
llm             @agentaily/llm           多家大模型统一客户端(BYOK,浏览器直连 / 流式)
db              @agentaily/db            持久化层:平台固定表(Drizzle 真相源)+ 旧 JSON-Schema 派生表引擎 + 新 AML 引擎
                                         (建表 / 迁移 + scoped 数据接口,M1/M2 已 ship)。详见 db/README.md;重构中改名 → @agentaily/runtime
backend         @agentaily/backend       轻后端纯逻辑:鉴权 + 公开运行时桥 + host 解析 + 提交 / 查询编排。详见 backend/README.md
persistence     @agentaily/persistence   零依赖跨子域偏好持久化原语(cookie → localStorage → memory → no-op)
i18n            @agentaily/i18n          国际化机制(locale 检测 + 持久化 + <html lang>)
theme           @agentaily/theme         主题切换机制(system / light / dark + flash-free init;依赖 persistence)
design-system   @agentaily/design-system 设计系统(120 组件 + Storybook)
storybook-addon-review                   @agentaily/storybook-addon-review —— Storybook addon:预览里 hover 选元素 + 写评论
                                         + 一键开评审 PR(本地 dev,git plumbing 非破坏式建 PR;静态/线上优雅降级)。详见包内 README/skill
feedback-widget @agentaily/feedback-widget 可发布的 React「评审 widget」:任意站点开评审模式 → 点选元素 → 写意见 → 提交;
                                         POST 给 agentaily-feedback Worker 开 PR。React 仅 peerDep、不依赖 DS。详见包内 README/skill
annotate        @agentaily/annotate      统一「页面标注/评审」核心:vanilla DOM 控制器(hover 高亮 + 点选 + 写 + 提交)+ 薄
                                         React 包装;回调式(无后端)、主题走 DS token。供上面两者 + 文档站 + 预览工作台复用(收敛后续刀)。详见包内 README/skill

Agent 层

agent/agent     @agentaily/agent         无头 agent 运行时(客户端 loop · app-builder 工具 · 技能 · 记忆 · 会话 rehydrate)
agent/store     @agentaily/agent-store   agent 状态 / 持久化层(Skill + Memory + Conversation stores;本地默认实现)

聊天 UI 现直接在 apps/web(ChatWorkbench,基于 @agentaily/design-system 的 ChatApp 壳)里实现;旧 @agentaily/agent-ui 已删(M7),后续可按 REFACTOR §8.1 重写为 @agentaily/agent-react。

市场 / 渲染

presets         @agentaily/presets       市场数据层:AppEntry{aml,indexHtml,preview,author,forkedFrom,…} + list/get/search/fork
                                         (★核心价值;升级中 → @agentaily/market,服务端存储 / 预览截图待接)

垂直(verticals)与 Studio 协议(studio/protocol·client)已删(M7)。 收敛态「无 verticals」:app = aml + 零构建 VFS 文件,沙箱直跑,不再有内容 schema / 内嵌 Studio / postMessage RPC。form / slides 的种料以市场种子 AppEntry 形式承载。

产物 / 评测

apps/web         @agentaily/web        主 SPA(`/` = ChatApp:聊天造 app + 会话绑定的预览工作台 + 市场弹窗)+ Pages Functions(/api/*,落 D1)。详见 apps/web/README.md
apps/website     @agentaily/website    官网(双语营销落地页)
apps/publish     @agentaily/publish    UGC 制品独立源运行时 Worker(按 Host 路由:<slug>.agentaily.com / 自带域名)
apps/feedback    @agentaily/feedback   反馈 Worker(agentaily-feedback):收 feedback-widget 提交 → GitHub REST 开 PR(reviews/<ts>.md)
apps/docs        @agentaily/docs       VitePress 文档站:聚合全仓 md 真相源 → 一个可搜索文档官网(→ docs.agentaily.com)。详见 apps/docs/README.md
eval             @agentaily/eval       任务完成度评测(真 agent + 真模型,headless)

市场不再是独立 app。 原 apps/market 门面 SPA 已删,其浏览 UI(列表 / 卡片 / 搜索 / 详情 / fork)搬进 apps/web,以 弹窗(Dialog) 形式从 ChatApp header 打开;市场数据端点用 apps/web 自有的 functions/api/market/*。

状态

已上线:/ = ChatApp(聊天为主造 app → 会话绑定的预览工作台:文件侧栏开关 + 文件下拉 + 纯预览,绝不示码 → 市场弹窗逛 / 搜 / fork → 发布)跑通;apps/web 已上线 https://agentaily.pages.dev(CF Pages + Pages Functions + D1)。主题 / 语言偏好存 cookie + 防 FOUC(@agentaily/theme init-script)。
重构地基已落地:@agentaily/aml DSL、db 的 AML 建表 + 数据引擎(M1/M2)、presets 的 AppEntry 市场数据层(M3 第一刀)、@agentaily/agent-store + loop 接 ConversationStore、theme/persistence 抽独立包;M7 清旧已完成(删 verticals/studio-protocol/client/agent-ui/旧 App.tsx)。进度逐项见 ROADMAP.md 与 REFACTOR.md。

开发

完整本地开发指南(环境、各应用端口、后端 / D1、推进模型)见 DEVELOPMENT.md;推进走 worktree + PR(见 CLAUDE.md 的「🌳 推进模型」)。测试分层 / 双循环 TDD/BDD 见 TESTING.md;项目级 sub-agent 角色(spec-architect / implementer / outer-tester / reviewer / release-eng / designer)+ 编排策略见 .claude/agents/README.md。

bash

pnpm install
pnpm test                              # vitest,全工作区
pnpm typecheck                         # turbo run typecheck
pnpm build                             # turbo run build

# 跑主应用(AppBuilder 聊天造 app)
pnpm --filter @agentaily/web dev           # 主应用 → http://localhost:4173

Agentaily ​

仓库地图 ​

状态 ​

开发 ​

Agentaily

仓库地图

状态

开发