From ba4467eea172efc99858e199fde3ffa367b36a7f Mon Sep 17 00:00:00 2001
From: stqfdyr <89149493+stqfdyr@users.noreply.github.com>
Date: Fri, 18 Sep 2026 21:50:08 +0800
Subject: [PATCH 1/3] =?UTF-8?q?docs:=20=E9=87=8D=E8=B7=91=E6=89=B9?=
 =?UTF-8?q?=E9=87=8F=E6=B3=A8=E5=86=8C=E7=9A=84=E8=AF=B4=E6=98=8E=E8=A1=A5?=
 =?UTF-8?q?=E4=B8=8A=E8=8A=82=E7=82=B9=E5=88=A0=E9=99=A4=E6=88=96=20token?=
 =?UTF-8?q?=20=E6=8D=A2=E5=8F=91=E5=90=8E=E7=9A=84=E6=83=85=E5=86=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/content/install/agent.mdx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/content/install/agent.mdx b/src/content/install/agent.mdx
index f3117cf..c5af939 100644
--- a/src/content/install/agent.mdx
+++ b/src/content/install/agent.mdx
@@ -33,7 +33,9 @@ for h in node1 node2 node3; do
 done
 ```
 
-窗口到点自动失效，一个窗口最多注册 100 台。重跑同一条命令不会重复添加，机器上已经有 token 就直接沿用。
+窗口到点自动失效，一个窗口最多注册 100 台。重跑同一条命令不会重复添加：机器上已有的 token 只要还对应着
+节点就直接沿用，窗口关了也一样。节点在面板里删掉了，或者 token 换发过，旧 token 就不再算数，要在开着的
+窗口里重新注册成一个新节点。
 
 <Note>
   key 泄露的影响范围：在窗口剩下的时间里最多建 100 个节点，每个只能上报它自己那一个节点，

From 5946bc579423ce250c240b44e9a736453034c41a Mon Sep 17 00:00:00 2001
From: stqfdyr <89149493+stqfdyr@users.noreply.github.com>
Date: Sat, 19 Sep 2026 05:47:55 +0800
Subject: [PATCH 2/3] =?UTF-8?q?docs:=20=E6=8D=A2=E5=8F=91=20token=20?=
 =?UTF-8?q?=E5=90=8E=E7=94=A8=E8=8A=82=E7=82=B9=E8=87=AA=E5=B7=B1=E7=9A=84?=
 =?UTF-8?q?=E5=AE=89=E8=A3=85=E5=91=BD=E4=BB=A4=E9=87=8D=E8=A3=85=EF=BC=9B?=
 =?UTF-8?q?=E6=9E=B6=E6=9E=84=E9=A1=B5=E8=AF=B4=E6=98=8E=E6=B3=A8=E5=86=8C?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E8=AE=A4=20X-Node-Token?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 批量注册一节只说节点删除后的情况；换发 token 的处理挪到「换 token」，说明重跑批量命令
  会多出一个节点、原节点留在面板里
- 架构页路由表下补充注册接口对 X-Node-Token 的处理
---
 src/content/dev/architecture.mdx | 3 +++
 src/content/install/agent.mdx    | 7 ++++---
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/content/dev/architecture.mdx b/src/content/dev/architecture.mdx
index 18d94a3..9e86b76 100644
--- a/src/content/dev/architecture.mdx
+++ b/src/content/dev/architecture.mdx
@@ -76,6 +76,9 @@ GET  /agent/{arch}          公开，把 release 二进制从 GitHub 转发给
 POST /api/agent/register    公开，凭窗口内有效的注册 key 换一个节点 token
 ```
 
+注册接口另认一个 `X-Node-Token` 头：安装器重跑时带上机器已有的 token，它仍对应节点就原样返回，不看窗口和
+key，所以窗口关了也能重跑；对应不上再按 key 注册。
+
 `arch` 只认 `x86_64` 和 `aarch64` 两个字面量。二进制总是走 hub 转发，能连上 hub 就能装，
 IPv6-only 或者出不去的机器不用再找加速站。并发转发数限到 4。
 
diff --git a/src/content/install/agent.mdx b/src/content/install/agent.mdx
index c5af939..a5041bc 100644
--- a/src/content/install/agent.mdx
+++ b/src/content/install/agent.mdx
@@ -34,8 +34,8 @@ done
 ```
 
 窗口到点自动失效，一个窗口最多注册 100 台。重跑同一条命令不会重复添加：机器上已有的 token 只要还对应着
-节点就直接沿用，窗口关了也一样。节点在面板里删掉了，或者 token 换发过，旧 token 就不再算数，要在开着的
-窗口里重新注册成一个新节点。
+节点就直接沿用，窗口关了也一样。节点在面板里删掉了，旧 token 就不再算数，要开着窗口重跑，那台机器会注册
+成一个新节点。
 
 <Note>
   key 泄露的影响范围：在窗口剩下的时间里最多建 100 个节点，每个只能上报它自己那一个节点，
@@ -48,7 +48,8 @@ done
 **节点 → 重新生成 token**。旧 token 立刻失效，包括已经连着的那条连接：hub 会把这个节点踢下线，
 它拿旧 token 重连会吃到 401。
 
-安装命令随时可以再看一次，token 不是只显示一次。
+安装命令随时可以再看一次，token 不是只显示一次。换发之后用这个节点自己的安装命令重装，不要重跑批量注册
+命令：批量命令认不出换发前的 token，会另建一个节点，原节点连同它的历史数据留在面板里一直显示离线。
 
 ## 卸载
 

From f945b235b079045a7c5fc29b2d42e3ee428f97db Mon Sep 17 00:00:00 2001
From: stqfdyr <89149493+stqfdyr@users.noreply.github.com>
Date: Sat, 19 Sep 2026 05:48:36 +0800
Subject: [PATCH 3/3] =?UTF-8?q?docs:=20=E6=8D=A2=E5=8F=91=20token=20?=
 =?UTF-8?q?=E7=9A=84=E8=AF=B4=E6=98=8E=E5=8D=95=E7=8B=AC=E6=88=90=E6=AE=B5?=
 =?UTF-8?q?=EF=BC=8C=E4=B8=8E=E5=8D=B8=E8=BD=BD=E9=A1=B5=E7=9A=84=E6=94=B9?=
 =?UTF-8?q?=E5=8A=A8=E9=94=99=E5=BC=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/content/install/agent.mdx | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/content/install/agent.mdx b/src/content/install/agent.mdx
index a5041bc..32eff20 100644
--- a/src/content/install/agent.mdx
+++ b/src/content/install/agent.mdx
@@ -48,8 +48,10 @@ done
 **节点 → 重新生成 token**。旧 token 立刻失效，包括已经连着的那条连接：hub 会把这个节点踢下线，
 它拿旧 token 重连会吃到 401。
 
-安装命令随时可以再看一次，token 不是只显示一次。换发之后用这个节点自己的安装命令重装，不要重跑批量注册
-命令：批量命令认不出换发前的 token，会另建一个节点，原节点连同它的历史数据留在面板里一直显示离线。
+换发之后用这个节点自己的安装命令重装，不要重跑批量注册命令：批量命令认不出换发前的 token，会另建一个
+节点，原节点连同它的历史数据留在面板里一直显示离线。
+
+安装命令随时可以再看一次，token 不是只显示一次。
 
 ## 卸载