完善 SouWen HFS 在线预览、部署事务与验收文档 - #269

结果

本 PR 将 SouWen 的 canonical HFS Preview 收口为可操作、可验收且失败后 fail closed 的部署面：Panel 的 Search/LLM Search 请求与 Server contract 一致，完整功能有固定 deep link 与角色说明，部署事务在 settings mutation 后失败时暂停 Space 等待人工恢复，不再尝试用未知旧 Secret 值自动回滚。

本 PR 包含并扩展 #268 的 HFS registry 调整；#268 可在本 PR 合并后关闭。

主要变更

• 修正 Panel 请求合同：Search 固定单领域，LLM Search 固定单 configured Provider 与 single 策略；保留 loading/error/empty、深色模式、窄屏和键盘焦点行为。
• 新增 docs/live-preview.md，列出 Login、Search、LLM Search、Fetch、Providers、Runtime、Settings、Swagger、OpenAPI 和 probes 的直达入口、角色与验收顺序。
• 将 Space Secret name/schema preflight 与 mutation phase 分开；只有 settings_mutation_started=true 后的失败才触发 containment，写前失败不会暂停健康 Space。
• 扩展 trusted HFS smoke：authenticated admin ping/config/doctor、canonical redaction parity、edge-only 与完全匿名 Data/Admin API 负向鉴权。
• 采用当前 HFS v2.1 draft registry schema，登记 preview / primary / source、本地 env 与 raw YAML 事实源；正式公开 HFS 基线仍为 v2.0，generic sync 继续在读本地值和联网前 fail closed。
• 修正文档中的 RC4 Release、current-main deployment、Docker config mount、Space settings ownership 与失败恢复边界。既有 v2.0.0rc4 tag/Release 不移动、不覆盖。

影响与边界

• 目标仍只有 BlueSkyXN/SouWen canonical Space；不创建、移动或删除任何 Space/Bucket，不影响其他项目。
• Space repository 继续保持 private；当前 App domain 的 Panel/docs/probes 可预览，Data/Admin API 仍要求 SouWen application credential。
• 本 PR 本身不部署。合并并取得 exact final-main SHA 后，另用 deployment + publish=false + deploy_hfs=true 执行 factory rebuild 与 live acceptance。
• Secret 值不进入 Git、PR、日志、截图或 artifact；tracked registry 只保存名称和路径。

验证

• PYTHONPATH=src pytest tests/ -q --tb=short：2744 passed，2 skipped。
• cd panel && npm test && npm run build:local && npm run check:artifact：7 files / 48 tests PASS，single-file artifact readback PASS。
• ruff check src tests scripts：PASS；ruff format --check src tests scripts：908 files formatted。
• sdk-contract 与 server-contract profiles：PASS。
• Markdown links：65 files / 157 local links / 0 issues。
• Generated docs、legacy wording gate、git diff --check：PASS。
• actionlint -shellcheck= -pyflakes=：workflow YAML/expression lint PASS；默认外部 integrations 在本机 actionlint v1.7.7 出现 CPU loop，交由远端 CI 复核。
• HFS v2.1 draft checker（含 local values）：0 ERROR / 0 WARN；工具测试 74/74 PASS；generic sync 预期 exit 2，发生在读取本地值和联网前。
• 两个独立只读复核均给出 GO，无剩余 P1/P2 finding。

Review focus

1. .github/workflows/deploy-hf-space.yml 中 preflight、mutation marker、first write 与 containment 条件顺序。
2. scripts/hf_space_smoke.py 的 authenticated/edge-only/anonymous auth 矩阵与 redaction parity。
3. hfs-dev.toml 的 draft/public-baseline、registry-only 和 local fact-source 边界。
4. Panel Search/LLM Search 请求 shape 与文档矩阵是否一致。