timeline.md 3.2 KB

时间线

本文件只保留可帮助交接的里程碑与部署状态。测试过程细节由 Git 历史和当前测试代码承载,现行合同以 README.md 与其他四份 project-docs 为准。

2026-07-06 至 2026-07-08:基础 Gateway 与公网安全

  • 建立项目文档与本地 stdio Gateway,随后增加公网 HTTP JSON-RPC、Redis 设备会话和健康检查。
  • 公网审计不记录授权码或 token,限流身份不再默认信任调用方可伪造的转发头。
  • 正式员工接入统一使用后台生成的 GWS_xxx,旧授权码绑定流程退出运行时。

2026-07-13 至 2026-07-15:协议错误与安全展示

  • stdio/public 统一工具响应适配:后端业务失败返回 MCP isError=true,不再错误标记为成功,也不中断 JSON-RPC 会话。
  • 引入 OutputPresenter,将受支持工具的内部结果转换为中文白名单 DTO;query_order 保持旧协议兼容。
  • 增加未排舱订单导出、省外进港资料导出及对应权限筛选项。

2026-07-16:排舱查询

  • 增加 query_outbound_listquery_outbound_detail,同步本地/公网注册、CLI 参数和 Presenter。
  • 排舱列表使用固定中文业务列;详情使用汇总与订单明细两层结构,附件只保留安全文件字段。

2026-07-17:工具边界、筛选与限流

  • 12 个候选工具统一采用零推断说明:先确认结果意图与号码类型,禁止格式猜测、并行试查和跨字段/跨工具重试。
  • list_outbound_filter_options 统一七类排舱筛选项,仓库能力并入该工具,不保留重复入口。
  • 排舱阶段改为必选;运输方式未指定时查询全部运输方式。
  • initializetools/list 退出限流,tools/call 保持按设备会话与工具分桶。
  • 本地 GatewayApp 与公网 PublicGatewayApp 对齐为 12 个候选工具;OutputPresenter 处理其中 11 个安全工具。
  • 用户确认 Y:/fmsoperate/sql 的 10 个 MCP SQL 与 Y:/base/sql 的 5 个 MCP SQL 均已执行。
  • 文档治理建立 AGENTS.md,放行并重写 project-docs 五件套;历史计划与旧测试快照经校验备份后从活动工作区清理。

2026-07-17:订单详情工具

  • 增加 query_order_detail 的中文模块 Schema、本地/公网双注册、CLI 转发和严格白名单 Presenter。
  • 支持 section=全部 一次返回概览和十个明细模块,各明细模块独立分页并保持中文白名单展示。
  • 概览固定展示状态节点及四组业务信息;明细覆盖箱单、DW、附件、入库、查验、轨迹、日志和派送,附件保留安全链接。
  • fmsoperate 注册 SQL 仍待目标环境执行;Gateway 重启、Workbuddy 重连和实际动态可见性仍需发布确认。

当前交接

  • Python 测试继续执行 .coveragerc 的语句与分支 100% 门禁;发布前必须重新运行,不能引用历史报告代替。
  • 原有 SQL 执行状态已确认,订单详情注册 SQL尚待执行;工具当前动态启用值仍需通过实际员工会话的 tools/list 核验。
  • 运行中 Gateway 是否已加载当前代码、Workbuddy 是否已重新连接,无法由仓库静态判断,发布交接必须显式确认。