# @deckflow/deckuse 中文文档规范地址：https://npmcn.com/package/%40deckflow/deckuse/ 版本：1\.9\.9 npm 元数据更新时间：2026-11-13T08:01:48.944Z 中文译文更新时间：2026-11-14T07:12:07.219Z 软件包许可：AGPL-3\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。原始 npm 页面：https://www.npmjs.com/package/%40deckflow/deckuse 原文对照：https://npmcn.com/package/%40deckflow/deckuse/?lang=original 项目主页：https://github.com/deckflow/deckuse#readme 源码仓库：https://github.com/deckflow/deckuse ## 关键信息（来自 npm 元数据） - 包体积（解压后）：3.4 MB，520 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20\.19\.0 - 运行依赖：6 个 - 首次发布：2026-08-11T10:45:19.740Z - 最新版本发布：2026-11-13T08:01:48.744Z - 近 30 天下载量：2156（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：28（近 12 个月 28 个） ## 中文简介 Canonical Deckuse CLI 用于可编辑的 PowerPoint 和 Word 文档,并带有捆绑的代理商 Skill. ## 安装 ```sh npm install @deckflow/deckuse ``` 也可以使用：`pnpm add @deckflow/deckuse`、`yarn add @deckflow/deckuse`、`bun add @deckflow/deckuse` ## README # Deckuse [![Node.js 20.19.0+](https://img.shields.io/badge/Node.js-20.19.0%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org/) [![pnpm 10](https://img.shields.io/badge/pnpm-10-F69220?logo=pnpm&logoColor=white)](https://pnpm.io/) [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![PPTX](https://img.shields.io/badge/Format-PPTX-B7472A?logo=microsoftpowerpoint&logoColor=white)](https://npmcn.com/package/%40deckflow/deckuse/#readme-pptx-capabilities) [English](https://npmcn.com/package/%40deckflow/deckuse/README.md) · [简体中文](https://npmcn.com/package/%40deckflow/deckuse/README.zh-CN.md) · [Français](https://npmcn.com/package/%40deckflow/deckuse/README.fr.md) · [日本語](https://npmcn.com/package/%40deckflow/deckuse/README.ja.md) · [한국어](https://npmcn.com/package/%40deckflow/deckuse/README.ko.md) · [Русский](https://npmcn.com/package/%40deckflow/deckuse/README.ru.md) · [Español](https://npmcn.com/package/%40deckflow/deckuse/README.es.md) · [Português](https://npmcn.com/package/%40deckflow/deckuse/README.pt-BR.md) > Partial translation. See the [English README](https://github.com/deckflow/deckuse/blob/main/README.md) for current capabilities and installation. Deckuse 是一款面向编程智能体的本地优先、模式驱动的 Office 文档自动化引擎。它将文档打开为带版本的工作区，让智能体用语义地址（如 `slide:1/shape:2`）检查并精确定位结构，执行显式变更、验证结果，再导出新文档。目前已实现 PPTX 与 DOCX（**协议 2.0**）。XLSX、Keynote 和 Numbers 适配器会明确返回 `FORMAT_NOT_IMPLEMENTED`；它们尚不是受支持的编辑目标。Word 与 PPTX 共用工作区循环（`new --format docx`、`init`、`apply`、`validate`、`export`），寻址用 `body/p:N`、`bookmark:名称`、`para:`，而不是幻灯片形状。`render --page` 仍只支持 PPTX。完整说明见 [README.md](https://npmcn.com/package/%40deckflow/deckuse/README.md) 的 DOCX capabilities。 ## 在编程智能体中使用 Deckuse [Deckuse skill](https://npmcn.com/package/%40deckflow/deckuse/skills/deckuse/SKILL.md) 指导智能体编辑演示文稿和 Word 文档，CLI 执行实际的文档操作。在使用智能体的项目目录中运行： ```sh npx skills add deckflow/deckuse ``` 按提示选择智能体和安装范围。项目级安装供当前项目使用，用户级安装可跨项目使用。手动安装时，将整个 `skills/deckuse/` 目录复制到智能体的技能目录。各工具的发现路径见[安装路径表](https://github.com/vercel-labs/skills/blob/main/docs/agents.md)。如果先装了 skill，运行 `deckuse --version` 检查 CLI。缺少 CLI 时，按[安装](https://npmcn.com/package/%40deckflow/deckuse/#readme-%E5%AE%89%E8%A3%85)一节操作。如果已经安装 CLI，想让智能体驱动 Deckuse 时，再运行上面的命令。需要固定版本时，从与 npm 包版本对应的发布标签安装 skill。两者就绪后，直接给智能体具体任务，例如“用 Deckuse 更新 `report.pptx` 的数字，并导出一份修订稿”。 ## 为何选择 Deckuse Deckuse 可在不从零重建演示文稿的情况下修改现有 PPT。若没有源文件，可用 `deckuse new` 基于内置空白模板创建工作区。其工作流刻意以结构为中心，而非视觉为中心： ```text existing.pptx → init ─┐ ├→ list / get → set / add → validate → export blank template → new ─┘ ``` 每次成功的写操作会自动提交 Git 版本、更新 `operations.jsonl`、重建 `package.pptx`，并刷新 `.deckuse/index.json`。可使用 `undo` 撤销、`history` 查看操作历史。 Deckuse 会尽可能保留未修改的 XML 和未知的包部件。它不是完整的 PowerPoint 渲染或版式引擎，无法可靠判断幻灯片是否美观或版式是否正确。可用 `monitor` 做实时 HTML 预览，用 `render` 将单页截成 PNG 供智能体视觉复查。语义 `diff` / `branch` 仍在 Phase 1a 之后交付。 ## 安装需要 Node.js 20.19.0 或更高版本。 ```sh npm install -g @deckflow/deckuse ``` 该命令会全局安装 `deckuse` CLI。生成 PNG 预览时，`deckuse render` 优先使用与 Playwright 匹配的 Chromium Headless Shell。缺失时会在常见安装位置查找 Chrome、Edge 和 Chromium。如果都找不到，可以安装并验证浏览器： ```sh deckuse render --install-browser deckuse render --preflight --probe-browser --json ``` ```sh # 从演示文稿创建持久工作空间（revision 从 1 开始）。 deckuse init input.pptx ./workspace --json # 或从内置空白 16:9 模板起步（无需 input.pptx）。 deckuse new ./workspace --json # 清单与带 provenance 的实时属性读取。 deckuse status --workspace ./workspace --json deckuse list slides --workspace ./workspace --json deckuse list shapes --workspace ./workspace --slide 1 --json deckuse get slide:1/shape:2 --workspace ./workspace --resolve both --json # 语义目标写入（一次写 = 一次 revision）。 deckuse set text slide:1/shape:2 --workspace ./workspace --value 'Hello' --json deckuse set slide:1/shape:2 --workspace ./workspace --font.size 42 --fill.color '#0A2930' --json deckuse add shape --workspace ./workspace --slide 1 --type text --name Title --x 0 --y 0 --width 914400 --height 457200 --json # 验证、历史、撤销、导出。 deckuse validate --workspace ./workspace --json deckuse history --workspace ./workspace --json deckuse undo --workspace ./workspace --steps 1 --json deckuse export ./out.pptx --workspace ./workspace --json # 实时 HTML 预览；浏览器订阅后才开始转换。 deckuse monitor --workspace ./workspace --port 4173 # 将单页截成 PNG 供视觉复查。 deckuse render --page 1 --workspace ./workspace --json ``` 批量截图可使用项目脚本（调用当前项目的 `bin/deckuse render`）： ```bash # 支持多个 PPTX/DOCX 文件、Deckuse 工作区，或包含 Office 文件的目录。 node scripts/batch-render.mjs ./presentations ./workspace --output-dir ./screenshots node scripts/batch-render.mjs ./presentations -j 4 --scale 2 ``` 默认并发数为 `max(1, CPU 核心数 - 2)`，可用 `-j` / `--concurrency` 指定正整数。普通目录只扫描当前层的 PPTX/DOCX 文件；每个输入的全部页面输出到独立的编号子目录。原始文件通过临时工作区渲染，结束后清理临时工作区。单项失败后继续处理，其余任务完成后汇总；存在失败时退出码为 1。优先调用项目的 `bin/deckuse`；该入口不存在或链接失效时，自动使用 `node dist/bin.js`。若构建产物也不存在，请先运行 `pnpm build`。全局选项包括 `--workspace`、`--json`、`--dry-run`、`--expect-revision`、`--reason`。完整 CLI 契约见 `deckuse --help` 或 `deckuse --help`。工作区布局： ```text workspace/ source/ # 解压后的 OPC 包，写操作直接修改此处 package.pptx # 由 source 即时打包的 Office 快照（不在 Git 中） .deckuse/ # manifest、index、operations.jsonl、被忽略的监控输出 .git/ # 工作区版本历史 .gitignore # 忽略 package.* 等生成文件 ``` ## CLI 工作流 `apply` 可接受 transaction 文件（`{ "operations": [...] }`）、单个 JSON mutation、JSON 数组或 JSONL。一次调用可应用多条写命令；多条命令作为一次原子 batch 执行。使用 `--input -`（默认）从标准输入读取。仍支持旧版 ElementRef mutation。无子命令时，CLI 从标准输入读取一条完整的协议 `2.0` JSON 命令。命令结果使用 JSON envelope（`ok`、`command`、`revision`、`data` / `error`）。退出状态 `0` 表示成功，`1` 表示命令失败，`2` 表示 CLI 用法或解析失败。 ### 选择器 Phase 1a 优先使用 `search text` / `search shape` 与 `list`。`query` 仍可用作兼容入口，接受选择器字符串或命令中的结构化选择器。空格分隔的条件以 AND 组合。 | 语法 | 含义 | | --- | --- | | `*` 或 `all` | 匹配所有已索引元素。 | | `kind=textbox` | 按不区分大小写的子串匹配元素 kind。 | | `text=Quarter` | 匹配包含字面量的文本。 | | `text~=pattern` | 用 Unicode 正则匹配文本。 | | `hasText=true` | 匹配含文本的元素。 | | `slide=256`、`id=256:10`、`name=Title` | 按幻灯片 ID、元素 ID 或名称过滤。 | 查询结果提供稳定的元素引用。引用包含文档 ID 以及元素 ID 或结构路径；数组下标不是稳定标识符。 ## 通用智能体工作流这些示例仅使用当前 PPTX 功能。它们描述了智能体如何从 Deckuse 基元组合出工作流，而非声称 Deckuse 可独立进行推理、文案撰写或视觉审查。 ### 1\. 跨整个演示文稿更新过期年份 **Request：**“将每处 `FY2025` 引用改为 `FY2026`，不要改动其他内容。” 先使用 `query` 审查受影响的元素，然后执行字面量 `replaceText`，并在导出前验证。 ```sh deckuse init master.pptx ./year-update --json deckuse query ./year-update 'text=FY2025' --limit 1000 --json cat > year-update.json <<'EOF' { "type": "replaceText", "find": "FY2025", "replace": "FY2026" } EOF deckuse apply ./year-update --input year-update.json --json deckuse validate ./year-update --json ``` 写操作完成后，`./year-update/package.pptx` 会自动更新为最新快照。审查查询将变更限定在已知出现位置；`replaceText` 执行经批准的批量修改，同时保持无关对象不变。无 selector 时，它会更新最具体的索引文本节点，而不是聚合了子节点文本的祖先容器。 ### 2\. 重命名公司或产品 **Request：**“将旧产品名称在所有位置替换为新产品名称。” 这沿用同一套安全的“审查后替换”模式。先搜索准确的旧名称，再用字面量值执行 `replaceText`。对于标点或空格等变体，只有在检查查询输出后才使用正则表达式替换。 ```json { "type": "replaceText", "find": "Legacy Platform", "replace": "Unified Platform" } ``` 若要进一步收窄变更范围，请在命令中加入选择器，例如 `"selector": "slide=256"`，使其仅对一张幻灯片生效。 ### 3\. 为智能体提取演示文稿大纲 **Request：**“列出各页幻灯片标题并总结此演示文稿涵盖的内容。” 运行 `inspect` 获取已索引的演示文稿结构，然后查询含有文本的对象。调用方智能体可按幻灯片 ID 对返回对象分组，根据其名称、位置或文本识别标题类对象，并基于提取出的文本生成摘要。 ```sh deckuse init briefing.pptx ./outline --json deckuse inspect ./outline --depth 2 --json deckuse query ./outline 'hasText=true' --limit 10000 --json ``` Deckuse 提供结构化源数据。由智能体而非 Deckuse 决定哪些文本是标题，并撰写摘要。 ### 4\. 执行交付前内容 QA **Request：**“在发送此演示文稿前，找出旧客户名称、日期、产品名称、URL 和必需的免责声明文本。” 查询每项已知风险并检查返回的引用。缺失检查的工作方式相同：查询所需文本，并标记空结果。智能体可以在不修改演示文稿的前提下生成 QA 报告，也可以为经批准的修复准备精确定位的 `setText` / `replaceText` 命令。 ```sh deckuse query ./workspace 'text=Customer A' --limit 1000 --json deckuse query ./workspace 'text~=https?://' --limit 1000 --json deckuse query ./workspace 'text=Required disclaimer' --limit 1000 --json ``` 这是内容和结构 QA，不是视觉 QA。`render` / `monitor` 仅作人或智能体复查辅助；Deckuse 不会检测重叠，也不会评判版式质量。 ### 5\. 仅修改一张幻灯片上的一个项目 **Request：**“在第 7 张幻灯片上，将标题改为 `Enterprise Strategy`；不要改动其他内容。” 先查询该幻灯片及标题文本，然后取返回的 `ref` 发送 `setText` 命令。`ref` 可避免含义不明确的全局替换。 ```json { "type": "setText", "ref": { "documentId": "./workspace", "elementId": "256:10" }, "text": "Enterprise Strategy" } ``` 元素 ID 是特定于演示文稿的示例。务必使用当前工作区返回的 ID，而不要复制此值。 ### 6\. 统一标题排版 **Request：**“将每个经批准的标题设为 28 pt，并使用已批准的字体。” 使用查询识别标题对象，让智能体审查或筛选返回的引用，然后对每个已批准的引用分别应用一次 `setProperties`。`setProperties` 一次只针对一个引用；它本身不接受选择器。 ```json { "type": "setProperties", "ref": { "documentId": "./workspace", "elementId": "256:8" }, "properties": { "fontSize": 28, "fontFamily": "Approved Sans", "bold": true } } ``` 同一命令还可设置 `fill`、`stroke`（也可写作 `border`、`outline` 或 `line`）、`textColor`、`italic`、`underline`、`name` 和 `hidden`。未知属性键会以 `INVALID_COMMAND` 失败。 ### 7\. 精确调整对象几何属性 **Request：**“将每个经批准的标题稍微向下移动。” 查询并选择目标标题引用，检查它们当前的几何属性，然后为每个对象发出一条带有明确坐标的 `setTransform` 命令。这是结构化的几何操作；未经视觉验证，不应将其表述为自动版式修复。 ```json { "type": "setTransform", "ref": { "documentId": "./workspace", "elementId": "256:8" }, "transform": { "x": 914400, "y": 731520, "width": 8229600, "height": 685800 } } ``` 变换坐标使用 OOXML EMU。若仅更改其垂直位置，请保留检查所得对象的 `x`、`width` 和 `height`。 ### 8\. 将已批准的销售演示文稿个性化 **Request：**“为潜在客户创建一个版本。更新客户名称和已批准的特定客户文案，但保留设计。” 从已批准的母版为每份输出创建独立工作区。查询占位符或现有客户文本，仅应用经审查的替换，验证后使用自动更新的 `package.pptx`。 ```sh deckuse init approved-master.pptx ./customer-a --json deckuse query ./customer-a 'text=Customer Name' --json # 仅应用针对此客户的经审查替换。 deckuse apply ./customer-a --input customer-a.jsonl --json deckuse validate ./customer-a --json ``` 独立工作区可防止某一客户的编辑泄漏到另一份输出中。仅替换审批流程允许智能体修改的对象。 ### 9\. 从同一母版生成区域或受众变体 **Request：**“从已批准的演示文稿生成区域版和企业版变体。” 从同一母版为每个变体初始化新的工作区。每个变体都有自己的命令文件和输出路径。优先使用 `apply` 配合 JSON 数组、JSONL 或 `{ "operations": [...] }`：一次调用中的多条写命令作为一次原子 batch 执行（任一失败则全部不落盘）。协议层的 `batch` 命令形式仍然支持。 ```json [ { "type": "replaceText", "find": "Default Message", "replace": "Regional Message" }, { "type": "replaceText", "find": "Default Offer", "replace": "Enterprise Offer" } ] ``` ```sh deckuse apply ./regional --input regional.json --json ``` 这既保留了一份已批准的源演示文稿，也使每个变体都能从显式变更集复现。 ### 10\. 让编程智能体操作现有演示文稿 **Request：**“检查此演示文稿，识别所需编辑，完成编辑并导出修订后的 PPTX。” 向智能体提供以下循环：初始化工作区；在每次针对性变更前执行检查或查询；生成显式 JSON 命令；应用命令；验证包；使用自动重建的 `package.pptx` 作为导出结果。当可审计性很重要时，将命令文件和命令结果与任务一同保存。 Deckuse 为智能体提供稳定引用、选择器、事务、验证和确定性的导出路径。智能体负责理解任务，并决定哪些操作适用。 ### `setProperties` 示例 ```json { "type": "setProperties", "ref": { "documentId": "./workspace", "elementId": "256:8" }, "properties": { "stroke": { "color": "0000FF", "width": 1.5 }, "fill": "none", "textColor": "111111", "fontSize": 18, "fontFamily": "Approved Sans", "bold": true } } ``` `stroke` 与 `fill` 可接受十六进制颜色字符串。使用 `none`、`false` 或 `null` 表示无描边/无填充。`stroke.width` 单位为磅，默认 `1`。 ## PPTX 功能 - 持久工作区、修订冲突检测、dry-run、原子 batch 与操作日志。 - `inspect`、`list`、`get`、`search`，以及兼容用的 `query` / `getText`；稳定引用在可用时包含幻灯片 ID、部件 URI、cNvPr ID 与祖先路径。 - `setText` 与 `replaceText`，包括可选 selector 范围内的字面量或正则替换。无 selector 时，`replaceText` 优先更新最具体的文本节点，而非聚合了子节点文本的祖先容器。`setText` 中的换行会拆成多个段落。CLI `--value` 会解析 `\n`/`\t`（可用 `--text-raw` 关闭）；多行多样式可用 `--blocks` / 协议 `blocks`（块内可选 `runs[]` 做段内多 run）。`addShape` 支持一次写入内联 `blocks` / `fill` / `stroke`。 - 几何支持 **EMU 数字或单位字符串**（`px`@96DPI、`pt`、`cm`、`mm`、`in`、相对幻灯片的 `%`）。`alignElements` / `deckuse align` 将对齐结果写回绝对 EMU。同一次 `apply` 内可按形状 `name` 前向引用刚 `addShape` 的对象。 - `setTransform` 用于显式设置对象位置、尺寸、旋转与翻转。 - `setProperties` 用于常见形状与文本属性，包括 `paragraph.align`（可用 `center`/`left` 等别名）、`paragraph.level`、`bullet`、填充透明度、`hyperlink`、`wrap`、`anchor`/`valign`、`cornerRadius`。 - 可添加、复制、删除幻灯片，以及将已有页切换到另一版式（`setSlideLayout` / `deckuse set slide-layout`）；layout 引用支持序号、`layout:N`、`slide:N`、显示名或 basename。切换只改 slide→layout 关系，不编辑 layout 部件本身。复制幻灯片时会克隆可变的备注与图表部件，版式与媒体可安全共享。 - 可添加形状/文本框（可选 `role` 写出 `p:ph` 占位符）、直线连接线（`line`/`connector`）、折线/曲线连接线、箭头预设、组合、图片（文件路径或 base64）、表格、图表（仅缓存）以及嵌入的视频/音频；可复制或删除元素。 - `role` 须为 OOXML 占位符类型（`title`、`body`、`subTitle`、`ctrTitle` 等）。常见别名会规范化（如 `subtitle`→`subTitle`）；非 OOXML 标签（如 `card`）会被拒绝，以免 PowerPoint 提示修复。 - 可用 `slide:N/placeholder:` 寻址占位符；可用 `slide:N/shape:X/run:K` 对单个 run 做 `setProperties`。 - `replacePicture` 就地替换图片嵌入媒体，并保留元素引用与图层顺序。 - 表格单元格寻址；表格行列增删与单元格 `fill`；演讲者备注读写（对 `slide:N/notes` 写入时若无备注页会自动创建）。表格支持 `height: "auto"`、主题 `minimal`/`zebra` 与 `alignColumns`。 - 可创建图表（`bar` / `column` / `line` / `pie` / 受限 `combo` 双轴）并编辑标题、系列名、缓存值、数据标签、系列颜色与数值格式。存在嵌入工作簿时返回 `EMBEDDED_WORKBOOK_NOT_SYNCHRONIZED`，不会声称已更新工作簿。社区版对高级图表（其它 family、ChartEx）仅保留、不可编辑。社区版 `render` **可能无法忠实显示**自定义系列色——请核对 chart XML 或用 PowerPoint 打开。 - 可 list / resolve master、layout、theme；社区版拒绝写入这些部件（`UNSUPPORTED_CAPABILITY`）。Master/Layout 编辑见商业版仓库。 - `monitor` 提供实时 HTML 预览（`monitor start|status|stop`；可用 `--port 0` 自动选端口），`render` 可将单页截成 PNG（支持 `--scale`）。`deckuse schema` 输出命令 JSON Schema；`deckuse measure` 启发式估算文本尺寸。 - 尽可能保留未知部件与未改动节点。ZIP 会重新压缩，保真度针对未改动条目的未压缩数据，而非 ZIP 字节级一致。 Agent 速查：[docs/agent-cookbook.md](https://npmcn.com/package/%40deckflow/deckuse/docs/agent-cookbook.md)。需要 **CLI >= 1.2.0**。 ## 限制 - Deckuse 未实现完整的 PowerPoint DrawingML、动画编辑、SmartArt 编辑、OLE 编辑或宏编辑。 - 它不是完整的 PowerPoint 渲染或版式引擎。`monitor` 与 `render` 仅提供 HTML/PNG 复查辅助；不要依赖它们评判视觉质量、检测重叠或自动改善版式。 - 图表创建与编辑仅更新 OOXML 图表缓存；不会重写嵌入的 Excel 工作簿。 - 嵌入的视频/音频使用生成的海报帧；播放时序与高级媒体选项不可编辑。 - 复制幻灯片会克隆备注与图表部件，并复用版式、主题与媒体。复杂自定义 XML 扩展会保留，但不做语义编辑。 - `setText` 与 `replaceText` 会将每个段落内的多 run 文本折叠为单个 run，并保留首个 run 的样式；`setText` 中的换行会创建新段落。 ## 开发检查 ```sh pnpm format:check pnpm lint pnpm typecheck pnpm test pnpm build ``` 完整英文文档与命令措辞见 [README.md](https://npmcn.com/package/%40deckflow/deckuse/README.md)。 ### Agent 可靠性与批量渲染参见 [Agent 可靠性说明](https://npmcn.com/package/%40deckflow/deckuse/docs/agent-reliability.md)：包含 JSON 错误处理、事务恢复、非空目录保护，以及固定输入快照的 `render --pages 1,3-5` / `render --all`。使用 `schema --list --json` 查看可批处理命令；`addSlide` 可与页面内容一起提交。 ## 常见问题 ### @deckflow/deckuse 是什么？ Canonical Deckuse CLI 用于可编辑的 PowerPoint 和 Word 文档,并带有捆绑的代理商 Skill\. ### 如何安装 @deckflow/deckuse？在项目目录运行 npm install @deckflow/deckuse，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 deckuse，可以用 npx deckuse 直接运行。 ### @deckflow/deckuse 支持 TypeScript 吗？支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @deckflow/deckuse 支持 ESM 还是 CommonJS？以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @deckflow/deckuse 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @deckflow/deckuse 可以商用吗？ @deckflow/deckuse 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。 ### @deckflow/deckuse 的下载量有多少？根据 npm 官方下载统计，@deckflow/deckuse 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,156 次，日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @deckflow/deckuse 还在维护吗？最新版本 1\.9\.9 发布于 2026/11/13（1 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/08/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。