当前沿 AI 遇见古老的中医知识,会做出怎样的交互体验?
这是一次由王斗提出需求、与基于 GPT‑6 的 Codex 协作完成的开源实验:在可追溯的人体数据上,加入穴位、六种工具、皮肤接触反馈与疼痛关联,让知识可以被旋转、观察和操作。
立即体验 · 加入 JIC Discord · 制作过程 · 参与贡献
- 旋转、缩放成人男性参考人体,探索15个显示系统、2234个网格。
- 搜索十四经脉362个经穴名称(含国标印堂),显示670个左右侧或中线体表实例;龈交收录目录,口内位置不贴外皮肤。
- 显示或隐藏14经的彩色分段体表连线,按经筛选,并用上一穴、下一穴循序浏览。
- 成人男性参考模型的外生殖器体表已替换为连续平滑皮肤,移除独立阴毛网格;该区域属于外形简化展示。
- 使用针、灸、砭石、指压、刮痧、火罐;默认工具为针。
- 直接抓住器具或“移动工具”手柄,沿皮肤拖动;支持播放、暂停与按住演示。
- 观察程序化压放、回弹、刮拭轨迹、温热范围和杯口形变。
- 选择头痛、颈部痛、腰痛、膝痛课堂示例:红色痛处、金色局部穴位、蓝色远端关联。工具移动后原痛处保持,来源可展开查看。
- 查看涌泉时自动隐藏遮挡足底的展示底座,并启用足底补光。
本项目不是从零生成的人体,也不是从零编写的解剖查看器。
| 层次 | 来源与贡献 |
|---|---|
| 人体数据 | BodyParts3D 4.0,成人男性参考解剖,CC BY 4.0 |
| 查看器 | ashemag / Human Atlas,React、Three.js,MIT;保留上游Git历史 |
| 本项目改编 | 中文教学界面、穴位覆盖层、六工具、拖动与皮肤反馈、疼痛关联、教学视角修复 |
| 人机协作 | 王斗提出目标并反馈体验;基于GPT‑6的Codex参与实现、调试与验证 |
上游起点:1c38bf35c254a891200d3cedecfd57abebe83d8d。原始项目说明见 README-upstream.md,模型处理与完整署名见 ATTRIBUTION.md。代码许可与人体数据许可分别适用。
这是教学交互工程预览,尚未完成专业医学审校。
362个经穴名称均标记 reviewed: false。范围是十四经穴,不包含全部经外奇穴、耳穴、头针体系。旧铜人种子经过同区域姿态适配,再吸附皮肤;这只验证几何接触,不证明标准取穴精度。龈交不显示体表标记;简化后的会阴区不用于精细取穴。
彩色经脉线按穴序分段,在分支跳转或皮肤投射失败处断开,不代表完整传统循行、深部路线或现代解剖结构。不得作为针刺路线使用。国家标准采用 GB/T 12346—2021(362穴,含 GV24+ 印堂);WHO 361穴目录不含该新增编号。
皮肤、手部和工具反应为程序化3D示意,不是真人扫描或实测组织力学。参数不对应真实施术力度、温度、负压或时长。疼痛连线表示有出处的教学关联,不是神经/经络路径,不提供诊断或疗效预测;工具操作不会自动降低痛感标记。组合研究也不证明单穴独立疗效或所有工具的效果。
需要 Node.js 22.13 或更高版本,无需AI密钥或账号。
git clone https://github.com/JICio/tcm-3d.git
cd tcm-3d
npm ci
npm run dev打开 http://127.0.0.1:3016/ 。端口占用时以终端输出为准。人体资源随仓库提供,首次加载需下载模型数据。该界面运行不调用GPT‑6;GPT‑6参与的是开发过程。
npm run check
node scripts/validate-tool-drag.mjs
node scripts/validate-teaching.mjs
npm run buildnpm run build 输出独立静态站点到 dist/。可部署到支持静态文件的主机。
npm run build:tcm 输出 /3d/ 前缀资源到 dist-tcm/,供已有站点集成;此目录不是原JIC全站,不可用它覆盖已有网站根目录。开发服务器默认只监听本机,不用于公网生产托管。
欢迎中医教师、解剖学与医学可视化研究者、前端和3D开发者、设计师及学习者参与。
优先方向:逐穴专业校核、体表标志与体位、可访问性、移动端交互、模型性能、工具外观与教学文案。提出定位修正时请给标准版本、条款与适用体位。
遇到问题可 提交 Issue,也欢迎到 discord.gg/jic 展示你的改进、讨论教学用法、一起完成下一次迭代。
- 应用代码:MIT,保留ashemag原版权声明;JIC改编同以MIT发布。
- BodyParts3D数据:CC BY 4.0,© The Database Center for Life Science。
- 外部标准、论文与第三方依赖保留各自权利;代码MIT许可不覆盖它们。
data/legacy-meridians.mjs 保存旧铜人原始种子;scripts/expand-meridians.mjs 扩展目录并保留原30点局部修正。更新坐标或教学皮肤变形后,运行 node scripts/bake-meridian-surface.mjs,再运行验证脚本。预计算结果包含皮肤三角面索引及26条左右/中线显示路径,页面加载时直接复用。算法不能替代教师逐穴校核。