CLI 参考

本页列出公开文档中会提到的常用命令。具体脚本行为以仓库当前版本为准。

启动和重启

./restart.sh

从仓库根目录启动或重启本地 Jarvis。它会使用本地环境文件、构建产物和默认端口规则。

bash scripts/status.sh

查看本机 Jarvis 相关进程、端口和运行状态。多 worktree 开发时，先用它确认哪个 checkout 拥有哪个实例。

curl http://127.0.0.1:8888/api/v1/health

验证后端是否健康，并确认运行版本。

cd frontend
npm install
npm run build

构建主 Web UI。纯前端变更通常先重建前端，再硬刷新浏览器。

cd services/docs-site
npm ci --no-audit
npm run dev
npm run build
npm run check

npm run check 会构建 Starlight 文档，并检查 Pagefind、内部链接和导航 slug。

cd services/jarvis-site
npm ci --no-audit
npm run build
npm test

这是 /app 和 /doc 被集成到 Cloudflare Pages public 目录前的本地验证路径。

.venv/bin/jarvis genkey -d "本地浏览器"

生成本地 Jarvis API 密钥。使用自定义 data dir 或无头后台实例时，带上同一个 --data-dir：

.venv/bin/jarvis genkey --data-dir "$HOME/.jarvis-headless" -d "headless admin"

不要把生成结果提交或公开。