Registry 页面与包介绍¶
状态： 公开指引，2026-11-05。包 Registry 页面是发布时生成的快照。源码 README、 清单和文档站可能更新。不要从陈旧页面推断当前行为，也不要假设本仓库的修改会自动更新 已发布页面。
这对采用很重要：编程 Agent 或开发者可能先看到 PyPI、npm、Maven Central、pkg.go.dev、 crates.io、NuGet、RubyGems、Packagist、Hex、pub.dev 等 Registry 页面，而不是文档站。
各 Registry 页面来源¶
| Registry 类别 | 页面来源 | 何时变化 |
|---|---|---|
| Go module proxy / pkg.go.dev | Tag 对应的模块 README 与包文档 | 新模块 tag |
| PyPI | 已发布 summary、keywords、classifiers、project URLs、README | 新版本发布 |
| npm | 已发布 description、keywords、README、repository、homepage | 新版本发布 |
| Maven Central | POM name、description、URL、license、SCM；Javadoc/sources | 新部署 |
| crates.io、NuGet、RubyGems、Packagist、Hex、pub.dev、LuaRocks、DUB、PowerShell Gallery、r-universe 等 | 各 Registry 自身的元数据与 README 渲染 | 新 Registry 发布 |
具体地址与当前版本见Registry 发布状态。该页记录发布状态，不承诺 每个页面介绍都是最新的。
每个语言源码目录还提供面向 Registry 的 REGISTRY.md、llms.txt 与 llms.md；
总索引见语言 Registry 与编程 Agent 入口。
这些是源码入口，不证明 Registry 页面已刷新。
生成入口区分 source_version 与 published_version。源码发布可以在 Registry 页面更新前准备；
在新 tag 发布前，消费者应安装已发布版本。准备好的源码 tag 不是 Registry 可用性的证据。
页面检查清单¶
- 精确包名、版本、安装命令与运行时版本。
- 一句话定位：可嵌入、可治理的 Agent 运行时，包含 Policy、人工审批、Checkpoint 与 工具调用。
- Registry 支持时使用具体关键词，例如
agent-runtime、tool-authorization、policy-enforcement、human-in-the-loop、checkpoint、embeddable。 - 链接到规范文档站、语言消费者 Starter、安全模型与 何时不应选择。
- 许可证与源码/仓库链接。
- 不声明 exactly-once、完整沙箱隔离、生产安全认证或实时/物理安全。
- 版本元数据与源码 tag、Registry 一致。
当前试点页面审计¶
2026-11-13 核对四个试点包的 Registry 版本。
| 语言 | 页面 | 已发布版本 | 当前页面状态 | 下一步 |
|---|---|---|---|---|
| Go | pkg.go.dev | v2.8.0 |
渲染后的 v2.8.0 README 包含 @v2.8.0 安装命令、MIT 许可、规范文档与消费者链接；module proxy @latest 为 v2.8.0；2026-11-09 已核对 |
无需进一步操作 |
| Python | PyPI | 0.6.0 |
0.6.0 已发布，但渲染描述仍包含较旧的安装命令与源码版本文本 |
下次发布时刷新包 README |
| TypeScript | npm | 0.5.0 |
0.5.0 已作为 latest 发布；渲染页面文本尚未重审 |
刷新发布元数据时重审 0.5.0 页面 |
| Java | Maven Central | 0.7.0 |
Maven metadata 报告 0.7.0；Central 不渲染 README |
刷新发布元数据时重审 sources 与 javadoc |
本仓库的源元数据更新不会改变已发布的 0.6.0、0.5.0 与 0.7.0 语言页面。
Go 页面随 v2.8.0 tag 更新，并已于 2026-11-09 重新核对。在其他 Registry 显示新版本与
新文本前，不得声称对应页面已更新。
其他 Registry 见Registry 发布状态。本次未逐一重新审计；发布时 使用同一清单，不能仅凭源码推断页面质量。
面向编程 Agent¶
- 读取 Registry 页面的精确包名、版本与安装命令。
- 行为、边界与验证命令以规范文档站为准。
- 依赖某能力前先核对已发布版本。
- 页面陈旧时报告它，并使用 编程 Agent 集成契约，不要从页面推断未支持行为。
面向维护者¶
- 发布前更新源 description、keywords、README 与规范链接，而不是发布后。
- 通过新版本更新 Registry 页面；不得移动或复用 tag。
- 发布后验证渲染的 description、keywords、README、安装命令、许可证与版本，然后更新 Registry 发布状态的检查日期。
- Registry 专用流程保留在内部发布 runbook。
实际发布包验收¶
源码 README 修改不等于完成。下一次正式发布时，必须验证真实工件与页面：
| 证据 | 验收要求 |
|---|---|
| 身份 | 精确包名、版本、不可变源码 tag 与工件摘要一致 |
| 包内介绍 | 检查下载的 wheel/sdist、npm tarball、Maven POM/sources 或 Go tag，不检查 main 替代品 |
| 页面展示 | 在对应版本的公开 URL 核对定位、消费者 Starter、限制、安装方式和运行时要求 |
| 消费者安装 | 在干净消费者中安装该版本，执行文档中的确定性 smoke/允许拒绝检查 |
| 责任边界 | 说明 Core 实现、测试证据和消费者责任；Policy 需配置，沙箱接口不等于隔离，Checkpoint 不等于外部事务 |
将版本、URL、核对日期、工件哈希与观察结果记录后，才能在 注册表发布状态标为页面已更新。索引或渲染延迟应标记待核实，不能从 发布 job 推断成功。不渲染 README 的注册表（例如 Maven Central）也需准确元数据与规范文档链接。
MATLAB 兼容性元数据¶
2026-11-06 核对：File Exchange
的 0.3.0 显示“Compatible with any release”和 Windows/macOS/Linux，安装菜单又显示
R2026b 或更新版本。这些标签不是独立 MATLAB 验证证据。当前执行证据仅来自 GNU Octave
11.3.0，MATLAB 运行及实际安装包验证仍未完成。提交所有者需收窄可编辑兼容性字段，或在
Overview 顶部添加醒目限制。修改源码不会自动修改线上提交。