weichen
83a062b7f8
Why: BuildWorkspaceOptions / RdmErrorKind / RdmErrorView are only consumed inside their own modules, so exporting them pushed unused exports 45 over the knip baseline 43 and failed make test. Evidence: npx vitest run 23 files / 112 tests pass; node scripts/check-knip.mjs passes at 42 <= 43. Impact: no API change - consumers pass object literals and consume the classified error structurally. Refs: 2026-10-12 diagnostic report, increment 2.
93 lines
3.3 KiB
TypeScript
93 lines
3.3 KiB
TypeScript
// 体系工具排位：服务端声明的工作区对所有用户可见，按 shortcut 数字占位；
|
||
// 内置「代理」补进空位。文件浏览在第三栏「文件」入口（方案：入口收敛），不再占体系工具位。
|
||
// 插件管理面板不进这条清单。
|
||
// 2026-10-12 增量 2（审计入口能力门控）：「追溯审计」不再无条件内置——普通基座
|
||
// 没有任何 rdm.inspect.* 命令，入口可达而进入即 400。仅当命令面探测通过
|
||
//（rdmAuditReady / store.rdmAuditAvailable）才纳入；代理仍无条件以 ⌘1 补位。
|
||
|
||
export interface WorkspaceEntry {
|
||
key: string
|
||
title: string
|
||
icon: string
|
||
shortcut: string
|
||
}
|
||
|
||
export interface WorkspaceSource {
|
||
id: string
|
||
title: string
|
||
icon?: string
|
||
shortcut?: string
|
||
}
|
||
|
||
/** 审计工作区消费的全部 rdm.inspect.* 命令（capabilities 入口 + 四页签取数）。 */
|
||
export const RDM_AUDIT_COMMANDS = [
|
||
'rdm.inspect.capabilities',
|
||
'rdm.inspect.summary',
|
||
'rdm.inspect.tree',
|
||
'rdm.inspect.object',
|
||
'rdm.inspect.relations',
|
||
'rdm.inspect.events',
|
||
'rdm.inspect.history',
|
||
] as const
|
||
|
||
/** GET /api/commands 清单是否足以支撑审计工作区：七命令齐备且 enabled。清单不可用（未登录/请求失败）视为未就绪。 */
|
||
export function rdmAuditReady(cmds: { id?: string; enabled?: boolean }[] | null | undefined): boolean {
|
||
if (!Array.isArray(cmds)) return false
|
||
return RDM_AUDIT_COMMANDS.every(need => cmds.some(c => c?.id === need && c.enabled === true))
|
||
}
|
||
|
||
const BUILTINS: Omit<WorkspaceEntry, 'shortcut'>[] = [
|
||
{ key: 'agents', title: '代理', icon: '🤖' },
|
||
{ key: 'rdm-audit', title: '追溯审计', icon: '🔍' },
|
||
]
|
||
|
||
function shortcutNum(raw?: string): number | null {
|
||
if (!raw) return null
|
||
const m = raw.match(/(\d)/)
|
||
if (!m) return null
|
||
const n = Number(m[1])
|
||
return n >= 1 && n <= 9 ? n : null
|
||
}
|
||
|
||
interface BuildWorkspaceOptions {
|
||
/** rdm.inspect.* 命令面探测通过（store.rdmAuditAvailable）。默认 false：能力未知/缺失不展示审计入口。 */
|
||
rdmAudit?: boolean
|
||
}
|
||
|
||
export function buildWorkspaceEntries(server: WorkspaceSource[], opts: BuildWorkspaceOptions = {}): WorkspaceEntry[] {
|
||
const used = new Set<number>()
|
||
const ranked: { rank: number; entry: Omit<WorkspaceEntry, 'shortcut'> }[] = []
|
||
const unranked: Omit<WorkspaceEntry, 'shortcut'>[] = []
|
||
for (const w of server) {
|
||
const entry = { key: `ws:${w.id}`, title: w.title, icon: w.icon || '🗂' }
|
||
const n = shortcutNum(w.shortcut)
|
||
if (n && !used.has(n)) {
|
||
used.add(n)
|
||
ranked.push({ rank: n, entry })
|
||
} else {
|
||
unranked.push(entry)
|
||
}
|
||
}
|
||
const takeFree = (prefer: number): number => {
|
||
if (!used.has(prefer) && prefer >= 1 && prefer <= 9) {
|
||
used.add(prefer)
|
||
return prefer
|
||
}
|
||
for (let n = 1; n <= 9; n++) {
|
||
if (!used.has(n)) {
|
||
used.add(n)
|
||
return n
|
||
}
|
||
}
|
||
return 99
|
||
}
|
||
ranked.push({ rank: takeFree(1), entry: BUILTINS[0] })
|
||
if (opts.rdmAudit === true) ranked.push({ rank: takeFree(2), entry: BUILTINS[1] })
|
||
for (const entry of unranked) ranked.push({ rank: takeFree(9), entry })
|
||
return ranked
|
||
.filter(item => item.rank <= 9)
|
||
.sort((a, b) => a.rank - b.rank)
|
||
.slice(0, 9)
|
||
.map((item, i) => ({ ...item.entry, shortcut: `⌘${i + 1}` }))
|
||
}
|