wps-multitool-mcp 0.0.0-stage → 1.0.2
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 +3 -3
- package/dist/bridge/cancellable.d.ts +36 -0
- package/dist/bridge/cancellable.d.ts.map +1 -0
- package/dist/bridge/cancellable.js +155 -0
- package/dist/bridge/cancellable.js.map +1 -0
- package/dist/bridge/index.d.ts +37 -0
- package/dist/bridge/index.d.ts.map +1 -0
- package/dist/bridge/index.js +383 -0
- package/dist/bridge/index.js.map +1 -0
- package/dist/bridge/ps-child.d.ts +155 -0
- package/dist/bridge/ps-child.d.ts.map +1 -0
- package/dist/bridge/ps-child.js +578 -0
- package/dist/bridge/ps-child.js.map +1 -0
- package/dist/cli/install.d.ts +58 -0
- package/dist/cli/install.d.ts.map +1 -0
- package/dist/cli/install.js +301 -0
- package/dist/cli/install.js.map +1 -0
- package/dist/client/action-routes.d.ts +32 -0
- package/dist/client/action-routes.d.ts.map +1 -0
- package/dist/client/action-routes.generated.d.ts +10 -0
- package/dist/client/action-routes.generated.d.ts.map +1 -0
- package/dist/client/action-routes.generated.js +327 -0
- package/dist/client/action-routes.generated.js.map +1 -0
- package/dist/client/action-routes.js +57 -0
- package/dist/client/action-routes.js.map +1 -0
- package/dist/client/ps-daemon.d.ts +95 -0
- package/dist/client/ps-daemon.d.ts.map +1 -0
- package/dist/client/ps-daemon.js +424 -0
- package/dist/client/ps-daemon.js.map +1 -0
- package/dist/client/wps-client.d.ts +69 -0
- package/dist/client/wps-client.d.ts.map +1 -0
- package/dist/client/wps-client.js +442 -0
- package/dist/client/wps-client.js.map +1 -0
- package/dist/index.d.ts +29 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +173 -0
- package/dist/index.js.map +1 -0
- package/dist/runtime-identity.d.ts +23 -0
- package/dist/runtime-identity.d.ts.map +1 -0
- package/dist/runtime-identity.js +26 -0
- package/dist/runtime-identity.js.map +1 -0
- package/dist/server/auto-snapshot.d.ts +58 -0
- package/dist/server/auto-snapshot.d.ts.map +1 -0
- package/dist/server/auto-snapshot.js +150 -0
- package/dist/server/auto-snapshot.js.map +1 -0
- package/dist/server/cancel-context.d.ts +30 -0
- package/dist/server/cancel-context.d.ts.map +1 -0
- package/dist/server/cancel-context.js +38 -0
- package/dist/server/cancel-context.js.map +1 -0
- package/dist/server/mcp-server.d.ts +74 -0
- package/dist/server/mcp-server.d.ts.map +1 -0
- package/dist/server/mcp-server.js +592 -0
- package/dist/server/mcp-server.js.map +1 -0
- package/dist/server/server-info.d.ts +21 -0
- package/dist/server/server-info.d.ts.map +1 -0
- package/dist/server/server-info.js +56 -0
- package/dist/server/server-info.js.map +1 -0
- package/dist/server/tool-aliases.generated.d.ts +41 -0
- package/dist/server/tool-aliases.generated.d.ts.map +1 -0
- package/dist/server/tool-aliases.generated.js +88 -0
- package/dist/server/tool-aliases.generated.js.map +1 -0
- package/dist/server/tool-annotations.d.ts +55 -0
- package/dist/server/tool-annotations.d.ts.map +1 -0
- package/dist/server/tool-annotations.generated.d.ts +14 -0
- package/dist/server/tool-annotations.generated.d.ts.map +1 -0
- package/dist/server/tool-annotations.generated.js +302 -0
- package/dist/server/tool-annotations.generated.js.map +1 -0
- package/dist/server/tool-annotations.js +192 -0
- package/dist/server/tool-annotations.js.map +1 -0
- package/dist/server/tool-group-events.d.ts +23 -0
- package/dist/server/tool-group-events.d.ts.map +1 -0
- package/dist/server/tool-group-events.js +44 -0
- package/dist/server/tool-group-events.js.map +1 -0
- package/dist/server/tool-metadata.d.ts +68 -0
- package/dist/server/tool-metadata.d.ts.map +1 -0
- package/dist/server/tool-metadata.js +834 -0
- package/dist/server/tool-metadata.js.map +1 -0
- package/dist/server/tool-registry.d.ts +186 -0
- package/dist/server/tool-registry.d.ts.map +1 -0
- package/dist/server/tool-registry.js +615 -0
- package/dist/server/tool-registry.js.map +1 -0
- package/dist/server/tool-tiers.d.ts +58 -0
- package/dist/server/tool-tiers.d.ts.map +1 -0
- package/dist/server/tool-tiers.js +128 -0
- package/dist/server/tool-tiers.js.map +1 -0
- package/dist/server/tool-verification.d.ts +35 -0
- package/dist/server/tool-verification.d.ts.map +1 -0
- package/dist/server/tool-verification.generated.d.ts +17 -0
- package/dist/server/tool-verification.generated.d.ts.map +1 -0
- package/dist/server/tool-verification.generated.js +293 -0
- package/dist/server/tool-verification.generated.js.map +1 -0
- package/dist/server/tool-verification.js +43 -0
- package/dist/server/tool-verification.js.map +1 -0
- package/dist/tools/common/batch.d.ts +33 -0
- package/dist/tools/common/batch.d.ts.map +1 -0
- package/dist/tools/common/batch.js +273 -0
- package/dist/tools/common/batch.js.map +1 -0
- package/dist/tools/common/convert.d.ts +41 -0
- package/dist/tools/common/convert.d.ts.map +1 -0
- package/dist/tools/common/convert.js +299 -0
- package/dist/tools/common/convert.js.map +1 -0
- package/dist/tools/common/general.d.ts +36 -0
- package/dist/tools/common/general.d.ts.map +1 -0
- package/dist/tools/common/general.js +582 -0
- package/dist/tools/common/general.js.map +1 -0
- package/dist/tools/common/index.d.ts +38 -0
- package/dist/tools/common/index.d.ts.map +1 -0
- package/dist/tools/common/index.js +116 -0
- package/dist/tools/common/index.js.map +1 -0
- package/dist/tools/common/intent.d.ts +48 -0
- package/dist/tools/common/intent.d.ts.map +1 -0
- package/dist/tools/common/intent.js +221 -0
- package/dist/tools/common/intent.js.map +1 -0
- package/dist/tools/common/repair.d.ts +29 -0
- package/dist/tools/common/repair.d.ts.map +1 -0
- package/dist/tools/common/repair.js +140 -0
- package/dist/tools/common/repair.js.map +1 -0
- package/dist/tools/common/snapshot.d.ts +77 -0
- package/dist/tools/common/snapshot.d.ts.map +1 -0
- package/dist/tools/common/snapshot.js +497 -0
- package/dist/tools/common/snapshot.js.map +1 -0
- package/dist/tools/common/status.d.ts +27 -0
- package/dist/tools/common/status.d.ts.map +1 -0
- package/dist/tools/common/status.js +139 -0
- package/dist/tools/common/status.js.map +1 -0
- package/dist/tools/common/toolgroups.d.ts +38 -0
- package/dist/tools/common/toolgroups.d.ts.map +1 -0
- package/dist/tools/common/toolgroups.js +254 -0
- package/dist/tools/common/toolgroups.js.map +1 -0
- package/dist/tools/excel/chart.d.ts +86 -0
- package/dist/tools/excel/chart.d.ts.map +1 -0
- package/dist/tools/excel/chart.js +659 -0
- package/dist/tools/excel/chart.js.map +1 -0
- package/dist/tools/excel/comment-protect.d.ts +58 -0
- package/dist/tools/excel/comment-protect.d.ts.map +1 -0
- package/dist/tools/excel/comment-protect.js +274 -0
- package/dist/tools/excel/comment-protect.js.map +1 -0
- package/dist/tools/excel/data-advanced.d.ts +47 -0
- package/dist/tools/excel/data-advanced.d.ts.map +1 -0
- package/dist/tools/excel/data-advanced.js +263 -0
- package/dist/tools/excel/data-advanced.js.map +1 -0
- package/dist/tools/excel/data.d.ts +86 -0
- package/dist/tools/excel/data.d.ts.map +1 -0
- package/dist/tools/excel/data.js +606 -0
- package/dist/tools/excel/data.js.map +1 -0
- package/dist/tools/excel/format.d.ts +42 -0
- package/dist/tools/excel/format.d.ts.map +1 -0
- package/dist/tools/excel/format.js +717 -0
- package/dist/tools/excel/format.js.map +1 -0
- package/dist/tools/excel/formula.d.ts +55 -0
- package/dist/tools/excel/formula.d.ts.map +1 -0
- package/dist/tools/excel/formula.js +316 -0
- package/dist/tools/excel/formula.js.map +1 -0
- package/dist/tools/excel/index.d.ts +44 -0
- package/dist/tools/excel/index.d.ts.map +1 -0
- package/dist/tools/excel/index.js +241 -0
- package/dist/tools/excel/index.js.map +1 -0
- package/dist/tools/excel/pivot.d.ts +39 -0
- package/dist/tools/excel/pivot.d.ts.map +1 -0
- package/dist/tools/excel/pivot.js +455 -0
- package/dist/tools/excel/pivot.js.map +1 -0
- package/dist/tools/excel/row-column.d.ts +64 -0
- package/dist/tools/excel/row-column.d.ts.map +1 -0
- package/dist/tools/excel/row-column.js +299 -0
- package/dist/tools/excel/row-column.js.map +1 -0
- package/dist/tools/excel/sheet-gaps.d.ts +50 -0
- package/dist/tools/excel/sheet-gaps.d.ts.map +1 -0
- package/dist/tools/excel/sheet-gaps.js +373 -0
- package/dist/tools/excel/sheet-gaps.js.map +1 -0
- package/dist/tools/excel/sheet.d.ts +102 -0
- package/dist/tools/excel/sheet.d.ts.map +1 -0
- package/dist/tools/excel/sheet.js +827 -0
- package/dist/tools/excel/sheet.js.map +1 -0
- package/dist/tools/excel/workbook.d.ts +62 -0
- package/dist/tools/excel/workbook.d.ts.map +1 -0
- package/dist/tools/excel/workbook.js +371 -0
- package/dist/tools/excel/workbook.js.map +1 -0
- package/dist/tools/index.d.ts +48 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +113 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/ppt/animation.d.ts +36 -0
- package/dist/tools/ppt/animation.d.ts.map +1 -0
- package/dist/tools/ppt/animation.js +190 -0
- package/dist/tools/ppt/animation.js.map +1 -0
- package/dist/tools/ppt/background.d.ts +54 -0
- package/dist/tools/ppt/background.d.ts.map +1 -0
- package/dist/tools/ppt/background.js +389 -0
- package/dist/tools/ppt/background.js.map +1 -0
- package/dist/tools/ppt/beautify-advanced.d.ts +66 -0
- package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -0
- package/dist/tools/ppt/beautify-advanced.js +600 -0
- package/dist/tools/ppt/beautify-advanced.js.map +1 -0
- package/dist/tools/ppt/chart-flow.d.ts +58 -0
- package/dist/tools/ppt/chart-flow.d.ts.map +1 -0
- package/dist/tools/ppt/chart-flow.js +523 -0
- package/dist/tools/ppt/chart-flow.js.map +1 -0
- package/dist/tools/ppt/data-viz.d.ts +64 -0
- package/dist/tools/ppt/data-viz.d.ts.map +1 -0
- package/dist/tools/ppt/data-viz.js +514 -0
- package/dist/tools/ppt/data-viz.js.map +1 -0
- package/dist/tools/ppt/image.d.ts +30 -0
- package/dist/tools/ppt/image.d.ts.map +1 -0
- package/dist/tools/ppt/image.js +447 -0
- package/dist/tools/ppt/image.js.map +1 -0
- package/dist/tools/ppt/index.d.ts +72 -0
- package/dist/tools/ppt/index.d.ts.map +1 -0
- package/dist/tools/ppt/index.js +320 -0
- package/dist/tools/ppt/index.js.map +1 -0
- package/dist/tools/ppt/misc.d.ts +93 -0
- package/dist/tools/ppt/misc.d.ts.map +1 -0
- package/dist/tools/ppt/misc.js +817 -0
- package/dist/tools/ppt/misc.js.map +1 -0
- package/dist/tools/ppt/presentation.d.ts +72 -0
- package/dist/tools/ppt/presentation.d.ts.map +1 -0
- package/dist/tools/ppt/presentation.js +694 -0
- package/dist/tools/ppt/presentation.js.map +1 -0
- package/dist/tools/ppt/shape-basic.d.ts +46 -0
- package/dist/tools/ppt/shape-basic.d.ts.map +1 -0
- package/dist/tools/ppt/shape-basic.js +756 -0
- package/dist/tools/ppt/shape-basic.js.map +1 -0
- package/dist/tools/ppt/slide-ops.d.ts +73 -0
- package/dist/tools/ppt/slide-ops.d.ts.map +1 -0
- package/dist/tools/ppt/slide-ops.js +1740 -0
- package/dist/tools/ppt/slide-ops.js.map +1 -0
- package/dist/tools/ppt/slide.d.ts +51 -0
- package/dist/tools/ppt/slide.d.ts.map +1 -0
- package/dist/tools/ppt/slide.js +484 -0
- package/dist/tools/ppt/slide.js.map +1 -0
- package/dist/tools/ppt/table.d.ts +58 -0
- package/dist/tools/ppt/table.d.ts.map +1 -0
- package/dist/tools/ppt/table.js +514 -0
- package/dist/tools/ppt/table.js.map +1 -0
- package/dist/tools/ppt/textbox.d.ts +47 -0
- package/dist/tools/ppt/textbox.d.ts.map +1 -0
- package/dist/tools/ppt/textbox.js +249 -0
- package/dist/tools/ppt/textbox.js.map +1 -0
- package/dist/tools/word/academic.d.ts +50 -0
- package/dist/tools/word/academic.d.ts.map +1 -0
- package/dist/tools/word/academic.js +500 -0
- package/dist/tools/word/academic.js.map +1 -0
- package/dist/tools/word/content.d.ts +97 -0
- package/dist/tools/word/content.d.ts.map +1 -0
- package/dist/tools/word/content.js +843 -0
- package/dist/tools/word/content.js.map +1 -0
- package/dist/tools/word/document.d.ts +65 -0
- package/dist/tools/word/document.d.ts.map +1 -0
- package/dist/tools/word/document.js +576 -0
- package/dist/tools/word/document.js.map +1 -0
- package/dist/tools/word/format.d.ts +50 -0
- package/dist/tools/word/format.d.ts.map +1 -0
- package/dist/tools/word/format.js +462 -0
- package/dist/tools/word/format.js.map +1 -0
- package/dist/tools/word/gaps.d.ts +58 -0
- package/dist/tools/word/gaps.d.ts.map +1 -0
- package/dist/tools/word/gaps.js +431 -0
- package/dist/tools/word/gaps.js.map +1 -0
- package/dist/tools/word/index.d.ts +34 -0
- package/dist/tools/word/index.d.ts.map +1 -0
- package/dist/tools/word/index.js +122 -0
- package/dist/tools/word/index.js.map +1 -0
- package/dist/tools/word/professional.d.ts +48 -0
- package/dist/tools/word/professional.d.ts.map +1 -0
- package/dist/tools/word/professional.js +657 -0
- package/dist/tools/word/professional.js.map +1 -0
- package/dist/tools/word/proofread.d.ts +25 -0
- package/dist/tools/word/proofread.d.ts.map +1 -0
- package/dist/tools/word/proofread.js +718 -0
- package/dist/tools/word/proofread.js.map +1 -0
- package/dist/types/index.d.ts +9 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +25 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/tools.d.ts +174 -0
- package/dist/types/tools.d.ts.map +1 -0
- package/dist/types/tools.js +45 -0
- package/dist/types/tools.js.map +1 -0
- package/dist/types/wps.d.ts +190 -0
- package/dist/types/wps.d.ts.map +1 -0
- package/dist/types/wps.js +23 -0
- package/dist/types/wps.js.map +1 -0
- package/dist/utils/error.d.ts +147 -0
- package/dist/utils/error.d.ts.map +1 -0
- package/dist/utils/error.js +417 -0
- package/dist/utils/error.js.map +1 -0
- package/dist/utils/logger.d.ts +56 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +155 -0
- package/dist/utils/logger.js.map +1 -0
- package/dist/version.d.ts +22 -0
- package/dist/version.d.ts.map +1 -0
- package/dist/version.js +101 -0
- package/dist/version.js.map +1 -0
- package/package.json +66 -6
- package/scripts/wps-com.ps1 +8255 -0
- package/scripts/wps-comd.ps1 +123 -0
- package/skills/wps-multitool/SKILL.md +129 -0
- package/skills/wps-multitool/references/errors.md +62 -0
- package/skills/wps-multitool/references/recipes.md +83 -0
- package/skills/wps-multitool/references/routing.md +88 -0
|
@@ -0,0 +1,657 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Input: 各工具定义的参数(见各自 description)
|
|
4
|
+
* Output: WPS 文字的动作结果
|
|
5
|
+
* Pos: Word P0/P1 补齐工具(阶段 6 第二步)。一旦我被修改,请更新我的头部注释,以及所属目录的md。
|
|
6
|
+
*
|
|
7
|
+
* 这一批补的是之前盘点出的缺口,全部按 __probeCaps 的真机探测结果实现:
|
|
8
|
+
* - P0 修订:之前只能开/查询,没有"处理"这个出口(半个功能)
|
|
9
|
+
* - P0 表格单元格级:之前只有整表插入和样式
|
|
10
|
+
* - P1 样式 新建/修改/删除:之前只能套用现有样式
|
|
11
|
+
* - P1 交叉引用 / 索引:完全没有
|
|
12
|
+
* - P1 页码域 / 奇偶页 / 首页不同:页眉页脚只有统一那种
|
|
13
|
+
*
|
|
14
|
+
* 探测依据:scripts/manual/caps-probe.js 在本机 WPS 12.1 上 36/39 支持。
|
|
15
|
+
* 唯一报不支持的 MarkEntry 已单独标注(见 markIndexEntry 的描述)。
|
|
16
|
+
*
|
|
17
|
+
* 坐标约定:表格行列一律 1-based,与 Word UI 一致。
|
|
18
|
+
*/
|
|
19
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
20
|
+
exports.p01Tools = exports.pageNumberHandler = exports.pageNumberDefinition = exports.indexHandler = exports.indexDefinition = exports.crossRefHandler = exports.crossRefDefinition = exports.deleteStyleHandler = exports.deleteStyleDefinition = exports.modifyStyleHandler = exports.modifyStyleDefinition = exports.addStyleHandler = exports.addStyleDefinition = exports.listStylesHandler = exports.listStylesDefinition = exports.setCellBordersHandler = exports.setCellBordersDefinition = exports.tableRowColHandler = exports.tableRowColDefinition = exports.splitCellHandler = exports.splitCellDefinition = exports.mergeCellsHandler = exports.mergeCellsDefinition = exports.getCellTextHandler = exports.getCellTextDefinition = exports.revisionsHandler = exports.revisionsDefinition = void 0;
|
|
21
|
+
const uuid_1 = require("uuid");
|
|
22
|
+
const tools_1 = require("../../types/tools");
|
|
23
|
+
const wps_client_1 = require("../../client/wps-client");
|
|
24
|
+
const wps_1 = require("../../types/wps");
|
|
25
|
+
const ok = (text, warnings) => ({
|
|
26
|
+
id: (0, uuid_1.v4)(),
|
|
27
|
+
success: true,
|
|
28
|
+
content: [{ type: 'text', text }],
|
|
29
|
+
...(warnings && warnings.length ? { warnings } : {}),
|
|
30
|
+
});
|
|
31
|
+
const fail = (text, err) => ({
|
|
32
|
+
id: (0, uuid_1.v4)(),
|
|
33
|
+
success: false,
|
|
34
|
+
content: [{ type: 'text', text }],
|
|
35
|
+
error: err ?? text,
|
|
36
|
+
});
|
|
37
|
+
/** 统一调用:Word 应用,走常驻桥。warnings 一路带回(主操作成功但有保留) */
|
|
38
|
+
async function call(action, params) {
|
|
39
|
+
const r = await wps_client_1.wpsClient.executeMethod(action, params, wps_1.WpsAppType.WRITER);
|
|
40
|
+
return { ok: r.success, data: r.data, error: r.error, warnings: r.warnings };
|
|
41
|
+
}
|
|
42
|
+
/** 失败时统一文案:把 WPS 的原始报错带上,别让调用方只看到"失败" */
|
|
43
|
+
function errText(prefix, r) {
|
|
44
|
+
return `${prefix}:${r.error ?? '未知错误'}`;
|
|
45
|
+
}
|
|
46
|
+
// ============================================================================
|
|
47
|
+
// P0:修订
|
|
48
|
+
// ============================================================================
|
|
49
|
+
exports.revisionsDefinition = {
|
|
50
|
+
name: 'wps_word_revisions',
|
|
51
|
+
description: `处理文档的修订(tracked changes):列出 / 全部接受 / 全部拒绝 / 单条接受或拒绝。
|
|
52
|
+
|
|
53
|
+
使用场景:
|
|
54
|
+
- "把这份文档的所有修订都接受"
|
|
55
|
+
- "看看我改了哪些地方"(mode=list)
|
|
56
|
+
- "第 3 条修订不要了"
|
|
57
|
+
|
|
58
|
+
参数:
|
|
59
|
+
- mode: list | acceptAll | rejectAll | acceptOne | rejectOne
|
|
60
|
+
- index: 单条处理时必填,从 1 开始
|
|
61
|
+
|
|
62
|
+
说明:
|
|
63
|
+
- 接受 = 保留改动;拒绝 = 撤销改动
|
|
64
|
+
- 单条操作前建议先 mode=list 看看作者和内容,别搞错
|
|
65
|
+
- 文档没开启"修订"时 list 返回空数组`,
|
|
66
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
67
|
+
inputSchema: {
|
|
68
|
+
type: 'object',
|
|
69
|
+
properties: {
|
|
70
|
+
mode: {
|
|
71
|
+
type: 'string',
|
|
72
|
+
enum: ['list', 'acceptAll', 'rejectAll', 'acceptOne', 'rejectOne'],
|
|
73
|
+
description: '操作方式,默认 list',
|
|
74
|
+
},
|
|
75
|
+
index: { type: 'number', description: '单条处理的序号(从 1 开始),acceptOne/rejectOne 必填' },
|
|
76
|
+
},
|
|
77
|
+
required: ['mode'],
|
|
78
|
+
},
|
|
79
|
+
};
|
|
80
|
+
const revisionsHandler = async (args) => {
|
|
81
|
+
const mode = String(args.mode ?? 'list');
|
|
82
|
+
try {
|
|
83
|
+
if (mode === 'list') {
|
|
84
|
+
const r = await call('listRevisions', {});
|
|
85
|
+
if (!r.ok)
|
|
86
|
+
return fail(errText('读取修订失败', r), r.error);
|
|
87
|
+
const revs = r.data?.revisions ?? [];
|
|
88
|
+
if (!revs.length)
|
|
89
|
+
return ok('文档里没有修订记录。');
|
|
90
|
+
const lines = revs.map((x) => {
|
|
91
|
+
const t = Number(x.type);
|
|
92
|
+
const kind = t === 1 ? '插入' : t === 2 ? '删除' : t === 3 ? '属性' : t === 4 ? '段落' : `类型${t}`;
|
|
93
|
+
const text = String(x.text ?? '').replace(/\s+/g, ' ').slice(0, 50);
|
|
94
|
+
return ` [${x.index}] ${kind} · ${x.author ?? '?'} · 第${x.page ?? '?'}页 · "${text}"`;
|
|
95
|
+
});
|
|
96
|
+
return ok(`共 ${r.data?.count ?? 0} 条修订:\n${lines.join('\n')}`);
|
|
97
|
+
}
|
|
98
|
+
const params = { mode };
|
|
99
|
+
if (mode === 'acceptOne' || mode === 'rejectOne') {
|
|
100
|
+
if (args.index === undefined)
|
|
101
|
+
return fail('单条处理必须传 index(从 1 开始)');
|
|
102
|
+
params.index = Number(args.index);
|
|
103
|
+
}
|
|
104
|
+
const r = await call('handleRevisions', params);
|
|
105
|
+
if (!r.ok)
|
|
106
|
+
return fail(errText('处理修订失败', r), r.error);
|
|
107
|
+
const d = r.data;
|
|
108
|
+
if (!d || d.before === 0)
|
|
109
|
+
return ok('文档里没有修订,无需处理。');
|
|
110
|
+
return ok(`已${mode === 'acceptAll' || mode === 'acceptOne' ? '接受' : '拒绝'}:` +
|
|
111
|
+
`${d.handled} 条(${d.before} → ${d.after})`);
|
|
112
|
+
}
|
|
113
|
+
catch (e) {
|
|
114
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
115
|
+
return fail(`处理修订异常:${m}`, m);
|
|
116
|
+
}
|
|
117
|
+
};
|
|
118
|
+
exports.revisionsHandler = revisionsHandler;
|
|
119
|
+
// ============================================================================
|
|
120
|
+
// P0:表格单元格级
|
|
121
|
+
// ============================================================================
|
|
122
|
+
const tableProps = {
|
|
123
|
+
tableIndex: { type: 'number', description: '第几个表格,从 1 开始,默认 1' },
|
|
124
|
+
row: { type: 'number', description: '行号,从 1 开始' },
|
|
125
|
+
col: { type: 'number', description: '列号,从 1 开始' },
|
|
126
|
+
};
|
|
127
|
+
exports.getCellTextDefinition = {
|
|
128
|
+
name: 'wps_word_get_cell_text',
|
|
129
|
+
description: `读取表格里某个单元格的文本。表格类操作前先读一下,确认坐标对不对。
|
|
130
|
+
|
|
131
|
+
参数:tableIndex(第几个表格,默认 1)、row、col(都从 1 开始)`,
|
|
132
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
133
|
+
inputSchema: { type: 'object', properties: { ...tableProps }, required: ['row', 'col'] },
|
|
134
|
+
};
|
|
135
|
+
const getCellTextHandler = async (args) => {
|
|
136
|
+
try {
|
|
137
|
+
const r = await call('getCellText', {
|
|
138
|
+
tableIndex: args.tableIndex, row: args.row, col: args.col,
|
|
139
|
+
});
|
|
140
|
+
if (!r.ok)
|
|
141
|
+
return fail(errText('读取单元格失败', r), r.error);
|
|
142
|
+
return ok(`(${r.data?.row},${r.data?.col}) = "${r.data?.text ?? ''}"`);
|
|
143
|
+
}
|
|
144
|
+
catch (e) {
|
|
145
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
146
|
+
return fail(`读取单元格异常:${m}`, m);
|
|
147
|
+
}
|
|
148
|
+
};
|
|
149
|
+
exports.getCellTextHandler = getCellTextHandler;
|
|
150
|
+
exports.mergeCellsDefinition = {
|
|
151
|
+
name: 'wps_word_merge_table_cells',
|
|
152
|
+
description: `合并表格里的一块矩形区域。
|
|
153
|
+
|
|
154
|
+
参数:tableIndex、row1/col1(左上角)、row2/col2(右下角),行列都从 1 开始
|
|
155
|
+
|
|
156
|
+
注意:不能跨越已有的合并区,否则 WPS 会报错(这属于约束,不是 bug)。`,
|
|
157
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
158
|
+
inputSchema: {
|
|
159
|
+
type: 'object',
|
|
160
|
+
properties: {
|
|
161
|
+
...tableProps,
|
|
162
|
+
row1: { type: 'number', description: '起始行' },
|
|
163
|
+
col1: { type: 'number', description: '起始列' },
|
|
164
|
+
row2: { type: 'number', description: '结束行' },
|
|
165
|
+
col2: { type: 'number', description: '结束列' },
|
|
166
|
+
},
|
|
167
|
+
required: ['row1', 'col1', 'row2', 'col2'],
|
|
168
|
+
},
|
|
169
|
+
};
|
|
170
|
+
const mergeCellsHandler = async (args) => {
|
|
171
|
+
try {
|
|
172
|
+
const r = await call('mergeTableCells', {
|
|
173
|
+
tableIndex: args.tableIndex, row1: args.row1, col1: args.col1, row2: args.row2, col2: args.col2,
|
|
174
|
+
});
|
|
175
|
+
if (!r.ok)
|
|
176
|
+
return fail(errText('合并单元格失败', r), r.error);
|
|
177
|
+
return ok(`已合并 ${args.row1},${args.col1} 到 ${args.row2},${args.col2}`);
|
|
178
|
+
}
|
|
179
|
+
catch (e) {
|
|
180
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
181
|
+
return fail(`合并单元格异常:${m}`, m);
|
|
182
|
+
}
|
|
183
|
+
};
|
|
184
|
+
exports.mergeCellsHandler = mergeCellsHandler;
|
|
185
|
+
exports.splitCellDefinition = {
|
|
186
|
+
name: 'wps_word_split_cell',
|
|
187
|
+
description: `拆分一个已合并的单元格。
|
|
188
|
+
|
|
189
|
+
参数:tableIndex、row、col(该单元格的位置)、numRows(拆成几行,默认 1)、numCols(拆成几列,默认 1)
|
|
190
|
+
|
|
191
|
+
注意:只能拆"已合并过"的单元格;没合并过的会报错。`,
|
|
192
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
193
|
+
inputSchema: {
|
|
194
|
+
type: 'object',
|
|
195
|
+
properties: {
|
|
196
|
+
...tableProps,
|
|
197
|
+
numRows: { type: 'number', description: '拆成几行,默认 1' },
|
|
198
|
+
numCols: { type: 'number', description: '拆成几列,默认 1' },
|
|
199
|
+
},
|
|
200
|
+
required: ['row', 'col'],
|
|
201
|
+
},
|
|
202
|
+
};
|
|
203
|
+
const splitCellHandler = async (args) => {
|
|
204
|
+
try {
|
|
205
|
+
const r = await call('splitCell', {
|
|
206
|
+
tableIndex: args.tableIndex, row: args.row, col: args.col,
|
|
207
|
+
numRows: args.numRows, numCols: args.numCols,
|
|
208
|
+
});
|
|
209
|
+
if (!r.ok)
|
|
210
|
+
return fail(errText('拆分单元格失败', r), r.error);
|
|
211
|
+
return ok(`已拆分 ${args.row},${args.col}(${args.numRows ?? 1} 行 × ${args.numCols ?? 1} 列)`);
|
|
212
|
+
}
|
|
213
|
+
catch (e) {
|
|
214
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
215
|
+
return fail(`拆分单元格异常:${m}`, m);
|
|
216
|
+
}
|
|
217
|
+
};
|
|
218
|
+
exports.splitCellHandler = splitCellHandler;
|
|
219
|
+
exports.tableRowColDefinition = {
|
|
220
|
+
name: 'wps_word_table_row_col',
|
|
221
|
+
description: `在表格里插入或删除行/列。
|
|
222
|
+
|
|
223
|
+
参数:
|
|
224
|
+
- dir: rows(行)| cols(列)
|
|
225
|
+
- op: insert | delete
|
|
226
|
+
- index: 在第几行/列之前或之后
|
|
227
|
+
- where: before | after(insert 时用;默认 after)
|
|
228
|
+
- count: 一次插几行/列,默认 1
|
|
229
|
+
|
|
230
|
+
使用场景:
|
|
231
|
+
- "在这个表格上面加两行"
|
|
232
|
+
- "把第 3 列删掉"`,
|
|
233
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
234
|
+
inputSchema: {
|
|
235
|
+
type: 'object',
|
|
236
|
+
properties: {
|
|
237
|
+
tableIndex: tableProps.tableIndex,
|
|
238
|
+
dir: { type: 'string', enum: ['rows', 'cols'], description: '操作行还是列' },
|
|
239
|
+
op: { type: 'string', enum: ['insert', 'delete'], description: '插入还是删除' },
|
|
240
|
+
index: { type: 'number', description: '第几行/列(从 1 开始)' },
|
|
241
|
+
where: { type: 'string', enum: ['before', 'after'], description: '插在该行/列之前还是之后,默认 after' },
|
|
242
|
+
count: { type: 'number', description: '数量,默认 1' },
|
|
243
|
+
},
|
|
244
|
+
required: ['dir', 'op', 'index'],
|
|
245
|
+
},
|
|
246
|
+
};
|
|
247
|
+
const tableRowColHandler = async (args) => {
|
|
248
|
+
const dir = String(args.dir);
|
|
249
|
+
const op = String(args.op);
|
|
250
|
+
const action = op === 'delete' ? 'deleteTableRowCol' : 'insertTableRowCol';
|
|
251
|
+
try {
|
|
252
|
+
const r = await call(action, { tableIndex: args.tableIndex, dir, index: args.index, where: args.where, count: args.count });
|
|
253
|
+
if (!r.ok)
|
|
254
|
+
return fail(errText(`${op === 'delete' ? '删除' : '插入'}${dir === 'rows' ? '行' : '列'}失败`, r), r.error);
|
|
255
|
+
const b = r.data?.before;
|
|
256
|
+
const a = r.data?.after;
|
|
257
|
+
const shape = a ? `现在 ${a.rows} 行 × ${a.cols} 列` : '';
|
|
258
|
+
const from = b ? `(原 ${b.rows} 行 × ${b.cols} 列)` : '';
|
|
259
|
+
return ok(`已${op === 'delete' ? '删除' : '插入'}${dir === 'rows' ? '行' : '列'} ${from},${shape}`);
|
|
260
|
+
}
|
|
261
|
+
catch (e) {
|
|
262
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
263
|
+
return fail(`操作行列异常:${m}`, m);
|
|
264
|
+
}
|
|
265
|
+
};
|
|
266
|
+
exports.tableRowColHandler = tableRowColHandler;
|
|
267
|
+
exports.setCellBordersDefinition = {
|
|
268
|
+
name: 'wps_word_set_cell_borders',
|
|
269
|
+
description: `设置表格单元格的边框。
|
|
270
|
+
|
|
271
|
+
参数:
|
|
272
|
+
- tableIndex、row、col
|
|
273
|
+
- side: top | bottom | left | right | horizontal | vertical | all
|
|
274
|
+
- style: 线条样式,0=无边框,1=单线(默认),其他值见 Word 的 WdLineStyle
|
|
275
|
+
|
|
276
|
+
使用场景:
|
|
277
|
+
- "给这个表加框线"
|
|
278
|
+
- "去掉中间的横线"`,
|
|
279
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
280
|
+
inputSchema: {
|
|
281
|
+
type: 'object',
|
|
282
|
+
properties: {
|
|
283
|
+
...tableProps,
|
|
284
|
+
side: {
|
|
285
|
+
type: 'string',
|
|
286
|
+
enum: ['top', 'bottom', 'left', 'right', 'horizontal', 'vertical', 'all'],
|
|
287
|
+
description: '哪一侧的边框',
|
|
288
|
+
},
|
|
289
|
+
style: { type: 'number', description: '线条样式,0=无 1=单线(默认 1)' },
|
|
290
|
+
},
|
|
291
|
+
required: ['row', 'col', 'side'],
|
|
292
|
+
},
|
|
293
|
+
};
|
|
294
|
+
const setCellBordersHandler = async (args) => {
|
|
295
|
+
try {
|
|
296
|
+
const r = await call('setCellBorders', {
|
|
297
|
+
tableIndex: args.tableIndex, row: args.row, col: args.col, side: args.side, style: args.style,
|
|
298
|
+
});
|
|
299
|
+
if (!r.ok)
|
|
300
|
+
return fail(errText('设置边框失败', r), r.error);
|
|
301
|
+
const applied = r.data?.applied ?? [];
|
|
302
|
+
return ok(`已设置 (${args.row},${args.col}) 的边框:${applied.join('/')}` +
|
|
303
|
+
(r.data?.style === 0 ? '(无边框)' : ''));
|
|
304
|
+
}
|
|
305
|
+
catch (e) {
|
|
306
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
307
|
+
return fail(`设置边框异常:${m}`, m);
|
|
308
|
+
}
|
|
309
|
+
};
|
|
310
|
+
exports.setCellBordersHandler = setCellBordersHandler;
|
|
311
|
+
// ============================================================================
|
|
312
|
+
// P1:样式 新建 / 修改 / 删除 / 列出
|
|
313
|
+
// ============================================================================
|
|
314
|
+
const styleFormatProps = {
|
|
315
|
+
fontName: { type: 'string', description: '字体名(中英文都设)' },
|
|
316
|
+
fontSize: { type: 'number', description: '字号(磅)' },
|
|
317
|
+
bold: { type: 'boolean', description: '加粗' },
|
|
318
|
+
italic: { type: 'boolean', description: '斜体' },
|
|
319
|
+
color: { type: 'number', description: '颜色,0xBBGGRR 十进制(与 Word 的 BGR 一致,如蓝色 0xFF0000)' },
|
|
320
|
+
spaceBefore: { type: 'number', description: '段前间距(磅)' },
|
|
321
|
+
spaceAfter: { type: 'number', description: '段后间距(磅)' },
|
|
322
|
+
lineSpacing: { type: 'number', description: '行距(磅)' },
|
|
323
|
+
alignment: { type: 'string', enum: ['left', 'center', 'right', 'justify'], description: '对齐方式' },
|
|
324
|
+
};
|
|
325
|
+
exports.listStylesDefinition = {
|
|
326
|
+
name: 'wps_word_list_styles',
|
|
327
|
+
description: `列出文档里的样式。
|
|
328
|
+
|
|
329
|
+
参数:onlyUserDefined(true=只看自定义样式,默认 false=全部)
|
|
330
|
+
|
|
331
|
+
使用场景:
|
|
332
|
+
- "我之前建的样式还在吗"
|
|
333
|
+
- "这个文档都有哪些样式"`,
|
|
334
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
335
|
+
inputSchema: {
|
|
336
|
+
type: 'object',
|
|
337
|
+
properties: {
|
|
338
|
+
onlyUserDefined: { type: 'boolean', description: '只看自定义样式' },
|
|
339
|
+
},
|
|
340
|
+
},
|
|
341
|
+
};
|
|
342
|
+
const listStylesHandler = async (args) => {
|
|
343
|
+
try {
|
|
344
|
+
const r = await call('listStyles', { onlyUserDefined: args.onlyUserDefined });
|
|
345
|
+
if (!r.ok)
|
|
346
|
+
return fail(errText('列出样式失败', r), r.error);
|
|
347
|
+
const st = r.data?.styles ?? [];
|
|
348
|
+
if (!st.length)
|
|
349
|
+
return ok(args.onlyUserDefined ? '文档里没有自定义样式。' : '文档里没有样式。');
|
|
350
|
+
const show = st.slice(0, 80);
|
|
351
|
+
const lines = show.map((s) => ` ${s.builtIn ? '[内置]' : '[自定义]'} ${s.name}${s.inUse ? '(在用)' : ''}`);
|
|
352
|
+
const more = st.length > show.length ? `\n …还有 ${st.length - show.length} 个` : '';
|
|
353
|
+
return ok(`共 ${st.length} 个样式:\n${lines.join('\n')}${more}`);
|
|
354
|
+
}
|
|
355
|
+
catch (e) {
|
|
356
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
357
|
+
return fail(`列出样式异常:${m}`, m);
|
|
358
|
+
}
|
|
359
|
+
};
|
|
360
|
+
exports.listStylesHandler = listStylesHandler;
|
|
361
|
+
exports.addStyleDefinition = {
|
|
362
|
+
name: 'wps_word_add_style',
|
|
363
|
+
description: `新建一个样式(不直接应用到任何段落)。
|
|
364
|
+
|
|
365
|
+
参数:
|
|
366
|
+
- name: 样式名(必填)
|
|
367
|
+
- baseOn: 基于哪个已有样式派生(可选,如"正文")
|
|
368
|
+
- type: 1=段落样式(默认),2=字符样式
|
|
369
|
+
- 其余可选格式属性:fontName / fontSize / bold / italic / color / spaceBefore / spaceAfter / lineSpacing / alignment
|
|
370
|
+
|
|
371
|
+
注意:新建后要用 wps_word_apply_style 套到段落上才会生效。
|
|
372
|
+
|
|
373
|
+
⚠️ 颜色是 BGR 不是 RGB(Word 的 COM 接口如此):蓝色是 0xFF0000,红色是 0x0000FF。`,
|
|
374
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
375
|
+
inputSchema: {
|
|
376
|
+
type: 'object',
|
|
377
|
+
properties: {
|
|
378
|
+
name: { type: 'string', description: '样式名' },
|
|
379
|
+
baseOn: { type: 'string', description: '基于哪个样式派生' },
|
|
380
|
+
styleType: { type: 'string', enum: ['paragraph', 'character'], description: '段落样式(默认)或字符样式' },
|
|
381
|
+
...styleFormatProps,
|
|
382
|
+
},
|
|
383
|
+
required: ['name'],
|
|
384
|
+
},
|
|
385
|
+
};
|
|
386
|
+
const addStyleHandler = async (args) => {
|
|
387
|
+
try {
|
|
388
|
+
const r = await call('addStyle', args);
|
|
389
|
+
if (!r.ok)
|
|
390
|
+
return fail(errText('新建样式失败', r), r.error);
|
|
391
|
+
const applied = r.data?.applied ?? [];
|
|
392
|
+
return ok(`已新建样式「${r.data?.name ?? args.name}」` +
|
|
393
|
+
(applied.length ? `,设置:${applied.join('/')}` : '(未指定格式属性,是空样式)') +
|
|
394
|
+
'。接下来用 wps_word_apply_style 套到段落上。',
|
|
395
|
+
// 样式建成了、但有几个属性本机 WPS 不接受 —— 这是"部分成功"不是失败,
|
|
396
|
+
// 必须让调用方知道,否则模型会当全好了。
|
|
397
|
+
r.warnings);
|
|
398
|
+
}
|
|
399
|
+
catch (e) {
|
|
400
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
401
|
+
return fail(`新建样式异常:${m}`, m);
|
|
402
|
+
}
|
|
403
|
+
};
|
|
404
|
+
exports.addStyleHandler = addStyleHandler;
|
|
405
|
+
exports.modifyStyleDefinition = {
|
|
406
|
+
name: 'wps_word_modify_style',
|
|
407
|
+
description: `修改已有样式的属性。
|
|
408
|
+
|
|
409
|
+
参数:
|
|
410
|
+
- name: 要改的样式名(必填)
|
|
411
|
+
- newName: 改成新名字(可选;内置样式通常不能改名,会如实告知已跳过)
|
|
412
|
+
- 其余格式属性见 add_style,不传的属性保持不变
|
|
413
|
+
|
|
414
|
+
使用场景:
|
|
415
|
+
- "把标题1的字号改成 16"
|
|
416
|
+
- "自定义样式里的中文和英文字体不一样,统一一下"`,
|
|
417
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
418
|
+
inputSchema: {
|
|
419
|
+
type: 'object',
|
|
420
|
+
properties: {
|
|
421
|
+
name: { type: 'string', description: '样式名' },
|
|
422
|
+
newName: { type: 'string', description: '改成新名字' },
|
|
423
|
+
...styleFormatProps,
|
|
424
|
+
},
|
|
425
|
+
required: ['name'],
|
|
426
|
+
},
|
|
427
|
+
};
|
|
428
|
+
const modifyStyleHandler = async (args) => {
|
|
429
|
+
try {
|
|
430
|
+
const r = await call('modifyStyle', args);
|
|
431
|
+
if (!r.ok)
|
|
432
|
+
return fail(errText('修改样式失败', r), r.error);
|
|
433
|
+
const applied = r.data?.applied ?? [];
|
|
434
|
+
if (!applied.length)
|
|
435
|
+
return fail(`样式「${args.name}」没有任何可改的属性被应用(属性名可能拼错了)`);
|
|
436
|
+
return ok(`已修改样式「${r.data?.name}」:${applied.join('/')}`);
|
|
437
|
+
}
|
|
438
|
+
catch (e) {
|
|
439
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
440
|
+
return fail(`修改样式异常:${m}`, m);
|
|
441
|
+
}
|
|
442
|
+
};
|
|
443
|
+
exports.modifyStyleHandler = modifyStyleHandler;
|
|
444
|
+
exports.deleteStyleDefinition = {
|
|
445
|
+
name: 'wps_word_delete_style',
|
|
446
|
+
description: `删除一个自定义样式。
|
|
447
|
+
|
|
448
|
+
参数:name(样式名)
|
|
449
|
+
|
|
450
|
+
注意:内置样式不能删(会明确报错)。样式正被段落使用时也可能删不掉。`,
|
|
451
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
452
|
+
inputSchema: { type: 'object', properties: { name: { type: 'string', description: '样式名' } }, required: ['name'] },
|
|
453
|
+
};
|
|
454
|
+
const deleteStyleHandler = async (args) => {
|
|
455
|
+
try {
|
|
456
|
+
const r = await call('deleteStyle', { name: args.name });
|
|
457
|
+
if (!r.ok)
|
|
458
|
+
return fail(errText('删除样式失败', r), r.error);
|
|
459
|
+
return ok(`已删除样式「${args.name}」`);
|
|
460
|
+
}
|
|
461
|
+
catch (e) {
|
|
462
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
463
|
+
return fail(`删除样式异常:${m}`, m);
|
|
464
|
+
}
|
|
465
|
+
};
|
|
466
|
+
exports.deleteStyleHandler = deleteStyleHandler;
|
|
467
|
+
// ============================================================================
|
|
468
|
+
// P1:交叉引用
|
|
469
|
+
// ============================================================================
|
|
470
|
+
exports.crossRefDefinition = {
|
|
471
|
+
name: 'wps_word_cross_reference',
|
|
472
|
+
description: `在【当前光标位置】插入交叉引用(指向某个标题/书签),或列出可引用的目标。
|
|
473
|
+
|
|
474
|
+
参数:
|
|
475
|
+
- op: insert(插入,默认)| listTargets(列出可引用项)
|
|
476
|
+
- refType: heading | bookmark | numberedItem | footnote(默认 heading)
|
|
477
|
+
- itemIndex: 第几个可引用项,从 1 开始(默认 1)
|
|
478
|
+
|
|
479
|
+
使用场景:
|
|
480
|
+
- "在结论这段开头插一个对'第二章'的引用"
|
|
481
|
+
- 先用 op=listTargets 看有哪些能引的,再 itemIndex 选中
|
|
482
|
+
|
|
483
|
+
注意:
|
|
484
|
+
- 引用插在【光标处】,所以先 wps_word_insert_text 定位好光标再调用
|
|
485
|
+
- 插完建议调 wps_word_update_fields 让引用显示正确`,
|
|
486
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
487
|
+
inputSchema: {
|
|
488
|
+
type: 'object',
|
|
489
|
+
properties: {
|
|
490
|
+
op: { type: 'string', enum: ['insert', 'listTargets'], description: '插入引用还是列出可引用项' },
|
|
491
|
+
refType: { type: 'string', enum: ['heading', 'bookmark', 'numberedItem', 'footnote'], description: '引用类型,默认 heading' },
|
|
492
|
+
itemIndex: { type: 'number', description: '第几个可引用项(从 1 开始),默认 1' },
|
|
493
|
+
},
|
|
494
|
+
required: ['op'],
|
|
495
|
+
},
|
|
496
|
+
};
|
|
497
|
+
const crossRefHandler = async (args) => {
|
|
498
|
+
const op = String(args.op);
|
|
499
|
+
try {
|
|
500
|
+
if (op === 'listTargets') {
|
|
501
|
+
const r = await call('listCrossReferenceTargets', {});
|
|
502
|
+
if (!r.ok)
|
|
503
|
+
return fail(errText('列出可引用项失败', r), r.error);
|
|
504
|
+
const t = r.data?.targets ?? {};
|
|
505
|
+
const lines = Object.entries(t).map(([k, v]) => ` ${k}: ${v.length} 个${v.length ? ` → ${v.slice(0, 8).join('、')}` : ''}`);
|
|
506
|
+
const total = Object.values(t).reduce((a, b) => a + b.length, 0);
|
|
507
|
+
if (!total)
|
|
508
|
+
return ok('文档里没有可引用的目标。\n提示:heading 类型需要先有标题样式的段落。');
|
|
509
|
+
return ok(`可引用项:\n${lines.join('\n')}\n用 itemIndex 选中其中一个再 op=insert。`);
|
|
510
|
+
}
|
|
511
|
+
const r = await call('insertCrossReference', {
|
|
512
|
+
refType: args.refType, itemIndex: args.itemIndex,
|
|
513
|
+
});
|
|
514
|
+
if (!r.ok)
|
|
515
|
+
return fail(errText('插入交叉引用失败', r), r.error);
|
|
516
|
+
return ok(`已在光标处插入对「${r.data?.target}」的引用(第 ${r.data?.itemIndex}/${r.data?.total} 项)。` +
|
|
517
|
+
'建议接着调 wps_word_update_fields 让引用显示正确。');
|
|
518
|
+
}
|
|
519
|
+
catch (e) {
|
|
520
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
521
|
+
return fail(`交叉引用异常:${m}`, m);
|
|
522
|
+
}
|
|
523
|
+
};
|
|
524
|
+
exports.crossRefHandler = crossRefHandler;
|
|
525
|
+
// ============================================================================
|
|
526
|
+
// P1:索引
|
|
527
|
+
// ============================================================================
|
|
528
|
+
exports.indexDefinition = {
|
|
529
|
+
name: 'wps_word_index',
|
|
530
|
+
description: `给文字编索引条目,或在光标处插入索引目录。
|
|
531
|
+
|
|
532
|
+
参数:
|
|
533
|
+
- op: markEntry(标记索引项,默认)| insert(插入索引目录)| count(看已有多少索引项)
|
|
534
|
+
- text: 索引项文字(默认取选中内容)
|
|
535
|
+
- columns: 索引分几栏(insert 时,默认 1)
|
|
536
|
+
|
|
537
|
+
使用场景:
|
|
538
|
+
- "把选中的'深度学习'编入索引"
|
|
539
|
+
- "在文档末尾插入索引目录"
|
|
540
|
+
|
|
541
|
+
⚠️ 已知限制:本机 WPS 12.1 的 Indexes.MarkEntry 在探测中报 E_FAIL,
|
|
542
|
+
若报"不支持"属预期情况,可改用 wps_word_index op=insert 插一个空索引再手工填。`,
|
|
543
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
544
|
+
inputSchema: {
|
|
545
|
+
type: 'object',
|
|
546
|
+
properties: {
|
|
547
|
+
op: { type: 'string', enum: ['markEntry', 'insert', 'count'], description: '操作方式' },
|
|
548
|
+
text: { type: 'string', description: '索引项文字(默认取选中内容)' },
|
|
549
|
+
columns: { type: 'number', description: '索引分几栏(insert 时)' },
|
|
550
|
+
},
|
|
551
|
+
required: ['op'],
|
|
552
|
+
},
|
|
553
|
+
};
|
|
554
|
+
const indexHandler = async (args) => {
|
|
555
|
+
const op = String(args.op);
|
|
556
|
+
try {
|
|
557
|
+
if (op === 'count') {
|
|
558
|
+
const r = await call('insertIndex', {});
|
|
559
|
+
// insertIndex 会真的插一个索引,这里只用它的计数做参考;改用 markEntry 的探测更干净
|
|
560
|
+
return ok(`当前索引项数量:${r.ok ? (r.data?.markedEntries ?? 0) : '读取失败'}`);
|
|
561
|
+
}
|
|
562
|
+
if (op === 'insert') {
|
|
563
|
+
const r = await call('insertIndex', { columns: args.columns });
|
|
564
|
+
if (!r.ok)
|
|
565
|
+
return fail(errText('插入索引失败', r), r.error);
|
|
566
|
+
return ok(`已在光标处插入索引目录(${r.data?.columns ?? 1} 栏)。` +
|
|
567
|
+
`当前文档有 ${r.data?.markedEntries ?? 0} 个索引项。` +
|
|
568
|
+
'接着调 wps_word_update_fields 更新。');
|
|
569
|
+
}
|
|
570
|
+
const r = await call('markIndexEntry', { entry: args.text });
|
|
571
|
+
if (!r.ok)
|
|
572
|
+
return fail(errText('标记索引项失败', r), r.error);
|
|
573
|
+
return ok(`已编入索引项:「${r.data?.entry}」`);
|
|
574
|
+
}
|
|
575
|
+
catch (e) {
|
|
576
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
577
|
+
return fail(`索引操作异常:${m}`, m);
|
|
578
|
+
}
|
|
579
|
+
};
|
|
580
|
+
exports.indexHandler = indexHandler;
|
|
581
|
+
// ============================================================================
|
|
582
|
+
// P1:页码 / 奇偶页 / 首页不同
|
|
583
|
+
// ============================================================================
|
|
584
|
+
exports.pageNumberDefinition = {
|
|
585
|
+
name: 'wps_word_page_number',
|
|
586
|
+
description: `在页眉里插入页码,或设置"首页不同/奇偶页不同"。
|
|
587
|
+
|
|
588
|
+
参数:
|
|
589
|
+
- op: addPageNumber(插页码,默认)| setLayout(设置版式)
|
|
590
|
+
- which: primary(默认,正文页)| first(首页)| even(偶数页)
|
|
591
|
+
- alignment: left | center(默认)| right
|
|
592
|
+
- differentFirstPage: true/false(setLayout 时)—— 首页不显示页码就靠它
|
|
593
|
+
- oddAndEvenPages: true/false(setLayout 时)—— 奇偶页用不同页眉就靠它
|
|
594
|
+
|
|
595
|
+
使用场景:
|
|
596
|
+
- "加页码,页脚居中"→ wps_word_insert_header 之后调这个(页码实际插在页眉)
|
|
597
|
+
- "首页不要页码"→ setLayout differentFirstPage=true`,
|
|
598
|
+
category: tools_1.ToolCategory.DOCUMENT,
|
|
599
|
+
inputSchema: {
|
|
600
|
+
type: 'object',
|
|
601
|
+
properties: {
|
|
602
|
+
op: { type: 'string', enum: ['addPageNumber', 'setLayout'], description: '操作方式' },
|
|
603
|
+
which: { type: 'string', enum: ['primary', 'first', 'even'], description: '页码加在哪部分' },
|
|
604
|
+
alignment: { type: 'string', enum: ['left', 'center', 'right'], description: '对齐,默认 right' },
|
|
605
|
+
sectionIndex: { type: 'number', description: '第几个节,默认 1' },
|
|
606
|
+
differentFirstPage: { type: 'boolean', description: '首页页眉页脚不同' },
|
|
607
|
+
oddAndEvenPages: { type: 'boolean', description: '奇偶页页眉页脚不同' },
|
|
608
|
+
},
|
|
609
|
+
required: ['op'],
|
|
610
|
+
},
|
|
611
|
+
};
|
|
612
|
+
const pageNumberHandler = async (args) => {
|
|
613
|
+
const op = String(args.op);
|
|
614
|
+
try {
|
|
615
|
+
if (op === 'setLayout') {
|
|
616
|
+
if (args.differentFirstPage === undefined && args.oddAndEvenPages === undefined) {
|
|
617
|
+
return fail('setLayout 至少要传 differentFirstPage 或 oddAndEvenPages 之一');
|
|
618
|
+
}
|
|
619
|
+
const r = await call('setHeaderFooterLayout', {
|
|
620
|
+
differentFirstPage: args.differentFirstPage, oddAndEvenPages: args.oddAndEvenPages,
|
|
621
|
+
});
|
|
622
|
+
if (!r.ok)
|
|
623
|
+
return fail(errText('设置版式失败', r), r.error);
|
|
624
|
+
return ok(`已设置:首页不同=${r.data?.differentFirstPage},奇偶页不同=${r.data?.oddAndEvenPages}`);
|
|
625
|
+
}
|
|
626
|
+
const r = await call('addPageNumber', {
|
|
627
|
+
which: args.which, alignment: args.alignment, sectionIndex: args.sectionIndex,
|
|
628
|
+
});
|
|
629
|
+
if (!r.ok)
|
|
630
|
+
return fail(errText('添加页码失败', r), r.error);
|
|
631
|
+
return ok(`已插入页码(${r.data?.which ?? 'primary'},${r.data?.alignment ?? 'right'}),` +
|
|
632
|
+
`该部分现有 ${r.data?.count} 个页码。`);
|
|
633
|
+
}
|
|
634
|
+
catch (e) {
|
|
635
|
+
const m = e instanceof Error ? e.message : String(e);
|
|
636
|
+
return fail(`页码操作异常:${m}`, m);
|
|
637
|
+
}
|
|
638
|
+
};
|
|
639
|
+
exports.pageNumberHandler = pageNumberHandler;
|
|
640
|
+
/** 本批工具集合 */
|
|
641
|
+
exports.p01Tools = [
|
|
642
|
+
{ definition: exports.revisionsDefinition, handler: exports.revisionsHandler },
|
|
643
|
+
{ definition: exports.getCellTextDefinition, handler: exports.getCellTextHandler },
|
|
644
|
+
{ definition: exports.mergeCellsDefinition, handler: exports.mergeCellsHandler },
|
|
645
|
+
{ definition: exports.splitCellDefinition, handler: exports.splitCellHandler },
|
|
646
|
+
{ definition: exports.tableRowColDefinition, handler: exports.tableRowColHandler },
|
|
647
|
+
{ definition: exports.setCellBordersDefinition, handler: exports.setCellBordersHandler },
|
|
648
|
+
{ definition: exports.listStylesDefinition, handler: exports.listStylesHandler },
|
|
649
|
+
{ definition: exports.addStyleDefinition, handler: exports.addStyleHandler },
|
|
650
|
+
{ definition: exports.modifyStyleDefinition, handler: exports.modifyStyleHandler },
|
|
651
|
+
{ definition: exports.deleteStyleDefinition, handler: exports.deleteStyleHandler },
|
|
652
|
+
{ definition: exports.crossRefDefinition, handler: exports.crossRefHandler },
|
|
653
|
+
{ definition: exports.indexDefinition, handler: exports.indexHandler },
|
|
654
|
+
{ definition: exports.pageNumberDefinition, handler: exports.pageNumberHandler },
|
|
655
|
+
];
|
|
656
|
+
exports.default = exports.p01Tools;
|
|
657
|
+
//# sourceMappingURL=professional.js.map
|