docs: move maintenance guides to docs and add project agent entry
This commit is contained in:
parent
430ddbe9b6
commit
30645f96d5
9
.gitignore
vendored
9
.gitignore
vendored
@ -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
13
AGENTS.md
Normal 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 不代表界面可用。测试、提交、发布和真实验收分别报告,未执行的步骤不能写成完成。
|
||||||
|
|
||||||
|
本文件提供维护入口,不扩大当前任务授权,也不启动无人值守自动维护。
|
||||||
@ -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">
|
||||||
|
|||||||
@ -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。
|
||||||
@ -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”。据此,日报实际送达与自动回复已通过用户验收,不再列为待验收项。本次仅登记该确认,未重新发送邮件、触发日报或读取服务器记录。后续发生异常或变更相关逻辑时重新核验,并检查已处理记录避免重复回复/汇报。
|
||||||
|
|
||||||
## 接手注意
|
## 接手注意
|
||||||
|
|
||||||
Loading…
Reference in New Issue
Block a user