跳到主内容

dsh-tool-calculator 使用指南

安全的数学表达式求值器,零依赖递归下降解析器。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

安全的数学表达式求值器,零依赖递归下降解析器。

— 源: plugins.ai_summary

安装与验证

dsh plugin --profile web add github:omdsh-dev/dsh-tool-calculator

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 词法层只识别数字字面量、白名单标识符、运算符;引号、分号、反引号、{} [] 直接报错
  • 标识符按名查白名单表(15 个函数 + 2 个常量),查不到即抛 Unknown identifier
  • 求值结果必须是有限数字,NaN/Infinity(除零、负数开方等)统一拒绝
  • src/index.ts:Cordis 插件入口(name/inject/apply),注册 calculator 工具
  • src/evaluate.ts:evaluate(expression: unknown): number——入口独立校验类型(非字符串抛 calculator: expression must be a string),返回有限数字,非法输入全部抛错

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则