快速开始#

当前阶段 D0：MetaRepo 与文档站可用；server / web 等实现子仓在 M1 编码启动后通过 init.sh 克隆。

环境要求#

• Git
• Node.js ≥ 22
• pnpm ≥ 9

克隆 MetaRepo#

git clone git@github.com:VistaCast/vistacast.git
cd vistacast

Windows 本地路径：D:\www\vistacast

启动文档站（D0 默认开发命令）#

pnpm install
./dev.sh          # Linux / macOS
# 或
.\dev.ps1         # Windows

等价命令：

pnpm dev:docs
# 或
cd docs && pnpm install && pnpm dev

默认端口：13102（见 .meta/config.json）

打开工作区#

在 Cursor / VS Code 中打开 vistacast.code-workspace，可同时编辑 MetaRepo、spec/ 与 docs/。

M1 起：克隆实现子仓#

编码启动后，子仓将发布至 GitHub VistaCast 组织：

./init.sh                    # 克隆 shared / server / web / ai / deploy
./init.sh --only docs,server # 按需克隆
./init.sh --https            # HTTPS 协议

docs/ 当前 内嵌 MetaRepo（in-tree），无需 clone；后续可拆至 VistaCast/docs 独立仓。

阅读 Spec#

MetaRepo 根目录 spec/ 为规范源：

1. strategic-analysis.md
2. product-roadmap.md
3. architecture.md

下一步#

• 产品路线图
• Spec 驱动开发
• LuminaryWorks 生态