From 0231be63388b87a72f402f08a04e70dfdda462f5 Mon Sep 17 00:00:00 2001
From: meijiali <你的邮箱@xxx.com>
Date: Fri, 3 Jul 2026 11:11:26 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=E5=8D=95=E4=BA=BA?=
 =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E6=8F=90=E4=BA=A4=E8=A7=84=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .DS_Store      | Bin 6148 -> 0 bytes
 .gitignore     |  10 +++++++++
 AGENTS.md      |  59 +++++++++++++++++++++++++++++++++++++++++++++++++
 docs/.DS_Store | Bin 6148 -> 0 bytes
 4 files changed, 69 insertions(+)
 delete mode 100644 .DS_Store
 create mode 100644 .gitignore
 delete mode 100644 docs/.DS_Store

diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index b1bc858e925d93fb375ed4bdb59c7154b9b72c92..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeH~F>b>!3`IX%4*|M(?5HIN=naG*JwYxI#2y292)gU&`J}kS%^VoPCqO=tGGY4<
zmI=TPfAbG80@%@=*n3!+F&{8v!Gzm<o358-xq6ZI(E(5CBUbylEl2?=AO)m=6p#WN
zQXr4<-PeYmNsl50q`)>5@b5#RJ8QCa#;1cJMgVePIgIO=CCK6hvL;(6D>TdL!Lrq2
z4DoujlO?aK$=2E1VL5zQ-r0PLp;>Q-6(%&R0R<@_1y%}t_I&j7|Cj!3{$I5yl>$=W
z%@nZVcsd^VQhB!idp)n8v+C<cC*yL4ho1l@eiVPx!?<63LDppJWQC?5fsjE#3cOT-
EJEBw)t^fc4

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..fbe6252
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,10 @@
+.venv/
+__pycache__/
+*.py[cod]
+.DS_Store
+.pytest_cache/
+.coverage
+htmlcov/
+.env
+data/*.db
+data/*.db-*
diff --git a/AGENTS.md b/AGENTS.md
index 91bac29..24476e9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -113,6 +113,22 @@ For each task:
 
 Keep changes scoped. Avoid unrelated refactors. If a file or design issue blocks the requested work, propose the smallest corrective change that serves the current goal.
 
+### Project Memory And Conversation Learnings
+
+After any valuable conversation iteration, agents should consider whether the
+learning should be preserved in this `AGENTS.md` file so future agents understand
+the project better. Examples include successfully resolving a recurring problem,
+confirming an ambiguous project convention, discovering a reliable workflow, or
+clarifying how agents should coordinate work in this repository.
+
+Do not silently add uncertain or speculative rules. If the learning is ambiguous,
+could change product behavior, or might conflict with the source documents, ask the
+user for confirmation before updating `AGENTS.md`.
+
+Keep additions concise and operational. `AGENTS.md` should capture durable agent
+working rules, not replace product requirements, implementation specs, or detailed
+task plans that belong in `docs/`.
+
 ### Error Handling Philosophy
 
 These principles are defined in `docs/DevelopmentPlan.md` §10 and `docs/TDD.md` §13.
@@ -217,6 +233,49 @@ For UI work, verify rendered pages manually or with browser automation when prac
 
 Use small, focused commits. One commit should represent one clear change.
 
+### Solo Commit Discipline
+
+For this solo project, after completing each independent feature/task, run the
+relevant tests and create one focused git commit for the files related to that
+task. Do not push unless the user explicitly asks. Do not commit unrelated
+files.
+
+An "independent feature/task" means the smallest useful change that can be
+understood, tested, and reverted on its own. Examples:
+
+- One `docs/Tasks.md` task such as T07 API retry, T20 export, or T22 Docker.
+- One narrow bug fix, such as fixing 401 error display or CSV newline handling.
+- One cohesive page or route improvement, such as adding the task detail page.
+- One test-only change that documents or locks down one behavior.
+
+Do not mix unrelated changes in one commit. For example, do not combine Docker
+deployment, UI redesign, AI retry logic, and documentation edits unless they are
+strictly required to complete one same task.
+
+Commit messages for this project must be written in Chinese while keeping the
+standard prefix. Examples:
+
+- `feat: 接入真实 AI 评论分析`
+- `fix: 修复评论分页停止条件`
+- `test: 补充导出 CSV 注入防护测试`
+- `docs: 记录单人项目提交规则`
+
+### Current Solo Execution Mode
+
+The current project phase is initial solo development and process practice. Unless
+the user explicitly enables parallel work or PR workflow, execute tasks
+sequentially: one task at a time, in dependency order.
+
+For this phase, use one task branch per `docs/Tasks.md` task, named
+`feat/tXX-short-description` (for example, `feat/t01-project-skeleton`). After the
+task passes its required checks, create one focused commit for that task when
+practical. Large tasks may be split into multiple meaningful commits only when a
+single commit would be hard to review or safely revert.
+
+Do not start the next task until the previous task has been reviewed, verified,
+and either merged into the working baseline or explicitly approved as the base for
+the next branch. Do not open a PR unless the user asks for one.
+
 Recommended commit prefixes:
 
 - `docs:` documentation changes
diff --git a/docs/.DS_Store b/docs/.DS_Store
deleted file mode 100644
index 5008ddfcf53c02e82d7eee2e57c38e5672ef89f6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeH~Jr2S!425mzP>H1@V-^m;4Wg<&0T*E43hX&L&p$$qDprKhvt+--jT7}7np#A3
zem<@ulZcFPQ@L2!n>{z**<q8>++&mCkOWA81W14cNZ<zv;LbK1Poaz?KmsK2CSc!(
z0ynLxE!0092;Krf2c+FF_Fe*7ECH>lEfg7;MkzE(HCqgga^y>{tEnwC%0;vJ&^%eQ
zLs35+`xjp>T0<F0fCPF1$Cyrb|F7^5{eNG?83~ZUUlGt@xh*qZDeu<Z%US-OSsOPv
j)R!Z4KLME7ReXlK;d!wEw5GODWMKRea10D2@KpjYNUI8I