界面与交互全面翻修(前两波):运行态有了 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:
ThearchyHelios
2026-09-26 23:11:31 +08:00
parent 95ff6470d1
commit e10c4f23fc
132 changed files with 43558 additions and 5399 deletions
+7 -1
View File
@@ -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:
"""向量那一路默认占多少权重。
+37 -6
View File
@@ -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"的兜底——
+3 -1
View File
@@ -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)
+36
View File
@@ -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: