M6(2/n): 治理台九功能 + SSE 订阅层 + 读/治分权

治理台按 §9.1 拆成九个 gov-* feature,共用件落 shared/gov:
  · 外壳(左轨/顶栏/面包屑/页签/整页下钻)自原型 Governance.tsx 平移,
    DOM 与 g-* 类名原样;路由状态即应用状态,区/页签/下钻栈全编码进 hash 可深链
  · 编排画布 diagram-js 画布件 1:1 平移(flow-layout/flow-node-paint/FlowDiagram),
    新增 pkg-to-graph 把 ProcessPackage 转成画布图模型;统一报价 v1 全图 12 节点 15 边渲染通过
  · 后端补四路由:审批单 / 工作流下钻 / 通道实例 / 度量仪表

SSE 订阅层(§9.2):app 层单一连接,按信封目标失效缓存;
组件不再自行轮询(去掉 refetchInterval)。广播只说「哪个目标动了」,不带业务载荷,
且在投递已落库已送达之后才发 —— 不是第二条投递链路。

两处实质修正:
  · 治理路由一律要 govern → 读路由改要 read。客体三类 × 动作三种的分法就是为此:
    BD 有 task:read 能看在途、动不了控制事件;一律 govern 等于把三种动作压成一种
  · 控制事件/恢复/改派原记为 engine-transition(归机器产出)→ 新增 control 条目种类,
    归人裁决侧。归侧是按动作类型的纯推导,所以「谁干的」必须体现在 kind 上;
    否则人的叫停会被算进自主率的机器分子

判据 ⑩ 治理台一半跑通:在途监控 / 叫停 / 恢复,治理动作留痕可查。
无权查看不再画成空清单,按岗位说明缺哪一项。

gates: tsc / eslint / depcruise(286 模块)/ api-report / 360 测试 全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
2026-07-27 03:28:40 +08:00
co-authored by Claude Opus 5
parent 594a0a9ca0
commit a9cd6d10c7
47 changed files with 7272 additions and 11 deletions
@@ -0,0 +1,5 @@
/**
* feature `gov-system` 唯一出口(编码规范 §9.1)。
* 系统管理:LLM 实例四元绑定、通道实例
*/
export { SystemHome, LlmPage, ChanPage } from './internal/panel.tsx';
@@ -0,0 +1,152 @@
/**
* feature `gov-system` —— 系统管理:LLM 实例四元绑定、通道实例
*
* 自 `~/coding/JCAI_PRD/governance/_components/Governance.tsx` 平移:
* DOM 结构、类名(`g-*` + 色调 `t-*`)与文案原样保留,mock 常量换成服务端投影(README 平移规则 1/2/4)。
* 区首页只负责导航,治理动作一律落在下钻详情页的**就地确认带**(影响预览三必答)。
*/
import { Card, Chip, NList, NRow, Note, PageHead, QueryGate, Rows, St } from '@web-shared/gov/primitives.tsx';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import {
useGovChannels,
useGovLlm,
} from '@web-shared/gov/gov-api.ts';
export type HomeProps = { tab: string; nav: Nav };
export function SystemHome({ tab, nav }: HomeProps) {
const llm = useGovLlm();
const channels = useGovChannels();
if (tab === 'chan') {
return (
<>
<Note>
通道实例声明<b>归属键规则</b>与默认认领岗位。归属解析三级逐级短路:会话线程 → 监听键 → 地址窗口;
歧义或失败一律判无主——<b>宁交人,不错投</b>。
</Note>
<NList>
{(channels.data?.channels ?? []).map((ch) => (
<NRow
key={ch.id}
tone={ch.enabled ? 'brand' : 'mute'}
ico="mail"
title={ch.name}
sub={ch.address}
cols={[
{ k: '归属键规则', v: ch.extractCount },
{ k: '载荷映射', v: ch.mappingCount },
{ k: '地址窗口', v: <span className="g-mono">{Math.round(ch.addressWindowMs / 3600_000)}h</span> },
{ k: '默认认领岗位', v: ch.fallbackPosition ?? '—' },
]}
right={
<St tone={ch.enabled ? 'ok' : 'mute'} ico={ch.enabled ? 'circle-check' : 'power'}>
{ch.enabled ? '已启用' : '已停用'}
</St>
}
onClick={() => nav.push({ k: 'chan', id: ch.id })}
/>
))}
</NList>
</>
);
}
return (
<QueryGate query={llm}>
<>
<Note>
LLM 实例是<b>名称间接层</b>:活动只见自定义模型名,Provider / URL / API-Key / Model 四元在系统侧绑定。
密钥与 endpoint 值只存治理台——不入包、不入活动、不入留痕明文。
</Note>
<NList>
{(llm.data?.instances ?? []).map((i) => (
<NRow
key={i.id}
tone={i.enabled ? 'brand' : 'mute'}
ico="cpu"
title={i.name}
sub={`${i.provider} · ${i.model}`}
cols={[
{ k: 'Base URL', v: <span className="g-mono">{i.baseUrl}</span> },
{ k: '系统用途', v: i.systemUse ? '是' : '—' },
]}
right={
<St tone={i.apiKeyBound ? 'ok' : 'warn'} ico={i.apiKeyBound ? 'shield-check' : 'alert-triangle'}>
{i.apiKeyBound ? '密钥已绑定' : '密钥未绑定'}
</St>
}
onClick={() => nav.push({ k: 'llm', id: i.id })}
/>
))}
</NList>
</>
</QueryGate>
);
}
export function LlmPage({ id }: { id: string }) {
const q = useGovLlm();
const i = (q.data?.instances ?? []).find((x) => x.id === id);
if (i === undefined) return <Note>实例不存在。</Note>;
return (
<>
<PageHead
ico="cpu"
kicker={`LLM 实例 · ${i.provider}`}
title={i.name}
chips={
<>
<Chip ico="hash">{i.model}</Chip>
<Chip tone={i.apiKeyBound ? 'ok' : 'warn'}>{i.apiKeyBound ? '密钥已绑定' : '密钥未绑定'}</Chip>
{i.systemUse && <Chip tone="brand">系统用途</Chip>}
</>
}
desc="名称间接层:活动只声明自定义模型名,四元绑定在系统侧。换厂商、换端点、换密钥都不动活动一行代码。"
/>
<Card ico="settings" title="四元绑定">
<Rows
items={[
{ k: 'Provider', v: i.provider },
{ k: 'Base URL', v: i.baseUrl, mono: true },
{ k: 'Model', v: i.model, mono: true },
{ k: 'API-Key', v: i.apiKeyBound ? '已绑定(密文存储,永不回显)' : '未绑定' },
]}
/>
</Card>
</>
);
}
export function ChanPage({ id }: { id: string }) {
const q = useGovChannels();
const ch = (q.data?.channels ?? []).find((x) => x.id === id);
if (ch === undefined) return <Note>通道不存在。</Note>;
return (
<>
<PageHead
ico="mail"
kicker={`通道实例 · ${ch.kind}`}
title={ch.name}
chips={
<>
<Chip ico="at-sign">{ch.address}</Chip>
<Chip tone={ch.enabled ? 'ok' : 'mute'}>{ch.enabled ? '已启用' : '已停用'}</Chip>
</>
}
desc="归属解析三级逐级短路:会话线程 → 监听键 → 地址窗口;歧义或失败一律判无主——宁交人,不错投。"
/>
<Card ico="settings" title="归属与映射">
<Rows
items={[
{ k: '归属键规则', v: `${ch.extractCount} 条` },
{ k: '载荷映射', v: `${ch.mappingCount} 条` },
{ k: '地址窗口', v: `${Math.round(ch.addressWindowMs / 3600_000)} 小时`, mono: true },
{ k: '默认认领岗位', v: ch.fallbackPosition ?? '—' },
]}
/>
</Card>
</>
);
}