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 目录前的本地验证路径。

API 密钥

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

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

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

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

扩展包

.venv/bin/jarvis extensions validate examples/extensions/ssh-tunnel-pack

校验本地声明式扩展包目录。该命令只读文件，不写入 Jarvis 数据库。

.venv/bin/jarvis extensions package examples/extensions/ssh-tunnel-pack --out dist/ssh-tunnel-0.1.0.jarvispack

把扩展包目录打成 .jarvispack 归档。安装命令可以直接接收 server-local 目录或 .jarvispack 文件。

.venv/bin/jarvis extensions install examples/extensions/ssh-tunnel-pack --enable

安装本地扩展示例包目录。--enable 会立即 materialize pack 贡献的配置档、工作流和斜杠命令。

.venv/bin/jarvis extensions registry-install jarvis.memagora --version 0.3.3 --enable --install-native-dependencies

从已配置的公共插件目录安装签名扩展包。main/stable 默认可用；显式设置 JARVIS_EXTENSION_REGISTRY_ENABLED=0 或 gated 构建会关闭。需要本机 daemon 的插件必须显式传 --install-native-dependencies，否则只安装 pack。常用选项包括 --version、--channel、--registry-url、--install-native-dependencies 和 --data-dir。

.venv/bin/jarvis extensions list
.venv/bin/jarvis extensions enable example.ssh-tunnel
.venv/bin/jarvis extensions disable example.ssh-tunnel
.venv/bin/jarvis extensions uninstall example.ssh-tunnel

管理已安装扩展包。上面的 example.ssh-tunnel 来自本地示例 pack，不是公共 Registry listing；使用自定义数据目录时，给 lifecycle 命令加同一个 --data-dir。