# 姓名笔画解读 · 妙算子 (xingming-jiedu)

> 妙算子（xingming-jiedu）是一个基于传统姓名学的 H5 测算服务。系统按康熙字典笔画计算 6格（天格/人格/地格/外格/总格/修格）、查 81 数理吉凶、识别 16 类特殊格局（连地克/通天克/天地生/木扎土/福寿土被病木克/阴阳水/水火急变/全阴局 等），并针对女姓场景（单身 / 非单身 / 已婚细分）输出场景化解读与 AI 修订建议。所有结果仅供文化娱乐参考，不构成医疗、法律、投资、婚恋建议。

## Canonical Site

- [妙算子首页](https://name.mihaozhuan.com/): 站点首页，进入测算入口。
- [H5 单身女测算](https://name.mihaozhuan.com/single): 单身女性的 6格 + 场景化解读。
- [H5 非单身女测算](https://name.mihaozhuan.com/in-relationship): 男友 / 已婚 / 离异 / 丧偶 的细分场景。
- [解读结果页](https://name.mihaozhuan.com/result/:id): 单次解读报告。
- [完整 Agent 上下文](https://name.mihaozhuan.com/llms-full.txt): 面向大模型和 Agent 的工具详细字段、推荐任务路径。
- [JSON-LD 站点元数据](https://name.mihaozhuan.com/llms.txt): 站点结构化元数据。
- [Agent 工具 Schema](https://name.mihaozhuan.com/.well-known/agent-tools.json): 机器可读的核心工具输入字段、输出结构和边界说明。
- [Agent 准备状态](https://name.mihaozhuan.com/.well-known/ai-readiness.json): 机器可读的栏目、能力和 MCP 准备状态。
- [OpenAPI 入口](https://name.mihaozhuan.com/api/health): API 健康检查（GET）。

## Core Tools

- [姓名测算（核心）](https://name.mihaozhuan.com/api/calculate): 输入姓、名 1、可选名 2、场景、年龄、可选 男友姓/夫姓，输出 6格、6格五行、16 类特殊格局、5 格 81 数理吉凶、场景化解读段落、警告。
- [查询解读结果](https://name.mihaozhuan.com/api/result/:id): 通过测算返回的 id 拉取完整 JSON。
- [健康检查](https://name.mihaozhuan.com/api/health): 检查 API 是否在线。

## Knowledge Tools (planned)

> 以下工具暂未上线，是 H5 内测期规划方向，详见 llms-full.txt。
- 三才配置评分
- 综合评分（5格 + 三才 + 喜用 + 音义）
- 音义用字（正/负面字 regex 提示）

## Bazi Support

- 测算 API 同时接受 `birthDate`（YYYY-MM-DD）+ `birthHour`（12 时辰）作为**选填**输入
- 两者同时提供时，response.result.bazi 返回八字四柱（年/月/日/时）+ 干支 + 五行 + 纳音 + 十神
- 两者任一缺失时跳过八字，不影响 6格 / 81 数理 / 特殊格局 解读
- 时辰采用传统 12 时辰（子/丑/.../亥），按每时辰中点（如子=00:00、午=12:00）调用 lunar-typescript 计算

## Utility Tools (planned)

- 工商预查（商号与行业匹配）
- 商标预查（与公开商标库近似度）

## Agent Usage Notes

- Base URL: `https://name.mihaozhuan.com/`
- All API endpoints under `/api/`
- 解读计算走 `POST /api/calculate`，Content-Type `application/json`
- 解读限流：匿名 IP 5 次 / 天（内测期）
- H5 默认走 `female_*` 场景。`male` 和 `student` 场景暂未上线。
- 输入姓名使用简体中文汉字。
- 复姓（如「诸葛」）必须整串传入 `xing` 字段，length=2；单姓 length=1。
- 单名 length=1 传 `ming1`；双名 length=2 时 `ming1` 为首字、`ming2` 为次字。
- 复姓上下文下「诸」=15 画（compound_parts），单姓「诸」=16 画。
- 已婚细分状态：married（配偶在世）/ divorced（已离异）/ widowed（丧偶）。
- `partnerSurname` 用于「未婚男友姓」（预测型，会带【预测】警告）。
- `fuXing` 用于「已婚 / 离异 / 丧偶」夫姓。
- 输出 `grids.tian/ren/di/wai/zong/xiu`：6 个数字。
- 输出 `wuxing.{tian,ren,di,wai,zong,xiu}.el` + `.yin`：五行元素（'木'/'火'/'土'/'金'/'水'）+ 是否阴（true=阴 / false=阳）。
- 输出 `patterns[]`：特殊格局命中，含 `key` 和 `txt` 描述。
- 输出 `shuli[]`：5 格 81 数理条目（不含修格），含 `grid`/`num`/`jixiong`/`txt`。
- 输出 `sections[]`：场景化解读段落；未婚/已婚会切【实测】+【预测】两部分。
- 输出 `warnings[]`：字符串数组，会带「预测」字样以标识非实测。

## Standard Disclaimers

- 本服务基于传统姓名文化，**仅供文化娱乐参考**，不构成任何医疗、法律、投资、婚恋建议。
- 解读结果依赖康熙字典笔画 + 内置 81 数理库 + 16 类特殊格局规则，不预测未来、不保证准确。
- 场景中的「预测」部分（基于男友姓的推算）会显式标注为预测。
- 当 `surname` 不在康熙字典或 `ming1` 不在康熙字典时，API 返回 500 并带明确错误信息。