496 lines
33 KiB
TypeScript
496 lines
33 KiB
TypeScript
import type { SCUMConfigField, SCUMFeatureWorkspace, SCUMLogicalDirectory, SCUMLogicalFile } from "./contracts.js";
|
|
|
|
type StateSetter<T> = (next: T | ((previous: T) => T)) => void;
|
|
export type ReactLike = {
|
|
createElement: (...args: any[]) => any;
|
|
useEffect?: (effect: () => void | (() => void), deps: readonly unknown[]) => void;
|
|
useState?: <T>(initialState: T | (() => T)) => [T, StateSetter<T>];
|
|
};
|
|
|
|
export type SCUMFileReadSnapshot = {
|
|
serverInstanceId: string;
|
|
pluginId: string;
|
|
key: string;
|
|
state: "ready" | "pending" | "not-read" | "unavailable" | string;
|
|
content?: string;
|
|
version?: number;
|
|
checksum?: string;
|
|
sizeBytes?: number;
|
|
jobId?: string;
|
|
readAt?: string;
|
|
reason?: string;
|
|
};
|
|
|
|
export type SCUMPageContext = {
|
|
serverInstanceId?: string;
|
|
permissions: string[];
|
|
availability: { available: boolean; reason?: string };
|
|
featureAvailability?: Array<{ key: string; available: boolean; reason?: string }>;
|
|
workspace?: SCUMFeatureWorkspace;
|
|
workspaceActions?: {
|
|
refreshWorkspace?: () => Promise<SCUMFeatureWorkspace | undefined>;
|
|
requestFile?: (fileKey: string) => Promise<{ status: string; message: string; jobId?: string }>;
|
|
getFileSnapshot?: (fileKey: string) => Promise<SCUMFileReadSnapshot>;
|
|
writeFile?: (fileKey: string, content: string, options?: { expectedChecksum?: string }) => Promise<{ status: string; message: string; jobId?: string }>;
|
|
};
|
|
};
|
|
|
|
type NormalizedWorkspace = { defaultDirectoryKey: string; directories: readonly SCUMLogicalDirectory[]; files: readonly SCUMLogicalFile[]; configFields: readonly SCUMConfigField[] };
|
|
type ConfigMode = "fields" | "pairs" | "source";
|
|
type RawEncoding = "utf-8" | "utf-16le";
|
|
type FileRequestState = { fileKey: string; status: string; message: string; jobId?: string } | null;
|
|
type WorkspaceRefreshState = { status: string; message: string } | null;
|
|
type PreviewState = { fileKey: string; mode: ConfigMode; summary: string; proposedContent: string; lines: readonly DiffLine[] } | null;
|
|
type DiffLine = { kind: "same" | "added" | "removed"; text: string };
|
|
|
|
export function renderSCUMFeaturePage(react: ReactLike, input: SCUMPageContext) {
|
|
const e = react.createElement;
|
|
const workspace = normalizeWorkspace(input.workspace);
|
|
const [selectedDirectoryKey, setSelectedDirectoryKey] = usePluginState(react, workspace.defaultDirectoryKey);
|
|
const effectiveDirectoryKey = workspace.directories.some((directory) => directory.key === selectedDirectoryKey) ? selectedDirectoryKey : workspace.defaultDirectoryKey;
|
|
const directoryFiles = workspace.files.filter((file) => file.directoryKey === effectiveDirectoryKey);
|
|
const defaultFileKey = initialFileKey(workspace, effectiveDirectoryKey);
|
|
const [selectedFileKey, setSelectedFileKey] = usePluginState(react, defaultFileKey);
|
|
const selectedFile = directoryFiles.find((file) => file.key === selectedFileKey) ?? directoryFiles[0] ?? workspace.files[0];
|
|
const selectedFields = selectedFile ? workspace.configFields.filter((field) => field.fileKey === selectedFile.key) : [];
|
|
const [configMode, setConfigMode] = usePluginState<ConfigMode>(react, "fields");
|
|
const [fieldDraft, setFieldDraft] = usePluginState<Record<string, string>>(react, {});
|
|
const [pairDraft, setPairDraft] = usePluginState<Record<string, string>>(react, {});
|
|
const [rawDraft, setRawDraft] = usePluginState<Record<string, string>>(react, {});
|
|
const [rawEncoding, setRawEncoding] = usePluginState<RawEncoding>(react, "utf-8");
|
|
const [snapshot, setSnapshot] = usePluginState<SCUMFileReadSnapshot | null>(react, null);
|
|
const [requestState, setRequestState] = usePluginState<FileRequestState>(react, null);
|
|
const [workspaceRefreshState, setWorkspaceRefreshState] = usePluginState<WorkspaceRefreshState>(react, null);
|
|
const [writeState, setWriteState] = usePluginState<FileRequestState>(react, null);
|
|
const [preview, setPreview] = usePluginState<PreviewState>(react, null);
|
|
const scoped = Boolean(input.serverInstanceId);
|
|
const canFilesRead = scoped && input.permissions.includes("server.files.read");
|
|
const canFilesWrite = scoped && input.permissions.includes("server.files.write");
|
|
|
|
if (react.useEffect) {
|
|
react.useEffect(() => {
|
|
let active = true;
|
|
setPreview(null);
|
|
setWriteState(null);
|
|
if (!selectedFile || !input.workspaceActions?.getFileSnapshot) {
|
|
setSnapshot(null);
|
|
return () => { active = false; };
|
|
}
|
|
void input.workspaceActions.getFileSnapshot(selectedFile.key).then((next) => {
|
|
if (active) setSnapshot(next);
|
|
}).catch((error) => {
|
|
if (active) setSnapshot({ serverInstanceId: input.serverInstanceId ?? "", pluginId: "game.scum", key: selectedFile.key, state: "unavailable", reason: error instanceof Error ? error.message : "无法读取文件快照。" });
|
|
});
|
|
return () => { active = false; };
|
|
}, [input.serverInstanceId, input.workspaceActions?.getFileSnapshot, selectedFile?.key]);
|
|
}
|
|
|
|
function refreshWorkspaceCatalog() {
|
|
if (!input.workspaceActions?.refreshWorkspace) return;
|
|
setWorkspaceRefreshState({ status: "pending", message: "正在从平台刷新声明文件列表..." });
|
|
void input.workspaceActions.refreshWorkspace().then((next) => {
|
|
const count = next?.files?.length ?? 0;
|
|
setWorkspaceRefreshState({ status: "ok", message: `文件列表已刷新：${count} 个声明文件。` });
|
|
}).catch((error) => {
|
|
setWorkspaceRefreshState({ status: "error", message: error instanceof Error ? error.message : "文件列表刷新失败。" });
|
|
});
|
|
}
|
|
|
|
function loadFileSnapshot(fileKey: string, poll = false, attempt = 0) {
|
|
if (!input.workspaceActions?.getFileSnapshot) return;
|
|
void input.workspaceActions.getFileSnapshot(fileKey).then((next) => {
|
|
setSnapshot(next);
|
|
if (poll && next.state !== "ready" && attempt < 8) {
|
|
globalThis.setTimeout(() => loadFileSnapshot(fileKey, true, attempt + 1), Math.min(3200, 600 + attempt * 350));
|
|
}
|
|
}).catch((error) => {
|
|
setSnapshot({ serverInstanceId: input.serverInstanceId ?? "", pluginId: "game.scum", key: fileKey, state: "unavailable", reason: error instanceof Error ? error.message : "无法读取文件快照。" });
|
|
});
|
|
}
|
|
|
|
function selectDirectory(directoryKey: string) {
|
|
const nextFiles = workspace.files.filter((file) => file.directoryKey === directoryKey);
|
|
const nextFile = nextFiles.find((file) => file.kind === "config") ?? nextFiles[0];
|
|
setSelectedDirectoryKey(directoryKey);
|
|
if (nextFile) selectFile(nextFile, directoryKey);
|
|
}
|
|
|
|
function selectFile(file: SCUMLogicalFile, directoryKey = file.directoryKey) {
|
|
setSelectedDirectoryKey(directoryKey);
|
|
setSelectedFileKey(file.key);
|
|
setConfigMode(file.kind === "config" && workspace.configFields.some((field) => field.fileKey === file.key) ? "fields" : "source");
|
|
setRequestState(null);
|
|
setWriteState(null);
|
|
setPreview(null);
|
|
setRawEncoding("utf-8");
|
|
}
|
|
|
|
function requestSelectedFile() {
|
|
if (!selectedFile || !canFilesRead || !input.workspaceActions?.requestFile) return;
|
|
setRequestState({ fileKey: selectedFile.key, status: "pending", message: "正在提交文件读取请求..." });
|
|
setPreview(null);
|
|
void input.workspaceActions.requestFile(selectedFile.key).then((result) => {
|
|
setRequestState({ fileKey: selectedFile.key, status: result.status, message: result.message, jobId: result.jobId });
|
|
if (result.status === "queued" || result.status === "ok") {
|
|
setSnapshot({ serverInstanceId: input.serverInstanceId ?? "", pluginId: "game.scum", key: selectedFile.key, state: "pending", jobId: result.jobId, reason: "等待运行端完成文件读取。" });
|
|
loadFileSnapshot(selectedFile.key, true);
|
|
}
|
|
}).catch((error) => setRequestState({ fileKey: selectedFile.key, status: "error", message: error instanceof Error ? error.message : "文件读取请求失败。" }));
|
|
}
|
|
|
|
function refreshSelectedSnapshot() {
|
|
if (!selectedFile || !input.workspaceActions?.getFileSnapshot) return;
|
|
setPreview(null);
|
|
loadFileSnapshot(selectedFile.key);
|
|
}
|
|
|
|
function previewModeChange(mode: ConfigMode, content: string, current: string) {
|
|
if (!selectedFile) return;
|
|
const diff = buildSimpleDiff(current, content);
|
|
setPreview({ fileKey: selectedFile.key, mode, proposedContent: content, summary: diff.summary, lines: diff.lines });
|
|
}
|
|
|
|
function writePreviewedContent() {
|
|
if (!selectedFile || !preview || preview.fileKey !== selectedFile.key || !input.workspaceActions?.writeFile) return;
|
|
setWriteState({ fileKey: selectedFile.key, status: "pending", message: "正在提交声明文件写入..." });
|
|
void input.workspaceActions.writeFile(selectedFile.key, preview.proposedContent, { expectedChecksum: snapshot?.checksum }).then((result) => {
|
|
setWriteState({ fileKey: selectedFile.key, status: result.status, message: result.message, jobId: result.jobId });
|
|
setPreview(null);
|
|
}).catch((error) => setWriteState({ fileKey: selectedFile.key, status: "error", message: error instanceof Error ? error.message : "文件写入请求失败。" }));
|
|
}
|
|
|
|
return e("section", { className: "console-panel", "aria-label": "SCUM 文件管理" },
|
|
e("div", { className: "panel-header" },
|
|
e("div", null, e("h2", null, "文件管理"), e("p", { className: "provider-id" }, "第一级选择目录，第二级选择目录内文件；配置默认表单，日志只读原文。")),
|
|
e("span", { className: "page-status" }, scoped ? "声明文件工作区" : "插件页面未绑定服务器")
|
|
),
|
|
e("div", { className: "file-workbench" },
|
|
navigationPane(e, workspace, effectiveDirectoryKey, directoryFiles, selectedFile?.key, workspaceRefreshState, Boolean(input.workspaceActions?.refreshWorkspace), selectDirectory, selectFile, refreshWorkspaceCatalog),
|
|
selectedFile
|
|
? fileDetail(e, {
|
|
file: selectedFile,
|
|
fields: selectedFields,
|
|
mode: selectedFile.kind === "log" ? "source" : configMode,
|
|
setMode: setConfigMode,
|
|
fieldDraft,
|
|
setFieldDraft,
|
|
pairDraft,
|
|
setPairDraft,
|
|
rawDraft,
|
|
setRawDraft,
|
|
rawEncoding,
|
|
setRawEncoding,
|
|
snapshot: snapshot?.key === selectedFile.key ? snapshot : null,
|
|
requestState: requestState?.fileKey === selectedFile.key ? requestState : null,
|
|
writeState: writeState?.fileKey === selectedFile.key ? writeState : null,
|
|
preview: preview?.fileKey === selectedFile.key ? preview : null,
|
|
canFilesRead,
|
|
canFilesWrite,
|
|
canRequestFile: Boolean(input.workspaceActions?.requestFile),
|
|
canRefreshSnapshot: Boolean(input.workspaceActions?.getFileSnapshot),
|
|
canWriteFile: Boolean(input.workspaceActions?.writeFile),
|
|
onRequestFile: requestSelectedFile,
|
|
onRefreshSnapshot: refreshSelectedSnapshot,
|
|
onPreview: previewModeChange,
|
|
onWrite: writePreviewedContent
|
|
})
|
|
: e("div", { className: "file-workbench-detail" }, e("p", { className: "page-status" }, "当前插件没有可展示的声明文件。"))
|
|
)
|
|
);
|
|
}
|
|
|
|
function navigationPane(e: ReactLike["createElement"], workspace: NormalizedWorkspace, directoryKey: string, directoryFiles: readonly SCUMLogicalFile[], selectedFileKey: string | undefined, refreshState: WorkspaceRefreshState, canRefreshWorkspace: boolean, onDirectoryChange: (directoryKey: string) => void, onFileSelect: (file: SCUMLogicalFile) => void, onRefreshWorkspace: () => void) {
|
|
const activeDirectory = workspace.directories.find((directory) => directory.key === directoryKey);
|
|
const selectedFile = directoryFiles.find((file) => file.key === selectedFileKey) ?? directoryFiles[0];
|
|
return e("aside", { className: "file-workbench-nav", "aria-label": "SCUM 文件两级菜单" },
|
|
e("div", { className: "console-row-actions file-workbench-nav-actions" },
|
|
e("button", { type: "button", className: "icon-command", disabled: !canRefreshWorkspace, onClick: onRefreshWorkspace }, "刷新文件列表")
|
|
),
|
|
refreshState ? e("p", { className: "page-status", "data-state": refreshState.status }, refreshState.message) : null,
|
|
e("label", { className: "file-workbench-picker" },
|
|
e("span", null, "目录"),
|
|
e("select", { value: directoryKey, onChange: (event: { target: { value: string } }) => onDirectoryChange(event.target.value), "aria-label": "选择目录" },
|
|
workspace.directories.length ? workspace.directories.map((directory) => e("option", { key: directory.key, value: directory.key }, `${directory.label} · ${directoryScopeLabel(directory.scope)}`)) : e("option", { value: "" }, "没有已声明目录")
|
|
)
|
|
),
|
|
e("div", { className: "file-workbench-directory-heading" },
|
|
e("strong", null, activeDirectory?.label ?? "插件声明目录"),
|
|
e("span", null, activeDirectory ? `${activeDirectory.key} · ${directoryScopeLabel(activeDirectory.scope)}` : "等待平台声明"),
|
|
e("small", null, `${directoryFiles.length} 个声明文件`)
|
|
),
|
|
e("div", { className: "file-workbench-directory", role: "listbox", "aria-label": "声明文件列表" },
|
|
directoryFiles.length
|
|
? directoryFiles.map((file) => e("button", { key: file.key, type: "button", className: "file-workbench-file", role: "option", "aria-selected": file.key === selectedFile?.key, "aria-current": file.key === selectedFile?.key ? "page" : undefined, onClick: () => onFileSelect(file) },
|
|
e("strong", null, file.label),
|
|
e("span", null, file.kind === "config" ? file.editable === false ? "配置只读" : "配置可写" : `日志${file.streamKey ? ` · ${file.streamKey}` : ""}`)
|
|
))
|
|
: e("p", { className: "page-status" }, "当前目录没有平台声明文件。")
|
|
)
|
|
);
|
|
}
|
|
|
|
function fileDetail(e: ReactLike["createElement"], props: {
|
|
file: SCUMLogicalFile; fields: readonly SCUMConfigField[]; mode: ConfigMode; setMode: StateSetter<ConfigMode>; fieldDraft: Record<string, string>; setFieldDraft: StateSetter<Record<string, string>>; pairDraft: Record<string, string>; setPairDraft: StateSetter<Record<string, string>>;
|
|
rawDraft: Record<string, string>; setRawDraft: StateSetter<Record<string, string>>; rawEncoding: RawEncoding; setRawEncoding: StateSetter<RawEncoding>; snapshot: SCUMFileReadSnapshot | null;
|
|
requestState: FileRequestState; writeState: FileRequestState; preview: PreviewState; canFilesRead: boolean; canFilesWrite: boolean; canRequestFile: boolean; canRefreshSnapshot: boolean; canWriteFile: boolean;
|
|
onRequestFile: () => void; onRefreshSnapshot: () => void; onPreview: (mode: ConfigMode, content: string, current: string) => void; onWrite: () => void;
|
|
}) {
|
|
const canShowFields = props.file.kind === "config" && props.fields.length > 0;
|
|
const currentContent = props.snapshot?.state === "ready" ? decodeRawContent(props.snapshot.content ?? "", props.rawEncoding) : "";
|
|
const snapshotValues = props.snapshot?.state === "ready" ? parseIniAssignments(currentContent) : {};
|
|
return e("article", { className: "file-workbench-detail", "aria-label": `文件 ${props.file.label}` },
|
|
e("div", { className: "panel-header" },
|
|
e("div", null, e("h2", null, props.file.label), e("p", { className: "provider-id" }, `${props.file.directoryKey} · ${props.file.kind === "config" ? "配置文件" : "日志文件"}${props.file.streamKey ? ` · ${props.file.streamKey}` : ""}`)),
|
|
e("div", { className: "console-row-actions" },
|
|
e("button", { type: "button", className: "icon-command", disabled: !props.canFilesRead || !props.canRequestFile, onClick: props.onRequestFile }, "读取文件"),
|
|
e("button", { type: "button", className: "icon-command", disabled: !props.canRefreshSnapshot, onClick: props.onRefreshSnapshot }, "刷新结果")
|
|
)
|
|
),
|
|
props.requestState ? e("p", { className: "page-status", "data-state": props.requestState.status }, props.requestState.message) : null,
|
|
props.writeState ? e("p", { className: "page-status", "data-state": props.writeState.status }, props.writeState.message) : null,
|
|
props.file.kind === "log" || props.snapshot?.state === "ready" ? encodingSwitcher(e, props.rawEncoding, props.setRawEncoding) : null,
|
|
canShowFields
|
|
? e("div", { className: "file-workbench-mode", role: "tablist", "aria-label": "表单配置与原文模式" },
|
|
e("span", null, "编辑视图"),
|
|
e("button", { type: "button", role: "tab", "aria-selected": props.mode === "fields", className: props.mode === "fields" ? "file-workbench-mode-active" : undefined, onClick: () => props.setMode("fields") }, "配置表单"),
|
|
e("button", { type: "button", role: "tab", "aria-selected": props.mode === "pairs", className: props.mode === "pairs" ? "file-workbench-mode-active" : undefined, onClick: () => props.setMode("pairs") }, "键值视图"),
|
|
e("button", { type: "button", role: "tab", "aria-selected": props.mode === "source", className: props.mode === "source" ? "file-workbench-mode-active" : undefined, onClick: () => props.setMode("source") }, "原文模式")
|
|
)
|
|
: null,
|
|
canShowFields && props.mode === "fields"
|
|
? modeledConfigurationFields(e, props.file, props.fields, props.fieldDraft, props.setFieldDraft, snapshotValues, currentContent, props.snapshot?.state === "ready", props.canFilesWrite, props.canWriteFile, props.preview, props.onPreview, props.onWrite)
|
|
: canShowFields && props.mode === "pairs"
|
|
? modeledKeyValueEditor(e, props.file, props.fields, props.pairDraft, props.setPairDraft, snapshotValues, currentContent, props.snapshot?.state === "ready", props.canFilesWrite, props.canWriteFile, props.preview, props.onPreview, props.onWrite)
|
|
: rawFileView(e, props.file, currentContent, props.rawDraft, props.setRawDraft, props.snapshot, props.canFilesWrite, props.canWriteFile, props.preview, props.onPreview, props.onWrite)
|
|
);
|
|
}
|
|
|
|
function encodingSwitcher(e: ReactLike["createElement"], encoding: RawEncoding, setEncoding: StateSetter<RawEncoding>) {
|
|
return e("div", { className: "file-workbench-mode file-workbench-encoding", role: "tablist", "aria-label": "原文编码" },
|
|
e("span", null, "文本编码"),
|
|
e("button", { type: "button", role: "tab", "aria-selected": encoding === "utf-8", className: encoding === "utf-8" ? "file-workbench-mode-active" : undefined, onClick: () => setEncoding("utf-8") }, "UTF-8"),
|
|
e("button", { type: "button", role: "tab", "aria-selected": encoding === "utf-16le", className: encoding === "utf-16le" ? "file-workbench-mode-active" : undefined, onClick: () => setEncoding("utf-16le") }, "UTF-16 LE")
|
|
);
|
|
}
|
|
|
|
function modeledConfigurationFields(e: ReactLike["createElement"], file: SCUMLogicalFile, fields: readonly SCUMConfigField[], draft: Record<string, string>, setDraft: StateSetter<Record<string, string>>, values: Record<string, string>, currentContent: string, hasReadSnapshot: boolean, canFilesWrite: boolean, canWriteFile: boolean, preview: PreviewState, onPreview: (mode: ConfigMode, content: string, current: string) => void, onWrite: () => void) {
|
|
const editable = hasReadSnapshot && canFilesWrite && file.editable !== false;
|
|
const fieldKeys = new Set(fields.map((field) => field.key));
|
|
const selectedDraft = Object.fromEntries(Object.entries(draft).filter(([key]) => fieldKeys.has(key)));
|
|
const hasChanges = Object.keys(selectedDraft).length > 0;
|
|
const unknown = unknownIniAssignments(currentContent, fields);
|
|
return e("div", { className: "file-workbench-fields" },
|
|
fields.map((field) => {
|
|
const value = draft[field.key] ?? values[field.configKey] ?? field.defaultValue;
|
|
return e("label", { className: "file-workbench-field", key: field.key },
|
|
e("span", null, e("strong", null, field.label), e("small", null, `${field.configKey} · ${field.description}`)),
|
|
fieldControl(e, field, value, editable, (next) => setDraft((current) => ({ ...current, [field.key]: next }))),
|
|
e("small", null, `${controlLabel(field)} · ${field.restartImpact === "restart-required" ? "修改后需要受控重启" : "可在安全窗口内生效"}`)
|
|
);
|
|
}),
|
|
unknown.length ? e("section", { className: "file-workbench-unknown", "aria-label": "未建模配置项" }, e("h3", null, "未建模配置项"), unknown.map((item) => e("div", { className: "console-row", key: `${item.key}:${item.index}` }, e("span", null, item.key), e("strong", null, item.value || "空值")))) : null,
|
|
e("div", { className: "console-row-actions file-workbench-actions" },
|
|
e("button", { type: "button", className: "icon-command", disabled: !editable || !hasChanges, onClick: () => onPreview("fields", composeIniContent(currentContent, fields, selectedDraft), currentContent) }, "预览改动"),
|
|
e("button", { type: "button", className: "primary-command", disabled: !editable || !canWriteFile || !preview || preview.mode !== "fields", onClick: onWrite }, "提交写入")
|
|
),
|
|
preview && preview.mode === "fields" ? diffPreview(e, preview) : null,
|
|
e("p", { className: "page-status" }, hasReadSnapshot ? editable ? "配置表单会保留原文中的未知行；提交前先预览差异。" : "当前账号仅有读取权限，配置项为只读。" : "先读取文件后才显示服务器当前值；未读取时不会把默认值伪装成原文。")
|
|
);
|
|
}
|
|
|
|
function modeledKeyValueEditor(e: ReactLike["createElement"], file: SCUMLogicalFile, fields: readonly SCUMConfigField[], draft: Record<string, string>, setDraft: StateSetter<Record<string, string>>, values: Record<string, string>, currentContent: string, hasReadSnapshot: boolean, canFilesWrite: boolean, canWriteFile: boolean, preview: PreviewState, onPreview: (mode: ConfigMode, content: string, current: string) => void, onWrite: () => void) {
|
|
const editable = hasReadSnapshot && canFilesWrite && file.editable !== false;
|
|
const currentPairs = modeledPairText(fields, values);
|
|
const rawValue = draft[file.key] ?? currentPairs;
|
|
const parsed = parseModeledPairDraft(rawValue, fields);
|
|
const proposedContent = composeIniContent(currentContent, fields, parsed.changes);
|
|
const hasChanges = proposedContent !== currentContent && Object.keys(parsed.changes).length > 0;
|
|
return e("div", { className: "file-workbench-raw file-workbench-pairs" },
|
|
e("textarea", { className: "file-workbench-raw-editor file-workbench-keyvalue-editor", value: rawValue, readOnly: !editable, spellCheck: false, "aria-label": `${file.label} 键值视图编辑`, onChange: (event: { target: { value: string } }) => setDraft((current) => ({ ...current, [file.key]: event.target.value })) }),
|
|
parsed.unknown.length ? e("section", { className: "file-workbench-unknown", "aria-label": "不可写键值" }, e("h3", null, "不可写键值"), parsed.unknown.map((key) => e("div", { className: "console-row", key }, e("span", null, key), e("strong", null, "未在声明字段中")))) : null,
|
|
e("div", { className: "console-row-actions file-workbench-actions" },
|
|
e("button", { type: "button", className: "icon-command", disabled: !editable || parsed.unknown.length > 0 || !hasChanges, onClick: () => onPreview("pairs", proposedContent, currentContent) }, "预览改动"),
|
|
e("button", { type: "button", className: "primary-command", disabled: !editable || !canWriteFile || !preview || preview.mode !== "pairs", onClick: onWrite }, "提交写入")
|
|
),
|
|
preview && preview.mode === "pairs" ? diffPreview(e, preview) : null,
|
|
e("p", { className: "page-status" }, hasReadSnapshot ? "键值视图适合批量调整已声明字段；未知键只展示，不会被作为安全写入目标。" : "先读取文件后才启用键值编辑。")
|
|
);
|
|
}
|
|
|
|
function fieldControl(e: ReactLike["createElement"], field: SCUMConfigField, value: string, editable: boolean, onChange: (next: string) => void) {
|
|
if (field.control === "boolean") {
|
|
return e("select", { value: normalizeBoolean(value) ? "true" : "false", disabled: !editable, "aria-label": field.label, onChange: (event: { target: { value: string } }) => onChange(event.target.value) },
|
|
e("option", { value: "true" }, "是"),
|
|
e("option", { value: "false" }, "否")
|
|
);
|
|
}
|
|
if (field.control === "number" || field.control === "port") {
|
|
return e("div", { className: "file-workbench-number-control" },
|
|
e("input", { type: "range", value, min: field.minimum, max: field.maximum, disabled: !editable, "aria-label": `${field.label}滑动输入`, onChange: (event: { target: { value: string } }) => onChange(event.target.value) }),
|
|
e("input", { type: "number", value, min: field.minimum, max: field.maximum, readOnly: !editable, "aria-label": field.label, onChange: (event: { target: { value: string } }) => onChange(event.target.value) })
|
|
);
|
|
}
|
|
return e("input", { type: "text", value, readOnly: !editable, "aria-label": field.label, onChange: (event: { target: { value: string } }) => onChange(event.target.value) });
|
|
}
|
|
|
|
function rawFileView(e: ReactLike["createElement"], file: SCUMLogicalFile, currentContent: string, rawDraft: Record<string, string>, setRawDraft: StateSetter<Record<string, string>>, snapshot: SCUMFileReadSnapshot | null, canFilesWrite: boolean, canWriteFile: boolean, preview: PreviewState, onPreview: (mode: ConfigMode, content: string, current: string) => void, onWrite: () => void) {
|
|
if (snapshot?.state !== "ready") {
|
|
const message = snapshot?.reason ?? (file.kind === "config" ? "尚未读取此配置文件的受控原文。" : "尚未读取此日志文件的受控内容。");
|
|
return e("div", { className: "file-workbench-raw" }, e("p", { className: "page-status" }, message), snapshot?.jobId ? e("small", null, `读取任务 ${snapshot.jobId}`) : null);
|
|
}
|
|
const rawValue = rawDraft[file.key] ?? currentContent;
|
|
const editable = file.kind === "config" && canFilesWrite && file.editable !== false;
|
|
if (file.kind === "log") {
|
|
return e("div", { className: "file-workbench-raw" }, e("pre", { className: "runtime-task-log" }, rawValue), e("p", { className: "page-status" }, `日志原文只读 · ${contentLineCount(rawValue)} 行 · ${snapshot.sizeBytes ?? 0} B`));
|
|
}
|
|
return e("div", { className: "file-workbench-raw" },
|
|
e("textarea", { className: "file-workbench-raw-editor", value: rawValue, readOnly: !editable, spellCheck: false, "aria-label": `${file.label} 原文模式编辑`, onChange: (event: { target: { value: string } }) => setRawDraft((current) => ({ ...current, [file.key]: event.target.value })) }),
|
|
e("div", { className: "console-row-actions file-workbench-actions" },
|
|
e("button", { type: "button", className: "icon-command", disabled: !editable || rawValue === currentContent, onClick: () => onPreview("source", rawValue, currentContent) }, "预览改动"),
|
|
e("button", { type: "button", className: "primary-command", disabled: !editable || !canWriteFile || !preview || preview.mode !== "source", onClick: onWrite }, "提交写入")
|
|
),
|
|
preview && preview.mode === "source" ? diffPreview(e, preview) : null,
|
|
e("p", { className: "page-status" }, editable ? "原文模式会整文件写入声明 file key；提交前请先预览差异。" : "原文配置当前只读。")
|
|
);
|
|
}
|
|
|
|
function diffPreview(e: ReactLike["createElement"], preview: Exclude<PreviewState, null>) {
|
|
return e("section", { className: "file-workbench-diff", "aria-label": "文件改动预览" },
|
|
e("div", { className: "console-row" }, e("span", null, "差异预览"), e("strong", null, preview.summary)),
|
|
e("pre", { className: "runtime-task-log" }, preview.lines.map((line) => `${line.kind === "added" ? "+" : line.kind === "removed" ? "-" : " "} ${line.text}`).join("\n"))
|
|
);
|
|
}
|
|
|
|
function usePluginState<T>(react: ReactLike, initialState: T): [T, StateSetter<T>] {
|
|
return react.useState ? react.useState(initialState) : [initialState, () => undefined];
|
|
}
|
|
|
|
function normalizeWorkspace(workspace?: SCUMFeatureWorkspace): NormalizedWorkspace {
|
|
const directories = workspace?.directories ?? [];
|
|
const directoryKeys = new Set(directories.map((directory) => directory.key));
|
|
const files = (workspace?.files ?? []).filter((file) => directoryKeys.has(file.directoryKey));
|
|
const fileKeys = new Set(files.map((file) => file.key));
|
|
const configFields = (workspace?.configFields ?? []).filter((field) => fileKeys.has(field.fileKey));
|
|
return { defaultDirectoryKey: workspace?.defaultDirectoryKey && directories.some((directory) => directory.key === workspace.defaultDirectoryKey) ? workspace.defaultDirectoryKey : directories[0]?.key ?? "", directories, files, configFields };
|
|
}
|
|
|
|
function initialFileKey(workspace: NormalizedWorkspace, directoryKey: string): string {
|
|
return workspace.files.find((file) => file.directoryKey === directoryKey && file.kind === "config")?.key ?? workspace.files.find((file) => file.directoryKey === directoryKey)?.key ?? workspace.files[0]?.key ?? "";
|
|
}
|
|
|
|
function directoryScopeLabel(scope: SCUMLogicalDirectory["scope"]): string {
|
|
return scope === "logs" ? "日志声明" : "配置声明";
|
|
}
|
|
|
|
function modeledPairText(fields: readonly SCUMConfigField[], values: Record<string, string>): string {
|
|
return fields.map((field) => `${field.configKey}=${values[field.configKey] ?? field.defaultValue}`).join("\n");
|
|
}
|
|
|
|
function parseModeledPairDraft(content: string, fields: readonly SCUMConfigField[]): { changes: Record<string, string>; unknown: string[] } {
|
|
const byConfigKey = new Map(fields.map((field) => [field.configKey, field]));
|
|
const changes: Record<string, string> = {};
|
|
const unknown: string[] = [];
|
|
for (const line of content.split("\n")) {
|
|
const parsed = parseIniAssignment(line);
|
|
if (!parsed) continue;
|
|
const field = byConfigKey.get(parsed.key);
|
|
if (!field) {
|
|
unknown.push(parsed.key);
|
|
continue;
|
|
}
|
|
changes[field.key] = parsed.value;
|
|
}
|
|
return { changes, unknown: [...new Set(unknown)] };
|
|
}
|
|
|
|
function controlLabel(field: SCUMConfigField): string {
|
|
const range = field.minimum !== undefined || field.maximum !== undefined ? `范围 ${field.minimum ?? "不限"}-${field.maximum ?? "不限"}` : "";
|
|
const label = field.control === "boolean" ? "是/否选择" : field.control === "number" || field.control === "port" ? "滑动输入" : "文本填空";
|
|
return [label, range].filter(Boolean).join(" · ");
|
|
}
|
|
|
|
function normalizeBoolean(value: string): boolean {
|
|
return /^(true|1|yes|on)$/i.test(String(value).trim());
|
|
}
|
|
|
|
function parseIniAssignments(content: string): Record<string, string> {
|
|
const values: Record<string, string> = {};
|
|
for (const line of content.split("\n")) {
|
|
const parsed = parseIniAssignment(line);
|
|
if (parsed) values[parsed.key] = parsed.value;
|
|
}
|
|
return values;
|
|
}
|
|
|
|
function unknownIniAssignments(content: string, fields: readonly SCUMConfigField[]): Array<{ key: string; value: string; index: number }> {
|
|
const known = new Set(fields.map((field) => field.configKey));
|
|
const unknown: Array<{ key: string; value: string; index: number }> = [];
|
|
content.split("\n").forEach((line, index) => {
|
|
const parsed = parseIniAssignment(line);
|
|
if (parsed && !known.has(parsed.key)) unknown.push({ ...parsed, index });
|
|
});
|
|
return unknown;
|
|
}
|
|
|
|
function parseIniAssignment(line: string): { key: string; value: string } | null {
|
|
const trimmed = line.trim();
|
|
if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith(";") || trimmed.startsWith("[")) return null;
|
|
const separator = line.indexOf("=");
|
|
if (separator < 1) return null;
|
|
return { key: line.slice(0, separator).trim(), value: line.slice(separator + 1).trim() };
|
|
}
|
|
|
|
function composeIniContent(content: string, fields: readonly SCUMConfigField[], draft: Record<string, string>): string {
|
|
const byField = new Map(fields.map((field) => [field.key, field]));
|
|
const changes = new Map<string, string>();
|
|
for (const [fieldKey, value] of Object.entries(draft)) {
|
|
const field = byField.get(fieldKey);
|
|
if (field) changes.set(field.configKey, value);
|
|
}
|
|
if (changes.size === 0) return content;
|
|
const applied = new Set<string>();
|
|
const lines = content.split("\n").map((line) => {
|
|
const parsed = parseIniAssignment(line);
|
|
if (!parsed || !changes.has(parsed.key)) return line;
|
|
applied.add(parsed.key);
|
|
return `${line.slice(0, line.indexOf("=") + 1)}${changes.get(parsed.key) ?? ""}`;
|
|
});
|
|
for (const [key, value] of changes) {
|
|
if (!applied.has(key)) lines.push(`${key}=${value}`);
|
|
}
|
|
return content.endsWith("\n") ? lines.join("\n") : lines.join("\n").replace(/\n$/, "");
|
|
}
|
|
|
|
function decodeRawContent(content: string, encoding: RawEncoding): string {
|
|
if (encoding === "utf-8") return content;
|
|
const bytes = Uint8Array.from(Array.from(content), (char) => char.charCodeAt(0) & 0xff);
|
|
if (typeof TextDecoder !== "undefined") return new TextDecoder("utf-16le").decode(bytes);
|
|
let decoded = "";
|
|
for (let index = 0; index < bytes.length; index += 2) decoded += String.fromCharCode(bytes[index] | ((bytes[index + 1] ?? 0) << 8));
|
|
return decoded;
|
|
}
|
|
|
|
function buildSimpleDiff(current: string, proposed: string): { summary: string; lines: readonly DiffLine[] } {
|
|
const currentLines = current.split("\n");
|
|
const proposedLines = proposed.split("\n");
|
|
const max = Math.max(currentLines.length, proposedLines.length);
|
|
const lines: DiffLine[] = [];
|
|
let added = 0;
|
|
let removed = 0;
|
|
for (let index = 0; index < max; index += 1) {
|
|
const before = currentLines[index];
|
|
const after = proposedLines[index];
|
|
if (before === after) {
|
|
if (before !== undefined) lines.push({ kind: "same", text: before });
|
|
continue;
|
|
}
|
|
if (before !== undefined) { removed += 1; lines.push({ kind: "removed", text: before }); }
|
|
if (after !== undefined) { added += 1; lines.push({ kind: "added", text: after }); }
|
|
}
|
|
return { summary: `+${added} / -${removed} 行变更`, lines };
|
|
}
|
|
|
|
function contentLineCount(content: string): number {
|
|
return content ? content.split("\n").length : 0;
|
|
}
|