Kuroyuu-多智能体AI编排平台
查看： https://www.kuroryuu.com/ 了解更多信息！
活力x基洛黑客马拉松参赛作品 |2026年1月5日至30日|开发26天
Kuroyuu（黑龙）是一个生产就绪的多代理AI编排平台，使自主AI代理能够在复杂的软件开发任务上进行协作。具有Ralph leader编排、通过PowerShell/Win32 API实现桌面自动化以及6个提供商的61多个LLM模型。
Kuroryuu Desktop - Multi-agent orchestration with terminal, chat, and code panels
Home Overview - Dragon landing page with guided tour
Agents Dashboard - Heartbeat configuration, identity, and action execution modes
About - We're Doing This For Marlee Rose
先决条件
对于Windows（本机安装）：
- Python 3.12 （MCP Core需要-使用旧版本中没有的FastAPI功能）
- Node.js 18+ （适用于桌面和Web应用程序）
- Git （用于克隆）
- 视窗 （PowerShell脚本、用于桌面自动化的Win32 API）
对于Docker（跨平台）：
- 码头工人 Docker Compose
- 适用于Windows、Linux、macOS
安装
1.克隆存储库
git clone https://github.com/ahostbr/kuroryuu-public
cd kuroryuu-public2.运行安装脚本
.\setup-project.ps1此脚本会自动执行以下操作：
- 集合
KURORYUU_PROJECT_ROOT环境变量（持久） - 生成
.mcp.json从具有解析路径的模板 - 创建Python 3.12虚拟环境(
.venv_mcp312) - 安装所有Python依赖项（mcp_core、gateway、mcp_stdio）
- 安装所有Node.js依赖项（桌面、pty_daemon、web）
- 检查所需的构建资产
可选标志：
.\setup-project.ps1 -SkipPython # Skip Python venv and deps
.\setup-project.ps1 -SkipNode # Skip Node.js deps
.\setup-project.ps1 -Force # Overwrite existing configs3.重新启动终端
在设置完成之后， 重新启动终端 以获取新的环境变量。
4.启动所有服务
.\run_all.ps1快速启动（安装后）
# Start all services (gateway, mcp_core, desktop)
.\run_all.ps1
# Stop all services
.\kill_all.ps1
# Or start individually
cd apps/gateway && python server.py # Gateway (port 8200)
cd apps/mcp_core && python server.py # MCP Core (port 8100)
cd apps/desktop && npm run dev # Desktop App访问应用程序：
- 桌面应用：自动启动
- 网关API: http://127.0.0.1:8200/docs
- MCP核心: http://127.0.0.1:8100/mcp
Docker安装（后端开发/CI）
Docker支持是为了 后端开发人员 和 CI管道黑龙是Windows第一；完整功能需要安装本机Windows。
快速开始
# 1. Clone repository
git clone https://github.com/ahostbr/kuroryuu-public
cd kuroryuu-public
# 2. Configure environment
cp .env.example .env
# Edit .env and set ANTHROPIC_API_KEY (required for chat)
# 3. Start all services
docker-compose up -d
# 4. Verify health
docker-compose ps
curl http://localhost:8100/health # MCP Core
curl http://localhost:8200/v1/health # Gateway
curl http://localhost:7073/health # PTY Daemon
curl http://localhost:3000/ # Web UI服务
| 服务 | 端口 | 运行状况端点 | 目的 |
|---|---|---|---|
| MCP核心 | 8100 | /health | MCP工具服务器（15个工具，107个操作） |
| 网关 | 8200 | /v1/health | FastAPI+WebSocket，聊天流 |
| PTY守护进程 | 7072（RPC），7073（健康） | /health | 终端仿真后端 |
| Web用户界面 | 3000 | / | 通过nginx提供的React SPA |
环境变量
复制 .env.example 到 .env 并配置：
# Required for chat functionality
ANTHROPIC_API_KEY=sk-ant-your-key-here
# Optional overrides
KURORYUU_GATEWAY_PORT=8200
KURORYUU_MCP_PORT=8100
KURORYUU_AUTH_ENABLED=true
KURORYUU_AUTH_PASSWORD_HASH=Docker命令
# Start in background
docker-compose up -d
# View logs (follow mode)
docker-compose logs -f
# View specific service logs
docker-compose logs -f gateway
# Rebuild after code changes
docker-compose build
docker-compose up -d
# Stop all services
docker-compose down
# Stop and remove volumes (clean slate)
docker-compose down -vDocker模式的局限性
仅限Windows的功能会自动禁用：
k_capture-需要Win32显示APIk_pccontrol-需要PowerShell+Win32 API- 桌面电子应用程序-改用Web UI
- 托盘伴侣-需要Windows SAPI
实现完整功能 包括桌面自动化，使用本机Windows安装。
架构概述
┌─────────────────────────────────────────────────────────────┐
│ Kuroryuu Desktop │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────────┐ │
│ │ Leader │ │ Worker │ │ Worker │ │ Command │ │
│ │Terminal │ │Terminal │ │Terminal │ │ Center │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ └────────┬────────┘ │
└───────┼──────────┼──────────┼─────────────────┼─────────────┘
│ │ │ │
└──────────┴──────────┴─────────────────┘
│
┌──────────▼──────────┐
│ Gateway (8200) │
│ FastAPI + WebSocket │
└──────────┬──────────┘
│
┌──────────▼──────────┐
│ MCP Core (8100) │
│ 15 Tools→107 Actions│
└─────────────────────┘关键组件
- 网关：具有21个路由器的FastAPI服务器、代理注册表、WebSocket事件、流式聊天
- MCP核心：15个MCP工具，包含107个路由操作（RAG、收件箱、检查点、PTY、PCControl…）
- 桌面：电子+反应+TypeScript有235个组件，16个屏幕，13个模块
- Kuroyuu命令行界面：6137 LOC Python REPL，带有24个斜线命令，通过3个提供者提供61多种模型
- 领导/工人模式：Ralph编排与桌面监控和推送
Kiro CLI集成
该项目是使用 Kiro命令行界面 用于人工智能驱动的开发。
发展统计
| 度量 | 值 |
|---|---|
| 开发日 | 26 |
| 总会话数 | 460+ |
| 已完成任务 | 445 |
| MCP工具 | 15（107个动作） |
| 反应组件 | 235 |
| 桌面屏幕 | 16+13个模块 |
| 网关路由器 | 21 |
| 总源LOC | 235,626 |
| 桌面（TypeScript） | 95426 |
| 网关（Python） | 23097 |
| MCP核心（Python） | 10292 |
| Kuroyuu命令行界面（Python） | 6137 |
| CLI命令 | 24 |
| 支持LLM型号 | 61+ |
| 插件命令 | 20 |
| 工作日志 | 602 |
| 检查点 | 706 |
自定义提示(ai\prompts\workflows\)
| 提示 | 目的 |
|---|---|
@prime | 加载综合项目上下文 |
@plan-feature | 设计特征架构 |
@execute | 具有任务跟踪功能的系统化实施 |
@code-review | 承诺前的质量保证 |
@code-review-hackathon | 黑客马拉松量规评估 |
@rca | 调试根本原因分析 |
@create-prd | 需求文档 |
@system-review | 集成验证 |
指导文件(.kiro/steering/)
- product.md -产品愿景和用户角色
- tech.md -技术架构和标准
- structure.md -项目组织模式
- 公约.md -代码风格指南
- 规则.md -发展原则
- kuroryuu-mcp.md -MCP特定惯例
开发工作流程
@prime-在会话开始时加载上下文@plan-feature-编码前的设计@execute-实施任务跟踪@code-review-承诺前确保质量- 更新指导文档-维护知识库
MCP工具（16个工具→ 115 路由操作）
Kiro CLI直接连接到Kuroyuu的MCP服务器，提供对以下内容的访问：
| 工具 | 行动 | 目的 |
|---|---|---|
| k_rag | 12 | 多策略搜索（关键字、语义、混合、反射、代理） |
| kpty | 12 | 终端控制和注入 |
| k收件箱 | 8 | 邮件目录消息 |
| k_msg | 8 | 简化的代理间消息传递（发送、检查、读取、回复、广播） |
| k捕获 | 8 | 屏幕截图 |
| kpc控制 | 8 | 通过PowerShell/Win32 API实现桌面自动化（OPT-IN） |
| k_session | 7 | 会话生命周期 |
| k存储器 | 7 | 工作记忆 |
| k石墨迁移 | 6 | 知识图迁移 |
| k集体 | 6 | 代理协调 |
| k_repo_intel | 5 | 存储库智能 |
| k文件 | 5 | 文件操作 |
| k检查点 | 4 | 会话持久性 |
| k_thinker_channel | 3 | 思考者沟通 |
| k_MCPTOOLSEARCH | 2 | 工具发现 |
| k_help | - | 帮助系统 |
特性
多代理编排（Ralph Leader）
拉尔夫 是协调员工的自主领导者：
- 桌面监控Ralph是否处于非活动状态，并发送提示
- Ralph通过k_pty监控员工的承诺信号
- 技能：
/k-ralph,/ralph_done,/ralph_progress,/ralph_stuck - 通过桌面上的LeaderMonitorModal进行可视化监控
核心特点：
- 具有层级任务委托的领导/工人模式
- 失败关闭安全模型（领导者死亡块UI）
- 具有心跳监控功能的实时代理注册表
- k_pccontrol用于全Windows桌面自动化（OPT-IN）
桌面应用程序（235个React组件）
- 16个主屏幕+13个黑龙/矩阵主题的模组
- 具有PTY持久性的终端网格（重启后仍能生存）
- 带有代理、工具、服务器选项卡的命令中心
- Claude任务监视器，带圆环图+甘特图时间线
- 基于网络图的HTTP/PTY流量可视化
- 带有@提及的完整VSCode风格代码编辑器
- GitHub桌面风格的Worktrees管理器
- 已完成任务的变更日志生成器
- 437个可搜索的对话记录
MCP工具套件（15个工具，107个操作）
- 路由工具架构，防止工具膨胀
- 全Windows桌面自动化的k_pccontrol
- RAG搜索有12种策略（关键字、语义、混合、代理……）
- 基于Maildir的多代理消息收件箱
- Graphiti知识图集成
黑流CLI（6137 LOC）
用于AI驱动开发的全功能Python REPL：
cd apps/kuroryuu_cli
python -m kuroryuu_cli --help24击杀命令：
/help /exit /status /clear /context /compact /history
/config /model /provider /mode /permissions /doctor
/init /memory /tools /review /plan /execute /agents /ask /approve3家供应商，61+型号：
- LMStudio（本地推理）
- Claude API（带有Pro/Max的OAuth）
- CLIProxyAPI（Anthropic、OpenAI、Gemini、GitHub Copilot、Kiro、反重力）
特征：
- 领导/员工角色支持与权限执行
- 子代理产卵（Explorer、Planner类型）
- 人在循环门（/询问/批准）
- 3种操作模式：正常、计划（干运行）、只读
- 具有丰富终端UI的异步IO流媒体
CLI Bootstrap集成
- 8个主要AI工具的Bootstrap文件：
- Kiro CLI、光标、复制品、Cline、风帆、Codex、反重力
目录结构
kuroryuu/
├── apps/
│ ├── gateway/ # FastAPI gateway (port 8200)
│ ├── mcp_core/ # MCP tool server (port 8100)
│ ├── desktop/ # Electron + React app
│ └── web/ # Next.js web UI
├── ai/
│ ├── checkpoints/ # Agent checkpoints
│ ├── prompts/ # PRD-First workflow prompts
│ ├── collective/ # Pattern library
│ └── traffic/ # Request history
├── .kiro/
│ ├── steering/ # Project knowledge
│ ├── prompts/ # Custom Kiro prompts
│ └── specs/ # Feature specifications
├── Docs/
│ ├── DEVLOG.md # Development timeline
│ ├── worklogs/ # 602 session logs
│ └── Plans/ # Implementation plans
├── KURORYUU_BOOTSTRAP.md # Agent bootstrap guide
├── KURORYUU_LEADER.md # Leader agent instructions
└── KURORYUU_WORKER.md # Worker agent instructions故障排除
安装脚本失败-找不到Python 3.12
# Install Python 3.12 from python.org
# Ensure 'py' launcher is installed (checked by default)
py -3.12 --version # Should show Python 3.12.x桌面应用程序无法构建-缺少图标
桌面应用程序需要 apps/desktop/build/icon.png (256x256 PNG). 运行前创建此文件 npm run build 在桌面应用程序中。
网关无法启动
# Check if port 8200 is in use
netstat -an | findstr 8200
# Kill existing process and restart
.\kill_all.ps1
.\run_all.ps1MCP工具没有响应
# Check MCP Core health
curl http://127.0.0.1:8100/health
# Verify tools list
curl -X POST http://127.0.0.1:8100/mcp -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'桌面应用程序空白终端
- 重新启动应用程序（终端通过PTY守护进程持久化）
- 检查
ai/logs/main.log对于错误
领导死亡警告
- 这是故意的故障关闭安全
- 单击“重新启动应用程序”进行恢复
- 第一终端永远是领导者
文档
| 文件 | 目的 |
|---|---|
| DEVLOG.md | 使用Kiro CLI统计数据完成开发时间表 |
| DEMO.md | 以curl为例进行技术深度潜水 |
| KURORYOU_BOOTSTRAP.md | 代理引导指南 |
| KURORYU_LAWS.md | 操作规则 |
黑客马拉松提交
- 持续时间26天的开发（460多场会议）
- 已完成的任务：总计445
- 总源代码：235626 LOC（TypeScript+Python）
- MCP工具：15个工具，107个已安排的操作
- 桌面应用：95426 LOC TypeScript（235个React组件）
- 网关：23097 LOC Python（21个路由器）
- Kuroyuu命令行界面：6137 LOC Python（24个命令）
- LLM模型：61+通过6家供应商
- 文档602个工作日志，706个检查点
许可证
AGPL-3.0 -请参阅 许可证 了解详情。
您可以自由使用、修改和分发Kuroyuu。如果您修改并部署它（包括作为网络服务），则必须在AGPL-3.0下开源您的更改。
______________________________________________________________________
为2026年Dynamous x Kiro黑客马拉松使用Kiro CLI构建