From 82e266353b05e3c3fe92d2997f368041f51c344f Mon Sep 17 00:00:00 2001 From: Codex Date: Sat, 6 Jun 2026 08:30:31 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=20G14=20HWLAB=20API?= =?UTF-8?q?=20key=20=E5=8F=91=E7=8E=B0=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index dd7fcc11..55f5a3f4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -80,8 +80,9 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文 ## Critical HWLAB_API_KEY Discovery Rule -- P0: `HWLAB_API_KEY` 已在 master server 固化，统一来源是 `/root/.config/hwlab-v02/master-server-admin-api-key.env`；处理 HWLAB CLI、Code Agent、HWPOD、trace/result、Web 等价 CLI 或 v0.2 验收前，必须先从该文件加载或确认 key，禁止先把问题定性为缺少 API key。 -- P0: 查询 key 时只能输出 `HWLAB_API_KEY=present/missing`、source path 或 redacted prefix；禁止在 stdout、issue、trace、日志、AGENTS 或 docs 中打印完整 key。G14/HWLAB runtime 中环境变量缺失不代表 master server 没有 key，应先通过该统一来源注入再继续排查。 +- P0: `HWLAB_API_KEY` 已在 master server 和 G14 固化，统一来源路径都是 `/root/.config/hwlab-v02/master-server-admin-api-key.env`；处理 HWLAB CLI、Code Agent、HWPOD、trace/result、Web 等价 CLI 或 v0.2 验收前，必须先从当前执行 host 的该文件加载或确认 key，禁止先把问题定性为缺少 API key。 +- P0: master server 和 G14 的 `~/.bashrc` 会加载该固定文件，并通过 `BASH_ENV=$HOME/.bashenv` 让从交互 shell 派生的非交互 bash 也能读取 `HWLAB_API_KEY`；若当前进程没有继承环境，先显式 `source ~/.bashrc` 或确认该固定文件，不得改走别名、token、cookie 或临时 fallback。 +- P0: 查询 key 时只能输出 `HWLAB_API_KEY=present/missing`、source path 或 redacted prefix；禁止在 stdout、issue、trace、日志、AGENTS 或 docs 中打印完整 key。G14/HWLAB runtime 中环境变量缺失不代表 key 不存在，应先通过同一固定来源注入再继续排查。 ## Critical AgentRun Worktree Rule