SkyJourney
2c5c1bd317
新增通用 CSS 到 OOXML 翻译修复，统一字体、字距、精确行距、段落、列表、表格、引用、代码块与行内代码连续性，不引入按主题 ID 分支。 新增 MdTP Mono 并统一 Serif、Sans、Mono 三字体包的 Chromium 与 DOCX 使用链；字体声明、嵌入部件和 Word/WPS 实际采用均进入硬门禁。 重建封面整页及正文语义块视觉差分，14 套主题、纵横两个方向、五组页边距共 140 个真实场景全部通过，阻断失败和诊断失败均为零。 源码服务、Docker Web API 与实际安装 Desktop 的 red-briefing 导出均包含 5 个字体部件；Word/WPS 原生渲染和逐页复核通过。修复 Docker 构建上下文与运行层复用软链接，并完善 v0.6.1 版本、发行说明和发布归集。 验证：npm test（116 个文件、616 项测试）、npm run typecheck、npm run build、git diff --check 全部通过。Desktop 安装器与 ZIP、Docker v0.6.1 镜像已生成；Windows 产物仍为未签名内部发行。
274 lines
8.5 KiB
JavaScript
274 lines
8.5 KiB
JavaScript
import fs from "node:fs";
|
||
import path from "node:path";
|
||
|
||
export const DOCX_LAYOUT_MATRIX_ORIENTATIONS = Object.freeze([
|
||
"portrait",
|
||
"landscape"
|
||
]);
|
||
|
||
export const DOCX_LAYOUT_MATRIX_MARGIN_SCENARIOS = Object.freeze([
|
||
Object.freeze({
|
||
id: "theme-default",
|
||
label: "主题默认边距",
|
||
marginMode: "theme"
|
||
}),
|
||
Object.freeze({
|
||
id: "standard",
|
||
label: "标准边距",
|
||
marginMode: "custom",
|
||
margins: Object.freeze({
|
||
top: "25.4mm",
|
||
right: "25.4mm",
|
||
bottom: "25.4mm",
|
||
left: "25.4mm"
|
||
})
|
||
}),
|
||
Object.freeze({
|
||
id: "compact",
|
||
label: "紧凑边距",
|
||
marginMode: "custom",
|
||
margins: Object.freeze({
|
||
top: "12.7mm",
|
||
right: "12.7mm",
|
||
bottom: "12.7mm",
|
||
left: "12.7mm"
|
||
})
|
||
}),
|
||
Object.freeze({
|
||
id: "wide",
|
||
label: "宽松边距",
|
||
marginMode: "custom",
|
||
margins: Object.freeze({
|
||
top: "31.8mm",
|
||
right: "31.8mm",
|
||
bottom: "31.8mm",
|
||
left: "31.8mm"
|
||
})
|
||
}),
|
||
Object.freeze({
|
||
id: "binding",
|
||
label: "非对称装订边距",
|
||
marginMode: "custom",
|
||
margins: Object.freeze({
|
||
top: "25.4mm",
|
||
right: "19.1mm",
|
||
bottom: "25.4mm",
|
||
left: "31.8mm"
|
||
})
|
||
})
|
||
]);
|
||
|
||
function assert(condition, message) {
|
||
if (!condition) {
|
||
throw new Error(message);
|
||
}
|
||
}
|
||
|
||
function hasIndependentCover(manifest) {
|
||
const profiles = Array.isArray(manifest.compatibleProfiles)
|
||
? manifest.compatibleProfiles
|
||
: [];
|
||
return profiles.includes("project-report") || profiles.includes("tender");
|
||
}
|
||
|
||
export function readBundledThemeMatrixDefinitions(themesDirectory) {
|
||
assert(
|
||
typeof themesDirectory === "string" && themesDirectory.length > 0,
|
||
"主题目录不能为空"
|
||
);
|
||
return fs.readdirSync(themesDirectory, { withFileTypes: true })
|
||
.filter((entry) => entry.isDirectory())
|
||
.flatMap((entry) => {
|
||
const manifestPath = path.join(themesDirectory, entry.name, "theme.json");
|
||
if (!fs.existsSync(manifestPath)) {
|
||
return [];
|
||
}
|
||
const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
|
||
if (manifest.bundled !== true) {
|
||
return [];
|
||
}
|
||
assert(
|
||
typeof manifest.id === "string" && manifest.id.length > 0,
|
||
`内置主题清单缺少 id：${manifestPath}`
|
||
);
|
||
return [{
|
||
id: manifest.id,
|
||
name:
|
||
typeof manifest.name === "string" && manifest.name.length > 0
|
||
? manifest.name
|
||
: manifest.id,
|
||
coverPageCount: hasIndependentCover(manifest) ? 1 : 0,
|
||
compatibleProfiles: Array.isArray(manifest.compatibleProfiles)
|
||
? [...manifest.compatibleProfiles]
|
||
: [],
|
||
docxFontFaces: Array.isArray(manifest.docxFonts?.faces)
|
||
? manifest.docxFonts.faces.map((face) => ({
|
||
family: face.family,
|
||
aliases: Array.isArray(face.aliases) ? [...face.aliases] : [],
|
||
weight: face.weight ?? 400,
|
||
style: face.style ?? "normal"
|
||
}))
|
||
: [],
|
||
themeDefaultMargins: manifest.pageDefaults?.margins
|
||
? structuredClone(manifest.pageDefaults.margins)
|
||
: undefined
|
||
}];
|
||
})
|
||
.sort((left, right) => left.id.localeCompare(right.id, "en"));
|
||
}
|
||
|
||
function normalizeFontName(value) {
|
||
return value
|
||
.replace(/^[A-Z]{6}\+/u, "")
|
||
.replace(/(?:[-, ](?:regular|bold|italic|bolditalic|roman|medium|light|black))+$/iu, "")
|
||
.replace(/[\s_-]+/gu, "")
|
||
.toLocaleLowerCase("en-US");
|
||
}
|
||
|
||
function isOfficeEmbeddedAlias(value, engine) {
|
||
return engine === "word"
|
||
? /^___WRD_EMBED_SUB_/iu.test(value)
|
||
: engine === "wps"
|
||
? /^WPSEMBED\d+$/iu.test(value)
|
||
: false;
|
||
}
|
||
|
||
export function getDocxFontGateFailures({
|
||
theme,
|
||
inspection,
|
||
renderedFonts,
|
||
engine
|
||
}) {
|
||
assert(theme && typeof theme.id === "string", "字体门禁缺少主题定义");
|
||
assert(inspection && typeof inspection === "object", "字体门禁缺少 DOCX 检查结果");
|
||
assert(Array.isArray(renderedFonts), "字体门禁缺少实际渲染字体");
|
||
assert(engine === "word" || engine === "wps", "字体门禁引擎必须为 word 或 wps");
|
||
const failures = [];
|
||
const declaredFaces = Array.isArray(theme.docxFontFaces)
|
||
? theme.docxFontFaces
|
||
: [];
|
||
const embeddedNames = Array.isArray(inspection.embeddedFontNames)
|
||
? inspection.embeddedFontNames
|
||
: [];
|
||
const embeddedPartCount = Number(inspection.embeddedFontPartCount ?? 0);
|
||
if (declaredFaces.length === 0) {
|
||
failures.push(`主题 ${theme.id} 未声明任何 DOCX 字体`);
|
||
}
|
||
if (embeddedPartCount === 0) {
|
||
failures.push(`主题 ${theme.id} 的 DOCX 没有嵌入字体部件`);
|
||
}
|
||
if (declaredFaces.length > 0 && embeddedPartCount < declaredFaces.length) {
|
||
failures.push(
|
||
`主题 ${theme.id} 声明 ${declaredFaces.length} 个字体面，但 DOCX 仅嵌入 ${embeddedPartCount} 个部件`
|
||
);
|
||
}
|
||
if (embeddedPartCount > 0) {
|
||
const expected = new Set(embeddedNames.map(normalizeFontName));
|
||
const actuallyUsed = renderedFonts.some((font) => {
|
||
const name = typeof font === "string" ? font : font?.name;
|
||
return typeof name === "string" && (
|
||
isOfficeEmbeddedAlias(name, engine) || expected.has(normalizeFontName(name))
|
||
);
|
||
});
|
||
if (!actuallyUsed) {
|
||
failures.push(
|
||
`${engine === "word" ? "Microsoft Word" : "WPS Writer"} 输出未实际使用 DOCX 嵌入字体`
|
||
);
|
||
}
|
||
}
|
||
return failures;
|
||
}
|
||
|
||
function createPaperConfig(orientation, marginScenario) {
|
||
return {
|
||
format: "A4",
|
||
orientation,
|
||
marginMode: marginScenario.marginMode,
|
||
...(marginScenario.marginMode === "custom"
|
||
? { margins: structuredClone(marginScenario.margins) }
|
||
: {})
|
||
};
|
||
}
|
||
|
||
export function createDocxLayoutVisualMatrixCases(themeDefinitions) {
|
||
assert(Array.isArray(themeDefinitions), "主题定义必须是数组");
|
||
const ids = new Set();
|
||
const cases = [];
|
||
for (const theme of themeDefinitions) {
|
||
assert(
|
||
theme && typeof theme.id === "string" && theme.id.length > 0,
|
||
"矩阵主题必须包含非空 id"
|
||
);
|
||
assert(!ids.has(theme.id), `矩阵主题 ID 重复：${theme.id}`);
|
||
ids.add(theme.id);
|
||
for (const orientation of DOCX_LAYOUT_MATRIX_ORIENTATIONS) {
|
||
for (const marginScenario of DOCX_LAYOUT_MATRIX_MARGIN_SCENARIOS) {
|
||
const paper = createPaperConfig(orientation, marginScenario);
|
||
cases.push({
|
||
id: `${theme.id}--${orientation}--${marginScenario.id}`,
|
||
themeId: theme.id,
|
||
themeName: theme.name,
|
||
orientation,
|
||
marginScenarioId: marginScenario.id,
|
||
marginScenarioLabel: marginScenario.label,
|
||
coverPageCount: theme.coverPageCount,
|
||
themeDefaultMargins: theme.themeDefaultMargins
|
||
? structuredClone(theme.themeDefaultMargins)
|
||
: undefined,
|
||
paper: { format: "A4", orientation },
|
||
config: { paper }
|
||
});
|
||
}
|
||
}
|
||
}
|
||
return cases;
|
||
}
|
||
|
||
export function summarizeDocxLayoutVisualMatrix(themeDefinitions, cases) {
|
||
const themeIds = themeDefinitions.map((theme) => theme.id);
|
||
const caseIds = cases.map((entry) => entry.id);
|
||
const expectedCaseCount =
|
||
themeIds.length *
|
||
DOCX_LAYOUT_MATRIX_ORIENTATIONS.length *
|
||
DOCX_LAYOUT_MATRIX_MARGIN_SCENARIOS.length;
|
||
assert(
|
||
new Set(caseIds).size === caseIds.length,
|
||
"DOCX 布局视觉矩阵存在重复场景 ID"
|
||
);
|
||
assert(
|
||
cases.length === expectedCaseCount,
|
||
`DOCX 布局视觉矩阵场景数错误：${cases.length}，期望 ${expectedCaseCount}`
|
||
);
|
||
for (const themeId of themeIds) {
|
||
const themeCaseCount = cases.filter(
|
||
(entry) => entry.themeId === themeId
|
||
).length;
|
||
assert(
|
||
themeCaseCount ===
|
||
DOCX_LAYOUT_MATRIX_ORIENTATIONS.length *
|
||
DOCX_LAYOUT_MATRIX_MARGIN_SCENARIOS.length,
|
||
`主题 ${themeId} 的矩阵场景数错误：${themeCaseCount}`
|
||
);
|
||
}
|
||
return {
|
||
themeCount: themeIds.length,
|
||
themeIds,
|
||
orientationCount: DOCX_LAYOUT_MATRIX_ORIENTATIONS.length,
|
||
orientations: [...DOCX_LAYOUT_MATRIX_ORIENTATIONS],
|
||
marginScenarioCount: DOCX_LAYOUT_MATRIX_MARGIN_SCENARIOS.length,
|
||
marginScenarios: DOCX_LAYOUT_MATRIX_MARGIN_SCENARIOS.map((scenario) => ({
|
||
id: scenario.id,
|
||
label: scenario.label,
|
||
marginMode: scenario.marginMode,
|
||
...(scenario.margins
|
||
? { margins: structuredClone(scenario.margins) }
|
||
: {})
|
||
})),
|
||
expectedCaseCount,
|
||
coverThemeCount: themeDefinitions.filter(
|
||
(theme) => theme.coverPageCount === 1
|
||
).length,
|
||
coverCaseCount: cases.filter((entry) => entry.coverPageCount === 1).length
|
||
};
|
||
}
|