wps-multitool-mcp 1.0.3 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/bridge/cancellable.d.ts.map +1 -1
- package/dist/bridge/cancellable.js +2 -0
- package/dist/bridge/cancellable.js.map +1 -1
- package/dist/bridge/index.js +36 -1
- package/dist/bridge/index.js.map +1 -1
- package/dist/client/action-routes.generated.d.ts +2 -2
- package/dist/client/action-routes.generated.d.ts.map +1 -1
- package/dist/client/action-routes.generated.js +8 -2
- package/dist/client/action-routes.generated.js.map +1 -1
- package/dist/server/auto-snapshot.d.ts.map +1 -1
- package/dist/server/auto-snapshot.js +12 -1
- package/dist/server/auto-snapshot.js.map +1 -1
- package/dist/server/collab-guard.d.ts +13 -0
- package/dist/server/collab-guard.d.ts.map +1 -0
- package/dist/server/collab-guard.js +112 -0
- package/dist/server/collab-guard.js.map +1 -0
- package/dist/server/intent-miss-log.d.ts +28 -0
- package/dist/server/intent-miss-log.d.ts.map +1 -0
- package/dist/server/intent-miss-log.js +143 -0
- package/dist/server/intent-miss-log.js.map +1 -0
- package/dist/server/mcp-server.d.ts +9 -0
- package/dist/server/mcp-server.d.ts.map +1 -1
- package/dist/server/mcp-server.js +168 -4
- package/dist/server/mcp-server.js.map +1 -1
- package/dist/server/progress-context.d.ts +6 -0
- package/dist/server/progress-context.d.ts.map +1 -0
- package/dist/server/progress-context.js +35 -0
- package/dist/server/progress-context.js.map +1 -0
- package/dist/server/task-engine.d.ts +112 -0
- package/dist/server/task-engine.d.ts.map +1 -0
- package/dist/server/task-engine.js +305 -0
- package/dist/server/task-engine.js.map +1 -0
- package/dist/server/tool-aliases.generated.d.ts +1 -1
- package/dist/server/tool-aliases.generated.d.ts.map +1 -1
- package/dist/server/tool-aliases.generated.js +15 -2
- package/dist/server/tool-aliases.generated.js.map +1 -1
- package/dist/server/tool-annotations.d.ts.map +1 -1
- package/dist/server/tool-annotations.generated.d.ts.map +1 -1
- package/dist/server/tool-annotations.generated.js +7 -8
- package/dist/server/tool-annotations.generated.js.map +1 -1
- package/dist/server/tool-annotations.js +18 -0
- package/dist/server/tool-annotations.js.map +1 -1
- package/dist/server/tool-metadata.d.ts.map +1 -1
- package/dist/server/tool-metadata.js +21 -9
- package/dist/server/tool-metadata.js.map +1 -1
- package/dist/server/tool-registry.d.ts.map +1 -1
- package/dist/server/tool-registry.js +26 -1
- package/dist/server/tool-registry.js.map +1 -1
- package/dist/server/tool-tiers.d.ts +2 -2
- package/dist/server/tool-tiers.js +2 -2
- package/dist/server/tool-verification.d.ts +5 -5
- package/dist/server/tool-verification.generated.d.ts +4 -4
- package/dist/server/tool-verification.generated.d.ts.map +1 -1
- package/dist/server/tool-verification.generated.js +78 -79
- package/dist/server/tool-verification.generated.js.map +1 -1
- package/dist/server/tool-verification.js +2 -2
- package/dist/tools/common/batch.d.ts.map +1 -1
- package/dist/tools/common/batch.js +5 -0
- package/dist/tools/common/batch.js.map +1 -1
- package/dist/tools/common/convert.js +34 -34
- package/dist/tools/common/general.d.ts.map +1 -1
- package/dist/tools/common/general.js +81 -79
- package/dist/tools/common/general.js.map +1 -1
- package/dist/tools/common/index.d.ts +1 -0
- package/dist/tools/common/index.d.ts.map +1 -1
- package/dist/tools/common/index.js +3 -0
- package/dist/tools/common/index.js.map +1 -1
- package/dist/tools/common/intent.d.ts +42 -0
- package/dist/tools/common/intent.d.ts.map +1 -1
- package/dist/tools/common/intent.js +307 -19
- package/dist/tools/common/intent.js.map +1 -1
- package/dist/tools/common/snapshot.d.ts.map +1 -1
- package/dist/tools/common/snapshot.js +27 -19
- package/dist/tools/common/snapshot.js.map +1 -1
- package/dist/tools/common/taskrunner.d.ts +25 -0
- package/dist/tools/common/taskrunner.d.ts.map +1 -0
- package/dist/tools/common/taskrunner.js +100 -0
- package/dist/tools/common/taskrunner.js.map +1 -0
- package/dist/tools/common/toolgroups.js +36 -36
- package/dist/tools/excel/chart.d.ts.map +1 -1
- package/dist/tools/excel/chart.js +109 -86
- package/dist/tools/excel/chart.js.map +1 -1
- package/dist/tools/excel/comment-protect.js +2 -2
- package/dist/tools/excel/comment-protect.js.map +1 -1
- package/dist/tools/excel/data.d.ts.map +1 -1
- package/dist/tools/excel/data.js +32 -21
- package/dist/tools/excel/data.js.map +1 -1
- package/dist/tools/excel/format.js +9 -9
- package/dist/tools/excel/formula.js +46 -46
- package/dist/tools/excel/pivot.js +34 -34
- package/dist/tools/excel/sheet.d.ts +4 -0
- package/dist/tools/excel/sheet.d.ts.map +1 -1
- package/dist/tools/excel/sheet.js +103 -1
- package/dist/tools/excel/sheet.js.map +1 -1
- package/dist/tools/ppt/animation.d.ts +2 -2
- package/dist/tools/ppt/animation.d.ts.map +1 -1
- package/dist/tools/ppt/animation.js +35 -97
- package/dist/tools/ppt/animation.js.map +1 -1
- package/dist/tools/ppt/beautify-advanced.d.ts +3 -16
- package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -1
- package/dist/tools/ppt/beautify-advanced.js +65 -355
- package/dist/tools/ppt/beautify-advanced.js.map +1 -1
- package/dist/tools/ppt/chart-flow.d.ts.map +1 -1
- package/dist/tools/ppt/chart-flow.js +113 -278
- package/dist/tools/ppt/chart-flow.js.map +1 -1
- package/dist/tools/ppt/data-viz.d.ts.map +1 -1
- package/dist/tools/ppt/data-viz.js +78 -276
- package/dist/tools/ppt/data-viz.js.map +1 -1
- package/dist/tools/ppt/deckkit.d.ts +209 -0
- package/dist/tools/ppt/deckkit.d.ts.map +1 -0
- package/dist/tools/ppt/deckkit.js +635 -0
- package/dist/tools/ppt/deckkit.js.map +1 -0
- package/dist/tools/ppt/helpers.d.ts +38 -0
- package/dist/tools/ppt/helpers.d.ts.map +1 -0
- package/dist/tools/ppt/helpers.js +60 -0
- package/dist/tools/ppt/helpers.js.map +1 -0
- package/dist/tools/ppt/image.d.ts +6 -4
- package/dist/tools/ppt/image.d.ts.map +1 -1
- package/dist/tools/ppt/image.js +148 -244
- package/dist/tools/ppt/image.js.map +1 -1
- package/dist/tools/ppt/index.d.ts +43 -29
- package/dist/tools/ppt/index.d.ts.map +1 -1
- package/dist/tools/ppt/index.js +106 -95
- package/dist/tools/ppt/index.js.map +1 -1
- package/dist/tools/ppt/misc.d.ts +1 -2
- package/dist/tools/ppt/misc.d.ts.map +1 -1
- package/dist/tools/ppt/misc.js +70 -385
- package/dist/tools/ppt/misc.js.map +1 -1
- package/dist/tools/ppt/page-effects.d.ts +28 -0
- package/dist/tools/ppt/page-effects.d.ts.map +1 -0
- package/dist/tools/ppt/page-effects.js +505 -0
- package/dist/tools/ppt/page-effects.js.map +1 -0
- package/dist/tools/ppt/{background.d.ts → page-info.d.ts} +11 -13
- package/dist/tools/ppt/page-info.d.ts.map +1 -0
- package/dist/tools/ppt/page-info.js +258 -0
- package/dist/tools/ppt/page-info.js.map +1 -0
- package/dist/tools/ppt/presentation.d.ts +3 -6
- package/dist/tools/ppt/presentation.d.ts.map +1 -1
- package/dist/tools/ppt/presentation.js +136 -437
- package/dist/tools/ppt/presentation.js.map +1 -1
- package/dist/tools/ppt/shape-basic.d.ts +22 -3
- package/dist/tools/ppt/shape-basic.d.ts.map +1 -1
- package/dist/tools/ppt/shape-basic.js +518 -421
- package/dist/tools/ppt/shape-basic.js.map +1 -1
- package/dist/tools/ppt/slide-ops.d.ts +6 -42
- package/dist/tools/ppt/slide-ops.d.ts.map +1 -1
- package/dist/tools/ppt/slide-ops.js +93 -1485
- package/dist/tools/ppt/slide-ops.js.map +1 -1
- package/dist/tools/ppt/slide.d.ts +1 -7
- package/dist/tools/ppt/slide.d.ts.map +1 -1
- package/dist/tools/ppt/slide.js +196 -328
- package/dist/tools/ppt/slide.js.map +1 -1
- package/dist/tools/ppt/table.d.ts.map +1 -1
- package/dist/tools/ppt/table.js +94 -264
- package/dist/tools/ppt/table.js.map +1 -1
- package/dist/tools/ppt/textbox.d.ts +1 -22
- package/dist/tools/ppt/textbox.d.ts.map +1 -1
- package/dist/tools/ppt/textbox.js +87 -107
- package/dist/tools/ppt/textbox.js.map +1 -1
- package/dist/tools/word/academic.d.ts +2 -0
- package/dist/tools/word/academic.d.ts.map +1 -1
- package/dist/tools/word/academic.js +77 -111
- package/dist/tools/word/academic.js.map +1 -1
- package/dist/tools/word/content.d.ts +7 -12
- package/dist/tools/word/content.d.ts.map +1 -1
- package/dist/tools/word/content.js +134 -452
- package/dist/tools/word/content.js.map +1 -1
- package/dist/tools/word/document.d.ts +1 -3
- package/dist/tools/word/document.d.ts.map +1 -1
- package/dist/tools/word/document.js +71 -328
- package/dist/tools/word/document.js.map +1 -1
- package/dist/tools/word/format.d.ts.map +1 -1
- package/dist/tools/word/format.js +59 -211
- package/dist/tools/word/format.js.map +1 -1
- package/dist/tools/word/helpers.d.ts +33 -0
- package/dist/tools/word/helpers.d.ts.map +1 -0
- package/dist/tools/word/helpers.js +50 -0
- package/dist/tools/word/helpers.js.map +1 -0
- package/dist/tools/word/index.d.ts +1 -1
- package/dist/tools/word/index.d.ts.map +1 -1
- package/dist/tools/word/index.js +2 -6
- package/dist/tools/word/index.js.map +1 -1
- package/dist/tools/word/professional.d.ts +4 -0
- package/dist/tools/word/professional.d.ts.map +1 -1
- package/dist/tools/word/professional.js +80 -4
- package/dist/tools/word/professional.js.map +1 -1
- package/dist/tools/word/proofread.d.ts.map +1 -1
- package/dist/tools/word/proofread.js +44 -184
- package/dist/tools/word/proofread.js.map +1 -1
- package/dist/types/tools.d.ts +6 -0
- package/dist/types/tools.d.ts.map +1 -1
- package/dist/utils/image-inline.d.ts +3 -0
- package/dist/utils/image-inline.d.ts.map +1 -0
- package/dist/utils/image-inline.js +61 -0
- package/dist/utils/image-inline.js.map +1 -0
- package/dist/version.js +1 -1
- package/package.json +1 -1
- package/scripts/wps-com.ps1 +509 -28
- package/skills/wps-multitool/SKILL.md +17 -4
- package/skills/wps-multitool/references/dsh.md +1 -1
- package/skills/wps-multitool/references/recipes.md +20 -4
- package/skills/wps-multitool/references/routing.md +13 -0
- package/dist/client/mac-poll-server.d.ts.map +0 -1
- package/dist/client/mac-poll-server.js.map +0 -1
- package/dist/tools/ppt/background.d.ts.map +0 -1
- package/dist/tools/ppt/background.js +0 -389
- package/dist/tools/ppt/background.js.map +0 -1
|
@@ -0,0 +1,635 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Input: DeckSpec(JSON 页面描述,自有 schema,字段名自定)——见 DeckSpec/各页型注释;theme 主题名(缺省学术蓝)
|
|
4
|
+
* Output: build_ppt_deck 工具(逐动作落成真 PPT)+ wps_ppt_get_textbox_metrics 工具(文本框排版度量,
|
|
5
|
+
* 生成后溢出检查的读回通道,也可独立做排版诊断)——都走 toolRegistry.callTool 真入口
|
|
6
|
+
* Pos: deckkit 引擎骨架(第 3 期 E2)+ 主题三套与生成后溢出检查(第 3 期 E3,方案 docs/agents/BORROW-PLAN.md §2.5 第三步)。
|
|
7
|
+
* 一旦我被修改,请更新我的头部注释,以及所属目录的md。
|
|
8
|
+
*
|
|
9
|
+
* 架构(方案 §2.2):布局计算(坐标/字号/密度)全部在本 TS 层——可 mock、可进门禁;
|
|
10
|
+
* 本模块【不碰 ps1】:展开成的是既有 ppt 动作(add_textbox/add_shape/set_shape_gradient/…),
|
|
11
|
+
* 逐动作经 toolRegistry.callTool 走真入口——快照护栏照常(红线),性能优化归 E3。
|
|
12
|
+
*
|
|
13
|
+
* shapeIndex 约定(重要):每页从空白页(layout=blank,0 形状)开始,展开序列里
|
|
14
|
+
* add_shape / add_textbox / insert_ppt_chart 每个都 +1;引用型动作
|
|
15
|
+
* (set_font_color / set_shape_gradient / set_ppt_chart_data)用【字面序号】——
|
|
16
|
+
* 因为每页型的形状序列是静态可数的,字面值比运行时计数更可断言(mock 单测逐个钉)。
|
|
17
|
+
*
|
|
18
|
+
* 素材路线(§2.2/第一步探针):COM 原生形状优先、零新增依赖——
|
|
19
|
+
* 渐变横幅 = set_shape_gradient(TwoColorGradient,探针 seg1 可用);
|
|
20
|
+
* 表格 = 矩形拼(第一步探针坑 5:AddTable 边框不可靠,禁走真表格);
|
|
21
|
+
* 行高系数 = 1.2(探针 seg3 本机标定——【改动前须真机复核】,勿抄别处数值)。
|
|
22
|
+
*
|
|
23
|
+
* 主题(E3):学术蓝 / 政务红 / 商务灰——配色、字体对、间距整套在 DECK_THEMES;
|
|
24
|
+
* 数值【全部自创(2026-10-29),未搬任何现成模板——改动前须真机复核】;字体只用 Windows/WPS 必有字体。
|
|
25
|
+
*
|
|
26
|
+
* 溢出检查(E3,探针 seg2 证过 BoundHeight 可判溢出):每页铺完自动量一遍(wps_ppt_get_textbox_metrics
|
|
27
|
+
* 读回 boundHeight vs 帧高);超框 → 写 warnings + 缩字一档(不低于正文字号下限)重排复测一次,
|
|
28
|
+
* 仍超只警告不强改。量不了(旧桥缺 bound 字段 / 读回失败)→ 如实降级记一条,不算失败——页已生成成功,
|
|
29
|
+
* 检查是诊断不是闸门;fail-fast 只管写入步骤。
|
|
30
|
+
*
|
|
31
|
+
* 数据约定(chart 页):insert_ppt_chart 的 data 参数不生效(chart-flow.ts 头注),必须
|
|
32
|
+
* insert → set_ppt_chart_data 两段式;chartIndex = 页内形状序号(图表追加在最后)。
|
|
33
|
+
*
|
|
34
|
+
* schema 是自研的(防抄态势 BORROW-PLAN §4.4):字段名 kind/heading/points/milestones 等
|
|
35
|
+
* 与任何外部引擎不同源;页型命名体系自定。
|
|
36
|
+
*/
|
|
37
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
38
|
+
exports.deckTools = exports.buildDeckHandler = exports.buildDeckDefinition = exports.getTextboxMetricsHandler = exports.getTextboxMetricsDefinition = exports.DECK_OVERFLOW = exports.DECK_THEMES = exports.DEFAULT_THEME = exports.DECK_TYPO = void 0;
|
|
39
|
+
exports.resolveDeckTypo = resolveDeckTypo;
|
|
40
|
+
exports.expandDeck = expandDeck;
|
|
41
|
+
exports.deckSummary = deckSummary;
|
|
42
|
+
exports.pageTextBoxRecords = pageTextBoxRecords;
|
|
43
|
+
const uuid_1 = require("uuid");
|
|
44
|
+
const tools_1 = require("../../types/tools");
|
|
45
|
+
const tool_registry_1 = require("../../server/tool-registry");
|
|
46
|
+
const wps_client_1 = require("../../client/wps-client");
|
|
47
|
+
const wps_1 = require("../../types/wps");
|
|
48
|
+
// ============================================================================
|
|
49
|
+
// 排版纪律常量(一处集中;【本机标定值,改动前须真机复核】——lineFactor 来自引擎探针 seg3)
|
|
50
|
+
// ============================================================================
|
|
51
|
+
exports.DECK_TYPO = {
|
|
52
|
+
slideWidth: 960,
|
|
53
|
+
slideHeight: 540,
|
|
54
|
+
margin: 42,
|
|
55
|
+
titleBandTop: 30,
|
|
56
|
+
titleBandHeight: 64,
|
|
57
|
+
titleFont: 30,
|
|
58
|
+
sectionFont: 40,
|
|
59
|
+
closingFont: 44,
|
|
60
|
+
heroFont: 36,
|
|
61
|
+
subFont: 20,
|
|
62
|
+
bodyTop: 128,
|
|
63
|
+
bodyFont: 16,
|
|
64
|
+
/** 正文字号下限(排版纪律:低于此值可读性崩) */
|
|
65
|
+
bodyFontMin: 14,
|
|
66
|
+
cardGap: 18,
|
|
67
|
+
/** 多行行高系数:引擎探针 seg3 实测 24 号字行高 28.8pt → 1.2。改动前须真机复核 */
|
|
68
|
+
lineFactor: 1.2,
|
|
69
|
+
/** 每页信息密度上限(超出直接拒绝,不静默截断) */
|
|
70
|
+
maxBullets: 6,
|
|
71
|
+
maxComparePoints: 4,
|
|
72
|
+
maxTableRows: 6,
|
|
73
|
+
maxTableCols: 4,
|
|
74
|
+
maxTimeline: 6,
|
|
75
|
+
maxSlides: 30,
|
|
76
|
+
};
|
|
77
|
+
exports.DEFAULT_THEME = 'academic-blue';
|
|
78
|
+
exports.DECK_THEMES = {
|
|
79
|
+
'academic-blue': {
|
|
80
|
+
label: '学术蓝',
|
|
81
|
+
deep: '#1F3A5F', mid: '#2E5C8A', accent: '#C8A24B', paper: '#F5F7FA', ink: '#1A1A1A',
|
|
82
|
+
fontPair: { heading: '微软雅黑', body: '微软雅黑' },
|
|
83
|
+
},
|
|
84
|
+
'gov-red': {
|
|
85
|
+
label: '政务红',
|
|
86
|
+
deep: '#8C1F28', mid: '#B03A3F', accent: '#D2A24C', paper: '#FBF6EF', ink: '#2B1D1D',
|
|
87
|
+
fontPair: { heading: '黑体', body: '仿宋' },
|
|
88
|
+
spacing: { margin: 48 },
|
|
89
|
+
},
|
|
90
|
+
'business-gray': {
|
|
91
|
+
label: '商务灰',
|
|
92
|
+
deep: '#2B2F33', mid: '#545B63', accent: '#B7791F', paper: '#F3F4F6', ink: '#1F2328',
|
|
93
|
+
fontPair: { heading: '微软雅黑', body: '微软雅黑' },
|
|
94
|
+
spacing: { cardGap: 20 },
|
|
95
|
+
},
|
|
96
|
+
};
|
|
97
|
+
/** E3 溢出检查常量:tolerance 防浮点噪声与边贴边误报(探针 seg3 行高 28.8 量级下 1pt 足够容噪);缩字档位自创 */
|
|
98
|
+
exports.DECK_OVERFLOW = {
|
|
99
|
+
tolerancePt: 1,
|
|
100
|
+
fontStep: 2,
|
|
101
|
+
};
|
|
102
|
+
function resolveDeckTypo(themeName = exports.DEFAULT_THEME) {
|
|
103
|
+
const t = exports.DECK_THEMES[themeName];
|
|
104
|
+
if (!t) {
|
|
105
|
+
throw new Error(`未知主题「${String(themeName)}」。支持:${Object.keys(exports.DECK_THEMES).join(' / ')}`);
|
|
106
|
+
}
|
|
107
|
+
return { ...exports.DECK_TYPO, ...(t.spacing ?? {}), theme: t };
|
|
108
|
+
}
|
|
109
|
+
const KNOWN_KINDS = ['title', 'section', 'bullets', 'compare', 'imageText', 'table', 'chart', 'timeline', 'closing', 'quote'];
|
|
110
|
+
// ============================================================================
|
|
111
|
+
// 展开器(纯函数:DeckSpec → DeckStep[][],坐标/字号/shapeIndex 全在此算)
|
|
112
|
+
// ============================================================================
|
|
113
|
+
function textbox(slide, o) {
|
|
114
|
+
return {
|
|
115
|
+
tool: 'wps_ppt_add_textbox',
|
|
116
|
+
args: {
|
|
117
|
+
slideIndex: slide, left: o.left, top: o.top, width: o.width, height: o.height, text: o.text,
|
|
118
|
+
...(o.fontSize ? { fontSize: o.fontSize } : {}), ...(o.fontName ? { fontName: o.fontName } : {}),
|
|
119
|
+
},
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
function color(slide, shapeIndex, hex) {
|
|
123
|
+
return { tool: 'wps_ppt_set_font_color', args: { slideIndex: slide, shapeIndex, color: hex } };
|
|
124
|
+
}
|
|
125
|
+
/** 标题色带(形状#1)+ 标题文本框(形状#2,白字) */
|
|
126
|
+
function headingBand(slide, heading, T) {
|
|
127
|
+
return [
|
|
128
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: 0, top: T.titleBandTop, width: T.slideWidth, height: T.titleBandHeight, fillColor: T.theme.deep }, note: '标题色带' },
|
|
129
|
+
{ tool: 'wps_ppt_add_textbox', args: { slideIndex: slide, left: T.margin, top: T.titleBandTop + 8, width: T.slideWidth - T.margin * 2, height: T.titleBandHeight - 16, text: heading, fontSize: T.titleFont, fontName: T.theme.fontPair.heading } },
|
|
130
|
+
color(slide, 2, '#FFFFFF'),
|
|
131
|
+
];
|
|
132
|
+
}
|
|
133
|
+
/** 全页渐变底(形状#1) */
|
|
134
|
+
function fullBleedGradient(slide, from, to, T) {
|
|
135
|
+
return [
|
|
136
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: 0, top: 0, width: T.slideWidth, height: T.slideHeight, fillColor: from }, note: '全页底' },
|
|
137
|
+
{ tool: 'wps_ppt_set_shape_gradient', args: { slideIndex: slide, shapeIndex: 1, gradient: { type: 'linear', angle: 90, stops: [{ color: from, position: 0 }, { color: to, position: 1 }] } } },
|
|
138
|
+
];
|
|
139
|
+
}
|
|
140
|
+
const pageSteps = {
|
|
141
|
+
// 形状序列(每页):#1 渐变底,#2 标题,#3 副标,#4 页脚
|
|
142
|
+
title: (slide, s, T) => {
|
|
143
|
+
const steps = [
|
|
144
|
+
...fullBleedGradient(slide, T.theme.deep, T.theme.mid, T),
|
|
145
|
+
textbox(slide, { left: 80, top: 200, width: 800, height: 90, text: s.heading, fontSize: T.heroFont, fontName: T.theme.fontPair.heading }),
|
|
146
|
+
color(slide, 2, '#FFFFFF'),
|
|
147
|
+
];
|
|
148
|
+
if (s.sub) {
|
|
149
|
+
steps.push(textbox(slide, { left: 80, top: 300, width: 800, height: 50, text: s.sub, fontSize: T.subFont, fontName: T.theme.fontPair.body }));
|
|
150
|
+
steps.push(color(slide, 3, T.theme.accent));
|
|
151
|
+
}
|
|
152
|
+
if (s.footer) {
|
|
153
|
+
steps.push(textbox(slide, { left: 80, top: 480, width: 800, height: 30, text: s.footer, fontSize: 12 }));
|
|
154
|
+
steps.push(color(slide, 4, '#DDE6F2'));
|
|
155
|
+
}
|
|
156
|
+
return steps;
|
|
157
|
+
},
|
|
158
|
+
// #1 竖条,#2 序号,#3 标题,#4 标语
|
|
159
|
+
section: (slide, s, T) => {
|
|
160
|
+
const steps = [
|
|
161
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: 0, top: 0, width: 24, height: T.slideHeight, fillColor: T.theme.accent }, note: '章节竖条' },
|
|
162
|
+
textbox(slide, { left: 70, top: 200, width: 160, height: 90, text: s.ordinal, fontSize: T.sectionFont, fontName: T.theme.fontPair.heading }),
|
|
163
|
+
color(slide, 2, T.theme.accent),
|
|
164
|
+
textbox(slide, { left: 240, top: 210, width: 640, height: 80, text: s.heading, fontSize: T.titleFont, fontName: T.theme.fontPair.heading }),
|
|
165
|
+
];
|
|
166
|
+
if (s.tagline) {
|
|
167
|
+
steps.push(textbox(slide, { left: 240, top: 300, width: 640, height: 40, text: s.tagline, fontSize: T.bodyFont, fontName: T.theme.fontPair.body }));
|
|
168
|
+
steps.push(color(slide, 4, '#666666'));
|
|
169
|
+
}
|
|
170
|
+
return steps;
|
|
171
|
+
},
|
|
172
|
+
// #1 色带,#2 标题(白);要点卡 i:色块 2i+1、文本 2i+2
|
|
173
|
+
bullets: (slide, s, T) => {
|
|
174
|
+
if (!s.points?.length)
|
|
175
|
+
throw new Error('bullets 页需要 points');
|
|
176
|
+
if (s.points.length > T.maxBullets)
|
|
177
|
+
throw new Error(`要点数 ${s.points.length} 超过每页密度上限 ${T.maxBullets}——拆页`);
|
|
178
|
+
const gap = (T.slideHeight - T.bodyTop - 30) / s.points.length;
|
|
179
|
+
const cards = s.points.map((pt, i) => {
|
|
180
|
+
const top = T.bodyTop + i * gap;
|
|
181
|
+
return [
|
|
182
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: T.margin, top, width: T.slideWidth - T.margin * 2, height: gap - T.cardGap, fillColor: T.theme.paper } },
|
|
183
|
+
textbox(slide, { left: T.margin + 16, top: top + (gap - T.cardGap - T.bodyFont * T.lineFactor) / 2, width: T.slideWidth - T.margin * 2 - 32, height: T.bodyFont * T.lineFactor, text: pt, fontSize: Math.max(T.bodyFont, T.bodyFontMin), fontName: T.theme.fontPair.body }),
|
|
184
|
+
];
|
|
185
|
+
}).flat();
|
|
186
|
+
return [...headingBand(slide, s.heading, T), ...cards];
|
|
187
|
+
},
|
|
188
|
+
// #1/#2 标题带;左:色块3/label4/points5(墨);右:色块6/label7/points8(墨)
|
|
189
|
+
compare: (slide, s, T) => {
|
|
190
|
+
const check = (col_) => {
|
|
191
|
+
if (!col_?.label || !col_?.points?.length)
|
|
192
|
+
throw new Error('compare 页左右两栏各需要 label 与 points');
|
|
193
|
+
if (col_.points.length > T.maxComparePoints)
|
|
194
|
+
throw new Error(`每栏要点 ${col_.points.length} 超上限 ${T.maxComparePoints}`);
|
|
195
|
+
return col_;
|
|
196
|
+
};
|
|
197
|
+
const L = check(s.left);
|
|
198
|
+
const R = check(s.right);
|
|
199
|
+
const w = (T.slideWidth - T.margin * 2 - T.cardGap) / 2;
|
|
200
|
+
const col = (x, col_, color0, base) => [
|
|
201
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: x, top: T.bodyTop, width: w, height: 60, fillColor: color0 } },
|
|
202
|
+
textbox(slide, { left: x + 12, top: T.bodyTop + 10, width: w - 24, height: 40, text: col_.label, fontSize: 18, fontName: T.theme.fontPair.heading }),
|
|
203
|
+
textbox(slide, { left: x + 12, top: T.bodyTop + 70, width: w - 24, height: 280, text: col_.points.map((p, i) => `${i + 1}. ${p}`).join('\n'), fontSize: T.bodyFontMin, fontName: T.theme.fontPair.body }),
|
|
204
|
+
color(slide, base, T.theme.ink),
|
|
205
|
+
];
|
|
206
|
+
return [
|
|
207
|
+
...headingBand(slide, s.heading, T),
|
|
208
|
+
...col(T.margin, L, T.theme.mid, 5),
|
|
209
|
+
...col(T.margin + w + T.cardGap, R, T.theme.accent, 8),
|
|
210
|
+
];
|
|
211
|
+
},
|
|
212
|
+
// #1/#2 标题带,#3 图
|
|
213
|
+
imageText: (slide, s, T) => {
|
|
214
|
+
if (!s.imagePath)
|
|
215
|
+
throw new Error('imageText 页需要 imagePath');
|
|
216
|
+
return [
|
|
217
|
+
...headingBand(slide, s.heading, T),
|
|
218
|
+
{ tool: 'wps_ppt_insert_image', args: { slideIndex: slide, path: s.imagePath, left: T.margin, top: T.bodyTop, width: 420, height: 340 } },
|
|
219
|
+
textbox(slide, { left: T.margin + 440, top: T.bodyTop, width: T.slideWidth - T.margin * 2 - 440, height: 340, text: (s.points || []).map((p, i) => `${i + 1}. ${p}`).join('\n'), fontSize: T.bodyFont, fontName: T.theme.fontPair.body }),
|
|
220
|
+
];
|
|
221
|
+
},
|
|
222
|
+
// #1/#2 标题带;表头 j:色块 3+2j、文本 4+2j;数据行 (i,j):色块、文本(无单独上色)
|
|
223
|
+
table: (slide, s, T) => {
|
|
224
|
+
if (!s.head?.length)
|
|
225
|
+
throw new Error('table 页需要 head(表头行)');
|
|
226
|
+
if (s.head.length > T.maxTableCols)
|
|
227
|
+
throw new Error(`列数 ${s.head.length} 超上限 ${T.maxTableCols}——矩形拼表格的密度纪律`);
|
|
228
|
+
if (!s.rows?.length || s.rows.length > T.maxTableRows)
|
|
229
|
+
throw new Error(`数据行需 1~${T.maxTableRows} 行(got ${s.rows?.length ?? 0})`);
|
|
230
|
+
if (s.rows.some((r) => r.length !== s.head.length))
|
|
231
|
+
throw new Error('数据行列数与表头不一致');
|
|
232
|
+
const w = (T.slideWidth - T.margin * 2) / s.head.length;
|
|
233
|
+
const headH = 40;
|
|
234
|
+
const rowH = 40;
|
|
235
|
+
const steps = [...headingBand(slide, s.heading, T)];
|
|
236
|
+
s.head.forEach((h, j) => {
|
|
237
|
+
steps.push({ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: T.margin + j * w, top: T.bodyTop, width: w, height: headH, fillColor: T.theme.deep } });
|
|
238
|
+
steps.push(textbox(slide, { left: T.margin + j * w + 6, top: T.bodyTop + 6, width: w - 12, height: headH - 12, text: h, fontSize: T.bodyFont, fontName: T.theme.fontPair.heading }));
|
|
239
|
+
steps.push(color(slide, 3 + 2 * j, '#FFFFFF'));
|
|
240
|
+
});
|
|
241
|
+
s.rows.forEach((row, i) => {
|
|
242
|
+
const top = T.bodyTop + headH + i * rowH;
|
|
243
|
+
row.forEach((cell, j) => {
|
|
244
|
+
steps.push({ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: T.margin + j * w, top, width: w, height: rowH, fillColor: i % 2 === 0 ? T.theme.paper : '#FFFFFF' } });
|
|
245
|
+
steps.push(textbox(slide, { left: T.margin + j * w + 6, top: top + 6, width: w - 12, height: rowH - 12, text: String(cell), fontSize: T.bodyFontMin, fontName: T.theme.fontPair.body }));
|
|
246
|
+
});
|
|
247
|
+
});
|
|
248
|
+
return steps;
|
|
249
|
+
},
|
|
250
|
+
// #1/#2 标题带,#3 图表(insert 后 #3 就是图表本身——追加在页尾)
|
|
251
|
+
chart: (slide, s, T) => {
|
|
252
|
+
if (!s.categories?.length || !s.series?.length)
|
|
253
|
+
throw new Error('chart 页需要 categories 与 series');
|
|
254
|
+
return [
|
|
255
|
+
...headingBand(slide, s.heading, T),
|
|
256
|
+
{ tool: 'wps_ppt_insert_ppt_chart', args: { slideIndex: slide, chartType: s.chartType ?? 51, left: T.margin, top: T.bodyTop, width: T.slideWidth - T.margin * 2, height: T.slideHeight - T.bodyTop - 30, data: { categories: s.categories, series: s.series } }, note: 'data 在此不生效(chart-flow.ts 头注),仅建形状' },
|
|
257
|
+
{ tool: 'wps_ppt_set_ppt_chart_data', args: { slideIndex: slide, chartIndex: 3, data: { categories: s.categories, series: s.series } }, note: '真数据二段式(chartIndex=3:标题带两形状后图表追加页尾)' },
|
|
258
|
+
];
|
|
259
|
+
},
|
|
260
|
+
// #1/#2 标题带,#3 主线;里程碑 i:节点 4+2i、label 5+2i、note(交替上/下,note 时 +1)
|
|
261
|
+
timeline: (slide, s, T) => {
|
|
262
|
+
if (!s.milestones?.length)
|
|
263
|
+
throw new Error('timeline 页需要 milestones');
|
|
264
|
+
if (s.milestones.length > T.maxTimeline)
|
|
265
|
+
throw new Error(`里程碑 ${s.milestones.length} 超上限 ${T.maxTimeline}`);
|
|
266
|
+
const axisY = T.bodyTop + 140;
|
|
267
|
+
const span = T.slideWidth - T.margin * 2 - 60;
|
|
268
|
+
const step = span / Math.max(s.milestones.length - 1, 1);
|
|
269
|
+
const steps = [
|
|
270
|
+
...headingBand(slide, s.heading, T),
|
|
271
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: T.margin + 30, top: axisY, width: span, height: 4, fillColor: T.theme.mid }, note: '时间轴主线' },
|
|
272
|
+
];
|
|
273
|
+
s.milestones.forEach((m, i) => {
|
|
274
|
+
const x = T.margin + 30 + i * step;
|
|
275
|
+
steps.push({ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: x - 8, top: axisY - 10, width: 16, height: 24, fillColor: T.theme.accent }, note: `节点${i + 1}` });
|
|
276
|
+
const above = i % 2 === 0;
|
|
277
|
+
steps.push(textbox(slide, { left: x - 55, top: above ? axisY - 60 : axisY + 30, width: 130, height: 40, text: m.label, fontSize: T.bodyFont, fontName: T.theme.fontPair.heading }));
|
|
278
|
+
if (m.note)
|
|
279
|
+
steps.push(textbox(slide, { left: x - 55, top: above ? axisY + 30 : axisY - 60, width: 130, height: 40, text: m.note, fontSize: T.bodyFontMin, fontName: T.theme.fontPair.body }));
|
|
280
|
+
});
|
|
281
|
+
return steps;
|
|
282
|
+
},
|
|
283
|
+
// #1 渐变底,#2 heading,#3 contact
|
|
284
|
+
closing: (slide, s, T) => {
|
|
285
|
+
const steps = [
|
|
286
|
+
...fullBleedGradient(slide, T.theme.mid, T.theme.deep, T),
|
|
287
|
+
textbox(slide, { left: 80, top: 210, width: 800, height: 100, text: s.heading, fontSize: T.closingFont, fontName: T.theme.fontPair.heading }),
|
|
288
|
+
color(slide, 2, '#FFFFFF'),
|
|
289
|
+
];
|
|
290
|
+
if (s.contact) {
|
|
291
|
+
steps.push(textbox(slide, { left: 80, top: 330, width: 800, height: 40, text: s.contact, fontSize: T.bodyFont }));
|
|
292
|
+
steps.push(color(slide, 3, T.theme.accent));
|
|
293
|
+
}
|
|
294
|
+
return steps;
|
|
295
|
+
},
|
|
296
|
+
// #1 竖条,#2 引文,#3 出处
|
|
297
|
+
quote: (slide, s, T) => {
|
|
298
|
+
if (!s.quote)
|
|
299
|
+
throw new Error('quote 页需要 quote(引文内容)');
|
|
300
|
+
const steps = [
|
|
301
|
+
{ tool: 'wps_ppt_add_shape', args: { slideIndex: slide, type: 'rectangle', left: 0, top: 0, width: 14, height: T.slideHeight, fillColor: T.theme.accent }, note: '引文竖条' },
|
|
302
|
+
textbox(slide, { left: 90, top: 180, width: 780, height: 160, text: '「' + s.quote + '」', fontSize: 28, fontName: T.theme.fontPair.heading }),
|
|
303
|
+
color(slide, 2, T.theme.ink),
|
|
304
|
+
];
|
|
305
|
+
if (s.attribution) {
|
|
306
|
+
steps.push(textbox(slide, { left: 90, top: 360, width: 780, height: 40, text: '—— ' + s.attribution, fontSize: T.bodyFont, fontName: T.theme.fontPair.body }));
|
|
307
|
+
steps.push(color(slide, 3, '#666666'));
|
|
308
|
+
}
|
|
309
|
+
return steps;
|
|
310
|
+
},
|
|
311
|
+
};
|
|
312
|
+
/** 纯函数:DeckSpec → 每页步骤。抛错 = 描述违反排版纪律(密度/缺字段/未知 kind/未知主题),handler 转如实报错 */
|
|
313
|
+
function expandDeck(spec, themeName = exports.DEFAULT_THEME) {
|
|
314
|
+
const T = resolveDeckTypo(themeName);
|
|
315
|
+
if (!spec?.slides?.length)
|
|
316
|
+
throw new Error('deck.slides 为空:至少给一页');
|
|
317
|
+
if (spec.slides.length > T.maxSlides) {
|
|
318
|
+
throw new Error(`页数 ${spec.slides.length} 超过上限 ${T.maxSlides}`);
|
|
319
|
+
}
|
|
320
|
+
return spec.slides.map((s, i) => {
|
|
321
|
+
const fn = pageSteps[s.kind];
|
|
322
|
+
if (!fn) {
|
|
323
|
+
throw new Error(`未知页型「${s.kind}」(第 ${i + 1} 页)。支持:${KNOWN_KINDS.join(' / ')}`);
|
|
324
|
+
}
|
|
325
|
+
return fn(i + 1, s, T);
|
|
326
|
+
});
|
|
327
|
+
}
|
|
328
|
+
/** 诊断:整套 deck 的步骤总览(handler 返回里带,便于客户端复核) */
|
|
329
|
+
function deckSummary(pages) {
|
|
330
|
+
return pages.map((steps, i) => ({
|
|
331
|
+
slide: i + 1,
|
|
332
|
+
steps: steps.length,
|
|
333
|
+
tools: [...new Set(steps.map((x) => x.tool))],
|
|
334
|
+
}));
|
|
335
|
+
}
|
|
336
|
+
// ============================================================================
|
|
337
|
+
// 工具一:wps_ppt_get_textbox_metrics(只读;deckkit 溢出检查的读回通道,也可独立做排版诊断)
|
|
338
|
+
// ============================================================================
|
|
339
|
+
exports.getTextboxMetricsDefinition = {
|
|
340
|
+
name: 'wps_ppt_get_textbox_metrics',
|
|
341
|
+
description: `获取指定页全部文本框的排版度量(结构化 JSON,只读):每框 index/name/text/left/top/width/height(帧几何)+ boundWidth/boundHeight(文字实际包围盒)+ fontSize(当前字号)。boundHeight > height 即文字超框。
|
|
342
|
+
deckkit 生成后溢出检查的读回通道(E3),也可独立用于排版诊断。
|
|
343
|
+
注意:bound 字段需桥侧 getTextBoxes 支持(E3 增补);旧桥回包缺字段,调用方须按字段缺失降级,勿当硬失败。`,
|
|
344
|
+
category: tools_1.ToolCategory.PRESENTATION,
|
|
345
|
+
inputSchema: {
|
|
346
|
+
type: 'object',
|
|
347
|
+
properties: {
|
|
348
|
+
slideIndex: { type: 'number', description: '幻灯片索引(从1开始)' },
|
|
349
|
+
},
|
|
350
|
+
required: ['slideIndex'],
|
|
351
|
+
},
|
|
352
|
+
};
|
|
353
|
+
const getTextboxMetricsHandler = async (args) => {
|
|
354
|
+
const { slideIndex } = args;
|
|
355
|
+
try {
|
|
356
|
+
const response = await wps_client_1.wpsClient.executeMethod('getTextBoxes', { slideIndex }, wps_1.WpsAppType.PRESENTATION);
|
|
357
|
+
if (!response.success) {
|
|
358
|
+
return {
|
|
359
|
+
id: (0, uuid_1.v4)(),
|
|
360
|
+
success: false,
|
|
361
|
+
content: [{ type: 'text', text: `获取文本框度量失败: ${response.error}` }],
|
|
362
|
+
error: response.error,
|
|
363
|
+
};
|
|
364
|
+
}
|
|
365
|
+
const list = response.data?.textBoxes ?? [];
|
|
366
|
+
// 降级标记(体验修复轮 A):boundHeight 拿得到 = 桥是 E3 增补后的;拿不到 = 老桥,
|
|
367
|
+
// 消费方(溢出检查)必须把"读不到"与"没超"分开表述,不许把读不到当没超。
|
|
368
|
+
const boundSupported = list.some((x) => x && typeof x === 'object' && x.boundHeight !== undefined && x.boundHeight !== null);
|
|
369
|
+
return {
|
|
370
|
+
id: (0, uuid_1.v4)(),
|
|
371
|
+
success: true,
|
|
372
|
+
content: [{ type: 'text', text: JSON.stringify({ slideIndex, boundSupported, textBoxes: list }) }],
|
|
373
|
+
};
|
|
374
|
+
}
|
|
375
|
+
catch (error) {
|
|
376
|
+
const errMsg = error instanceof Error ? error.message : String(error);
|
|
377
|
+
return {
|
|
378
|
+
id: (0, uuid_1.v4)(),
|
|
379
|
+
success: false,
|
|
380
|
+
content: [{ type: 'text', text: `获取文本框度量出错: ${errMsg}` }],
|
|
381
|
+
error: errMsg,
|
|
382
|
+
};
|
|
383
|
+
}
|
|
384
|
+
};
|
|
385
|
+
exports.getTextboxMetricsHandler = getTextboxMetricsHandler;
|
|
386
|
+
// ============================================================================
|
|
387
|
+
// 生成后溢出检查(E3):BoundHeight 实际文字高度 vs 帧高;超框 → warnings + 缩字一档重排复测一次
|
|
388
|
+
// ============================================================================
|
|
389
|
+
/** 每页的文本框静态记录(shapeIndex 按 SHAPE_CREATING_TOOLS 次序数出,与 COM Shapes 序号同空间)。
|
|
390
|
+
* 【大项②判定缺陷修复 2026-11-04】图片步旧名 insert_ppt_image 已转别名,deckkit 同步改发
|
|
391
|
+
* wps_ppt_insert_image——本表没跟着换,导致 imageText 页图片步不被计数、其后的文本框
|
|
392
|
+
* shapeIndex 少算一格、溢出检查测错形状。 */
|
|
393
|
+
const SHAPE_CREATING_TOOLS = new Set([
|
|
394
|
+
'wps_ppt_add_shape',
|
|
395
|
+
'wps_ppt_add_textbox',
|
|
396
|
+
'wps_ppt_insert_image',
|
|
397
|
+
'wps_ppt_insert_ppt_chart',
|
|
398
|
+
]);
|
|
399
|
+
/** 从一页步骤流静态导出文本框记录——与展开器同源推导,不另设平行结构防漂移 */
|
|
400
|
+
function pageTextBoxRecords(steps) {
|
|
401
|
+
let ordinal = 0;
|
|
402
|
+
const out = [];
|
|
403
|
+
for (const st of steps) {
|
|
404
|
+
if (!SHAPE_CREATING_TOOLS.has(st.tool))
|
|
405
|
+
continue;
|
|
406
|
+
ordinal += 1;
|
|
407
|
+
if (st.tool === 'wps_ppt_add_textbox') {
|
|
408
|
+
out.push({
|
|
409
|
+
shapeIndex: ordinal,
|
|
410
|
+
text: String(st.args.text ?? ''),
|
|
411
|
+
fontSize: typeof st.args.fontSize === 'number' ? st.args.fontSize : exports.DECK_TYPO.bodyFont,
|
|
412
|
+
width: st.args.width,
|
|
413
|
+
height: st.args.height,
|
|
414
|
+
});
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
return out;
|
|
418
|
+
}
|
|
419
|
+
/** 溢出判据:纵向 boundHeight 超帧高,或横向 boundWidth 超帧宽(不换行文本走横向),均带容差 */
|
|
420
|
+
function isOverflow(m) {
|
|
421
|
+
const tol = exports.DECK_OVERFLOW.tolerancePt;
|
|
422
|
+
const vertical = typeof m.boundHeight === 'number' && typeof m.height === 'number' && m.boundHeight > m.height + tol;
|
|
423
|
+
const horizontal = typeof m.boundWidth === 'number' && typeof m.width === 'number' && m.boundWidth > m.width + tol;
|
|
424
|
+
return vertical || horizontal;
|
|
425
|
+
}
|
|
426
|
+
async function fetchTextBoxMetrics(slide) {
|
|
427
|
+
const r = await tool_registry_1.toolRegistry.callTool({ id: (0, uuid_1.v4)(), name: 'wps_ppt_get_textbox_metrics', arguments: { slideIndex: slide } });
|
|
428
|
+
if (!r.success)
|
|
429
|
+
return null;
|
|
430
|
+
try {
|
|
431
|
+
const parsed = JSON.parse(r.content?.[0]?.text ?? 'null');
|
|
432
|
+
return Array.isArray(parsed?.textBoxes) ? parsed.textBoxes : null;
|
|
433
|
+
}
|
|
434
|
+
catch {
|
|
435
|
+
return null;
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
const snippetOf = (t) => (t.length > 14 ? t.slice(0, 14) + '…' : t);
|
|
439
|
+
/** 一页的生成后溢出检查。返回 degraded=true = 量不了(页已生成成功,不算失败) */
|
|
440
|
+
async function checkPageOverflow(slide, steps) {
|
|
441
|
+
const records = pageTextBoxRecords(steps);
|
|
442
|
+
if (!records.length)
|
|
443
|
+
return { issues: [], warnings: [], degraded: false };
|
|
444
|
+
const metrics = await fetchTextBoxMetrics(slide);
|
|
445
|
+
if (!metrics || !metrics.some((m) => m && typeof m === 'object' && 'boundHeight' in m)) {
|
|
446
|
+
return { issues: [], warnings: [], degraded: true };
|
|
447
|
+
}
|
|
448
|
+
const issues = [];
|
|
449
|
+
const warnings = [];
|
|
450
|
+
const shrinking = [];
|
|
451
|
+
// "读不到"≠"没超"(体验修复轮 A):桥回传 boundHeight 为 null 的块不计入溢出判定,
|
|
452
|
+
// 但必须按页如实说一声,不许静默漏过
|
|
453
|
+
let unmeasurable = 0;
|
|
454
|
+
for (const rec of records) {
|
|
455
|
+
const m = metrics.find((x) => x.index === rec.shapeIndex);
|
|
456
|
+
if (!m)
|
|
457
|
+
continue;
|
|
458
|
+
if (typeof m.boundHeight !== 'number') {
|
|
459
|
+
unmeasurable += 1;
|
|
460
|
+
continue;
|
|
461
|
+
}
|
|
462
|
+
if (!isOverflow(m))
|
|
463
|
+
continue;
|
|
464
|
+
const cur = typeof m.fontSize === 'number' && m.fontSize > 0 ? m.fontSize : rec.fontSize;
|
|
465
|
+
const target = Math.max(cur - exports.DECK_OVERFLOW.fontStep, exports.DECK_TYPO.bodyFontMin);
|
|
466
|
+
if (target < cur) {
|
|
467
|
+
shrinking.push({ rec, m, target });
|
|
468
|
+
}
|
|
469
|
+
else {
|
|
470
|
+
issues.push({ slide, shapeIndex: rec.shapeIndex, snippet: snippetOf(rec.text), frameHeight: m.height ?? null, boundHeight: m.boundHeight, fixed: false, note: '已达正文字号下限,不强改' });
|
|
471
|
+
warnings.push(`第 ${slide} 页第 ${rec.shapeIndex} 块文字溢出(帧高 ${m.height}pt/实际 ${m.boundHeight}pt):"${snippetOf(rec.text)}"——已达正文字号下限 ${exports.DECK_TYPO.bodyFontMin}pt,请手工调整`);
|
|
472
|
+
}
|
|
473
|
+
}
|
|
474
|
+
if (unmeasurable > 0) {
|
|
475
|
+
warnings.push(`第 ${slide} 页有 ${unmeasurable} 块文字无法测量(读回 BoundHeight 为空),未计入溢出检查——这与"没超框"是两回事,建议 wps_ppt_get_textbox_metrics 人工看一眼`);
|
|
476
|
+
}
|
|
477
|
+
if (shrinking.length) {
|
|
478
|
+
for (const s of shrinking) {
|
|
479
|
+
await tool_registry_1.toolRegistry.callTool({
|
|
480
|
+
id: (0, uuid_1.v4)(),
|
|
481
|
+
name: 'wps_ppt_set_textbox_style',
|
|
482
|
+
arguments: { slideIndex: slide, textboxIndex: s.rec.shapeIndex, style: { fontSize: s.target } },
|
|
483
|
+
});
|
|
484
|
+
}
|
|
485
|
+
const after = await fetchTextBoxMetrics(slide);
|
|
486
|
+
for (const s of shrinking) {
|
|
487
|
+
const m2 = after?.find((x) => x.index === s.rec.shapeIndex);
|
|
488
|
+
if (after && m2 && typeof m2.boundHeight === 'number' && !isOverflow(m2)) {
|
|
489
|
+
issues.push({ slide, shapeIndex: s.rec.shapeIndex, snippet: snippetOf(s.rec.text), frameHeight: m2.height ?? null, boundHeight: m2.boundHeight, fixed: true, finalFontSize: s.target, note: `已缩字 ${s.m.fontSize ?? s.rec.fontSize}→${s.target}pt 复测通过` });
|
|
490
|
+
}
|
|
491
|
+
else if (after && m2 && typeof m2.boundHeight === 'number') {
|
|
492
|
+
issues.push({ slide, shapeIndex: s.rec.shapeIndex, snippet: snippetOf(s.rec.text), frameHeight: m2.height ?? null, boundHeight: m2.boundHeight, fixed: false, note: `缩字一档(→${s.target}pt)后仍溢出,不强改` });
|
|
493
|
+
warnings.push(`第 ${slide} 页第 ${s.rec.shapeIndex} 块文字溢出(帧高 ${m2.height}pt/实际 ${m2.boundHeight}pt):"${snippetOf(s.rec.text)}"——缩字一档后仍溢出,请手工调整`);
|
|
494
|
+
}
|
|
495
|
+
else {
|
|
496
|
+
issues.push({ slide, shapeIndex: s.rec.shapeIndex, snippet: snippetOf(s.rec.text), frameHeight: s.m.height ?? null, boundHeight: typeof s.m.boundHeight === 'number' ? s.m.boundHeight : null, fixed: false, note: `已缩字至 ${s.target}pt 但复测失败(读回通道异常),请手工确认` });
|
|
497
|
+
warnings.push(`第 ${slide} 页第 ${s.rec.shapeIndex} 块文字溢出:"${snippetOf(s.rec.text)}"——已缩字至 ${s.target}pt,复测失败,请手工确认`);
|
|
498
|
+
}
|
|
499
|
+
}
|
|
500
|
+
}
|
|
501
|
+
return { issues, warnings, degraded: false };
|
|
502
|
+
}
|
|
503
|
+
// ============================================================================
|
|
504
|
+
// 工具二:wps_ppt_build_deck(不进默认档;逐动作走 callTool 真入口,快照护栏照常)
|
|
505
|
+
// ============================================================================
|
|
506
|
+
exports.buildDeckDefinition = {
|
|
507
|
+
name: 'wps_ppt_build_deck',
|
|
508
|
+
description: `按 JSON 页面描述一次性生成整套演示文稿(deckkit 引擎)。
|
|
509
|
+
|
|
510
|
+
页面 kind(10 种):title / section / bullets / compare / imageText / table / chart / timeline / closing / quote。
|
|
511
|
+
- title: { heading, sub? } —— 渐变全页 + 大标题
|
|
512
|
+
- section: { ordinal, heading, tagline? } —— 章节隔页
|
|
513
|
+
- bullets: { heading, points[≤6] } —— 要点卡片(超出密度上限会拒绝,拆页)
|
|
514
|
+
- compare: { heading, left:{label,points[≤4]}, right:{...} } —— 两栏对比
|
|
515
|
+
- imageText: { heading, imagePath, points? } —— 左图右文
|
|
516
|
+
- table: { heading, head[], rows[≤6][][] } —— 矩形拼表格(真表格边框不可靠,引擎不走 AddTable)
|
|
517
|
+
- chart: { heading, categories[], series[{name,values}] } —— 插入图表并写入真数据(两段式)
|
|
518
|
+
- timeline: { heading, milestones[{label,note?}][≤6] } —— 时间轴
|
|
519
|
+
- closing: { heading, contact? } —— 结尾页
|
|
520
|
+
- quote: { quote, attribution? } —— 引文页
|
|
521
|
+
|
|
522
|
+
主题 theme(缺省 academic-blue):academic-blue 学术蓝(微软雅黑)/ gov-red 政务红(黑体+仿宋,边距加宽)/ business-gray 商务灰(雅黑,卡片间距加大)。配色与间距为自创数值,改前须真机复核。
|
|
523
|
+
|
|
524
|
+
行为:新建演示文稿 → 逐页铺排(每页从空白页起)→ 逐步骤走真工具入口(快照护栏照常)→
|
|
525
|
+
每页铺完自动量一遍文字溢出(BoundHeight 实际高度 vs 帧高):超框写 warnings 并自动缩字一档
|
|
526
|
+
(不低于正文字号下限)重排复测一次,仍超只警告不强改;量不了(读回通道不可用)如实降级记一条,不算失败。
|
|
527
|
+
任一步失败即停并如实报完成到第几页第几步——不静默续跑。`,
|
|
528
|
+
category: tools_1.ToolCategory.PRESENTATION,
|
|
529
|
+
inputSchema: {
|
|
530
|
+
type: 'object',
|
|
531
|
+
properties: {
|
|
532
|
+
deck: {
|
|
533
|
+
type: 'object',
|
|
534
|
+
description: '页面描述:{ slides: [ {kind:"title",heading,...}, {kind:"bullets",heading,points}, ... ] },kind 与字段见工具描述;slides 上限 30 页',
|
|
535
|
+
},
|
|
536
|
+
theme: {
|
|
537
|
+
type: 'string',
|
|
538
|
+
enum: ['academic-blue', 'gov-red', 'business-gray'],
|
|
539
|
+
description: '主题(缺省 academic-blue 学术蓝)',
|
|
540
|
+
},
|
|
541
|
+
},
|
|
542
|
+
required: ['deck'],
|
|
543
|
+
},
|
|
544
|
+
};
|
|
545
|
+
const buildDeckHandler = async (args) => {
|
|
546
|
+
const spec = args.deck;
|
|
547
|
+
const themeName = args.theme ?? exports.DEFAULT_THEME;
|
|
548
|
+
let pages;
|
|
549
|
+
try {
|
|
550
|
+
pages = expandDeck(spec, themeName);
|
|
551
|
+
}
|
|
552
|
+
catch (e) {
|
|
553
|
+
const msg = e instanceof Error ? e.message : String(e);
|
|
554
|
+
return {
|
|
555
|
+
id: (0, uuid_1.v4)(),
|
|
556
|
+
success: false,
|
|
557
|
+
content: [{ type: 'text', text: `deck 描述不合法:${msg}` }],
|
|
558
|
+
error: msg,
|
|
559
|
+
};
|
|
560
|
+
}
|
|
561
|
+
const total = pages.reduce((n, p) => n + p.length, 0) + pages.length; // 每页一次 add_slide
|
|
562
|
+
const failures = [];
|
|
563
|
+
const overflow = { checkedPages: 0, degraded: false, issues: [], warnings: [] };
|
|
564
|
+
let executed = 0;
|
|
565
|
+
let stoppedAtSlide = 0;
|
|
566
|
+
// 第一步:新建演示文稿(deck 是新建语义;追加到已有文稿归 render/编辑类工具)
|
|
567
|
+
const create = await tool_registry_1.toolRegistry.callTool({ id: (0, uuid_1.v4)(), name: 'wps_ppt_create_presentation', arguments: {} });
|
|
568
|
+
if (!create.success) {
|
|
569
|
+
const msg = create.content?.[0]?.text || 'create_presentation 失败';
|
|
570
|
+
return { id: (0, uuid_1.v4)(), success: false, content: [{ type: 'text', text: msg }], error: msg };
|
|
571
|
+
}
|
|
572
|
+
executed += 1;
|
|
573
|
+
for (let i = 0; i < pages.length; i++) {
|
|
574
|
+
stoppedAtSlide = i + 1;
|
|
575
|
+
// 每页先铺空白页(layout blank = 无占位符,形状计数从 0 起——展开器按此推 shapeIndex)
|
|
576
|
+
const add = await tool_registry_1.toolRegistry.callTool({ id: (0, uuid_1.v4)(), name: 'wps_ppt_add_slide', arguments: { layout: 'blank' } });
|
|
577
|
+
executed += 1;
|
|
578
|
+
if (!add.success) {
|
|
579
|
+
failures.push({ slide: i + 1, index: 0, tool: 'wps_ppt_add_slide', error: add.content?.[0]?.text || 'add_slide 失败' });
|
|
580
|
+
break;
|
|
581
|
+
}
|
|
582
|
+
let pageBroken = false;
|
|
583
|
+
for (let j = 0; j < pages[i].length; j++) {
|
|
584
|
+
const step = pages[i][j];
|
|
585
|
+
const r = await tool_registry_1.toolRegistry.callTool({ id: (0, uuid_1.v4)(), name: step.tool, arguments: step.args });
|
|
586
|
+
executed += 1;
|
|
587
|
+
if (!r.success) {
|
|
588
|
+
failures.push({ slide: i + 1, index: j, tool: step.tool, error: r.content?.[0]?.text || '步骤失败' });
|
|
589
|
+
pageBroken = true;
|
|
590
|
+
break;
|
|
591
|
+
}
|
|
592
|
+
}
|
|
593
|
+
if (pageBroken)
|
|
594
|
+
break; // fail-fast:如实报停在哪页哪步,不静默续跑
|
|
595
|
+
// E3:本页铺完且无失败 → 生成后溢出检查(量不了降级记一次,不算失败)
|
|
596
|
+
const chk = await checkPageOverflow(i + 1, pages[i]);
|
|
597
|
+
if (chk.degraded) {
|
|
598
|
+
if (!overflow.degraded) {
|
|
599
|
+
overflow.degraded = true;
|
|
600
|
+
overflow.warnings.push('溢出检查降级:读回通道缺度量能力(bound 字段缺失或读回失败),本轮未做生成后检查');
|
|
601
|
+
}
|
|
602
|
+
}
|
|
603
|
+
else {
|
|
604
|
+
overflow.checkedPages += 1;
|
|
605
|
+
overflow.issues.push(...chk.issues);
|
|
606
|
+
overflow.warnings.push(...chk.warnings);
|
|
607
|
+
}
|
|
608
|
+
}
|
|
609
|
+
const leftover = overflow.issues.filter((x) => !x.fixed).length;
|
|
610
|
+
const autoFixed = overflow.issues.filter((x) => x.fixed).length;
|
|
611
|
+
const overflowLine = overflow.degraded
|
|
612
|
+
? '溢出检查:降级未执行(读回通道不可用)。'
|
|
613
|
+
: `溢出检查:${overflow.checkedPages} 页已量,遗留 ${leftover} 处溢出${autoFixed ? `(另有 ${autoFixed} 处缩字自动修复)` : ''}。`;
|
|
614
|
+
const body = failures.length
|
|
615
|
+
? `生成中止:完成到第 ${stoppedAtSlide} 页(执行 ${executed}/${total} 步)。失败明细:${failures.map((f) => `第${f.slide}页#${f.index} ${f.tool}: ${f.error.slice(0, 80)}`).join(';')}`
|
|
616
|
+
: `已生成 ${pages.length} 页(共 ${total} 步)。${overflowLine}可用 wps_ppt_export_slide_as_image 逐页出图复核。`;
|
|
617
|
+
return {
|
|
618
|
+
id: (0, uuid_1.v4)(),
|
|
619
|
+
success: failures.length === 0,
|
|
620
|
+
content: [{
|
|
621
|
+
type: 'text',
|
|
622
|
+
text: body
|
|
623
|
+
+ (overflow.warnings.length ? '\nwarnings:\n- ' + overflow.warnings.join('\n- ') : '')
|
|
624
|
+
+ '\n' + JSON.stringify({ pages: deckSummary(pages), overflow: { checkedPages: overflow.checkedPages, degraded: overflow.degraded, warnings: overflow.warnings, issues: overflow.issues } }),
|
|
625
|
+
}],
|
|
626
|
+
...(failures.length ? { error: body } : {}),
|
|
627
|
+
};
|
|
628
|
+
};
|
|
629
|
+
exports.buildDeckHandler = buildDeckHandler;
|
|
630
|
+
exports.deckTools = [
|
|
631
|
+
{ definition: exports.buildDeckDefinition, handler: exports.buildDeckHandler },
|
|
632
|
+
{ definition: exports.getTextboxMetricsDefinition, handler: exports.getTextboxMetricsHandler },
|
|
633
|
+
];
|
|
634
|
+
exports.default = exports.deckTools;
|
|
635
|
+
//# sourceMappingURL=deckkit.js.map
|