dsh-math-calculator 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 与 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [2.1.1] — 2026-10-28
+
+紧急修复 **2.1.0 会让工具不可用**的问题。
+
+### 修复
+
+- **`notice` / `cached` 未在输出 schema 声明，导致调用失败**。
+
+  宿主用 `additionalProperties: false` **校验**工具输出。2.1.0 的代码会产出
+  `notice`（显示精度提示、精度不足提醒）与 `cached`（缓存命中标记），
+  但 `OUTPUT_SCHEMA` 里没有声明这两个字段，于是宿主拒绝整次调用：
+
+  ```
+  Error: tool "math_execute" returned invalid output:
+         "value.notice" is not a declared property (additionalProperties: false)
+  ```
+
+  触发条件是**任何带小数的结果**（默认 8 位小数下几乎每次都会产出 notice），
+  也就是说 2.1.0 装上去基本不能用。
+
+  **为什么单元测试没发现**：测试直接调 `runMathTool`，拿到的是普通对象，
+  不经过宿主那层 schema 校验 —— 77 套全绿，而真实宿主一调就废。
+  这是「测试走的路径与真实调用路径不同」的典型盲区。
+
+### 新增
+
+- **输出字段声明守卫**（`test/integration.mjs`）：断言 `MathResult` 能产出的
+  每个字段都已在 `output.schema` 声明，并实跑一次会产出 `notice` 与 `cached`
+  的调用。以后再加字段忘了声明，这条会红。
+
 ## [2.1.0] — 2026-10-28
 
 公式库扩到 404 条、新增天体目录与类型学、工具定义瘦身 21%，并把「计算精度」与

package/README.md

@@ -47,7 +47,7 @@ npm run build
 
 ```powershell
 npm pack
-& "...\dsh.cmd" plugin --profile desktop add ./dsh-math-calculator-2.1.0.tgz
+& "...\dsh.cmd" plugin --profile desktop add ./dsh-math-calculator-2.1.1.tgz
 ```
 
 ---

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-math-calculator",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "main": "lib/index.js",
   "description": "DSH 原生数学与架空世界推演插件：高精度计算、342 条公式、常数与星球推演。",
   "engines": {

package/lib/index.js

@@ -2285,6 +2285,16 @@ const OUTPUT_SCHEMA = {
         precision: { type: 'integer', required: true, description: '使用的精度' },
         value: { type: 'json', description: '机器可读结果' },
         variables: { type: 'object', additionalProperties: true, description: '本次使用的变量' },
+        /**
+         * 附加提示（渲染时展示，不进 `result`）。
+         *
+         * ⚠️ 必须声明在这里。宿主用 `additionalProperties: false` **校验**工具输出，
+         * 漏一个字段就会让整次调用判为「invalid output」而失败 ——
+         * 实测踩过：加了 notice 却忘了声明，`bodies` 调用直接被宿主拒绝。
+         */
+        notice: { type: 'string', description: '附加提示（显示精度/精度不足等）' },
+        /** 结果来自缓存（未重算）。同样必须声明，否则命中缓存时调用失败。 */
+        cached: { type: 'boolean', description: '是否命中缓存' },
         error: {
             type: 'object',
             additionalProperties: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-math-calculator",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "private": false,
   "description": "DSH 原生的高精度数学计算器插件：BigNumber 64 位求值、符号微积分、线性代数（秩/零空间/奇异值/特征值）、统计概率与回归、微分方程、单位换算、395 条公式库（三轴标签）、物理常数推演。全部本地执行，不联网。附带一组可选的世界观推演工具。",
   "type": "module",

package/src/index.ts

@@ -2575,6 +2575,16 @@ const OUTPUT_SCHEMA = {
     precision: { type: 'integer', required: true, description: '使用的精度' },
     value: { type: 'json', description: '机器可读结果' },
     variables: { type: 'object', additionalProperties: true, description: '本次使用的变量' },
+    /**
+     * 附加提示（渲染时展示，不进 `result`）。
+     *
+     * ⚠️ 必须声明在这里。宿主用 `additionalProperties: false` **校验**工具输出，
+     * 漏一个字段就会让整次调用判为「invalid output」而失败 ——
+     * 实测踩过：加了 notice 却忘了声明，`bodies` 调用直接被宿主拒绝。
+     */
+    notice: { type: 'string', description: '附加提示（显示精度/精度不足等）' },
+    /** 结果来自缓存（未重算）。同样必须声明，否则命中缓存时调用失败。 */
+    cached: { type: 'boolean', description: '是否命中缓存' },
     error: {
       type: 'object',
       additionalProperties: false,