核心用法
Calculator Skill 是一个轻量级 Python 计算脚本，通过命令行直接调用 calc.py 执行数学表达式求值。用户只需将表达式作为字符串参数传入，即可快速获得计算结果。
基本调用格式：
python3 <skill-path>/scripts/calc.py "<expression>"
典型示例：
- 基础运算：
"2 + 3 * 4"→ 14（遵循标准运算优先级） - 括号分组：
"(2 + 3) * 4"→ 20 - 开方运算：
"sqrt(144)"→ 12 - 幂运算：
"2^8"或"2**8"→ 256 - 百分比计算：
"1000 * 5%"→ 50 - 三角函数：
"sin(pi/2)"→ 1（弧度制） - 对数运算：
"log(1000)"→ 3（以10为底）
---
显著优点
1. 功能覆盖全面：涵盖基础四则运算、幂/根运算、百分比计算、三角函数（sin/cos/tan）、对数（log/ln）、绝对值、取整（round/floor/ceil）等常用数学功能，满足日常到进阶的计算需求。
2. 语法简洁直观：支持 ^ 和 ** 两种幂运算符号，隐式乘法（如 2(3) 自动解析为 2*3），以及常用数学常数 pi 和 e，降低学习成本。
3. 精度控制合理：浮点结果自动保留10位小数，有效避免 Python 浮点运算的常见精度问题，同时保持输出可读性。
4. 零依赖轻量实现：纯 Python 脚本实现，无需额外安装数学库，启动速度快，资源占用极低。
---
潜在局限
1. 输入安全风险：直接传递用户输入至 Python eval() 或类似机制执行（根据实现推测），若未严格过滤表达式内容，存在代码注入隐患，不建议处理不可信来源的输入。
2. 弧度制局限：三角函数强制使用弧度制，对习惯角度制的用户需手动转换（deg * pi / 180），缺少原生角度模式切换。
3. 功能边界明确：不支持方程求解、矩阵运算、符号计算等高级数学功能，定位为快速数值计算器而非数学软件。
4. 错误反馈简略：命令行工具特性决定其错误提示可能不如图形计算器友好，复杂表达式调试依赖用户经验。
---
适合人群
- 开发者/技术人员：需要快速验证数值计算、调试公式逻辑
- 学生/教育工作者：完成数学作业、验证习题答案
- 日常办公用户：替代系统计算器进行批量或复杂计算
- 脚本自动化场景：作为工作流中的计算环节嵌入 Shell/Bash 脚本
---
常规风险提示
| 风险类型 | 说明 |
|---------|------|
| 输入注入 | 避免直接拼接用户输入到表达式，建议白名单校验或沙箱执行 |
| 精度误解 | 10位小数截断非四舍五入到绝对精确，金融级精度需求需谨慎 |
| 依赖环境 | 依赖系统 Python3 环境，版本差异可能导致细微行为不同 |