mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-20 12:22:00 +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:
@@ -125,7 +125,7 @@ def _make(kind: str, model: str, base_url: str = "", *,
|
||||
where = base_url or "api.openai.com"
|
||||
raise EmbedderUnavailable(
|
||||
f"用不了 {where} 上的 embedding 模型 "
|
||||
f"{model or 'text-embedding-3-small'}:{type(e).__name__}: {e}。"
|
||||
f"{model or 'text-embedding-3-small'}:{_why(e)}。"
|
||||
f"检查服务在不在、模型名对不对;走官方接口还要看 OPENAI_API_KEY。"
|
||||
) from e
|
||||
return _local
|
||||
@@ -181,6 +181,12 @@ def has_semantics() -> bool:
|
||||
return getattr(get_embedder(), "name", "") != "local-hashing"
|
||||
|
||||
|
||||
def _why(e: BaseException) -> str:
|
||||
from app.api.errors import explain
|
||||
|
||||
return explain(e)[0]
|
||||
|
||||
|
||||
def default_alpha() -> float:
|
||||
"""向量那一路默认占多少权重。
|
||||
|
||||
|
||||
@@ -21,6 +21,10 @@ _DOCX = {".docx"}
|
||||
_PPTX = {".pptx"}
|
||||
_HTML = {".html", ".htm"}
|
||||
|
||||
#: 按 UTF-8 文本读的常见格式。清单外的文件也会按文本试,这里列的是上传框里
|
||||
#: 该让人选得到的那些——前端的 accept 从 GET /api/kb/formats 取,只在这一处定义
|
||||
_TEXT = (".txt", ".md", ".markdown", ".json", ".log", ".yaml", ".yml", ".py", ".ts", ".js")
|
||||
|
||||
#: 表格数据。它们有更好的去处——数据源那条路会把它变成可以真查的表,
|
||||
#: 而传进知识库只能当文本检索:数字是模型"读"出来的不是"算"出来的,
|
||||
#: 而这个项目的地基恰恰是"所有算术下沉到 SQL 或口径卡"(见 engine/issuance.py)
|
||||
@@ -36,6 +40,24 @@ class UnsupportedDocument(ValueError):
|
||||
"""认不出或解析不了。message 直接给用户看。"""
|
||||
|
||||
|
||||
def supported_formats() -> dict[str, list[str]]:
|
||||
"""知识库收哪些格式、拒哪些。上传框的 accept 和后端的判断必须是同一份清单:
|
||||
以前前端手写了一份,漏了 .pptx(后端支持)、多了 .csv(后端必拒)。"""
|
||||
extensions = sorted(_PDF | _DOCX | _PPTX) + sorted(_HTML) + list(_TEXT)
|
||||
return {
|
||||
"extensions": extensions,
|
||||
"text": list(_TEXT),
|
||||
"tabular": sorted(_TABULAR),
|
||||
"legacy": sorted(_LEGACY_OFFICE),
|
||||
}
|
||||
|
||||
|
||||
def _why(e: BaseException) -> str:
|
||||
"""解析库的原话,去掉类名。它们常常是英文,但比"读不开"多一点线索。"""
|
||||
text = str(e).strip()
|
||||
return (text.splitlines()[0][:120] if text else "") or "没有更多说明"
|
||||
|
||||
|
||||
def _ext(filename: str) -> str:
|
||||
idx = filename.rfind(".")
|
||||
return filename[idx:].lower() if idx >= 0 else ""
|
||||
@@ -51,7 +73,10 @@ def _from_pdf(raw: bytes) -> str:
|
||||
try:
|
||||
reader = PdfReader(io.BytesIO(raw))
|
||||
except Exception as e: # noqa: BLE001
|
||||
raise UnsupportedDocument(f"这个 PDF 读不开:{type(e).__name__}: {e}") from e
|
||||
raise UnsupportedDocument(
|
||||
f"这个 PDF 读不开:文件可能损坏、加了密码,或者其实不是 PDF({_why(e)})。"
|
||||
"用原软件打开另存一份再传"
|
||||
) from e
|
||||
|
||||
# 按页拼,页与页之间留空行——切块是按段落切的,页边界正好是天然的段落边界
|
||||
pages = []
|
||||
@@ -86,7 +111,10 @@ def _from_docx(raw: bytes) -> str:
|
||||
try:
|
||||
doc = docx.Document(io.BytesIO(raw))
|
||||
except Exception as e: # noqa: BLE001
|
||||
raise UnsupportedDocument(f"这个 Word 文档读不开:{type(e).__name__}: {e}") from e
|
||||
raise UnsupportedDocument(
|
||||
f"这个 Word 文档读不开:文件可能损坏、加了密码,或者其实不是 Word({_why(e)})。"
|
||||
"用原软件打开另存一份再传"
|
||||
) from e
|
||||
|
||||
parts = [p.text.strip() for p in doc.paragraphs if p.text.strip()]
|
||||
# 表格也要:合同、口径说明这类文档的关键信息常常整个在表里,
|
||||
@@ -112,7 +140,10 @@ def _from_pptx(raw: bytes) -> str:
|
||||
try:
|
||||
deck = Presentation(io.BytesIO(raw))
|
||||
except Exception as e: # noqa: BLE001
|
||||
raise UnsupportedDocument(f"这个 PowerPoint 读不开:{type(e).__name__}: {e}") from e
|
||||
raise UnsupportedDocument(
|
||||
f"这个 PowerPoint 读不开:文件可能损坏、加了密码,或者其实不是 PowerPoint({_why(e)})。"
|
||||
"用原软件打开另存一份再传"
|
||||
) from e
|
||||
|
||||
slides: list[str] = []
|
||||
for page in deck.slides:
|
||||
@@ -167,9 +198,9 @@ def extract(raw: bytes, filename: str, mime: str = "") -> str:
|
||||
return _from_html(raw)
|
||||
if ext in _TABULAR:
|
||||
raise UnsupportedDocument(
|
||||
f"{filename} 是表格数据,请传到「设置 → 数据源」那里——"
|
||||
"它会变成一张可以用 SQL 查的表,数字是算出来的、能追溯到哪条查询。"
|
||||
"传进知识库只能当文本检索,模型只是把数字读出来,容易读错也查不出来源。"
|
||||
f"「{filename}」是表格,知识库不收表格。请到「数据源」点「传表格」导入:"
|
||||
"它会变成一张能用 SQL 查的表,数字是算出来的、查得到出自哪条查询。"
|
||||
"放进知识库只能按文字检索,数字靠模型去读,容易读错,也追不到来源。"
|
||||
)
|
||||
if ext in _LEGACY_OFFICE:
|
||||
# 认出来再拒,而不是让它掉进下面那个"不是 UTF-8"的兜底——
|
||||
|
||||
@@ -96,7 +96,9 @@ async def rerank(
|
||||
return hits[:top_n]
|
||||
except Exception as e: # noqa: BLE001
|
||||
if on_note:
|
||||
on_note(f"重排失败,按初筛顺序返回:{type(e).__name__}: {e}")
|
||||
from app.api.errors import explain
|
||||
|
||||
on_note(f"重排失败,按初筛顺序返回:{explain(e)[0]}")
|
||||
return hits[:top_n]
|
||||
|
||||
ranked = sorted(zip(hits, scores), key=lambda t: t[1], reverse=True)
|
||||
|
||||
@@ -90,12 +90,16 @@ async def recall(
|
||||
kind: str | None = None,
|
||||
min_score: float = 0.05,
|
||||
on_degrade: Any = None,
|
||||
track: bool = True,
|
||||
) -> list[dict[str, Any]]:
|
||||
"""按混合相关度取回记忆,并按重要性和使用次数做轻微加权。
|
||||
|
||||
存量向量和当前 embedder 对不上时整体退回纯关键词。以前这里退得悄无声息
|
||||
——知识库那边至少会发一条 warn,记忆这边只是"最近想不起事",而人根本
|
||||
不会想到要去重建索引。
|
||||
|
||||
track=False 只看不记:调试台试一次回忆不该算"被召回过",否则记忆卡上的
|
||||
召回次数会被调试操作抬高,下次排序也跟着偏。
|
||||
"""
|
||||
stmt = select(MemoryItem).where(MemoryItem.scope == scope)
|
||||
if kind:
|
||||
@@ -151,6 +155,8 @@ async def recall(
|
||||
if len(results) >= limit:
|
||||
break
|
||||
|
||||
if not track:
|
||||
return results
|
||||
# 记一下被召回过,作为下次排序的信号
|
||||
for r in results:
|
||||
item = await session.get(MemoryItem, r["id"])
|
||||
@@ -161,6 +167,36 @@ async def recall(
|
||||
return results
|
||||
|
||||
|
||||
async def revise(
|
||||
session: AsyncSession,
|
||||
memory_id: str,
|
||||
*,
|
||||
content: str | None = None,
|
||||
kind: str | None = None,
|
||||
importance: float | None = None,
|
||||
) -> MemoryItem | None:
|
||||
"""原地改一条记忆。找不到返回 None。
|
||||
|
||||
内容变了向量必须跟着重算:不然召回按的还是旧话,改完的口径搜不出来,
|
||||
搜得出来的却是已经被改掉的那句。
|
||||
"""
|
||||
item = await session.get(MemoryItem, memory_id)
|
||||
if not item:
|
||||
return None
|
||||
if content is not None and content.strip() != item.content:
|
||||
item.content = content.strip()
|
||||
item.embedding = to_blob(await embed_text(item.content))
|
||||
item.embed_model = embedder_id()
|
||||
item.embed_dim = embedder_dim()
|
||||
if kind is not None:
|
||||
item.kind = kind
|
||||
if importance is not None:
|
||||
item.importance = importance
|
||||
await session.commit()
|
||||
await session.refresh(item)
|
||||
return item
|
||||
|
||||
|
||||
async def forget(session: AsyncSession, memory_id: str) -> bool:
|
||||
item = await session.get(MemoryItem, memory_id)
|
||||
if not item:
|
||||
|
||||
Reference in New Issue
Block a user