dsh-math-calculator 2.1.1 → 2.2.0

package/src/ops/units-op.ts

@@ -34,7 +34,20 @@ import {
 import { CalcError, safeNumberForJson, type MathArgs, type Outcome } from './shared.js'
 
 /** 量纲的展示顺序（先写日常用的）。 */
-const ORDER: Dimension[] = ['length', 'mass', 'time', 'area', 'volume', 'energy', 'power', 'temperature', 'speed']
+const ORDER: Dimension[] = [
+  // 力学与几何
+  'length', 'mass', 'time', 'area', 'volume',
+  'energy', 'power', 'temperature', 'speed', 'pressure',
+  'force', 'angle', 'data', 'frequency',
+  // 电学
+  'current', 'charge', 'voltage', 'capacitance', 'resistance',
+  'conductance', 'magnetic_flux', 'magnetic_flux_density', 'inductance',
+  // 光学
+  'solid_angle', 'luminous_intensity', 'luminous_flux', 'illuminance',
+  // 化学与核物理
+  'amount_of_substance', 'activity', 'absorbed_dose',
+  'dose_equivalent', 'catalytic_activity',
+]
 
 /**
  * 把作者传来的自定义单位规范化。
@@ -144,8 +157,30 @@ export function opUnits(args: MathArgs): Outcome {
   }
 
   // ── 情形 A：列清单 ──
+  /**
+   * ## 为什么默认只给摘要
+   *
+   * 单位收到 287 条后，全量展开一次是 17000+ 字符 —— 那是**每轮对话都占上下文**的东西，
+   * 而调用方通常只想确认「有没有我要的那条」。
+   *
+   * 所以默认给「每个量纲几条约数 + 几个样例」，要看全表就传 `unitScale`
+   * （如 `unitScale:"length"`）。这与 help 的取向一致：**用到时才读**。
+   */
   if (!hasFrom && !hasTo) {
-    lines.push('══════ 可用单位 ══════')
+    const wantedDimension = typeof args.unitScale === 'string' ? args.unitScale.trim().toLowerCase() : ''
+    const expandDimension =
+      wantedDimension === ''
+        ? null
+        : ORDER.find(function (d) { return d === wantedDimension || DIMENSION_LABEL[d] === wantedDimension }) ?? null
+    if (wantedDimension !== '' && expandDimension === null) {
+      throw new CalcError(
+        'invalid_argument',
+        '不认识的量纲「' + wantedDimension + '」',
+        '可用: ' + ORDER.map(function (d) { return d + '(' + DIMENSION_LABEL[d] + ')' }).join(' / '),
+      )
+    }
+
+    lines.push('══════ 可用单位（共 ' + (UNITS.length + custom.length) + ' 条）══════')
     lines.push('')
     if (custom.length > 0) {
       lines.push('【本项目的自定义单位】')
@@ -161,23 +196,62 @@ export function opUnits(args: MathArgs): Outcome {
     for (const dimension of ORDER) {
       const items = [...custom.filter(function (u) { return u.dimension === dimension }), ...UNITS.filter(function (u) { return u.dimension === dimension })]
       if (items.length === 0) continue
-      lines.push('【' + DIMENSION_LABEL[dimension] + '】（基准单位 ' + BASE_UNIT[dimension] + '）')
-      for (const unit of items) {
-        const aliases = (unit.aliases || []).length > 0 ? '（别名：' + unit.aliases!.join('、') + '）' : ''
+      /** 展开只针对点名的那一维；其余给计数与样例。 */
+      if (expandDimension === dimension) {
+        /**
+         * 展开时**按用途分两段**：度量衡在前（绝大多数调用者要这个），
+         * 科学单位在后并标明。混排会让「找三丈是多少米」的人翻过一堆 eV。
+         */
+        const measureItems = items.filter(function (u) { return u.category !== 'science' })
+        const scienceItems = items.filter(function (u) { return u.category === 'science' })
         lines.push(
-          '  ' + unit.name.padEnd(10) + ' = ' + showFactor(unit.factor).padEnd(22) +
-          BASE_UNIT[dimension] + aliases,
+          '【' + DIMENSION_LABEL[dimension] + '】（基准单位 ' + BASE_UNIT[dimension] + '）' +
+          '共 ' + items.length + ' 条：度量衡 ' + measureItems.length + ' / 科学 ' + scienceItems.length,
+        )
+        for (const unit of measureItems) {
+          const aliases = (unit.aliases || []).length > 0 ? '（别名：' + unit.aliases!.join('、') + '）' : ''
+          lines.push(
+            '  ' + unit.name.padEnd(12) + ' = ' + showFactor(unit.factor).padEnd(22) +
+            BASE_UNIT[dimension] + aliases,
+          )
+          if (unit.note) lines.push('      · ' + unit.note)
+        }
+        if (scienceItems.length > 0) {
+          lines.push('  ── 科学单位（专业计算用，正文里通常不写）──')
+          for (const unit of scienceItems) {
+            const aliases = (unit.aliases || []).length > 0 ? '（别名：' + unit.aliases!.join('、') + '）' : ''
+            lines.push(
+              '  ' + unit.name.padEnd(12) + ' = ' + showFactor(unit.factor).padEnd(22) +
+              BASE_UNIT[dimension] + aliases,
+            )
+          }
+        }
+        lines.push('')
+      } else {
+        /** 摘要行也标出度量衡/科学的条数——不展开也能看出这条量纲的分界。 */
+        const measureCount = items.filter(function (u) { return u.category !== 'science' }).length
+        const scienceCount = items.length - measureCount
+        const sample = items.slice(0, 5).map(function (u) { return u.name }).join('/')
+        lines.push(
+          '  ' + DIMENSION_LABEL[dimension].padEnd(4) + BASE_UNIT[dimension].padEnd(6) +
+          ('度量衡 ' + measureCount).padEnd(9) +
+          ('科学 ' + scienceCount).padEnd(7) + '例：' + sample + (items.length > 5 ? '/…' : ''),
         )
-        if (unit.note) lines.push('      · ' + unit.note)
       }
-      lines.push('')
     }
+    if (expandDimension === null) {
+      lines.push('【看某一类的全部单位】')
+      lines.push('  传 unitScale:"length" / "mass" / "volume" / …（也可用中文名如 "长度"）')
+    }
+    lines.push('')
     lines.push('【怎么换算】')
     lines.push('  {operation:"units", unitValue:30, unitFrom:"里", unitTo:"km"}')
     lines.push('  → 30 里 = 15 km')
     lines.push('')
     lines.push('注：中文古制单位历朝不同，内置值取最常见近似；要精确到某朝代，')
     lines.push('    用 customUnits 覆盖（如 {name:"里",dimension:"length",factor:576}）。')
+    lines.push('    同一名字在两套体系里数值不同的（加仑、担、石、马力），')
+    lines.push('    已分两类收（gal/gal_uk、hp/hp_metric），按 note 区分。')
     return {
       result: lines.join('\n'),
       value: toJsonValue({
@@ -228,6 +302,48 @@ export function opUnits(args: MathArgs): Outcome {
   }
   const c = outcome.conversion
 
+  /**
+   * `terse`：只回「A = B」一行。
+   *
+   * ## 为什么让 terse 对 units 也生效
+   *
+   * 实测反馈（2026-11-06）：`{operation:"units", terse:true}` 返回仍是 6 行带框，
+   * terse 对 units **没有任何压缩效果** —— 而 units 的输出本来就有
+   * 「代入过程 + 注意」两段可省的内容。
+   *
+   * ## 但**注意**那一段不能省，只压缩格式
+   *
+   * 与批量一致：terse 承诺的是「省掉标题与统计」，不是省掉风险。
+   * 「里在周制约 415 m」这类适用域提示如果被省掉，
+   * 调用方会拿一个用错朝代的值去写设定 —— 那比多几行更糟。
+   * 所以 terse 下保留内容，只去掉竖排与空行。
+   */
+  if (args.terse === true) {
+    const terseLines: string[] = []
+    terseLines.push(show(c.value) + ' ' + c.from.name + ' = ' + show(c.result) + ' ' + c.to.name)
+    if (implicitOne) terseLines[0] = '（未给 unitValue，按 1 计）' + terseLines[0]
+    /**
+     * 适用域提示合并成一行 —— 它们在 terse 下仍必须出现，
+     * 只是不再逐条占一行。
+     */
+    if (c.warnings.length > 0) terseLines.push('⚠ ' + c.warnings.join('；'))
+    return {
+      result: terseLines.join('\n'),
+      value: toJsonValue({
+        mode: 'convert',
+        dimension: c.dimension,
+        value: safeNumberForJson(c.value),
+        from: c.from.name,
+        to: c.to.name,
+        result: safeNumberForJson(c.result),
+        steps: c.steps,
+        warnings: c.warnings,
+        implicitOne: implicitOne,
+        terse: true,
+      } as never),
+    }
+  }
+
   lines.push('══════ 单位换算 ══════')
   lines.push('')
   if (implicitOne) {

package/src/ops/workspace-op.ts

@@ -213,6 +213,16 @@ export function opWorkspace(args: MathArgs): Outcome {
             next.variables = { ...next.variables, ...args.workspaceVariables }
           }
           if (args.description) next.description = args.description
+          /**
+           * 命名变量是否参与计算（默认关闭）。
+           *
+           * 单独一个开关而不是「存了就用」，是为了让这条状态变化是**显式的一次动作**：
+           * 打开它会让同一个调用在不同工作区状态下给出不同结果，
+           * 调用方应当知道自己在换掉什么。
+           */
+          if (args.useWorkspaceVariables !== undefined) {
+            next.useWorkspaceVariables = Boolean(args.useWorkspaceVariables)
+          }
           /**
            * 显示精度固化。
            *

package/src/playbook.ts

@@ -295,18 +295,43 @@ export function buildPlaybook(state: {
  * @param state - 工作区状态
  * @returns 精简提示词
  */
+/**
+ * brief 档的指令集（每轮都随注入下发，**每个字都在付费**）。
+ *
+ * ## 字数按「使用频率 × 重要程度」分配
+ *
+ * 曾经的问题是比例失调：整段 817 字符里，「世界推演」占了 360（44%），
+ * 而它只对做架空世界设定那类会话有用 —— 算术、单位换算、统计这些
+ * **高频场景完全用不到**，却要为它每轮付 360 字符。
+ *
+ * 现在按三档分配：
+ *
+ * | 内容 | 频率 | 重要度 | 字数 |
+ * |---|---|---|---|
+ * | 行为约束（必须调用 / 不要心算） | 每轮 | 极高 | ~40 |
+ * | 该用哪个 operation（最常问） | 极高 | 高 | ~70 |
+ * | 可信度标签怎么读 | 中 | 极高 | ~60 |
+ * | 精度两层 | 中 | 高 | ~50 |
+ * | 世界推演分工（低频，压到极限） | 低 | 中 | ~80 |
+ *
+ * ## 顺手修掉两处自相矛盾
+ *
+ * 原第 5 条说「输出默认全精度（几十位小数）」、第 6 条说「默认 8 位小数」——
+ * 两条并列下发，模型读到的是互相冲突的指令。**8 位才是现状**（2.1.0 起），
+ * 「全精度」那句是过时表述，已删。
+ *
+ * @param state - 工作区状态（改过的常数、自创量）
+ * @returns 指令集文本
+ */
 export function buildBriefPlaybook(state: {
   changedConstants?: string[]
   customConstants?: number
 }): string {
   const out: string[] = []
-  out.push('**世界推演：底座算数，你判断与表达。**')
-  out.push('- 该算的调 `derivation`（pipeline/civilization/dead/observer/backSolve/chaos）与 `custom`')
-  out.push('- 该写的（结语、描写、叙事判断）由你生成，别照抄工具输出')
-  out.push('- 硬约束（物质不存在等）如实说；叙事选择（要巨兽、要灵能）不反驳，只讲代价')
-  out.push('- 算不出来的别编，标待定或问用户')
-  out.push('- 工具输出默认是**全精度**（可能几十位小数），是供你取舍的原料。**保留几位你来定**：读者只要感觉就少给，要核对就多给，要接着算就管够。别把 60 位抄给读者，也别把该精确的整数（如 10^20+5）截成科学计数法')
-  out.push('- 工具输出默认按**小数点后 8 位**显示（整数永远完整，如 10^20+5 不会被截）。需要更多位就单次传 `displayPrecision`；想全局换一档用 `{operation:"workspace", action2:"set", displayPrecision:N}` 固化一次。注意 `precision`（计算精度）不要调低，它一低大数就会算错')
+  // 低频内容压到 120 字符内。四句话的语义一个不少，只是去掉重复的修饰。
+  out.push('**世界推演：底座算数，你判断表达。**')
+  out.push('- 算：`derivation`（pipeline/backSolve/dead/observer/chaos）；写：结语叙事你生成')
+  out.push('- 硬约束如实说；叙事选择不反驳只讲代价；算不出的别编，标待定')
   if ((state.changedConstants ?? []).length > 0) {
     out.push('- 本区改过常数，先跑 dimensionless 确认不是单位重定义')
   }