diff --git a/.gitignore b/.gitignore index dfb231b..2a3e47c 100755 --- a/.gitignore +++ b/.gitignore @@ -40,14 +40,7 @@ compose.split.yaml # Separate frontend repository (commit it independently) /stellar/ # Local reports, backups, screenshots and private operational records -/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 +/codex/output/ /deliverables/ # Local native-client build products /macos-client/build/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..725217c --- /dev/null +++ b/AGENTS.md @@ -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 不代表界面可用。测试、提交、发布和真实验收分别报告,未执行的步骤不能写成完成。 + +本文件提供维护入口,不扩大当前任务授权,也不启动无人值守自动维护。 diff --git a/README.md b/README.md index 0199ecc..d41526f 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ +## dpl 项目维护 + +AI 接手入口见 [AGENTS.md](AGENTS.md),维护说明见 [docs/maintenance](docs/maintenance/README.md)。任务日志与截图仍保存在不纳入 Git 的 codex/output/。 + +--- + # Xboard
diff --git a/codex/output/maintenance/ARCHITECTURE.md b/docs/maintenance/ARCHITECTURE.md similarity index 100% rename from codex/output/maintenance/ARCHITECTURE.md rename to docs/maintenance/ARCHITECTURE.md diff --git a/codex/output/maintenance/BUSINESS_RULES.md b/docs/maintenance/BUSINESS_RULES.md similarity index 100% rename from codex/output/maintenance/BUSINESS_RULES.md rename to docs/maintenance/BUSINESS_RULES.md diff --git a/codex/output/maintenance/DEPLOYMENT.md b/docs/maintenance/DEPLOYMENT.md similarity index 100% rename from codex/output/maintenance/DEPLOYMENT.md rename to docs/maintenance/DEPLOYMENT.md diff --git a/codex/output/maintenance/README.md b/docs/maintenance/README.md similarity index 76% rename from codex/output/maintenance/README.md rename to docs/maintenance/README.md index dff9054..d3de393 100644 --- a/codex/output/maintenance/README.md +++ b/docs/maintenance/README.md @@ -4,7 +4,7 @@ ## 接手顺序 -1. 阅读全局 AGENTS.md、当前用户要求和本目录说明。用户最新明确边界优先,不扩大本次授权。 +1. 阅读全局及项目根目录 AGENTS.md、当前用户要求和本目录说明。用户最新明确边界优先,不扩大本次授权。 2. 确认所在仓库、分支、工作区差异与远端;分别识别用户既有修改、本次任务与其他聊天修改。不要覆盖、清理或混入其他任务。 3. 按 [架构与配置](ARCHITECTURE.md) 沿实际调用链检查问题;按 [业务约束](BUSINESS_RULES.md) 判断影响。 4. 修改后运行与影响范围相关的检查;后台界面必须浏览器验收,包括页面显示、保存、切换、权限。HTTP 200 不代表前端可用。 @@ -22,4 +22,4 @@ 这些说明用于辅助 AI 接手,不代表 AI 会在聊天结束后自动持续运行。应用定时任务在服务器执行,AI 维护任务需要会话或明确配置的自动化来启动。 -所有维护输出放在项目 codex/output/。本目录五份维护文档允许纳入 Git;其他运行日志、截图、备份、临时脚本仍默认忽略。凭据与私密配置始终不提交。 +正式维护文档放在 docs/maintenance/,纳入 Git 并随相关代码一起更新。项目根目录 AGENTS.md 是 AI 自动接手入口;运行日志、截图、临时脚本与任务产物放在 codex/output/,继续默认忽略。受保护备份和私密配置按运行环境保存,不提交 Git。 diff --git a/codex/output/maintenance/STATUS.md b/docs/maintenance/STATUS.md similarity index 78% rename from codex/output/maintenance/STATUS.md rename to docs/maintenance/STATUS.md index 121f116..51139fa 100644 --- a/codex/output/maintenance/STATUS.md +++ b/docs/maintenance/STATUS.md @@ -1,6 +1,6 @@ # 接手验收状态 -文档核对日期:2026-10-11。以下为当前会话已验证的事实,不承诺服务器一直保持此状态。 +文档核对日期:2026-10-11。以下区分本会话检查结果与用户验收确认,不承诺服务器一直保持此状态。 ## 最新代码基线 @@ -14,7 +14,7 @@ Resend 发信、常规 SMTP、配额回退、投递事件回调、master 一次性汇报都曾实测。来信保存、每日一次自动回复曾在本地实测并收到回复。生产 IMAP 连接与增量检查已验证。 -尚未在本轮复核的项目:生产新来信触发的完整自动回复链、首次/最新 08:00 定时汇报是否实际送达。这不是实现缺失,但不能按既有单次发送测试宣称定时运行已验收。若后续任务要求继续验收,先检查已处理记录避免重复回复/汇报。 +用户于 2026-10-11 明确确认“日报送达和自动回复验收 ok”。据此,日报实际送达与自动回复已通过用户验收,不再列为待验收项。本次仅登记该确认,未重新发送邮件、触发日报或读取服务器记录。后续发生异常或变更相关逻辑时重新核验,并检查已处理记录避免重复回复/汇报。 ## 接手注意