#BodyMate｜MoonBit 基础库套件与全身参考应用

English summary. lqyq666/bodymate ships four dependency-free MoonBit packages you can moon add individually — agent (a guard that turns untrusted LLM proposals into allowlisted commands with bounded numeric fields, or nothing), zhnum (Chinese numeral parsing, formatting and in-text normalization), anatomy (376 bilingual Human Atlas / BodyParts3D terms with laterality and search) and motion (parameterized motion sessions with deterministic pose intents) — plus an offline full-body Three.js reference application that proves the same MoonBit code drives the browser, a local AI proxy and command-line examples. Published on mooncakes.io; API docs are in the library README.

moon add lqyq666/bodymate

#各库三行上手

// agent：模型提议 → 受控动作
let allowed = @agent.parse_allowlist("push_up^handWidth,elbowAngle~squat^stanceWidth")
@agent.guard_command("push_up", [("handWidth", 1.8), ("invented", 7.0)], allowed) // Command("push_up", [("handWidth", 1.8)])
@agent.guard_command("run_marathon", [], allowed)                                  // None

// zhnum：中文数字 → 数字
@zhnum.normalize_numerals("手距一点五倍肩宽，夹角六十度，深度百分之八十") // "手距1.5倍肩宽，夹角60度，深度80%"
@zhnum.quantity_before_unit("夹角六十度", ["度", "°"])                  // Some(60.0)

// anatomy：拉丁名 → 中文，含侧别与检索
@anatomy.structure_name_zh("Left femur", @anatomy.kind_from_string("bone")) // "左侧股骨"
@anatomy.search_structures(entries, "腰大肌")                               // 肌肉优先的匹配列表

// motion：中文指令 → 类型化参数 → 确定性姿态
let parsed = @motion.parse_query("push_up", "手距一点五倍肩宽，夹角六十度", []).unwrap()
@motion.pose_intent("push_up", 0.5, parsed.values)                          // 同输入同输出

#四个不依赖网页的可运行示例

moon run moonbit/examples/parameters --target js   # 中文参数解析与越界调整
moon run moonbit/examples/sessions --target js     # 两个会话独立播放与暂停
moon run moonbit/examples/sampling --target js     # 五个相位的确定性姿态采样
moon run moonbit/examples/export --target js       # 四库串联：指令 → 护栏 → 命名 → 姿态帧 CSV

#生态贡献与边界

• 补空缺，不重复：截至 2026-09-16，mooncakes.io 上没有面向 LLM 应用的动作白名单原语，中文数字方向只有“数字→中文大写金额”的格式化包而没有反向解析库，也没有解剖学术语字典；这三项都是从真实应用需求中抽出的、边界清晰的独立包。
• 单一事实来源：术语表、护栏规则、动作目录只存在于 MoonBit；浏览器与 Node 侧的 JavaScript 只做字符串编解码（见 架构）。
• 可验证：MoonBit 76 项测试、Node 143 项测试、生成物新鲜度检查、冻结人体资产哈希、仓库卫生审计、真实发布 ZIP 的隔离 check/build/test/run；npm run moonbit:install-check 会在临时模块里从 mooncakes.io 真实 moon add lqyq666/bodymate 并运行四个包（需要网络）。规模基线见 实时基线。
• 诚实边界：motion 的姿态标量绑定当前教学骨架尺寸，不是通用骨骼求解器；anatomy 是展示用译名，不是临床术语标准；整套项目不提供医疗诊断、疼痛判断、训练处方或实测发力结论。

#参考应用：全身动作实验室

用户输入 / 模型提议 / 参数控件 / 每帧经过时间
  → MoonBit zhnum：中文数字归一化
  → MoonBit motion：识别 → 参数校验 → 会话状态 → 姿态意图
  → MoonBit agent：模型提议护栏（服务端与浏览器同一份规则）
  → MoonBit anatomy：结构中文名与检索
  → MoonBit core：wire 导出
  → JavaScript 编解码 → Three.js 骨架 / 材质 / DOM

#运行

npm ci
npm run build
npm run check
npm start                      # 启动本地服务并打开页面；端口占用时只打开页面

#可选：本地 AI 对话

npm run ai:configure-glm
npm run ai:serve

#评审入口

• 库说明（四个包的 API、边界、示例）
• 评委快速开始 · MoonBit 技术审查
• 架构 · 测试矩阵 · 实时规模基线
• 演示讲稿 · 一页项目说明 · 申报清单

#来源、AI 辅助与限制