fix(webui): 总览改静态骨架 + 图标 KPI,彻底去掉整页重建的闪烁

jianf:仍严重闪烁;应彻底摒弃增量重建,用动态图标 + api 数据展示;主页文字太多。

- renderOverview 从「每次 innerHTML 重建整页(含运行态面板)」改成**首帧建一次
  静态骨架**,之后 renderAll(每 15s 一次)只 updateOverview —— 只写 textContent
  与类名,一个节点都不重建。实测连续两次 renderAll 后 #ov-kpis / #ov-status /
  #rt-panel 仍是同一批 DOM 节点,这是"不再闪"的直接判据。
- 主页文字大幅收缩:删掉「系统概览 / LLM 状态 / 记忆状态 / 运行时」四张 kv 文字卡,
  改成一排 8 个图标 KPI(状态/运行/插件/版本/LLM/记忆/文档/运行时),状态用彩色
  圆点表达,其余只留数字 + 两字标签。
- 运行态面板不再被 renderOverview 清空(去掉 _rtSig=null 与重建),保持连续更新。
This commit is contained in:
JianFeeeee
2026-09-14 16:16:14 +08:00
parent 7768168dd2
commit 36b577bff8
2 changed files with 183 additions and 131 deletions

View File

@ -2740,3 +2740,74 @@
border-color: var(--text-primary);
box-shadow: 0 0 0 2px var(--accent-bg);
}
/* ===== 总览 KPI图标 + 数字,静态骨架)=====
节点只在首帧建一次,刷新只改值与类名 —— 这是总览页不再闪的前提。 */
.ov-kpis {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(118px, 1fr));
gap: 10px;
}
.ov-kpi {
display: flex;
flex-direction: column;
gap: 5px;
padding: 12px 14px 11px;
border-radius: var(--radius-md);
background: var(--bg-input);
border: 1px solid var(--border-color);
min-width: 0;
}
.ov-ico svg {
width: 18px;
height: 18px;
fill: none;
stroke: var(--accent);
stroke-width: 1.7;
stroke-linecap: round;
stroke-linejoin: round;
display: block;
}
.ov-val {
display: flex;
align-items: center;
gap: 6px;
font-size: 18px;
font-weight: 700;
line-height: 1.15;
min-width: 0;
}
.ov-val b {
font-weight: 700;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.ov-lab {
font-size: 10px;
letter-spacing: 0.05em;
text-transform: uppercase;
color: var(--text-muted);
}
.ov-dot {
flex: 0 0 auto;
width: 8px;
height: 8px;
border-radius: 50%;
background: var(--text-muted);
}
.ov-dot.ok {
background: var(--success);
box-shadow: 0 0 8px rgba(23, 169, 100, 0.55);
}
.ov-dot.warn {
background: var(--warning);
}
.ov-dot.bad {
background: var(--error);
}
.ov-foot {
margin-top: 10px;
font-size: 11px;
color: var(--text-muted);
}

View File

@ -567,12 +567,12 @@
function startUptimeTicker() {
if (uptimeTick) clearInterval(uptimeTick);
uptimeTick = setInterval(function () {
var el = document.querySelector("#uptime-val");
var el = document.querySelector("#ov-uptime");
if (el && state.startedAt) {
var now = Date.now();
el.textContent = fmtUptime(now - state.startedAt);
} else if (!state.startedAt) {
var el2 = document.querySelector("#uptime-val");
var el2 = document.querySelector("#ov-uptime");
if (el2) el2.textContent = "-";
}
}, 1000);
@ -1180,140 +1180,121 @@
}, 3000);
}
// ===== Overview =====
//
// 总览页是**静态骨架 + 数据绑定**DOM 只在首帧建一次,之后所有刷新只改
// 文本/类名,绝不重建节点。此前 renderAll 每 15s 把整个总览(含运行态面板)
// innerHTML 重建一遍 —— 那是页面上最刺眼的周期性闪烁的来源。
//
// 文字也压到最少:状态用彩色圆点表达,其余只留数字与两字标签,不再堆
// 「未初始化 / 不可用」这类整句描述。
var OV_ICONS = {
activity:
'<svg viewBox="0 0 24 24"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></svg>',
clock:
'<svg viewBox="0 0 24 24"><circle cx="12" cy="12" r="9"/><path d="M12 7v5l3 2"/></svg>',
puzzle:
'<svg viewBox="0 0 24 24"><path d="M4 7h4a2 2 0 1 1 4 0h4v4a2 2 0 1 0 0 4v4h-4a2 2 0 1 0-4 0H4v-4a2 2 0 1 1 0-4z"/></svg>',
tag:
'<svg viewBox="0 0 24 24"><path d="M20 12l-8 8-9-9V3h8z"/><circle cx="7.5" cy="7.5" r="1.3"/></svg>',
brain:
'<svg viewBox="0 0 24 24"><path d="M9 3a3 3 0 0 0-3 3 3 3 0 0 0-1 5.8V15a3 3 0 0 0 4 2.8V21"/><path d="M15 3a3 3 0 0 1 3 3 3 3 0 0 1 1 5.8V15a3 3 0 0 1-4 2.8V21"/></svg>',
db:
'<svg viewBox="0 0 24 24"><ellipse cx="12" cy="6" rx="8" ry="3"/><path d="M4 6v12c0 1.7 3.6 3 8 3s8-1.3 8-3V6"/><path d="M4 12c0 1.7 3.6 3 8 3s8-1.3 8-3"/></svg>',
file:
'<svg viewBox="0 0 24 24"><path d="M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8z"/><path d="M14 3v5h5"/></svg>',
cpu:
'<svg viewBox="0 0 24 24"><rect x="6" y="6" width="12" height="12" rx="2"/><path d="M9 2v3M15 2v3M9 19v3M15 19v3M2 9h3M2 15h3M19 9h3M19 15h3"/></svg>',
};
function ovKpi(id, icon, label, dot) {
return (
'<div class="ov-kpi"><span class="ov-ico">' +
icon +
'</span><span class="ov-val">' +
(dot ? '<i class="ov-dot" id="ov-' + id + '-dot"></i>' : "") +
'<b id="ov-' + id + '">—</b></span><span class="ov-lab">' +
label +
"</span></div>"
);
}
function renderOverview() {
// 总览页会整块重建 #rt-panel面板本身是空的所以必须让运行态的
// 数据签名失效,否则 renderRuntime 会以为“没变化”而不去填这块空面板。
_rtSig = null;
var host = document.getElementById("tab-overview");
if (!host) return;
// 只在首帧建骨架之后renderAll 每 15s 一次)只 updateOverview。
// 一个节点都不重建,所以不会闪。
if (!document.getElementById("ov-kpis")) {
host.innerHTML =
'<div id="rt-panel"></div>' +
'<div class="card"><div class="ov-kpis" id="ov-kpis">' +
ovKpi("status", OV_ICONS.activity, __("状态", "Status"), true) +
ovKpi("uptime", OV_ICONS.clock, __("运行", "Uptime")) +
ovKpi("plugins", OV_ICONS.puzzle, __("插件", "Plugins")) +
ovKpi("version", OV_ICONS.tag, __("版本", "Version")) +
ovKpi("llm", OV_ICONS.brain, "LLM", true) +
ovKpi("memory", OV_ICONS.db, __("记忆", "Memory")) +
ovKpi("docs", OV_ICONS.file, __("文档", "Docs")) +
ovKpi("runtime", OV_ICONS.cpu, __("运行时", "Runtime")) +
'</div><div class="ov-foot" id="ov-foot"></div></div>';
}
updateOverview();
}
function ovSet(id, text) {
var el = document.getElementById(id);
if (el && el.textContent !== String(text)) el.textContent = String(text);
}
function ovDot(id, cls) {
var el = document.getElementById(id);
if (el && el.className !== cls) el.className = cls;
}
// updateOverview 只写值与类名,从不改结构。
function updateOverview() {
var s = state.status || {};
var k = state.kernel;
var html =
'<div id="rt-panel"></div>' +
'<div class="card"><h2>' +
__("系统概览", "System Overview") +
"</h2>" +
'<div class="kv-row"><span class="key">' +
__("运行状态", "Status") +
'</span><span class="val"><span class="status-dot ' +
(s.status === "running" ? "dot-green" : "dot-yellow") +
'"></span>' +
escHtml(s.status || "unknown") +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("运行时间", "Uptime") +
'</span><span class="val"><span id="uptime-val">' +
(state.startedAt ? fmtUptime(Date.now() - state.startedAt) : "-") +
"</span></span></div>" +
'<div class="kv-row"><span class="key">' +
__("插件", "Plugins") +
'</span><span class="val">' +
((k?.plugins || []).length || 0) +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("版本", "Version") +
'</span><span class="val">' +
escHtml(
k?.build?.version
? (k.build.kernel_name || "HomeAgent") + " v" + k.build.version
: s.version
? "v" + s.version
: "-",
) +
"</span></div>" +
// AGPL-3.0 §13向网络使用者提供取得对应源码的入口。
// 地址来自内核 meta.SourceURL构建时可 -ldflags 覆盖),
// 修改后对外部署的分支必须把它指向自己的源码仓库。
(k?.build?.source_url
? '<div class="kv-row"><span class="key">' +
__("源码", "Source") +
'</span><span class="val"><a href="' +
escHtml(k.build.source_url) +
var running = s.status === "running";
ovSet("ov-status", running ? __("运行中", "running") : s.status || "unknown");
ovDot("ov-status-dot", "ov-dot " + (running ? "ok" : "warn"));
ovSet("ov-uptime", state.startedAt ? fmtUptime(Date.now() - state.startedAt) : "-");
ovSet("ov-plugins", ((k && k.plugins) || []).length || 0);
ovSet(
"ov-version",
k && k.build && k.build.version
? "v" + k.build.version
: s.version
? "v" + s.version
: "—",
);
var llm = (k && k.llm) || {};
ovDot("ov-llm-dot", "ov-dot " + (llm.available ? "ok" : "bad"));
ovSet("ov-llm", llm.provider || "");
var mem = (k && k.memory) || {};
ovSet("ov-memory", mem.available ? mem.entity_count + "/" + mem.relation_count : "—");
var docs = (k && k.documents) || {};
ovSet("ov-docs", docs.available ? docs.doc_count : "—");
var rt = (k && k.runtime) || {};
ovSet(
"ov-runtime",
rt.goroutines ? rt.goroutines + (rt.memory_mb ? " · " + rt.memory_mb + "M" : "") : "—",
);
// 源码链接AGPL §13静态文本第一次填好后不参与轮询刷新。
var foot = document.getElementById("ov-foot");
if (foot) {
var src = k && k.build && k.build.source_url;
var want = src
? '<a href="' +
escHtml(src) +
'" target="_blank" rel="noopener noreferrer">' +
escHtml(k.build.source_url) +
"</a></span></div>"
: "") +
'<div class="kv-row"><span class="key">' +
__("构建", "Build") +
'</span><span class="val">' +
escHtml(fmtBuild(k?.build, s)) +
"</span></div></div>";
if (k) {
html +=
'<div class="card"><h2>' +
__("LLM 状态", "LLM Status") +
"</h2>" +
'<div class="kv-row"><span class="key">Provider</span><span class="val">' +
(k.llm?.provider || __("未配置", "Not configured")) +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("可用源", "Sources") +
'</span><span class="val">' +
(k.llm?.sources || 0) +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("状态", "Status") +
'</span><span class="val"><span class="status-dot ' +
(k.llm?.available ? "dot-green" : "dot-red") +
'"></span>' +
(k.llm?.available
? __("运行中", "Running")
: __("不可用", "Unavailable")) +
"</span></div></div>";
html +=
'<div class="card"><h2>' +
__("记忆状态", "Memory Status") +
"</h2>" +
'<div class="kv-row"><span class="key">' +
__("图记忆", "Graph Memory") +
'</span><span class="val"><span class="status-dot ' +
(k.memory?.available ? "dot-green" : "dot-gray") +
'"></span>' +
(k.memory?.available
? k.memory.entity_count +
__(" 实体, ", " entities, ") +
k.memory.relation_count +
__(" 关系", " relations")
: __("未初始化", "Uninitialized")) +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("文档记忆", "Document Memory") +
'</span><span class="val">' +
(k.documents?.available
? k.documents.doc_count + __(" 文档", " docs")
: __("未初始化", "Uninitialized")) +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("文本记忆", "Text Memory") +
'</span><span class="val">' +
(k.text_memory?.available
? k.text_memory.file_count + __(" 文件", " files")
: __("未初始化", "Uninitialized")) +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("知识库", "Knowledge") +
'</span><span class="val">' +
(k.knowledge?.available
? k.knowledge.item_count + __(" 项", " items")
: __("未初始化", "Uninitialized")) +
"</span></div></div>";
html +=
'<div class="card"><h2>' +
__("运行时", "Runtime") +
"</h2>" +
'<div class="kv-row"><span class="key">Goroutines</span><span class="val">' +
(k.runtime?.goroutines || "-") +
"</span></div>" +
'<div class="kv-row"><span class="key">' +
__("内存", "Memory") +
'</span><span class="val">' +
(k.runtime?.memory_mb ? k.runtime.memory_mb + " MB" : "-") +
"</span></div>" +
'<div class="kv-row"><span class="key">Go ' +
__("版本", "Version") +
'</span><span class="val">' +
escHtml(k.runtime?.go_version || "-") +
"</span></div></div>";
__("源码", "Source") +
"</a>"
: "";
if (foot.__html !== want) {
foot.__html = want;
foot.innerHTML = want;
}
}
document.getElementById("tab-overview").innerHTML = html;
}
// ===== Chat =====