# 开发指南

> 从源码运行，理解架构并扩展能力。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

本章面向准备修改 AGW 源码或接入 API 的开发者。只想安装和使用 AGW，可以先阅读[快速开始](/zh/docs/start/)。

建议先完成[开发环境](/zh/docs/development/setup/)，再用[架构与模块边界](/zh/docs/development/architecture/)判断代码应放在哪里。接入客户端时阅读[API 与执行协议](/zh/docs/development/api/)，新增能力时阅读[扩展 Tools 与 Integrations](/zh/docs/development/extensions/)。提交改动前，按[测试与贡献约定](/zh/docs/development/testing/)完成相关验证。

---

本节页面：

- [开发环境与运行](/zh/docs/development/setup/): 安装依赖，独立运行后端、Web、Desktop 或 Mobile。
- [架构与模块边界](/zh/docs/development/architecture/): 理解模块化单体、数据所有权和客户端包分工。
- [API 与执行协议](/zh/docs/development/api/): 区分管理 JSON API、SignalR 执行与 A2A 协议。
- [扩展 Tools 与 Integrations](/zh/docs/development/extensions/): 选择能力归属，使用编译期工具声明与用户连接。
- [测试与贡献约定](/zh/docs/development/testing/): 按影响范围验证改动，遵守格式、边界和迁移规则。

---

反链：

- [文档](/zh/docs/)