From 37496dcec47bc98dc545d94287f39b33eb181bca Mon Sep 17 00:00:00 2001
From: xyc <jc_xiong@hotmail.com>
Date: 星期五, 28 八月 2026 17:36:48 +0800
Subject: [PATCH] docs: 关机交接——菜单布局修复(2bd663b)与实测结论、/import 主线程卡死新发现、sessionStorage 强制登录待办

---
 HANDOFF.md |   21 +++++++++++++++++++--
 1 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/HANDOFF.md b/HANDOFF.md
index 1d4fbce..5dc3934 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -25,13 +25,30 @@
   - **鏈湴鎵撳寘褰㈡�佸帇娴嬶紙headless Chrome锛�20 杞彍鍗曞垏鎹級**锛氬鑸� 17~89ms銆�0 JS 閿欒銆丏OM 鎭� 949 鑺傜偣鏃犵疮绉�佸爢鍐呭瓨 11~37MB 鏃犳硠婕忋�佹渶闀块暱浠诲姟 80ms 鈫� 搴旂敤 JS 灞傛棤姝诲惊鐜�/澶ц绠�/娉勬紡銆�
   - **宸插姞 Tomcat 璁块棶鏃ュ織**锛坄server.tomcat.basedir: .` + accesslog锛宩ar 鍚岀骇 `logs/access.*.log`锛宲attern 鍚� `%D` 鑰楁椂锛岄潤鎬佽祫婧愪篃璁板綍锛夆�斺�旀湰鍦板疄娴� chunk 璇锋眰 3ms銆�**閲嶆柊鎵撳寘鍙戝竷鍚�**锛屼笅娆″穿婧冪湅 access log锛歝hunk 璇锋眰鏄惁鍒拌揪銆佽�楁椂澶氬皯 鈫� 鐩存帴瀹氫綅銆屾湇鍔″櫒鎱€�嶈繕鏄�屽鎴风娌″彂鍑鸿姹傘�嶃��
   - 寰呯敤鎴凤細閲嶆柊鎵撳寘鍙戝竷鍚庯紝宕╂簝鏃剁湅 鈶犳湇鍔″櫒 `logs/access.*.log` 鈶″鎴风 F12 Network 涓� `chunk-*.js` 璇锋眰鐘舵�侊紙pending/stalled/鑰楁椂锛夈��
-  - **鏍瑰洜瀹為敜锛堟湰鏈哄疄楠屽鐜帮級**锛歍omcat 9 NIO 涓嬫參杩炴帴涓嶅崰绾跨▼锛坰lowloris 鏃犳晥锛屽凡娴嬶級锛屼絾**鎱㈤�� multipart 涓婁紶浼氬崰绾跨▼**鈥斺��240 涓參涓婁紶鍗犳弧绾跨▼姹犲悗锛宑hunk 涓� batches 璇锋眰鍏ㄩ儴 pending/瓒呮椂锛堜笌鐢ㄦ埛鐜拌薄涓�鑷达級銆�**鏁版嵁瀵煎叆鏄悓姝ラ暱浠诲姟**锛�4 涓囪瀵煎叆鍗� 1 涓嚎绋� 5 鍒嗛挓锛屽墠绔秴鏃� 600s锛夛紝澶氱敤鎴峰悓鏃跺鍏�/鐩綍瀵煎叆涓茶 鈫� 200 绾跨▼鑰楀敖 鈫� 鏂拌姹傦紙batches銆侀潤鎬佹枃浠讹級鎺掗槦 pending 鈫� 娴忚鍣ㄧ瓑 鈫掋�屾棤鍝嶅簲銆嶅脊绐椼��**鍙穿鏁版嵁瀵煎叆椤�**鍥犱负瀹冭繘椤靛嵆鍙� 2 涓� batches 璇锋眰涓旂敤鎴峰鍦ㄥ鍏ュ満鏅搷浣滐紱鍏朵粬椤甸潰鍦ㄥ悓鏍锋椂鍒讳篃浼� pending 鍙槸鏈娉ㄦ剰銆�
+  - **鏈哄埗鍙鐜帮紙鏈満瀹為獙锛岄潪瀹為敜锛�**锛歍omcat 9 NIO 涓嬫參杩炴帴涓嶅崰绾跨▼锛坰lowloris 鏃犳晥锛屽凡娴嬶級锛屼絾**鎱㈤�� multipart 涓婁紶浼氬崰绾跨▼**鈥斺��240 涓參涓婁紶鍗犳弧绾跨▼姹犲悗锛宑hunk 涓� batches 璇锋眰鍏ㄩ儴 pending/瓒呮椂锛堜笌鐢ㄦ埛鐜拌薄涓�鑷达級銆�**鏁版嵁瀵煎叆鏄悓姝ラ暱浠诲姟**锛�4 涓囪瀵煎叆鍗� 1 涓嚎绋� 5 鍒嗛挓锛屽墠绔秴鏃� 600s锛夛紝澶氱敤鎴峰悓鏃跺鍏�/鐩綍瀵煎叆涓茶 鈫� 200 绾跨▼鑰楀敖 鈫� 鏂拌姹傦紙batches銆侀潤鎬佹枃浠讹級鎺掗槦 pending 鈫� 娴忚鍣ㄧ瓑 鈫掋�屾棤鍝嶅簲銆嶅脊绐椼��**鍙穿鏁版嵁瀵煎叆椤�**鍥犱负瀹冭繘椤靛嵆鍙� 2 涓� batches 璇锋眰涓旂敤鎴峰鍦ㄥ鍏ュ満鏅搷浣滐紱鍏朵粬椤甸潰鍦ㄥ悓鏍锋椂鍒讳篃浼� pending 鍙槸鏈娉ㄦ剰銆�
   - **淇锛坈ommit 728b372锛屽凡楠岃瘉锛�**锛氣憼 `server.tomcat.threads.max: 500`锛坅pplication.yml + example锛夛紱鈶� 鏁版嵁瀵煎叆椤� `loadBatches`+`loadOverview` 鍚堝苟涓� `loadData`锛堣繘椤�/鍒锋柊/瀵煎叆鍚庡彧鍙� 1 涓� limit=200 璇锋眰锛岃〃鏍煎彇鍓� 50锛屾瑙堝鐢ㄥ悓鎵规暟鎹級銆�**淇楠岃瘉**锛氬悓鏍� 240 鎱笂浼犲帇鍔涗笅锛宐atches 0.2s銆乧hunk 0.1s 姝ｅ父銆�
   - **閬楃暀锛堝缓璁笅涓�姝ユ牴娌伙級**锛氬鍏ュ紓姝ュ寲锛園Async 鐙珛绾跨▼姹犳墽琛屽鍏ャ�佸墠绔疆璇㈣繘搴︼級锛屽交搴曚笉鍗� Tomcat 璇锋眰绾跨▼锛涙垨 nginx 鎵樼闈欐�佽祫婧愩�傚鏂� dev 鏈哄崟鐢ㄦ埛涔� pending锛岄渶鐪嬪鏂瑰悗绔棩蹇楋紙鍙兘 DB 杩炴帴/閿侊紝鎴栧鏂瑰綋鏃跺湪璺戝鍏ワ級锛屼笌鏈慨澶嶄笉鍐茬獊銆�
+  - **鐢ㄦ埛鍙嶉┏锛�08-28 鏅氾級鈫� 绾跨▼姹犺�楀敖涓嶆槸褰撳墠鍦烘櫙瀹為敜鏍瑰洜**锛氬穿婧冩椂浠� 3 涓敤鎴凤紙1 浜哄凡鐧诲叆銆�1 浜烘湭鐧诲叆銆�1 浜虹櫥鍏ュ悗鍗冲嚭闂锛夛紝鏃堕棿涓婁笉鍙兘鍗犳弧 200 绾跨▼銆傜嚎绋嬫睜 500 + batches 鍚堝苟鐨勪慨澶嶄粛鏈夋晥锛堥檷浣庡悓绫婚闄╋級锛屼絾涓嶈瀵圭敤鎴峰绉版牴鍥犲凡瀹為敜銆傜湡姝ｅ緟鍙栬瘉锛氶噸鏂版墦鍖呭彂甯冨悗宕╂簝鏃剁湅 鈶犳湇鍔″櫒 `logs/access.*.log`锛坈hunk/batches 鏄惁鍒拌揪銆�%D 鑰楁椂锛夆憽瀵规柟 dev 鏈猴紙鍗曠敤鎴蜂篃 pending 鐨勫鐜版満锛夊悗绔棩蹇楋紙鏄惁 DB 杩炴帴/閿�/SQL 鍗′綇锛夈��
 
-### 3. 寰呭姙涓嶅彉
+### 3. 鍓嶇 API 鍏ㄥ眬瓒呮椂淇濇姢锛堝凡瀹屾垚骞舵帹閫� commit 41487b9锛�
+- 鑳屾櫙锛氱敤鎴疯姹傛墍鏈夊悜鍚庡彴鐨� API 璇锋眰閮藉姞瓒呮椂淇濇姢锛岃秴鏃朵紭闆呮彁绀猴紙缃戠粶/鏈嶅姟鍣ㄥ紓甯革級锛屼笉瑕佹棤闄� pending銆�
+- 瀹炵幇锛歚src/api/index.js` axios 瀹炰緥榛樿 `timeout: 15000`锛涘搷搴旀嫤鎴櫒閲� `ECONNABORTED` 鈫� 寮广�岃姹傝秴鏃讹細鏈嶅姟鍣ㄧ箒蹇欐垨鏃犲搷搴旓紝璇风◢鍚庨噸璇曘�嶃�佹棤 `response` 鈫� 寮广�岀綉缁滃紓甯革細鏃犳硶杩炴帴鏈嶅姟鍣ㄣ�嶏紝骞剁粰 error 鎵� `_toast` 鏍囪锛岄〉闈� catch 閲� `if (e && e._toast) return` 閬垮厤閲嶅寮癸紱401 璺崇櫥褰曢�昏緫涓嶅彉銆�
+- 闀胯�楁椂璇锋眰鏄惧紡瑕嗙洊锛氭枃浠朵笂浼� 600s/300s锛堝師鏈夛級銆乣/audit/execute` 120s銆乣/audit/review` `/audit/markAudited` `/explain/save` 60s銆乣/llm/chat` 120s銆佹姤琛ㄥ鍑� 120s銆佹姤琛ㄩ瑙�/灏辩华 60s銆侀獙璇佺爜鎺ュ彛 10s銆佺櫥褰� 15s銆�
+- 瑕嗙洊鏂囦欢 11 涓紙api/index.js銆丄iChatDialog銆丆aptcha3D銆丄uditResult銆丏ataImport銆丏ataView銆丒xplainReview銆丩ogin銆丷eportExport銆丷uleManage銆乁serManage锛夛紝node24 鏋勫缓閫氳繃锛屽凡鎻愪氦鎺ㄩ�併��
+
+### 4. 鑿滃崟/甯冨眬缁熶竴淇锛坈ommit 2bd663b锛屽凡鎺ㄩ�侊級
+- 鐢ㄦ埛鍙嶉 4 涓棶棰橈細鈶犵偣銆屽鏍哥粨鏋溿�嶈彍鍗曚笉楂樹寒锛涒憽浼佷笟瑙ｉ噴/鐢ㄦ埛绠＄悊椤堕儴娌℃湁缁熶竴妯爮锛涒憿鏌愪簺椤甸潰閫�鍑虹櫥褰曚笉鏄剧ず锛涒懀锛堟柊澧烇級涓嶇偣閫�鍑虹洿鎺ュ叧鏍囩椤�/娴忚鍣紝閲嶅紑鍚庤烦杩囩櫥褰曠洿鎺ヨ繘涓婚〉锛岃姹傞噸寮�鏃跺己鍒剁櫥褰曘��
+- 宸蹭慨澶嶏紙鈶♀憿锛夛細ExplainReview.vue 鏈夐噸澶� `components` 閿紙`{ AppHeader }` 琚悗闈㈢殑 `{ AiChatDialog }` 瑕嗙洊锛夆啋 app-header 鏈敞鍐屻�佷紒涓氳В閲婇〉椤堕儴妯爮涓㈠け锛涘凡鍚堝苟涓� `{ AppHeader, AiChatDialog }`銆俁uleManage.vue / UserManage.vue 杩樻槸鏃х増甯冨眬锛坄<el-container>` 鏃� direction銆乣<el-header>` 鏃犵敤鎴�/鐧诲嚭銆侀��鍑虹櫥褰曡棌鍦ㄨ彍鍗曢噷涓� RuleManage 鏍规湰娌℃湁 logout 鏂规硶锛夆啋 缁熶竴鏀逛负 `<app-header>` 涓婁笅甯冨眬銆佸垹鑿滃崟鍐呴��鍑洪」锛屼笌鍏朵綑 6 椤典竴鑷淬��
+- 宸插疄娴嬶紙puppeteer headless锛宎dmin/admin123 鐧诲綍鍚庨�愯矾鐢辫闂級锛�/explain /rules /users 鍧囨湁 app-header + 閫�鍑烘寜閽紱/audit 鐩存帴璁块棶鏃惰彍鍗曢珮浜�屽鏍哥粨鏋溿�嶆甯� 鈫� 闂鈶� 涓嶅湪 AuditResult 鑷韩銆�
+- **鏂板彂鐜帮紙閲嶈锛�**锛�/import锛堟暟鎹鍏ワ級椤甸潰鎸傝浇鍚� **JS 涓荤嚎绋嬪崱姝�**锛坧uppeteer evaluate 3s 瓒呮椂锛実oto 宸插埌 #/import 浣嗛〉闈㈣剼鏈暱鏃堕棿涓嶅搷搴旓級鈥斺�旀��鐤戣繖灏辨槸銆岀偣瀹℃牳缁撴灉涓嶉珮浜�嶅強姝ゅ墠銆屾暟鎹鍏ヨ彍鍗曚竴鐐瑰氨娴忚鍣ㄦ棤鍝嶅簲銆嶇殑鏍瑰洜鏂瑰悜锛堥〉闈� JS 闃诲 鈫� 鐐瑰嚮浜嬩欢/楂樹寒鏇存柊琚崱浣忥級銆備笅涓�姝ワ細profiling /import 椤� loadData锛坆atches 鍝嶅簲鍚� overview 鏋勯�� / 200 琛岃〃鏍兼覆鏌擄級鎵句富绾跨▼闀夸换鍔°��
+- 闂鈶� 鏈仛锛堜笅娆′紭鍏堬級锛氭妸璁よ瘉淇℃伅锛坱oken/username/realName/modules锛変粠 localStorage 鏀瑰瓨 **sessionStorage**锛堝叧鏍囩椤靛嵆娓呯┖ 鈫� 寮哄埗鐧诲綍锛夛紝娑夊強 Login.vue銆乺outer/index.js銆乤pi/index.js銆乵ain.js銆丄ppHeader.vue銆丷eportExport.vue锛汥ataImport 鐨� `dirLast_*`銆丷eportExport 鐨� `report_note_*` 灞炲亸濂借蹇嗕繚鐣� localStorage銆傛敞鎰忥細鍚屾爣绛鹃〉 F5 鍒锋柊淇濇寔鐧诲綍銆佹柊寮�鏍囩椤甸渶閲嶇櫥銆�
+- 娴嬭瘯鑴氭湰锛歚D:\Codex\_tools\pptr-core\menu_test3.js`锛堢偣鍑婚亶鍘嗭級銆乣menu_test4.js`锛堥�愯矾鐢辫闂紝鎺ㄨ崘锛夈�乣login_debug.js`锛沶ode24 杩愯锛坄C:\Users\jcxiong\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe`锛夈��
+
+### 5. 寰呭姙涓嶅彉
 - `docs/鎵撳寘閮ㄧ讲璇存槑.docx` 绗叚鑺傘�屽缃� application.yml 闇�鍖呭惈瀹屾暣閰嶇疆銆嶆敼涓恒�屽睘鎬х骇鍚堝苟銆嶅悗閲嶆柊瀵煎嚭 docx锛堟湭鍋氾級銆�
 - 宕╂簝鏍瑰洜纭鍚庯細淇 commit `cf57c2b` 涓�屾寚鍚戝鎴风鐜銆嶇殑鏃х粨璁恒��
+- /import 椤� JS 涓荤嚎绋嬪崱姝诲緟璋冩煡锛堢浉淇′负闂鈶犻珮浜強娴忚鍣ㄦ棤鍝嶅簲鐨勬牴鍥狅級銆�
+- 璁よ瘉淇℃伅 localStorage 鈫� sessionStorage锛堝己鍒剁櫥褰曪級锛岃涓婇潰绗� 4 鑺傘��
 
 
 ## 銆囥�佸叧鏈轰氦鎺ワ紙2026-08-27 娣卞锛岀敤鎴峰叧鏈哄墠锛�

--
Gitblit v1.9.1