From 3063995c6bb6bf74e2d9de6883f67d5584271824 Mon Sep 17 00:00:00 2001
From: xyc <jc_xiong@hotmail.com>
Date: 星期五, 28 八月 2026 15:36:14 +0800
Subject: [PATCH] feat: 开启 Tomcat 访问日志（basedir 固定 jar 同级，记录静态资源与 API 请求耗时），便于定位客户端崩溃卡点
---
HANDOFF.md | 22 ++++++++++++++++++++++
1 files changed, 22 insertions(+), 0 deletions(-)
diff --git a/HANDOFF.md b/HANDOFF.md
index 6434f60..0f9f415 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -3,6 +3,27 @@
> **鐢ㄦ硶**锛氭柊瀵硅瘽寮�濮嬪悗锛屽厛璇绘湰鏂囦欢 + 椤圭洰鏍圭洰褰� `AGENTS.md`锛屽嵆鍙棤缂濇帴鍔涖��
> **姣忓ぉ缁撴潫鏃�**锛氭妸褰撳ぉ杩涘睍銆佽俯杩囩殑鍧戙�佹柊闇�姹傘�佹湭瀹屾垚浜嬮」鏇存柊鍒版湰鏂囦欢锛岀劧鍚庡彲浠ユ斁蹇冨紑鏂板璇濄��
+## 浠婃棩锛�2026-08-28锛�
+
+### 1. 鐧诲綍楠岃瘉鐮侊細娴嬭瘯闃舵鍙烦杩囷紙宸插畬鎴愬苟楠岃瘉锛�
+- 鍚庣鏂板 `app.captcha.required` 寮�鍏筹紙缂虹渷 `true`=鍚敤锛夛紱鏈満 application.yml 涓� example 鐜颁负 `false`锛堟祴璇曢樁娈佃烦杩囷紝**姝ｅ紡鍙戝竷鍓嶆敼鍥� `true`**锛夈��
+- LoginController锛歚captchaRequired=false` 鏃剁櫥褰曚笉鏍￠獙楠岃瘉鐮侊紱鏂板鍏紑鎺ュ彛 `GET /api/auth/captcha-config` 杩斿洖 `{required}`銆�
+- Login.vue锛氬惎鍔ㄦ椂鎷夊彇璇ラ厤缃紱`required=false` 鏃堕殣钘忛獙璇佺爜鍖哄煙骞舵樉绀恒�屾祴璇曟ā寮忥細琛屼负楠岃瘉鐮佸凡璺宠繃銆嶆彁绀猴紝鐧诲綍璺宠繃楠岃瘉锛涢厤缃姹傚け璐ユ椂榛樿鎸夊惎鐢ㄥ鐞嗭紙瀹夊叏鍏滃簳锛夈��
+- 宸插疄娴嬶細captcha-config 杩斿洖 required=false锛沘dmin/admin123 涓嶅甫楠岃瘉鐮佺洿鎺ョ櫥褰� 200锛涘悗绔� mvn compile 鉁呫�佸墠绔� npm run build 鉁呫��
+- 鈿狅笍 闇�閲嶆柊鎵撳寘鎵嶅湪娴嬭瘯鐜鐢熸晥锛涙寮忓彂甯冩椂鎶� `app.captcha.required` 鏀瑰洖 `true`銆�
+
+### 2. 鏁版嵁瀵煎叆娴忚鍣ㄥ穿婧冩帓鏌ワ紙杩涜涓紝鐢ㄦ埛绾跨储鏇存柊锛�
+- 鐢ㄦ埛琛ュ厖锛氬叡 3 鍙版満鍣ㄥ嚭鐜帮紙瀵规柟寮�鍙戞満 + 鏄ㄥぉ鎵撳寘娴嬭瘯 1 鍙� + 浠婂ぉ 1 鍙帮級锛涘鏂硅褰曠殑銆岃繀闆�/椹卞姩銆嶆槸鍏朵富瑙傚垽鏂紱鐜拌薄鏃跺ソ鏃跺潖銆佹瘡鍙扮害 1/3 鐢ㄦ埛宕┿��
+- 宸叉帓闄わ細/import/batches锛坙imit鈮�200銆�81 鏉＄害 17KB锛夛紱杩涘叆椤甸潰鏃犺疆璇�/瀹氭椂鍣ㄣ��
+- 鐢ㄦ埛鎬�鐤戙�岀洰褰曞鍏ワ紙娴忚/鎵弿鐩綍锛夈�嶁啋 宸插姞鍥猴紙瑙佷笅锛夈�傛敞鎰忥細璇ュ姛鑳介渶鐢ㄦ埛涓诲姩鎵撳紑鐩綍娴忚/鐐圭洰褰曞鍏ユ墠瑙﹀彂锛屼笌銆岀偣鏁版嵁瀵煎叆鑿滃崟灏卞穿銆嶇幇璞′笉瀹屽叏鍚诲悎锛�**寰呯敤鎴风‘璁ゅ穿婧冩椂鐐圭殑鍏蜂綋鎸夐挳**銆�
+- 鍔犲浐锛堝凡瀹屾垚锛岀紪璇�/鏋勫缓閫氳繃锛夛細鍚庣 `listDirs` 瀛愮洰褰�/鏂囦欢鍒楄〃鍚勯檺 300锛堟柊澧� `dirsTruncated`/`filesTruncated` 鏍囪锛宍excelCount` 浠嶄负鐪熷疄鎬绘暟锛夛紱鍓嶇銆屼粠鐩綍鎵归噺瀵煎叆銆嶆瘡鎵归檺 60 涓枃浠讹紙瓒呴檺鎻愮ず鍒嗘壒锛夛紱鐩綍娴忚寮圭獥鏄剧ず鎴柇鎻愮ず銆�
+- 寰呭姙锛氳宕╂簝鏈哄櫒鐢ㄦ埛鍦� Chrome 寮� `chrome://crashes` 璁颁笅鍘熷洜鐮侊紙OOM / GPU / STATUS_ACCESS_VIOLATION 绛夛級锛屽苟纭宕╂簝鏃剁偣鐨勬槸渚ц竟鏍忋�屾暟鎹鍏ャ�嶈彍鍗曡繕鏄〉闈笂鏌愪釜鎸夐挳锛涙嵁姝ゅ喅瀹氫笅涓�姝ャ��
+
+### 3. 寰呭姙涓嶅彉
+- `docs/鎵撳寘閮ㄧ讲璇存槑.docx` 绗叚鑺傘�屽缃� application.yml 闇�鍖呭惈瀹屾暣閰嶇疆銆嶆敼涓恒�屽睘鎬х骇鍚堝苟銆嶅悗閲嶆柊瀵煎嚭 docx锛堟湭鍋氾級銆�
+- 宕╂簝鏍瑰洜纭鍚庯細淇 commit `cf57c2b` 涓�屾寚鍚戝鎴风鐜銆嶇殑鏃х粨璁恒��
+
+
## 銆囥�佸叧鏈轰氦鎺ワ紙2026-08-27 娣卞锛岀敤鎴峰叧鏈哄墠锛�
- **褰撳墠杩愯鐘舵��**锛氬墠鍚庣搴旂敤鏈嶅姟鍏ㄩ儴宸插仠姝紙寮�鍙戞湇鍔°�佹墦鍖呯増鍧囨湭杩愯锛夛紱浠呮暟鎹簱鍦ㄨ窇
锛圡ySQL80 鏈嶅姟=3305锛屾湰椤圭洰鐢紱MySQL57=3306 鍕垮姩锛夛紱8080 涓� IIS 绔欑偣浠嶅湪浣嗘湰椤圭洰宸蹭笉鍐嶄緷璧� IIS銆�
@@ -87,6 +108,7 @@
- 鍚庣画鎵╁睍锛欻203-1 鍏矾鏃呭銆乄203 姘磋矾銆丳203 娓彛銆丠204 鑳芥簮绛夛紙闇�姹傛枃妗� v2/v3 璁″垝锛夛紝鍏堟妸 H203-2 婕旂ず鍋氬ソ銆�
- 銆愭柊闇�姹偮蜂粎璁板綍鏈疄鐜奥�2026-08-23銆戠櫥褰曞悗棣栭〉鏂板銆屽叏鐪佷氦閫氳繍杈撴�佸娍鎰熺煡鍥俱�嶏細鎶婅揣杩愩�佸杩愩�佸贰娓稿嚭绉熴�佺綉绾﹁溅銆佹姇璧勩�佽兘鑰楃瓑鏂归潰鐨勫彉鍖栨�佸娍鍙鍖栧睍绀恒��
- 銆愭柊闇�姹偮蜂粎璁板綍鏈疄鐜奥�2026-08-23銆戞墿灞曠幇鏈� AI 鍒嗘瀽涓恒�孉I 鍔╂墜銆嶏細浠ユ湰鍦版暟鎹簱鏁版嵁涓哄熀纭�寤虹珛鐭ヨ瘑搴擄紝鍋� RAG锛屾敮鎸佽嚜鐒惰瑷�鎻愰棶/鑱婂ぉ锛岀伒娲绘煡鐪嬩笌鎸栨帢鏁版嵁銆�
+- **2026-08-28 澶嶆牳銆岀偣鏁版嵁瀵煎叆娴忚鍣ㄥ穿婧冦�嶏紙鎵撳寘娴嬭瘯鐜锛岄儴鍒嗙敤鎴凤級**锛氶噸鐐规帓鏌� `GET /api/import/batches`鈥斺�斿悗绔� limit 涓婇檺 200锛涘叏琛� 81 鏉°�乪rror_detail 鏈�闀� 2.6KB銆佸叏閲忓搷搴旂害 17KB锛堝墠绔彧鍙� 50 鏉★級锛涘墠绔〃鏍间粎 8 鍒楃煭瀛楁锛坋rrorDetail 涓嶆覆鏌擄級銆佹棤杞/瀹氭椂鍣ㄣ��**缁撹锛氭帴鍙ｄ笉鏄穿婧冩牴鍥�**锛堣嫢鎺ュ彛鏈夐棶棰橈紝鎵�鏈夌敤鎴烽兘浼氬穿锛岃�岄潪"閮ㄥ垎鐢ㄦ埛"锛夈�傜幇璞＄鍚堝鎴风鐜宸紓锛堢涓夋柟鎵╁睍娉ㄥ叆/鏃ф樉鍗￠┍鍔�/浣庨厤鍐呭瓨锛屼笌 08-27 杩呴浄鎵╁睍+Intel 鏃ч┍鍔ㄧ粨璁轰竴鑷达級銆傚缓璁宕╂簝鐢ㄦ埛渚濇楠岃瘉锛氭棤鐥曟ā寮忊啋鎹� Edge鈫掔鎵╁睍锛屽苟鐪� chrome://crashes銆�
- 銆愭柊闇�姹偮蜂粎璁板綍鏈疄鐜奥�2026-08-28銆戝鍔�**缁忔祹鎸囨爣璇曠畻鍔熻兘**锛氶瀵奸潪甯稿叧娉ㄧ粡娴庢寚鏍囷紝**璐ц繍鏄ぇ澶�**锛涘父椹荤幇鍦虹殑鎵�鏈変汉閮借浼氳绠楄揣杩愮浉鍏虫暟鎹紙璐ц繍閲�/鍛ㄨ浆閲忕瓑锛夈�傞瀵肩粡甯歌姹傛妸鏌愪釜鏁版嵁銆屽帇涓�鍘嬨�嶏紝浠婂悗鑰冭檻鍦ㄨ蒋浠堕噷澧炲姞璇曠畻鍔熻兘鈥斺�斿彲鎸夐渶瑕佽皟鏁�/娴嬬畻鎸囨爣鏁板�硷紙濡傛ā鎷熶笅璋冩煇浼佷笟/鏌愬彛寰勭殑璐ц繍閲忓悗鐪嬫眹鎬讳笌瓒嬪娍褰卞搷锛夛紝杈呭姪鐜板満浜哄憳蹇�熻瘯绠椾笌搴斿銆�
## 鍏�佹瘡鏃ヤ氦鎺ョ害瀹�
--
Gitblit v1.9.1