尧图网页设计 
JiuwenSwarm 二次开发指南从源码搭建、调试到扩展自定义 Agent 的完整开发者路径【免费下载链接】jiuwenswarmJiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.项目地址: https://gitcode.com/gh_mirrors/ji/jiuwenswarmJiuwenSwarm 是基于 openJiuwen 构建的开源智能 AI Agent 项目能把大语言模型的能力通过日常通讯软件直接送到你手上。想深入 JiuwenSwarm 二次开发这篇完整开发者指南将带你走完三步核心路径从源码快速搭建开发环境→一键调试并跑通测试→通过扩展机制自定义你的专属 Agent。无需大量编程基础跟着步骤即可完成第一次修改与验证。先看懂 JiuwenSwarm 源码架构在动手前花 5 分钟了解项目结构能帮你快速定位要改的地方在哪。JiuwenSwarm 采用 Python 后端 前端界面的双栈架构目录职责jiuwenswarm/agents/智能体核心Swarm 集群、Harness、Agent 组装与注册jiuwenswarm/gateway/消息网关频道管理、路由、定时任务、心跳jiuwenswarm/channels/前端渠道Web 前端、TUI 终端界面、桌面端jiuwenswarm/extensions/扩展机制自定义 Agent 的插件入口jiuwenswarm/server/AgentServer 运行时会话、技能、MCP、A2UItests/单元测试与系统测试项目结构详细解析见官方文档docs/zh/developer_guide.md智能体概念图解见docs/zh/智能体.md。智能体 角色设定 工具 技能 记忆 工作空间 配置。理解这个公式你就理解了自定义 Agent 的本质——改变其中的任一项。三步完成 JiuwenSwarm 源码搭建环境要求一览依赖项版本要求用途操作系统Windows / macOS / Linux全平台支持Python≥3.11, 3.14推荐 3.11后端运行时Node.js≥18.xWeb 前端构建uv最新版Python 依赖管理Bun最新版TUI 终端界面编译一键安装步骤第 1 步克隆源码git clone https://gitcode.com/gh_mirrors/ji/jiuwenswarm cd jiuwenswarm第 2 步用 uv 创建虚拟环境并同步依赖uv venv --python3.11 source .venv/bin/activate # Windows 用 .venv\Scripts\activate uv syncuv sync会根据 pyproject.toml 和uv.lock自动安装全部依赖含 pytest 等开发依赖。依赖声明统一在这里管理添加新依赖用uv add package。第 3 步构建 Web 前端cd jiuwenswarm/channels/web/frontend npm install npm run build构建产物输出到frontend/dist供后端静态服务。至此开发环境就绪 ✅快速启动JiuwenSwarm 一键调试模式改完代码怎么验证官方提供了debug调试模式把「重新构建 重装依赖 后台启动」串成一条命令uv run jiuwenswarm-start debug它会自动依次执行Web 前端npm install→npm run build→ 根目录uv sync→ 后台启动全部服务AgentServer / Gateway / Web日志重定向到logs/swarm-时间戳.log。提速技巧如果只改了 Python 代码前端构建纯属浪费加--skip-build复用已有产物uv run jiuwenswarm-start debug --skip-build其他常用调试操作操作命令跟踪实时日志tail -f logs/swarm-时间戳.log停止后台服务uv run jiuwenswarm-stop仅后端改动uv run jiuwenswarm-init uv run jiuwenswarm-start仅前端改动前端目录执行npm run build启动成功后打开 Web 界面即可看到完整的工作页面——模式选择器、技能、频道、智能体管理一应俱全调试模式的实现源码在 jiuwenswarm/debug_launcher.py命令入口定义见 pyproject.tomljiuwenswarm-start/jiuwenswarm-stop/jiuwenswarm-init三个可执行入口。用测试用例验证你的修改修改代码后务必跑测试。⚠️ 关键点必须使用uv run pytest直接运行pytest会因环境不对报ModuleNotFoundError。# 运行全部单元测试 uv run pytest tests/unit_tests/ # 运行全部系统测试 uv run pytest tests/system_tests/ # 只跑指定测试文件开发时最常用的姿势 uv run pytest tests/unit_tests/test_config.py测试框架配置见 pytest.ini 与 tests/README.md。如果你要新增功能建议同步在tests/unit_tests/下补充对应的测试文件——仓库的 贡献指南 对此有规范说明。扩展机制定制你自己的专属 Agent这是 JiuwenSwarm 二次开发的灵魂。项目在 jiuwenswarm/extensions/ 内置了完整的插件式扩展框架无需 fork 核心代码即可注入自定义能力。扩展机制如何工作扩展加载流程由三个模块协作完成发现jiuwenswarm/extensions/loader.py 扫描扩展目录寻找含extension.yaml清单的扩展包并自动安装扩展声明的依赖注册jiuwenswarm/extensions/registry.py 提供扩展点目前已开放AgentServer 客户端、加解密工具、第三方 AgentThirdAgent三类注册接口还支持回调事件系统register/trigger挂载自定义钩子基类jiuwenswarm/extensions/sdk/base.py 定义了BaseExtension只需实现initialize()和shutdown()两个生命周期方法。内置扩展 jiuwenswarm/extensions/agent_client/ 是最佳参考范例一个extension.yaml描述元数据id、版本、依赖、配置 schema一个extension.py实现register_extensions(registry)函数完成注册——清单模板见 jiuwenswarm/extensions/agent_client/extension.yaml。编写你的第一个扩展概念流程在扩展目录下新建extension.yaml声明你的扩展 id、版本与dependencies新建extension.py写一个继承BaseExtension或AgentServerClientExtension等专用基类的类在register_extensions(registry)中把实例注册进registry通过配置项extensions.extension_dirs指定你的扩展目录重启服务即生效。想接入外部智能体可参考第三方 Agent 扩展 SDKjiuwenswarm/extensions/sdk/third_agent.py。在 Web 端「智能体」页面可以查看任意 Agent 的工作区文件与记忆内容——你自定义的 Agent 同样会在这里呈现其工作空间。打包分发把你的改动交付出去二次开发完成后项目支持两种分发形式wheel 包在根目录执行bash scripts/build.sh一键产出主包jiuwenswarm.whl和 TUI sidecar 包jiuwenswarm-tui.whl构建配置分别位于 pyproject.toml 与 packages/jiuwenswarm-tui/pyproject.toml桌面 EXE / DMG基于 PyInstallerWindows 用scripts\build-exe.batmacOS 用bash scripts/build-macos.sh。完整的打包细节含 jiuwenbox 沙箱包单独构建见 docs/zh/developer_guide.md 第 6 章与 docs/zh/打包exe指南.md。常见问题排查问题原因与解决ModuleNotFoundError: No module named xxx没用uv run前缀改用uv run pytest ...--skip-build报前端 dist 不存在先完整跑一次jiuwenswarm-start debug生成前端产物debug 模式拒绝启动已有 debug 服务在跑先uv run jiuwenswarm-stop测试单独跑通过、全量跑失败某测试污染了全局状态用二分法定位总结你的 JiuwenSwarm 二次开发路线图搭环境git clone→uv venv→uv sync→npm run build跑起来uv run jiuwenswarm-start debug一键调试--skip-build提速改代码后端改 Python、前端改 Web、TUI 用 Bun 编译验修改uv run pytest跑单元测试与系统测试做扩展借助jiuwenswarm/extensions/扩展机制注册你的自定义 Agent发出去scripts/build.sh打 wheel 包或桌面安装包。从读源码到交付定制 AgentJiuwenSwarm 的每一步都有现成脚本和文档支撑。现在就可以打开终端跑通你的第一条 debug 命令了 【免费下载链接】jiuwenswarmJiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.项目地址: https://gitcode.com/gh_mirrors/ji/jiuwenswarm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 JiuwenSwarm 二次开发指南：从源码搭建、调试到扩展自定义 Agent 的完整开发者路径
JiuwenSwarm 二次开发指南从源码搭建、调试到扩展自定义 Agent 的完整开发者路径【免费下载链接】jiuwenswarmJiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.项目地址: https://gitcode.com/gh_mirrors/ji/jiuwenswarmJiuwenSwarm 是基于 openJiuwen 构建的开源智能 AI Agent 项目能把大语言模型的能力通过日常通讯软件直接送到你手上。想深入 JiuwenSwarm 二次开发这篇完整开发者指南将带你走完三步核心路径从源码快速搭建开发环境→一键调试并跑通测试→通过扩展机制自定义你的专属 Agent。无需大量编程基础跟着步骤即可完成第一次修改与验证。先看懂 JiuwenSwarm 源码架构在动手前花 5 分钟了解项目结构能帮你快速定位要改的地方在哪。JiuwenSwarm 采用 Python 后端 前端界面的双栈架构目录职责jiuwenswarm/agents/智能体核心Swarm 集群、Harness、Agent 组装与注册jiuwenswarm/gateway/消息网关频道管理、路由、定时任务、心跳jiuwenswarm/channels/前端渠道Web 前端、TUI 终端界面、桌面端jiuwenswarm/extensions/扩展机制自定义 Agent 的插件入口jiuwenswarm/server/AgentServer 运行时会话、技能、MCP、A2UItests/单元测试与系统测试项目结构详细解析见官方文档docs/zh/developer_guide.md智能体概念图解见docs/zh/智能体.md。智能体 角色设定 工具 技能 记忆 工作空间 配置。理解这个公式你就理解了自定义 Agent 的本质——改变其中的任一项。三步完成 JiuwenSwarm 源码搭建环境要求一览依赖项版本要求用途操作系统Windows / macOS / Linux全平台支持Python≥3.11, 3.14推荐 3.11后端运行时Node.js≥18.xWeb 前端构建uv最新版Python 依赖管理Bun最新版TUI 终端界面编译一键安装步骤第 1 步克隆源码git clone https://gitcode.com/gh_mirrors/ji/jiuwenswarm cd jiuwenswarm第 2 步用 uv 创建虚拟环境并同步依赖uv venv --python3.11 source .venv/bin/activate # Windows 用 .venv\Scripts\activate uv syncuv sync会根据 pyproject.toml 和uv.lock自动安装全部依赖含 pytest 等开发依赖。依赖声明统一在这里管理添加新依赖用uv add package。第 3 步构建 Web 前端cd jiuwenswarm/channels/web/frontend npm install npm run build构建产物输出到frontend/dist供后端静态服务。至此开发环境就绪 ✅快速启动JiuwenSwarm 一键调试模式改完代码怎么验证官方提供了debug调试模式把「重新构建 重装依赖 后台启动」串成一条命令uv run jiuwenswarm-start debug它会自动依次执行Web 前端npm install→npm run build→ 根目录uv sync→ 后台启动全部服务AgentServer / Gateway / Web日志重定向到logs/swarm-时间戳.log。提速技巧如果只改了 Python 代码前端构建纯属浪费加--skip-build复用已有产物uv run jiuwenswarm-start debug --skip-build其他常用调试操作操作命令跟踪实时日志tail -f logs/swarm-时间戳.log停止后台服务uv run jiuwenswarm-stop仅后端改动uv run jiuwenswarm-init uv run jiuwenswarm-start仅前端改动前端目录执行npm run build启动成功后打开 Web 界面即可看到完整的工作页面——模式选择器、技能、频道、智能体管理一应俱全调试模式的实现源码在 jiuwenswarm/debug_launcher.py命令入口定义见 pyproject.tomljiuwenswarm-start/jiuwenswarm-stop/jiuwenswarm-init三个可执行入口。用测试用例验证你的修改修改代码后务必跑测试。⚠️ 关键点必须使用uv run pytest直接运行pytest会因环境不对报ModuleNotFoundError。# 运行全部单元测试 uv run pytest tests/unit_tests/ # 运行全部系统测试 uv run pytest tests/system_tests/ # 只跑指定测试文件开发时最常用的姿势 uv run pytest tests/unit_tests/test_config.py测试框架配置见 pytest.ini 与 tests/README.md。如果你要新增功能建议同步在tests/unit_tests/下补充对应的测试文件——仓库的 贡献指南 对此有规范说明。扩展机制定制你自己的专属 Agent这是 JiuwenSwarm 二次开发的灵魂。项目在 jiuwenswarm/extensions/ 内置了完整的插件式扩展框架无需 fork 核心代码即可注入自定义能力。扩展机制如何工作扩展加载流程由三个模块协作完成发现jiuwenswarm/extensions/loader.py 扫描扩展目录寻找含extension.yaml清单的扩展包并自动安装扩展声明的依赖注册jiuwenswarm/extensions/registry.py 提供扩展点目前已开放AgentServer 客户端、加解密工具、第三方 AgentThirdAgent三类注册接口还支持回调事件系统register/trigger挂载自定义钩子基类jiuwenswarm/extensions/sdk/base.py 定义了BaseExtension只需实现initialize()和shutdown()两个生命周期方法。内置扩展 jiuwenswarm/extensions/agent_client/ 是最佳参考范例一个extension.yaml描述元数据id、版本、依赖、配置 schema一个extension.py实现register_extensions(registry)函数完成注册——清单模板见 jiuwenswarm/extensions/agent_client/extension.yaml。编写你的第一个扩展概念流程在扩展目录下新建extension.yaml声明你的扩展 id、版本与dependencies新建extension.py写一个继承BaseExtension或AgentServerClientExtension等专用基类的类在register_extensions(registry)中把实例注册进registry通过配置项extensions.extension_dirs指定你的扩展目录重启服务即生效。想接入外部智能体可参考第三方 Agent 扩展 SDKjiuwenswarm/extensions/sdk/third_agent.py。在 Web 端「智能体」页面可以查看任意 Agent 的工作区文件与记忆内容——你自定义的 Agent 同样会在这里呈现其工作空间。打包分发把你的改动交付出去二次开发完成后项目支持两种分发形式wheel 包在根目录执行bash scripts/build.sh一键产出主包jiuwenswarm.whl和 TUI sidecar 包jiuwenswarm-tui.whl构建配置分别位于 pyproject.toml 与 packages/jiuwenswarm-tui/pyproject.toml桌面 EXE / DMG基于 PyInstallerWindows 用scripts\build-exe.batmacOS 用bash scripts/build-macos.sh。完整的打包细节含 jiuwenbox 沙箱包单独构建见 docs/zh/developer_guide.md 第 6 章与 docs/zh/打包exe指南.md。常见问题排查问题原因与解决ModuleNotFoundError: No module named xxx没用uv run前缀改用uv run pytest ...--skip-build报前端 dist 不存在先完整跑一次jiuwenswarm-start debug生成前端产物debug 模式拒绝启动已有 debug 服务在跑先uv run jiuwenswarm-stop测试单独跑通过、全量跑失败某测试污染了全局状态用二分法定位总结你的 JiuwenSwarm 二次开发路线图搭环境git clone→uv venv→uv sync→npm run build跑起来uv run jiuwenswarm-start debug一键调试--skip-build提速改代码后端改 Python、前端改 Web、TUI 用 Bun 编译验修改uv run pytest跑单元测试与系统测试做扩展借助jiuwenswarm/extensions/扩展机制注册你的自定义 Agent发出去scripts/build.sh打 wheel 包或桌面安装包。从读源码到交付定制 AgentJiuwenSwarm 的每一步都有现成脚本和文档支撑。现在就可以打开终端跑通你的第一条 debug 命令了 【免费下载链接】jiuwenswarmJiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.项目地址: https://gitcode.com/gh_mirrors/ji/jiuwenswarm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考