用途:安装并启动 pace 个人仪表盘,提供 Bun 开发与 Docker 生产两条路径。
前置条件:Bun 路径需 Bun v1.3+;Docker 路径需 Docker 与 Docker Compose。
Bun 开发用法:克隆仓库后执行 bun install;复制 config.example.yaml 为 config.yaml 并编辑;运行 bun run dev,默认地址 http://localhost:7453。CLI 命令包括 serve、presets list、adapters list、adapters explain <type>、transforms list、transforms explain <type>、config check [path]、skill [name]。关键参数:-c/--config(默认 ./config.yaml)、-p/--port(默认 7453)、-P/--preset、-C/--chdir。环境变量 PACE_CONFIG 与 PORT 可覆盖,CLI 参数优先。可用 bun install && npm link 全局安装。
Docker 生产用法:复制并编辑 config.yaml,按需在 docker-compose.yml 中取消 config 卷挂载注释,执行 docker compose up -d;或 docker build -t pace . 后 docker run,挂载 ./config.yaml 与 pace-data:/app/data。也可直接使用预构建镜像 ghcr.io/av/pace:latest。数据卷持久化 SQLite 数据库。内置 preset 可用 pace presets list 查看,包含 tech-news、ml-ai、daily-brief 等,可用 --preset 启动。布局支持 image、text、iframe 组件及 bookmarks、counter 适配器。验证:访问 7453 端口,内容在首次适配器刷新后出现;可 POST /refresh/<panel-id> 立即刷新,GET /health 返回 {"status":"ok"}。
限制:需自行准备 config.yaml,否则报文件未找到;适配器类型拼写错误或 llm 配置缺失会导致相应问题,后者会静默透传数据。