核心用法
FarmOS Land Portfolio 是一套面向规模化农业经营者的综合土地资产管理解决方案，核心功能覆盖四大模块：
1. 土地与租赁全景视图
通过 /api/integration/leases/all 和 /api/integration/parcels 端点获取完整的自有与租赁土地清单，包括地块位置、面积、所有权类型及租赁条款细节。系统特别强调数据完整性——强制使用 /all 后缀端点，严禁使用会截断至5条记录的 dashboard 接口。
2. 付款与现金流管理
支持多维度付款查询（按状态、类型、日期范围、作物年度），集成 /api/integration/payments/all 实现精准现金流规划。关键特性包括：逾期付款自动标红、未来N天付款预测、以及按日期/批量/单条的灵活标记付款功能。对于"三月需支付多少租金"类问题，系统要求显式返回记录总数与金额合计。
3. 地主关系维护
集中管理地主联系信息、活跃租约数量及总租金规模，数据访问受严格角色管控（仅 admin/manager 可见敏感商业信息）。
4. 年度财务规划
通过 /api/integration/finance/costs 与 /api/integration/finance/cost-per-field 实现按月度、类别、实体的成本拆解，支持P&L报表级的地块级成本归因。
显著优点
- 数据完整性保障：强制
/all端点策略杜绝"部分数据陷阱"，所有查询必须声明记录总数 - 双模式架构设计：集成端点（免认证）用于高频读取，认证端点（JWT）保护写操作，平衡便利与安全
- 前瞻性预警机制：自动标红6个月内到期租约、逾期付款及待执行任务
- 批量操作安全锁：租约续签与年度结转均强制"预览→确认→执行"三步流程
- 精细化权限控制：敏感商业数据（租金金额、地主联系方式）与操作权限（付款标记、租约续签）分级隔离
潜在局限性与风险
- 网络依赖性强：所有数据实时来自
http://100.102.77.110:8009，离线场景完全不可用 - 令牌时效窗口：JWT 仅15分钟有效期，长时操作需频繁刷新
- 无内置缓存层：重复查询可能产生冗余网络负载
- IP硬编码风险：内网地址暴露可能引发网络配置安全隐患
- 批量操作不可逆：租约续签与年度结转执行后无显式回滚机制
适合人群
规模化农场运营者（>1000英亩）、农业企业财务经理、负责多地主关系的土地协调员，以及需要整合土地成本进行作物级盈利分析的农场主。特别适合租约结构复杂（现金地租+产量分成+弹性租金混合）、付款周期密集（月付/季付/年付并存）的经营主体。
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 数据截断误读 | 误用 dashboard 端点导致决策基于不完整数据 | 严格遵循 `/all` 端点强制规则 |
| 越权数据泄露 | 非授权人员获取敏感租金/地主信息 | 强制检查 `~/.openclaw/farmos-users.json` 角色 |
| 误操作执行 | 批量付款标记或租约续签未确认即提交 | 严格执行预览→确认流程 |
| 令牌过期中断 | 写操作中途401导致流程断裂 | 操作前主动获取新令牌 |
| 网络单点故障 | 内网服务不可用时全功能瘫痪 | 建议配置健康检查与降级策略 |