eyeful

部署上线 ​

这一页说明 eyeful 发布了什么、各部分运行在哪里，以及怎样开启云端审查。从源码运行 eyeful 见开发，所有变量见配置，发布时间见路线图。

云端审查通过仓库根目录的 composite action action.yml 在 GitHub Actions 里运行。本地部分是桌面应用和 eyeful 命令，不需要服务器。所有东西都要在 CI 通过后才发布：文档站在 main 上每次 CI 通过后发布到 GitHub Pages（docs.yml）；v* tag 先跑 CI 再跑 GoReleaser（release.yml、.goreleaser.yml），把 Linux 和 macOS 的 eyeful CLI 以压缩包、.deb 和 .rpm 形式附到 GitHub release 上。目前还没有打过任何版本。CI（.github/workflows/ci.yml）运行 mise run check，然后构建审查镜像和沙箱镜像；推送到 main 或打 tag 时，以该名字发布到 ghcr.io。

产物 ​

产物构建方式运行在
审查镜像和沙箱镜像main 和 tag 上的 CI（Dockerfile、Dockerfile.sandbox），发布在 ghcr.io/pleasurecruise/eyeful-action 和 -sandboxGitHub Actions runner
桌面应用mise run package:desktop（Wails）macOS、Windows、Linux
eyefulmise run install，或 v* tag（GoReleaser）用户的机器
文档站mise run build:docs（VitePress）DOCS_URL 上的 GitHub Pages

审查镜像里有 eyeful-action、git、/opt/pi 下的 pi 1.4.0、带有 cmd/eyeful-action/pi/ 中 pi 设置的用户 agent，以及以 agent 身份运行 pi 的 /usr/local/bin/pi。沙箱镜像里有 eyeful-sandbox 和 mise，配置在 cmd/eyeful-sandbox/mise.toml。它预装 Node、Go、Python、Rust、pnpm、Yarn、Bun、uv 和 Poetry；项目自己的版本文件（mise.toml、.nvmrc、package.json 里的 packageManager、go.mod、.python-version、rust-toolchain.toml）决定实际使用的版本，缺的版本由 mise 在第一次使用时安装。

云端 ​

两个容器共用 Docker 网络 eyeful 和目录 $RUNNER_TEMP/eyeful，挂载在 /work：审查容器可读写，沙箱只读。

开启审查 ​

需要一个开通了 Coding Plan 的火山方舟 API key（控制台）、一个 TypeSafe API key，以及已登录的 GitHub CLI。在仓库的默认分支上运行：

sh
gh secret set EYEFUL_MODEL_KEY          # 粘贴火山方舟 key
gh secret set EYEFUL_TYPESAFE_API_KEY   # 粘贴 TypeSafe key
curl -fsSL https://raw.githubusercontent.com/Pleasurecruise/eyeful/main/.github/workflows/eyeful.yml \
  --create-dirs -o .github/workflows/eyeful.yml
git add .github && git commit -m "ci: review pull requests with eyeful" && git push

前两条命令把 key 存成仓库 secrets。第三条复制 eyeful 自己的 .github/workflows/eyeful.yml，它调用可复用 workflow .github/workflows/review.yml。其余都在那里：谁能发起审查、同一 pull request 同时只跑一次审查、action 的输入。它从不检出 pull request；eyeful-action 自己克隆，并且只在沙箱里运行它的代码。

本地 ​

本地模式只安装应用本身。它不需要服务器、数据库、eyeful 账号或模型密钥，因为 agent 就是用户已经登录的编码工具；只有 Jev 需要一个 TypeSafe API key。

eyeful review 用 eyeful connect 选定的 agent 运行审查；桌面应用在窗口里做同样的事（见桌面应用）。本地审查可以运行什么、怎样隔离，见本地运行。