ai-workflow/README.zh-CN.md

English

ai-workflow-v2

这个仓库现在按“独立模块”来组织，而不是把运行时、缓存和多套旧代码混在一起。

模块划分

模块	路径	作用
Inbox host	inbox/	Go 控制面：CLI、HTTP API、运行时存储、Agent 调度
Dashboard	dashboard/	面向 Inbox host 的 React 运维界面
Blog backend	apps/blog/backend/	示例 Express API
Blog frontend	apps/blog/frontend/	示例 React 客户端
Blog E2E	apps/blog/e2e/	面向 blog 应用的 Playwright 黑盒测试

模块边界说明见 docs/modules.md。

仓库规则

• 每个模块都应该可以独立开发、独立测试。
• 跨模块只通过 HTTP 或 CLI 边界通信，不直接相互引用源码。
• 运行时数据、本地数据库、worktree、缓存和构建产物默认都不进仓库。

快速开始

统一从根目录 Makefile 进入：

make help
make build-inbox
make test-inbox
make test-dashboard
make test-blog-backend
make test-blog-frontend
make test-blog-e2e

各模块独立使用

Inbox host

cd inbox
go build ./cmd/inbox
go test ./...

更多说明见 inbox/README.md。

Dashboard

cd dashboard
npm ci
npm run dev
npm test

更多说明见 dashboard/README.md。

Blog 应用

cd apps/blog/backend && npm ci && npm test
cd apps/blog/frontend && npm ci && npm test
cd apps/blog/e2e && npm ci && npm test

更多说明见 apps/blog/README.md。

测试入口

• 快速测试：make test-all
• 浏览器 / E2E：make test-all-e2e
• 一次性安装全部 JS 依赖：make deps-all

当前目标

让每个模块边界清晰、职责单一，并且默认就是“方便使用、方便测试”的状态。