PolyLoop

iomgaa/PolyLoop

Fork 0

Commit Graph

Author	SHA1	Message	Date
iomgaa	8c63367d3a	docs(guides): 按硕士生冷读改发布指南，并对齐 build/twine 已进 dev extra 冷读抓到三条确定性矛盾：registry 说「停在 1.0.5」而同一份文档又说 1.1.1/1.1.2 发出去了（真实情况是版本号中间断了一截，缺的恰好是 1.0.6 与 1.1.0）；「1.1.0 改回 1.0.4」与「版本只能往前走」打架（那次发生在 1.0.4 发布之前，发布前版本号只是文件里的字符串）；跑 Python 的命令带不带 conda 前缀两种形状并存（Makefile 的 target 内部已经包好了，裸敲就对）。作为操作指南，「照着做会卡住」就是缺陷，补了八处：建仓与接 remote 的命令、tea 要不要装、第四步合并与 push 的命令、token 那三个 export 只活在当前 shell、第八步解包看什么算通过、 README 里哪几行会随版本变、CHANGELOG 的日期形状、人类门批的是哪一次。末节「这些坑为什么在这里」整节删掉——冷读是扫读跳过的，因为五条里四条正文已经讲过，而且那一节的主语是「这份文档的九个步骤」不是发布这件事，正是 §6 禁止的自述。其中正文没有的三句就地并进对应步骤。另修一处它和代码的漂移：那一节写 build/twine 不在 dev extra、要手工装，而同一批改动正是把它们钉了进去。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-08-11 00:25:03 -04:00
iomgaa	855d9c376a	docs(guides): 写发布指南，guides/ 的第一份 CLAUDE.md §1.10 一直指着一份「还没写」的文档，现在它在了。九个步骤逐条写清为什么是这一步、为什么在这个位置，末节按「哪一步防哪个坑」把 PolyGateway 踩过的十来个坑映射回步骤，读者不用自己对应。素材来自对 PolyGateway 的调研并逐条核实过：registry 是 owner 级、工具只能是 twine （tea 0.15.0 没有 packages 子命令）、token 在 tea 的配置里不在 .pypirc、这台机器的代理到不了外面所以上传与验证都要绕开、同版本重传会被 409 拒绝、缺 readme 会让包页面空白而 twine check 只警告不拦。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-08-11 00:14:22 -04:00

Author

SHA1

Message

Date

iomgaa

8c63367d3a

docs(guides): 按硕士生冷读改发布指南，并对齐 build/twine 已进 dev extra

冷读抓到三条确定性矛盾：registry 说「停在 1.0.5」而同一份文档又说 1.1.1/1.1.2 发出去了
（真实情况是版本号中间断了一截，缺的恰好是 1.0.6 与 1.1.0）；「1.1.0 改回 1.0.4」与「版本
只能往前走」打架（那次发生在 1.0.4 发布之前，发布前版本号只是文件里的字符串）；跑 Python
的命令带不带 conda 前缀两种形状并存（Makefile 的 target 内部已经包好了，裸敲就对）。

作为操作指南，「照着做会卡住」就是缺陷，补了八处：建仓与接 remote 的命令、tea 要不要装、
第四步合并与 push 的命令、token 那三个 export 只活在当前 shell、第八步解包看什么算通过、
README 里哪几行会随版本变、CHANGELOG 的日期形状、人类门批的是哪一次。

末节「这些坑为什么在这里」整节删掉——冷读是扫读跳过的，因为五条里四条正文已经讲过，而且
那一节的主语是「这份文档的九个步骤」不是发布这件事，正是 §6 禁止的自述。其中正文没有的
三句就地并进对应步骤。

另修一处它和代码的漂移：那一节写 build/twine 不在 dev extra、要手工装，而同一批改动正是
把它们钉了进去。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-11 00:25:03 -04:00

iomgaa

855d9c376a

docs(guides): 写发布指南，guides/ 的第一份

CLAUDE.md §1.10 一直指着一份「还没写」的文档，现在它在了。九个步骤逐条写清为什么是这一步、
为什么在这个位置，末节按「哪一步防哪个坑」把 PolyGateway 踩过的十来个坑映射回步骤，读者
不用自己对应。

素材来自对 PolyGateway 的调研并逐条核实过：registry 是 owner 级、工具只能是 twine
（tea 0.15.0 没有 packages 子命令）、token 在 tea 的配置里不在 .pypirc、这台机器的代理
到不了外面所以上传与验证都要绕开、同版本重传会被 409 拒绝、缺 readme 会让包页面空白而
twine check 只警告不拦。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-11 00:14:22 -04:00

2 Commits