一、App 是什么

一款"能自己造公式"的计算器。

内置基础计算 + 自定义公式管理 + 子公式复用 + 标签分类 + 工具箱 + 笔记备忘 + 语音播报，全部数据本地存储，不上传服务器。

二、主界面导航

打开 App 进入主页面，顶部标题栏：

· 左上角 ⏱：历史记录（点开看计算历史）
· 右上角 ⋮：菜单（使用帮助 / 关于我们）

显示屏：结果和输入显示区，深色底。

中间功能区：

· 公式计算：进入公式列表
· 笔记备忘：进入备忘录
· 🔊 / 🔇：语音播报开关
· ⌫：退格
· AC：清空

键盘区：数字 + 运算符（+ − × ÷ ^ √ % ( )），底部 = 计算。

操作逻辑：

· 按数字、运算符输入表达式
· 按 = 出结果
· 算完后按运算符 → 自动用上次结果继续算
· 算完后按数字 → 另起一行
· 负数：点键盘上的 .- 格右半边（我们刚加的）

三、公式列表页

从主页面点 「公式计算」 进入。

顶部：

· < 返回
· ⏱ 数据记录（进去看每条公式保存的计算记录）
· 鹤鸣公式列表（标题）
· ∞（导入/导出/公式库菜单）

功能按钮：

· 工具箱：6 个小工具（分数、日期、养老金、单位换算、金融、个税）
· 添加自定义公式：新建公式

筛选行：

· 全部：显示所有公式
· 最近：最近用过的公式
· 标签    按标签筛选
· 标签：进入标签管理

搜索框：输入关键词搜公式（支持拼音首字母）

公式列表：

· 点：进入计算页面
· 长按：弹出操作菜单

四、长按公式的操作菜单

操作 作用
修改 编辑公式
标签 给公式打标签
置顶 移到列表最前
下移 往下移一位
删除 删除公式（二次确认）

五、核心：如何建立自定义公式

第 1 步：进入「添加自定义公式」

公式列表页 → 点「添加自定义公式」。

第 2 步：填写基础信息

字段 说明 例子
公式名称 显示在列表里的名字 长方形面积
提示 公式说明，帮助用户理解 输入长和宽
公式标签 分类（可多选） 几何
图片 可选，上传示意图 一张图

第 3 步：添加参数（输入变量）

点 「添加参数」 → 填：

· 变量名：公式里用的符号，建议用英文或单字（如 a、r、长）
· 显示名：用户看到的名称（如 半径(mm)）
· 默认值：可选，用户不填时的默认数
· 预设表：可选，关联预设数据表（选单位、材料等）

提示：变量名可以是英文或中文，但中文变量名建议 1~2 个字，太长表达式难写。

第 4 步：添加结果（输出项）

点 「添加结果」 → 填：

· 变量名：结果符号（如 S、面积）
· 显示名：用户看到的名称
· 表达式：核心，公式怎么写
· 显示此结果：开关，关掉则此结果参与计算但不显示（用于中间变量）

第 5 步：写表达式（核心）

点进表达式编辑框，用专用键盘输入：

支持的运算符：

· + 加、- 减、× 乘、÷ 除
· ^ 乘方
· √(...) 开方
· % 百分号（自动转 ÷100）
· ( ) 括号

支持的内置函数（全部角度单位为度）：

函数 含义
sin(x) / cos(x) / tan(x) 三角函数
asin(x) / acos(x) / atan(x) 反三角
ln(x) 自然对数
log(x) / lg(x) 常用对数
ABS(x) 绝对值
FACT(x) 阶乘（最大 170!）
round(x[,n]) 四舍五入，n 保留位数
ROUNDUP(x) 向上取整

支持的常量：

· π 圆周率
· e 自然常数
· φ 黄金分割比

表达式示例：

· 圆面积：π×r^2 或 3.14*r*r
· 油缸推力：3.14*活塞杆直径*(油泵压力/2)^2/10000
· 两点距离：√((x2-x1)^2+(y2-y1)^2)

书写注意：

· ❌ 2(3+4) → ✅ 2*(3+4)（乘号不能省略）
· ❌ (5+6 → ✅ (5+6)（括号要配对）
· ❌ 中文括号 （5+6） → ✅ 英文 (5+6)
· 变量名必须先添加为参数，表达式里才能引用

第 6 步：保存

点右上角 「保存」。名称不能重复。

六、子公式（一条公式，多套逻辑）

什么场景用子公式？

同一个公式名，但有多种计算路径。典型例子：

「圆」公式，用户可能：

· 已知半径求面积周长
· 已知直径求面积周长
· 已知周长求半径面积
· 已知面积求半径周长

不同已知条件，参数和结果都不一样。用子公式就能一个「圆」下面挂 4 套。

如何建立子公式

1. 进入「添加自定义公式」（或修改已有公式）
2. 页面中间有 「公式：」 一行，显示当前子公式（默认一个「公式」）
3. 点右边的 「✏」按钮 → 进入 子公式管理页
4. 在管理页：
   · 点「-」 删除某个子公式（至少保留 1 个）
   · 点子公式名 → 改名
   · 底部输入框 + 「+」 → 新增子公式
5. 保存后返回

每个子公式独立配置

关键：每个子公式独立有自己的参数和结果。

· 切到「已知半径」→ 加参数 r、结果 S、C
· 切到「已知直径」→ 加参数 d、结果 S、C
· 互不干扰

用的时候怎么切

在公式计算页面顶部有一行 「公式：」 标签栏：

· 显示所有子公式名
· 点某个名字 → 切换，参数和结果都跟着变

注意事项

· 子公式至少保留 1 个
· 子公式之间参数互相独立（不共享）
· 旧版公式（没有子公式）打开时会自动包装成 1 个子公式，但保存时不写回（保持旧格式兼容）

七、计算页（使用公式）

从公式列表点某个公式 → 进公式计算页面

页面结构：

· 顶部：公式名 + < 返回 + 🖩（回主计算器并带回结果）
· 图片：如果公式配了图，显示
· 子公式标签栏：多子公式时显示
· 提示：* 开头的红色提示
· 输入参数：每个参数一行，点行 → 键盘弹起
· 结果：显示每个结果的值（隐藏的结果不显示）
· 底部：
  · 清空
  · 计算（主按钮）
  · ^ / v（键盘展开/收起）
· 键盘：数字 + .-（含负数）

操作：

1. 逐项填参数（点行 → 键盘输 → 换行）
2. 填完点「计算」
3. 结果显示在下方
4. 点结果可复制

「整体保存」：点「结果」行右侧的「整体保存」→ 命名 → 把本次输入 + 结果存成一条数据记录。

「🖩」按钮：计算完成后点它 → 回到主计算器，结果带过去，可以继续算。

八、其他功能速览

工具箱（6 个）

· 分数计算器：可视化分数四则运算
· 日期计算：日期差值、日期推算
· 养老金计算器：职工/居民养老估算
· 单位换算：长度/面积/体积/重量/压强/温度/功率/速度/时间/角度/数据
· 金融计算器：存款、贷款
· 个税计算器：工资薪金个税

笔记备忘

· 新建笔记（标题 + 内容）
· 笔记列表（需要生物识别认证）
· 导出/导入 .hmy 备份
· 密码保护

数据记录

· 查看所有保存的计算记录
· 展开看输入/结果
· 复制、删除、清空

公式库

· 内置公式包：几何、工程、材料、实用、数学、电气
· 勾选导入到自己的公式列表

导入导出

· 导出所有公式为 .hm 文件
· 导入 .hm 文件追加公式（重名跳过）

语音播报

· 主页面 🔊 开关
· 开启后按键有音效，= 后逐位读出结果

九、常见问题

Q1：输入 2(3+4) 报错
A：乘号不能省略，写 2*(3+4)。

Q2：自定义公式的变量识别不到
A：变量要先在「添加参数」里定义，表达式里才能引用。

Q3：子公式不生效
A：子公式要各自配置参数和结果，参数不共享。

Q4：历史、笔记数据丢失
A：卸载/清数据会清空本地数据，重要内容用导出备份。

Q5：语音没声音
A：检查手机媒体音量，主页点喇叭打开语音。

十、声明
· 所有数据保存在本地，不上传服务器