dpl/docs/maintenance/README.md

2.2 KiB
Raw Blame History

dpl:AI 维护入口

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

接手顺序

  1. 阅读全局及项目根目录 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 共享资源隔离、订阅网关与新增节点流程及待验收状态

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

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