agent-ecosystem/landing/product-docs/zh/developers/index.md
777genius 95e0f34d31 docs(product-docs): add zh, es, ja, fr, de doc translations
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese,
French and German (18 pages each), mirroring the existing en/ru structure.

- generate the 5 new locales in config.ts from a single strings table
  (nav, sidebar, search, footer, docFooter, outline, editLink) with
  locale-prefixed links
- rework DocsCardGrid from the binary isRu check to a per-locale map so
  the home cards render translated copy and prefixed links for every locale
2026-05-31 17:50:54 +03:00

3.7 KiB
Raw Blame History

title description lang
开发者中心 Agent Teams 文档 面向贡献者和开发者的 Agent Teams 入口,涵盖架构、护栏、调试以及 MCP 扩展路径。 zh-Hans

开发者中心

当你想要修改 Agent Teams 本身、调试团队启动,或用 MCP 工具扩展某个运行时,请使用本页。下面的链接指向仓库中的权威文档,使实现规则集中在一处。

从这里开始

需求 前往
仓库概览、脚本与源码设置 README.md
智能体导航与架构索引 AGENTS.md
面向智能体与贡献者的工作约定 CLAUDE.md
硬性实现护栏 AGENT_CRITICAL_GUARDRAILS.md
中型与大型功能的结构 功能架构标准
启动、引导与队友消息传递的调试 智能体团队调试手册
贡献流程 贡献指南
发布说明 / 更新日志 RELEASE.mdCHANGELOG.md

本地开发路径

运行桌面端 Electron 应用进行常规开发:

pnpm install
pnpm dev

浏览器/网页路径并不能替代桌面端运行时。桌面模式是受支持的本地路径,因为它包含 IPC、终端、提供方鉴权、团队生命周期处理、启动诊断以及真实团队所使用的运行时桥接。

架构检查点

在修改某个功能之前,先确定它的边界:

区域 预期归属
中型或大型产品功能 src/features/<feature-name>/
Electron 主进程编排 src/main/
Preload 安全 API 层 src/preload/
渲染器 UI 与应用状态 src/renderer/
共享类型与纯工具函数 src/shared/
Agent Teams 看板 MCP 服务器 mcp-server/
看板数据控制器 agent-teams-controller/

使用 src/features/recent-projects 作为功能组织的参考切片。保持跨进程契约的显式化,并避免跨功能边界进行深层导入。

调试路径

针对启动挂起、OpenCode 的 registered / 引导未确认状态、队友回复缺失,或可疑的任务日志:

  1. 调试手册开始。
  2. 检查 ~/.claude/teams/<team>/launch-failure-artifacts/latest.json 下最新的产物包。
  3. 打开产物中的 manifest.json,检查 classification、引导面包屑、启动诊断、成员 spawn 状态以及经过脱敏的日志末尾片段。
  4. 仅清理你能确认归属于本次冒烟测试或失败启动的团队、运行、面板或进程。

MCP 开发路径

Agent Teams 使用一个名为 agent-teams 的内置 MCP 服务器进行看板操作。用户级和项目级的 MCP 服务器可以为运行时添加外部能力。设置示例、.mcp.json 结构以及工具注册指引,参见 MCP 集成

相关文档