docs: move maintenance guides to docs and add project agent entry

This commit is contained in:
hellcat 2026-10-11 10:34:09 +08:00
parent 430ddbe9b6
commit 30645f96d5
8 changed files with 24 additions and 12 deletions

9
.gitignore vendored
View File

@ -40,14 +40,7 @@ compose.split.yaml
# Separate frontend repository (commit it independently) # Separate frontend repository (commit it independently)
/stellar/ /stellar/
# Local reports, backups, screenshots and private operational records # Local reports, backups, screenshots and private operational records
/codex/output/* /codex/output/
!/codex/output/maintenance/
/codex/output/maintenance/*
!/codex/output/maintenance/README.md
!/codex/output/maintenance/ARCHITECTURE.md
!/codex/output/maintenance/BUSINESS_RULES.md
!/codex/output/maintenance/DEPLOYMENT.md
!/codex/output/maintenance/STATUS.md
/deliverables/ /deliverables/
# Local native-client build products # Local native-client build products
/macos-client/build/ /macos-client/build/

13
AGENTS.md Normal file
View File

@ -0,0 +1,13 @@
# dpl 项目维护
开始维护前阅读 [维护入口](docs/maintenance/README.md),再按任务范围阅读架构、业务约束、发布恢复与验收状态。用户最新明确要求优先;文档中的历史状态必须按当前代码和运行环境复核。
- 保留用户及其他任务既有修改,提交只包含本次范围;不要重置或清理无关文件。
- 默认 Git 发布:提交、推送,再让服务器更新到明确版本并验证;未经明确要求不得打包覆盖。
- 前台 stellar/ 是独立仓库;后台资源是锁定版本的 Git 子模块,不能混入后端提交或直接改第三方构建产物。
- 修改功能时同步相应维护说明与验收状态。原有业务约束见 docs/maintenance/BUSINESS_RULES.md。
- 文档放 docs/maintenance/;任务截图、日志与临时脚本放 codex/output/;密钥和私密配置不提交 Git。
- 本地开发优先 dev/热更新;构建用于发布或构建验证。相关检查与命令见 docs/maintenance/ARCHITECTURE.md。
- 后台变更实际验证显示、切换、保存与权限;HTTP 200 不代表界面可用。测试、提交、发布和真实验收分别报告,未执行的步骤不能写成完成。
本文件提供维护入口,不扩大当前任务授权,也不启动无人值守自动维护。

View File

@ -1,3 +1,9 @@
## dpl 项目维护
AI 接手入口见 [AGENTS.md](AGENTS.md),维护说明见 [docs/maintenance](docs/maintenance/README.md)。任务日志与截图仍保存在不纳入 Git 的 codex/output/。
---
# Xboard # Xboard
<div align="center"> <div align="center">

View File

@ -4,7 +4,7 @@
## 接手顺序 ## 接手顺序
1. 阅读全局 AGENTS.md、当前用户要求和本目录说明。用户最新明确边界优先,不扩大本次授权。 1. 阅读全局及项目根目录 AGENTS.md、当前用户要求和本目录说明。用户最新明确边界优先,不扩大本次授权。
2. 确认所在仓库、分支、工作区差异与远端;分别识别用户既有修改、本次任务与其他聊天修改。不要覆盖、清理或混入其他任务。 2. 确认所在仓库、分支、工作区差异与远端;分别识别用户既有修改、本次任务与其他聊天修改。不要覆盖、清理或混入其他任务。
3. 按 [架构与配置](ARCHITECTURE.md) 沿实际调用链检查问题;按 [业务约束](BUSINESS_RULES.md) 判断影响。 3. 按 [架构与配置](ARCHITECTURE.md) 沿实际调用链检查问题;按 [业务约束](BUSINESS_RULES.md) 判断影响。
4. 修改后运行与影响范围相关的检查;后台界面必须浏览器验收,包括页面显示、保存、切换、权限。HTTP 200 不代表前端可用。 4. 修改后运行与影响范围相关的检查;后台界面必须浏览器验收,包括页面显示、保存、切换、权限。HTTP 200 不代表前端可用。
@ -22,4 +22,4 @@
这些说明用于辅助 AI 接手,不代表 AI 会在聊天结束后自动持续运行。应用定时任务在服务器执行,AI 维护任务需要会话或明确配置的自动化来启动。 这些说明用于辅助 AI 接手,不代表 AI 会在聊天结束后自动持续运行。应用定时任务在服务器执行,AI 维护任务需要会话或明确配置的自动化来启动。
所有维护输出放在项目 codex/output/。本目录五份维护文档允许纳入 Git;其他运行日志、截图、备份、临时脚本仍默认忽略。凭据与私密配置始终不提交。 正式维护文档放在 docs/maintenance/,纳入 Git 并随相关代码一起更新。项目根目录 AGENTS.md 是 AI 自动接手入口;运行日志、截图、临时脚本与任务产物放在 codex/output/,继续默认忽略。受保护备份和私密配置按运行环境保存,不提交 Git。

View File

@ -1,6 +1,6 @@
# 接手验收状态 # 接手验收状态
文档核对日期:2026-10-11。以下为当前会话已验证的事实,不承诺服务器一直保持此状态。 文档核对日期:2026-10-11。以下区分本会话检查结果与用户验收确认,不承诺服务器一直保持此状态。
## 最新代码基线 ## 最新代码基线
@ -14,7 +14,7 @@
Resend 发信、常规 SMTP、配额回退、投递事件回调、master 一次性汇报都曾实测。来信保存、每日一次自动回复曾在本地实测并收到回复。生产 IMAP 连接与增量检查已验证。 Resend 发信、常规 SMTP、配额回退、投递事件回调、master 一次性汇报都曾实测。来信保存、每日一次自动回复曾在本地实测并收到回复。生产 IMAP 连接与增量检查已验证。
尚未在本轮复核的项目:生产新来信触发的完整自动回复链、首次/最新 08:00 定时汇报是否实际送达。这不是实现缺失,但不能按既有单次发送测试宣称定时运行已验收。若后续任务要求继续验收,先检查已处理记录避免重复回复/汇报。 用户于 2026-10-11 明确确认“日报送达和自动回复验收 ok”。据此,日报实际送达与自动回复已通过用户验收,不再列为待验收项。本次仅登记该确认,未重新发送邮件、触发日报或读取服务器记录。后续发生异常或变更相关逻辑时重新核验,并检查已处理记录避免重复回复/汇报。
## 接手注意 ## 接手注意