# 我的租船智能体产品介绍

## 1. 产品定位

我的租船智能体是一套面向航运经纪人、船东、经营人、货主和租船团队的租船业务工作台。系统可以部署在用户自己的电脑、内网服务器或自有云服务器上，自动接入业务邮箱，解析邮件中的船盘和货盘信息，并结合 HiFleet 数据能力完成船舶档案、港口、公开船货盘、预抵船、联系方式、订阅与用量等业务操作。

它的核心目标是：把分散在邮件、公开市场和船舶数据平台里的租船机会，集中整理成一个可检索、可筛选、可匹配、可跟进的私有工作台。

## 2. 适用用户

- 航运 Broker：自动整理每天大量船货盘邮件，快速发现可撮合机会。
- 船东和经营人：筛选适合自有或合作船舶的货盘，跟进重点机会。
- 货主和租船人：管理询盘邮件，按港口、Laycan、货量和船型查找可用船盘。
- 企业租船团队：在自有环境部署，统一管理内部邮箱船货盘、公开市场和团队用户。

## 3. 核心功能

### 3.1 邮箱船货盘自动解析

- 支持一个或多个邮箱账号。
- 支持接入多个邮箱文件夹，例如收件箱、垃圾邮件、业务归档文件夹等。
- 按设定间隔自动同步新邮件，也可手动点击“同步邮箱”。
- 使用配置的 LLM 解析邮件主题和正文，提取船盘、货盘和未知/异常邮件。
- 解析结果写入客户本地 SQLite 数据库，前端分页展示。
- 支持原邮件预览、网页邮箱打开/搜索、网页邮箱回复和系统内跟进状态记录。

### 3.2 船盘与货盘工作台

- 船盘、货盘、公开船盘、公开货盘、预抵船、匹配、异常、已关注、订阅、登录日志等多视图切换。
- 支持分页显示，支持 10/20/30/50/100 等分页选项。
- 支持港口、船名、货种、邮件主题等搜索推荐；港口推荐接入 HiFleet 港口查询能力。
- 全部、船盘、货盘、公开船盘和公开货盘均支持按港口检索；按港口检索时，距离字段统一显示单位，便于快速判断近远。
- 船盘和公开船盘支持船舶类型、船舶子类型、Tags 等筛选。
- 货盘和公开货盘支持货量、Tags 等筛选。
- 左侧筛选条件提供“前端展示天数”，可查看最近 N 天船盘、货盘、公开船盘和公开货盘数据；该偏好保存在用户浏览器中。
- Laycan 统一为紧凑格式，例如 `16-18 Jul 26`、`26 Jul-08 Aug 26`。
- 界面支持手机端和窄屏访问；表格列较多时支持左右拖动查看完整内容。
- 支持已关注管理，便于持续跟踪重点船货盘。

### 3.3 HiFleet 富化

系统可调用 HiFleet 对本地邮箱解析出的船盘和货盘进行富化：

- 船盘：补充港口 ID、船舶档案、DWT、建造年份、船旗、船东、管理公司、经营公司、船型和 Tags。
- 货盘：补充港口 ID、Tags 和匹配所需字段。
- 港口 ID 使用持久缓存，减少重复调用。
- 仅富化前端展示天数内、尚未富化的数据。
- 新收到的船盘和货盘可在同步后自动进入富化流程。

针对客户对私密邮件数据的顾虑，系统提供独立开关：

```text
私密船货盘 HiFleet 富化
```

关闭后，用户邮箱里的私密船盘/货盘只保留本地解析字段，不再发送给 HiFleet 做富化。公开船货盘、预抵船、订阅和用量查询仍可继续使用 HiFleet。

### 3.4 公开船盘与公开货盘

- 支持读取 HiFleet 公开船盘和公开货盘。
- 支持分页浏览和按港口检索。
- 港口检索时支持按距离排序。
- 点击公开船盘或公开货盘详情时，可按 HiFleet 公开船货盘联系方式流程获取联系人、邮箱和电话等信息。
- 右侧详情栏压缩展示租船最常用字段，减少接口原始字段干扰。

### 3.5 预抵船查询

- 支持按港口查询预抵船。
- 支持船舶类型、船舶子类型、ETA、是否有联系人等筛选。
- 查询较慢时，前端显示查询进度提示。
- 点击某艘预抵船时，如有联系人记录，可调用 HiFleet 解锁并刷新明文联系方式。
- 右侧栏展示船东、管理公司、经营公司、联系人等租船常用信息。

### 3.6 智能匹配

系统根据船盘和货盘的关键字段进行匹配：

- 港口和距离
- Laycan 重叠度
- 船型和子类型
- DWT 与货量
- 航线意向
- 货种和 Tags

前端会展示匹配评分和匹配理由，帮助用户优先处理更可能成交的机会。

### 3.7 登录、权限与审计

- 登录页支持简体中文、繁体中文、英文、日语、西班牙语、德语和俄语；首次访问默认跟随浏览器语言，用户切换后会记住并带入主系统。
- 普通用户需要登录后才能访问工作台。
- 仅管理员可以进入系统设置，配置邮箱、HiFleet API Key、LLM、私密富化开关、用户管理等系统级参数。
- 管理员可创建普通用户、重置密码、停用或删除普通用户。
- 管理员可在主页“订阅”后面的“登录日志”查看登录时间、用户、成功/失败状态、IP 地址、IP 来源国家和城市、浏览器信息。

### 3.8 多语言界面

系统支持多语言切换，并会记住用户上次选择：

- 简体中文
- 繁体中文
- 英文
- 日语
- 西班牙语
- 德语
- 俄语

界面提示、按钮、筛选条件、表格标题、设置页面、订阅页面和登录页均支持多语言。船名、港口名、货物名、邮件主题等业务数据保留原文，不做机器翻译。

### 3.9 订阅与用量

- 前端提供订阅页面，可嵌入 HiFleet Skills 控制台。
- 支持使用已配置的 HiFleet API Key 自动登录控制台。
- 可查看本周使用、余额、订阅套餐和调用明细。
- 免费或不计费接口可在本地用量记录中按规则展示为 0 消费。

## 4. 部署架构

系统采用轻量私有部署架构：

```text
浏览器
  |
  | http://127.0.0.1:8765 或用户自有服务器地址
  v
我的租船智能体后端服务
  |
  |-- 本地 SQLite 数据库
  |-- 本地邮件归档 .eml
  |-- 本地配置 config.json
  |
  |-- IMAP/SMTP 邮箱服务
  |-- 用户配置的 LLM 接口
  |-- HiFleet API / Skills 控制台
```

默认单机部署时，浏览器访问本机 `127.0.0.1:8765`。企业或团队共享使用时，也可以部署在客户自己的云服务器或内网服务器上。

## 5. 用户需要配置的内容

上线前，管理员通常需要准备：

- 邮箱账号、IMAP 地址、端口、SSL 设置和第三方客户端授权密码。
- 需要同步的邮箱文件夹，一行一个。
- LLM API Base URL、API Key、模型名称和 token 限制。
- 是否允许将脱敏后的邮件主题和正文发送给 LLM 解析。
- HiFleet API Key；没有 Key 时可在设置页申请。
- 是否启用私密船货盘 HiFleet 富化。
- 可选 SMTP 配置，用于系统内回复邮件。
- 管理员初始密码、普通用户账号和访问策略。
- 部署电脑或服务器的网络访问权限。

普通用户可在左侧筛选条件中调整“前端展示天数”，例如仅展示最近 5 天数据；该设置属于个人浏览偏好，不需要进入系统设置。

## 6. 数据安全与泄密顾虑应答

### 6.1 哪些数据保存在客户本地

以下数据保存在客户自己的部署环境中：

- 邮箱账号配置和第三方客户端授权密码。
- 原始邮件归档。
- SQLite 数据库。
- 解析后的船盘、货盘、异常邮件记录。
- 已关注和跟进状态。
- 用户账号、登录日志、本地服务日志和用量记录。

### 6.2 邮箱密码会不会发送给 HiFleet

不会。邮箱密码仅用于系统连接客户配置的 IMAP/SMTP 邮箱服务，不需要发送给 HiFleet。建议使用邮箱服务商生成的第三方客户端授权密码，不要直接使用网页登录密码。

### 6.3 邮件内容会不会发送给 LLM

只有在管理员开启“允许发送脱敏邮件给 LLM”后，系统才会把脱敏后的邮件主题和正文发送给配置的 LLM 接口。脱敏范围包括邮箱、电话、微信、WhatsApp、QQ 等联系方式。

为保证解析效果，船名、港口、货物、DWT、Laycan、船型等业务字段会保留。

高敏感客户建议使用客户自有的企业版 LLM、私有化 LLM 或内部托管模型。

### 6.4 私密船货盘会不会发送给 HiFleet

如果开启“私密船货盘 HiFleet 富化”，系统会把富化所需的业务字段发送给 HiFleet，例如船名、IMO、港口、DWT、Laycan、船型、货种和已脱敏的业务说明。系统会删除联系方式字段，并对正文中的邮箱、电话、即时通讯账号进行脱敏。

如果客户不希望私密邮箱船货盘发送给 HiFleet，可关闭该开关。关闭后：

- 私密邮箱船盘/货盘仍可本地展示、搜索和匹配。
- 不再补充 HiFleet 港口 ID、船舶档案和服务端 Tags。
- 公开船货盘、预抵船、订阅和用量查询仍可使用 HiFleet。

### 6.5 本地部署能降低什么风险

本地或客户自有服务器部署可以降低以下风险：

- 邮箱密码不经过第三方托管平台。
- 原始邮件和数据库保存在客户环境。
- 管理员可以控制普通用户账号、系统设置和登录审计。
- 客户可自行控制防火墙、HTTPS、访问权限和备份策略。
- 客户可选择是否接入外部 LLM、是否启用私密 HiFleet 富化。

## 7. 产品价值

- 把人工整理邮件的重复工作自动化。
- 将私密邮箱船货盘、公开船货盘和预抵船集中在一个界面。
- 提高港口检索、距离排序、船货匹配和跟进效率。
- 通过私有部署、登录权限和独立开关，兼顾业务效率与数据安全。
- 支持多语言和团队用户管理，适合跨国租船团队协作。

## 8. 交付形式

当前交付包为不包含后端源码的强化安装包：

```text
MyCharterAgent-Windows-x64-Protected-latest.zip
MyCharterAgent-Linux-x86_64-Protected-latest.tar.gz
```

Windows 包包含强化后端可执行文件 `charter_agent.exe`。Linux 包包含强化后端可执行文件 `charter_agent`。两个安装包均包含前端页面模板、示例配置和安装/启动/停止脚本。

安装包不包含：

- 后端源码 `app.py`
- 客户本机 `config.json`
- SQLite 数据库
- 邮件归档
- 服务日志

说明：强化可执行文件比 `.pyc` 交付具备更强源码保护，但不等同于不可逆加密。如客户需要更高保护强度，可结合代码签名、授权校验或服务器端托管方案。
