From cd21a0bdf89c5413c8c241e067839295debcbcbd Mon Sep 17 00:00:00 2001
From: QLHazyCoder <2825305047@qq.com>
Date: Mon, 13 Apr 2026 23:53:49 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0Hotmail=E5=8F=8C=E6=A8=A1?=
 =?UTF-8?q?=E5=BC=8F=E9=80=82=E9=85=8D=E5=BC=80=E5=8F=91=E6=96=B9=E6=A1=88?=
 =?UTF-8?q?=E5=8F=8A=E5=BC=80=E5=8F=91=E8=AE=B0=E5=BD=95md=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Hotmail双模式适配开发方案及开发记录.md | 431 +++++++++++++++++++++++++
 1 file changed, 431 insertions(+)
 create mode 100644 Hotmail双模式适配开发方案及开发记录.md

diff --git a/Hotmail双模式适配开发方案及开发记录.md b/Hotmail双模式适配开发方案及开发记录.md
new file mode 100644
index 0000000..d8ab2ee
--- /dev/null
+++ b/Hotmail双模式适配开发方案及开发记录.md
@@ -0,0 +1,431 @@
+# Hotmail 鍙屾ā寮忛€傞厤寮€鍙戞柟妗?
+## 1. 鑳屾櫙涓庨棶棰樺垎鏋?
+褰撳墠浠撳簱鐨?Hotmail 鎺ョ爜璺緞宸茬粡鍥為€€鍒扳€滅涓夋柟閰嶇疆鈥濈増鏈紝鏍稿績鐗圭偣鏄細
+
+- 璐﹀彿姹犵户缁娇鐢?`閭 / 瀹㈡埛绔?ID / 鍒锋柊浠ょ墝` 浣滀负鎵归噺瀵煎叆鏍煎紡
+- 鎵╁睍褰撳墠娲昏穬閫昏緫鐩存帴璇锋眰绗笁鏂?HTTP 鎺ュ彛璇诲彇閭欢
+- 渚ц竟鏍忛澶栨毚闇蹭簡 `API 鍦板潃 / 鍝嶅簲绫诲瀷 / 鏀朵欢绠卞弬鏁?/ 鍨冨溇绠卞弬鏁癭 杩欑粍鍗忚缁嗚妭閰嶇疆
+
+杩欑増铏界劧鑳藉伐浣滐紝浣嗗凡缁忔毚闇插嚭涓や釜缁撴瀯鎬ч棶棰橈細
+
+1. **杩滅▼鍗忚鍜屾湰鍦板崗璁苟涓嶄竴鑷?*
+   - `#10` 鏄繙绋嬬涓夋柟鏈嶅姟妯″紡锛屾牳蹇冩槸涓€涓浐瀹氭枃妗ｆ帴鍙?`https://apple.882263.xyz/api.html`
+   - `#42` 鏄湰鍦?helper 妯″紡锛屾牳蹇冩槸鏈湴 Python 鑴氭湰鏆撮湶 `/messages`銆乣/code` 绛夋帴鍙?   - 涓よ€呭彧鏄骇鍝佸叆鍙ｇ浉浼硷紝涓嶆槸鍚屼竴鍗忚锛屼笉鑳界‖缁熶竴鎴愪竴濂椻€滈€氱敤 API 鍙傛暟閰嶇疆鍣ㄢ€?
+2. **褰撳墠 UI 鏆撮湶浜嗚繃澶氬崗璁粏鑺?*
+   - `鍝嶅簲绫诲瀷`
+   - `鏀朵欢绠卞弬鏁癭
+   - `鍨冨溇绠卞弬鏁癭
+   - 杩欎簺瀛楁瀵硅繙绋嬫彁渚涘晢鍗忚鏉ヨ鏄浐瀹氱殑锛屽鏈湴 helper 鍗忚鏉ヨ鍙堟牴鏈笉閫傜敤
+   - 鎶婅繖浜涚粏鑺傛毚闇茬粰鏈€缁堢敤鎴凤紝浼氭妸鐣岄潰鍙樻垚鈥滄帴鍙ｈ皟璇曞櫒鈥濓紝澧炲姞閿欒閰嶇疆椋庨櫓
+
+3. **鐢ㄦ埛鐪熷疄闇€姹備笉鏄氦浜掓巿鏉冿紝鑰屾槸鎵归噺璐﹀彿姹?*
+   - 闇€瑕佺户缁敮鎸?`璐﹀彿----瀵嗙爜----瀹㈡埛绔疘D----鍒锋柊浠ょ墝`
+   - 闇€瑕佹敮鎸佸嚑鍗佷釜璐﹀彿鐨勬壒閲忓鍏ヤ笌鑷姩杞
+   - 鍥犳褰撳墠闃舵涓嶅簲鍒囧埌鈥滃井杞氦浜掓巿鏉冣€濅富璺嚎
+
+## 2. 宸查獙璇佸弬鑰冩潵婧?
+### 2.1 PR #10锛氳繙绋嬬涓夋柟鏈嶅姟妯″紡
+
+宸茬‘璁ょ壒寰侊細
+
+- 鎵╁睍鐩存帴璇锋眰杩滅▼鎺ュ彛
+- 鎺ュ彛鏂囨。宸插叕寮€锛歚https://apple.882263.xyz/api.html`
+- 鏍稿績鎺ュ彛鏄?`/api/mail-new`
+- 鎵╁睍浼犲叆锛?  - `client_id`
+  - `refresh_token`
+  - `email`
+  - `mailbox`
+  - `response_type`
+
+璁捐鐗圭偣锛?
+- 鍗忚鐢辨彁渚涘晢鍥哄畾锛屼笉鍙兘涓哄綋鍓嶉」鐩崟鐙慨鏀?- 鎵╁睍搴旇鍋氣€滃崗璁€傞厤鈥濓紝鑰屼笉鏄鐢ㄦ埛鎵嬪～涓€鍫嗗簳灞傚弬鏁?
+### 2.2 PR #42锛氭湰鍦?helper 妯″紡
+
+宸茬‘璁ょ壒寰侊細
+
+- 鎵╁睍璇锋眰鏈湴 helper锛歚http://127.0.0.1:17373`
+- helper 鑴氭湰浣嶄簬锛?  - `scripts/hotmail_helper.py`
+  - `start-hotmail-helper.bat`
+- 鎵╁睍浣跨敤鐨勬牳蹇冩帴鍙ｆ槸锛?  - `/messages`
+  - `/code`
+
+璁捐鐗圭偣锛?
+- 鎵╁睍鍜岄偖绠卞崗璁В鑰?- 鏈湴鑴氭湰鎵挎媴 token 鍒锋柊銆佸彇淇°€侀獙璇佺爜绛涢€?- 鏇撮€傚悎鏈湴鐢ㄦ埛鑷帶鐜
+
+## 3. 鏈€缁堣璁″彇鑸?
+### 3.1 鐩爣鏂规
+
+Hotmail 鍖烘敼鎴?*鍙屾ā寮忛€傞厤**锛?
+- `杩滅▼鏈嶅姟`
+- `鏈湴鍔╂墜`
+
+涓ょ妯″紡缁х画鍏辩敤鍚屼竴濂楄处鍙锋睜涓庢壒閲忓鍏ユ牸寮忥細
+
+```text
+璐﹀彿----瀵嗙爜----瀹㈡埛绔疘D----鍒锋柊浠ょ墝
+```
+
+### 3.2 涓嶉噰鐢ㄧ殑鏂规
+
+#### 涓嶉噰鐢ㄢ€滃井杞氦浜掓巿鏉冣€濅富鏂规
+
+鍘熷洜锛?
+- 涓嶉€傚悎鍑犲崄涓处鍙风殑鎵归噺浣跨敤鍦烘櫙
+- 浼氱牬鍧忕幇鏈夋壒閲忓鍏ラ摼璺?- 涓庡綋鍓嶇敤鎴烽渶姹傚啿绐?
+#### 涓嶉噰鐢ㄢ€滈€氱敤 API 鍙傛暟閰嶇疆鍣ㄢ€?
+鍘熷洜锛?
+- 杩滅▼鍗忚鍜屾湰鍦板崗璁湰灏变笉鍚?- 缁х画淇濈暀 `鍝嶅簲绫诲瀷 / 鏀朵欢绠卞弬鏁?/ 鍨冨溇绠卞弬鏁癭 浼氬鍔犻厤缃鏉傚害
+- 杩欎簺瀛楁涓嶅簲鎴愪负鏈€缁堢敤鎴风殑甯歌閰嶇疆鍏ュ彛
+
+## 4. 鐩爣浜や簰璁捐
+
+### 4.1 Hotmail 鍖虹晫闈㈢粨鏋?
+鍦ㄧ幇鏈?`Hotmail 璐﹀彿姹燻 鍖哄潡涓柊澧烇細
+
+1. `Hotmail 妯″紡` 鎸夐挳缁?   - `杩滅▼鏈嶅姟`
+   - `鏈湴鍔╂墜`
+
+2. `鏈嶅姟鍦板潃` 杈撳叆妗?   - 褰撴ā寮忎负 `杩滅▼鏈嶅姟` 鏃舵樉绀鸿繙绋嬫湇鍔″湴鍧€
+   - 褰撴ā寮忎负 `鏈湴鍔╂墜` 鏃舵樉绀烘湰鍦板姪鎵嬪湴鍧€
+
+3. 淇濈暀璐﹀彿姹犺〃鍗?   - 閭
+   - 瀹㈡埛绔?ID
+   - 閭瀵嗙爜澶囨敞
+   - 鍒锋柊浠ょ墝
+   - 娣诲姞璐﹀彿
+
+4. 淇濈暀鎵归噺瀵煎叆
+   - 浠嶇劧鏀寔 `璐﹀彿----瀵嗙爜----瀹㈡埛绔疘D----鍒锋柊浠ょ墝`
+
+5. 淇濈暀璐﹀彿鎿嶄綔
+   - 浣跨敤姝よ处鍙?   - 鏍囪宸茬敤 / 鏈敤
+   - 鏍￠獙
+   - 澶嶅埗鏈€鏂伴獙璇佺爜
+   - 鍒犻櫎
+
+### 4.2 瑕佸垹闄ょ殑鏃?UI
+
+鍒犻櫎褰撳墠绗笁鏂归厤缃噷杩欏嚑涓粏椤癸細
+
+- `Hotmail API 鍦板潃`
+- `鍝嶅簲绫诲瀷`
+- `鏀朵欢绠卞弬鏁癭
+- `鍨冨溇绠卞弬鏁癭
+
+鍘熷洜锛?
+- 杩欎簺灞炰簬鍗忚缁嗚妭锛屼笉閫傚悎鏅€氫娇鐢ㄨ€?- 鍙屾ā寮忔柟妗堥噷鍙渶瑕侀厤缃€滄湇鍔″湴鍧€鈥?
+## 5. 鍚庡彴璁捐
+
+### 5.1 鎸佷箙鍖栭厤缃」
+
+鏂板骞朵娇鐢ㄤ互涓嬫寔涔呭寲瀛楁锛?
+- `hotmailServiceMode`
+  - 鍊硷細`remote` / `local`
+- `hotmailRemoteBaseUrl`
+  - 榛樿锛氳繙绋嬫湇鍔℃枃妗ｆ墍鍦ㄥ煙鍚?- `hotmailLocalBaseUrl`
+  - 榛樿锛歚http://127.0.0.1:17373`
+
+鍒犻櫎褰撳墠浠呮湇鍔′簬绗笁鏂归€氱敤閰嶇疆鍣ㄧ殑瀛楁锛?
+- `hotmailApiUrl`
+- `hotmailApiResponseType`
+- `hotmailApiInboxMailbox`
+- `hotmailApiJunkMailbox`
+
+### 5.2 璇锋眰閫傞厤灞?
+鏂板缁熶竴鐨勬ā寮忓垎鍙戝眰锛屼絾**涓嶇粺涓€搴曞眰鍗忚**銆?
+#### 杩滅▼妯″紡
+
+鐩存帴鍏煎 PR #10 鏂囨。鍗忚锛?
+- 璋冪敤杩滅▼ `baseUrl + /api/mail-new`
+- 鎵╁睍绔繚鎸佺幇鏈夆€滄媺娑堟伅鍚庢湰鍦扮瓫楠岃瘉鐮佲€濈殑妯″紡
+
+#### 鏈湴妯″紡
+
+鐩存帴鍏煎 PR #42 helper 鍗忚锛?
+- `/messages`
+- `/code`
+
+鎵╁睍绔€昏緫锛?
+- `鏍￠獙` / `娴嬭瘯鏀朵俊` 璧?`/messages`
+- 楠岃瘉鐮佽疆璇紭鍏堣蛋 `/code`
+
+### 5.3 闇€瑕佹柊澧炴垨璋冩暣鐨勫悗鍙板嚱鏁?
+1. 閰嶇疆褰掍竴鍖?   - `normalizeHotmailServiceMode`
+   - `normalizeHotmailRemoteBaseUrl`
+   - `normalizeHotmailLocalBaseUrl`
+   - `getHotmailServiceSettings`
+
+2. 杩滅▼妯″紡閫傞厤
+   - `requestHotmailRemoteMailbox`
+   - `fetchHotmailRemoteMessages`
+
+3. 鏈湴妯″紡閫傞厤
+   - `requestHotmailLocalMessages`
+   - `requestHotmailLocalCode`
+   - `fetchHotmailLocalMessages`
+
+4. 缁熶竴鍒嗗彂鍏ュ彛
+   - `fetchHotmailMailboxMessages`
+   - `pollHotmailVerificationCode`
+   - 鏍规嵁妯″紡鍒嗘祦
+
+## 6. 鏈湴 helper 鏂囦欢绛栫暐
+
+鐩存帴寮曞叆骞堕€傞厤 PR #42 宸查獙璇佺殑鏈湴鑴氭湰鏂规锛?
+- `scripts/hotmail_helper.py`
+- `start-hotmail-helper.bat`
+
+寮曞叆鍘熷垯锛?
+- 浼樺厛淇濇寔鍗忚鍏煎锛屼笉鍋氭棤蹇呰閲嶆瀯
+- 鍙帴鍏ュ綋鍓嶆墿灞曢渶瑕佺敤鍒扮殑鎺ュ彛涓庡惎鍔ㄦ柟寮?- 涓嶅湪鏈疆鎵╁睍寮€鍙戜腑缁х画寮曞叆涓?Hotmail 妯″紡鍒囨崲鏃犲叧鐨勫ぇ瑙勬ā鐘舵€侀€昏緫
+
+## 7. 涓庣幇鏈夐€昏緫鐨勫吋瀹硅姹?
+### 7.1 蹇呴』淇濇寔涓嶅彉鐨勮涓?
+- `Mail = Hotmail` 鏃朵粛鐒剁敱璐﹀彿姹犲垎閰嶉偖绠?- `璐﹀彿----瀵嗙爜----瀹㈡埛绔疘D----鍒锋柊浠ょ墝` 鎵归噺瀵煎叆鏍煎紡蹇呴』缁х画鍙敤
+- `鏍￠獙` / `澶嶅埗鏈€鏂伴獙璇佺爜` / `Auto` 鐨勭敤鎴峰叆鍙ｄ笉鍙?- Hotmail 璐﹀彿鐨?`used / status / lastError / lastAuthAt / lastUsedAt` 閫昏緫淇濇寔鐜版湁璇箟
+
+### 7.2 蹇呴』閬垮厤鐨勯棶棰?
+- 涓嶈兘鎶婅繙绋嬪拰鏈湴寮鸿鎶芥垚涓€濂楀亣缁熶竴鍗忚
+- 涓嶈兘鎶婄涓夋柟鏈嶅姟瑕佹眰鏀规垚 `/messages` `/code`
+- 涓嶈兘鍒犻櫎鎵归噺瀵煎叆 refresh token 鐨勮兘鍔?- 涓嶈兘鍙敼 UI锛屼笉鎺ュ悗鍙板垎鍙?- 涓嶈兘鍙帴鍚庡彴锛屼笉鍚屾 README 涓庤鏄?
+## 8. 鏂规鑷涓庡畬鏁存€у垎鏋?
+### 8.1 鏂规鏄惁绗﹀悎闇€姹?
+绗﹀悎銆?
+鍘熷洜锛?
+- 淇濈暀鎵归噺瀵煎叆
+- 涓嶅己杩敤鎴疯蛋寰蒋浜や簰鎺堟潈
+- 鍚屾椂鏀寔宸查獙璇佺殑杩滅▼涓庢湰鍦颁袱绉嶈矾寰?
+### 8.2 鏂规鏄惁瀹屾暣
+
+瀹屾暣銆?
+宸茬粡瑕嗙洊锛?
+- 閰嶇疆妯″瀷
+- 鐣岄潰鍙樻洿
+- 鍚庡彴鍒嗗彂
+- helper 寮曞叆
+- 鏂囨。鏇存柊
+- 鑷椤?
+### 8.3 鏂规鏄惁瀛樺湪鍐呴儴鍐茬獊
+
+褰撳墠鏃犳槑鏄惧啿绐併€?
+鍞竴闇€瑕佷弗鏍兼帶鍒剁殑鏄細
+
+- 杩滅▼妯″紡涓庢湰鍦版ā寮忚櫧鐒跺叆鍙ｇ粺涓€锛屼絾鍗忚涓嶈兘娣风敤
+- 瀹炵幇鏃跺繀椤绘槑纭垎灞傦紝涓嶈鍋氭垚鈥滄牴鎹厤缃嫾涓嶅悓 query 鍙傛暟鈥濈殑鏉傜硡閫昏緫
+
+### 8.4 鏂规娼滃湪缂洪櫡
+
+1. 鏈湴 helper 鍙兘渚濊禆 Python 鐜
+   - 闇€瑕佸湪 README 涓槑纭鏄庡浣曞惎鍔?
+2. 杩滅▼鏈嶅姟鏂囨。鑻ユ湭鏉ュ彉鏇?   - 褰撳墠浠嶄緷璧栨湇鍔″晢鎺ュ彛绋冲畾鎬?
+3. 褰撳墠浠撳簱鏄棫椤圭洰
+   - Hotmail 閫昏緫鍛ㄨ竟宸叉湁杈冨鐘舵€佸瓧娈?   - 瀹炵幇鏃跺繀椤昏皑鎱庢鏌?`verify/test/poll/auto-run` 鍥涙潯閾炬槸鍚︾粺涓€鎸夋ā寮忓垎鍙?
+## 9. 寮€鍙戞竻鍗?
+### 闃舵 1锛氶厤缃ā鍨嬩笌鏂规钀界洏
+
+- 鏂板缓鏈柟妗堟枃妗?- 鏂板 Hotmail 鍙屾ā寮忔寔涔呭寲瀛楁
+- 鍒犻櫎鏃х殑绗笁鏂瑰崗璁粏椤瑰瓧娈?
+鑷锛?
+- 閰嶇疆椤瑰懡鍚嶆槸鍚︾粺涓€
+- 榛樿鍊兼槸鍚﹀畬鏁?- import/export 鏄惁浠嶅彲宸ヤ綔
+
+### 闃舵 2锛欻otmail UI 鏀归€?
+- 鏂板 `杩滅▼鏈嶅姟 / 鏈湴鍔╂墜` 妯″紡鎸夐挳
+- 鏂板 `鏈嶅姟鍦板潃` 杈撳叆妗?- 鍒犻櫎鏃х殑 `鍝嶅簲绫诲瀷 / 鏀朵欢绠卞弬鏁?/ 鍨冨溇绠卞弬鏁癭 杈撳叆妗?- 淇濈暀璐﹀彿姹犺〃鍗曚笌鎵归噺瀵煎叆
+
+鑷锛?
+- 鍒囨崲妯″紡鍚庢樉绀烘槸鍚︽纭?- 鑷姩淇濆瓨鏄惁浠嶆甯?- 涓嶅悓妯″紡鐨勫湴鍧€鏄惁涓嶄細浜掔浉瑕嗙洊
+
+### 闃舵 3锛氬悗鍙板弻妯″紡閫傞厤
+
+- 瀹炵幇杩滅▼妯″紡璇锋眰閫傞厤
+- 瀹炵幇鏈湴妯″紡 helper 璇锋眰閫傞厤
+- 淇敼 `fetchHotmailMailboxMessages`
+- 淇敼 `pollHotmailVerificationCode`
+- 鏍￠獙 `verify / test / auto-run` 涓夋潯閾?
+鑷锛?
+- 杩滅▼妯″紡鏄惁浠嶅吋瀹?`#10`
+- 鏈湴妯″紡鏄惁鍏煎 `#42`
+- 閿欒淇℃伅鏄惁浠嶄細鍐欏洖 `lastError`
+
+### 闃舵 4锛氬紩鍏ユ湰鍦?helper
+
+- 寮曞叆 `scripts/hotmail_helper.py`
+- 寮曞叆 `start-hotmail-helper.bat`
+- 妫€鏌ユ湰鍦板崗璁笌鎵╁睍璋冪敤涓€鑷?
+鑷锛?
+- helper 璺緞鏄惁姝ｇ‘
+- 绔彛涓庢枃妗ｆ槸鍚︿竴鑷?- 鎵╁睍璇锋眰璺緞鏄惁鍖归厤 helper
+
+### 闃舵 5锛氭枃妗ｆ敹灏?
+- 鏇存柊 README 涓?Hotmail 浣跨敤璇存槑
+- 鏄庣‘杩滅▼妯″紡涓庢湰鍦版ā寮忕殑鍖哄埆
+- 鏄庣‘鏈湴 helper 鍚姩鏂瑰紡
+
+鑷锛?
+- README 鏄惁鍜岀湡瀹?UI 涓€鑷?- 鐢ㄦ埛鏄惁鑳界湅鏂囨。瀹屾垚閰嶇疆
+
+## 10. 瀹炴柦椤哄簭
+
+鏈疆寮€鍙戜弗鏍兼寜浠ヤ笅椤哄簭鎵ц锛?
+1. 鍏堝啓鏈柟妗堟枃妗?2. 鍐嶆敼閰嶇疆妯″瀷
+3. 鍐嶆敼 UI
+4. 鍐嶆敼鍚庡彴鍙屾ā寮忓垎鍙?5. 鍐嶅紩鍏ユ湰鍦?helper
+6. 鏈€鍚庣粺涓€鍋氶潤鎬佽嚜妫€骞舵彁閱掔敤鎴锋墜娴?
+## 11. 瀹為檯寮€鍙戣褰?
+### 11.1 宸插畬鎴愭敼鍔?
+鏈疆宸插疄闄呭畬鎴愪互涓嬪紑鍙戝唴瀹癸細
+
+1. Hotmail 閰嶇疆妯″瀷浠庘€滅涓夋柟閫氱敤缁嗛」閰嶇疆鈥濆垏鎹负鈥滃弻妯″紡 + 鍦板潃閰嶇疆鈥?   - 鍒犻櫎鍘熸湰闈㈠悜绗笁鏂圭粏椤圭殑鎬濊矾锛?     - `hotmailApiUrl`
+     - `hotmailApiResponseType`
+     - `hotmailApiInboxMailbox`
+     - `hotmailApiJunkMailbox`
+   - 鏀逛负锛?     - `hotmailServiceMode`
+     - `hotmailRemoteBaseUrl`
+     - `hotmailLocalBaseUrl`
+
+2. Sidepanel Hotmail 鍖哄凡鏀归€犳垚鍙屾ā寮?UI
+   - 鏂板 `杩滅▼鏈嶅姟 / 鏈湴鍔╂墜` 鎸夐挳缁?   - 鏂板杩滅▼鏈嶅姟鍦板潃杈撳叆妗?   - 鏂板鏈湴鍔╂墜鍦板潃杈撳叆妗?   - 淇濈暀鍘熸湁璐﹀彿姹犺〃鍗曞拰鎵归噺瀵煎叆鏍煎紡
+
+3. 鍚庡彴 Hotmail 璇锋眰閾惧凡鎸夋ā寮忓垎娴?   - 杩滅▼妯″紡锛?     - 鐩存帴鍏煎 `#10`
+     - 浣跨敤 `baseUrl + /api/mail-new`
+   - 鏈湴妯″紡锛?     - 鐩存帴鍏煎 `#42`
+     - 浣跨敤 `/messages`
+     - 浣跨敤 `/code`
+
+4. 鏈湴 helper 鏂囦欢宸茶惤鍦?   - `scripts/hotmail_helper.py`
+   - `start-hotmail-helper.bat`
+
+5. README 宸插悓姝ユ洿鏂颁负鍙屾ā寮忚鏄?
+### 11.2 瀹為檯淇敼鏂囦欢
+
+鏈疆瀹為檯鏀瑰姩鏂囦欢濡備笅锛?
+- `background.js`
+- `sidepanel/sidepanel.html`
+- `sidepanel/sidepanel.js`
+- `README.md`
+- `scripts/hotmail_helper.py`
+- `start-hotmail-helper.bat`
+
+鏈疆鏂板浣嗕笉涓€瀹氳繘鍏?Git 鐨勬枃妗ｏ細
+
+- `docs/md/Hotmail鍙屾ā寮忛€傞厤寮€鍙戞柟妗?md`
+
+### 11.3 瀹為檯瀹炵幇涓庡師鏂规鐨勫樊寮?
+褰撳墠瀹炵幇涓庡師鏂规鐩告瘮锛屽瓨鍦ㄨ繖浜涘疄闄呭樊寮傦細
+
+1. 鏈湴 helper 娌℃湁鏁翠唤鐓ф惉 `#42`
+   - 褰撳墠鏄寜 `#42` 鐨勫崗璁€濊矾钀戒簡涓€涓畝鍖栫増
+   - 鐩爣鏄厛婊¤冻鎵╁睍鐜伴樁娈电殑 `/messages` 涓?`/code`
+   - 娌℃湁缁х画寮曞叆 `#42` 閲屾洿閲嶇殑澶辫触鐘舵€併€佹寔涔呭凡鐢ㄩ偖绠便€佸苟鍙戜繚鎶ょ瓑鏁村鎵╁睍閫昏緫
+
+2. 杩滅▼妯″紡鐩墠浠嶆部鐢ㄦ墿灞曠鏈湴绛涢獙璇佺爜
+   - 鍏煎 `#10` 鐨勫崟鎺ュ彛 `/api/mail-new`
+   - 鏈澶栧鎺?`mail-all`銆乣process-inbox`銆乣process-junk`
+
+3. 娴嬭瘯鏂囦欢鏈疆娌℃湁缁х画琛ラ綈
+   - 褰撳墠涓昏瀹屾垚鐨勬槸鏂规钀藉湴鍜屼富閾炬敼閫?   - 灏氭湭琛ラ拡瀵瑰弻妯″紡鐨勬渶灏忓洖褰掓祴璇曟々
+
+### 11.4 褰撳墠宸茬煡鏈畬鎴愰」
+
+浠ヤ笅鍐呭褰撳墠浠嶆湭瀹屾垚鎴栨湭楠岃瘉锛?
+1. 鏈ˉ Hotmail 鍙屾ā寮忓搴旂殑娴嬭瘯妗?   - 杩滅▼妯″紡楠岃瘉閫昏緫
+   - 鏈湴妯″紡 `/messages` 涓?`/code` 鍒嗗彂閫昏緫
+   - 妯″紡鍒囨崲鍚庣殑 UI 鐘舵€佸洖濉?
+2. 鏈 helper 鍋氳繍琛岀骇瀹炴祴
+   - 褰撳墠鍙畬鎴愪唬鐮佹帴鍏?   - 灏氭湭纭鏈満 Python 鐜涓?`imaplib + XOAUTH2 + login.live.com/oauth20_token.srf` 鏄惁鑳界ǔ瀹氬伐浣?
+3. 鏈獙璇佽繙绋嬫湇鍔″湴鍧€鐨勪笉鍚岃緭鍏ュ舰寮?   - 渚嬪鐢ㄦ埛濉細
+     - 鏍瑰煙鍚?     - `/api.html`
+     - `/api/mail-new`
+   - 鐩墠浠ｇ爜鍋氫簡璺緞褰掍竴鍖栵紝浣嗛渶瑕佷汉宸ユ墜娴嬬‘璁?
+4. 鏈ˉ README 涓洿缁嗙殑鏈湴 helper 鍚姩鎺掗敊璇存槑
+   - 褰撳墠鍙啓浜嗗叆鍙ｈ鏄?   - 杩樻病鍐欌€滃惎鍔ㄥけ璐ユ€庝箞鐪嬨€佺鍙ｅ崰鐢ㄦ€庝箞鍔炪€丳ython 涓嶅瓨鍦ㄦ€庝箞鍔炩€?
+### 11.5 褰撳墠鎵嬫祴閲嶇偣
+
+鍚庣画浼樺厛鎵嬫祴浠ヤ笅鍐呭锛?
+1. 杩滅▼妯″紡
+   - `Mail = Hotmail`
+   - 妯″紡鍒囧埌 `杩滅▼鏈嶅姟`
+   - 鍦板潃濉?`https://apple.882263.xyz`
+   - 娴嬶細
+     - `鏍￠獙`
+     - `澶嶅埗鏈€鏂伴獙璇佺爜`
+     - `Auto`
+
+2. 鏈湴妯″紡
+   - 鍏堣繍琛?`start-hotmail-helper.bat`
+   - 妯″紡鍒囧埌 `鏈湴鍔╂墜`
+   - 鍦板潃淇濇寔 `http://127.0.0.1:17373`
+   - 娴嬶細
+     - `鏍￠獙`
+     - `澶嶅埗鏈€鏂伴獙璇佺爜`
+     - `Auto`
+
+3. 妯″紡鍒囨崲
+   - 浠?`杩滅▼鏈嶅姟` 鍒囧埌 `鏈湴鍔╂墜`
+   - 浠?`鏈湴鍔╂墜` 鍒囧埌 `杩滅▼鏈嶅姟`
+   - 鐪嬪湴鍧€鏄惁鍒嗗埆淇濈暀
+   - 鐪?Hotmail 璐﹀彿姹犳槸鍚︿笉鍙楀奖鍝?
+4. 鎵归噺瀵煎叆
+   - 瀵煎叆鏍煎紡锛?     - `璐﹀彿----瀵嗙爜----瀹㈡埛绔疘D----鍒锋柊浠ょ墝`
+   - 妫€鏌ユā寮忓垏鎹㈠悗瀵煎叆鑳藉姏鏄惁浠嶆甯?
+### 11.6 褰撳墠椋庨櫓缁撹
+
+褰撳墠鏈€澶ч闄╀笉鍦?UI锛岃€屽湪杩欎袱涓偣锛?
+1. 鏈湴 helper 鐨勭湡瀹炲彲杩愯鎬?   - 浠ｇ爜宸茬粡鎺ヤ笂
+   - 浣嗘湭缁忓疄闄呰繍琛岄獙璇?
+2. 杩滅▼涓庢湰鍦扮殑杩斿洖缁撴瀯鍏煎鎬?   - 杩滅▼妯″紡璧?`#10` 椋庢牸
+   - 鏈湴妯″紡璧?`#42` 椋庢牸
+   - 铏界劧鍚庡彴宸茬粡鍋氫簡閫傞厤锛屼絾浠嶉渶瑕佸疄闄呰繑鍥炴牱鏈獙璇?
+### 11.7 褰撳墠闃舵缁撹
+
+褰撳墠鐘舵€佸彲浠ョ悊瑙ｄ负锛?
+- 鏂规宸茶惤鐩?- 鍙屾ā寮忎富缁撴瀯宸插紑鍙戝畬鎴?- 杩滅▼ / 鏈湴涓ゆ潯鍗忚宸叉帴鍏?- 璐﹀彿姹犱笌鎵归噺瀵煎叆浠嶄繚鐣?- 浣嗗皻鏈粡杩囩湡瀹炶繍琛岄獙璇?
+鍥犳鏈疆寮€鍙戠粨鏋滃睘浜庯細
+
+- **浠ｇ爜缁撴瀯宸插埌浣?*
+- **杩愯绋冲畾鎬у緟浜哄伐楠岃瘉**
+
+## 12. 本地 helper 运行说明补充
+
+### 12.1 启动命令
+
+Windows：
+
+```powershell
+.\start-hotmail-helper.bat
+```
+
+macOS：
+
+```bash
+chmod +x ./start-hotmail-helper.command
+./start-hotmail-helper.command
+```
+
+如果不使用启动脚本，也可以直接运行：
+
+```bash
+python scripts/hotmail_helper.py
+```
+
+或：
+
+```bash
+python3 scripts/hotmail_helper.py
+```
+
+### 12.2 启动成功标志
+
+启动成功后，终端应输出：
+
+```text
+Hotmail helper listening on http://127.0.0.1:17373
+```
+
+### 12.3 最小排错说明
+
+- 若提示 `Python 3 not found`，说明当前机器没有可用的 Python 3.10+。
+- 若 helper 已启动但扩展仍连不上，先确认 Hotmail 模式切到了 `本地助手`。
+- 再确认侧边栏中的本地助手地址与终端输出一致，默认应为 `http://127.0.0.1:17373`。
+- 若地址一致仍失败，再检查终端中是否已经打印异常，或是否有端口占用。