From 48ee35558554d8592b6a3354383c1ee266fb07fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=90=E5=BF=B5=E4=BA=91?= <noreply@munianyun.com>
Date: Wed, 1 Jul 2026 18:19:34 +0800
Subject: [PATCH] docs: add plugin readme

---
 README.md | 149 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 149 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b14b30e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,149 @@
+# 下游推送域名修复插件
+
+用于你站点名下代理用户的地址变更后，可通过本插件直接批量更换推送代理新地址。
+
+## 功能说明
+
+本插件用于批量修改指定客户名下服务器的下游推送地址。
+
+当代理用户更换域名后，系统数据库中已保存的推送地址仍然可能是旧域名，导致上游向下游推送时请求失败，例如出现 `HTTP 404`。通过本插件可以按客户 ID 批量修复这些服务器的推送域名。
+
+插件会更新数据库中：
+
+```text
+shd_host.stream_info
+```
+
+字段内 JSON 的：
+
+```text
+downstream_url
+```
+
+## 适用场景
+
+- 代理站更换域名
+- 上游推送下游失败
+- 数据库中保存的下游推送地址仍是旧地址
+- 需要按客户 ID 批量修复该客户名下所有服务器的推送地址
+
+## 安装方式
+
+将插件目录上传到系统插件目录：
+
+```text
+public/plugins/addons/downstream_domain_fix
+```
+
+然后进入后台插件管理页面，找到并安装：
+
+```text
+下游推送域名修复
+```
+
+## 使用方法
+
+进入插件后台菜单：
+
+```text
+修复推送域名
+```
+
+填写以下信息：
+
+| 字段 | 说明 | 示例 |
+| --- | --- | --- |
+| 客户ID | 需要批量修复的客户 ID，对应 `shd_host.uid` | `810` |
+| 指定推送域名 | 新的代理站地址 | `https://www.ysyplat.cn` |
+
+点击：
+
+```text
+开始修复
+```
+
+插件会自动处理该客户名下符合条件的服务器。
+
+## 处理规则
+
+插件只会处理满足以下条件的服务器：
+
+1. `shd_host.uid` 等于输入的客户 ID
+2. `stream_info` 不为空
+3. `stream_info` 中存在完整的下游推送信息：
+   - `downstream_url`
+   - `downstream_token`
+   - `downstream_id`
+
+插件会跳过以下服务器：
+
+- 没有下游推送信息的服务器
+- 下游推送信息不完整的服务器
+- 当前推送域名已经等于目标域名的服务器
+
+## 修改内容
+
+插件实际修改的是：
+
+```text
+shd_host.stream_info.downstream_url
+```
+
+不会修改：
+
+- 产品信息
+- 客户信息
+- 订单信息
+- 服务器状态
+- `downstream_token`
+- `downstream_id`
+
+## 域名填写说明
+
+填写站点根地址即可，例如：
+
+```text
+https://www.ysyplat.cn
+```
+
+如果系统安装在子目录，则填写到系统根目录，例如：
+
+```text
+https://www.ysyplat.cn/finance
+```
+
+## 处理结果
+
+执行后页面会显示：
+
+- 匹配服务器数量
+- 成功更新数量
+- 跳过数量
+- 每台服务器的处理结果
+
+结果表格包含：
+
+- Host ID
+- 主机名
+- 主 IP
+- 状态
+- 原推送域名
+- 新推送域名
+- 处理结果
+
+## 注意事项
+
+- 执行前建议先备份数据库。
+- 请确认客户 ID 正确，避免修改错误客户名下的服务器。
+- 本插件只修改本地数据库中的推送域名，不主动调用上游接口。
+- 修改完成后，上游后续推送会读取新的 `downstream_url`。
+
+## 插件信息
+
+| 项目 | 内容 |
+| --- | --- |
+| 插件名称 | 下游推送域名修复 |
+| 插件标识 | `DownstreamDomainFix` |
+| 插件目录 | `downstream_domain_fix` |
+| 作者 | 沐念云 |
+| 版本 | `1.0` |