mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-17 19:01:59 +00:00
界面与交互全面翻修(前两波):运行态有了 HUD 和时间轴,终态会收尾,全站令牌、组件、文案统一
来自 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 项旧断言(按旧日期格式找运行行),第三波更新。
This commit is contained in:
@@ -7,6 +7,8 @@ from pydantic import BaseModel, Field
|
||||
from sqlalchemy import func, select
|
||||
from sqlalchemy.ext.asyncio import AsyncSession
|
||||
|
||||
from app.api.errors import graph_error
|
||||
from app.api.runs import actor_of
|
||||
from app.core.artifact_store import graph_hash
|
||||
from app.db.base import get_session
|
||||
from app.db.models import Run, Workflow, WorkflowVersion
|
||||
@@ -15,6 +17,8 @@ from app.engine.schema import GraphSpec, validate_graph
|
||||
|
||||
router = APIRouter(prefix="/api/workflows", tags=["workflows"])
|
||||
|
||||
_GONE = "这个工作流不存在,可能已经被删了"
|
||||
|
||||
|
||||
class WorkflowIn(BaseModel):
|
||||
name: str = Field(min_length=1, max_length=200)
|
||||
@@ -41,6 +45,7 @@ class WorkflowOut(BaseModel):
|
||||
is_template: bool
|
||||
status: str = "draft"
|
||||
published_version: int | None = None
|
||||
published_by: str | None = None
|
||||
created_at: Any = None
|
||||
updated_at: Any = None
|
||||
run_count: int = 0
|
||||
@@ -91,7 +96,7 @@ async def get_workflow(
|
||||
) -> Workflow:
|
||||
workflow = await session.get(Workflow, workflow_id)
|
||||
if not workflow:
|
||||
raise HTTPException(404, "工作流不存在")
|
||||
raise HTTPException(404, _GONE)
|
||||
return workflow
|
||||
|
||||
|
||||
@@ -101,7 +106,7 @@ async def update_workflow(
|
||||
) -> Workflow:
|
||||
workflow = await session.get(Workflow, workflow_id)
|
||||
if not workflow:
|
||||
raise HTTPException(404, "工作流不存在")
|
||||
raise HTTPException(404, _GONE)
|
||||
|
||||
if payload.name is not None:
|
||||
workflow.name = payload.name
|
||||
@@ -138,7 +143,16 @@ async def delete_workflow(
|
||||
) -> None:
|
||||
workflow = await session.get(Workflow, workflow_id)
|
||||
if not workflow:
|
||||
raise HTTPException(404, "工作流不存在")
|
||||
raise HTTPException(404, _GONE)
|
||||
# 运行记录是 ON DELETE SET NULL:删掉工作流,已结束的运行留着、照样能核对封存;
|
||||
# 还在跑的那次会失去归属,再也回不到它的画布,所以和删除运行记录一样先停再删
|
||||
live = await session.scalar(
|
||||
select(func.count()).select_from(Run).where(
|
||||
Run.workflow_id == workflow_id, Run.status.in_(("queued", "running"))
|
||||
)
|
||||
)
|
||||
if live:
|
||||
raise HTTPException(409, f"这个工作流还有 {live} 次运行在执行,现在删除它们会失去归属。先停止运行,再删除")
|
||||
await session.delete(workflow)
|
||||
await session.commit()
|
||||
|
||||
@@ -149,7 +163,7 @@ async def duplicate_workflow(
|
||||
) -> Workflow:
|
||||
source = await session.get(Workflow, workflow_id)
|
||||
if not source:
|
||||
raise HTTPException(404, "工作流不存在")
|
||||
raise HTTPException(404, _GONE)
|
||||
copy = Workflow(
|
||||
name=f"{source.name} 副本",
|
||||
description=source.description,
|
||||
@@ -183,13 +197,24 @@ async def list_versions(
|
||||
return list(rows.scalars())
|
||||
|
||||
|
||||
@router.post("/{workflow_id}/versions/{version}/restore", response_model=WorkflowOut)
|
||||
async def restore_version(
|
||||
class VersionDetailOut(VersionOut):
|
||||
workflow_id: str
|
||||
graph: dict[str, Any]
|
||||
graph_hash: str | None = None
|
||||
#: 这一版入口节点声明的字段。正式运行跑的是已发布的那一版,表单得照它来填——
|
||||
#: 画布上改过入口字段时,拿当前画布的字段去跑已发布版本会传错参数
|
||||
input_fields: list[dict[str, Any]] = Field(default_factory=list)
|
||||
published: bool = False
|
||||
|
||||
|
||||
@router.get("/{workflow_id}/versions/{version}", response_model=VersionDetailOut)
|
||||
async def get_version(
|
||||
workflow_id: str, version: int, session: AsyncSession = Depends(get_session)
|
||||
) -> Workflow:
|
||||
) -> VersionDetailOut:
|
||||
"""取某一版的完整图。"""
|
||||
workflow = await session.get(Workflow, workflow_id)
|
||||
if not workflow:
|
||||
raise HTTPException(404, "工作流不存在")
|
||||
raise HTTPException(404, _GONE)
|
||||
snapshot = (
|
||||
await session.execute(
|
||||
select(WorkflowVersion).where(
|
||||
@@ -199,7 +224,41 @@ async def restore_version(
|
||||
)
|
||||
).scalar_one_or_none()
|
||||
if not snapshot:
|
||||
raise HTTPException(404, "版本不存在")
|
||||
raise HTTPException(404, f"「{workflow.name}」没有 v{version} 这个版本")
|
||||
|
||||
graph = snapshot.graph or {}
|
||||
fields: list[dict[str, Any]] = []
|
||||
for node in graph.get("nodes") or []:
|
||||
if node.get("type") == "input":
|
||||
fields.extend(
|
||||
f for f in ((node.get("data") or {}).get("config") or {}).get("fields") or []
|
||||
if isinstance(f, dict)
|
||||
)
|
||||
return VersionDetailOut(
|
||||
id=snapshot.id, version=snapshot.version, note=snapshot.note,
|
||||
created_at=snapshot.created_at, workflow_id=workflow_id, graph=graph,
|
||||
graph_hash=snapshot.graph_hash or graph_hash(graph), input_fields=fields,
|
||||
published=workflow.published_version == snapshot.version,
|
||||
)
|
||||
|
||||
|
||||
@router.post("/{workflow_id}/versions/{version}/restore", response_model=WorkflowOut)
|
||||
async def restore_version(
|
||||
workflow_id: str, version: int, session: AsyncSession = Depends(get_session)
|
||||
) -> Workflow:
|
||||
workflow = await session.get(Workflow, workflow_id)
|
||||
if not workflow:
|
||||
raise HTTPException(404, _GONE)
|
||||
snapshot = (
|
||||
await session.execute(
|
||||
select(WorkflowVersion).where(
|
||||
WorkflowVersion.workflow_id == workflow_id,
|
||||
WorkflowVersion.version == version,
|
||||
)
|
||||
)
|
||||
).scalar_one_or_none()
|
||||
if not snapshot:
|
||||
raise HTTPException(404, f"没有 v{version} 这个版本")
|
||||
|
||||
workflow.graph = snapshot.graph
|
||||
workflow.version += 1
|
||||
@@ -236,10 +295,10 @@ async def publish_workflow(
|
||||
返回 200 + ok/issues 而不是抛错,让前端能把问题列表渲染出来。
|
||||
"""
|
||||
if payload.level not in ("published", "governed"):
|
||||
raise HTTPException(400, "level 只能是 published 或 governed")
|
||||
raise HTTPException(400, "发布档位只能选「已发布」或「受管」")
|
||||
workflow = await session.get(Workflow, workflow_id)
|
||||
if not workflow:
|
||||
raise HTTPException(404, "工作流不存在")
|
||||
raise HTTPException(404, _GONE)
|
||||
|
||||
version = payload.version or workflow.version
|
||||
snapshot = (
|
||||
@@ -251,12 +310,12 @@ async def publish_workflow(
|
||||
)
|
||||
).scalar_one_or_none()
|
||||
if not snapshot:
|
||||
raise HTTPException(404, f"版本 v{version} 不存在,先保存一次")
|
||||
raise HTTPException(404, f"没有 v{version} 这个版本:画布上的改动还没保存,先保存一次再发布")
|
||||
|
||||
try:
|
||||
spec = GraphSpec.model_validate(snapshot.graph)
|
||||
except Exception as e: # noqa: BLE001
|
||||
return {"ok": False, "issues": [{"level": "error", "message": f"图结构非法:{e}"}]}
|
||||
return {"ok": False, "issues": [{"level": "error", "message": f"工作流的结构读不懂:{graph_error(e)}"}]}
|
||||
|
||||
issues = [i.model_dump() for i in validate_graph(spec).issues]
|
||||
issues += [i.model_dump() for i in lint_for_publish(spec, level=payload.level).issues]
|
||||
@@ -267,7 +326,7 @@ async def publish_workflow(
|
||||
snapshot.graph_hash = graph_hash(snapshot.graph)
|
||||
workflow.status = payload.level
|
||||
workflow.published_version = version
|
||||
workflow.published_by = (x_actor or "").strip() or None
|
||||
workflow.published_by = actor_of(x_actor)
|
||||
await session.commit()
|
||||
return {
|
||||
"ok": True,
|
||||
@@ -289,7 +348,7 @@ async def validate(payload: ValidateIn) -> dict[str, Any]:
|
||||
try:
|
||||
spec = GraphSpec.model_validate(payload.graph)
|
||||
except Exception as e: # noqa: BLE001
|
||||
return {"ok": False, "issues": [{"level": "error", "message": f"图结构非法:{e}"}]}
|
||||
return {"ok": False, "issues": [{"level": "error", "message": f"工作流的结构读不懂:{graph_error(e)}"}]}
|
||||
result = validate_graph(spec)
|
||||
return result.model_dump()
|
||||
|
||||
@@ -306,5 +365,5 @@ async def variables(payload: ValidateIn) -> dict[str, Any]:
|
||||
try:
|
||||
spec = GraphSpec.model_validate(payload.graph)
|
||||
except Exception as e: # noqa: BLE001
|
||||
return {"variables": [], "issues": [{"level": "error", "message": f"图结构非法:{e}"}]}
|
||||
return {"variables": [], "issues": [{"level": "error", "message": f"工作流的结构读不懂:{graph_error(e)}"}]}
|
||||
return analyze(spec).model_dump()
|
||||
|
||||
Reference in New Issue
Block a user