mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-16 08:31:57 +00:00
e10c4f23fc
来自 2026-09 的 UI/UX 审查(142 条)。本提交是前两波,第三波(记录页接入时间轴、跨页互链、check-ui 更新、全站扫尾)另行提交。 地基 - 设计令牌:全局规则和 .btn/.field/.chip 放进 CSS 层,Tailwind 工具类重新生效,选中态、开启态不再被吞掉;字号阶梯; 辅助文字在所有底色上 >= 4.5:1;状态色专用,节点类型色与之拉开色相;「跟随系统」真的跟随,首帧不闪深色;新字标与 favicon - 基础组件:confirmDialog / promptDialog 取代原生对话框;toast 出错不自动消失、可复制、读屏可播报;离线横幅与断线恢复; 九种剪影的状态徽标;唯一一份状态文案(lib/status)、格式化(lib/format)、术语(lib/terms)、报错人话(lib/errors) - 运行态内核:事件折成航迹(run/trace.ts),可投影到任意时刻;取消 / 失败 / 服务重启后统一收尾,不再永远转圈; run.status 随事件回写;token 事件不再堆进 events - 后端:协作成员逐个完成即发事件,调度者决策有事件;时长分执行 / 墙钟 / 等人;API 时间带时区; 中断的运行也发 stream.end;运行列表可筛选翻页;删除运行 / 工作流有保护;运行默认值接通;可测未保存的配置; 报错说清发生了什么、为什么、怎么办 功能 - 画布:状态四重编码、固定高度遥测槽、按缩放三档、运行胶囊与 HUD、航迹时间轴与回放、执行轨迹边、 等待闸门、跟随执行、正式运行只读、一次性时刻(开场点亮、回扫、阻断级联、出具印章) - 编辑:撤销重做、版本历史、问题面板可定位、三栏可收起、模板与表达式字段区分、变量血缘、快捷键、带搜索的选择器 - 回答流 / 问数据:贴底才跟随滚动、工件下钻、出具横幅列出缺口、答案可复制导出、按会话的忙闲、 答案不再在 2000 字处截断、重启后这一轮会收尾 - 记录页:待审批 / 运行中 / 失败页签、筛选翻页、实时接流、排错路径指到节点、封存凭证常驻 - 管理页:新的「数据」页、写操作失败都有反馈、弹窗里先测连接、统一持久的连接状态 - 外壳:导航改版、⌘K 命令面板、? 快捷键帮助、404、页面标题与 favicon 状态点、后台提醒 验证(沙箱):tsc 干净,pytest 579 passed,14 个检查脚本中 13 个全绿;check-ui 剩 1 项旧断言(按旧日期格式找运行行),第三波更新。
151 lines
5.6 KiB
Python
151 lines
5.6 KiB
Python
from __future__ import annotations
|
|
|
|
import asyncio
|
|
import logging
|
|
from typing import Any
|
|
|
|
from langchain_core.tools import BaseTool
|
|
from sqlalchemy import select
|
|
|
|
from app.db.base import SessionLocal
|
|
from app.db.models import McpServer
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def _server_config(row: McpServer) -> dict[str, Any]:
|
|
if row.transport == "http":
|
|
return {"transport": "streamable_http", "url": row.url or ""}
|
|
return {
|
|
"transport": "stdio",
|
|
"command": row.command or "",
|
|
"args": list(row.args or []),
|
|
"env": dict(row.env or {}),
|
|
}
|
|
|
|
|
|
class McpManager:
|
|
"""管理外部 MCP server 的连接与工具缓存。
|
|
|
|
工具在图里用 `mcp:<server>/<tool>` 引用。连接是懒建立的,
|
|
并且按 server 缓存,避免每个节点都去重新拉起一次 stdio 子进程。
|
|
"""
|
|
|
|
def __init__(self) -> None:
|
|
self._tools: dict[str, list[BaseTool]] = {} # server name -> tools
|
|
self._lock = asyncio.Lock()
|
|
|
|
async def _load_servers(self) -> list[McpServer]:
|
|
async with SessionLocal() as session:
|
|
rows = await session.execute(select(McpServer).where(McpServer.enabled.is_(True)))
|
|
return list(rows.scalars())
|
|
|
|
async def _connect(self, rows: list[McpServer]) -> dict[str, list[BaseTool]]:
|
|
from langchain_mcp_adapters.client import MultiServerMCPClient
|
|
|
|
out: dict[str, list[BaseTool]] = {}
|
|
for row in rows:
|
|
try:
|
|
client = MultiServerMCPClient({row.name: _server_config(row)})
|
|
tools = await asyncio.wait_for(client.get_tools(), timeout=30)
|
|
out[row.name] = list(tools)
|
|
await self._mark(row.id, "ok", None, [t.name for t in tools])
|
|
except Exception as e: # noqa: BLE001 - 一个 server 挂了不影响其他的
|
|
logger.warning("MCP server %s 连接失败: %s", row.name, e)
|
|
out[row.name] = []
|
|
await self._mark(row.id, "error", _reason(e), [])
|
|
return out
|
|
|
|
async def _mark(
|
|
self, server_id: str, status: str, error: str | None, tool_names: list[str]
|
|
) -> None:
|
|
async with SessionLocal() as session:
|
|
row = await session.get(McpServer, server_id)
|
|
if row:
|
|
row.status = status
|
|
row.last_error = error
|
|
row.tools_cache = tool_names
|
|
await session.commit()
|
|
|
|
async def refresh(self) -> dict[str, list[str]]:
|
|
async with self._lock:
|
|
rows = await self._load_servers()
|
|
self._tools = await self._connect(rows)
|
|
return {name: [t.name for t in tools] for name, tools in self._tools.items()}
|
|
|
|
async def ensure_loaded(self) -> None:
|
|
if not self._tools:
|
|
await self.refresh()
|
|
|
|
async def list_tools(self) -> list[dict[str, Any]]:
|
|
await self.ensure_loaded()
|
|
out: list[dict[str, Any]] = []
|
|
for server, tools in self._tools.items():
|
|
for tool in tools:
|
|
out.append(
|
|
{
|
|
"id": f"mcp:{server}/{tool.name}",
|
|
"name": tool.name,
|
|
"server": server,
|
|
"description": tool.description or "",
|
|
"category": f"MCP · {server}",
|
|
"schema": tool.args_schema.model_json_schema()
|
|
if getattr(tool, "args_schema", None)
|
|
else {},
|
|
}
|
|
)
|
|
return out
|
|
|
|
async def get_tools(self, refs: list[str]) -> list[BaseTool]:
|
|
"""按 `mcp:<server>/<tool>` 取工具;`mcp:<server>/*` 表示该 server 全部工具。"""
|
|
await self.ensure_loaded()
|
|
wanted: list[BaseTool] = []
|
|
for ref in refs:
|
|
body = ref[4:] if ref.startswith("mcp:") else ref
|
|
server, _, tool_name = body.partition("/")
|
|
tools = self._tools.get(server, [])
|
|
if tool_name in ("", "*"):
|
|
wanted.extend(tools)
|
|
continue
|
|
for tool in tools:
|
|
if tool.name == tool_name:
|
|
wanted.append(tool)
|
|
break
|
|
return wanted
|
|
|
|
async def probe(self, row: McpServer) -> dict[str, Any]:
|
|
"""连一次看看,用于设置页的"测试连接"。"""
|
|
from langchain_mcp_adapters.client import MultiServerMCPClient
|
|
|
|
try:
|
|
client = MultiServerMCPClient({row.name: _server_config(row)})
|
|
tools = await asyncio.wait_for(client.get_tools(), timeout=30)
|
|
return {
|
|
"ok": True,
|
|
"tools": [
|
|
{"name": t.name, "description": t.description or ""} for t in tools
|
|
],
|
|
}
|
|
except Exception as e: # noqa: BLE001
|
|
from app.api.errors import raw
|
|
|
|
return {"ok": False, "error": _reason(e), "detail": raw(e)}
|
|
|
|
|
|
def _reason(e: BaseException) -> str:
|
|
"""连不上 MCP 服务的原因,写成工具页上看得懂的话。
|
|
|
|
最常见的两种:命令不存在(没装 npx / uvx)和超时(进程起来了但不讲 MCP)。
|
|
"""
|
|
from app.api.errors import explain
|
|
|
|
if isinstance(e, FileNotFoundError):
|
|
return f"启动不了:找不到命令 {e.filename or ''}。确认它已安装、并且在后端的 PATH 里"
|
|
if isinstance(e, asyncio.TimeoutError):
|
|
return "连上了但 30 秒内没有应答:确认这个命令启动的是 MCP 服务,参数有没有写错"
|
|
reason, hint = explain(e)
|
|
return f"{reason}。{hint}" if hint else reason
|
|
|
|
|
|
mcp_manager = McpManager()
|