0006 · 部署操作与权限排错说明

英文版本 为准，本文供参考。

状态：基于 main ad0d939e123f9cf77263de503a6aa2bdb14bd831，在 docs/deployment-clarity 分支准备，接续部署教程变更 。本次尚无提交、PR 或远程配置修改。

评审选择：用户仅选择独立验收评审；需求、方案、执行评审均由用户豁免，不记为通过。

需求

让部署指南 可以按步骤直接操作。移除套餐对比及删除部署环境引用的说明，写清启用部署、选择当前 main 的 push 任务、重跑及确认两站上传的操作。说明 Cloudflare 令牌的账号与用户权限范围，以及域名策略和账号策略的区别。保持中英文语义一致，提供被忽略的中文验收手册。

方案与决策

直接修改现有指南，复用 CI 发布流程，保留工作流、应用和依赖文件。本次文档变更不修改账号或密钥，不发布或部署。令牌及重跑官方说明于 2026-09-18 核对；没有依赖升级。

首次发布或恢复时，优先使用已有的当前 main push 任务；没有可用任务时，通过检查通过的 PR 触发。在同一处写明点击入口、提交匹配、产物及成功日志。日常发布和回滚沿用现有章节，不增加发布机制。

区分最初的 Cloudflare 认证错误与随后运行的 Wrangler 诊断。固定版本 Wrangler 4.131.1 的错误处理会先输出认证错误，再调用 whoami，后续成员诊断可能输出读取权限提示。仓库发布包装只报告失败站点和已完成的上传；后续确认失败请求为 Workers 子域名查询，认证错误码为 10000。该接口接受的 Workers Scripts Write 已在所提供的令牌汇总中，因此指南转而检查实际生效令牌、账号范围及密钥优先级，不要求继续添加用户权限。具体的凭据不匹配或限制仍未验证。

执行

精简部署开关设置，移除套餐和删除环境引用的分支说明。第 7 步围绕 GitHub 的 Code、Actions、重跑、任务日志入口重写，并给出 workers.dev 下可直接输入的页面路径。补充账号策略中的 Workers Scripts、Account Settings 搜索词与权限级别，单独说明个人令牌诊断权限、更新密钥及从最早错误开始排查的顺序。保留原有域名切换和回滚说明。

账号令牌路径依据 Cloudflare CI 认证文档 ；权限参考 区分账号、域名及用户权限，只限定到域名的策略不能授予账号级 Worker 上传权限。指南不声称只添加成员读取权限就能修复部署。

验收与迁移

2026-09-18 本地验证沿用 Node.js 26.8.2、pnpm 12.4.1、Go 1.27.1、Hugo Extended 0.166.0 固定版本。pnpm install --frozen-lockfile、pnpm tools:hugo、pnpm build 及 pnpm test:output 六项检查通过，依赖和锁文件未改变。git diff --check 通过。本地手册被忽略且在 Hugo 挂载外，公开产物不含其文件名及本机私有路径。

使用本机 Chrome 153.0.8010.53，在 1440 和 390 像素宽度检查两种语言：指南及变更页正常加载，11 个章节存在，宽表格保留横向滚动容器，无整页横向溢出。最终排错修订后，pnpm build:logs 及六项产物检查再次通过。源码检查覆盖四份公开文档中的 16 个相对链接，并查看了第 5、7 步具有代表性的桌面与手机截图。截图只供本地查看，不作为公开附件。

验收评审——通过（2026-09-18）：独立评审者检查了上述基线以来尚未提交的修改，范围为两份部署指南、本条双语变更记录及被忽略的中文验收手册。确认源码与官方参考准确、中英文步骤一致、复用现有 CI、测试与文档范围适当，并检查隐私、可复现性及公开与本地资料分离。无剩余阻塞项。需求、方案、执行评审仍记为用户豁免。

本次文档变更未重跑完整应用套件或部署 dry run，不声明外部凭据、上传、DNS 或 TLS 已验证。

本次无需迁移：仅修改指南和变更记录，不改变依赖、配置、数据结构、路由或部署行为。后续实际修正凭据属于指南所述的运维操作；先验证替代令牌再撤销旧令牌。提交后撤回文档走正常 revert PR；移除 worktree 前保存被忽略的本地验收手册。