dpl/docs/maintenance/README.md
hellcat 1de59971f6
Some checks are pending
Docker Build and Publish / build (push) Waiting to run
docs: record three-node Japan batch acceptance and recovery
2026-10-17 09:11:53 +08:00

2.9 KiB
Raw Blame History

dpl:AI 维护入口

核对日期:2026-10-11。文档随代码版本维护;运行状态必须现场复核,不能把历史验收当成当前状态。

接手顺序

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

文档导航

文件 用途
ARCHITECTURE.md 服务入口、前后端边界、配置来源、开发与检查
BUSINESS_RULES.md 邮件、提醒、账号与支付等不可随意改变的约束
DEPLOYMENT.md Git 发布、备份、运行依赖、恢复及故障排查
TELEGRAM_TICKETS.md Telegram 工单接入、绑定、权限及故障处理
STATUS.md 最近验证基线、已知限制与待验收项目
CLOUD_FLARE_AUDIT.md 两机场 Cloudflare 审查、已部署调优、域名轮换与回退及可选未实施项
NODE_ONBOARDING.md 五节点链路、命名规则、共享资源与验收
NODE_RUNBOOK.md initialize/append参数、脚本入口、前检/证书/验收与面板回退;隔离测试/运维版本与现场边界,含验证清单
NODE_BATCH.md 批量接入默认一个子助手的分工与关卡;append并发锁/查重/断点恢复、命令协议与测试边界
GATEWAY_ADMIN_PROXY.md 两网关管理域名、白色机新旧区域反代、独立证书续期、恢复和验收边界

这些说明用于辅助 AI 接手,不代表 AI 会在聊天结束后自动持续运行。应用定时任务在服务器执行,AI 维护任务需要会话或明确配置的自动化来启动。

正式维护文档放在 docs/maintenance/,纳入 Git 并随相关代码一起更新。项目根目录 AGENTS.md 是 AI 自动接手入口;运行日志、截图、临时脚本与任务产物放在 codex/output/,继续默认忽略。受保护备份和私密配置按运行环境保存,不提交 Git。

本机共享 wwwroot 权限已于 2026-10-13 收紧;策略、服务身份、限制和恢复入口见 CoDocs 本地目录权限。仅本机适用,未变更本项目业务或生产权限。