zhizhijie
9 天以前 4792a6c11fd390ce36f71106f7f332ab6226489a
AGENTS.md
@@ -32,4 +32,22 @@
## 验证注意
- 沙箱内 `Get-NetTCPConnection` 会因权限“拒绝访问”而静默失败,**不要**据此判定端口未监听;判断服务状态以 backend.log / frontend.log 为准。
- 用户要求:临时脚本/文件未经同意不删;导入失败要在页面显示行号;AI 分析结果要给结构化排版 + 逐字输出动画。
- 用户要求:临时脚本/文件未经同意不删;导入失败要在页面显示行号;AI 分析结果要给结构化排版 + 逐字输出动画。
## 工作规范(2026-09-02 起,必须遵守)
1. **每做完一个功能,立即测试并写《功能测试报告》**
   - 测试至少覆盖:正向用例(正常数据)、负向用例(错类型/错列位/缺列等)、入库抽查(与源文件逐项对齐)。
   - 报告写入 `docs/功能测试报告/`,命名:`功能测试报告_<功能名>_<YYYY-MM-DD>.md`。
   - 报告须包含:功能说明、测试环境、用例表(输入/预期/实际/结论)、发现的问题与处置、结论。
2. **每天下班前写《工作日结》,命名附日期**
   - 写入 `docs/工作日结/`,命名:`工作日结_<YYYY-MM-DD>.md`。
   - 内容至少包含:今天做了什么(功能/修复)、测试结果摘要、遗留问题与待办、明天计划。
   - 当天没有代码/测试工作时,也要写(一句话说明“今日无代码改动”即可)。
3. **git 工作流(2026-09-03 用户授权,无需再询问是否推送)**
   - 每次修改代码/文档后:先测试并写《功能测试报告》/更新《工作日结》,再 `git fetch origin` 与远端 `main` 对比合并(必要时解决冲突),确认无误后 commit 并 push 到公司 gitea(`http://61.183.254.94:3000/r/trafficAudit.git`,账号 zyj)。
   - 若远端已有同事新提交:必须先合并/基于最新再推,禁止强推覆盖同事代码。
   - 公司 git 账号密码只通过本机 git 凭据/临时 askpass 使用,禁止写进仓库内任何文档或提交内容。
4. **git 单仓库约定(2026-09-21 用户确认,替代 2026-09-07 的双仓库约定)**
   - 本机只使用公司 gitea:`origin` = `http://61.183.254.94:3000/r/trafficAudit.git`(账号 zyj)。个人 gitee 仓库已不再使用,不要再把它当作 origin 或额外拉取源。
   - 拉取/推送一律走 `origin`(远端分支 `main`):先拉合并,禁强推,再 commit/push。