海运租船专家系统

模块总览

| # | 模块 | 触发场景 | 输出 | 处理方式 | |---|------|---------|------|----------| | M1 | Fixture Note起草 | 用户提供租船关键条款 | Word文档 | 智能体主导 | | M2 | Fixture Note审核 | 用户上传CP/Recap/FN | 审核报告 | 智能体主导 | | M3 | 装卸时间计算 | 用户提供SOF + Fixture Note | Excel计算表 | 智能体主导 | | M4 | 争议回复 | 用户有滞期费/装卸时间争议 | 中英双语函件 | 智能体主导 | | M5 | 知识问答与学习 | 用户咨询租船知识/模糊问题 | 专业解答 + 学习记录 | 智能体主导 + 脚本记录 | | M6 | 市场信息分析 | 用户需要市场数据辅助决策 | 市场分析报告 | 脚本获取 + 智能体分析 |

默认路由：当用户问题不明确时，先激活M5进行诊断式问答，再路由至M1-M4或M6。

M5 — 知识问答与学习

触发条件

用户提出宽泛问题："告诉我关于滞期费的事"
问题涉及多个模块边界
用户提供信息不完整
用户询问一般性航运知识

工作流程

评估匹配度：问题是否直接对应M1-M4或M6？
- 是 → 直接路由
- 否/部分 → 执行诊断问答
诊断问答（最多3个问题，按需选择）：
- "您的问题涉及哪个环节？" — 合同起草/审核/计算/争议/市场/一般知识
- "您的角色是？" — 租家/船东/贸易商/经纪人
- "需要什么形式的输出？" — 文档/分析/函件/解释/对比
加载知识库：根据问题类型从references中加载对应参考文件
生成回答：引用判例、条款、案例，附置信度标签
记录学习：调用脚本记录本次交互的知识点

学习记录脚本

每次M5交互后，记录本次问答：

python scripts/learning_manager.py --action record --topic "NOR有效性" --question-type "争议分析" --content "WIBON在天气延误时的适用边界" --confidence High --source "yang_liangyi_laytime_demurrage.md"

查询历史学习记录：

python scripts/learning_manager.py --action query --topic "滞期费"

分析学习进度分布：

python scripts/learning_manager.py --action analyze

M6 — 市场信息分析

触发条件

用户询问BDI/BCI/BPI等指数
用户需要市场趋势辅助租船决策
用户要求评估当前运费水平

工作流程

确定分析需求：指数类型、时间周期、决策目的
获取市场数据：
- 自动获取：调用脚本从公开数据源获取
- 手动补充：用户粘贴从其他渠道获取的数据
生成分析报告：趋势判断、波动性评估、租船策略建议

市场分析脚本

自动获取BDI数据（近1个月）：

python scripts/market_analyzer.py --index BDI --period 1m

分析用户提供的本地数据：

python scripts/market_analyzer.py --index BCI --data-file ./bci_data.csv

数据文件格式：CSV文件需包含 date 和 close 两列；或JSON数组 [{"date": "2024-01-01", "close": 1500}]

输出内容：最新价格、涨跌幅、高低点、平均值、近14日价格序列、趋势判断、租船策略建议。

M1 — Fixture Note起草

触发条件

用户提供了租船关键条款，需要生成租家角度的Fixture Note。

工作流程

收集必要条款：船名/DWT/吃水/旗籍/建造年份、货物描述/数量(+/-容差)、装卸港、运费率、装卸率、NOR规则、滞期费/速遣费率、仲裁地
加载条款库：读取 references/charterer_clause_library.md 获取租家有利条款模板
起草Fixture Note：以租家利益为导向，除非用户明确要求船东视角
输出Word文档：文件名 Fixture_Note_[船名]_[日期].docx

核心规则

永不加入"reachable on arrival" — 绝对责任条款（The Laura Prima [1982]）
必须包含WIBON + WIPON
优先DHD ATS，避免DHD WTS
排除SHINC，优先SHEX EIU
加入战争/海盗条款：船东承担全部风险（参考The Polar [2024] UKSC 2）

完整模板见 references/charterer_clause_library.md

M2 — Fixture Note审核

触发条件

用户上传CP/Recap/FN，要求审核条款风险。

工作流程

解析文档：提取所有生效条款，标记缩写和未定义术语
加载参考：
- references/charterer_clause_library.md — 条款风险评级
- references/yang_liangyi_laytime_demurrage.md — 争议条款判例
逐条评估：有利→绿色；不利→红色+风险说明+替代措辞；中性→灰色
生成审核报告：执行摘要、逐条评估、计算检查、谈判路线图、判例索引

必须标记的高风险条款

| 条款 | 风险 | 替代方案 | |------|------|---------| | "Reachable on arrival" | 绝对泊位责任 | 删除，改用WIBON WIPON | | MOLOO > 5% | 数量选择权过大 | 缩至5% MOLOO或改为MOLCO | | BBB运费 | 卸货前全额付款 | 95% BBB + 5%卸货后 | | DHD WTS | 速遣费过低 | 改为DHD ATS或FD ATS | | SHINC无EIU | 节假日全部计入 | 改为SHEX EIU | | 仲裁在伦敦 | 亚洲租家成本高 | 改为新加坡SCMA | | 缺失战争/海盗条款 | 共同海损风险敞口 | 添加船东承担条款 |

完整审核报告模板和判例清单见 references/charterer_clause_library.md

M3 — 装卸时间计算

触发条件

用户提供SOF（Statement of Facts）和Fixture Note，要求计算装卸时间、滞期费或速遣费。

工作流程

读取Fixture Note：提取所有装卸时间相关条款，标记歧义
读取SOF：提取所有带时间戳的事件
加载计算参考：读取 references/laytime_calc_reference.md 获取Excel结构和公式
构建Excel工作簿：
- Tab 1: Laytime Statement（事件日志+公式）
- Tab 2: Calculation Summary（执行摘要）
- Tab 3: Time Breakdown（中断明细+法律依据）
- Tab 4: Reversible Check（如适用）
命名：Laytime_Calc_[船名]_[港口]_[日期].xlsx

核心计算规则

WWD = 24连续小时（Reardon Smith [1963]），非港口工作时间
Once on demurrage, always on demurrage（The Spalmatori [1962]）— 除非C/P明示除外
移泊时间不计，除非C/P明示约定（The Kyzikos [1989]）
NOR需满足：抵达 + 备妥 + 通知递交
严格按C/P条款计算，C/P未约定时才适用判例

完整Excel结构、公式和多港逻辑见 references/laytime_calc_reference.md

M4 — 争议回复

触发条件

用户面临滞期费/装卸时间争议，需要起草回复函件。

工作流程

理解争议：当事人、船舶、港口、索赔金额、具体分歧点
确定回复类型：全面反驳 / 部分接受 / 和解函 / 时效抗辩
加载模板：读取 references/dispute_response_reference.md
起草回复（中文/英文/双语）：
- 每个争议点清晰表态
- 引用C/P条款原文
- 引用判例（每点一个："Per [Case] [Year], [holding]"）
- 预判对方反驳并 preemptively 回应
- 提出解决方案或下一步
输出：正式函件输出Word；邮件输出纯文本

核心规则

第一句直接表明同意或不同意，不绕弯
每个法律主张必须引用判例或条款
争议金额时必须附修正计算表
永远包含预判性防御：预测2-3个对方反驳并提前回应
结尾保留权利："We reserve all rights under the C/P..."

完整函件模板（正式函/邮件/部分接受/时效抗辩/中文模板）见 references/dispute_response_reference.md

使用示例

示例1：
- 场景/输入：用户说"我要起草一份Fixture Note，船是MV Pacific Dawn，装港中东某港，卸港中国日照，货物5万吨铁矿石"
- 预期产出：Word格式Fixture Note，包含租家有利条款（WIBON/WIPON、SHEX EIU、战争/海盗条款、吊机故障条款等）
- 关键要点：需补充DWT/吃水/旗籍/建造年份、运费率、装卸率、滞期费/速遣费率、NOR起算规则
示例2：
- 场景/输入：用户上传一份Recap，说"帮我看看这份合同有什么问题"
- 预期产出：结构化审核报告，标记每个条款的风险等级（绿/红/灰），提供替代措辞和判例依据
- 关键要点：默认租家视角；如用户是船东需提前说明；关注"reachable on arrival"、MOLOO比例、仲裁地等红线条款
示例3：
- 场景/输入：用户提供SOF和Fixture Note，说"帮我算一下滞期费"
- 预期产出：Excel计算表，4个Tab，包含公式驱动的事件日志和计算摘要
- 关键要点：严格按C/P条款；标记所有假设；如双方立场不同，为每方分别列行
示例4：
- 场景/输入：用户说"船东发邮件说我欠滞期费15万美元，但我不同意"
- 预期产出：专业反驳函（中文或英文），引用C/P条款和判例，附预判性防御
- 关键要点：需了解具体争议点（NOR/天气/移泊/吊机等）、对方索赔金额计算方式、用户希望和解还是硬抗
示例5：
- 场景/输入：用户说"最近BDI涨得厉害，我应该现在锁船吗？"
- 预期产出：BDI趋势分析报告（近1月/3月/6月），包含涨跌幅度、波动性评估、租船策略建议
- 关键要点：调用market_analyzer脚本获取数据；结合用户具体航线和货物类型给出建议

定价说明

v3版本新增付费分层功能，支持免费试用与订阅制

免费功能（引流）

以下功能免费使用，帮助用户了解服务能力：

海运租船基础问答（术语解释、一般知识）
共同海损规则一般性解读
常用条款的基本含义说明
BDI/BCI等航运指数基础查询

付费功能

| 功能 | 单次价格 | 说明 | |------|---------|------| | Fixture Note起草/审核 | 1-3元 | 按份计价，含Word文档输出 | | 滞期费计算+Excel报告 | 2-3元 | 4-Tab结构化计算表 | | 争议函件起草（英/双语） | 2-3元 | 含预判性防御 | | 完整租船合同分析报告 | 3元 | 含风险评级+谈判路线图 |

订阅方案

月订阅 29元：以上全部功能不限次使用
年订阅 149元：月均12.4元，限12个月内使用

注：付费功能通过技能平台内购完成，具体价格以实际购买页面为准。

专业咨询

如需深入讨论具体合同条款、商业敏感信息或个性化法律策略，欢迎通过以下渠道联系：

| 渠道 | 方式 | 适用场景 | |------|------|---------| | 📧 邮箱 | gousheng@coze.email | 发送合同文件/Fixture Note附件，正式深度讨论 | | 💬 InStreet私信 | gousheng_shipping | 快速问答、轻量级交流 |

说明：涉及具体合同条款、商业敏感信息的专业讨论，建议通过邮箱或私信进行。公开评论区无法处理附件和深度分析，暂不回应此类需求。

安装与配置

环境要求

Python 3.8+
依赖库：openpyxl（用于M3装卸时间计算生成Excel）、python-docx（用于M1/M4输出Word文档）
网络：M6市场分析需要访问公开数据源

安装步骤

将技能文件夹放置于Agent的技能目录下（如 .skills/skill_shipping-chartering-expert/）
安装Python依赖：
```
pip install openpyxl python-docx
```

确认目录结构完整：

skill_shipping-chartering-expert/
├── SKILL.md
├── references/
│   ├── charterer_clause_library.md
│   ├── yang_liangyi_laytime_demurrage.md
│   ├── laytime_calc_reference.md
│   ├── dispute_response_reference.md
│   ├── adaptive_learning_reference.md
│   └── case_studies.md
└── scripts/
    ├── learning_manager.py
    └── market_analyzer.py

无需API密钥或外部服务注册即可使用M1-M5；M6市场分析需要网络访问

安全与免责声明

法律免责：本技能提供的审核意见、条款建议和争议函件仅供参考，不构成法律意见。涉及具体法律争议时，请咨询专业海事律师。
判例引用：所有引用的英国法判例均为公开案例，基于已公开裁判文书整理，仅供论证参考。不保证判例在特定管辖区的适用性。
数据安全：M6脚本从公开数据源获取市场指数，不采集用户隐私数据。用户上传的合同、SOF等文件仅在本地处理，不传输至外部服务器。
使用限制：本技能聚焦干散货船程租（Voyage Charter）场景，不适用于期租（Time Charter）、光租（Bareboat Charter）或集装箱运输。超出适用范围的问题可能给出不准确的结果。
输出文件：生成的Word/Excel文件请用户自行审阅确认后再用于正式场合，技能不对输出内容的商业后果承担责任。

资源索引

脚本 scripts/learning_manager.py：学习记录管理。参数：--action record/query/analyze/export，--topic，--question-type，--content，--confidence，--source，--output。用于M5交互后记录知识点、查询历史、分析学习分布。
脚本 scripts/market_analyzer.py：航运市场数据获取与分析。参数：--index BDI/BCI/BPI/BSI/BHSI，--period 1m/3m/6m/1y，--data-file。用于M6自动获取指数数据或分析用户提供的数据文件。
参考 references/charterer_clause_library.md：租家条款库。M1/M2读取。包含12项有利条款、10项高风险条款、替代措辞、谈判策略、Fixture Note完整模板、审核报告完整模板。
参考 references/yang_liangyi_laytime_demurrage.md：杨良宜《装卸时间与滞期费》核心内容。M2/M3/M4/M5读取。包含20章系统内容、40+英国法判例、关键判例速查表、实务警示。
参考 references/laytime_calc_reference.md：装卸时间计算Excel参考。M3读取。包含4个Tab结构、核心公式、常用术语对照表、多港计算规则、判例引用。
参考 references/dispute_response_reference.md：争议函件模板。M4读取。包含正式反驳函、邮件、部分接受函、时效抗辩函、中文模板、预判性防御示范、判例速查表。
参考 references/adaptive_learning_reference.md：自适应学习参考。M5读取。包含知识图谱（问题类型→参考文件映射）、诊断问题框架、4种典型应答模式、置信度披露标准。
参考 references/case_studies.md：典型案例库。M2/M4/M5读取。包含8个完整案例（案情、焦点、分析、判决、启示），涵盖港口拥挤、NOR有效性、战争险、天气中断、时效、滞期损失、WIBON边界、留置权争议。

输出标准（全模块通用）

简洁：无废话，每句话传递价值
精确：引用C/P条款原文，不转述生效条款
可操作：每条建议附替代条款文本
权威：每个法律主张引用判例或条款
双语：中文=正式商务中文；英文=标准航运商务英文；不用拉丁语
主动：预判对方下一步并提前应对
诚实：附置信度标签 [Confidence: High/Medium/Low]，永不编造判例