规范源文件：由 MetaRepo spec/ 同步，请勿直接编辑本页。

仓库关系说明

品牌：DoerFlow · 目标组织：github.com/doerflow（原 AgentSkillMesh）
版本: v0.1
最后更新: 2026-06-13
清单数据源: repos.manifest.json

组织迁移见 LuminaryWorks/spec/github-org-migration.md。下文 AgentSkillMesh 为迁移前组织名。

1. 三层结构

doerflow（GitHub 组织，目标名）
├── platform          MetaRepo · 私有 · 本仓库根目录（现 AgentSkillMesh/VibeAgent）
│   ├── spec/          规范源（Spec-Driven，不单独成 Git 仓）
│   ├── scripts/       克隆、初始化、同步规范
│   └── repos/         子仓库本地工作区
│       ├── docs       公开 · 文档站 + 同步后的 Spec
│       ├── site       公开 · 品牌官网 doerflow.dev
│       ├── contracts  私有 · 智能合约
│       ├── api        私有 · 索引 API
│       ├── web        私有 · DApp
│       ├── p2p        私有 · P2P SDK
│       ├── shared     私有 · 类型与 ABI
│       ├── wallet     私有 · RN 纯粹钱包（发任务）
│       ├── worker     私有 · RN 综合端（接单 + 社交）
│       └── admin      私有 · 运营管理（审核/告警）

层级	名称	Git 仓库（目标）	可见性	职责
组织	doerflow	—	—	品牌、GitHub 托管
产品	DoerFlow	`doerflow/platform`	私有	MetaRepo：规范、脚本、清单
子仓	docs	`doerflow/docs`	公开	Rspress 站点、白皮书、同步 Spec
子仓	site	`doerflow/site`	公开	品牌官网、产品介绍（doerflow.dev）
子仓	contracts	`doerflow/contracts`	私有	Solidity、部署脚本、export-abi
子仓	api	`doerflow/api`	私有	链上事件索引、REST、任务治理 API
子仓	web	`doerflow/web`	私有	React DApp、wagmi（Creator）
子仓	p2p	`doerflow/p2p`	私有	libp2p Beacon（v0.2+）
子仓	shared	`doerflow/shared`	私有	`@doerflow/shared`（原 `@vibe-agent/shared`）
子仓	wallet	`doerflow/wallet`	私有	RN 纯粹钱包：转账、收益、发布任务
子仓	worker	`doerflow/worker`	私有	RN 综合端：众包接单 + 社交平台任务
子仓	admin	`doerflow/admin`	私有	运营平台：审批、告警、订单总览

2. 依赖关系图

flowchart TB
  subgraph meta [VibeAgent MetaRepo]
    SPEC[spec/]
    MANI[repos.manifest.json]
  end

  subgraph chain [链上]
    C[contracts]
  end

  subgraph offchain [链下]
    S[shared]
    A[api]
    W[web]
    P[p2p]
    WL[wallet]
    WK[worker]
    AD[admin]
  end

  D[docs]

  SPEC -.->|规范驱动| C
  SPEC -.->|规范驱动| A
  SPEC -.->|规范驱动| W
  SPEC -.->|WALLET / WORKER| WL
  SPEC -.->|WORKER| WK
  SPEC -.->|ADMIN / TASK_GOVERNANCE| AD
  SPEC -.->|sync| D

  C -->|export-abi / deployments| S
  S --> A
  S --> W
  S --> WL
  S --> WK
  S --> P
  A -->|REST| W
  A -->|tasks publish/list| WL
  A -->|human-tasks / social| WK
  A -->|/admin/*| AD
  C -->|RPC| W
  C -->|Escrow| WL
  C -->|Escrow| WK
  WL -.->|发任务| A
  AD -->|审批 published| A
  WK -->|仅 published| A
  P -.->|v0.2 消息| W

2.1 代码依赖（运行时 / 构建时）

从 → 到	类型	说明
contracts → shared	构建产物	`export-abi` 写入 ABI；`deploy` 写 `deployments.json`
contracts → api	配置文件	`deployments.json`、`.env` 合约地址
contracts → web	配置文件	`public/deployments.json`、`.env`
shared → api	npm	`@vibe-agent/shared` 类型与常量
shared → web	npm	同上
shared → p2p	npm	同上
api → web	HTTP	DApp 调用 REST（市场列表、Escrow 索引）
api → wallet	HTTP	发布任务、Escrow 托管、收益
api → worker	HTTP	已发布任务列表、交付、社交任务登记
api → admin	HTTP	审核队列、告警、订单统计
shared → wallet / worker	npm	任务/Escrow 类型
web → contracts	RPC	Creator 钱包链上写操作
wallet → contracts	RPC	发单方托管/结算
worker → contracts	RPC	执行者接单/交付/收款
admin → api	HTTP	运营审批（无链上私钥）
docs → 各仓	无代码依赖	仅文档与同步的 Spec

2.2 变更传播顺序（跨仓 PR）

1. spec/SPEC.md（需求变更）
2. contracts → pnpm export-abi
3. shared（版本/tag）
4. api + web + wallet + worker + admin（联调）
5. sync-spec-to-docs → docs

3. 各仓库详细说明

3.1 VibeAgent（MetaRepo）

项	内容
路径	仓库根（非 `repos/` 下）
包含	`spec/`、`scripts/`、`repos.manifest.json`、`MVP_PLAN.md`、`WHITEPAPER.md`
不包含	子项目 `node_modules`（`repos/*` 在 `.gitignore` 中）
协作者	团队编排、规范评审、一键脚本

3.2 docs（公开）

项	内容
路径	`repos/docs`
技术栈	Rspress
与 Spec	`docs/technical/SPEC.md`、`REPOS.md` 由脚本从 `spec/` 同步
独有内容	`users/`、`developers/`、`platform/`、`vision/`、`whitepaper/`
部署	GitHub Pages → https://docs.doerflow.dev（Cloudflare DNS CNAME → `doerflow.github.io`）

3.3 site（品牌官网 · 公开）

项	内容
路径	`repos/site`
技术栈	Next.js 16 + Tailwind CSS 4
域名	doerflow.dev（根域）
与 docs 区分	docs = 技术文档；site = 营销官网、产品介绍
构建	`output: "export"` 静态导出（SSG，`out/`）
部署	Cloudflare Pages → doerflow.dev（`doerflow/site` · GitHub Actions）
端口	13010（`pnpm dev`）

3.4 contracts

项	内容
路径	`repos/contracts`
实现 Spec	`FR-ID-`、`FR-SK-`、`FR-ST-`；v0.15* `FR-DEX-001` → `src/metadex/`；v0.7* `FR-BRIDGE-*` → `src/bridge/` + OP Stack
输出	`artifacts/`、ABI → `api`/`web`/`shared`
关键脚本	`deploy:mvp`、`deploy:sepolia:full`、`deploy:metadex`、`export-abi`

3.5 api

项	内容
路径	`repos/api`
实现 Spec	§8 REST、`FR-SK-004` 索引、Escrow 状态同步
依赖	`shared`、`deployments.json`、SQLite（MVP）
端口	13008（见 `PORTS.md`）

3.6 web

项	内容
路径	`repos/web`
实现 Spec	§5.6 DApp、`FR-UI-*`
依赖	`shared`、`api`、wagmi、链上合约
端口	5174

3.7 p2p

项	内容
路径	`repos/p2p`
实现 Spec	§5.4 `FR-P2P-*`（v0.2 Alpha）
状态	MVP 阶段为 stub

3.8 shared

项	内容
路径	`repos/shared`
包名	`@vibe-agent/shared`
职责	跨仓类型、链 ID、合约地址常量、ABI 重导出

3.9 wallet（纯粹钱包 · React Native）

项	内容
路径	`repos/wallet`
规格	`spec/WALLET.md`、`spec/TASK_GOVERNANCE.md`
角色	发单方：转账、收益、发布任务（须确认 → 待审核）
依赖	`api`（任务发布）、`shared`、链上 Escrow
构建	Expo · `pnpm start` / `android` / `ios`

不含任务大厅与接单 — 见 worker。

3.10 worker（综合端 · React Native）

项	内容
路径	`repos/worker`
规格	`spec/WORKER.md`、`spec/CLIENTS.md`
角色	执行者：众包 Human Task + 社交平台任务（无障碍 v0.4）
依赖	`api`（仅 `published` 任务）、`shared`、Escrow
构建	Expo · 包名 `@vibe-agent/worker`

3.11 admin（运营管理 · Web）

项	内容
路径	`repos/admin`
规格	`spec/ADMIN.md`、`spec/TASK_GOVERNANCE.md`
职责	订单总览、简单任务自动过审、复杂人工复审、风控告警
依赖	`api` `/admin/*`
构建	Next.js + Ant Design · 默认端口 13011 · 域名 admin.doerflow.dev

与 web 区分：web = Creator DApp；admin = 内部运营。

4. 本地目录与 Git 远程

本地 `repos/`	GitHub 远程	默认分支
`docs`	`git@github.com:doerflow/docs.git`	main
`site`	`git@github.com:doerflow/site.git`	main
`contracts`	`git@github.com:doerflow/contracts.git`	main
`api`	`git@github.com:doerflow/api.git`	main
`web`	`git@github.com:doerflow/web.git`	main
`p2p`	`git@github.com:doerflow/p2p.git`	main
`shared`	`git@github.com:doerflow/shared.git`	main
`wallet`	`git@github.com:doerflow/wallet.git`	main
`worker`	`git@github.com:doerflow/worker.git`	main
`admin`	`git@github.com:doerflow/admin.git`	main

克隆 MetaRepo 后执行：./scripts/clone-repos.sh

5. 与 Turborepo / 单仓的区别

	单仓 Monorepo	VibeAgent Polyrepo
Git	一个仓库	MetaRepo + 10 个子仓库
规范	常放 `docs/` 或 `spec/`	MetaRepo `spec/` + 同步到 `docs`
发布	统一版本	各仓独立 tag
开源节奏	一次公开	当前 `docs` 与 `site` 公开，代码仓后续开源

6. 相关文档

ON THIS PAGE

仓库关系说明#

1. 三层结构#

2. 依赖关系图#

2.1 代码依赖（运行时 / 构建时）#

2.2 变更传播顺序（跨仓 PR）#

3. 各仓库详细说明#

3.1 VibeAgent（MetaRepo）#

3.2 docs（公开）#

3.3 site（品牌官网 · 公开）#

3.4 contracts#

3.5 api#

3.6 web#

3.7 p2p#

3.8 shared#

3.9 wallet（纯粹钱包 · React Native）#

3.10 worker（综合端 · React Native）#

3.11 admin（运营管理 · Web）#

4. 本地目录与 Git 远程#

5. 与 Turborepo / 单仓的区别#

6. 相关文档#