docs: 文档治理2026-08-11——归档7份过时文档+57份研究过程文档，重写README，新增doc-audit核实报告

deploy/profile-scripts/mofin_db.py

@@ -2367,11 +2367,16 @@ def read_mtf_cache(conn, code: str) -> dict:
 
 
 def write_capital_flow_cache(conn, data: dict):
-    """写入资金流缓存（替代 capital_flow_cache.json）"""
+    """写入资金流缓存（替代 capital_flow_cache.json）
+
+    2026-08-11 修复: 原 DELETE 全表 + INSERT 在大库(mofin.db 6GB)上
+    持写锁过久，导致并发 cron (candidate_filter 等) database is locked。
+    改为固定 id=1 单行 upsert，锁持有时间从秒级降至毫秒级。
+    """
     import json
-    conn.execute("DELETE FROM capital_flow_cache")
     conn.execute(
-        "INSERT INTO capital_flow_cache (cache_json, updated_at) VALUES (?,datetime('now','localtime'))",
+        "INSERT INTO capital_flow_cache (id, cache_json, updated_at) VALUES (1,?,datetime('now','localtime')) "
+        "ON CONFLICT(id) DO UPDATE SET cache_json=excluded.cache_json, updated_at=excluded.updated_at",
         (json.dumps(data, ensure_ascii=False),)
     )