@dztabel/excel-kit 0.9.0 → 0.10.0

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/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # 变更记录
2
2
 
3
+ ## 0.10.0
4
+
5
+ - 新增图表系列与副轴编辑、直方图和箱线图、透视日期分组与筛选、条件格式和验证展示。
6
+ - 会话支持按版本提交、试算并恢复未保存状态,成功后按范围和图表重读。
7
+ - 支持两个工作簿的内容比较、带版本和引用绑定的跨簿区域迁移、条件透视指标和文字截断查询。
8
+ - 随包提供新组合配方;skill 入口按任务链接到 19 个专题。
9
+
3
10
  ## 0.9.0
4
11
 
5
12
  - 共享大范围依赖,紧凑存放只有样式的空格,减少计算线程间的复制;不完整计算不再在主线程重复建图。
package/DISTRIBUTION.md CHANGED
@@ -1,12 +1,12 @@
1
1
  # 安装包验证
2
2
 
3
- 公开发行复用 0.9.0 已验收的三个独立程序,SHA-256 见 `release.json`。工作簿、性能、Excel 和三平台历史验收见 [VALIDATION.md](VALIDATION.md),本次不重复这些实验。
3
+ 公开发行使用 Bun 1.4.2 从同一固定版本构建三个独立程序,SHA-256 见 `release.json`。工作簿、性能、Excel 和三平台历史验收见 [VALIDATION.md](VALIDATION.md),本次不重复这些实验。
4
4
 
5
- 本次新增的是 Node.js 安装入口和 npm 平台包:入口只选择与平台相符、版本完全相同的程序,原样传递参数、标准输入输出、退出状态及取消信号,不做公式计算,不启动额外后台服务,也没有安装时下载脚本。
5
+ 发行包提供 Node.js 安装入口和 npm 平台包:入口只选择与平台相符、版本完全相同的程序,原样传递参数、标准输入输出、退出状态及取消信号,不做公式计算,不启动额外后台服务,也没有安装时下载脚本。
6
6
 
7
7
  公开 Actions 只接受手动触发与 `release.json` 中固定的源码 SHA,用只读 Deploy Key 临时检出私有源码。构建日志不公开,artifact 只含三份已逐字节核对的程序,保留一天;不上传源码、完整构建 manifest、业务语料或测试结果。npm 发布在三个平台包全部准备并检查后串行进行,主包最后发布。
8
8
 
9
- 发布前检查包文件清单、权限、许可、平台选择及错误路径;在 macOS ARM64 上从打包文件进行干净安装,核对版本、标准输入、会话和退出行为。公开发布后再从 registry 实际安装核对。Windows 和 macOS x64 的程序本体复用既有验证,安装入口在这些系统上的实际 npm 安装尚未重跑,不将本机检查外推为三平台新验收。
9
+ 发布前检查包文件清单、权限、许可、平台选择及错误路径;在 macOS ARM64 上从打包文件进行干净安装,核对版本、标准输入、会话和退出行为。公开发布后再从 registry 实际安装核对。历史三平台验收按版本保留,安装入口在这些系统上的实际 npm 安装尚未重跑,不将本机检查外推为三平台新验收。
10
10
 
11
11
  包内示例是合成数据或另附许可的第三方 fixture,不含私有业务工作簿。公开仓库不包含核心源码、源码构建脚本、测试、内部证据或其提交历史。
12
12
 
package/README.md CHANGED
@@ -30,7 +30,7 @@ excel-kit version
30
30
  excel-kit help
31
31
  ```
32
32
 
33
- 当前版本应返回 `cli: "0.9.0"`、`protocol: 1`。帮助首页是索引,`excel-kit help <名称>` 查询具体命令、操作或函数。
33
+ 当前版本应返回 `cli: "0.10.0"`、`protocol: 1`。帮助首页是索引,`excel-kit help <名称>` 查询具体命令、操作或函数。
34
34
 
35
35
  ### 3. 交给 agent 使用
36
36
 
@@ -40,7 +40,7 @@ excel-kit help
40
40
 
41
41
  > 把我的学习用预算模型滚动到下一期间,保留公式、格式和打印设置;更新给出的假设,并核对总金额。
42
42
 
43
- `SKILL.md`、`reference/` 和 11 个[配方](recipes/README.md)也包含在 npm 安装目录中。全局安装目录可用 `npm root -g` 查找,其下的 `@dztabel/excel-kit/` 就是说明目录。使用配方前将其复制到工作目录,按对应 README 执行。
43
+ `SKILL.md`、`reference/` 和 12 个[配方](recipes/README.md)也包含在 npm 安装目录中。全局安装目录可用 `npm root -g` 查找,其下的 `@dztabel/excel-kit/` 就是说明目录。使用配方前将其复制到工作目录,按对应 README 执行。
44
44
 
45
45
  ## 调用方式
46
46
 
@@ -61,7 +61,7 @@ excel-kit help script
61
61
 
62
62
  ## 范围与版本
63
63
 
64
- 0.9.0 主要降低大工作簿的内存占用,并修正查找空值、透视结果读取与 EXP 舍入问题。实际验证、发行例外和资源边界见 [VALIDATION.md](VALIDATION.md),版本变化见 [CHANGELOG.md](CHANGELOG.md)。
64
+ 0.10.0 新增图表系列和统计图、透视规则、跨工作簿局部迁移、两版内容比较、会话试算、精细重读和文字截断检查。实际验证、发行例外和资源边界见 [VALIDATION.md](VALIDATION.md),版本变化见 [CHANGELOG.md](CHANGELOG.md)。
65
65
 
66
66
  不执行 VBA,不编辑加密文件,不提供多工作簿依赖求值。具体函数边界见 [函数限制](reference/function-limits.md),未支持范围见 [unsupported.md](reference/unsupported.md)。脚本不是安全沙箱,只运行可信代码。内存与时间取决于文件结构,不能保证所有大表都在固定预算内完成。
67
67
 
package/SKILL.md CHANGED
@@ -1,101 +1,52 @@
1
1
  ---
2
2
  name: excel-kit
3
- description: 需要在本地读取、编辑、重算并保存 XLSX/XLSM 工作簿,且已安装 excel-kit 命令或解压程序包时使用。
3
+ description: 用 ExcelKit 处理本地 XLSX/XLSM。适用于 agent 需要了解陌生工作簿、核对两个版本、编辑公式与原生对象、试算方案或交付可继续编辑的 Excel 文件时。
4
4
  ---
5
5
 
6
- # excel-kit
6
+ # ExcelKit
7
7
 
8
- npm 安装后运行 `excel-kit <命令>`。以下命令以此为例;ZIP 用户在包目录用 `./excel-kit`(Windows 是 `.\excel-kit.exe`)替代命令名。`run`、`query` 这类命令读一份 JSON 请求文件;每个响应在标准输出上占一行 JSON,大的输出先存文件再解析取字段,按行用 `head` 截不短它。先 `excel-kit inspect input.xlsx` 看有哪些工作表与对象,再把要做的事写成一份请求:
8
+ 先用 `excel-kit inspect <文件>` 找工作表、名称、Table、对象及文件版本。把任务拆成要查明的事实、要改的对象和验收用的格或绑定。用 `excel-kit help find <英文关键词>` 找入口,再用精确帮助查字段。一次能说清的修改写进 `run` 的 `operations`,把验收用的 `read` 放在同一次计算里。独立程序包在当前目录用 `./excel-kit`,Windows 用 `.\excel-kit.exe`。
9
9
 
10
- ```sh
11
- cat > edit.json <<'EOF'
12
- {"input":"input.xlsx","output":"output.xlsx",
13
- "operations":[{"op":"write","sheet":"Sheet1","range":"B2","values":[[1200]]}],
14
- "read":[{"sheet":"Sheet1","range":"B10","form":"compact"}]}
15
- EOF
16
- excel-kit run edit.json > edit.out.json
17
- ```
10
+ ### 1. 确定输入与输出
18
11
 
19
- 只读不改用 `query`:请求里同样写 `read`,没有 `output`。输出旁的 `.excel-kit-*.lock.guard.sqlite` 是写入锁留下的,不是交付物,也不要删。操作名与参数查 `excel-kit help <名字>`。动手前要知道的是下面八条;其余按文末的表读一篇。
12
+ `preflight` 执行并核对一次拟议的修改,返回已绑定版本的执行请求。需要确认覆盖、迁移或影响范围时使用。一次 `run` 原子发布到 `output`。替换已有文件必须给出 `overwrite.expectedVersion`。[编辑、预检与保存](reference/editing-and-saving.md)
20
13
 
21
- ## 契约
14
+ ### 2. 选择执行方式
22
15
 
23
- ### 1. `run` 是事务
16
+ 步骤已知,用一次 run。多个分别计成败的步骤用 `batch`。需要根据中间值判断、循环或断言,用 `script` 和 `strict:true`。跨调用积累未保存编辑用 `session`;在当前状态探索多个情景,用 `session.script` 的 `trial:true` 取回结果。以 `output.saved` 确认文件实际发布。[脚本](reference/scripts.md) · [会话、试算与重读](reference/sessions.md)
24
17
 
25
- 读入 `input`、执行 `operations`、计算、写出并读回核对、原子替换 `output`,任何一步失败都不动 `output`。`output` 已存在就拒绝,除非在 `overwrite.expectedVersion` 给出它当前的版本;核对的是写出的文件与内存一致,不是与 Excel 一致。
18
+ ### 3. 读值时确认来源
26
19
 
27
- ### 2. 四种调用方式
20
+ 紧凑读取的公式格看 `s`。本次计算为 `result`,历史保存值为 `cache`,已失效为 `invalidated`,没有可用值为 `unavailable`。需要解释差异时先看公式和输入,再查上下游。[读取与取值](reference/reading.md) · [双文件比较与续页](reference/paging.md)
28
21
 
29
- 默认用一次 `run`,改动、计算、读取写进同一份请求。其余三种:
22
+ ### 4. 决定要算多少
30
23
 
31
- - `batch`:多个写好的步骤各自成败。默认一步失败就都不发布;`commit:"successful"` 允许只发布成功的步骤,这时返回 `ok:false`、`status:"partial"`。
32
- - `script`:下一步取决于上一步的结果。正常返回后尝试发布成功的步骤;失败的 `wb.run` 只是没生效,不影响外层的 `ok`,要看 `script.stepFailures`;抛错、超时等才整体回滚。`strict:true` 让失败的 `wb.*` 抛错:不捕获就整体回滚并带出原错误,捕获了就只是那次没生效。
33
- - `session`:跨调用保留工作簿,可另存多份。`session.run` 只改内存,失败的一步不留痕迹;`session.save` 才写文件,没保存就结束则修改丢弃。
24
+ 中间编辑用 `none`,核对指定指标用 `targets`,交付要求整本当前结果时用 `all` 并检查完整性。缺普通公式值时自动模式可以设置 `fullCalcOnLoad`,手动模式要读警告。[计算范围](reference/calculation.md) · [交付核对](reference/deliverable.md)
34
25
 
35
- 批次和脚本有没有写文件,看 `output.saved`。
26
+ ### 5. 用响应决定下一步
36
27
 
37
- ### 3. 值的来源
28
+ 先看业务响应的 `ok` 和 `error`,会话从 `result.response` 取。再看计算状态、目标格是否为 Excel 错误值,以及步骤是否实际保存。根据错误提供的位置和恢复建议重选范围、补绑定或修改请求。[错误恢复](reference/errors.md) · [审计与依赖](reference/audit.md)
38
29
 
39
- 紧凑读取(`"form":"compact"`,数据在 `rows`,`cells` 是空数组)里公式格是 `{"f","v","s"}`。`s` 为 `result` 才是本次请求算出的当前值;`cache` 是文件里存着的上次结果;`invalidated` 是被本次修改作废的存值,`v` 仍是旧数;`unavailable` 是没有值。`result` 只出现在算它的那次请求里:刚算好并保存的值,下一次不计算的读取里就是 `cache`。
30
+ ### 6. 控制读取和计算成本
40
31
 
41
- ### 4. 计算方式
32
+ 先取一个有代表性的范围。续页绑定版本,将同一轮需要的编辑和读数组合起来。遇到超时先检查计算范围、步骤数与 `timeoutMs`,上限见 capabilities 的 `limits`。[成本与期限](reference/cost.md)
42
33
 
43
- - `all`:尝试整本计算;不完整也发布可得结果,`ok:true`、`calculation.status:"incomplete"`,并给 `CALCULATION_INCOMPLETE` 警告。要旧的拒绝行为,在请求顶层写 `requireCompleteCalculation:true`。
44
- - `targets`:算列出的格及其全部上游,只保证这些格。其余受本次修改影响的普通公式在文件里没有值(警告 `FORMULAS_WITHOUT_VALUES`),不重算的读取方看到的就是没有值。
45
- - `none`:不做最后的重算,受影响的普通公式同上;操作自己要当前值时仍会就地算一小块。
34
+ ### 7. 查本机能力并组合
46
35
 
47
- 普通公式缺值保存时,`auto/autoNoTable` 自动设 `fullCalcOnLoad:true`(覆盖原 false/缺省);手动模式保留并警告。模拟运算表失效缓存仍保留,`autoNoTable` 仍需人工重算。完整不可得清单在发布时给出的 JSONL 文件,读法见 [deliverable.md](reference/deliverable.md)。
36
+ `inspect` 给工作簿事实,`capabilities` 给当前程序识别的名称,`help <精确名称>` 给请求契约。按对象用 `help query.<种类>` 查可读取的状态,然后选修改操作,再确定如何验证。例如迁移模型区块前用 `help compare` 定位内容差异,查 `help range.transfer` 了解源绑定和目标覆盖授权,必要时用 `preflight`。涉及某个函数时单查 `help fn.<函数名>`。[跨簿绑定](reference/external-links.md) · [函数边界](reference/function-limits.md)
48
37
 
49
- 省略 `calculation`:`run`、`preflight`、`audit` 是 `all`;批次步骤、`session.run`、`wb.run` 沿用批次根、`session.open`、脚本请求上的那个;读取和查询不沿用,读取默认 `none`。
38
+ ### 8. 验证选中的对象
50
39
 
51
- ### 5. 取值与判失败
40
+ 批量选择先核对地址、名称或系列身份。`expectedMatches` 只能断言数量;按公式当前值选择时指定 `source:"calculation"`。用版本绑定后的结果复核实际目标,再决定提交。[条件选择](reference/selection.md)
52
41
 
53
- 先看 `ok`;失败的响应不保证有成功时的字段。
42
+ ## 按任务深入
54
43
 
55
- - `run`、`preflight`、`read`、`query`:错误在顶层 `error`。读取在顶层 `ranges`,其他查询在同名键。读取算不完整时 `ok:false` 而没有 `error`,看 `calculation`。
56
- - `batch`:每步在 `batch.steps[i]`,读取在其 `result.ranges`,错误在其 `error`;整批中止或执行前被拒才有顶层 `error`,后者没有 `batch`。
57
- - `script`:返回值在 `script.result`,错误在顶层 `error`。
58
- - 会话:每行应答的 `result.response` 才是业务响应,错误在其 `error`;`session.run` 的读取在其 `result.ranges`。
59
-
60
- 协议层成功不等于做成了:JSON-RPC 应答有 `result`、退出码 0 只说明请求被处理,它顶层的 `error` 只报协议错误。`ok:true` 也要看:保存步骤和 `query` 的 `calculation.status` 都可以是 `incomplete`;算完整了、`s` 是 `result` 的值也可以是 `{"e":"#DIV/0!"}` 等错误值。
61
-
62
- ### 6. 什么贵
63
-
64
- 贵的是步数与整本重算:每个写步骤都把整本写出再读回核对,每次读取、查询都重新解析整本;只要少数结果用 `targets`,中间步骤用 `none`。默认期限 30 秒(`timeoutMs`,上限 300000)。硬上限在 `capabilities` 的 `limits`。
65
-
66
- ### 7. 怎么查
67
-
68
- - `help` 是索引;`help <名字>` 查一项,主题、操作、原生编辑用本名,其余带类别前缀,如 `query.<种类>`、`session.<方法>`、`wb.<成员>`、`fn.<函数名>`;`help all <主题>` 给全文;`help find <词…>` 按名字和描述找。
69
- - `capabilities`:程序认得的全部名字,不保证参数都能算。
70
- - `inspect <文件>`:工作簿概况与文件版本,不计算;其余对象用 `query` 查。
71
- - `preflight`:把同一份 `run` 请求在内存里完整做一遍而不写文件。它查输出目录在不在、`output` 是否已存在;不占写入锁,不查能否写入,不保证之后没人改文件。
72
-
73
- ### 8. 选择与数量断言
74
-
75
- `query` 的 `select` 与 `selection.edit` 用同一套条件。`expectedMatches` 只核对个数:个数相符不证明选中的是你要的对象,改完看 `selections[i].targets`。条件涉及公式的值要写 `source:"calculation"`,否则公式的值算未知,整个条件因此判不出时,查询标 `status:"incomplete"`,`selection.edit` 整步拒绝。文本的值比较区分大小写,数字与文本不互转(`"001"` 不等于 `1`);写错不报错,只是选错。
76
-
77
- ## 下一跳
78
-
79
- 参数与字段只在 `help` 里。`reference/` 下每篇只讲一个主题里推不出来的语义,按情形读一篇:
80
-
81
- | 情形 | 读 |
44
+ | 需要判断的事 | 按需阅读 |
82
45
  |---|---|
83
- | 读单元格、在代码里取值 | `reference/reading.md` |
84
- | 一页读不完、要续页(`READ_TOO_LARGE`、`VERSION_REQUIRED`) | `reference/paging.md` |
85
- | 写请求、覆盖文件(`OUTPUT_EXISTS`)、预检、批次、`FILE_BUSY` | `reference/editing-and-saving.md` |
86
- | 按条件选出或批量修改 | `reference/selection.md` |
87
- | 决定算多少、读懂计算范围 | `reference/calculation.md` |
88
- | 核对交付件;公式没有值(`FORMULAS_WITHOUT_VALUES`);要 Excel 打开时重算 | `reference/deliverable.md` |
89
- | 慢、超时(`*_TIMEOUT`)、工作簿大 | `reference/cost.md` |
90
- | 计算不完整警告或严格拒绝(`CALCULATION_INCOMPLETE`),要找源头与影响范围 | `reference/audit.md` |
91
- | 宏、加密、模拟运算表等不支持项,怎样向用户说明 | `reference/unsupported.md` |
92
- | 某个函数算不出来或与 Excel 不同 | `reference/function-limits.md` |
93
- | 不认识的错误码、错误里的 `suggestions` | `reference/errors.md` |
94
- | 下一步取决于上一步的结果 | `reference/scripts.md` |
95
- | 边看边改、一次打开交付多份 | `reference/sessions.md`,可运行的驱动在 `reference/session-loop.md` |
96
- | 工作表或工作簿受保护 | `reference/protection.md` |
97
- | 有透视表或切片器 | `reference/pivots.md` |
98
- | 公式引用别的工作簿 | `reference/external-links.md` |
99
- | 自己实现会话的客户端 | `reference/api.md` |
100
-
101
- 现成的脚本在 `recipes/README.md`,验证范围在 `VALIDATION.md`。
46
+ | 指标在分组、总计和刷新之后如何计算 | [透视与切片器](reference/pivots.md) |
47
+ | 交付前检查换行文字、图表系列或原生规则 | [版面与对象](reference/presentation.md) |
48
+ | 能否编辑受保护的区域,怎样恢复权限 | [保护](reference/protection.md) |
49
+ | 写自己的会话客户端 | [协议与调用方式](reference/api.md) · [逐条应答驱动](reference/session-loop.md) |
50
+ | 文件含宏、外部来源或不受支持的对象 | [保留与计算边界](reference/unsupported.md) |
51
+
52
+ 程序包的 `recipes/README.md` 索引可运行的组合示例,`VALIDATION.md` 说明该版本的实测范围。
package/VALIDATION.md CHANGED
@@ -1,4 +1,11 @@
1
- # 0.9.0 验证范围
1
+ # 0.10.0 验证范围
2
+
3
+ Windows 11 上的 Microsoft Excel 16.0 build 20326 已对新增的图表系列、原生统计图、透视分组与过滤以及展示规则进行编辑并保存复核。组合示例中,迁移后的公式和图表随数量调整从 36 变为 42;条件透视总计从 0.27 变为 0.5。合并标题在 15 磅行高下截断,在 70 磅下完整显示。文字截断查询使用布局估计。固定版 SDK 对部分 Excel 接受的统计图分箱标记仍报告差异。
4
+
5
+ 本版沿用开发时的源码回归和定向复核,共 3,099 个有效用例有通过记录,5 项既有跳过。随包说明按专题核对,组合示例实际交付可编辑文件。发行安装核对另见 DISTRIBUTION.md。
6
+
7
+ ## 0.9.0 历史验证范围
8
+
2
9
 
3
10
  本版降低大工作簿的计算与保存内存占用,修正查找空值、原生透视结果读取及 EXP 舍入问题。这里区分实际通过、有效历史证据复用和仍保留的例外;不把程序成功保存等同于整本公式都与 Excel 一致。
4
11
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dztabel/excel-kit",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
4
4
  "description": "Read, edit, calculate and save Excel workbooks from your agent or terminal.",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
6
  "repository": { "type": "git", "url": "git+https://github.com/dztabel-happy/excel-kit.git" },
@@ -13,9 +13,9 @@
13
13
  "cpu": ["arm64", "x64"],
14
14
  "files": ["bin/", "SKILL.md", "reference/", "recipes/", "VALIDATION.md", "CHANGELOG.md", "DISTRIBUTION.md", "THIRD-PARTY-NOTICES.txt", "release.json"],
15
15
  "optionalDependencies": {
16
- "@dztabel/excel-kit-darwin-arm64": "0.9.0",
17
- "@dztabel/excel-kit-darwin-x64": "0.9.0",
18
- "@dztabel/excel-kit-win32-x64": "0.9.0"
16
+ "@dztabel/excel-kit-darwin-arm64": "0.10.0",
17
+ "@dztabel/excel-kit-darwin-x64": "0.10.0",
18
+ "@dztabel/excel-kit-win32-x64": "0.10.0"
19
19
  },
20
20
  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" }
21
21
  }
package/recipes/README.md CHANGED
@@ -18,6 +18,8 @@
18
18
  | R10 | [inventory-media](inventory-media/README.md) | 清点图片与附件并提取核对 | `image-extract`、`attachment-extract` |
19
19
  | R11 | [edit-protected-workbook](edit-protected-workbook/README.md) | 保存无口令保护权限、编辑并恢复核对;带口令时拒绝 | 先 `run prepare.json` 准备示例 |
20
20
 
21
+ [修复模型并试算两个情景](repair-and-test-model/README.md)使用同一份工作簿组合版本比较、局部迁移、试算、精细重读、条件透视与布局检查。
22
+
21
23
  ## 写自己的脚本时
22
24
 
23
25
  - **能事先写全就不用脚本。** 一份 `run` 把改动、计算、读取写在一起;脚本只用在下一步取决于上一步结果的时候。
@@ -0,0 +1,13 @@
1
+ # 修复模型并选择一个情景
2
+
3
+ 在空目录生成基准、工作副本和来源模板,最终交付 `delivery.xlsx` 与 `report.json`。示例需要 Python 3;所有工作簿读取、修改和计算均由 ExcelKit 执行。
4
+
5
+ 从程序包根目录运行:
6
+
7
+ ```sh
8
+ python3 recipes/repair-and-test-model/workflow.py ./model-output --cli ./excel-kit
9
+ ```
10
+
11
+ Windows 使用 `py -3` 和 `.\excel-kit.exe`。安装在 PATH 时可省略 `--cli`。
12
+
13
+ 先比较同一矩形中的公式与输入。示例在目标会话已有未保存编辑的情况下,验证替换范围、来源绑定、当前版本,然后迁入含合并标题、费率公式和图表的区块。两个试算分别得到 36 和 54,仅提交 36。脚本再刷新条件透视指标,调高显示不全的标题行,核对汇总值后保存。报告记录了每次选择所依据的内容差异,以及调用者需要重新读取的范围和图表。
@@ -0,0 +1,108 @@
1
+ """Run in an empty output directory. Python orchestrates the public ExcelKit CLI."""
2
+ import argparse
3
+ import json
4
+ from pathlib import Path
5
+ import subprocess
6
+
7
+
8
+ def main(directory, cli):
9
+ directory.mkdir(parents=True, exist_ok=True)
10
+ source, baseline, working, delivery = [str(directory / (name + ".xlsx"))
11
+ for name in ("source", "baseline", "working", "delivery")]
12
+
13
+ def invoke(command, request):
14
+ p = subprocess.run([*cli, command, "-"], input=json.dumps(request), text=True, capture_output=True)
15
+ result = json.loads(p.stdout)
16
+ if not result["ok"]:
17
+ raise RuntimeError(result)
18
+ return result
19
+
20
+ def write(sheet, cell, *rows):
21
+ return dict(op="write", sheet=sheet, range=cell, values=rows)
22
+
23
+ def formula(text):
24
+ return {"formula": "=" + text}
25
+
26
+ def name(sheet, address):
27
+ return dict(op="name.set", name="Rate", reference=sheet + "!" + address)
28
+
29
+ chart = dict(op="chart.create", sheet="Model", name="Charges", type="column",
30
+ series=[dict(categories="Model!A2:A3", values="Model!C2:C3")],
31
+ anchor=dict(kind="oneCell", **{"from": {"cell": "F2"}}, width=260, height=140))
32
+ original = invoke("run", dict(create=dict(sheets=["Model"]), output=source, operations=[
33
+ write("Model", "A1", ["Review\ncharges\nby region"]),
34
+ dict(op="merge", sheet="Model", range="A1:C1"),
35
+ dict(op="format", sheet="Model", range="A1", style=dict(alignment=dict(wrapText=True),font=dict(bold=True))),
36
+ write("Model", "A2", [10,2,formula("A2*B2*Rate")],[7,3,formula("$A2+A$2+$A$2")]),
37
+ write("Model", "H1", [4]), name("Model","$H$1"),chart]))
38
+ invoke("run",dict(create=dict(sheets=["Model","Data","Summary"]), output=baseline, operations=[
39
+ write("Model","A2",[5,None,4]),write("Model","A6",[3]), write("Model","B1",[1.5]),name("Model","$B$1"),
40
+ write("Model","E6",[formula("C6*D6*Rate")]), write("Model","C6",[10,2]),
41
+ dict(op="layout",sheet="Model",rows=[dict(start=5,count=1,height=15)]),
42
+ write("Data","A1",["Region","Cost","Qty"],["East",-1.25,1],["East",-1.20,1],["West",3,0]),
43
+ dict(op="table.create",sheet="Data",name="Inputs",range="A1:C4")]))
44
+ broken = invoke("run",dict(input=baseline,output=working,operations=[write("Model","E6",[30])]))
45
+ difference = invoke("compare",dict(left=baseline,right=working,sheet="Model",range="C5:E7"))
46
+ assert difference["total"] == 1 and difference["items"][0]["left"]["content"]["type"] == "formula", difference
47
+
48
+ # A receiving session can contain other work before the repair starts.
49
+ with subprocess.Popen([*cli,"session"],stdin=subprocess.PIPE,stdout=subprocess.PIPE,text=True) as proc:
50
+ seq = 0
51
+ def rpc(method, **params):
52
+ nonlocal seq
53
+ seq += 1
54
+ message = dict(jsonrpc="2.0",id=seq,method="session."+method,params=dict(sessionId="model",**params))
55
+ proc.stdin.write(json.dumps(message) + "\n")
56
+ proc.stdin.flush()
57
+ response = json.loads(proc.stdout.readline())["result"]["response"]
58
+ if not response["ok"]:
59
+ raise RuntimeError(response)
60
+ return response
61
+
62
+ rpc("open",input=working,output=delivery,expectedInputVersion=broken["output"]["version"],reread="precise")
63
+ edit = rpc("run",**write("Summary","A9",["Reviewed"]))
64
+ version = edit["outputVersion"]
65
+ move = dict(op="range.transfer",sheet="Model",cell="C5",chart="Charges",
66
+ source=dict(path=source,sheet="Model",range="A1:C3",expectedVersion=original["output"]["version"]),
67
+ bindings=[dict(**{"from":"Rate","to":"Rate"})],replaceRange="C5:E7",expectedTargetVersion=version)
68
+ move_script = "const step = await wb.run(args.move); return step.result.rangeOperations[0].transfer;"
69
+ # The exact replacement can be tried against the current unsaved model.
70
+ plan = rpc("script",expectedSessionVersion=version,trial=True,strict=True,script=move_script,arguments={"move":move})
71
+ assert plan["outputVersion"] == version
72
+ rpc("run",expectedSessionVersion=version,**move)
73
+ scenario = """
74
+ const step = await wb.run({operations:[{op:"write",sheet:"Model",range:"C6",values:[[args.units]]}],
75
+ calculation:{mode:"targets",targets:[{sheet:"Model",range:"E6"}]},read:[{sheet:"Model",range:"E6"}]});
76
+ return step.result.ranges[0].cells[0][0].result.value;
77
+ """
78
+ values = [rpc("script",trial=True,strict=True,script=scenario,arguments=dict(units=n))["result"] for n in (12,18)]
79
+ assert values == [36,54], values
80
+ chosen = rpc("script",strict=True,script=scenario,arguments=dict(units=12))
81
+ assert chosen["result"] == 36
82
+ rpc("run",op="pivot.create",sheet="Summary",cell="A1",name="Costs",source="Inputs",rows=["Region"],
83
+ calculatedFields=[dict(name="UnitCost",formula="IF(Qty=0,0,ROUND(ABS(Cost/Qty),2))")],
84
+ values=[dict(field="UnitCost",name="Unit cost")])
85
+ rpc("run",operations=[write("Data","B2",[-1.27]),dict(op="pivot.refresh",sheet="Summary",name="Costs"),
86
+ dict(op="chart.refresh",sheet="Model",name="Charges")])
87
+ layout = dict(sheet="Model",range="C5:E5",axis="textClipping")
88
+ clipped = rpc("query",layout=[layout])["layout"][0]["items"]
89
+ assert len(clipped) == 1 and clipped[0]["range"] == "C5:E5", clipped
90
+ rpc("run",op="layout",sheet="Model",rows=[dict(start=5,count=1,height=70)])
91
+ assert rpc("query",layout=[layout])["layout"][0]["total"] == 0
92
+ final = rpc("read",ranges=[dict(sheet="Model",range="E6:E7"),dict(sheet="Summary",range="B2:B4")],calculation=dict(mode="all"))
93
+ values_seen = [[r[0]["result"]["value"] if r[0].get("result") else r[0]["input"]["value"] for r in area["cells"]] for area in final["ranges"]]
94
+ assert values_seen == [[36,12],[1.24,0,0.27]], values_seen
95
+ receipt = rpc("save")
96
+ rpc("close")
97
+ proc.stdin.close()
98
+ report = dict(changedCell=difference["items"][0],transfer=plan["result"],scenarios=values,selectedUnits=12,
99
+ committedCharge=chosen["result"],reread=chosen["reread"],clipping=clipped,pivotAndFormulaValues=values_seen,output=receipt["output"])
100
+ (directory/"report.json").write_text(json.dumps(report,indent=2)+"\n")
101
+
102
+
103
+ if __name__ == "__main__":
104
+ parser=argparse.ArgumentParser(description=__doc__)
105
+ parser.add_argument("directory",type=Path)
106
+ parser.add_argument("--cli",nargs="+",default=["excel-kit"])
107
+ args=parser.parse_args()
108
+ main(args.directory.resolve(),args.cli)
package/reference/api.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 会话协议
2
2
 
3
- 给自己实现 `excel-kit session` 客户端的人;只用命令行不需要读这一篇。字段查 `excel-kit help`;调用方式的契约在 `SKILL.md`,会话怎样用见 [sessions.md](sessions.md)。
3
+ 给从 Bun 程序里调用 excel-kit、或自己实现 `excel-kit session` 客户端的人;只用命令行不需要读这一篇。字段查 `excel-kit help`;调用方式的契约在 `SKILL.md`,会话怎样用见 [sessions.md](sessions.md)。
4
4
 
5
5
  ## 1. 会话协议
6
6
 
@@ -54,6 +54,6 @@
54
54
 
55
55
  响应 `ok:false` 是 1,其中 `error.code` 为 `CANCELLED` 是 130,其余是 0。所以 0 不等于做成了:一次性脚本有失败步骤、甚至一步都没成功时是 0;会话在输入结束后退出也是 0,不论其中有多少业务失败。
56
56
 
57
- ## 3. Node.js 与其他客户端
57
+ ## 3. 客户端接入
58
58
 
59
- 本发行包提供独立命令行程序,不导出内核库。使用子进程调用 CLI,或通过标准输入输出连接上述会话协议。Node.js 可用 `child_process.spawn`;参数用数组传入,不需要 shell。
59
+ 使用子进程调用 CLI 或连接会话协议。版本前置条件、试算与重读见 [sessions.md](sessions.md)。
@@ -9,7 +9,7 @@
9
9
  3. `output.version` 是写出文件的 SHA-256。会话里它与会话版本相等,就确认了写出的内容,不必重新打开。
10
10
  4. 结构性结果(工作表次序、可见性、保护、名称)对交付件 `inspect` 或 `query`。
11
11
  5. 关键数值用紧凑读取,确认 `s` 是 `result`。对交付件不计算地读,读到的是存值(`cache`);要当前值就让这次读取计算。
12
- 6. 要证明"其他内容没变",用同一份读取请求(`none`、紧凑形式)分别读原件和交付件,在本地逐格比较,只比任务可能影响到的区域。
12
+ 6. 核对输入与公式的变化用 [compare](paging.md)。样式、对象和布局另查对应属性。
13
13
 
14
14
  ## 一步之后,每个公式存的是什么
15
15
 
@@ -59,8 +59,8 @@
59
59
 
60
60
  `run` 的 `calculation.unavailable` 给 `count/formulaCount/byReason/examples(≤10)/stepId/report`;计算不可得与保存缺值是两项不同统计,多个原因的计数也不能相加当格数。报告 `{path,sha256,records}` 指向本次发布的独立 JSONL 文件;批次提交、session.save、一次性脚本在顶层 `calculationReport` 给聚合文件。会话步骤只给统计与 stepId,清单先留在内存;预检不写报告文件。
61
61
 
62
- 文件第一行是头:schemaVersion、最终输出版本、各步骤 inputVersion/outputVersion、计算条件及摘要、不可得格数 count、压缩记录数 records、recordsSha256 与同次保存核验。之后每行是一条区域记录,带 stepId/sheetId/sheet/range/count/reasons/owner/savedValue。每步按表序、行、列排列,同原因/同保存状态/同所有者的横向连续格压成一段,不跨空隙。
62
+ 首行记录版本、计算条件、不可得格数 count、压缩条数 records、recordsSha256 与保存核验。之后逐行列出区域及原因、所有者和存值状态,按步骤、表、行、列排序。
63
63
 
64
- 先核对文件的 SHA-256 与响应一致,再从第二行开始按行分批读取(例如每 1000 行一页);保留每行原始 UTF-8 字节及换行。按 stepId 分组核对记录条数 records、展开格数 count 与原始记录行的 SHA-256(recordsSha256),并检查区域无重叠。这样取完整份清单,不需调用 query 或重新计算。发布文件与报告应一起保留;报告本身存在不能证明工作簿已经发布,仍看 output.saved/version 与批次 publication。
64
+ 核对文件 SHA-256 后流式读第二行起的记录。按 stepId 核对 records、count、区域无重叠及原始 UTF-8 行(含换行)的 recordsSha256。保留文件与报告,以 output.saved/version 与批次 publication 确认发布。
65
65
 
66
66
  `fileVerification.calculation` 给本次 computedFormulas/computedResults、missingFormulas/missingResults、historicalResults、computedSha256 和 outputVersion;computedSha256 是表序/行/列顺序的 `[sheetId,cell,type,value]` JSON UTF-8 行摘要(每行末尾 LF)。保存核验逐格确认写出值与本次模型一致;这不等于与 Excel 真值一致。不可把保留的 historical 值当本次计算结果,也不能用后一次 query 或 Excel 重算替代同次保存依据。
@@ -1,16 +1,14 @@
1
1
  # 错误码
2
2
 
3
- 先按 `SKILL.md` 第 5 条判失败。表里没有的码,先看响应自己的 `error.message` 与 `error.details`,再用 `help find <词>` 找相关的帮助。文件名都在 `reference/` 下。
3
+ 先看 `error.message` 与 `error.details`,用 `help find <词>` 查相关帮助。
4
4
 
5
5
  ## `details.suggestions` 的读法
6
6
 
7
7
  超时与读取超限的错误在 `details.suggestions` 里给出候选的改法,`details.hints` 写明字段该放在哪里。
8
8
 
9
- - 每项有 `path`(改哪里)和 `condition`(适用条件与操作顺序),另有 `set`(要设置或替换的小对象)或 `request`(可以独立发送的只读请求)。
10
- - **不要把 `set` 当作整份请求发出去**:按 `path` 改对应的层级,保留其余的输入、编辑、版本、输出与计算环境。
9
+ - 按 `condition` 判断适用条件,按 `path` 合并局部修改 `set`,保留输入、编辑、版本与计算环境。`request` 可作为独立只读请求。
11
10
  - 简写的步骤先把原操作包成 `operations:[原操作]`(原生编辑是 `nativeEdits`);旧式查询先删 `calculate` 再设 `calculation`。
12
- - 每项至多 1024 字符,合计至多 4096;缩减或省略时 `details.suggestionsTruncated:true`。候选不回显编辑的数据、公式或脚本文本,也不是可以盲目执行的恢复计划。
13
- - 脚本里:`strict` 下在 `error.details.cause.details`,否则在 `error.details.lastCallFailure.details`;其余详情过大被省去时有 `detailsOmitted:true`。
11
+ - 单项限 1024 字符,合计 4096;截断见 `details.suggestionsTruncated`。脚本错误路径见末节。详情过大时有 `detailsOmitted:true`。
14
12
 
15
13
  ## 请求与读取
16
14
 
@@ -33,3 +33,7 @@
33
33
  - 删除会让后面仍在使用的链接改变序号时,报 `EXTERNAL_LINK_RENUMBERING`。换一个删除次序。
34
34
  - 无法按 XML 解析的旧式 VML 绘图部件里,任何 `[n]`(包括注释和普通文字里的)都算作使用,这时可能保守地拒绝删除。
35
35
  - 仍删不掉的,请用户在 Excel 里断开链接。
36
+
37
+ ## 从另一份工作簿迁入可独立工作的区块
38
+
39
+ 用 `help range.transfer` 查看矩形、图表与映射契约。先定位来源,再为区外引用和名称逐个选择目标绑定;两簿同名的定义可以指向不同输入。将变换后的公式与系列落点纳入核对。非空目标须根据预检确认的精确矩形、当前目标版本授权。会话里可用试算预检未保存版本。遇到跨区对象时缩小范围或选择整表导入。
@@ -57,3 +57,7 @@ while True:
57
57
  print(len(rows))
58
58
  EOF
59
59
  ```
60
+
61
+ ## 找两个版本之间的内容变化
62
+
63
+ 用 `help compare`。比较单元格输入与展开后的公式,先缩到可疑的同名表与矩形。首批响应给出两份文件版本,续页同时传回两者。若只改名定义、格式或对象,应改查相应对象;若同值公式变常量,比较会直接列出两侧类型。
@@ -38,3 +38,9 @@ const values = step.result.ranges[0].cells;
38
38
  ## 报告时
39
39
 
40
40
  依赖未刷新透视的公式有值,但只与透视保存的结果一致。报告里要写明:公式已按工作簿当前保存的透视结果重新计算;透视未刷新,其与当前来源的一致性未获确认。列出哪些值依赖透视;来源变过(`PIVOT_NOT_REFRESHED`、`refresh_required`)的,请用户在 Excel 里刷新后再采信。打开时刷新的透视,引用它的公式不可得,`all` 默认仍发布其他可靠结果并给清单;`requireCompleteCalculation:true` 才拒绝。
41
+
42
+ 本地来源透视的 `pivot.create`、`pivot.set` 支持以下定义,`query.pivots` 的 `settings` 可读回。改源数据后执行 `pivot.refresh`。
43
+
44
+ - `dateGroups:[{field:"Date",by:"quarters"},{field:"Date",by:"years",name:"Year"}]` 以季度和年分组。在行字段中依次引用 Year、Date。最细级沿用来源字段名,较粗级取唯一名称。支持年、季、月、日。
45
+ - `rules:[{type:"captionBeginsWith",field:"Team",value:"North"},{type:"topN",field:"Team",measure:"Revenue",count:1}]` 在当前透视过滤标签并按指定度量排名。并列边界保留所有命中的成员。
46
+ - `calculatedFields:[{name:"Unit price",formula:"Sales/Units"}]` 声明计算字段,随后在 `values` 中按字段名引用。分组和总计均先汇总来源字段,再计算比值。条件费率、零分母与舍入指标可组合数值比较、IF、ABS 和 ROUND。先手算同组多行的分组合计和总计,再对照刷新结果;函数形状查 `help pivot.create calculatedFields`。
@@ -0,0 +1,11 @@
1
+ # 版面与对象
2
+
3
+ 固定行高的换行文本可以用 `help query.layout` 的 `axis:"textClipping"` 查。观察报告中的地址、合并范围和以磅计的可用及估计所需高度。未取得当前公式结果的格会报告无法判断,需要时在同一查询对该格指定 targets。可先在受保护的表上检查,挑出值得调整的行,再决定是否修改行高。调整后用相同范围复查。
4
+
5
+ ## 已有图表、透视与规则的局部编辑
6
+
7
+ 先以 `query.charts` 定位工作表内的图表名称、系列 `index` 与来源。用 `chart.set.seriesEdit` 指定一个系列。例如 `{"index":1,"sources":{"values":"Data!D2:D4"},"marker":{"symbol":"diamond","size":6}}` 会同时更新系列来源和标记。线图和散点图可设置 `linearTrendline` 与 `fixedErrorBars`,传 `null` 可删除。点覆盖使用 `point.index` 和 `point.appearance`,传空外观值可清除覆盖。
8
+
9
+ 在 `chart.create` 中指定 `type:"histogram"` 或 `type:"boxWhisker"`、本地单列或单行数值来源 `series:[{values:"Data!A1:A5"}]`,并传入绘图锚点。直方图用 `binning:{width:3}` 或 `binning:{count:4}`,箱线图用 `quartileMethod:"exclusive"` 或 `"inclusive"`。已有图可用 `chart.set` 改设置,用 `chart.refresh` 从当前工作簿刷新数值缓存。Excel 保存后可能把来源写为隐藏定义名称,查询返回文件实际绑定。对带分箱设置的直方图,Excel 使用分箱元素的 `val` 属性;固定版 Open XML SDK 的严格校验可能在该元素上同时报属性与文本诊断。
10
+
11
+ `conditional-format.set` 的 `condition` 支持 `{kind:"average",equal:true}` 和 `{kind:"time-period",period:"today"}`。数据条在同一条件对象传 `negativeColor`、`axisPosition` 和 `direction`。列表验证的 `showDropdown` 放在 `validation.set` 操作顶层,false 隐藏箭头。用 `query.rules` 查定义,`query.ruleResults` 查当前输入的匹配结果。
@@ -1,12 +1,12 @@
1
1
  # 脚本
2
2
 
3
- 脚本什么时候发布、失败留下什么,见 `SKILL.md` 第 2 条;请求的键与 `wb` 的成员查 `help script`、`help wb.<成员>`。本文讲写脚本时推不出来的事。现成的脚本见包里的 `recipes/README.md`。
3
+ 发布方式见入口第 2 条;请求字段与成员查 `help script`、`help wb.<成员>`。可运行脚本见包内 `recipes/README.md`。
4
4
 
5
5
  ## 请求与脚本体
6
6
 
7
7
  - 脚本是 JavaScript **异步函数体**,不是模块:可以用顶层 `await` 和 `return`,不能 `import`、`export`。参数是 `wb` 和 `args`(请求里的 `arguments`)。长脚本放进文件用 `scriptPath`。
8
8
  - 只读的脚本也必须写 `output`,给一个不存在的路径;没有成功的 `wb.run` 就不写文件,`output.saved:false`。
9
- - 会话里用 `session.script`:键相同但不含打开的键,正常返回只更新会话里的工作簿,仍要 `session.save`。
9
+ - `session.script` 在未保存状态上执行。默认保留成功修改,`session.save` 才写盘;`trial:true` 只带回结果并恢复原状态。见[会话](sessions.md)。
10
10
  - 修改只有 `wb.run` 一条路,用的是与 `run` 相同的操作。`wb` 没有通用文件接口:CSV 用 `data` 操作导入工作表再读回,图片与附件用 `image-extract`、`attachment-extract` 命令提取。
11
11
 
12
12
  ## 默认写 `strict:true`
@@ -46,3 +46,9 @@ EOF
46
46
  ## 结束与取消
47
47
 
48
48
  标准输入关闭后,会话做完已经收到的请求,丢弃没保存的状态,退出码 0。取消一条请求用通知 `{"jsonrpc":"2.0","method":"$/cancel","params":{"id":<请求 id>}}`。信号、并发与协议错误见 [api.md](api.md)。
49
+
50
+ ## 试算与提交
51
+
52
+ 先记下当前版本。用 `help session.script` 的 `trial:true` 在该版本及其未保存编辑上试算。脚本只返回所需的普通 JSON。应答中的试算结果属于该情景,之后仍可在同一基准上换参数。选定后以原版本为 `expectedSessionVersion` 正常执行,再保存。
53
+
54
+ 需要增量读取时查 `help session.open`,打开时设 `reread:"precise"`。成功编辑后按 `reread.version` 重读列出的范围和图表对象。返回整簿时重新查询整簿。试算恢复后不发变更提示。
package/release.json CHANGED
@@ -1,40 +1,40 @@
1
1
  {
2
- "version": "0.9.0",
2
+ "version": "0.10.0",
3
3
  "protocol": 1,
4
4
  "runtime": {
5
5
  "name": "Bun",
6
6
  "version": "1.4.2"
7
7
  },
8
- "sourceCommit": "2b0432997cc1d68f30eddf78648197d257b5c361",
9
- "builtAt": "2026-11-15T02:36:02.054Z",
10
- "sourceDigest": "4b54b86467b76b5a47e6cdbe0b967f96dbbdbfd634cf34bc3dd5b36ecff728e0",
11
- "binaryRebuild": false,
8
+ "sourceCommit": "55f6609f5fb719aa27ac2c0359bf7c7e7cd316ab",
9
+ "builtAt": "2026-11-19T08:51:39.008Z",
10
+ "sourceDigest": "2fb39e6a6058ec215c5ceb4ae854b6cdbae72c595e237add6dba595fb9895b9a",
11
+ "binaryRebuild": true,
12
12
  "artifacts": [
13
13
  {
14
14
  "platform": "macos-arm64",
15
15
  "binary": "excel-kit",
16
- "bytes": 94656498,
17
- "sha256": "6ee295691e30c622ad1e37aebb930b72b3085df2eb32c972bb3db67d89df31e0",
16
+ "bytes": 94920690,
17
+ "sha256": "2df9951126122207ed906129a197ace22d015760414ef36261e1e7c476dcd0a9",
18
18
  "build": {
19
- "inputs": "10e3ed5c6f4897b40031ed4c4197db3e6fde3ce0f806568e888e03ddc1319c7c"
19
+ "inputs": "3edf226cc46a302a442109e94d97e0d43358935f66ab0ab7abd6eaa472aedffa"
20
20
  }
21
21
  },
22
22
  {
23
23
  "platform": "macos-x64",
24
24
  "binary": "excel-kit",
25
- "bytes": 101511440,
26
- "sha256": "452e94386788d83f0f75cf0028074a5a0698184a972ce5f8e75b727f82b61773",
25
+ "bytes": 101773584,
26
+ "sha256": "4380e4de7bc45c50e7af31b6e887d1e0dd09c0b8e79e6801a0af862f654b3ea9",
27
27
  "build": {
28
- "inputs": "41504f3e90c43dd919e379497316cf52179c09711b877d21fd091ae80fc278cd"
28
+ "inputs": "b876cb8bc55824e8f3fc81ca811e083002ad5ee0a2b80794cc66de88545c2bf9"
29
29
  }
30
30
  },
31
31
  {
32
32
  "platform": "windows-x64",
33
33
  "binary": "excel-kit.exe",
34
- "bytes": 118278144,
35
- "sha256": "25a12c8356fbb7a30a0bc58ef9b16c994d37a7c680364267cc8c603ab113533f",
34
+ "bytes": 118537728,
35
+ "sha256": "c4ce062913292b9f4de865db66de1919bcaba2eb3ce2fe173f9a29cc8c0830f1",
36
36
  "build": {
37
- "inputs": "532fdde35d5b84adec09d0abb69026e79265f2e893f6739f982815166f176507"
37
+ "inputs": "f9c05dc52f7d13ccdbe6ebe38d6b85a6d30d4985355559b43323a8fd21e14be2"
38
38
  }
39
39
  }
40
40
  ]