[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75X9YQNDX8B6ZEVMKGM2TYR":3,"skill-same:01M75X9YQNDX8B6ZEVMKGM2TYR":76},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":52,"commitSha":53,"skillDirectory":54,"forksCount":55,"repositoryHtmlUrl":56,"repositoryHomepageUrl":57,"ownerHtmlUrl":58,"ownerBlogUrl":59,"ownerDescription":60,"updatedAt":61,"install":62,"resources":75},"01M75X9YQNDX8B6ZEVMKGM2TYR","windows-python-release",null,"当要手动发布 Python 包（codewiki-plus）到 PyPI 并建 GitHub Release 时——CI 不发布、Windows 控制台为 GBK、可能无 gh CLI、本机网络对 upload.pypi.org 的 Python TLS 握手有干扰——先核对 tag 区间与工作区未提交改动定 bump 级别，再按 8 步主干执行：同步四处版本→bump 提交（只 add 具体文件）→聚焦+ruff+全量闸门→清 dist 构建→PR 合并 main→tag merge commit 建 Release→uv publish（TLS 超时则 curl.exe 直传）→PyPI JSON API 核对","mambo-wang\u002FCodeWiki-Plus","mambo-wang","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F17296917?v=4","01M75489WXT2KCG0TDVRGMTEET","WanderingBug","01M75WY0F23J9DB5GBVTH8F8Q9",21,"MIT","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwindows-python-release\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: windows-python-release\ndescription: 当要手动发布 Python 包（codewiki-plus）到 PyPI 并建 GitHub Release 时——CI 不发布、Windows 控制台为 GBK、可能无 gh CLI、本机网络对 upload.pypi.org 的 Python TLS 握手有干扰——先核对 tag 区间与工作区未提交改动定 bump 级别，再按 8 步主干执行：同步四处版本→bump 提交（只 add 具体文件）→聚焦+ruff+全量闸门→清 dist 构建→PR 合并 main→tag merge commit 建 Release→uv publish（TLS 超时则 curl.exe 直传）→PyPI JSON API 核对\ntype: Skill\nstatus: stable\ngenerated:\n  by: codewiki\u002F5.8.0\n  at: \"2026-09-08T06:04:10Z\"\nstale_after: 2027-01-24\nmetadata:\n  summary: 手动发布 7 步主干 SOP + 每步避坑注解\n  source_refs: [\"wiki\u002Fscenarios\u002F发布与依赖治理方法.md\", \"notes\u002F2026-09-10-codewiki-手动发布完整流程同步四处版本测试build清distpublishrelease核对.md\", \"notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md\"]\n  revisions: [\"at: \\\"2026-09-08T06:04:10Z\\\"\", {\"at\": \"2026-09-10T02:02:25Z\", \"reason\": \"按主干优先重构：原 SOP 8 步中 6 步是避坑，缺发布主流程；改为 7 步主干（每步带判定点），避坑降级为步骤注解。来源为新增的流程型笔记。\", \"source\": \"skill_creator\"}, {\"at\": \"2026-09-23T04:05:06Z\", \"reason\": \"v5.13.0 发布实操回写：①新增步骤 5「PR 合并 main」（check-runs 轮询，非 commit status）；②tag 位置统一为 PR merge commit（main），废弃 v5.12.0 打在 develop bump commit 的旧做法；③步骤 7 补 TLS 握手干扰归因与 curl.exe（schannel）直传 legacy API 绕法，digest 字段名 sha256_digest；④核对端点补版本直查规避 JSON API 缓存延迟。来源：任务「发版本」v5.13.0 发布会话（2026-09-23）。\", \"source\": \"skill_creator\"}, {\"at\": \"2026-10-26T08:00:29Z\", \"reason\": \"v5.16.2\u002F5.16.3 发布实操回写：①新增步骤 0「判定发布内容与 bump 级别」——tag 区间无新提交 ≠ 无发布内容，先查工作区未提交改动；②步骤 2 补提交纪律——只 add 具体文件、fix 与 bump 分 commit、git add -A 会扫入无关未跟踪文件；③步骤 3 闸门细化为聚焦测试→ruff（CI 同口径）→全量；④步骤 6 补 Release API target_commitish 远端自动打 tag 的做法。来源：notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md（任务「发版本」v5.16.2\u002F5.16.3 会话）。\", \"source\": \"skill_creator\"}]\n  reason: created from candidate materials\n  source: skill_creator\n  installed_at: \"2026-10-26T11:01:51Z\"\n  installed_to: .codebuddy\u002Fskills\u002Fwindows-python-release\u002F\n  installed_hash: \"sha256:8d681945e85c6a784325343f0b5b55c172343c100ce7f69149e37cf24c11633e\"\n---\n\n\n## 工作场景\n\n手动发布 Python 包（`codewiki-plus`）到 PyPI 并创建 GitHub Release。**CI 只跑测试与 lint，不负责构建与发布**（`.github\u002Fworkflows\u002Fci.yml:13-74`），因此发布主干没有脚本承载，必须按序手工执行。Windows 控制台默认 GBK，环境可能无 gh CLI。\n\n## 适用条件\n\n- 发布是手动流程，仓库无发布脚本\n- 提交信息或 Release 正文含中文\u002Femoji\n- 环境无 gh CLI \u002F 未配置 GH_TOKEN，但 git credential manager 已保存凭据\n\n## 核心 SOP\n\n按序执行 8 步，**每步有判定点，不通过就停，不要带着问题往下走**。\n\n0. **判定发布内容与 bump 级别**：`git log \u003C上一tag>..HEAD --oneline` 看提交，**同时 `git status --short` + `git diff --stat` 核对工作区未提交改动**——tag 区间无新提交 ≠ 没有发布内容，发布内容可能全在未提交的工作区里（v5.16.2 实例：log 为空但 fix 改动全在工作区）。据实际内容定 patch\u002Fminor bump。\n   判定点：发布内容清单明确，bump 级别有依据。\n\n1. **同步四处版本引用**：`pyproject.toml`（`version`）、`codewiki\u002F__init__.py`（`__version__`）、`uv.lock`（用 `uv lock` 刷新，勿手改）、`codewiki\u002Fmcp\u002Fserver.py`（`version=__version__` 注入，勿手写常量）。CLI 与 actor id 也从 `__version__` 读取，自动跟随。\n   判定点：四处版本字符串完全一致。\n\n2. **提交 bump 并推送 develop**：消息 `chore: bump version to X`；推 `origin develop`。\n   判定点：`git show` 确认版本改动齐全。\n   ⚠️ 中文提交信息用 `git commit -F \u003Cutf8 文件>`，**不要用 `-m`**（GBK 破坏，乱码或拆词）。\n   ⚠️ **只 add 具体文件**：fix 改动与版本 bump 分两个 commit；工作区混着的 repowiki 产物等非发布文件不入库。`git add -A` 会扫入未跟踪的 `.scratch\u002F`、草稿文档等无关文件（v5.16.3 实例：误暂存 157 文件 8 万行），用 `git add -u` + 显式路径精确暂存。\n\n3. **发布闸门（按序）**：聚焦测试（改动模块，秒级）→ `ruff check` \u002F `ruff format --check`（本次变更的 py 文件，与 CI 增量 lint 同口径）→ 全量 `pytest -q`。\n   判定点：无失败用例，无 lint 错误。\n   ⚠️ 全量 `ruff format --check .` 会报 repowiki\u002Fconversations\u002F*.md 内嵌代码块——不在 CI Lint 范围，按 CI 同口径逐文件验证即可。\n\n4. **构建并清理产物**：`uv build`；发布前**清 `dist\u002F`** 或只精确指定本次产物。\n   判定点：`dist\u002F` 下只剩本次版本的 wheel 与 sdist。\n   ⚠️ 不清 `dist\u002F` 会连带上传旧产物（5.6.0 发布时残留 6 个）。\n\n5. **合并 main**：建 PR develop→main（无 gh CLI 时用 Python `subprocess` 调 `git credential fill` 取凭据再调 REST API，请求体显式 UTF-8）；轮询 head sha 的 **check-runs**（不是 commit status）等 CI 绿后合并。\n   判定点：PR merged，main 含 bump commit。\n\n6. **打 tag 并建 GitHub Release**：lightweight tag `vX.Y.Z` 打在 **PR merge commit 上（main 分支）**——Release 应反映 main 的事实状态；不要打在 develop 的 bump commit 上（v5.12.0 旧做法，与 Release 所属分支不一致）。Release 正文经 REST API 创建，显式 UTF-8；也可用 Release API 的 `target_commitish` 让远端自动打 tag。\n   ⚠️ Release 正文乱码**不可逆**（UTF-8 被按 GBK 解码写入，字符永久丢失），只能基于 `git log` 事实重写。\n   ⚠️ 给 `git credential fill` 喂 stdin 不用 PowerShell 管道（stdin 常为空、引号被破坏），用 `subprocess` 精确传字节；凭据只留进程内。\n\n7. **发布到 PyPI**：优先 `uv publish dist\u002Fcodewiki_plus-\u003Cversion>*`（精确指定，默认传 dist\u002F 全部）。\n   **token 来源：Windows 凭据管理器（keyring）**——`keyring.get_password('pypi', 'upload')`，首次配置：`keyring.set_password('pypi', 'upload', '\u003Ctoken>')`。**不要让用户把 token 粘贴到对话里**（本仓库 4 次泄露事故全部源于此），也不要写进仓库内任何文件（gitignore 不是安全边界，`.codebuddy\u002F` 是被跟踪目录）。\n   ⚠️ **本机网络对 upload.pypi.org 的 Python OpenSSL TLS 握手会被干扰**：uv publish \u002F twine \u002F requests 全部连接超时（TCP 通、curl 秒通）。绕法：curl.exe（schannel 栈）直传 legacy API——Python 从 whl 的 `*.dist-info\u002FMETADATA`、sdist 的 `PKG-INFO` 提取元数据构造完整表单（`:action=file_upload`、`protocol_version=1`、`filetype`、`pyversion` + 全部元数据字段 + `description` 正文），写 curl `-K` 配置文件（`form-string`，命令行会超长），`-u __token__:\u003Ctoken>` POST。**digest 字段名是 `sha256_digest`**（不是 `digests_sha256`，400 报 missing digest）。token 经参数传进程内，用完删临时文件。\n   ⚠️ **email.parser 提取元数据时 `Message.keys()` 对重复头返回 N 次**（如 4 个 `Project-URL`），循环内再 `get_all(key)` 会产生 N×N 重复字段（v5.13.1 时 project_urls 重复 16 条被 400 拒绝）。遍历前必须对 key 去重。\n\n8. **核对真实上传**：`https:\u002F\u002Fpypi.org\u002Fpypi\u002Fcodewiki-plus\u002Fjson` 查最新版本（JSON API 有缓存延迟，可直接查 `\u002Fpypi\u002Fcodewiki-plus\u002F\u003Cversion>\u002Fjson`）。\n   判定点：API 返回版本 == 目标版本，双产物 size 正确。\n\n## 判断逻辑\n\n- **主干优先**：先有完整流程，避坑是各步的注解，不是流程的替代品。缺任何一步（尤其是 3 闸门与 8 核对）都不算发布完成。\n- **tag 区间无新提交 ≠ 无事可发**：发布内容可能全在未提交的工作区改动里，先看 `git status` 再下结论（依据: notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md 的「tag 区间无提交容易被误判为无事可发」）。\n- 乱码\u002F拆词\u002Fstdin 失效同源：都是 cmd\u002FPowerShell 中间层破坏参数与编码。统一绕法是「落文件 \u002F 精确 subprocess」，不是加转义。\n- TLS 握手超时先做栈归因：TCP 通 + curl（schannel）通 + Python requests 超时 → 是 OpenSSL 栈被网络层干扰，换传输栈（curl.exe）而不是加超时重试。\n- PyPI 只增不改会幂等跳过已存在文件，但这是侥幸，不是安全网。\n\n## 禁忌与反模式\n\n- 不要 `git commit -m \"中文\"`\n- 不要 `git add -A` 一把梭——只 add 具体文件，fix 与 bump 分 commit\n- 不要不清 `dist\u002F` 就直接 `uv publish`\n- 不要跳过闸门（步骤 3）或发布后核对（步骤 8）\n- 不要用 PowerShell 管道或 `cmd \u002Fc echo` 给 `git credential fill` 喂 stdin\n- 不要试图反向还原 GBK 乱码文本（字符已丢失，只能重写）\n- PyPI 上传超时不要盲目加超时重试——先区分是读取慢（加超时有用）还是 TLS 握手被掐（换 curl.exe）\n- 不要把 PyPI token 写进任何落盘文件后不清理\n- 不要把 PyPI token 存进仓库内文件（含 gitignore 的文件）——统一走 keyring（Windows 凭据管理器）\n- 不要让用户把 token 粘贴到对话里——对话采集 hook 会把它原样写进 repowiki\u002Fconversations\u002F 并随提交推送\n\n依据: notes\u002F2026-09-10-codewiki-手动发布完整流程同步四处版本测试build清distpublishrelease核对.md 的「7 步主干与每步判定点」；wiki\u002Fscenarios\u002F发布与依赖治理方法.md 的「dist 残留被一并上传」「Release 正文乱码不可逆」「Windows 参数与 stdin 编码统一绕法」；任务「发版本」v5.13.0 发布实操（2026-09-23）：TLS 握手干扰归因与 curl.exe 绕法、sha256_digest 字段名、tag 打在 merge commit 的约定；notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md 的「tag 区间无提交先查工作区」「只 add 具体文件、fix 与 bump 分 commit」「闸门顺序聚焦→ruff→全量」\n\n","## 工作场景\n\n手动发布 Python 包（`codewiki-plus`）到 PyPI 并创建 GitHub Release。**CI 只跑测试与 lint，不负责构建与发布**（`.github\u002Fworkflows\u002Fci.yml:13-74`），因此发布主干没有脚本承载，必须按序手工执行。Windows 控制台默认 GBK，环境可能无 gh CLI。\n\n## 适用条件\n\n- 发布是手动流程，仓库无发布脚本\n- 提交信息或 Release 正文含中文\u002Femoji\n- 环境无 gh CLI \u002F 未配置 GH_TOKEN，但 git credential manager 已保存凭据\n\n## 核心 SOP\n\n按序执行 8 步，**每步有判定点，不通过就停，不要带着问题往下走**。\n\n0. **判定发布内容与 bump 级别**：`git log \u003C上一tag>..HEAD --oneline` 看提交，**同时 `git status --short` + `git diff --stat` 核对工作区未提交改动**——tag 区间无新提交 ≠ 没有发布内容，发布内容可能全在未提交的工作区里（v5.16.2 实例：log 为空但 fix 改动全在工作区）。据实际内容定 patch\u002Fminor bump。\n   判定点：发布内容清单明确，bump 级别有依据。\n\n1. **同步四处版本引用**：`pyproject.toml`（`version`）、`codewiki\u002F__init__.py`（`__version__`）、`uv.lock`（用 `uv lock` 刷新，勿手改）、`codewiki\u002Fmcp\u002Fserver.py`（`version=__version__` 注入，勿手写常量）。CLI 与 actor id 也从 `__version__` 读取，自动跟随。\n   判定点：四处版本字符串完全一致。\n\n2. **提交 bump 并推送 develop**：消息 `chore: bump version to X`；推 `origin develop`。\n   判定点：`git show` 确认版本改动齐全。\n   ⚠️ 中文提交信息用 `git commit -F \u003Cutf8 文件>`，**不要用 `-m`**（GBK 破坏，乱码或拆词）。\n   ⚠️ **只 add 具体文件**：fix 改动与版本 bump 分两个 commit；工作区混着的 repowiki 产物等非发布文件不入库。`git add -A` 会扫入未跟踪的 `.scratch\u002F`、草稿文档等无关文件（v5.16.3 实例：误暂存 157 文件 8 万行），用 `git add -u` + 显式路径精确暂存。\n\n3. **发布闸门（按序）**：聚焦测试（改动模块，秒级）→ `ruff check` \u002F `ruff format --check`（本次变更的 py 文件，与 CI 增量 lint 同口径）→ 全量 `pytest -q`。\n   判定点：无失败用例，无 lint 错误。\n   ⚠️ 全量 `ruff format --check .` 会报 repowiki\u002Fconversations\u002F*.md 内嵌代码块——不在 CI Lint 范围，按 CI 同口径逐文件验证即可。\n\n4. **构建并清理产物**：`uv build`；发布前**清 `dist\u002F`** 或只精确指定本次产物。\n   判定点：`dist\u002F` 下只剩本次版本的 wheel 与 sdist。\n   ⚠️ 不清 `dist\u002F` 会连带上传旧产物（5.6.0 发布时残留 6 个）。\n\n5. **合并 main**：建 PR develop→main（无 gh CLI 时用 Python `subprocess` 调 `git credential fill` 取凭据再调 REST API，请求体显式 UTF-8）；轮询 head sha 的 **check-runs**（不是 commit status）等 CI 绿后合并。\n   判定点：PR merged，main 含 bump commit。\n\n6. **打 tag 并建 GitHub Release**：lightweight tag `vX.Y.Z` 打在 **PR merge commit 上（main 分支）**——Release 应反映 main 的事实状态；不要打在 develop 的 bump commit 上（v5.12.0 旧做法，与 Release 所属分支不一致）。Release 正文经 REST API 创建，显式 UTF-8；也可用 Release API 的 `target_commitish` 让远端自动打 tag。\n   ⚠️ Release 正文乱码**不可逆**（UTF-8 被按 GBK 解码写入，字符永久丢失），只能基于 `git log` 事实重写。\n   ⚠️ 给 `git credential fill` 喂 stdin 不用 PowerShell 管道（stdin 常为空、引号被破坏），用 `subprocess` 精确传字节；凭据只留进程内。\n\n7. **发布到 PyPI**：优先 `uv publish dist\u002Fcodewiki_plus-\u003Cversion>*`（精确指定，默认传 dist\u002F 全部）。\n   **token 来源：Windows 凭据管理器（keyring）**——`keyring.get_password('pypi', 'upload')`，首次配置：`keyring.set_password('pypi', 'upload', '\u003Ctoken>')`。**不要让用户把 token 粘贴到对话里**（本仓库 4 次泄露事故全部源于此），也不要写进仓库内任何文件（gitignore 不是安全边界，`.codebuddy\u002F` 是被跟踪目录）。\n   ⚠️ **本机网络对 upload.pypi.org 的 Python OpenSSL TLS 握手会被干扰**：uv publish \u002F twine \u002F requests 全部连接超时（TCP 通、curl 秒通）。绕法：curl.exe（schannel 栈）直传 legacy API——Python 从 whl 的 `*.dist-info\u002FMETADATA`、sdist 的 `PKG-INFO` 提取元数据构造完整表单（`:action=file_upload`、`protocol_version=1`、`filetype`、`pyversion` + 全部元数据字段 + `description` 正文），写 curl `-K` 配置文件（`form-string`，命令行会超长），`-u __token__:\u003Ctoken>` POST。**digest 字段名是 `sha256_digest`**（不是 `digests_sha256`，400 报 missing digest）。token 经参数传进程内，用完删临时文件。\n   ⚠️ **email.parser 提取元数据时 `Message.keys()` 对重复头返回 N 次**（如 4 个 `Project-URL`），循环内再 `get_all(key)` 会产生 N×N 重复字段（v5.13.1 时 project_urls 重复 16 条被 400 拒绝）。遍历前必须对 key 去重。\n\n8. **核对真实上传**：`https:\u002F\u002Fpypi.org\u002Fpypi\u002Fcodewiki-plus\u002Fjson` 查最新版本（JSON API 有缓存延迟，可直接查 `\u002Fpypi\u002Fcodewiki-plus\u002F\u003Cversion>\u002Fjson`）。\n   判定点：API 返回版本 == 目标版本，双产物 size 正确。\n\n## 判断逻辑\n\n- **主干优先**：先有完整流程，避坑是各步的注解，不是流程的替代品。缺任何一步（尤其是 3 闸门与 8 核对）都不算发布完成。\n- **tag 区间无新提交 ≠ 无事可发**：发布内容可能全在未提交的工作区改动里，先看 `git status` 再下结论（依据: notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md 的「tag 区间无提交容易被误判为无事可发」）。\n- 乱码\u002F拆词\u002Fstdin 失效同源：都是 cmd\u002FPowerShell 中间层破坏参数与编码。统一绕法是「落文件 \u002F 精确 subprocess」，不是加转义。\n- TLS 握手超时先做栈归因：TCP 通 + curl（schannel）通 + Python requests 超时 → 是 OpenSSL 栈被网络层干扰，换传输栈（curl.exe）而不是加超时重试。\n- PyPI 只增不改会幂等跳过已存在文件，但这是侥幸，不是安全网。\n\n## 禁忌与反模式\n\n- 不要 `git commit -m \"中文\"`\n- 不要 `git add -A` 一把梭——只 add 具体文件，fix 与 bump 分 commit\n- 不要不清 `dist\u002F` 就直接 `uv publish`\n- 不要跳过闸门（步骤 3）或发布后核对（步骤 8）\n- 不要用 PowerShell 管道或 `cmd \u002Fc echo` 给 `git credential fill` 喂 stdin\n- 不要试图反向还原 GBK 乱码文本（字符已丢失，只能重写）\n- PyPI 上传超时不要盲目加超时重试——先区分是读取慢（加超时有用）还是 TLS 握手被掐（换 curl.exe）\n- 不要把 PyPI token 写进任何落盘文件后不清理\n- 不要把 PyPI token 存进仓库内文件（含 gitignore 的文件）——统一走 keyring（Windows 凭据管理器）\n- 不要让用户把 token 粘贴到对话里——对话采集 hook 会把它原样写进 repowiki\u002Fconversations\u002F 并随提交推送\n\n依据: notes\u002F2026-09-10-codewiki-手动发布完整流程同步四处版本测试build清distpublishrelease核对.md 的「7 步主干与每步判定点」；wiki\u002Fscenarios\u002F发布与依赖治理方法.md 的「dist 残留被一并上传」「Release 正文乱码不可逆」「Windows 参数与 stdin 编码统一绕法」；任务「发版本」v5.13.0 发布实操（2026-09-23）：TLS 握手干扰归因与 curl.exe 绕法、sha256_digest 字段名、tag 打在 merge commit 的约定；notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md 的「tag 区间无提交先查工作区」「只 add 具体文件、fix 与 bump 分 commit」「闸门顺序聚焦→ruff→全量」\n\n",{"name":5,"type":24,"status":25,"metadata":26,"generated":48,"description":7,"stale_after":51},"Skill","stable",{"reason":27,"source":28,"summary":29,"revisions":30,"source_refs":41,"installed_at":45,"installed_to":46,"installed_hash":47},"created from candidate materials","skill_creator","手动发布 7 步主干 SOP + 每步避坑注解",[31,32,35,38],"at: \"2026-09-08T06:04:10Z\"",{"at":33,"reason":34,"source":28},"2026-09-10T02:02:25Z","按主干优先重构：原 SOP 8 步中 6 步是避坑，缺发布主流程；改为 7 步主干（每步带判定点），避坑降级为步骤注解。来源为新增的流程型笔记。",{"at":36,"reason":37,"source":28},"2026-09-23T04:05:06Z","v5.13.0 发布实操回写：①新增步骤 5「PR 合并 main」（check-runs 轮询，非 commit status）；②tag 位置统一为 PR merge commit（main），废弃 v5.12.0 打在 develop bump commit 的旧做法；③步骤 7 补 TLS 握手干扰归因与 curl.exe（schannel）直传 legacy API 绕法，digest 字段名 sha256_digest；④核对端点补版本直查规避 JSON API 缓存延迟。来源：任务「发版本」v5.13.0 发布会话（2026-09-23）。",{"at":39,"reason":40,"source":28},"2026-10-26T08:00:29Z","v5.16.2\u002F5.16.3 发布实操回写：①新增步骤 0「判定发布内容与 bump 级别」——tag 区间无新提交 ≠ 无发布内容，先查工作区未提交改动；②步骤 2 补提交纪律——只 add 具体文件、fix 与 bump 分 commit、git add -A 会扫入无关未跟踪文件；③步骤 3 闸门细化为聚焦测试→ruff（CI 同口径）→全量；④步骤 6 补 Release API target_commitish 远端自动打 tag 的做法。来源：notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md（任务「发版本」v5.16.2\u002F5.16.3 会话）。",[42,43,44],"wiki\u002Fscenarios\u002F发布与依赖治理方法.md","notes\u002F2026-09-10-codewiki-手动发布完整流程同步四处版本测试build清distpublishrelease核对.md","notes\u002F2026-10-26-发版时-tag-区间无新提交发布内容可能在未提交的工作区改动里提交只-add-具体文件.md","2026-10-26T11:01:51Z",".codebuddy\u002Fskills\u002Fwindows-python-release\u002F","sha256:8d681945e85c6a784325343f0b5b55c172343c100ce7f69149e37cf24c11633e",{"at":49,"by":50},"2026-09-08T06:04:10Z","codewiki\u002F5.8.0",1800748800000,"develop","ba8919e7a5182cc94dbe3e9b3a46f4c2e8fa209d","repowiki\u002Fskills\u002Fwindows-python-release",4,"https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus","https:\u002F\u002Fpypi.org\u002Fproject\u002Fcodewiki-plus\u002F","https:\u002F\u002Fgithub.com\u002Fmambo-wang","https:\u002F\u002Fblog.csdn.net\u002Fsinat_27143551","专注Java后端开发，喜欢运动","2026-11-13 15:29:46",{"source":8,"skillName":5,"commands":63,"prompt":73,"zipAvailable":74},[64,67,70],{"tool":65,"command":66},"npx","npx skills add mambo-wang\u002FCodeWiki-Plus --skill windows-python-release",{"tool":68,"command":69},"bunx","bunx skills add mambo-wang\u002FCodeWiki-Plus --skill windows-python-release",{"tool":71,"command":72},"pnpm","pnpm dlx skills add mambo-wang\u002FCodeWiki-Plus --skill windows-python-release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwindows-python-release\u002FSKILL.md",true,[],[77,84,91,98,105,112],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M75XA78546E66PCC3JV2TM3Q","write-doc-file-content-file-sidechannel","write_doc_file 建档报目标路径已被手写文件占用\u002F路由冲突时——走 content_file 临时文件侧通道：正文写临时文件→删占位文件→write_doc_file(content_file=...) 正式建档→删临时文件","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwrite-doc-file-content-file-sidechannel\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M75X9MGBPRG6JDCRAY97E5T0","windows-dev-env","Windows\u002FPowerShell 下做 git 写操作、跑子进程或批量文件\u002F测试清理时：shell 漂移与中文路径致命令静默失败、无控制台宿主子进程闪窗、GCM 每次弹 OAuth 框、原生 DLL 被锁——须显式复核落盘、subprocess 加 CREATE_NO_WINDOW、gh auth setup-git 持久化凭据，并用 cmd \u002Fc 绕 safe-delete 钩子","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fwindows-dev-env\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M75X9H4YYF5C29JR7AF44K84","repowiki-conclusion-update","已落库 repowiki 结论发生变化时，按「结论方向 vs 表述」分流：方向变则新写 decision 笔记+reject_note 旧+confirm 并回源 ADR，仅表述\u002F证据变则 edit_doc_file 原地改","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Frepowiki-conclusion-update\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":19},"01M75X9CD6FDMX1RDE9NZEFNVY","maintain-fork-pr-merge","当合入 fork 来源的 PR 且 mergeStateStatus=CONFLICTING\u002FDIRTY 时——先 git merge-tree 探测冲突清单，查 maintainer_can_modify，再在 worktree 隔离目录解冲突后 push fork 分支，勿因 CI 绿直接 merge","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fmaintain-fork-pr-merge\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":19},"01M75X98KRKX80JQ9Y4PR8WZCK","git-commit-hygiene","在共享 worktree 多会话并行或暂存区有残留时提交代码——用显式 pathspec 只提交自己的文件并排除临时目录，禁止 git add -A 或裸 commit 扫入并行会话的改动","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002Frepowiki\u002Fskills\u002Fgit-commit-hygiene\u002FSKILL.md",[],[],{"skillNo":113,"name":114,"nameZh":6,"description":115,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":116,"categories":117,"keywords":118,"publishedAt":19},"01M75X974418SW9AX2J45B43Q0","writing-shape","Writing, exploit: shape raw material into an article, paragraph by paragraph.","https:\u002F\u002Fgithub.com\u002Fmambo-wang\u002FCodeWiki-Plus\u002Fblob\u002Fdevelop\u002F.trae\u002Fskills\u002Fwriting-shape\u002FSKILL.md",[],[]]