sf init 在你的机器上生成一个自包含的项目。CLI 来自 PyPI——
你不需要 clone 平台仓库来获得它,也不需要 clone 它来使用它。
这个项目同时也是控制台意义上的一个项目:starforge.yaml 里的 name
就是把它里面每个实验的每次 run 归到一起的那个名字。
安装 CLI
uv tool install。它把 sf 装进独立环境,不会和你当前所在项目的依赖打架,而且 sf update
能升级它。如果用 pip 装进系统 Python,sf update 会拒绝升级并提示你改用 uv tool 重装——
因为在那里升级可能影响系统上的其他工具。
验证:
sf update,它会检测安装方式并选用对应的命令。源码在 core/starforge/cli/。
创建仓库
common/ 与 configs/;Console 准入后注入内容寻址 Job Capsule(manifest、bootstrap 与 PEX runner)。
项目发现
所有需要项目上下文的命令(sf new / submit / ls / validate …)从当前目录向上查找 starforge.yaml,类似 git 找仓库根。
sf login / logout / status 是全局命令,不要求在项目内。