From 9f9db53a062c30a96e71136ed29b3fc1afec616e Mon Sep 17 00:00:00 2001
From: xmz7891 <xmz7891@gitee.com>
Date: Wed, 7 Oct 2026 12:25:27 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=A1=A5=E5=85=85=20EzHub=20?=
 =?UTF-8?q?=E4=BB=A4=E7=89=8C=E6=9D=83=E9=99=90=E5=9D=91=E5=92=8C=20SSH=20?=
 =?UTF-8?q?=E5=AE=9E=E9=99=85=E7=8A=B6=E6=80=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/双平台发布.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/双平台发布.md b/docs/双平台发布.md
index 7e6508e..fd32f87 100644
--- a/docs/双平台发布.md
+++ b/docs/双平台发布.md
@@ -24,6 +24,15 @@ ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMFMh2Zqwm+8KFhU3DhzhOO5Sx7cIzybYqUsrbt1c3ly
 **操作**：EzHub 网页 → 右上角头像 → **设置** → **SSH / GPG 密钥** → **增加密钥**
 → 把上面那一整行粘进去 → 保存。
 
+> ⚠️ **实测状态（2026-10-07）**：公钥加过一次，但服务端仍拒绝。
+> 报错：\Permission denied (publickey,password)> 本机送出的指纹：\SHA256:Acmu49YQcjw3m5WefOXSBzYNY2WPHLL2vvhnlYRAttA> 请到 EzHub 确认那条密钥的内容和上面**完全一致**（一个字符都不能差），
+> 并且加在**正确的账号**下。
+>
+> 在你修好之前，可以先用令牌走 HTTPS 推：
+> \\powershell
+> python _build\ezhub_push.py <令牌>
+> \> （令牌存在仓库外的 \%USERPROFILE%\.ykxmz\ezhub_token\）
+
 本机配置（已写好，不用你管）：
 
 ```
@@ -43,7 +52,22 @@ SSH 密钥只能推代码，**建发行版必须要令牌**。
 **操作**：EzHub 网页 → **设置** → **应用** → **生成令牌**
 → 名称随便（比如 `ykxmz-release`）→ 权限勾 **`write:repository`** → 生成 → 复制。
 
+> ⚠️ **只勾读权限是不行的**（实测踩过）。
+> Gitea 的令牌如果只有读权限：能读仓库、能列发行版，**看起来一切正常**，
+> 但一推代码就 `403 Forbidden`、一建发行版也 403。
+> Gitea 会把原因写在响应里：
+> `token does not have at least one of required scope(s): [write:repository]`
+>
+> 提前探一下（无副作用）：
+> ```powershell
+> python _build\probe_token.py <令牌>
+> ```
+> 原理：对一个**不存在的**发行版发 DELETE。
+> `403` = 缺写权限；`404` = 有写权限（只是资源不存在）。
+
 > 令牌只从命令行传给脚本，不落盘、不进仓库。
+> `_build/ezhub_push.py` 会把它存到 `%USERPROFILE%\.ykxmz\ezhub_token`
+> （仓库外），不会进版本库。
 
 ---