tom/dpl
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: use server-side node onboarding without DPL page acceptance

Browse Source
This commit is contained in:
hellcat 2026-10-20 17:11:51 +08:00
parent 155ee10370
commit 852b38c25d
4 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
AGENTS.md
View File

@ -8,7 +8,7 @@
- 修改功能时同步相应维护说明与验收状态。原有业务约束见 docs/maintenance/BUSINESS_RULES.md。 - 修改功能时同步相应维护说明与验收状态。原有业务约束见 docs/maintenance/BUSINESS_RULES.md。
- 文档放 docs/maintenance/；任务截图、日志与临时脚本放 codex/output/；密钥和私密配置不提交 Git。 - 文档放 docs/maintenance/；任务截图、日志与临时脚本放 codex/output/；密钥和私密配置不提交 Git。
- 本地开发优先 dev/热更新；构建用于发布或构建验证。相关检查与命令见 docs/maintenance/ARCHITECTURE.md。 - 本地开发优先 dev/热更新；构建用于发布或构建验证。相关检查与命令见 docs/maintenance/ARCHITECTURE.md。
- 后台变更实际验证显示、切换、保存与权限；HTTP 200 不代表界面可用。测试、提交、发布和真实验收分别报告，未执行的步骤不能写成完成。 - 后台界面功能变更仍实际验证显示、切换、保存与权限；HTTP 200 不代表界面可用。节点接入按用户2026-10-20长期要求，不再默认登录DPL或进行DPL页面验收；经白色机使用服务器侧正式脚本、应用模型/事务操作并回读线上数据，仍须完成订阅、联网/上报、权限、QA清理和旧资源回归。执行范围唯一入口见[服务器侧接入](docs/maintenance/NODE_BATCH_RUNTIME.md#服务器侧接入与验收)。测试、提交、发布和真实验收分别报告，未执行的步骤不能写成完成。
## 批量节点接入：默认启动一个子助手 ## 批量节点接入：默认启动一个子助手

6
docs/maintenance/NODE_BATCH_RUNTIME.md
View File

@ -4,6 +4,12 @@
`batch.py`保留原命令适配器兼容，新计划默认用`configure-site.py`生成`runtime.kind=ssh-site-v1`。旧计划、账本、任务handler一律保留，不修改源码摘要后直接续跑旧任务。生产操作仍须具体接入授权、独立助手审核、Git运维部署及现场验收。 `batch.py`保留原命令适配器兼容，新计划默认用`configure-site.py`生成`runtime.kind=ssh-site-v1`。旧计划、账本、任务handler一律保留，不修改源码摘要后直接续跑旧任务。生产操作仍须具体接入授权、独立助手审核、Git运维部署及现场验收。
## 服务器侧接入与验收
用户2026-10-20长期指定：新增节点不再默认登录DPL管理页面或进行页面验收。通过白色机SSH在面板应用根目录运行正式stage/promote/readiness及验收脚本，使用应用模型、业务服务、事务和操作journal读写线上数据；保留写前基线、参数/身份校验、幂等恢复和精确回退，不临时绕过业务逻辑写裸SQL。此前批次的节点记录本就由这些服务器侧脚本写入，浏览器仅承担额外回读。
完成标准仍包括新增资源参数回读、隔离完整订阅联网/严格TLS/预期出口和双向上报、append正式组、动态正式订阅按影响范围验收、QA禁用403/下发排除、旧节点/套餐/用户关联/订阅设置/网关容器及原服务保护。DPL页面验收不再列为节点接入未完成项；未做的界面/手机/TUN测试仍按事实注明。此规则不覆盖真正的后台界面功能修改，不授权本机网站访问或第三方后台写入越界。
## 文件与职责 ## 文件与职责
| 文件 | 职责 | | 文件 | 职责 |

2
docs/maintenance/NODE_RUNBOOK.md
View File

@ -169,7 +169,7 @@ python3 /opt/dpl-gateway/provision/verify-node.py \
| 正式开放 | 正式有效用户订阅与完整expectations逐一对应，检查实际权限及QA清理；按[影响范围](NODE_BATCH_RUNTIME.md#按影响范围验收2026-10-20)决定完整联网或轻量TLS，不能把轻量结果称为出口/鉴权通过 | | 正式开放 | 正式有效用户订阅与完整expectations逐一对应，检查实际权限及QA清理；按[影响范围](NODE_BATCH_RUNTIME.md#按影响范围验收2026-10-20)决定完整联网或轻量TLS，不能把轻量结果称为出口/鉴权通过 |
| QA 清理 | QA banned、其订阅拒绝、实际下发用户集合无 QA；客户端退出、临时本地秘密副本清理，服务器审计文件保留 | | QA 清理 | QA banned、其订阅拒绝、实际下发用户集合无 QA；客户端退出、临时本地秘密副本清理，服务器审计文件保留 |
| 回归 | 原节点/中转、套餐字段/用户组、订阅 URL、网关容器 ID/启动时间/重启计数与 before 快照对照 | | 回归 | 原节点/中转、套餐字段/用户组、订阅 URL、网关容器 ID/启动时间/重启计数与 before 快照对照 |
| 浏览器 | 正确反代入口，管理列表与保存结果回读；只查看后取消不算提交验收 | | DPL数据回读 | 用户2026-10-20长期指定无需登录DPL或页面验收；经白色机正式脚本/应用模型回读节点、机器、组及保存值，并绑定实际链路证据。边界见[服务器侧接入](NODE_BATCH_RUNTIME.md#服务器侧接入与验收) |
面板回读命令入口如下；它只覆盖该脚本实际返回的节点/QA 字段，其他行须另留证据： 面板回读命令入口如下；它只覆盖该脚本实际返回的节点/QA 字段，其他行须另留证据：

2
docs/maintenance/README.md
View File

@ -7,7 +7,7 @@
1. 按全局规则先读 CoDocs 项目总览、首次会话的持续维护协议与 dpl 档案，再读项目根目录 AGENTS.md、当前用户要求和本目录说明。用户最新明确边界优先，不扩大本次授权。 1. 按全局规则先读 CoDocs 项目总览、首次会话的持续维护协议与 dpl 档案，再读项目根目录 AGENTS.md、当前用户要求和本目录说明。用户最新明确边界优先，不扩大本次授权。
2. 确认所在仓库、分支、工作区差异与远端；分别识别用户既有修改、本次任务与其他聊天修改。不要覆盖、清理或混入其他任务。 2. 确认所在仓库、分支、工作区差异与远端；分别识别用户既有修改、本次任务与其他聊天修改。不要覆盖、清理或混入其他任务。
3. 按 [架构与配置](ARCHITECTURE.md) 沿实际调用链检查问题；按 [业务约束](BUSINESS_RULES.md) 判断影响。 3. 按 [架构与配置](ARCHITECTURE.md) 沿实际调用链检查问题；按 [业务约束](BUSINESS_RULES.md) 判断影响。
4. 修改后运行与影响范围相关的检查；后台界面必须浏览器验收，包括页面显示、保存、切换、权限。HTTP 200 不代表前端可用。 4. 修改后运行与影响范围相关的检查；后台界面功能修改必须浏览器验收，包括页面显示、保存、切换、权限。节点接入按[服务器侧接入](NODE_BATCH_RUNTIME.md#服务器侧接入与验收)完成数据与实际链路验收，用户2026-10-20长期指定无需登录DPL或页面验收。HTTP 200 不代表前端可用。
5. 本地实现、提交、推送、部署、真实联调分别报告。发布按 [发布与恢复](DEPLOYMENT.md) 执行。 5. 本地实现、提交、推送、部署、真实联调分别报告。发布按 [发布与恢复](DEPLOYMENT.md) 执行。
6. 完成后同步本目录说明与 [验收状态](STATUS.md)。记录事实、证据、限制与下一步，不存密钥或用户原始邮件。 6. 完成后同步本目录说明与 [验收状态](STATUS.md)。记录事实、证据、限制与下一步，不存密钥或用户原始邮件。