# @deliverart/sdk-js-integration-diagnostics 中文文档 规范地址：https://npmcn.com/package/%40deliverart/sdk-js-integration-diagnostics/ 版本：3\.0\.1 npm 元数据更新时间：2026-11-10T20:26:20.177Z 中文译文更新时间：2026-11-12T02:21:08.495Z 软件包许可：未声明 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40deliverart/sdk-js-integration-diagnostics 原文对照：https://npmcn.com/package/%40deliverart/sdk-js-integration-diagnostics/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：709 kB，6 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：3 个 - 首次发布：2026-10-09T06:25:12.127Z - 最新版本发布：2026-11-10T20:26:19.955Z - 近 30 天下载量：3382（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：26（近 12 个月 26 个） ## 中文简介 共享整合诊断、核查和明确的恢复合同 ## 安装 ```sh npm install @deliverart/sdk-js-integration-diagnostics ``` 也可以使用：`pnpm add @deliverart/sdk-js-integration-diagnostics`、`yarn add @deliverart/sdk-js-integration-diagnostics`、`bun add @deliverart/sdk-js-integration-diagnostics` ## README # 综合诊断 供应商中立诊断合同由Hub和Admin共享. 需要 API 综合诊断 迁移和来自协调特征的终点. 该套件不取代本地融合问题或订单出口API. ```ts import { GetDiagnosticProblems, GetDiagnosticProblemDetails, VerifyDiagnosticProblem, PreviewDiagnosticRecovery, RequestDiagnosticRecovery, describeDiagnostic, } from '@deliverart/sdk-js-integration-diagnostics' const page = await client.call(new GetDiagnosticProblems(posId, { query: { state: 'open', page: 1, itemsPerPage: 30 }, })) const problem = await client.call(new GetDiagnosticProblemDetails(problemId)) const explanation = describeDiagnostic(problem.operations[0]?.evidence ?? null, 'it') const checked = await client.call(new VerifyDiagnosticProblem(problemId)) // Build this list from the operator's explicit selection, never every open row. const input = { requestKey: crypto.randomUUID(), operations: selectedOperations } const preview = await client.call(new PreviewDiagnosticRecovery(posId, input)) // Display eligibility before requesting recovery. The API revalidates again. const receipt = await client.call(new RequestDiagnosticRecovery(posId, input)) ``` 重试提交时保留相同的请求密钥 其HTTP响应被丢失. 已提交的收件或已公布的队列消息 ; 刷新受影响的操作以观察其结果. `GetDiagnosticOverview` 将问题计数与唯一受影响的操作区分开来 计数。 永远不要把它们加在一起。 单独核实的问题摘要报告 成功、手工操作和杰出工作:20个假期中的17个 即使在原原因得到纠正的情况下,仍未完成的操作. `VerifyDiagnosticProblem` 使用共享冷却进行本地范围检查. 尊重范围、检查/过期时间和 `fresh`。当前本地绘图确实 无法证明远程可用性或订单交付。 刷新不会重试工作 . `CloseDiagnosticOperation` 需要当前修订和不可放弃的理由. 手工处理不同于成功处理,并阻碍今后出口的再发送; 此初始 API 不曝光重开 。 不要用它来对付整个问题 当操作员只选择了一个受影响的操作时. 未知的查找方案成为无效证据和清晰 `evidenceComplete`。 。 。 . 未知的恢复动作变为无效和不合格的预览, 因此更新服务器 能力不能意外通过更老的客户端执行。 已知证据 保留原因/受影响/背景角色。 资源名称和撰写的说明 是纯文本; 与正常逃逸一起渲染, 绝不是 HTML 。 申请路线, 授权、控制和实时刷新仍为每个消费者所有. `describeDiagnostic`, (中文(简体) ), `describeVerification` 财务报告和审定财务报表 `diagnosticResourceName` 提供 共享意大利语/英语演示文稿,无需React或MUI版本. 未识别代码得到不完全诊断解释. 这些初始 信件覆盖缺失的 Cassa 修改器映射和大象导入中断 或部分故障,加上分阶段同步超时、部分出错和 未证实完成。 这些解释描述了已知的流程结果,没有 声称有确认的根源。 与未来一起添加作者描述 贡献范围,而不是解析技术例外字符串. 操作行包括可选本地 `context`,独立于 失败的证据。 未知上下文类型变为无效; 客户端不能构造 来自未识别形状的资源链接. `describeDiagnosticOperation` 提供 意大利/英国订货标签 同步瞄准镜和进口 顺序标签 使用已授权的本地引用; 路线使用 `resourceId`从不导出 UUID 或任意的提供者 URL 。 缺少上下文可以读取遗留行 . 分阶段同步上下文可能包括 `direction: inbound | outbound | null`相对 给送货人 标签说明来源和目的地; 缺失的遗留值 保留“未记录的指令”。 方向是描述性的,从不重试 资格或更改本地同步设置. `diagnosticInvalidationRevision` 只接受诊断事件信封 它所要求的POS。 修改为小数字符串以保存 PostgreSQL bigint 精细。 此事件没有结果或总数: 用它来连接重读, 不改变本地计数器。 重新连接并错过后调试快照 即使已经看到修改. 本地菜单验证结果提供特定字段, 作者为意大利语/ 英语 名称、说明、价格、税收、选择限制、图像和 参考文献。 它们确定出版资源而不假定是综合提供者 ID是本地目录UUID. 不完整的证据有自己的明确解释. 提交前的验证不得作为远程出版物确认. 这个 `publication_validation` 操作上下文识别本地版本 审定。 交付/收集背景资源有本地化标签。 外地 解释允许部分提交 : 报告部分除外。 验证成功绝不是出版成功. ### 问题援助 援助是人类与诊断问题的对话。 正在完成中 援助不能解决技术原因,不能结束行动,也不能重试. `GetDiagnosticAssistanceHistory` 返回受约束的公共请求摘要; `GetDiagnosticAssistanceDetails` 返回单独标定的公共时间线. 使用 `RequestDiagnosticAssistance` 拥有稳定 `requestKey`,以及 `ReplyDiagnosticAssistance` 拥有稳定 `actionKey` 和本订正本. 在HTTP结果不确定后,重新使用相同的钥匙和有效载荷. 冲突要求 重新装入请求; 不要默默生成新密钥并重复动作 . 行政消费者的使用 `GetDiagnosticAssistanceInternal` 私人笔记 和操作员身份,以及 `UpdateDiagnosticAssistance` 转让,公开 问题、完成和说明。 默认为 `internal`; 客户问题 需求 `audience: 'public'` 和一无所取. 无法选择客户回复 观众。 API 权限仍然具有权威性;导入行政权限 请求类不允许访问 。 公共计划带 意外的身份字段, 但API必须先排除私人事件,然后才标注和序列化. 这些端点返回明确绑定的对象而不是通用的 API 平台 藏书. 所有读取请求接受 `page` 财务报告和审定财务报表 `itemsPerPage` (最多100个). `GetDiagnosticAssistanceQueue` 是单独的全球超级管理员元数据队列. 它默认打开请求,支持状态/任务/POS/整合过滤器, 并使用标准分解SDK结果. `assignment: 'mine'` 由 来自当前用户的 API. 队列中没有对话体 。 个人 对话读取,行动保留自己的源访问要求; 排队列不得视为授权能力. Glovo 结构化的远程预加载验证用途 `remote_menu_resource_*_invalid` 叙事 这些识别提供者验证,而非本地验证或成功 出版物. `remote_menu_validation_details_unavailable` 明确报告 不完整的证据;无论是客户端还是共享副本都无法推断免费文本中的项目. `publication_receipt` 操作上下文命名本地同步菜单上传. `menu_publication_*` 指导区分被拒绝的内容、访问/牵引/配置 问题 供应商出错 限制和穷尽的民调 明确未知的结果 在另一个发送前需要核查。 这些描述并不意味着成功 用于另一个交易或提供不支持的重试能力. 常见 `integration_*` 发行代码有意大利语/英语解释 认证,权限, 缺少引用, 菜单验证, 拒绝的数据, 每日限制和通用进程故障。 说明已知的分类 即使其确切原因仍未证实。 指导没有发明破损 证书/资源或承诺自动收回。 未知代码保留 安全不完全诊断后退. `diagnosticResourceName` 接受可选选项 可读集成标签的源服务并翻译已知的操作 范围; 记录的名称/翻译保留相对于倒置标签的优先权. ### 行动可用性 运行 `actions` 载有独立的追回/人工关闭决定 `evaluatedAt`。 。 。 . `describeDiagnosticActionAvailability` 翻译已知原因 输入意大利语/英语。 未知或畸形可执行元数据解析为无效; 客户端必须禁用动作,直到验证可用性。 可用读取 咨询性:本地提交仍然检查权限、修订和状态. ### 产品绘图说明和区域资源名称 确认 `catalog_product_mapping_missing` 意大利语/英语 解释不同于修改失败和未经核实的通用代码. 名称偏好所请求的语言, 然后是匹配的区域目录语言 (接受低分数和BCP-47分隔符),在现有名称/语言之前 堕倒. 区域名称,例如: `it_IT` 财务报告和审定财务报表 `en_GB` 不得降解为UUID. 本地映射校正不是远程可用或自动恢复. 经确认的顶级变体和销售模式绘图故障已单独共享 意大利语/英语叙事. 他们不推断产品,付款或捆绑 错误。 未经验证的后遗症编码保留了不完全的后遗症. 运算符 在任何本地更正后,选择仍然明确. 确认 `catalog_choice_mapping_missing` 意大利语/英语 将选定的选择与其绘图的修改符区分开来的解释 组合。 资源快照确定组和顺序行,恢复后仍保留 明确的运算符选择。 未知或未经证实的证据保留了通用 不完全诊断倒计时. Bundle 诊断法使用 准确拥有捆绑和修改器。 删除的修改/组成部分定义保留 历史顺序组名称并使用单独的叙事; 盲倒不是 以修复形式提出。 这些解释由Hub/Admin以意大利语和意大利语提供 英文,对未经证实的证据有一般的背书. `describeDiagnosticResourcePath` 使用 与主要证据清单相同的本地化资源名称。 它返回无路径 失踪、模棱两可、骑自行车、无名或过深的祖先。 枢纽和管理员 在不解释资源名称的情况下,通过 React 使返回的纯文本生效 作为 HTML 或猜测目录链接. 本地核查副本区分了确认的持续的绘图模糊性 从无定论的重复绘图。 当前检查结果也解释了缺失的原因 制图、没有资源、证据不足、没有证据/没有证据 检查和改变证据。 未知原因使通用安全倒置 永远不要暴露原始原因 缺失的时间戳和陈旧证据优先 所有具体的建议。 这些解释都没有选择或提交追回. 要求的 " 交付 " 菜单工作使用共同的叙述入分点 暂停准备、 发送失败、 上传拒绝、 请求限制的代码, 成果不确定,以前提交文件尚待审查,以及需要审查的正面出版证据。 意大利语和 英文副本从不等于在本地状态下读取完成的恢复 国家或其他未解决的划界案仍未核实。 这些解释是 不启用重试能力; 客户端必须继续使用API的动作守护. 分阶段同步证据可包括 `process_step` 环境资源, 父为本地进程 。 仅包含记录的允许上市阶段 标识符。 共享标签翻译所有 CassaInCloud/ Tilby 步骤; 未知的未来 步骤显示中性倒置。 记录的阶段不是因果资源或 并不具备恢复能力. CassaInCloud入境客户回收用途 `sync_current_state`意大利语和 英文确认 解释这创造了一个新的完整导入, 更新链接 客户,进口缺失的客户,保留之前的尝试. 还有 警告本地客户端更新可以触发其他已配置的同步. 解释从不选择或提交操作; 当前服务器资格 并且仍然需要明确的客户确认。 境外客户回收 且其他相机同步类型不得从其标签中继承这种能力. 资源标签重用本地的闭合同步镜词汇 配置上下文。 未命名进程资源使用本地化进程标签 并作简短的参考;持续的资源名称/译名仍然优先. 这样可以避免暴露出一个赤裸的流程UUID或英语范围密钥作为客户副本. 大象生命周期诊断 `integration_lifecycle` 操作环境 与整合/重新确定的范围。 意大利语/英语共同叙事 允许的列表操作代码和记录阶段。 未知的远程代码从未 成为作者的建议。 副本不等于已清除错误成功 激活或启用 API 不支持的重试 。 相位标签来自 封闭的原生矿井,与经核实的理由不同. Tilby 预发订单结果使用马厩 `tilby_seller_missing`, (中文(简体) ), `tilby_department_mapping_missing`, (中文(简体) ), `tilby_product_mapping_missing_for_variant`, (中文(简体) ), `tilby_variant_mapping_missing`, (中文(简体) ), `tilby_modifier_mapping_missing` 财务报告和审定财务报表 `tilby_choice_mapping_missing` 密码. `describeDiagnostic` 共享用品英语 和意大利康复指导。 资源标签保存已保存的目录/顺序名称; 配置标识符有共享名称. 这些调查结果没有授权: 重试、 验证远程存在或覆盖不确定端对齐. 本地 Tilby 校验使用相同的通用校验信封 供养者. 卖方检查区分 `configuration_missing` 从 `local_configuration_present`;共享的IT/EN演示文稿明确指出: 本地校正既不工作,也不证明远程配置. 测绘检查保留现有测绘原因. 只有新鲜的本地结果 匹配结果/理由对收到此解释; 未知、 stale 或 远程结果保留了自己的倒数。 消费者必须分开 操作结果和明确的操作者选择. 蒂比的部分财政恢复说明其全部进口增值税/部门进口, 保存的人工绘图分辨率、不可改变的以往历史和单独的顺序 复原。 该解释由准确的原生源/动作对来解开. 供应商标签的使用 `diagnosticServiceName` 和可选服务理由 `describeDiagnosticOperation`。未知的服务没有响应。 接收服务元数据是无效的,并且是权限范围. Tilby 受财政影响资源特性的使用 `tilby:vat:` 税收资源 `tilby:departments:` 用于配置资源。 共享的叙事使得其完整的外部ID带有IT/EN标签,而未将ID作为本地实体或被确认的原因处理. 已录制的 Tilby 菜单资源标签支持 `tilby:categories:`, (中文(简体) ), `tilby:components:` 财务报告和审定财务报表 `tilby:products:` 包括类别、配置和产品种类。 组件故意使用中性标签,而不是猜测本地映射是物品还是修饰. 选择的蒂比客户恢复使用 `tilby_sync_customers` 编号 : `sync_current_state` 说明在IT/EN中:完整的客户导入、保留历史、可能配置的下游更新和单独的订单回收. 已录入卡萨菜单资源使用情况 `cassa_in_cloud::` 标识符。 共享资源展示支持类别,产品,复合产品,选项,部门和销售模式参考文献使用意大利语和英语,验证类型/步配对,并保持完整的外部UUID可见. 这些标识符不得用作本地目录链接或作为根本原因的证明. ### 已录制的 Tilby 菜单原因 `describeDiagnostic` 翻译稳定入境 `tilby_menu_*` 代码输入 意大利语/英语标题,历史解释和操作者接下来的步骤. 产品 引用可识别受影响的远程项目,而不是本地目录链接。 不支持 变异/组件案例不会推断出确切的修改或选择。 指南保存 当前状态验证分开, 并要求运算符选择回收动作 明确在纠正原因之后 未知的代码保留了共享的后退 . 在提供商的标签和准确度旁边显示抓取的蒂比产品名称 外部身份证明。 这些名字来自记录失败的尝试,而非当前 地图查取. 遗留的无名证据仍仅限身份证明. 标签为 文本; 在提供者名中的标记永远不会变成 HTML。 较新的失败 产品/理由可以在保留本地历史的同时更新显示的快照. 核查可包括可选 `findings` (最多100个输入结果)。 渲染器 与历史行动分开 证据。 一个 `unknown/current_local_blockers` 结果描述当前本地 配置而不重建历史失败。 一个 `unknown/local_validation_passed` 结果无法确认历史更正 或远程送货。 旧回应没有 `findings` 仍可读取. 只要吃一些回收用途 `justeat_menu_submission` 与 `sync_current_state`。共享的意大利语/英语确认语解释完整当前 分类出版物、保存的历史证据以及 请求接受、菜单生成和提供者确认的出版物。 未知 出版结果必须仍然不符合提交另一文件的资格;API拥有 资格和客户不得从这一解释性副本推断许可. 共享出版物的诊断方法使用提供者中性的措辞来表达 多重融合. `menu_publication_queue_delivery_failed` 描述一个 未证实的内部交货,而不是远程拒绝;其回收指导要求 支持在提交另一份文件之前核查操作. 厨房访问准备失败 `kitchen_access_setup_failed` 编辑 `integration_lifecycle` 上下文 `access_setup` 范围。 共享意大利语/英语 抄本解释 穷尽的陷害尝试 而不坚持技术根源 或现场设备连接。 公共证据不得含有证书 数值。 未知代码继续使用常见的安全倒置. 蒂尔比部门选择使用顺序中节省的税率. 有效的明示 产品部门优先;百分率回落需要完全一个 已经解决的整合部门. `tilby_department_mapping_ambiguous` 当多个部门相匹配时解释操作者动作. 仅核查 检查当地证据;它从不重复出口或证明交货. Tilby 命令诊断包括 `tilby_product_mapping_ambiguous` 用于保留 产品映射,其标识不能安全授权销售书写。 显示 b. 共同叙述与地方 `mapping_ambiguous` 核查理由。 更正 本地原因不能证明已售出或授权自动重试; 保存 明确每个消费者的操作选择和恢复授权. `tilby_ingredient_mapping_unresolved` 识别原始成分/成分 独立于变异/价值协会的关联。 使用共享 语法来命名所保存的成分,解释它不能被一个 相同名称的变异,并保留任何明确选择和授权的回收. ## 远程调查 问题细节可选择披露 `remoteVerification`:队列/运行/完成/超状态,请求/检查时间戳,新鲜度,和有边框的打字检查. `VerifyDiagnosticProblem` 队列支持只读调查;现有客户端和不支持的错误保留本地验证. 远程检查描述的是当前的观测,从来就没有历史因果关系,成功交付订单,或自动恢复. 使用 `describeRemoteDiagnosticCheck` 意大利语/英语解释。 未知的检查代码必须明确不支持 . ## 运行时间和编译器库 现有诊断运行时间 `Object.hasOwn`;消耗的运行时间必须提供它或者兼容的多填充. ES2021 TypeScript目标控制放出语法,不提供内置. 类型检查保存了 ES2021 默认库,仅添加 `ES2022.Object` 声明; 此编译器对齐不添加运行时间多填充 . ## 常见问题 ### @deliverart/sdk-js-integration-diagnostics 是什么？ 共享整合诊断、核查和明确的恢复合同 ### 如何安装 @deliverart/sdk-js-integration-diagnostics？ 在项目目录运行 npm install @deliverart/sdk-js-integration-diagnostics，或使用 pnpm add / yarn add / bun add。 ### @deliverart/sdk-js-integration-diagnostics 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @deliverart/sdk-js-integration-diagnostics 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @deliverart/sdk-js-integration-diagnostics 可以商用吗？ @deliverart/sdk-js-integration-diagnostics 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @deliverart/sdk-js-integration-diagnostics 的下载量有多少？ 根据 npm 官方下载统计，@deliverart/sdk-js-integration-diagnostics 在 2026/10/12 – 2026/11/10 这 30 天内被下载 3,382 次，日均约 113 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @deliverart/sdk-js-integration-diagnostics 还在维护吗？ 最新版本 3\.0\.1 发布于 2026/11/11（1 天前）；至今共发布 26 个版本，其中过去 12 个月发布了 26 个；首次发布于 2026/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。