海运租船专家系统

模块总览

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

M5 — 知识问答与学习

触发条件

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

工作流程

1. 评估匹配度：问题是否直接对应M1-M4或M6？

   • 是 → 直接路由
   • 否/部分 → 执行诊断问答

2. 诊断问答（最多3个问题，按需选择）：

   • "您的问题涉及哪个环节？" — 合同起草/审核/计算/争议/市场/一般知识
   • "您的角色是？" — 租家/船东/贸易商/经纪人
   • "需要什么形式的输出？" — 文档/分析/函件/解释/对比

3. 加载知识库：根据问题类型从references中加载对应参考文件

4. 生成回答：引用判例、条款、案例，附置信度标签

5. 记录学习：调用脚本记录本次交互的知识点

学习记录脚本

每次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等指数
• 用户需要市场趋势辅助租船决策
• 用户要求评估当前运费水平

工作流程

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

市场分析脚本

自动获取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。

工作流程

1. 收集必要条款：船名/DWT/吃水/旗籍/建造年份、货物描述/数量(+/-容差)、装卸港、运费率、装卸率、NOR规则、滞期费/速遣费率、仲裁地
2. 加载条款库：读取 references/charterer_clause_library.md 获取租家有利条款模板
3. 起草Fixture Note：以租家利益为导向，除非用户明确要求船东视角
4. 输出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，要求审核条款风险。

工作流程

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

必须标记的高风险条款

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

M3 — 装卸时间计算

触发条件

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

工作流程

1. 读取Fixture Note：提取所有装卸时间相关条款，标记歧义
2. 读取SOF：提取所有带时间戳的事件
3. 加载计算参考：读取 references/laytime_calc_reference.md 获取Excel结构和公式
4. 构建Excel工作簿：
   • Tab 1: Laytime Statement（事件日志+公式）
   • Tab 2: Calculation Summary（执行摘要）
   • Tab 3: Time Breakdown（中断明细+法律依据）
   • Tab 4: Reversible Check（如适用）
5. 命名：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 — 争议回复

触发条件

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

工作流程

1. 理解争议：当事人、船舶、港口、索赔金额、具体分歧点
2. 确定回复类型：全面反驳 / 部分接受 / 和解函 / 时效抗辩
3. 加载模板：读取 references/dispute_response_reference.md
4. 起草回复（中文/英文/双语）：
   • 每个争议点清晰表态
   • 引用C/P条款原文
   • 引用判例（每点一个："Per [Case] [Year], [holding]"）
   • 预判对方反驳并 preemptively 回应
   • 提出解决方案或下一步
5. 输出：正式函件输出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等航运指数基础查询

付费功能

订阅方案

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

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

专业咨询

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

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

安装与配置

环境要求

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

安装步骤

1. 将技能文件夹放置于Agent的技能目录下（如 .skills/skill_shipping-chartering-expert/）
2. 安装Python依赖：

   pip install openpyxl python-docx
   

3. 确认目录结构完整：

   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
   

4. 无需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]，永不编造判例