sync update from LAN repo (source dhk-1 @ 3b1ec5b4)

This commit is contained in:
gozeros committed 2026-11-05 10:56:34 +08:00
1 parent da6521b6cb
commit 264e2200d6
995 files changed
+148105 -13399

No files matched your search

@@ -41,6 +41,25 @@ router = APIRouter(prefix="/api/roundtable-chains", tags=["roundtable-chains"])
MIN_SEATS = 2
MAX_SEATS = 20
# 功能型内置智能体不可作业务链席位(Step 1 意图理解 / 推荐器 / 总控 / 报告)。
# 与前端 `api/recommend.ts` 的 `filterRecommendCandidates` 排除集逐字对齐:
# 席位富化(_enrich_chain_seats)把这些 id 一律标为 available=False,保证
# 「前端不再实时查 /api/agents」后「功能型智能体不可入席」的语义不变。
_FUNCTIONAL_AGENT_IDS = frozenset(
{
"roundtable-intent",
"roundtable-recommender",
"roundtable-coordinator",
"roundtable-report",
}
)
_FUNCTIONAL_AGENT_PREFIX = "roundtable-coordinator-"
def _is_functional_agent(agent_id: str) -> bool:
lowered = agent_id.lower()
return lowered in _FUNCTIONAL_AGENT_IDS or lowered.startswith(_FUNCTIONAL_AGENT_PREFIX)
# ── schemas ────────────────────────────────────────────────────────────────
@@ -80,11 +99,30 @@ class ChainSeatSchema(BaseModel):
job_responsibilities: str | None = Field(default=None, max_length=4000)
class ChainSeatResponseSchema(ChainSeatSchema):
"""席位响应模型:在落库字段之外附带两个**读时计算**的富化字段。
前端选链(弹窗 / 左栏点选 / 深链自动选链)从此不再实时拉 `/api/agents`,
所需的「席位智能体是否仍可用」与「最新名称」由后端在返回链条时用一次批量
查询(`agent_store.list_by_ids`,与 `/api/agents` 同一套可见性过滤)算好:
- ``available``:该席位智能体当前对请求用户可见(本人 / 内置 / 已发布、
非私享、非管理员隐藏)且不是功能型内置 → True;否则 False。
- ``live_name``:智能体当前名称;查不到时为 None(前端回退 seat.name 快照)。
仅用于响应序列化,**绝不持久化**:create/update 请求沿用 ``ChainSeatSchema``,
富化字段不会进 seats JSON(存量数据零迁移)。
"""
available: bool | None = None
live_name: str | None = None
class ChainResponse(BaseModel):
id: str
title: str = ""
description: str | None = None
seats: list[ChainSeatSchema] = []
seats: list[ChainSeatResponseSchema] = []
# Optional layered orchestration: list of stages, each a list of agent_ids
# run in parallel (stages run serially). None/absent = linear chain.
stages: list[list[str]] | None = None
@@ -103,6 +141,10 @@ class ChainResponse(BaseModel):
# 「待审核」标记:True = owner 已提交审核(等待管理员在「待审核」筛选里发布);
# 管理员发布时随 is_public=True 一起清回 False。缺省 False。
pending_review: bool = False
# 管理员目录开关:True = 从所有普通列表(我的/公共/待审核/选链弹窗)隐藏,仅管理员
# 管理视图(admin_view=true)可见。纯目录开关:get_chain 单条读取不受影响,已配置的
# 业务映射 / 进行中的研讨继续可用。缺省 False。
hidden: bool = False
# 是否当前用户所有(仅本人可编辑 / 删除 / 发布;公共筛选里别人的链条 is_mine=False)。
is_mine: bool = True
# 配置者(owner)的 user_id 及解析后的可读用户名(email)。owner_name 由路由层
@@ -199,6 +241,60 @@ async def _enrich_owner_names(rows: list[dict]) -> None:
row["owner_name"] = cache[uid]
def _apply_seat_enrichment(chains: list[dict], live_records: list[dict]) -> None:
"""把批量查到的实时智能体信息写进每条链每个 seat(就地修改响应 dict)。
纯函数(不触网),便于单测:``live_records`` 是 ``agent_store.list_by_ids``
的返回(dict 列表,含 id/name)。规则:
- 功能型内置智能体(_is_functional_agent)与查不到的 id → available=False、
live_name=None(对齐前端 ``filterRecommendCandidates`` 的排除语义);
- 其余 → available=True、live_name=实时 name(回退 None 由前端用快照名)。
"""
live: dict[str, dict] = {}
for record in live_records:
rid = str(record.get("id") or "").lower()
if rid:
live[rid] = record
for chain in chains:
for seat in chain.get("seats") or []:
aid = str(seat.get("agent_id") or "").lower()
record = live.get(aid)
if record is None or _is_functional_agent(aid):
seat["available"] = False
seat["live_name"] = None
else:
seat["available"] = True
seat["live_name"] = str(record.get("name") or "") or None
async def _enrich_chain_seats(request: Request, rows: list[dict]) -> None:
"""席位富化入口:一次批量 SQL 算好所有 seat 的 available / live_name。
best-effort:agent store 不可用 / 查询异常时不写任何字段(响应缺省 → 前端
按存活处理),与旧前端「agents 列表拉取失败不判删」的降级语义一致。
仅修改响应 dict,落库的 seats JSON 不受影响。
"""
agent_ids = {
str(seat.get("agent_id") or "").lower()
for row in rows
for seat in row.get("seats") or []
if seat.get("agent_id")
}
if not agent_ids:
return
try:
store = get_agent_store(request)
except Exception:
logger.warning("Seat enrichment skipped: agent store unavailable")
return
try:
records = await store.list_by_ids(sorted(agent_ids), _current_user_id(request))
except Exception:
logger.warning("Seat enrichment skipped: batch agent lookup failed", exc_info=True)
return
_apply_seat_enrichment(rows, records)
def _get_store(request: Request):
store = getattr(request.app.state, "roundtable_chain_store", None)
if store is None:
@@ -364,7 +460,12 @@ def _validate_seat_mode(seat_mode: str | None) -> None:
@router.get("", response_model=ChainListResponse)
async def list_chains(request: Request, scope: str = "mine") -> ChainListResponse:
async def list_chains(
request: Request,
scope: str = "mine",
admin_view: bool = False,
hidden: bool | None = None,
) -> ChainListResponse:
"""列出业务链条。
``scope`` 查询参数(筛选):
@@ -374,6 +475,11 @@ async def list_chains(request: Request, scope: str = "mine") -> ChainListRespons
非管理员请求 ``pending`` 退化为 ``mine``);
- ``all``:所有账号的全部链条(**仅管理员**;非管理员请求 ``all`` 退化为 ``mine``)。
其余值按 ``mine`` 处理。
隐藏开关(管理员目录):默认(含管理员的普通视图,如选链弹窗)隐藏链条
(``hidden=True``)从所有 scope 排除。管理员传 ``admin_view=true`` 切到管理视图:
不排除隐藏链条,并可用 ``hidden=true/false`` 筛选只看隐藏 / 只看显示中(配置页专用)。
非管理员传 ``admin_view`` 一律忽略,绝不越权。
"""
is_admin = _is_admin(request)
normalized_scope = scope if scope in ("mine", "public", "pending", "all") else "mine"
@@ -382,8 +488,15 @@ async def list_chains(request: Request, scope: str = "mine") -> ChainListRespons
normalized_scope = "mine"
store = _get_store(request)
user_id = _current_user_id(request)
rows = await store.list_chains(user_id, scope=normalized_scope, is_admin=is_admin)
rows = await store.list_chains(
user_id,
scope=normalized_scope,
is_admin=is_admin,
include_hidden=admin_view and is_admin,
hidden=hidden if admin_view and is_admin else None,
)
await _enrich_owner_names(rows)
await _enrich_chain_seats(request, rows)
return ChainListResponse(chains=[ChainResponse(**r) for r in rows])
@@ -411,6 +524,7 @@ async def create_chain(request: Request, body: ChainCreateRequest) -> ChainRespo
},
)
await _enrich_owner_names([row])
await _enrich_chain_seats(request, [row])
return ChainResponse(**row)
@@ -422,6 +536,7 @@ async def get_chain(request: Request, chain_id: str) -> ChainResponse:
if row is None:
raise HTTPException(status_code=404, detail="Chain not found")
await _enrich_owner_names([row])
await _enrich_chain_seats(request, [row])
return ChainResponse(**row)
@@ -451,6 +566,7 @@ async def update_chain(request: Request, chain_id: str, body: ChainUpdateRequest
if row.get("is_public"):
await _publish_seat_agents(request, row, user_id, is_admin=is_admin)
await _enrich_owner_names([row])
await _enrich_chain_seats(request, [row])
return ChainResponse(**row)
@@ -463,6 +579,35 @@ async def delete_chain(request: Request, chain_id: str) -> None:
raise HTTPException(status_code=404, detail="Chain not found")
class ChainHiddenUpdateRequest(BaseModel):
"""Admin-only request body for hiding a chain from every non-admin listing."""
hidden: bool = Field(description="Set true to hide the chain from all non-admin listings (我的/公共/待审核/选链弹窗); false restores it. Purely a catalog switch — get_chain / 业务映射 / 进行中的研讨不受影响。")
@router.put("/{chain_id}/hidden", response_model=ChainResponse)
async def set_chain_hidden(
request: Request, chain_id: str, body: ChainHiddenUpdateRequest
) -> ChainResponse:
"""隐藏 / 取消隐藏一条业务链条(**仅管理员**)。
隐藏后链条从所有普通列表消失(连 owner 的「我的链条」也不显示),但单条读取不过滤:
已配置的业务映射、进行中的研讨、编辑器直接打开(chainId 深链)都继续可用。管理员
管理视图(``admin_view=true``)始终可见,可随时取消隐藏。
"""
if not _is_admin(request):
raise HTTPException(status_code=403, detail="Only system admins can hide or restore chains")
store = _get_store(request)
user_id = _current_user_id(request)
row = await store.update_chain(chain_id, user_id, hidden=body.hidden, is_admin=True)
if row is None:
raise HTTPException(status_code=404, detail="Chain not found")
logger.info("Set chain '%s' hidden=%s by admin", chain_id, body.hidden)
await _enrich_owner_names([row])
await _enrich_chain_seats(request, [row])
return ChainResponse(**row)
# ── 提示词优化(总控提示词 / 阶段目标)──────────────────────────────────────
# 链条编辑器的「AI 优化」按钮:把用户当前写的提示词 + 链条结构发来,单次直连
# LLM 重写后返回全文(同 suggestions 路由的直调模式,不走 agent / loopback)。