mirrors/pikasTech-HWLAB
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c4fb3d4fbfbb2b131ed09cd97bba942dc4dd98a8
pikasTech-HWLAB/AGENTS.md
T
Codex a59bed9a2a fix gateway shell head-of-line blocking
2026-05-25 03:16:55 +00:00

8.7 KiB
Raw Blame History

HWLAB Agent 顶级索引

HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥官和 runner 进入本仓库时的顶级索引，只放入口、一句话规则和长期参考链接；细则统一维护在 docs/reference/。

P0 D601 k3s 控制面归一

  • D601 的 HWLAB DEV 运行态只允许使用自部署原生 k3s；Docker Desktop Kubernetes 已经停用并清理数据，任何人不得重新启用或把它作为 HWLAB DEV、MVP、CI/CD、smoke、部署或验收目标。跨仓库事故跟踪见 pikasTech/unidesk#138，指挥官热修复背景见 pikasTech/unidesk#118。
  • D601 上裸 kubectl 不可信：默认 kubeconfig 可能仍残留 docker-desktop / 127.0.0.1:11700。所有 D601 hwlab-dev 只读观测、DEV CD、rollback、smoke 和排障必须显式使用 KUBECONFIG=/etc/rancher/k3s/k3s.yaml，并确认节点名是 d601。
  • 发现 docker-desktop context、desktop-control-plane 节点、Docker Desktop Kubernetes 中的 hwlab-dev 残留，或同一 HWLAB 资源被第二控制面承载时，必须停止部署/验收并按 #138 处理；不要把第二控制面或失效默认 kubeconfig 的输出作为 DEV-LIVE 证据。

P0 GitHub Issue 写入纪律

  • HWLAB #7、用户反馈、长期看板和指挥简报的 GitHub issue 正文写入必须走 UniDesk CLI：cd /root/unidesk && bun scripts/cli.ts gh ...；禁止直接用原生 gh issue edit/create/comment 写这些 issue。事故和工具补强需求见 pikasTech/unidesk#142。
  • 在 UniDesk CLI 局部替换、写前备份和写后 hash 验证能力完成前，不要对 #7 做无 guard 的整篇 body replace；必须先保留 before body、确认维护纪律 heading 仍存在，再写入。

工作区

  • Runner 和指挥常用工作区是 /workspace/hwlab；进入仓库先检查分支与工作树状态，详见 docs/reference/commander-collaboration.md。
  • D601 发布/构建工作区是 /home/ubuntu/workspace/hwlab；不要把 runner 临时目录当作发布真相，详见 docs/reference/deployment-publish.md。
  • Master server 只做控制、Git、issue/PR 和短轮询；HWLAB check、Playwright、本地构建、发布预检和 CI/CD 验证必须放到 D601/runner/CI/CD，详见 docs/reference/deployment-publish.md。
  • 当前一律走 PR 工作流；不要直推 main，默认不要合并自己的 PR；用户或指挥官明确授权且满足门禁时可按长期参考自合并，不要改 PROD、不要重启服务。
  • DC-DCSN-P0-2026-003 / pikasTech/HWLAB#78 是当前 M3 虚拟硬件可信闭环的上位约束；其他任务不得把 SOURCE、LOCAL、DRY-RUN、fixture 或前端状态误报为 M3 DEV-LIVE。
  • 仓库禁止创建或提交 repo report 目录；验收、进展和结论只承载在 #7、专题 issue、每日简报或 PR/issue 评论。临时 JSON 只能写入 /tmp、.state 或 CI artifact，不能进入源码仓库。

固定入口

长期参考

工作优先级

  • 中文优先：issue、PR 正文、长期参考文档和用户可见说明默认用中文；英文术语只在命令、协议、接口、ID、路径和标准名需要保真时保留，详见 docs/reference/chinese-first-documentation.md。
  • 用户反馈优先：用户和参谋提出的问题默认按高优先级用户反馈处理，blocker 状态不能替代反馈分流，必须挂到 pikasTech/HWLAB#7 醒目位置，详见 docs/reference/user-feedback-triage.md。
  • docs-spec 本地权威优先：涉及 AGENTS.md、docs/reference/*.md 或过程文档蒸馏时，先按 docs/reference/documentation-governance.md 执行，不另建同级规则副本。
  • PR 工作流优先：从最新 origin/main 创建短分支，提交 PR 到 pikasTech/HWLAB:main，runner 不直推 main，默认不自合并；显式授权且满足门禁时按协作规则收口，不改 PROD、不重启服务，详见 docs/reference/commander-collaboration.md。

常用轻量命令

  • 静态合同校验：npm run validate
  • Cloud Web 静态检查：npm run web:check
  • Cloud Web 构建：npm run web:build
  • Cloud Web M3 只读护栏：npm run web:m3-readonly
  • Cloud Workbench 布局/遮挡 smoke：npm run web:layout；local-build 用 npm run web:layout:build；DEV deploy 后用 npm run web:layout:live。
  • DEV artifact 发布预检：npm run dev-artifact:preflight
  • DEV artifact CI 发布：node tools/hwlab-cli/bin/hwlab-cli.mjs cicd submit --kind ci-publish --concurrency 4
  • DEV 依赖 runtime base 构建：npm run dev-runtime-base:build
  • DEV CD 单事务发布/应用/验证：node tools/hwlab-cli/bin/hwlab-cli.mjs cicd submit --kind dev-cd-apply --confirm-dev --confirmed-non-production --concurrency 4
  • CI/CD job 查询：node tools/hwlab-cli/bin/hwlab-cli.mjs cicd status|logs|report <jobId>
  • runner GitHub 可见性预检：npm run runner:issue-visibility:preflight
  • D601 k3s 只读观测：npm run d601:k3s:readonly
  • DEV runtime hotfix 只读审计计划：npm run dev-runtime:hotfix-audit
  • Gateway 主动出站本地 smoke：npm run gateway:demo:smoke；经本地 edge-proxy 验证用 npm run gateway:demo:edge-smoke。

D601 k3s 只读观测

HWLAB DEV runtime（运行态）在 D601 原生 k3s；只读诊断或手动发布必须显式使用 /etc/rancher/k3s/k3s.yaml，详见 docs/reference/dev-runtime-boundary.md。

禁止误判

Reference in New Issue View Git Blame Copy Permalink