feat(ql3): add read-only cluster copilot console

This commit is contained in:
whyour
2026-08-16 04:35:28 +08:00
parent da4e7cf688
commit c4a1238a92
32 changed files with 3407 additions and 20 deletions
@@ -0,0 +1,588 @@
:root {
--paper: #f3f6f1;
--paper-deep: #e7ede6;
--ink: #17231d;
--muted: #607067;
--line: #cbd5cc;
--moss: #2f654d;
--moss-soft: #dce9df;
--amber: #c98724;
--plum: #69556d;
--rust: #a84f38;
--white: #fbfdf9;
--shadow: 0 24px 70px rgba(31, 52, 40, 0.12);
font-family:
"Avenir Next", "Segoe UI Variable", "Segoe UI", "PingFang SC",
"Hiragino Sans GB", sans-serif;
color: var(--ink);
background: var(--paper);
font-synthesis: none;
}
* {
box-sizing: border-box;
}
html {
min-width: 320px;
background:
linear-gradient(90deg, rgba(47, 101, 77, 0.035) 1px, transparent 1px)
0 0 / 24px 24px,
var(--paper);
}
body {
margin: 0;
min-height: 100vh;
}
button,
input {
font: inherit;
}
button {
border: 1px solid var(--ink);
border-radius: 3px;
padding: 0.78rem 1rem;
color: var(--ink);
background: transparent;
cursor: pointer;
transition:
transform 140ms ease,
background-color 140ms ease,
color 140ms ease;
}
button:hover:not(:disabled) {
transform: translateY(-1px);
background: var(--ink);
color: var(--white);
}
button:disabled {
cursor: not-allowed;
opacity: 0.42;
}
button.primary {
background: var(--moss);
border-color: var(--moss);
color: var(--white);
}
button:focus-visible,
input:focus-visible,
pre:focus-visible {
outline: 3px solid color-mix(in srgb, var(--amber) 72%, white);
outline-offset: 3px;
}
input {
width: 100%;
border: 0;
border-bottom: 1px solid var(--ink);
border-radius: 0;
padding: 0.72rem 0;
color: var(--ink);
background: transparent;
}
input::placeholder {
color: #91a097;
}
.skip-link {
position: fixed;
left: 1rem;
top: 1rem;
z-index: 20;
transform: translateY(-180%);
padding: 0.7rem 1rem;
background: var(--ink);
color: white;
}
.skip-link:focus {
transform: translateY(0);
}
.shell {
width: min(1440px, 100%);
margin: 0 auto;
min-height: 100vh;
padding: 2rem clamp(1rem, 3vw, 3.5rem) 1.25rem;
display: flex;
flex-direction: column;
}
.masthead {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 2rem;
padding-bottom: 1.6rem;
border-bottom: 1px solid var(--ink);
}
.brand-lockup {
display: flex;
align-items: center;
gap: 1.2rem;
}
.brand-mark {
display: grid;
place-items: center;
width: 3.15rem;
height: 3.15rem;
border: 1px solid var(--ink);
border-radius: 50%;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-weight: 800;
letter-spacing: -0.09em;
}
.eyebrow {
margin: 0 0 0.42rem;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-size: 0.69rem;
font-weight: 700;
letter-spacing: 0.12em;
text-transform: uppercase;
color: var(--muted);
}
h1,
h2,
h3,
p {
margin-top: 0;
}
h1 {
margin-bottom: 0;
max-width: 18ch;
font-size: clamp(1.55rem, 3vw, 3rem);
line-height: 0.98;
letter-spacing: -0.055em;
}
h2 {
margin-bottom: 0.7rem;
font-size: clamp(1.45rem, 2vw, 2.15rem);
letter-spacing: -0.035em;
}
h3 {
letter-spacing: -0.025em;
}
.boundary {
min-width: 11rem;
display: grid;
grid-template-columns: auto 1fr;
gap: 0.22rem 0.52rem;
align-items: center;
font-size: 0.76rem;
}
.boundary strong {
grid-column: 2;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-weight: 500;
color: var(--muted);
}
.boundary-dot {
width: 0.65rem;
height: 0.65rem;
border-radius: 50%;
background: var(--moss);
box-shadow: 0 0 0 5px var(--moss-soft);
}
.workspace {
flex: 1;
display: grid;
grid-template-columns: minmax(18rem, 0.82fr) minmax(28rem, 1.4fr);
min-height: 680px;
border-bottom: 1px solid var(--ink);
}
.control-deck,
.evidence-panel {
padding: clamp(1.5rem, 3vw, 3.25rem);
}
.control-deck {
border-right: 1px solid var(--ink);
background: rgba(251, 253, 249, 0.72);
}
.section-heading > p:last-child {
max-width: 44ch;
line-height: 1.7;
color: var(--muted);
}
.session-gate {
margin: 2.5rem 0 2rem;
padding: 1.1rem;
border-left: 3px solid var(--plum);
background: color-mix(in srgb, var(--plum) 8%, var(--white));
}
.inline-control {
display: grid;
grid-template-columns: minmax(0, 1fr) auto;
gap: 0.8rem;
}
.field-note {
margin: 0.75rem 0 0;
font-size: 0.78rem;
line-height: 1.55;
color: var(--muted);
}
.target-form {
display: grid;
gap: 0.45rem;
}
.target-form label,
.session-gate label {
margin-top: 0.9rem;
font-size: 0.78rem;
font-weight: 750;
letter-spacing: 0.025em;
}
.actions {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 0.65rem;
margin-top: 1.7rem;
}
.trust-note {
margin-top: 2.4rem;
padding-top: 1rem;
border-top: 1px solid var(--line);
}
.trust-note span {
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-size: 0.68rem;
text-transform: uppercase;
letter-spacing: 0.1em;
color: var(--plum);
}
.trust-note p {
margin: 0.45rem 0 0;
font-size: 0.8rem;
line-height: 1.55;
color: var(--muted);
}
.evidence-panel {
position: relative;
background: var(--paper-deep);
}
.evidence-header,
.output-heading {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 1rem;
}
.status-chip {
border: 1px solid currentColor;
border-radius: 999px;
padding: 0.35rem 0.64rem;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-size: 0.68rem;
color: var(--muted);
}
.status-chip[data-tone="running"] {
color: var(--amber);
}
.status-chip[data-tone="success"] {
color: var(--moss);
}
.status-chip[data-tone="failed"] {
color: var(--rust);
}
.empty-state {
min-height: 450px;
display: grid;
place-content: center;
justify-items: center;
text-align: center;
}
.empty-state p {
max-width: 38ch;
line-height: 1.65;
color: var(--muted);
}
.empty-glyph {
width: 12rem;
height: 7rem;
margin-bottom: 2rem;
display: flex;
align-items: flex-end;
justify-content: center;
gap: 1.3rem;
border-bottom: 1px solid var(--ink);
}
.empty-glyph span {
width: 1px;
background: var(--ink);
transform-origin: bottom;
animation: signal 2.4s ease-in-out infinite;
}
.empty-glyph span:nth-child(1) {
height: 35%;
}
.empty-glyph span:nth-child(2) {
height: 82%;
animation-delay: 180ms;
}
.empty-glyph span:nth-child(3) {
height: 54%;
animation-delay: 360ms;
}
@keyframes signal {
0%,
100% {
transform: scaleY(0.55);
opacity: 0.42;
}
45% {
transform: scaleY(1);
opacity: 1;
}
}
.trace-rail {
list-style: none;
margin: 2.2rem 0;
padding: 0;
display: grid;
grid-template-columns: repeat(3, 1fr);
}
.trace-rail li {
position: relative;
display: grid;
grid-template-columns: auto 1fr;
gap: 0.75rem;
min-height: 5rem;
}
.trace-rail li:not(:last-child)::after {
content: "";
position: absolute;
top: 0.42rem;
left: 0.45rem;
right: -0.45rem;
height: 1px;
background: var(--moss);
}
.trace-node {
position: relative;
z-index: 1;
width: 0.9rem;
height: 0.9rem;
border: 3px solid var(--paper-deep);
border-radius: 50%;
background: var(--moss);
box-shadow: 0 0 0 1px var(--moss);
}
.trace-rail small,
.fact-grid dt,
.output-meta dt {
display: block;
margin-bottom: 0.42rem;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-size: 0.65rem;
letter-spacing: 0.11em;
color: var(--muted);
}
.trace-rail strong {
font-size: 0.9rem;
overflow-wrap: anywhere;
}
.fact-grid {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
margin: 0;
border-top: 1px solid var(--ink);
border-left: 1px solid var(--ink);
}
.fact-grid div {
min-height: 6.4rem;
padding: 1rem;
border-right: 1px solid var(--ink);
border-bottom: 1px solid var(--ink);
}
.fact-grid dd,
.output-meta dd {
margin: 0;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-size: 0.82rem;
overflow-wrap: anywhere;
}
.output-panel {
margin-top: 2rem;
padding: 1.2rem;
border: 1px solid var(--plum);
background: var(--white);
box-shadow: var(--shadow);
}
.output-heading span {
border: 1px solid var(--plum);
padding: 0.3rem 0.55rem;
font-size: 0.66rem;
color: var(--plum);
}
.output-panel pre {
max-height: 28rem;
overflow: auto;
margin: 1rem 0;
padding: 1rem;
border-left: 3px solid var(--plum);
white-space: pre-wrap;
word-break: break-word;
font: 0.82rem/1.7 ui-monospace, "SFMono-Regular", Consolas, monospace;
background: #f1eef2;
}
.output-meta {
display: grid;
grid-template-columns: 0.7fr 0.7fr 1.6fr;
gap: 1rem;
margin: 0;
}
.message {
min-height: 1.4rem;
margin-top: 1.2rem;
font-size: 0.82rem;
color: var(--muted);
}
.message[data-tone="error"] {
color: var(--rust);
}
footer {
display: flex;
justify-content: space-between;
gap: 1rem;
padding-top: 1rem;
font-family: ui-monospace, "SFMono-Regular", Consolas, monospace;
font-size: 0.65rem;
color: var(--muted);
}
[hidden] {
display: none !important;
}
@media (max-width: 860px) {
.masthead,
footer {
flex-direction: column;
}
.workspace {
grid-template-columns: 1fr;
}
.control-deck {
border-right: 0;
border-bottom: 1px solid var(--ink);
}
.trace-rail {
grid-template-columns: 1fr;
gap: 1rem;
}
.trace-rail li {
min-height: 3rem;
}
.trace-rail li:not(:last-child)::after {
left: 0.42rem;
right: auto;
top: 0.8rem;
bottom: -1.45rem;
width: 1px;
height: auto;
}
}
@media (max-width: 520px) {
.shell {
padding-inline: 0.75rem;
}
.brand-lockup {
align-items: flex-start;
}
.brand-mark {
flex: 0 0 auto;
width: 2.7rem;
height: 2.7rem;
}
.control-deck,
.evidence-panel {
padding: 1.25rem;
}
.inline-control,
.actions,
.fact-grid,
.output-meta {
grid-template-columns: 1fr;
}
}
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
scroll-behavior: auto !important;
transition-duration: 0.01ms !important;
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
}
}
@@ -0,0 +1,190 @@
"use strict";
(function () {
const commandSchema = "qinglong/cluster-copilot-console-read-request@v1";
const sessionForm = document.getElementById("session-form");
const sessionInput = document.getElementById("session-token");
const targetForm = document.getElementById("target-form");
const inspectButton = document.getElementById("inspect-button");
const outputButton = document.getElementById("output-button");
const emptyState = document.getElementById("empty-state");
const resultView = document.getElementById("result-view");
const outputPanel = document.getElementById("output-panel");
const outputText = document.getElementById("output-text");
const message = document.getElementById("message");
const statusChip = document.getElementById("status-chip");
let sessionToken = "";
let currentTarget = null;
const setText = function (id, value) {
document.getElementById(id).textContent =
value === null || value === undefined || value === "" ? "—" : String(value);
};
const setMessage = function (value, tone) {
message.textContent = value;
message.dataset.tone = tone || "neutral";
};
const dateTime = function (value) {
if (!Number.isSafeInteger(value)) return "—";
return new Intl.DateTimeFormat("zh-CN", {
dateStyle: "medium",
timeStyle: "medium",
}).format(new Date(value));
};
const setBusy = function (busy) {
inspectButton.disabled = busy;
outputButton.disabled =
busy || !currentTarget || currentTarget.outputAvailable !== true;
};
const request = async function (operation, target) {
const response = await fetch("/api/v1/copilot/" + operation, {
method: "POST",
cache: "no-store",
credentials: "omit",
redirect: "error",
referrerPolicy: "no-referrer",
headers: {
Accept: "application/json",
"Content-Type": "application/json; charset=utf-8",
Authorization: "QL3-Console " + sessionToken,
},
body: JSON.stringify({
schema: commandSchema,
operation: operation,
projectId: target.projectId,
sourceRunId: target.sourceRunId,
requestId: target.requestId,
}),
});
const body = await response.json();
if (!response.ok) {
const error = new Error(
typeof body.code === "string" ? body.code : "console_request_failed",
);
error.code = typeof body.code === "string" ? body.code : "console_request_failed";
throw error;
}
return body;
};
const targetFromForm = function () {
const form = new FormData(targetForm);
return {
projectId: String(form.get("projectId") || "").trim(),
sourceRunId: String(form.get("sourceRunId") || "").trim(),
requestId: String(form.get("requestId") || "").trim(),
};
};
const renderInspection = function (response) {
const result = response.result;
const fact = result.result;
currentTarget = {
projectId: fact.projectId,
sourceRunId: fact.sourceRunId,
requestId: fact.requestId,
outputAvailable: fact.outputAvailable,
};
emptyState.hidden = true;
resultView.hidden = false;
outputPanel.hidden = true;
outputText.textContent = "";
setText("admitted-at", dateTime(fact.admittedAtMs));
setText("stage", fact.stage || (fact.status === "running" ? "processing" : null));
setText("outcome", fact.outcome || fact.status);
setText("diagnosis-run", fact.diagnosisRunId);
setText("reason", fact.reason);
setText(
"tokens",
fact.usage === null ? null : fact.usage.totalTokens,
);
setText(
"cost",
fact.usage === null || fact.usage.costMicros === null
? null
: "$" + (fact.usage.costMicros / 1000000).toFixed(6),
);
statusChip.textContent = fact.status === "running" ? "诊断进行中" : fact.outcome;
statusChip.dataset.tone =
fact.status === "running"
? "running"
: fact.outcome === "succeeded"
? "success"
: "failed";
outputButton.disabled = fact.outputAvailable !== true;
setMessage(
fact.outputAvailable
? "状态已验证。诊断内容仍未读取。"
: "状态已验证;当前没有可读取的诊断内容。",
);
};
const renderOutput = function (response) {
const fact = response.result.result;
outputPanel.hidden = false;
outputText.textContent = fact.result.text;
setText("finish-reason", fact.result.finishReason);
setText("output-bytes", fact.reference.outputBytes);
setText("content-digest", fact.reference.contentDigest);
setMessage("诊断内容已显式读取;请把它当作不可信建议进行复核。");
outputPanel.scrollIntoView({ behavior: "smooth", block: "nearest" });
};
sessionForm.addEventListener("submit", function (event) {
event.preventDefault();
const candidate = sessionInput.value.trim();
if (!/^[A-Za-z0-9_-]{43}$/.test(candidate)) {
setMessage("浏览器访问密钥格式无效。", "error");
return;
}
sessionToken = candidate;
sessionInput.value = "";
sessionForm.hidden = true;
targetForm.hidden = false;
setMessage("本次页面已解锁。访问密钥只保留在内存中。");
document.getElementById("project-id").focus();
});
targetForm.addEventListener("submit", async function (event) {
event.preventDefault();
const target = targetFromForm();
setBusy(true);
setMessage("正在读取 durable status…");
try {
const response = await request("inspect", target);
renderInspection(response);
} catch (error) {
currentTarget = null;
outputPanel.hidden = true;
statusChip.textContent = "读取失败";
statusChip.dataset.tone = "failed";
setMessage("无法读取诊断状态:" + error.code, "error");
} finally {
setBusy(false);
}
});
outputButton.addEventListener("click", async function () {
if (!currentTarget || currentTarget.outputAvailable !== true) return;
setBusy(true);
setMessage("正在显式读取诊断内容…");
try {
const response = await request("output", currentTarget);
renderOutput(response);
} catch (error) {
setMessage("无法读取诊断内容:" + error.code, "error");
} finally {
setBusy(false);
}
});
window.addEventListener("pagehide", function () {
sessionToken = "";
currentTarget = null;
outputText.textContent = "";
});
})();
@@ -0,0 +1,218 @@
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="color-scheme" content="light" />
<meta
name="description"
content="QingLong 3.0 Cluster Copilot 只读诊断台"
/>
<title>QingLong 3.0 · Copilot 诊断台</title>
<link rel="stylesheet" href="/app.css" />
<script src="/app.js" defer></script>
</head>
<body>
<a class="skip-link" href="#workspace">跳到诊断工作区</a>
<div class="shell">
<header class="masthead">
<div class="brand-lockup" aria-label="QingLong 3.0 Cluster Console">
<span class="brand-mark" aria-hidden="true">QL</span>
<div>
<p class="eyebrow">QingLong 3.0 / Cluster field console</p>
<h1>故障诊断,不替你执行。</h1>
</div>
</div>
<div class="boundary" aria-label="当前权限边界">
<span class="boundary-dot" aria-hidden="true"></span>
<span>只读边界</span>
<strong>inspect · output</strong>
</div>
</header>
<main id="workspace" class="workspace">
<section class="control-deck" aria-labelledby="target-title">
<div class="section-heading">
<p class="eyebrow">Target coordinates</p>
<h2 id="target-title">定位一次诊断</h2>
<p>
输入已存在的 Project、源 Run 和诊断请求。页面不会创建、取消或重试任何任务。
</p>
</div>
<form id="session-form" class="session-gate" autocomplete="off">
<label for="session-token">浏览器访问密钥</label>
<div class="inline-control">
<input
id="session-token"
name="sessionToken"
type="password"
inputmode="text"
spellcheck="false"
autocomplete="off"
required
pattern="[A-Za-z0-9_\-]{43}"
aria-describedby="session-note"
/>
<button type="submit">解锁本次页面</button>
</div>
<p id="session-note" class="field-note">
从独立的 0600 session 文件读取并粘贴;仅保留在当前页面内存,不会发送到 Cluster API。
</p>
</form>
<form id="target-form" class="target-form" autocomplete="off" hidden>
<label for="project-id">Project</label>
<input
id="project-id"
name="projectId"
type="text"
maxlength="128"
spellcheck="false"
autocomplete="off"
placeholder="project-main"
required
/>
<label for="run-id">源 Run</label>
<input
id="run-id"
name="sourceRunId"
type="text"
maxlength="36"
spellcheck="false"
autocomplete="off"
placeholder="run_..."
required
/>
<label for="request-id">诊断请求</label>
<input
id="request-id"
name="requestId"
type="text"
maxlength="128"
spellcheck="false"
autocomplete="off"
placeholder="diag-request-..."
required
/>
<div class="actions">
<button id="inspect-button" class="primary" type="submit">
读取诊断状态
</button>
<button id="output-button" type="button" disabled>
显式读取诊断内容
</button>
</div>
</form>
<aside class="trust-note">
<span>Authority note</span>
<p>
Cluster credential 只存在于本机 BFF 的私有文件中。浏览器不能读取它,也不能调用 diagnose 或 cancel。
</p>
</aside>
</section>
<section class="evidence-panel" aria-labelledby="evidence-title">
<div class="evidence-header">
<div>
<p class="eyebrow">Durable evidence</p>
<h2 id="evidence-title">诊断轨迹</h2>
</div>
<span id="status-chip" class="status-chip" data-tone="idle">等待目标</span>
</div>
<div id="empty-state" class="empty-state">
<div class="empty-glyph" aria-hidden="true">
<span></span><span></span><span></span>
</div>
<h3>先读取状态,再决定是否查看内容</h3>
<p>
状态响应只包含有界、低敏的 durable facts。模型文本必须由你再次明确选择。
</p>
</div>
<div id="result-view" hidden>
<ol class="trace-rail" aria-label="诊断状态时间线">
<li>
<span class="trace-node"></span>
<div>
<small>ADMITTED</small>
<strong id="admitted-at"></strong>
</div>
</li>
<li>
<span class="trace-node"></span>
<div>
<small>STAGE</small>
<strong id="stage"></strong>
</div>
</li>
<li>
<span class="trace-node"></span>
<div>
<small>OUTCOME</small>
<strong id="outcome"></strong>
</div>
</li>
</ol>
<dl class="fact-grid">
<div>
<dt>Diagnosis Run</dt>
<dd id="diagnosis-run"></dd>
</div>
<div>
<dt>Reason</dt>
<dd id="reason"></dd>
</div>
<div>
<dt>Tokens</dt>
<dd id="tokens"></dd>
</div>
<div>
<dt>Settled cost</dt>
<dd id="cost"></dd>
</div>
</dl>
<section id="output-panel" class="output-panel" hidden>
<div class="output-heading">
<div>
<p class="eyebrow">Explicit content read</p>
<h3>诊断内容</h3>
</div>
<span>不可信模型输出</span>
</div>
<pre id="output-text" tabindex="0"></pre>
<dl class="output-meta">
<div>
<dt>Finish reason</dt>
<dd id="finish-reason"></dd>
</div>
<div>
<dt>Output bytes</dt>
<dd id="output-bytes"></dd>
</div>
<div>
<dt>Content digest</dt>
<dd id="content-digest"></dd>
</div>
</dl>
</section>
</div>
<div id="message" class="message" role="status" aria-live="polite"></div>
</section>
</main>
<footer>
<span>Loopback only · no legacy session · no browser credential</span>
<span>QingLong 3.0 incubation / D-327</span>
</footer>
</div>
</body>
</html>