From 079d872fabfe488abf485d8898c40ff1fd746472 Mon Sep 17 00:00:00 2001
From: xyc <jc_xiong@hotmail.com>
Date: 星期一, 31 八月 2026 09:48:44 +0800
Subject: [PATCH] docs: 交接约定——「提交」= commit + 推送远端 git
---
HANDOFF.md | 16 +++++++++++++---
1 files changed, 13 insertions(+), 3 deletions(-)
diff --git a/HANDOFF.md b/HANDOFF.md
index 5dc3934..d49a104 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -2,6 +2,7 @@
> **鐢ㄦ硶**锛氭柊瀵硅瘽寮�濮嬪悗锛屽厛璇绘湰鏂囦欢 + 椤圭洰鏍圭洰褰� `AGENTS.md`锛屽嵆鍙棤缂濇帴鍔涖��
> **姣忓ぉ缁撴潫鏃�**锛氭妸褰撳ぉ杩涘睍銆佽俯杩囩殑鍧戙�佹柊闇�姹傘�佹湭瀹屾垚浜嬮」鏇存柊鍒版湰鏂囦欢锛岀劧鍚庡彲浠ユ斁蹇冨紑鏂板璇濄��
+> **鍗忎綔绾﹀畾锛�2026-08-31锛�**锛氳銆屾彁浜ゃ��= 鏈湴 commit + 鎺ㄩ�佸埌杩滅 git锛坥rigin main锛孏itblit锛夛紝涓嶅啀鍙仛鏈湴 commit銆�
## 浠婃棩锛�2026-08-28锛�
@@ -13,6 +14,7 @@
- 鈿狅笍 闇�閲嶆柊鎵撳寘鎵嶅湪娴嬭瘯鐜鐢熸晥锛涙寮忓彂甯冩椂鎶� `app.captcha.required` 鏀瑰洖 `true`銆�
### 2. 鏁版嵁瀵煎叆娴忚鍣ㄥ穿婧冩帓鏌ワ紙杩涜涓紝鐢ㄦ埛绾跨储鏇存柊锛�
+- **銆�08-31 鏍瑰洜瀹為敜鏇存柊銆戠湡姝ｅ穿婧冩牴鍥犲凡鎵惧埌锛氭暟鎹鍏ラ〉 `<el-tabs>` 瑙﹀彂 Element UI 甯冨眬鏃犻檺寰幆锛堣瑙佷笅闈㈢ 4 鑺傦紝commit 684da41锛夈�傛鍓嶃�岀嚎绋嬫睜鍗犳弧/batches pending/鎱笂浼犮�嶆槸鍙︿竴鏉″彲澶嶇幇鏈哄埗锛屼絾涓嶆槸鐢ㄦ埛鍦烘櫙鐨勫疄閿ゆ牴鍥狅紱`/import/batches` pending 鍙槸**琛ㄨ薄**鈥斺�攅l-tabs 甯冨眬椋庢毚闃诲涓荤嚎绋嬪悗锛岄〉闈㈠悗缁姹傦紙鍚� batches锛夊叏閮ㄥ彂涓嶅嚭鍘�/鎺掗槦锛岃〃鐜颁负銆宐atches pending + 娴忚鍣ㄦ棤鍝嶅簲銆嶃�備慨澶� el-tabs 鍚� dev 涓庢墦鍖呭舰鎬佸潎姝ｅ父銆�
- 鐢ㄦ埛琛ュ厖锛氬叡 3 鍙版満鍣ㄥ嚭鐜帮紙瀵规柟寮�鍙戞満 + 鏄ㄥぉ鎵撳寘娴嬭瘯 1 鍙� + 浠婂ぉ 1 鍙帮級锛涘鏂硅褰曠殑銆岃繀闆�/椹卞姩銆嶆槸鍏朵富瑙傚垽鏂紱鐜拌薄鏃跺ソ鏃跺潖銆佹瘡鍙扮害 1/3 鐢ㄦ埛宕┿��
- 宸叉帓闄わ細/import/batches锛坙imit鈮�200銆�81 鏉＄害 17KB锛夛紱杩涘叆椤甸潰鏃犺疆璇�/瀹氭椂鍣ㄣ��
- 鐢ㄦ埛鎬�鐤戙�岀洰褰曞鍏ワ紙娴忚/鎵弿鐩綍锛夈�嶁啋 宸插姞鍥猴紙瑙佷笅锛夈�傛敞鎰忥細璇ュ姛鑳介渶鐢ㄦ埛涓诲姩鎵撳紑鐩綍娴忚/鐐圭洰褰曞鍏ユ墠瑙﹀彂锛屼笌銆岀偣鏁版嵁瀵煎叆鑿滃崟灏卞穿銆嶇幇璞′笉瀹屽叏鍚诲悎锛�**寰呯敤鎴风‘璁ゅ穿婧冩椂鐐圭殑鍏蜂綋鎸夐挳**銆�
@@ -36,7 +38,15 @@
- 闀胯�楁椂璇锋眰鏄惧紡瑕嗙洊锛氭枃浠朵笂浼� 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. 鑿滃崟/甯冨眬涓庡己鍒剁櫥褰曞叏閮ㄨВ鍐筹紙宸叉帹閫侊級
+- 鐢ㄦ埛鍙嶉 4 涓棶棰橈細鈶犵偣銆屽鏍哥粨鏋溿�嶈彍鍗曚笉楂樹寒锛涒憽浼佷笟瑙ｉ噴/鐢ㄦ埛绠＄悊椤堕儴娌℃湁缁熶竴妯爮锛涒憿鏌愪簺椤甸潰閫�鍑虹櫥褰曚笉鏄剧ず锛涒懀鍏虫爣绛鹃〉/娴忚鍣ㄥ悗閲嶅紑瑕佹眰寮哄埗鐧诲綍銆傚洓椤瑰潎宸插畬鎴愬苟瀹炴祴閫氳繃锛�
+- 鈶♀憿锛坈ommit 2bd663b锛夛細ExplainReview.vue 閲嶅 `components` 閿鐩栵紙`{ AppHeader }` 琚� `{ AiChatDialog }` 瑕嗙洊锛夆啋 浼佷笟瑙ｉ噴椤� app-header 鏈敞鍐屾棤妯爮锛涘凡鍚堝苟銆俁uleManage/UserManage 鏃х増甯冨眬锛堟棤 app-header銆侀��鍑鸿棌鑿滃崟涓斿け鏁堬級鈫� 缁熶竴涓� app-header 涓婁笅甯冨眬銆�
+- 鈶ｏ紙commit c62a61c锛夛細璁よ瘉淇℃伅锛坱oken/username/realName/modules锛変粠 localStorage 鏀瑰瓨 **sessionStorage**锛屽叧鏍囩椤�/娴忚鍣ㄥ悗寮哄埗閲嶆柊鐧诲綍锛涘悓鏍囩椤� F5 鍒锋柊淇濇寔鐧诲綍銆傚亸濂借蹇嗭紙DataImport `dirLast_*`銆丷eportExport `report_note_*`锛変繚鐣� localStorage銆傚疄娴嬶細鏂版爣绛鹃〉鐩磋 #/dashboard 琚畧鍗噸瀹氬悜鍒� /login 鉁擄紱F5 鍚庝繚鎸佺櫥褰� 鉁撱��
+- **鈶犳牴鍥犲疄閿わ紙commit 684da41锛屾湰鏃ラ噸澶х獊鐮达級锛氭暟鎹鍏ラ〉鐨� `<el-tabs>` 瑙﹀彂 Element UI 甯冨眬鏃犻檺寰幆锛圕hrome Trace 瀹炴祴锛氫富绾跨▼姣忕 1000+ 娆� Layout/UpdateLayoutTree锛屾棤 JS FunctionCall锛岀粍浠舵寕杞芥湭瀹屾垚鈫� batches 璇锋眰涓嶅彂鍑衡啋 `batchLoading` 姘� true 鈫� el-loading 鍔ㄧ敾姘歌浆锛夈�傝繖灏辨槸鐢ㄦ埛銆岀偣鏁版嵁瀵煎叆鑿滃崟灏辨祻瑙堝櫒鏃犲搷搴斻�嶅拰銆岀偣瀹℃牳缁撴灉涓嶉珮浜�嶇殑鐪熸鏍瑰洜锛堜笌姝ゅ墠绾跨▼姹�/涓婁紶鍘嬪姏鏃犲叧锛侊級銆�
+- 淇鏂瑰紡锛氬皢 el-tabs 鏀逛负 `<el-radio-group>` + `<el-radio-button>` 妯″潡鍒囨崲 + `v-show` 闈㈡澘锛堝姛鑳界瓑浠凤紝鍥為伩 el-tabs 瑙﹀彂鍣級銆傞獙璇侊細鈽� dev + **鎵撳寘褰㈡�侊紙dist + 闈欐�佷唬鐞� 8091锛�** 鍧囨甯革細/import 杩涘叆 8ms 鍙戝嚭 batches锛屾棤闀夸换鍔★紱瀹屾暣鐐瑰嚮 8 涓彍鍗曢珮浜叏閮ㄦ甯搞��
+- 娴嬭瘯鑴氭湰锛歚D:\Codex\_tools\pptr-core\` 涓� import_probe2.js / import_verify.js / menu_final.js / session_test.js / prod_import_test2.js / prod_server.js锛堟墦鍖呴潤鎬�+API 浠ｇ悊锛岀敤浜庢湰鍦伴獙璇� dist锛夈�倀race 鍒嗘瀽鑴氭湰鍦� %TEMP%\analyze_trace*.py銆�
+
+### 5. 寰呭姙涓嶅彉
- 鐢ㄦ埛鍙嶉 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 鑷韩銆�
@@ -47,8 +57,8 @@
### 5. 寰呭姙涓嶅彉
- `docs/鎵撳寘閮ㄧ讲璇存槑.docx` 绗叚鑺傘�屽缃� application.yml 闇�鍖呭惈瀹屾暣閰嶇疆銆嶆敼涓恒�屽睘鎬х骇鍚堝苟銆嶅悗閲嶆柊瀵煎嚭 docx锛堟湭鍋氾級銆�
- 宕╂簝鏍瑰洜纭鍚庯細淇 commit `cf57c2b` 涓�屾寚鍚戝鎴风鐜銆嶇殑鏃х粨璁恒��
-- /import 椤� JS 涓荤嚎绋嬪崱姝诲緟璋冩煡锛堢浉淇′负闂鈶犻珮浜強娴忚鍣ㄦ棤鍝嶅簲鐨勬牴鍥狅級銆�
-- 璁よ瘉淇℃伅 localStorage 鈫� sessionStorage锛堝己鍒剁櫥褰曪級锛岃涓婇潰绗� 4 鑺傘��
+- ~~/import 椤� JS 涓荤嚎绋嬪崱姝诲緟璋冩煡~~ 鈫� 宸插疄閿わ細el-tabs 甯冨眬寰幆锛屽凡淇锛堣涓娿��
+- ~~璁よ瘉淇℃伅 localStorage 鈫� sessionStorage~~ 鈫� 宸插畬鎴愶紙commit c62a61c锛夈��
## 銆囥�佸叧鏈轰氦鎺ワ紙2026-08-27 娣卞锛岀敤鎴峰叧鏈哄墠锛�
--
Gitblit v1.9.1