# 寻炁 · 人体图谱

版本：1.1.0，2026-09-08。

## 模型与许可

### 男性解剖

BodyParts3D, © The Database Center for Life Science licensed under CC Attribution 4.0 International.

- 官方数据：https://dbarchive.biosciencedbc.jp/en/bodyparts3d/download.html
- 官方授权：https://dbarchive.biosciencedbc.jp/en/bodyparts3d/lic.html
- 许可：https://creativecommons.org/licenses/by/4.0/
- 数据：BodyParts3D 4.0，成年男性参考解剖，2,234 个结构。
- 网页适配资源：https://github.com/ashemag/human-atlas
- 适配包括坐标变换、网格简化、法线量化与二进制分块。本项目沿用适配后的资源，增加中文索引、交互图层和独立的经络穴位示意覆盖层。
- 详细署名：[模型署名](./assets/models/ATTRIBUTION.md)。

### 女性解剖

Kristen Browne and Heidi Schlehlein, Human Reference Atlas / HuBMAP, 3D Reference Organ Set for Female v1.5 (2023). CC BY 4.0.

- 官方数据：https://lod.humanatlas.io/ref-organ/united-female/v1.5
- DOI：https://doi.org/10.48539/HBM352.BTSQ.586
- 适配来源：https://github.com/ashemag/human-atlas/tree/d72b4f6db42e41a8db84b1c19ff6d86ee7b65284/public/models
- HRA 原始参考集有 888 个网格，原集的全身骨骼与肌肉覆盖不完整；妊娠结构不展示。
- 当前女性页改为重建示意，共 2,267 个基础结构：2,205 个 BodyParts3D 派生结构与 62 个 HRA 女性骨盆、生殖器官、膀胱及乳房参考结构。包含 301 个骨骼分类网格和 402 个肌肉分类网格；网格数不等于解剖学骨/肌数量。
- BodyParts3D 派生部分按身体高度采用连续非均匀变形，肩部横向比例约 0.90、骨盆区域约 1.08；深度另作调整，所有关联组织与穴位锚点使用一致变形场。上述参数为美术示意设置，不是男女群体标准。
- 女性骨盆采用 HRA 的髂骨、坐骨、耻骨、骶骨及尾骨网格，替换原骨盆；生殖器官与膀胱按同一配准映射放入。移除男性生殖结构、相关专属血管及男性尿道。尚未补建女性尿道。
- 这是跨数据集的重建示意，并非同一女性扫描，也未经专业形态或关节、组织配准审校。各结构详情记录原始来源。
- 实现及配准参数见 female-geometry.js 与 atlas-female-complete.json；保留原始数据与署名，本节 BodyParts3D / HRA 派生部分继续遵守 CC BY 4.0。
- 详细署名：[女性模型署名](./assets/models/ATTRIBUTION-female.md)。

## 经络与穴位

- 十四经 361 个经典穴名、中文文字定位摘要及逐穴标准页码引用，双侧经穴在模型两侧显示，任督正中穴不复制。
- 命名参考：WHO Standard Acupuncture Nomenclature，https://www.who.int/publications/i/item/9290611057
- 定位参考：WHO Standard Acupuncture Point Locations in the Western Pacific Region (2008)，https://iris.who.int/bitstream/handle/10665/353407/9789290613831-eng.pdf
- 体表图层按用户要求不展示；源网格只用于经穴示意投射的内部参考。
- 三维覆盖层为本项目自行构建：用体表区域锚点连接穴位，再投射至参考皮肤网格。女性模型另作体型/姿态适配。
- **三维坐标不是 WHO 数据，不是临床取穴坐标，尚未经过专家逐穴校准。** 经络内行支脉未完整绘制；不可作为针灸操作指导。
- 不包括所有经外奇穴、耳穴、头针分区或各流派新增穴。
- 文字定位采用比例单位“寸”，不应直接换算成固定厘米。

## 子午流注与命理关联

- 当天模块采用十二时辰与十二经的传统对应：子胆、丑肝、寅肺、卯大肠、辰胃、巳脾、午心、未小肠、申膀胱、酉肾、戌心包、亥三焦。
- 术语参考：https://www.dayi.org.cn/term/800048
- 此版本只展示十二经时辰对应，**不计算纳甲开穴，不作补泻取穴或治疗建议**。同一时辰的经络对应在不同日期相同；日期用于显示干支与流年。
- 默认使用 Asia/Shanghai 钟表时间，可改为设备当地时间；未另算真太阳时。
- 五行脏腑分类参考《素问·阴阳应象大论》。中医脏腑概念与现代解剖实体分开说明。三焦不虚构为单个解剖器官。
- 五行、扶抑喜用神、调候、原局与流年神煞直接调用用户已有 BaziCore，不重写排盘算法。
- `assets/bazi-core.js` 与服务器 `/var/www/fengshui/lib/bazi-core.js` 读取时 SHA256 一致：439cc2c0a4bca166a4cc900ecbc12bff217ddddd9c309b927b7ad9c758734aac。
- 出生日期时间使用输入的钟表值；不在本页保存、上传或增加第三方 AI 调用。
- 神煞展示名称与柱位，不转译成病伤预测。五行得分是命理算法权重，不是器官功能评分。

## 软件

- Three.js r180，MIT，许可见 `assets/THREE-LICENSE.txt`。
- 沿用用户已有 BaziCore（含 lunar-javascript），保留原文件内容与署名。项目未新写八字算法。
- 页面、图层控制、模型载入和经络覆盖交互为本次制作内容；无付费模型或第三方追踪代码。

## 用途

传统文化关联展示、人体结构学习与研究对照。不参与医疗诊断，不提供用药或针灸操作指导。

## 1.1 显示与配色规则

- 穴位与经络覆盖层使用独立深度通道：不可见的源体表仅写入深度，不写入颜色，用于遮挡背面覆盖层；人体内部结构的显示不受该通道影响。指针选取同样排除被遮挡的穴位。
- 配色取原有 BaziCore 五行分值，除以五行得分合计得到占比。低于 15% 为蓝色权重偏低，15%—25% 为居中，高于 25% 为暖橙色权重偏高；仅为本页显示分档，不是命理定论或医学阈值。零总分或无效数据不着色。
- 喜用与忌神不增减权重、不合成器官分数，独立显示原核心标签。配色仅在个人/研究模式启用，可关闭；流年神煞不改变器官颜色。
- 脏腑归属优先使用 BodyParts3D 概念层级，覆盖心壁、肺段、肝段等细分网格；未映射组织保留原色。颜色始终表示命理关联，不表示真实器官功能或健康。

- 分类修正：左右髂胫束（FJ1423 / FJ1423M）在源目录被归入 skeletal，展示层改为 connective，并保留 sourceSystem。筋膜 / 结缔组织设独立图层，默认关闭；中文名为髂胫束。依据：https://www.ncbi.nlm.nih.gov/books/NBK537097/ 。

## 神经细分模型修订

已停用之前的 83 条自建主干曲线。当前保留 BodyParts3D 脑部网格，接入 Z-Anatomy 的 235 个神经细分参考网格（女性排除两条男性生殖分支，为 233 个）。包含脊髓灰白质、臂丛、肌支/皮支、指神经、肋间、腰骶及交感神经结构。数据约 113 万三角面；保持来源分支几何，没有用装饰性曲线填充。

神经数据以 CC BY-SA 4.0 授权，与其他来源的许可分别说明。署名、来源 Git blob 和派生步骤见 [神经授权](./assets/models/ATTRIBUTION-nerves.md)。模型转换参数在 atlas-nerves.json 中公开。新增神经基于男性参考，女性使用本页连续体型变形，不代表独立女性实测数据。

已用正面/侧面网格投影检查配准，并以实际加载器检查男女切换、全部新增索引和有限坐标、图层开关及脑干与脊髓连接区域的间距。该检查不等于专业逐分支解剖或临床审校。

## 女性乳房软组织修正

原 HRA 女性集合已有乳房脂肪、乳腺、输乳管及悬韧带，但原分类为 integumentary，去体表时被错误排除。本次恢复 10 个非皮肤乳房网格，分为乳房脂肪、乳腺与导管两个图层；悬韧带归结缔组织。全身皮肤仍隐藏。采用原 HRA 形状，配准参数在女性目录逐结构 registration 字段公开，未用球体代替。女性运行时共 2,500 个结构。

**骨骼仍未完成全女性来源替换**：胸廓、四肢等主体仍是男性 BodyParts3D 的改形派生，当前明确标为女性混合示意。乳房外观恢复不意味着骨骼已成为完整女性实测解剖。

- 软骨分类修正：鼻翼、鼻侧、鼻中隔、肋及喉部名称明确为 cartilage 的结构统一归软骨图层，保留原 sourceSystem。默认显示，用蓝灰色区别骨骼；不再出现鼻翼软骨随骨骼显示、相邻鼻软骨随器官隐藏的分类不一致。参考：https://www.ncbi.nlm.nih.gov/books/NBK532870/ 。