Prhub

#2533 docs: rebrand environments bullet as agentic, add HUD, sync README and docs index

原始 PR 作者 nblintao 合并时间 2026-08-14 08:43 文件变更 3 提交数 1 评论 0 代码增减 +11 / -10

执行摘要

环境 bullet 改名 Agentic 并补上 HUD 连接器

PR body 指出:README 与 docs index 中的 "Coding-agent environments" bullet 链接到的 Agentic Environments 页面实际还覆盖 computer-use (HUD) 和 tool-calling (τ-bench) 连接器,而 bullet 因标签限制完全没提到 HUD。因此需要重命名 bullet、补齐连接器列表,并把链接改为句尾 "See ..." 格式,使标题、内容与页面描述保持一致。

无需精读,可作为"功能上线后同步宣传文档"的小型参考。值得注意的设计决策:将链接从连接器列表中移出放到句尾,保持 README 与 docs 首页同步,并让概述页明确覆盖范围。若关注文档与功能一致性治理,可留意 PR#2491 → PR#2533 的演进链。

讨论亮点

本 PR 无任何 review 评论或讨论线程。唯一审核人 Shi-Dong 给出 APPROVED,未附意见。因此没有需要记录的争议或设计权衡。

实现拆解

  1. README.md:将相邻于 "Wide recipe support" 的特征 bullet 从 "Coding-agent environments" 改写为 "Agentic environments",首句改为 "Train coding and computer-use agents through connectors for",列出 Harbor、HUD、NeMo Gym、OpenEnv、Verifiers 五个主要连接器,Strands Agents / τ-bench 并入 "and more",链接以 "See Agentic Environments" 的形式移到句尾,与 Day-0 models、hardware 等相邻 bullet 的样式对齐。
  2. docs/index.md:镜像 README 的同一措辞,链接改为站点相对路径 /user-guide/environments,避免绝对 URL 在部署环境下失效。
  3. docs/user-guide/environments.md:在 "An external ecosystem" bullet 中追加 "spanning coding, computer-use and tool-calling agents",明确外部连接器生态覆盖三类 agent,与 README 的新表述互相印证。
  4. 配套说明:无测试、配置或部署配套改动;纯文档变更,但需保证 docs 站点构建时相对链接正确解析。
文件 模块 状态 重要度
README.md 项目首页 modified 2.1
docs/index.md 文档首页 modified 2.1
docs/user-guide/environments.md 环境指南 modified 1.56

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

纯文档变更,风险极低。主要潜在风险:

1) README 使用绝对 URL 而 docs/index.md 使用相对路径,若站点域名或部署路径变化需要同步更新;
2) Strands Agents / τ-bench 被并入 "and more",对这两项连接器的推广可见性略有下降;
3) 未来若连接器列表变化,README 与 docs/index 需要再次同步。无代码逻辑,因此不存在回归、性能或安全风险。

影响范围集中在文档可见性:README 和 docs 首页对 Miles 支持环境的描述从 coding-only 修正为 agentic(含 computer-use 与 tool-calling),HUD 等新连接器获得宣传曝光;对用户来说减少了"页面有但首页没提"的信息落差。团队维护上,文档口径与 PR#2491 的改名保持一致,后续修改环境列表需同步这三处文档。整体影响程度低。

纯文档变更 文案一致性 低风险

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论