v1.6.0 · 2026-09-28 · MIT 开源 · 459 项测试全绿

一份任务书,
跑完整条初步设计链

Design the shell that carries it all.

OpenHull 是由 AI 智能体编排的开源参数化船舶初步设计工具链:输入船型、载重吨、服务航速与航区,自动产出主尺度、静水力、IS Code 稳性、阻力与推进、螺旋桨设计、耐波性、失速估算、总布置简图与中文设计报告——每个数字都溯源到公式白名单。

459项自动化测试全绿
34条公开验收记录
±0.32 knDTMB 1712 航速锚
2.8 %敞水效率平均偏差
DEMO REEL

60 秒,看懂 OpenHull

一份任务书,如何变成一套可溯源的交付物——品牌短片《Design the shell that carries it all.》。

CAPABILITIES

它做什么

从任务书到交付物,十个环节全部自动化——每一条经验公式都有白名单出处,方法与公式出处见文档站方法页 ↗。

DIMENSIONS

主尺度与重量

载重量比法估算、诺曼系数迭代的重量浮力平衡,输出主尺度方案与载重量比。

HULL FORM

参数化船型

数字化 Series 60 母型 + Lackenby 变换,交付真实型值表与分层 DXF 型线图。

HYDROSTATICS

静水力

静水力表、邦戎曲线,自动绘制教材版式静水力曲线图(12 项要素)。

STABILITY

稳性校核

大倾角 GZ 曲线 + IMO 2008 IS Code 2.2 六项衡准 + 恶劣风浪衡准 2.3,逐条判定。

PERFORMANCE

阻力与推进

艾亚阻力估算、Holtrop 推进因子、瓦根宁根 B 系列螺旋桨设计与空泡校核。

OPTIMIZE

方案空间扫描

L/B × B/T × Cb 网格逐点过全链:可行方案集、逐级拒绝记录、帕累托前沿。

SEAKEEPING

耐波性两级

书内公式固有周期与谐摇判定;可选 capytaine 扩展输出零航速 RAO 曲线。

FREEBOARD

干舷校核

载重线公约 B 型夏季最小干舷(表 3-9 + 五项修正),按平衡尺度逐项列账并判定。

SPEED LOSS

失速估算

Kwon 方法:按蒲福风级、浪向与装载状态估算波浪中航速损失与实际航速。

DELIVERABLES

图纸与报告

静水力曲线图、总布置简图(图+分层 DXF)、中文 Markdown 设计报告,一条命令出齐。

QUICK START

两条命令,第一条船

需要 Python ≥ 3.11。完整安装方式(pip / 源码 / RAO 可选扩展)与任务书全字段说明见文档站快速上手 ↗。

安装并运行仓库自带的 15 万吨级散货船示例(JBC 基准船锚定)
uv tool install "git+https://github.com/5777-wq/OpenHull@v1.6.0"
openhull run examples/taskbook_bulk_carrier.yaml --report design_report.md

# 跑全链之前,可先秒级预检 8 道适用域关卡:
openhull check examples/taskbook_bulk_carrier.yaml
design_report.md 中文设计报告(稳性逐条判定/耐波性/分舱表) curves.png 静水力曲线图(教材版式 12 要素) ga.png / ga.dxf 总布置简图与分层 DXF
更多成果物:--hydro-curve-chart / --arrangement-chart / --arrangement-dxf / --json / --csv 方案扫描与 RAO 用法 ↗
FOR AI AGENTS

一句话,交给你的 AI 智能体

OpenHull 就是为智能体编排设计的:把下面这句话发给任何支持技能的 AI 智能体(ZCode、Claude Code 等),它会自己安装工具、写好任务书、跑完整条设计链。

复制这句话发给你的智能体
「请安装并使用 OpenHull 技能(https://github.com/5777-wq/OpenHull/tree/main/skills/openhull),
然后帮我设计一条 5 万吨散货船,服务航速 14.5 节,出设计报告和总布置简图。」
AUTO INSTALL

① 自动安装

智能体读取技能文件后执行一条命令装好 CLI 并自检版本——安装即锁定发布标签,可复现、可审计。

AUTO DRAFT

② 自己写任务书

技能内置最小任务书模板——只需载重吨、航速、吃水、方形系数四个字段,其余参数由智能体按内置方法补全。

FULL OUTPUT

③ 出齐成果

中文设计报告、静水力曲线图、总布置简图与 DXF、方案空间对比——全部可溯源,跳过项如实声明。

技能源码(任意智能体可自行读取安装):github.com/5777-wq/OpenHull/skills/openhull ↗

VALIDATION

公开基准,逐条含数字

34 条验收记录全部含具体数字与复现命令,锚定公开基准船、书内算例与独立路径互检——完整清单见VALIDATION.md ↗。

锚点一致性
NMRI JBC 基准船(主尺度反向锚)L −1.94 % · B +1.69 %(±5 % 判据内)
DTMB 1712 报告(Series 60)按公开轴功率复算航速 ±0.32 kn
NMRI MP687 实测敞水数据B 系列 ηo 平均偏差 2.8 %
KCS 波浪失速互检(公开对比)速比 f_w 0.929 vs 0.932
书内算例(《船舶原理》下册)螺旋桨终局设计差 0.07 kn
面板网格 vs 站面积分排水体积互差 0.1 %
PRINCIPLES

把工程纪律写进章程

这四条写在项目章程(AGENTS.md)里,AI 智能体和贡献者都必须遵守。

① 白名单先行

经验公式先入 AGENTS.md §5 白名单、对照原书页面核验后才能实现——先立账本再动手。

② 验收靠数字

书上算例、独立路径互检、公开基准船数据;"能跑"不算验收。

③ 近似必须声明

直壁甲板、阻尼区间、被约束的自由度——写了什么假定,就声明在哪里。

④ 人机各司其职

谐摇区是否规避、衡准是否否决方案,是船舶工程师的专业判断;工具只报告,不拍板。