Skip to content

plctap v0.6.1 稳定化第一周期

Choose a tag to compare

@ymxc152 ymxc152 released this 08 Sep 16:46
· 6 commits to main since this release

v0.6.1 稳定化第一周期 —— wire 兼容修复 + 返回建模收编 + 兼容纪律生效

自本版起 README「版本与兼容承诺」生效:MCP 工具名 / 参数名 / 返回结构向后兼容,新增只增不改;破坏性变更将在 docstring / README / Release notes 三处提前标注。1.0(语义定稿)待该纪律验证一个完整发布周期后另行宣布。

修复

  • enip: RRData 嵌入长度超声明时产出负长度 route_path 伪字段 → 转结构化 errors + 回归测试
  • get_listener_frames / get_proxy_frames: limit=0 / 负数不再把整个环形缓冲(最多 1000 条)泼给调用方([-0:] 切片陷阱);语义定为"取最新 N 条 + 环形硬上限 1000",写入工具 docstring

内部(wire 不变)

  • 9 个 dict 返回工具收编 pydantic 建模(extra="forbid" 黄金锁);tests/test_tool_shapes.py 黄金键集合测试证明 wire 兼容——键集合与值语义与 0.6.0 完全一致
  • pyproject classifiers 升 Production/Stable;外迁文档死引用清理(detect 文案/BUILD.md 括注/PLAN 引用)

兼容性说明

  • 直接消费 JSON 的调用方:输出键集合与 0.6.0 一致(黄金测试锁定),无迁移成本
  • 使用 fastmcp 客户端且以属性方式取 .data 的调用方:9 个建模工具的 .data 现为模型实例(属性访问),不再支持字典下标——README 兼容承诺节已注明例外(list_protocols 的 protocols 条目仍为自由形态 dict)
  • 台架验收 38/38(v0.6.0 的 30 项 + 监听/代理 MCP 层段);测试 579 passed

安装

uvx plctap

PyPI: https://pypi.org/project/plctap/0.6.1/