iomgaa
303e4ebc1c
发布前置：readme 与 project.urls 从第一版就写全——缺 readme 的话 registry 包页面正文一片 空白，而 twine 只警告不阻塞上传，三步全绿产物却是坏的（PolyGateway 1.1.2 的教训）。 build 与 twine 钉进 dev extra 而不是靠人手装，PolyGateway 那边它们不在任何 extra 里， 于是发布指南得多写一条「记得先装」，那种步骤迟早有人漏。 README 里那条「项目还没有可用的功能、十个模块是空骨架」的横幅早就过期了，而打包会把当时的 README 固化进 sdist、发布后再改无效，所以在构建之前换成安装说明与现状。顺带修两处与事实 不符的：GovDoc-SaaS 的实现已经在 8 月 3 日整体清空，⑥ 对它的验收标准改成设计级验收。 新建 CHANGELOG.md，写清楚首个版本为什么是 1.0.1 而不是 0.x——「公共类型的字段只增不删不 改名」那条承诺从第一个下游装上它那天起就生效，而 0.x 意味着随时可以破坏兼容。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
19 lines
1015 B
Python
19 lines
1015 B
Python
"""PolyLoop：Agent 执行内核。
|
||
|
||
治理单位是一次运行——围绕一个目标的有界多轮「模型决策 → 动作 → 观察」循环。
|
||
一次模型调用不归它管，那是 PolyGateway 的治理单位。
|
||
|
||
**这里只再导出五个公开模块**：`types`、`ports`、`tools`、`serialization`、`session`。
|
||
`stores` 与 `adapters` 必须由使用者显式 import——顺手提供的默认实现会让每个进程在
|
||
import 时把网关连同它的 provider 目录一起拉起来，而不传存储的人不会知道自己这次运行
|
||
没有恢复能力。
|
||
|
||
分层与依赖方向见 `research-wiki/explanation/architecture.md`，一次运行到底保证什么见
|
||
`tests/contract/`。
|
||
"""
|
||
|
||
#: 与 `pyproject.toml` 的 `project.version` 必须一致，由 `tests/unit/test_package.py` 断言。
|
||
#: 两处双写是因为运行时读不到构建元数据（未安装的源码树里 `importlib.metadata` 查不到），
|
||
#: 而下游报 bug 时第一件事就是问版本号。
|
||
__version__ = "1.0.1"
|