视界云遥
产品
架构
路线图
生态
开发
产品
架构
路线图
生态
开发

MetaRepo 结构

VistaCast 采用 MetaRepo + pnpm workspace + bash/ps1 脚本 编排多子仓，与 VistaRemote、LuminaryWorks 生态一致。

目录结构

vistacast/                    MetaRepo（VistaCast/vistacast）
├── .meta/
│   ├── manifest.json         子仓清单与 clone 顺序
│   └── config.json           品牌、端口、clone 协议
├── spec/                     规范源（始终留在 MetaRepo）
├── artifacts/                M1 起：OpenAPI、事件 schema
├── docs/                     Rspress 文档站（D0 in-tree）
├── tooling/scripts/          init-repos.mjs、dev-docs.mjs
├── shared/                   M1 子仓（init.sh 克隆）
├── server/
├── web/
├── ai/
├── deploy/
├── init.sh / init.ps1        克隆子仓
├── dev.sh / dev.ps1          D0：启动 docs；M1：扩展全栈
├── pnpm-workspace.yaml
└── vistacast.code-workspace

子仓清单

键 路径 状态 说明
docs docs/ ✅ in-tree Rspress，D0 可用
spec spec/ ✅ in-tree 规范源
shared shared/ ⬜ M1 Zod / 共享类型
server server/ ⬜ M1 NestJS API
web web/ ⬜ M1 Admin Console
ai ai/ ⬜ M1 检测 Worker
deploy deploy/ ⬜ M1 Docker Compose

常用命令

pnpm install          # workspace 依赖（含 docs）
./dev.sh              # 启动 Rspress（端口 13102）
./init.sh             # M1 起克隆 server/web/...
pnpm dev:docs         # 等价 dev.sh
pnpm build:docs       # 构建静态站 → docs/doc_build

工作区

打开 vistacast.code-workspace 可同时编辑 MetaRepo、spec/、docs/ 与未来子仓。

与 VistaRemote 对齐

项 VistaRemote VistaCast
MetaRepo vibeCode vistacast
清单 .meta/manifest.json 同
init ./init.sh 同
文档 Rspress 子仓 D0 in-tree，后续可拆
ON THIS PAGE