2026-06-26 15:30:37 +08:00
# 敶枏� 摰䂿緵� 嗆� �
> � 祆� � 臬虾閬� � � � � � 滚翰� 改� 霈啣� 隞� � 銝𦒘遙� ∠� � 輻� � 啣� � 嗆� � � �
> � � 蟮� 扯� 瘚� 偌餈賢� � � [`../progress.md`](../progress.md)嚗䔶� � 冽𧋦� � � 憭滚� � 湔𠯫敹𨰜� �
## 敶枏� 敹怎�
2026-07-02 09:06:52 +08:00
- � 交� 嚗� 2026-07-02
- � 嗆挾嚗间0 � 閗揭� � CDP 瘚� � 撌脤� 霂� � V1 撌脣� � � T-000 甇� � 隞� � � � � � � � � -001 `app/editor.py` 璅∪� � 硔� � -002 `app/appconfig.py` 摨𠉛鍂� 滨蔭� � -003 SQLite � � � � 硋𧑐� 箝� � -004 � 砍𧑐� 唳旿敹賜裦閫� � � � -005 AI 璅∪� 皜� � � 𡒊垢� � -006 � 訫� 瘚贝� � 箏漣� � -101 韐血噡 user-data-dir 撌亙� � � -102 Chrome � 臬𢆡� 具� � -103 � 餃� 靽脲暑銝擧� 瘚卝� � -104 PySide6 銝餌� � � 爸� 嗚� � -104b PySide6 worker � 箏漣� � -105 Tab� � 韐血噡蝞∠� � � -106 韐血噡敹急㭘� 孵� � � -201 Excel 撖澆� � 亙� � � -202 Tab� � 隞餃𦛚� 𡑒”銝𤾸紡� 交� � 柴� � -202b Tab� � 撖澆� 瘙� � 餅� � � -203 � � � � 扳� 憸䀹唂撠� 𢒰� � -204 � 𧼮� � 批� 畾萄� � � Excel� � -204b � � � 摰峕� � 芸𢆡� 𧼮� � � -205 擐𡝗活� 芷� 韐血噡/Chrome � 芸鍳� � /� 芰蒈敶訫� 撖潔� � 扎� � -205b � � � � 𤾸� � 剛䌊� 冽鰵撱箏� � � △ tab� � -206 Tab� � � 𣳇膄� � � � 寞活頧臬� � 扎� � -301 AI � � � � 亙藁� � -302 Tab� � AI � � � 撣� � 銝𦒘遙� ∪� 銵具� � -302p � 鞟內霂滨恣� � � � -303 Tab� � 撘� 憪讠� � � /� 𨀣迫/餈𥕦漲� � -303b � � /� � � � � ID蝑偦� 剹� � -401 Tab� � � 湔鰵� 𡑒”蝑偦� 劐� 撘� 憪𧢲凒� 啁&霈扎� � -402 Tab� � 蝖株恕� 𦒘葡銵峕凒� 啜� � -403 Tab� � 蝏𤘪� � 𧼮� 銝𡒊� � � � � 颯� � -501 Tab� � AI 璅∪� 蝞∠� UI� � -501b Tab� � 閫坿𠧧銝𡒊� � 𣂼� � 啜� � -501c Tab� � Shopee � 湔鰵摰匧� 撘� � 喋� � -502 � W� � W� 蝚砌� 撘惩� 銝𠹺� � � -503 � 𤩺� 靽⊥� � 砍𧑐� 擧� 靽嘥� � 鞟內銝擧𠯫敹𡑒� � 譌� � -504 憭朞揭� 瑕僎銵� /dry-run/餈鞱� � 亙� � � -207 � 𣳇� � � � � 剜𠯫敹𨰜� � 鷄 AI� � � � 曄� 憭梯揖霂𦠜鱏� 亙� 銵乩� � � -404a � � /� � � 劐葉霈啣� � 滨蔭� � -404 � 笔� Shopee � 閙辺� 湔鰵� 垍� 撉峕𤣰� � -506 甇� � 雿輻鍂� 寥� � 湔鰵雿㯄� � � -507 甇� � � 寥� � 湔鰵蝘駁膄� 桅� 𡁏� 蝔𧢲� 霂訫� � � ID � 𣂼� � � -508 � � � 湔鰵shopee� 煺漣� 𡝗� 雿𨅯躹� � -509 � � � 唳� 憸䀝犖撌亙凝靚� � � -510 � � 璉� � 交𧋦頧格凒� 唳� 獢� � 銝� � � -505 � 冽� 蝔贝� � 剜𠯫敹埈� 撅𨰻� � -511 霂凋� � 脫踎銝𦒘遙� ∠𠶖� � � 銝𡃏𠧧� � -512 � a� 憌𡡞埯� 厰僼銝𡃏𠧧銝𢛶� 撖澆� � ⊿� � 啣� � � 滯� � -513 � 餃� � � /� ㎡ab� 梢埯� � � /� 游� � 扳� � 桐� � 脯� �
2026-06-27 15:47:21 +08:00
- � � � 舀� 嚗䥪ython 3.10+嚗諹䌊� � CDP嚗òebsocket-client + requests嚗㚁� SQLite嚗ìqlite3嚗� + `config.json` + openpyxl + AI嚗Ǒconfig/ai_models.json` � 𡁶鍂 HTTP嚗稪hat JSON / images_edits嚗㚁� GUI PySide6 5 Tab嚗� 歇摰𡄯� � �
2026-07-02 09:06:52 +08:00
- � 煺漣隞� � 嚗𡁜歇撱箇� `app/` � � + � 孵� � � `main.py` 嚗𢱌app/cdp.py` 銝箏歇撉諹� CDP 摨訫漣嚗� 歇� 箏� ` CDP.close()` � 剖� WebSocket 銝� ` close_tab()` � 喲𡡒瘚讛� � � target嚗𢱌app/editor.py` 撌脣� 鋆� 蒈敶閧𠶖� � � 瘚卝� � � 憸� /撠� 𢒰/� � � /� 湔鰵� 厰僼� 賢� 嚗� 僎� 券� � � � � 笔� � 芸� � 剜𧋦頧株䌊� 冽鰵撱箇� � � � 蝻𤥁� 憿� tab� � � � 嗵鍂� 瑕歇� � tab嚗峕凒� 唳� 鈭斗� � 煺� 霈曄蔭撘� � 舀𧒄� 臬� � 剜𧋦頧株䌊� 冽鰵撱箏� � � △嚗𣬚&霈文� 頝喳� � � � � 𡑒”憿菜𧒄� 喲𡡒� 滨� 敺� 2 蝘𡜐� `click_update()` 撌脰‘ Shopee 蝡嗵� 靘抒&霈斗� 憭� � 嚗屸△� V蜓� 峕凒� 啜� 滚� � 亙枂� � `蝣箏� � 刻� � 湔鰵� � � � � ?` modal嚗Ǒ.eds-modal__content` / ` .eds-modal__box`嚗㚁� � 芰� � 餃撕蝒𦯀蜓� 厰僼� 峕凒� 啜� 滚僎� 踹� � 𣬚� � 喳� � 硔� 㵪� 銝磰扇敶閧&霈文� � 臬炏頝喳� � � � � 𡑒”憿蛛� ` replace_cover()` 撌脣� � 唳凒� 啣� � Y� 銝� � � 嵗撉峕𧋦� 唳唂撠� 𢒰憭� 遢嚗� � � 寧洵銝� 撘惩� � 扎� � 虾閫� &霈斗� � � � 敺� 㦛� � 恣� � 膥蝔喳� � 䔶� 隡� input � W� 嚗屸� � 𤾸� � 孵稬銝𠹺� � 埈芋� 煺犖撌亙� � � � � � � � � 敺� � � � � 啗繮� � input� � 釣� 交� 隞嗡� 隡䭾鰵� 曉僎蝑匧� Shopee CDN � 擧� � 啁洵銝� 雿滨� 隞� � 頝臬� 嚗𥕦歇靽格迤 2026-06-30 蝔喳� 蝑匧� � 𧼮� 嚗𡁜� � 斤洵銝� 撘惩� 銝滩� 瘙� � 隡� input � 舐鍂嚗� 蘨蝑匧㦛� � � 銵函迅摰𡄯� � 𣳇膄� 𤾸� 蝑劐� 隡惩� � � � 憭㵪� ` � 滩� /� 滚� /duplicate` 銝𠹺� toast 隡𡁶� � 喳ế銝箸鰵撠� 𢒰� 滚� � 躰秤嚗𢱌app/image_paths.py` 撌脩� 銝� � 圈� � � /� 啁� � 𣂼㦛� � 楝敺� 蛹 `images/<batch_id>/<slug>/<task_id>_<item_id>_old/new.jpg` 嚗� � � � DB 頝臬� 蝏抒賒� 匧� 頝臬� 霂餃� 嚗𢱌app/appconfig.py` 撌脣� � � ` config.json` 暺䁅恕� � /霂餃� /� 湔鰵� � I � � 㺭� � 垢� � 粉� 硔� � hopee � 湔鰵摰匧� 銝擧� 銵峕芋撘誯� 霈文� 潘� ` config/ai_models.json` 璅∪� 皜� � CRUD/餈� 誘/� 梶� /瘚贝� 餈墧𦻖銝� OpenAI-compatible base URL � 芸𢆡銵� endpoint嚗䔶誑� � ` mask_secret()`� � sanitize_for_log()` � � redact_secrets()` � 𤩺� 靽⊥� � 望� 撌亙� 嚗𢱌app/ai.py` 撌脣� � � `gen_title()` /`gen_cover()` /`generate_batch()` 嚗峕� 暺䁅恕� � 𧋦/� 曄� 璅∪� � 𤏸絲� 𡁶鍂 HTTP 靚� 鍂嚗峕𣈲� � � 霂𨰻� � � 霂航� � 譌� � 㦛� � URL/base64 閫� � � � esolution resize� � pg_quality 靽嘥� � � � 撟嗅� � � � � 滚僎� 穃� � U� � � 鞉辺 `set_generated` � � 仃韐� `mark_failed` � � 郊撉斤漣鈭衤辣/� 躰秤� 噼� 銝𤾸� 甇W� 瘨� 𧊋撘� 憪钅★嚗𢱌app/prompts.py` 撌脣� � 唳� 憸䀹� 蝷箄� 霂餃� � � � � X芋� � CRUD 銝𤾸� � 𤩺𤜯� g� ` app/db.py` 撌脣� � � SQLite schema� � � � � PRAGMA� � 鸌甈� /韐血噡/隞餃𦛚銝𡡞𧫴畾萄� 摨枏遆� 啜� � -206 � 寞活頧臬� � 斗� 霈唬� 暺䁅恕銝𡁜𦛚� 亥砭餈� 誘� � -404a � 砍𧑐� � � 蝏𤘪� /� 湔鰵� 嗆� � � 蝵桀遆� 啜� � -509 ` update_generated_title()` � 砍𧑐� 唳� 憸睃凝靚� 遆� 堆� 隞亙� ` run_logs/run_log_events` 餈鞱� � 亙� � 賣㺭嚗𢱌app/diagnostics.py` 撌脣� � � gitignore � 砍𧑐霂𦠜鱏� 亙� � � � � 典� � 乓� � � � � � payload � 諹䌊� 望� � 祈� � 𧶏� T-505 撌脫� Excel 撖澆� /� 𧼮� � � 𢅛� 湔鰵shopee� � 𪆓Chrome � 臬𢆡/� 餃� 璉� 瘚卝� � 𪈠AI璅∪� 瘚贝� 餈墧𦻖� 亙� `run_logs/run_log_events` 銝擧𧋦� 啗� � 讛� � 剜𠯫敹梹� `app/excel.py` 撌脣� � 啣� Excel 颲枏� � 𡑒圾� 僐� � 㟲� � 辣� 埈嵗撉䎚� � � 銵𣬚� 霈∟歲餈� � � 紡� 交鸌甈∩� 隞餃𦛚� 亙� � � � � 滚龪� 滨� 霈~� � 唂� � � /� 批� � Z楝敺� � � 坔� Excel� � 凒� 啁� � 𨅯� � 坔� Excel 銝𤾸𡖂摮睃� � 穿� `app/config.py` 撌脣� � 啗揭� � slug 銝� user-data-dir � 𥕦遣嚗𢱌app/accounts.py` 撌脣� � 啗揭� � CRUD � 滚𦛚� � 垢� � � 霈文� � 溻� � 鍳� 函蒈敶𨰻� � � 瘚讠蒈敶𨰻� � � � 𣂼翰� 瑟䲮撘𧶏� ` app/chrome.py` 撌脣� � � Chrome � � 㺭� 潸� � � 鍳� 具� � DP 蝡臬藁� X � � � owerShell ` .lnk` 敹急㭘� 孵� � � � 嚗𢱌app/gui.py` 撌脣� � � PySide6 `MainWindow` � � � Tab� � ▲� � Tab � 誯俈霂舐� � 瑕� � � � 銝� 霂凋� � 脫踎� � � � ﹦𢅛隞餃𦛚� 嗆� � � � 齿艶� 脯� � 𢅛� � � 憪𧢲凒� 啜� 懏arning � 讛器/� � � � 脣� � 惩紡� 交嵗撉峕㺭摮埈� 蝥U� � 𪆓� 餃� � 嗆� � � 銝𡃏𠧧� � 𢅛� 湔鰵shopee Tab warning 撠誩� � 孵� � 𣳇膄蝐餅� � � danger � 瑕� � � � 撖澆� � � � � � Excel 撖澆� � 厰僼/撖澆� 瘙� � 餅� /� 寞活蝑偦� 劐� � 𣳇膄� 寞活頧臬� � 文� � � /QTableView 隞餃𦛚� 𡑒”/� 芸龪� 滨� � 劐� � 亥� � � 扇/� � � � 扳� 憸䀹唂撠� 𢒰 worker/� � � � 滩揭� 瑕停蝏芷� 璉� 銝𢛶𪆓撘訫紡/� � � 摰峕� � 芸𢆡� 𧼮� /� 扳㺭� 桀� � 䠷� 霂閙� � 桐� worker/�
- 瘚贝� 嚗䫤tests/` 撌脣遣蝡页� T-006 � 𡒊滲� 餉� � 孵𢆡敹� ◆餈鞱� ` python -m unittest discover -s tests`嚗� � � 滩� � � appconfig/db/config/accounts/chrome � 臬𢆡銝𤾸翰� 瑟䲮撘� /editor � 餃� 璉� 瘚衤� � � � tab � 笔𦶢� 冽� � � 凒� 唳� � 笔� � 喲𡡒� 祈蔭� 啣� tab� � 凒� 啣� � W� 隞賜撩憭梢獈� � /8撘牐� 9撘惩� � 删洵銝� 撘� /� 𣳇膄蝖株恕/銝𠹺� � 亙藁� 嘥� 銝滚虾� � /� 滚� � 曄� toast/� 拇� � 躰秤銝漤獈� 凋� 隡� /� 惩㦛� 𡒊迅摰𡁶� 敺� /銝𠹺� � 嗆� � � � � /� 㚚� 雿� mock 頝臬� /Shopee � 湔鰵蝖株恕獢� � � � � 蠘歲� 𧼮� � � � 銵典� 畾讠� � 躰秤 toast 銝滩� � 𡝗� � � mock 頝臬� /excel 撖澆� /� 批� 畾萎� � 湔鰵蝏𤘪� � 𧼮� /ai � � � 銝𤾸� � � HTTP 閫� � /` generate_batch` 甇� 虜� � 仃韐乩� � 𨀣迫/prompts 霂餃� 銝擧葡� � /gui � � 撖澆� � � � � � � � 斗鸌甈∟蔓� 𣳇膄銝𡡞� � � � � 剜𠯫敹� /gui � � AI� � � 撣� � 銝擧鸌甈� /摨烾唍/� � � ID/� 嗆� � � � 剹� � � 蝷箄� 蝞∠� � � � � � worker� � 㦛� � 仃韐亥� � 剜𠯫敹𨰜� � � � 駁� 閫� � � � 蝵桃� � 鞟� � 靝� � 唳� 憸䀹𧋦� 啁� 颲� /gui � � � 湔鰵shopee� 寞活/摨烾唍/� � � ID/� 嗆� � � � 匧� 銵具� � &霈文撕蝒𨰜� � � 憪𧢲凒� 唬蜓� 厰僼� � � 蝵格凒� 啁𠶖� � 𢰧� 株� � 𨰻� � hopee � 湔鰵摰匧� � 行⏛銝𤾸� 敺� 霈曄蔭� � ApplyWorker` 銝脰� /璉� � � /� � 鸌/� 㕑揭� 瑕僎銵� /蝡臬藁� 脩� 憸� � � � � 銵峕𠯫敹𨰜� � � � 𨅯� � 嗘� 瘙� � � /gui � � 韐血噡蝞∠� � � � � � � � � � � 擧� 靽嘥� � 鞟內/gui � � AI 璅∪� 蝞∠� � � PI Key � 梶� 銝擧� � � � 摮䀹� 蝷箝� � � � � /� � � � � 㺭霈曄蔭� � hopee � 湔鰵摰匧� 霈曄蔭� � � � 交� � � /瘥𤩺鸌� � 憭扳凒� 唳辺� � /憭朞揭� 瑕僎銵諹挽蝵柴� � � 霂訫� � � ID � 𣂼� 蝘駁膄/worker signal 銝𡒊瑪蝔见� 鋆� � � -505 � 冽� 蝔贝� � 剜𠯫敹梹� import/write_back/apply/chrome_launch/login_check/ai_model_test嚗劐� � 砍𧑐� 亙� � 望� � � ui T-511 霂凋� � 脫踎� 䔶遙� ∠𠶖� � � � 齿艶� 脯� � -512 擃㗛� � 拇� � 桐� 撖澆� � ⊿� � 啣� � 瑕� � � -513 � 餃� � 嗆� � /Tab � � � /� 𣳇膄� 厰僼� 瑕� 嚗� 2026-07-01 撌脣� � � 5 銝芰� 摰𧼮� � � � T-404 � 湔鰵撉峕𤣰嚗� � 蝏� CDP/Shopee � 孵𢆡隞漤� 瘚贝� � � � � 见𢆡撉諹� � �
2026-06-29 17:49:45 +08:00
- � 唳旿嚗䫤config.json`� � config/ai_models.json` � � cmshopee.db`� � cmshopee.db-*` � � chrome_user_data_dir/`� � images/` � � logs/` 撌脩眏 ` .gitignore` � 㘾膄嚗𥕦� � � � API Key � 砍𧑐� 擧� 靽嘥� 雿� � 摮� /� 䀹凒� 嗆� 蝷綽� UI � 梶� 嚗峕𠯫敹� /撖澆枂敹� ◆� 望� 嚗𥡝� � 亙‵� 坔� � � Excel 銝𡁜𦛚� � 辣暺䁅恕敹賜裦嚗峕� � � 征璅⊥踎 ` shopee敺� � � � 遙� ⊥芋� � .xlsx` � 舀� 鈭歹� ` app/appconfig.py` 擐𡝗活霂餃� 蝻箏仃� � ` config.json` � 嗡� � 冽𧋦� 啣� 暺䁅恕� 滨蔭嚗䈣app/db.py` 靚� 鍂 `init_db()` � 嗡� � 冽𧋦� 啣� 撱� SQLite DB� �
2026-06-26 15:30:37 +08:00
## � W� 霈曇恣閬� � 嚗� � 獢� 歇摰𡄯�
2026-06-26 16:09:09 +08:00
- GUI嚗� **PySide6 5 Tab 瘚� 偌蝥� **嚗屸◇摨� � � 撖澆� � � � � � � � AI� � � � � � � � 湔鰵shopee � � � � 韐血噡蝞∠� � � � � 霈曄蔭嚗𥕦� � 唬遙� ∠鍂 worker/QThread/signal� �
2026-06-26 15:55:28 +08:00
- 瘚� 偌蝥輸𧫴畾蛛� imported � � collected嚗� � � � 唂� � � /� 批� � � +銝贝蝸+� 𧼮� 嚗争� generated嚗㇁I � 鞟內霂滨� � 鞉鰵� � � /� 啣� � g� � � applied嚗� 𢅛 撘寧� � 寥� 蝖株恕� 擧㺿 Shopee 撟嗆� 鈭歹� � � **� � confirmed� � � 撣賊彿� 𣂷漱撘� � 喋� � **
2026-06-29 10:05:16 +08:00
- 摮睃� 嚗䫤config.json`嚗� � � 刻挽蝵殷� + ` config/ai_models.json`嚗㇁I 璅∪� 皜� � 銝擧𧋦� 唳� � � Key嚗� + SQLite ` cmshopee.db`嚗� 揭� � /隞餃𦛚/� � 𧫴畾萇� � 頣� 撖� � � 砍𧑐� 擧� 隞� � � � � + openpyxl嚗𠄌xcel嚗� + � 砍𧑐 ` images/`嚗� 唂/� 啣� � g � 嚗𥕦� � � /API Key 靽嘥� � 硋� � 湔𧒄� 鞟內嚗� � 蝷箏� � 亙� /撖澆枂敹� ◆� 望� � �
2026-06-26 15:30:37 +08:00
- 憭朞揭� 琿� 蝳鳴� 瘥讛揭� 瑞𡠺蝡� user-data-dir嚗� � profile嚗剹� �
- 韐血噡� 𥪯遙� ∠� 摰𡄯� 隞� Excel� 𨅯� � 𨧀� 嘥� 銝箸� 憡� � � 芸龪� 滨裦餈� � 蝏𤘪� 撘寧� 瘙� � 颯� �
2026-07-01 14:30:49 +08:00
- � 扯� 嚗𡁻� 霈文� 韐血噡銝脰� � � � � ∪仃韐亦誧蝏哨� � � � 𣂷� � 峕� � 交𧋦頧格凒� 啜� 齿� � 殷� 璉� � 亙蘨� 躰� 銵峕𠯫敹堒� 瘙� � 鳴� 銝齿� 撘� Shopee� � � � 𣂷漱蝥蹂� � � � � 嫣遙� ∠𠶖� � � � � � 臬� � 臬� 韐血噡撟嗉� 嚗� � � 諹揭� 瑕僎銵䎚� � � 韐血噡� � 葡銵䕘� 撟嗉挽蝵格� � 寞� 憭扳凒� 唳辺� 啜� � 𢅛 � 孵稬� � � 憪𧢲凒� 啜� 滚� � � � � 笔� � 湔鰵摰匧� 霈曄蔭撘寧� 蝖株恕敶枏� 蝑偦� 㕑� � 氬� � 遙� ⊥㺭� 譌� � � � 孵之撠誩� 憸� 恣� 寞活嚗𤤿&霈文� � 𡁏𧋦頧株揭� � Chrome/CDP/� 餃� � � � 璉� 嚗峕𧊋� 臬𢆡� 𡝗𧊋� 餃� � 坔撕蝒堒� � 箄揭� 瑕僎銝剜迫� � � � 芸𢆡� 枏� Chrome嚗𥡝揭� 瑕停蝏芸� � 㗇鸌� 鞉辺� 嫘� 峕凒� 啜� 齿� 鈭斤瑪銝𠺪� � 孵稬� 𨀣迫� 𦒘� � 滚� 憪衤� 銝� � ⊥� 銝衤� � 嫘� �
2026-06-27 15:47:21 +08:00
- AI嚗𡁏� � ∪ � /璅∪� /Key � � `config/ai_models.json` � 滨蔭嚗𢱌app/ai.py` � 舀� chat JSON 銝� images_edits multipart嚗𤤿� � 𣂼� 摰寧凒� 亦鍂鈭擧凒� 堆� � 砍𧑐� 蹱﹝+� 𧼮� Excel 靘𥡝蕭皞胯� �
2026-07-01 08:35:46 +08:00
- � 餃� 嚗帋犖撌亦蒈敶� + 蝔见� 璉� 瘚页� 銝滩䌊� 函蒈敶𤏪� � � � � 鍳� 函蒈敶𨰻� 滚蘨� 舀� 撘� 撖孵� 韐血噡瘚讛� � 其� 鈭箏極� 餃� 嚗𢞖𪆓� 峕� 瘚讠蒈敶𨰻� 滚� � � /� a� 璉� � 芷� 霂� 蒈敶閙� � � � � Shopee tab � 嗆� 瘚见� � � 蛹 `https://<region_host>/` 嚗� � 霈� `https://seller.shopee.tw/` 嚗㚁� 擐𡝗活� 芷� 韐血噡� � 笆摨磰揭� � Chrome � 芸鍳� 冽� � 芰蒈敶閙𧒄嚗𢞖� � � 摨𠉛� � 冽� � 扯� � 漤� 璉� � 鞟內嚗� 僎撘訫紡� 領𪆓嚗𢞖𢅛 銝漤� 暺睃鍳� 函撩憭梯揭� � Chrome� �
2026-06-26 15:30:37 +08:00
## 敶枏� � 桀� 閬� �
| 頝臬� | � 嗆� � | 霂湔� |
| --- | --- | --- |
| `docs/` | 撌脫� | � � harness coding � � ﹝� � � |
2026-06-27 16:39:12 +08:00
| `app/cdp.py` | 撌脫� | CDP 摨訫漣嚗朞� � � /� � tab/撘� tab/� 喲𡡒 target/� 扯� JS/� 𡝗嗻嚗𢱌CDP.close()` � 芣鱏撘� WebSocket嚗䈣close_tab()` � 滚� � 剜� 閫� 膥憿菟𢒰 |
2026-06-27 09:02:05 +08:00
| `prototypes/` | 撌脫� | 撌脤� 霂� � � � /� X䰻� 𡁏𧋦嚗Ê̌emo/set_title/set_cover/get_title/cookies/inspect_images/grab/1.py嚗㚁� 靽萘� 雿靝犖撌亙� 敶雴� � X䰻� � � � � 閫� `prototypes/README.md` |
2026-06-26 15:30:37 +08:00
| `chrome-remote-debug-lan.md` | 撌脫� | WSL� 䁗indows CDP 頧砍� � 埝䰻霈啣� |
2026-06-29 10:37:27 +08:00
| `docs/troubleshooting.md` | 撌脫� | 撣貉� � 桅� � 埝䰻嚗𥕦歇霈啣� `config/ai_models.json` 蝻箏仃 `category` 撖潸稲 GUI � 臬𢆡� � � 𦯷I 璅∪� category 敹� ◆� � text � � image� � � � � � 𨬭� � 耨憭滚� 撉諹� 甇仿炊 |
2026-06-26 17:24:23 +08:00
| `app/__init__.py` / `app/__main__.py` / `main.py` | 撌脫� | 甇� � � � � � 臬𢆡� 亙藁嚗𢱌python main.py` / ` python -m app` � 航� 銵� � 雿滚� � � |
2026-07-02 09:06:52 +08:00
| ` app/gui.py` | 撌脫� | T-104/T-105/T-106/T-202/T-202b/T-203/T-204/T-204b/T-205/T-206/T-207/T-302/T-302p/T-303/T-303b/T-401/T-402/T-403/T-404a/T-501/T-501b/T-501c/T-503/T-504/T-506/T-507/T-508/T-509/T-510/T-505/T-511/T-512/T-513 鈭批枂嚗䥪ySide6 ` QMainWindow` + 鈭� Tab嚗偦▲� � Tab � 誯俈霂舐� � 瑕� 嚗𤤿� 銝� 霂凋� � 脫踎� � � � ﹦𢅛� 嗆� � � � 齿艶� 脯� � 𢅛撘� 憪𧢲凒� � warning � 瑕� � � � 撖澆� � ⊿� � 啣� � � 滯� � 𪆓� 餃� � 嗆� � � � � 𢅛Tab warning 撠誩� � 孵� � 𣳇膄� 厰僼 danger � 瑕� 嚗𥕞� 撖澆� � � � 撖澆� � 厰僼� � 紡� 交� � 餅� � � 鸌甈∠� � 剹� � � � 斗鸌甈∟蔓� 𣳇膄� 厰僼� � QTableView` 隞餃𦛚� 𡑒”� � 𧊋� 寥� 蝑偦� 劐� � 亥� � � 扇� � � � � 唂� � � � 批� � � worker嚗� 唂撠� 𢒰頝臬� � 㗇鸌甈� /摨烾唍/隞餃𦛚蝏� � 嚗剹� � � � � � 韐血噡撠梁貌憸� � 銝𢛶𪆓撘訫紡� � � � � � � 鞱䌊� 典� � 嗘� � 见𢆡� 滩� � � � � � � 銵峕𠯫敹𡑒� � 橘� � � AI� � � 撌血𢰧撣� � � � � 蝷箄� 蝞∠� � � 鸌甈� /摨烾唍/� � � ID/� 嗆� � � � 㗇� � � 遙� ∪� 銵具� � 鰵� � � � 埈𧋦� 啁� 颲㻫� � � 憪讠� � � /� 𨀣迫/餈𥕦漲� � � � 餅鰵� 批� � a� 閫� � � I� � � 餈鞱� � 亙� � � � 蝵桃� � 鞟� � 靝� `GenerateWorker` 嚗𥕞𢅛 � 湔鰵shopee� 寞活/摨烾唍/� � � ID/� 嗆� � � � 㗇� � � 遙� ∪� 銵具� � � 憪𧢲凒� 唬蜓� 厰僼� � � 蝵格凒� 啁𠶖� � 𢰧� 株� � 𨰻� � hopee � 湔鰵摰匧� � 行⏛銝汿� � � 敺� 霈曄蔭� 滩歲頧研� � � 峕� � 交𧋦頧格凒� 啜� 齿� � 柴� � � 憪𧢲凒� 啁&霈文撕蝒𨰜� � ApplyWorker` 璉� � � /� � 鸌銝脰� /� 㕑揭� 瑕僎銵䎚� � 揭� 瑚� 蝡臬藁憸� � � � � 銵峕𠯫敹𨰜� � � 鞉辺 ` set_applied`� � 䌊� 典� � 嗵� � 𨅯� Excel� � � � � � � 餃撕蝒𦯀� � 见𢆡� 𧼮� � 滩� 嚗𥕞𪆓 韐血噡蝞∠� 銵冽聢� � 揭� 瑕撕蝒𨰜� � � � � 𧋦� 唳� � � � 摮䀹� 蝷箝� � 鍳� 函蒈敶𨰻� � � 瘚讠蒈敶𨰻� � 翰� 瑟䲮撘𧶏� � � 霈曄蔭 AI 璅∪� 銝𧢲� � � 鰵憓� /� 𣳇膄� � 祕� � � 颲㻫� � � � 交� � � � � 砍𧑐� 擧� 靽嘥� � 鞟內� � � 霂閗� � � worker� � � 霈方� � 脖� � 剹� � � � 𣂼� � 啜� � 楝敺� 垢� � � 蝵柴� � � � � Shopee � 湔鰵摰匧� 銝擧� 銵峕芋撘讛挽蝵殷� dry_run � 冽� � 亙藁� 嫣蛹� X� � 交� � 殷� 瘚贝� � � � ID � 桅� 𡁜� � � 歇� 鞱� 銝𥪯� � 漤獈� 剜迤撘𤩺凒� � |
2026-06-27 10:05:29 +08:00
| ` app/workers.py` | 撌脫� | T-104b 鈭批枂嚗䫤BaseWorker` + � 𡁶鍂 signals + � 𡝗� � � 扇 + `run_worker()` QThread � � � |
2026-06-27 10:38:21 +08:00
| `app/accounts.py` | 撌脫� | T-105/T-106 鈭批枂嚗朞揭� � CRUD � 滚𦛚� � 𤌍敶訫� 撱箝� � 垢� � � � 溻� � 鍳� 函蒈敶𨰻� � � 瘚讠蒈敶𨰻� � 翰� 瑟䲮撘� |
2026-07-01 15:32:27 +08:00
| `app/editor.py` | 撌脫� | T-001/T-103/T-205b/T-207/T-501c/T-502 + T-404 銵乩� 鈭批枂嚗𡁶蒈敶閧𠶖� � � 瘚卝� � � 撘� � � � 憿萸� � 粉/� 蹱� 憸塩� � 粉/銝贝蝸撠� 𢒰� � � � � 郊撉文� 靚� � � 凒� 唳郊撉文� 靚� � � � � � � � 喲𡡒� 芸𢆡� 啣遣� � � 憿� tab� � � 隡惩� 蝑匧� � 曄� 蝞∠� � 函迅摰𠾼� � � � 颱� 隡惩� � 擧釣� 交� 隞嗅僎璉� 瘚� CDN � 擧� 撠� 𢒰� � 凒� 啣� � Y� 銝� � � 嵗撉峕唂撠� 𢒰憭� 遢� 滚� 蝥蹂� 蝚砌� 撘𨬭� � � 憭滚㦛� � toast � 𡒊&憭梯揖� � △� V蜓� 湔鰵� 厰僼� � hopee 蝡嗵� 靘抒&霈斗� 銝餅� � 柴� � pply_task嚗𥟇凒� 唳� � 笔� � 舀� 霈曄蔭� 喲𡡒� 祈蔭� 芸𢆡� 啣遣� � � 憿� |
2026-06-29 10:25:09 +08:00
| `app/appconfig.py` | 撌脫� | T-002/T-501c/T-503/T-504 鈭批枂嚗䫤config.json` 暺䁅恕� 潦� � 粉� 踺� � 凒� 啜� � 楝敺� /蝡臬藁/AI � � 㺭霂餃� � � hopee � 湔鰵摰匧� 銝� dry-run/憭朞揭� 瑕僎銵屸� 霈文� 潘� � 垍� � 𤩺� 摮埈挾� 坔� 嚗𥟇� 靘𥟇� � 笔� 潭� � � � � � � � � � 亙� � 望� 銝舘䌊� 望� � 祆𤜯� W極� � |
2026-07-01 15:32:27 +08:00
| ` app/diagnostics.py` | 撌脫� | T-207 + AI� � � 霂𦠜鱏銵乩� + T-505 鈭批枂嚗𡁏𧋦� � ` logs/cmshopee.log` 霂𦠜鱏� 亙� � � 之撠𤩺� � 具� � � 撣貊掩� � /traceback/step/� 埈𧒄霈啣� 嚗𣬚� � � � payload � 諹䌊� 望� � 祈� � 誩� � 坔� |
2026-07-01 08:35:46 +08:00
| ` app/ai.py` | 撌脫� | T-301/T-303 + AI� � � 霂𦠜鱏銵乩� 鈭批枂嚗䫤gen_title()` /`gen_cover()` /`generate_batch()` 嚗𥡝粉� 㚚� 霈斗芋� 页� � 𡁶鍂 HTTP 靚� 鍂嚗𥕦仃韐仿� 霂𤏪� � 躰秤� 望� 嚗𥟇� 憸� /撠� 𢒰甇仿炊蝥批� 靚� � 撠� 𢒰� � resolution/jpg_quality 靽嘥� 撟嗆� � 寞活/摨烾唍/隞餃𦛚頝臬� � 賜� 嚗𥟇鸌� 讐� � 𣂼� � � � � 𤾸� � U� � � 摨血� 靚� � � � 鞉辺� 賢� � � 仃韐交� 霈啜� � � 隞� /� 躰秤� 噼� � � � 甇W� 瘨� 𧊋撘� 憪钅★ |
2026-06-27 16:10:50 +08:00
| `app/prompts.py` | 撌脫� | T-302p 鈭批枂嚗𡁏� 憸䀹� 蝷箄� 霂餃� � � � � X芋� 踹� 銵� /霂餃� /靽嘥� /� 滚𦶢� � /� 𣳇膄� � � � 𤩺𤜯� � |
2026-07-01 14:30:49 +08:00
| `app/db.py` | 撌脫� | T-003/T-206/T-404a/T-504/T-509 鈭批枂嚗颹atches/accounts/tasks schema嚗𢲈atches 頧臬� � 文� 畾萎� 暺䁅恕銝𡁜𦛚� 亥砭餈� 誘嚗暿un_logs/run_log_events嚗𢫕AL/busy_timeout/foreign_keys嚗𥡝揭� � /� 寞活/隞餃𦛚銝� set_* � 嗆挾� 坔� 嚗𤤿� � 鞟� � � /� 湔鰵� 嗆� � 𧋦� 圈� 蝵殷� `update_generated_title()` � 砍𧑐� 唳� 憸睃凝靚� � 餈鞱� � 亙� � 坔� 銝擧䰻霂� |
2026-06-27 09:21:33 +08:00
| `app/config.py` | 撌脫� | T-101 鈭批枂嚗𡁜� � 𨧀� 蝔喳� slug嚗𥕦� 撱箏僎餈𥪜� 蝏嘥笆 user-data-dir |
2026-07-01 08:35:46 +08:00
| `app/image_paths.py` | 撌脫� | � 砍𧑐� 曄� 頝臬� helper嚗𡁏鰵� � � � 批� � W� � 啁� � 𣂼� � Y� 銝� � 坔� `images/<batch_id>/<slug>/<task_id>_<item_id>_old/new.jpg` 嚗𥕦� � � DB 撌脣� 頝臬� 蝏抒賒� 匧� 頝臬� 霂餃� |
2026-06-27 10:38:21 +08:00
| `app/chrome.py` | 撌脫� | T-102/T-106 鈭批枂嚗鋴hrome � 臬𢆡� � 㺭� � subprocess.Popen` � 臬𢆡� � /json/version` 蝡臬藁� X � � � owerShell `.lnk` 敹急㭘� 孵� |
2026-07-02 09:06:52 +08:00
| `tests/` | 撌脫� | T-006/T-201/T-202/T-202b/T-203/T-204/T-204b/T-205/T-206/T-207/T-301/T-302/T-302p/T-303/T-303b/T-401/T-402/T-403/T-501/T-501b/T-501c/T-502/T-503/T-504/T-506/T-507/T-508/T-509/T-510/T-505/T-511/T-512/T-513 鈭批枂嚗窃tdlib unittest � 箏漣嚗𥡝� � � appconfig/db/config/accounts/chrome/editor/excel/ai/image_paths/prompts/gui/workers |
2026-06-27 17:28:33 +08:00
| `app/excel.py` | 撌脫� | T-201/T-204/T-403 鈭批枂嚗𡁜� � � 辣 Excel 颲枏� � 𡑒圾� 僐� � � � � � 埈㟲� � 辣� 垍� � � � 銵屸� 鞱� 頝唾� � � 鸌甈� /隞餃𦛚� 亙� � � 龪� 滨� 霈∴� � 㗇� � � 辣/撌乩� 銵� /銵� 噡� 𧼮� � 扳� 憸䀝� � 批� � Z楝敺� � � 㗇� � � 辣/撌乩� 銵� /銵� 噡� 𧼮� � 唳� 憸塩� � 鰵撠� 𢒰頝臬� � � 凒� 啁𠶖� � � � 舀� � � � 隞嗉◤� 删鍂� 嗅𡖂摮睃� � � |
2026-06-27 15:47:21 +08:00
| `shopee敺� � � � 遙� ⊥芋� � .xlsx` | 撌脫� 嚗� 歇� 𣂷漱 | � � � 蝛� Excel 璅⊥踎嚗𥕦� 撌乩� 銵� `敺� � � � 遙� ︶嚗諹”憭� ` 韐血噡� � | � 怠� | � � � id | � 扳� 憸� | � 批� � W㦛� � 楝敺� | � 唳� 憸� | � 啣� � W㦛� � 楝敺� | � 湔鰵� 嗆� � 嚗𥡝� � 亙� � 嗅� 憛怠� 嚗� ‵� 坔� � 砌� � 𣂷漱 |
2026-06-29 17:49:45 +08:00
| `config.json` / `config/ai_models.json` / `cmshopee.db` / `cmshopee.db-*` / `chrome_user_data_dir/` / `images/` / `logs/` | � 砍𧑐摮睃銁� 𡝗� � � � � � 嚗� 歇敹賜裦 | � 恍� 蝵柴� � � � 乓� � � � ~� � 蒈敶閙� � � � 㦛� � � � 𧋦� 啗� � 剜𠯫敹梹� 銝齿� 鈭斤� � 砍� 嚗𥕦� � � /API Key 靽嘥� � 硋� � 湔𧒄� 鞟內嚗� � 蝷� /� 亙� /撖澆枂� 望� |
2026-06-26 15:30:37 +08:00
## 撌脤� 霂� � � 𨥈� � 閗揭� 瘀�
- CDP 餈墧𦻖 Chrome� � � � � tab� � 粉� � shopee.tw Cookie� �
- � 曉� /� 啣遣� � � 霂行� 憿� tab嚗𣬚� 蝻𤥁� � 典停蝏芥� �
- � 寞� 憸矋� � 毺� setter + 瘣曉� 鈭衤辣嚗䈣value` 銝� ` modelvalue` � 𣬚� 鈭擧鰵� 潦� �
2026-06-26 18:02:57 +08:00
- � W � � g � `setFileInputFiles` 銝𠹺� 嚗Ǒ.shopee-image-manager__upload input[type=file]`嚗争� 蝑� CDN � 暹𦻖 � � 蝑� 1 蝘� � � ` Input.dispatchMouseEvent` � 硋� 蝚砌� 雿㵪� � 賜� ` first.left - 0.30*w`嚗㚁� 雿輻鍂 ` 1_TY030.jpg` � 冽� 霂訫� � � � 霂� � 朞� � �
2026-07-01 08:35:46 +08:00
- � 峕凒� 啜� 齿� � 殷� � 舐� � 滨� 嚗𣬚� � 冽� � � � 恬� � � � 芣鸌� 讐&霈文� 銝齿� 鈭扎� � 2026-06-29 瘚贝� � � � 摰墧� 嚗𡁻△� V蜓� 峕凒� 啜� 滚� 隡𡁜枂� � Shopee 蝡嗵� 靘抒&霈斗� `.eds-modal__content` / `.eds-modal__box` 嚗峕� 憸� `蝣箏� � 刻� � 湔鰵� � � � � ?` 嚗� � � � `蝡见朖� 芸� ` / 銝餅� � � `� 湔鰵` 嚗� 2026-06-30 � 冽� 憭滩� 蝖株恕� 孵稬撘寧� 銝餅� � 桀� � 𣂷漱� 𣂼� 嚗� 僎頝喳� `https://seller.shopee.tw/portal/product/list/all?operationSortBy=modified_time` 嚗䔶誨� � 歇霈啣� 霂亥歲頧祉� � 頣� � 亥挽蝵桀� � 臭� 霂� tab � 舀𧋦頧株䌊� 冽鰵撘� 嚗� � � 剖� 蝑匧� 2 蝘鉝� �
2026-06-27 15:47:21 +08:00
- Tab� � � � 㦤� 垍� 嚗� 2026-06-27嚗㚁� 韐血噡 `papa` 嚗� 紡� 乩葩� � Excel 5 銵䕘� � � � 5 � ⊥唂� � � /� 批� � g� 銝贝蝸 5 撘䭾唂撠� 𢒰撟嗅� � 嗘葩� � Excel � 𣂼� � �
2026-06-26 15:30:37 +08:00
## 隞餃𦛚� 𧢲踎� 嗆� �
隞餃𦛚� 嗆� � 誑 [`06-tasks.md` ](06-tasks.md ) 銝箏� 嚗� � � 脰扇敶閗� [`../progress.md` ](../progress.md )� �
2026-07-02 09:06:52 +08:00
- 撌脣� � 琜� T-000嚗� 迤撘譍誨� � � 蝏𤘪� 嚗剹� � -001嚗Ǒapp/editor.py` 璅∪� � 吔� � � -002嚗Ǒapp/appconfig.py` + `config.json` 嚗剹� � -003嚗𠄎QLite 撱箄”嚗剹� � -004嚗� 𧋦� 唳㺭� � gitignore嚗剹� � -005嚗㇁I 璅∪� 皜� � � 𡒊垢嚗剹� � -006嚗� � � � � 霂訫抅摨改� � � -101嚗� 揭� � slug/user-data-dir嚗剹� � -102嚗㇃hrome � 臬𢆡� 剁� � � -103嚗� 蒈敶蓥� 瘣颱� 璉� 瘚页� � � -104嚗㇊ySide6 鈭� Tab 銝餌� � � 爸� 塚� � � -104b嚗㇊ySide6 worker � 箏漣嚗剹� � -105嚗㇍ab� � 韐血噡蝞∠� 嚗剹� � -106嚗� 揭� 瑕翰� 瑟䲮撘𧶏� � � -201嚗𠄌xcel 撖澆� 嚗朞圾� 𣂼� � � 辣颲枏� � 堒� 摨橒� � � -202嚗㇍ab� � 隞餃𦛚� 𡑒” + 撖澆� � 厰僼 + � 怠� � 寥� � � 扇嚗剹� � -202b嚗㇍ab� � 撖澆� 瘙� � 餅� 嚗剹� � -203嚗� � � � 唂� � � +� 批� � g� � � -204嚗� � � 蹱唂摮埈挾� 啣� Excel嚗剹� � -204b嚗� � � � � � 鞱䌊� 典� � 蹱唂摮埈挾嚗剹� � -205嚗� � 甈⊥𧊋� 滩揭� � / Chrome � 芸鍳� � / � 芰蒈敶訫� 撖潔� � 歹� � � -205b嚗� � � � � � 喲𡡒� 芸𢆡� 啣遣� � � 憿� tab嚗剹� � -206嚗㇍ab� � � 𣳇膄� � � � 寞活頧臬� � 歹� � � -301嚗㇁I � � � � 亙藁嚗剹� � -302嚗㇍ab� � 撌血𢰧撣� � 銝𦒘遙� ∪� 銵剁� � � -302p嚗� � 蝷箄� 蝞∠� 嚗剹� � -303嚗㇍ab� � 撘� 憪讠� � � + � 𨀣迫 + 餈𥕦漲嚗剹� � -303b嚗� 鷄/� � � � � ID蝑偦� 㚁� � � -401嚗㇍ab� � � 湔鰵� 𡑒”蝑偦� � + 撘� 憪𧢲凒� 啁&霈文撕蝒梹� � � -402嚗㇍ab� � 蝖株恕� 𦒘葡銵峕凒� 堆� � � -403嚗㇍ab� � 蝏𤘪� � 𧼮� 銝𡒊� � � � � 鳴� � � -501嚗㇍ab� � AI 璅∪� 蝞∠� UI嚗剹� � -501b嚗㇍ab� � 閫坿𠧧銝𡒊� � 𣂼� � 堆� � � -501c嚗㇍ab� � Shopee � 湔鰵摰匧� 撘� � 喉� � � -502嚗� 揢撠� 𢒰� 删洵銝� 撘惩� 銝𠹺� 嚗剹� � -503嚗� � � 煺縑� 舀𧋦� 唳� � � � 摮䀹� 蝷箔� � 亙� � 望� 嚗剹� � -504嚗� � 韐血噡撟嗉� / dry-run / 餈鞱� � 亙� 嚗剹� � -207嚗� � � � � 霂𦠜鱏� 亙� 嚗剹� � 鷄 AI� � � � 曄� 憭梯揖霂𦠜鱏� 亙� 銵乩� � � -404a嚗� 鷄/� � � 劐葉霈啣� � 滨蔭嚗剹� � -404嚗� � 摰� Shopee � 閙辺� 湔鰵� 垍� 撉峕𤣰嚗剹� � -506嚗� 迤撘譍蝙� 冽鸌� 𤩺凒� 唬� 撉䕘� � � -507嚗� 迤撘𤩺鸌� 𤩺凒� 堆� 蝘駁膄� 桅� 𡁏� 蝔𧢲� 霂訫� � � ID � 𣂼� 嚗剹� � -508嚗� 𢅛 � 湔鰵shopee� 煺漣� 𡝗� 雿𨅯躹嚗剹� � -509嚗� 鷄 � 唳� 憸䀝犖撌亙凝靚� � � � -510嚗� 𢅛 璉� � 交𧋦頧格凒� 唳� 獢� � 銝� 嚗剹� � -505嚗� � 瘚� � 霂𦠜鱏� 亙� � 拙� 嚗剹� � -511嚗� 祗銋㕑𠧧� � + � 罱鷄� V遙� ∠𠶖� � � 銝𡃏𠧧嚗剹� � -512嚗� 𢅛擃㗛� � 拇� � 桐� � � + � 惩紡� 交嵗撉峕㺭摮埈� 蝥g� � � -513嚗� 蒈敶閧� / � ㎡ab� 梢埯� � � / � 游� � 扳� � 桐� � 莎� � �
- 銝衤� 銝芸虾憸� � 隞餃𦛚嚗関-514嚗� � � ﹦𢅛 擐𡝗活蝛箇𠶖� � � 撖澆㨃� � � � �
2026-06-27 14:37:58 +08:00
2026-06-27 15:00:15 +08:00
## 敶枏� 撌脩䰻� 𣂼�
2026-06-27 14:37:58 +08:00
2026-07-01 15:32:27 +08:00
- T-505 撌脣� � 琜� � 𣳇� � � � � 鷄AI� � � � � xcel 撖澆� /� 𧼮� � � 𢅛� 湔鰵shopee� � 𪆓Chrome � 臬𢆡/� 餃� 璉� 瘚卝� � 𪈠AI璅∪� 瘚贝� 餈墧𦻖� � 歇� 亙� 銝𡁜𦛚� 航粉 `run_logs/run_log_events` 嚗𥕦� 撣貉楝敺� � � 砍𧑐 `logs/cmshopee.log` � 望� traceback嚗䔶� � ⊥𠯫敹𦯀� 霈啣� Cookie� � � � � � � PI Key� � oken� �
2026-06-29 17:49:45 +08:00
2026-07-01 08:35:46 +08:00
- � � � � � � 𢞖𢅛� 笔� � 湔鰵� 賭� 韏硋笆摨磰揭� � Chrome 撌脩鍂銝枏� user-data-dir � � CDP 蝡臬藁� 臬𢆡撟嗥蒈敶𤏪� T-205/T-402 撌脣銁� 扯� � 齿㜃� 芣𧊋� 滨蔭韐血噡� � hrome � 芸鍳� 具� � DP 蝡臬藁銝滚虾霈輸䔮� � 𧊋� 餃� 嚗� 僎撘訫紡� 領𪆓韐血噡蝞∠� � � 𢅛 � 孵稬� � � 憪𧢲凒� 啜� 滚� � 交𧋦頧桅� 閬� 揭� 瑟𧊋撠梁貌嚗� � 憿颱葉甇X𧋦頧格凒� 堆� 銝滩䌊� 冽� 撘� 韐血噡 Chrome� � � � 𣂷漱隞颱� � � � � �
2026-06-29 09:18:03 +08:00
- T-501/T-501b/T-501c 撌脣� � � `config/ai_models.json` 璅∪� 皜� � UI嚗䔶誑� � `config.json` � 𣬚� � � � /� 曄� 暺䁅恕璅∪� 閫坿𠧧� � 僎� 㻫� � � 霂𨰻� � � 颲函� � � pg 韐券� � � 楝敺� /蝡臬藁霈曄蔭� � Shopee � 湔鰵摰匧� 撘� � 喋� �
2026-07-01 14:30:49 +08:00
- T-506 撌脣� � 琜� � � 撌脣� � 冽� � 航� `dry-run` � 嫣蛹� 峕� � 交𧋦頧格凒� 啜� 齿� � 殷� � 笔� � 湔鰵撖孵� � 滨� � 厩� � 𨀣� 瘥𤩺鸌� � 憭扳凒� 唳辺� 啗䌊� 典� � 對� 蝖株恕撘寧� � 曄內隞餃𦛚� 啣� 憸� 恣� 寞活嚗� � 甇V蛹敶枏� � � � 摰匧� 蝏𤘪� � 𦒘� � 滚� 憪𧢲鰵隞餃𦛚嚗𥕞𪈠 霈曄蔭憿萄歇� 嫣蛹撅� 葉� � 捆� 綽� 撌血𢰧� 嗵蒾撌脩憬� 凋蛹 T-506 � 嘥� 摰䂿緵蝥� 40%嚗峕芋� 贝祕� � /閫坿𠧧銝𡒊� � 𣂼� � � /頝臬� 銝𡒊垢� � /Shopee � 湔鰵摰匧� 雿輻鍂銝匧� 撣� � 嚗屸鵭摮埈挾頝典� 嚗䜘� � � 韐血噡撟嗉� � 湔鰵� 滢� � 峕� 憭批僎銵諹揭� 瑟㺭� 滚歇� � 僎銝箏� 銝� 銝芣赤� 𤑳� 隞塚� � � 憭批僎銵諹揭� 瑟㺭蝝扯� � 嗅� 銝𥪯� � Z� � �
2026-07-01 08:35:46 +08:00
- T-507 撌脣� � 琜� � 桅� 𡁏迤撘𤩺凒� 啁宏� � `test_item_id` � � � ID � 𣂼� 嚗𥕞𢅛 蝖株恕撘寧� 銝滚� � 曄內瘚贝� � � � ID嚗𥕞𪈠 � 桅� 朞挽蝵桅△� 鞱� 瘚贝� � � � ID嚗� 蘨雿靝蛹� � 蟮/靚� � � 澆捆摮埈挾靽萘� 嚗𥕢� 靽萘� � � 捂� 笔� � 𣂷漱� � � 霈豢凒� 啣� � U� � � � 寞� 憭扳辺� 啜� � � 甈∠&霈扎� � 揭� 瑕停蝏芷� 璉� � � � 韐血噡撟嗉� 銝𢠃� � � � 銵峕𠯫敹堒� Excel � 𧼮� � �
2026-07-01 14:30:49 +08:00
- T-508/T-509/T-510 撌脣� � 琜� � U� � � 憪𧢲凒� 啜� 滢� 銝箔蜓� 滢� 閫� � 撘箏� 嚗䎚� 屸� 蝵格凒� 啁𠶖� � � 滨宏� 唬遙� ∟”� 喲睸� 𨅯� 嚗峕凒� 啣� � 冽㜃� 芸撕蝒堒� � 𤾸� 雿栞挽蝵桀僎� 航歲� 售𪈠嚗𥕞鷄� 峕鰵� � � � 滚� � � 捂撌脩� � 僐� � 𧊋� 𣂷漱蝥蹂� � � � 餈鞱� 銝凋遙� ⊥𧋦� 啣凝靚� � � 坔� `tasks.new_title` 嚗峕� 蝛� `last_error` 撟嗅� � 啣虾� 湔鰵� 嗆� � � 銝滩圻蝣� Shopee/CDP/Excel/撠� 𢒰嚗𥕞𢅛 � 冽� � 航� � 屸� 閫� 𧋦頧格凒� 啜� 滚歇蝏煺� � 孵� 銝箝� 峕� � 交𧋦頧格凒� 啜� 㵪� � � � `dry_run` 摮埈挾靽萘� � �
2026-07-01 17:56:27 +08:00
- T-511 撌脣� � 琜� `app/gui.py` 憿園� 摰帋� 蝏煺� 霂凋� � 脫踎撣賊� 嚗𥕞� � ﹦𢅛隞餃𦛚銵函𠶖� � 㮾� 喳� � 朞� `Qt.ForegroundRole` � 匧� � � `stage/status` 餈𥪜� `QColor` 嚗� � � � /憭梯揖/� 亥� /敺� � � � /餈𥡝� 銝剖� � 思蝙� � success/danger/muted/pending/info嚗䔶� � 劐葉� � 遬蝷箸� 獢� ′� 寥� 嚗䔶� 蝏蹱芦� 朞� � 瑕� � 脯� �
- T-512 撌脣� � 琜� � U� � � 憪𧢲凒� 啜� 滢蝙� � warning `#bc4c00` � � � � 峕� 颲孵撩靚� � 蝥蹂� 憌𡡞埯嚗𥕞� 撖澆� 瘙� � 颱葉� 䭾� 銵峕㺭 >0� � 𧊋� 寥� � � >0 隞� danger � � 滯嚗峕𧊋� 寥� � 厰僼隞滢� � � 緵� 厩� � 餌� � 箄� � 𨥈� � 䭾� 銵䔶� � 啣� 蝑𥡝”� 亙藁� �
2026-07-02 09:06:52 +08:00
- T-513 撌脣� � 琜� � � 揭� 瑞恣� � 蒈敶閧𠶖� � � � 曄內 `� � � 嗆� � 撟嗆� � 嗆� � � � 莎� 撌脩蒈敶� success� � � 瘚衤葉 info� � 𧊋� 餃� /璉� 瘚见仃韐� danger� � 𧊋� � /撌脣鍳� � muted嚗㚁� � X凒� 酒hopee Tab � 朞� ` setTabIcon(2, ...)` � 曄內� 见� warning 撠誩� � 對� 銝齿㺿 Tab � � � � 莎� � 𨬭� � � � 斗鸌甈~� 滚� � � � � � � 方揭� 瑯� 滢蝙� � danger � � � /� 讛器嚗� � � 匧鍳� � /蝳� 鍂� 䔶� 甈∠&霈日� 餉� 銝滚� � �
2026-06-29 17:49:45 +08:00
- T-301/T-303 撌脣� � 鞾� 𡁶鍂 HTTP AI � 亙藁� � 鸌� 讐� � 鞟� � 鍦� GUI � 亙� mock � 閙� 嚗𤤿� 摰� AI � � � 餈㗛� 閬� 銁 `config/ai_models.json` 憛怠� � 舐鍂 url/model/api_key � 𤾸� 銝� 甈⊥� � 砍虾� 抒� 撠𤩺甅� 砍� 瘚页� URL � 臬‵摰峕㟲 endpoint � � OpenAI-compatible base URL� �
2026-06-29 10:37:27 +08:00
- � 砍𧑐 `config/ai_models.json` � 亦眏� 抒� � 祆� � 见極蝏湔擪嚗� 虾� 賜撩撠� `category` 嚗𥕦鍳� 冽𥁒 � 𦯷I 璅∪� category 敹� ◆� � text � � image� � � 塚� � � [`troubleshooting.md` ](troubleshooting.md ) � 芾‘ `category` / `enabled` 蝑厰� 撖� 𤨎摮埈挾嚗䔶� � � API Key嚗䔶� 銝滩� � 𣂷漱霂交� 隞嗚� �
2026-07-01 08:49:38 +08:00
- T-403/T-501c 撌脣� � 鐥𢅛� 湔鰵蝏𤘪� � 𧼮� � � � � � � � 颱� � 笔� � 湔鰵摰匧� 撘� � 喉� 2026-06-29 撌脩鍂瘚贝� � � � 頝穃� � 笔� 蝻𤥁� 憿萄僎摰峕� � � � /撠� 𢒰� 踵揢� � △� V蜓� 峕凒� 啜� 滨� � 鳴� 雿� ◤ Shopee 蝡嗵� 靘抒&霈斗� � 虫� � � � � 滢誨� � 歇銵亦&霈斗� 憭� � � � &霈文� � 𡑒”憿菔歲頧祈� 瘚卝� � � 隡删𠶖� � � � 准� � � � 文� 蝔喳� 蝑匧� � � mock � 閙� 嚗� 2026-06-30 � 冽� 憭滩� � 𤑳緵蝔喳� 蝑匧� 憿箏� � 𧼮� 嚗𡁏說 9 撘䭾𧒄� 𣳇膄� 滩� 瘙� � 隡� input � 舐鍂嚗� 紡� 港� � 𣳇膄蝚砌� 撘惩㦛嚗𥕦� � 滚歇靽格迤銝箏� � 文� � 芰� � 曄� � 𡑒”蝔喳� � � � � 文� � 滨� 銝𠹺� � 亙藁� W� 嚗� 僎銵� mock � 𧼮� 瘚贝� 嚗� 2026-06-30 � � � � 啁� 瘚� /憭� 揮憿菟𢒰蝥扳嵗撉� toast 隡朞◤霂臬ế� 𣂼� � V� 隡惩仃韐伐� 敶枏� 撌脖耨憭滢蛹銝𠹺� � 嗆挾� 芾� � 怠㦛� � /� � 辣/銝𠹺� � 詨� � 躰秤嚗𣬚� 瘚� � 霂舐� � 唳� 鈭日𧫴畾萄� � � � � 2026-06-30 � 冽� 憭滩� 蝖株恕瘚讛� � 典歇� 𣂼� � 湔鰵� � � /� 曄� 撟嗉歲頧砍� � � � 銵剁� 雿� GUI 隞齿𥁒 `POST_UPDATE_ERROR` 嚗𥕦歇靽格迤� 𣂷漱� 舘� 瘚衤� � � 漣嚗𡁜� 銵券△頝唾蓮隡睃� � 斗� � � � 畾讠� error toast 銝滚� 閬� � � 𣂼� 頝唾蓮嚗屸� 霂� toast 隞� 銁� 芾歲頧砌� � � 賒摮睃銁� 嗅ế憭梯揖� � � � 滚� � 𤑳緵� � � 26887160467 � 见𢆡銝𠹺� 220KB � 啣㦛� 𣂼� 嚗䔶� 隞� � � 湔𦻖瘜典� � � 辣� 𦒘� 隡删� 隞園鵭� 蠘蓮� � � T-404 敶枏� 銵乩� 撌脰悟 `replace_cover()` 銝𠹺� � 滚� � 孵稬銝𠹺� � 埈芋� 煺犖撌亙� � � � � � � � � 敺� � � � � 啗繮� � input � 𤾸� `DOM.setFileInputFiles` 嚗� 僎銵� mock � 𧼮� 瘚贝� � � 25120403046 � 芣� 8 撘惩� � � 㦛� 嗆𧊋� 𣳇膄蝚砌� 撘惩紡� � Shopee � 鞟內 `� � 1撘菟� 銴� � � 𣇉� ` 嚗𥕦� � 滚歇� 賢𧑐銝箸凒� 啣� � Y� 銝� � � � 敶枏� 蝚砌� 撘惩� 銝𠹺� 嚗� 僎� � `� 滩� /� 滚� /duplicate` toast 霂� � 銝箏� � V� 隡惩仃韐乓� � 鰵� � � /� 啁� � 𣂼㦛� � 楝敺� 歇� 嫣蛹� 㗇鸌甈∠� � � � � 踹� � 䔶� 韐血噡憭𡁏鸌甈∪㦛� � 毽� 橘� � � 蟮 DB 撌脣� 頝臬� 蝏抒賒� 舐鍂� � &霈文� � 亥� � 墧� � � � � � � 銵券△銝磰挽蝵桐� � 𣂼� � 𤾸� � 剜𧋦甈⊥鰵撘� 蝻𤥁� 憿蛛� � 喲𡡒� 滨� 敺� 2 蝘鉝� � 2026-07-01 � 冽� 撌脩鍂� � 鉄 5 銝芸� � � ID � � Excel 摰峕� 撖澆� � � I � � � � � � /� 曄� � � ab� � � 湔鰵� � Shopee � � � 摰鮋曎頝舫� � 塚� T-404 � 文� 摰峕� � �
2026-07-01 14:30:49 +08:00
- T-404a 撌脣� � 琜� � ~� 屸� 蝵桃� � 鞟� � 栶� 齿� 蝛箸𧋦� � AI 蝏𤘪� 撟園� � � � collected嚗屸� 霈支� � 𣳇膄� 砍𧑐� 啣� � X� 隞塚� � U� 屸� 蝵格凒� 啁𠶖� � � 滢� � 蹱鰵� � � /� 啣� � W僎� � � � generated/pending嚗� � � 滚� � � 歇� � T-508 蝘餃� 隞餃𦛚銵典𢰧� 株� � 𤏪� 銝方� � 蘨雿𦦵鍂敶枏� � 劐葉� 閙辺� � � 銵䔶葉蝳� 鍂� � � `run_type=reset` 餈鞱� � 亙� � � 𢅛 撖� `committed=1` 隡𡁏� 蝷箇瑪銝𠰴歇� 𣂷漱餈� � � 𧋦� 圈� 蝵桐� � 墧� Shopee� � � 憭齿凒� 唬� � 齿活� 𣂷漱� �
2026-07-01 08:35:46 +08:00
- T-502 � W� � W� � 斗� 蝔见歇摰峕� 隞� � 頝臬� � � ock � 閙� � 𣬚� 摰� 9 � 曉� � � � � 𣂷漱瘚� � 摰墧� 嚗𥟇凒� 啣� � Y� 銝� � � � 敶枏� 蝚砌� 撘𩤃� � 𣳇膄� 滚� 憿餃歇� 㗇𧋦� 唳唂撠� 𢒰憭� 遢嚗Ǒold_cover_path` 摮睃銁銝娍� 隞嗅� � 剁� 嚗𣬚撩憭勗� 隞賣𧒄� 垍� � 𣳇膄蝥蹂� � 曄� 嚗𣁦ock 撌脰� � � 8 撘惩㦛銋笔� � 删洵銝� 撘𨬭� � � 憭滚㦛� � toast 蝡见朖憭梯揖� � 𧋦頧桀� 瘚见蘨� 滢� 蝻𤥁� 憿萄僎� 喲𡡒瘚贝� tab嚗峕𧊋� 孵稬� 峕凒� 啜� 滢� 摮条瑪銝𨳍� � images/` � 啗楝敺� � `batch_id/slug/task_id_item_id` 蝏� � 嚗峕唂 DB 頝臬� � 澆捆銝滩� 蝘颯� �
2026-06-26 15:30:37 +08:00
## 敶枏� � 航� 銵� � 摰�
```bash
2026-06-26 17:24:23 +08:00
# 霂剜� 璉� � 伐� T-000 � 𠬍� � 祆㦤隡睃� � � py -3嚗�
py -3 -m compileall app main.py
2026-06-27 09:02:05 +08:00
# appconfig 暺䁅恕� 滨蔭霂餃� 嚗� � � 乩葩� 嗥𤌍敶𤏪�
py -3 -c "import os,tempfile; from app import appconfig; d=tempfile.TemporaryDirectory(dir='.'); print(appconfig.load_config(os.path.join(d.name,'config.json'))['image_dir'])"
# db 銝湔𧒄摨枏� 憪见� 銝� PRAGMA 璉� � �
py -3 -c "import os,tempfile; from app import db; d=tempfile.TemporaryDirectory(dir='.'); p=os.path.join(d.name,'cmshopee.db'); db.init_db(p); c=db.connect(p); print(c.execute('PRAGMA foreign_keys').fetchone()[0], c.execute('PRAGMA journal_mode').fetchone()[0], c.execute('PRAGMA busy_timeout').fetchone()[0]); c.close()"
# gitignore � 詨� � 砍𧑐� 唳旿璉� � �
git check-ignore -v -- config.json config/ai_models.json cmshopee.db chrome_user_data_dir/ images/
2026-06-27 09:10:17 +08:00
# ai_models 銝湔𧒄皜� � 霂餃� 銝擧� � � � � �
py -3 -c "import os,tempfile; from app import appconfig; d=tempfile.TemporaryDirectory(dir='.'); p=os.path.join(d.name,'ai_models.json'); print([m['category'] for m in appconfig.list_ai_models(path=p)])"
2026-06-27 15:47:21 +08:00
# AI � 亙藁� 閙� 嚗� � 餈䂿� 摰墧� � ∴�
python -m unittest discover -s tests -p "test_ai.py"
2026-06-27 09:21:33 +08:00
# config slug 銝� user-data-dir 銝湔𧒄� 桀� 璉� � �
py -3 -c "import tempfile; from app import config; d=tempfile.TemporaryDirectory(dir='.'); print(config.ensure_user_data_dir(config.make_slug('alias'), root=d.name))"
2026-06-27 09:33:54 +08:00
# chrome � � 㺭� 潸� / 蝡臬藁� X � � � tests/test_chrome.py 閬� �
python -m unittest discover -s tests
2026-06-27 10:59:51 +08:00
# Excel 撖澆� � � tests/test_excel.py 閬� � 嚗偦� 霈� python � 臬� � � � 臬紡� � openpyxl � 齿� 銵𣬚� 摰噼圾� 鞉� 霂�
python -m unittest discover -s tests -p "test_excel.py"
2026-06-27 10:30:45 +08:00
# GUI 撉冽沲銝� � � 韐血噡蝞∠� � � tests/test_gui.py 閬� � 嚗𤦺orker � 箏漣� � tests/test_workers.py 閬� �
2026-06-27 10:05:29 +08:00
# 暺䁅恕 python 敶枏� PySide6=6.5.3嚗俰y -3 � 臬� 蝻� PySide6 � 嗥㮾� 單� 霂蓥� skip
2026-06-27 09:56:53 +08:00
2026-06-26 17:24:23 +08:00
# 敶枏� � 亙藁� 牐�
python main.py
py -3 -m app
2026-06-26 15:30:37 +08:00
2026-06-27 09:17:20 +08:00
# � 訫� 瘚贝� 嚗㇍-006 � 𡒊滲� 餉� � 孵𢆡敹� � 嚗�
2026-06-26 16:27:33 +08:00
python -m unittest discover -s tests
2026-06-26 15:30:37 +08:00
# � 閗揭� 琿𡡒� 荔� 銝齿� 鈭斤瑪銝𠺪�
2026-06-26 17:05:18 +08:00
python prototypes/demo.py # � � 郊嚗㇍-000 � 𦒘� 憿寧𤌍� 孵紡� � app.cdp嚗�
2026-06-26 15:30:37 +08:00
set AUTO = 1 && python prototypes/demo.py # � 芸𢆡嚗Ếmd嚗�
2026-06-27 17:58:08 +08:00
# � 笔� � 𣂷漱嚗� 馬� 𠬍� T-404 � 滢� 閬� � 憭扳鸌� 𧶏�
2026-06-26 15:30:37 +08:00
set UPDATE = 1 && python prototypes/demo.py
```
� 滨蔭� ∩辣嚗�
- Chrome 撌脩鍂� � user-data-dir 撣� `--remote-debugging-port` + `--remote-allow-origins=*` � 臬𢆡撟嗥蒈敶� Shopee� �
2026-06-27 10:59:51 +08:00
- 撌� `pip install websocket-client requests` 嚗𡻈xcel 撖澆� 餈㗛� 閬� `openpyxl` 嚗屸� 霈� `python` � 臬� � 祈蔭撌脣虾� 扯� � 笔� 閫� � 瘚贝� 嚗䈣py -3` � 臬� 蝻� openpyxl � � ` tests/test_excel.py` 隡𡁏� 霈曇恣頝唾� � �
2026-06-26 16:09:09 +08:00
- PySide6 敶枏� � 臬� 撌脣虾撖澆� 嚗� � 霂� � � � 6.5.3嚗㚁� GUI 摰䂿緵� 箏� 雿輻鍂 PySide6� �
2026-06-26 15:30:37 +08:00
- 暺䁅恕餈� `127.0.0.1:9222` 嚗� � � 烐� � 舐鍂 `CDP_HOST` � � � WSL 頧砍� � � `192.168.0.224:9333` 嚗剹� �
2026-06-26 17:24:23 +08:00
- � 祆㦤 `python` 敶枏� � � � `C:\Python37\python.exe` 嚗� 3.7.9嚗𢁾solated嚗䔶� 蝚血� Python 3.10+ 閬� � 銝� `python -m app` 銝齿� 蝝W� � 滨𤌍敶𤏪� 嚗𥕦� � � /撉諹� 隡睃� � � `py -3` 嚗� � � � 3.14.4嚗㗇� 蝖株恕 `python` 撌脫� � � 3.10+� �
2026-06-26 15:30:37 +08:00
## 撘� 憪讠� � � � 璉� � �
1. 霂颱� 摨梶漣 `AGENTS.md` / `CLAUDE.md` 嚗� � � 㚁� � �
2. 霂� `docs/00-ai-start-here.md` � �
2026-06-26 15:55:28 +08:00
3. 霂� `docs/05-coding-rules.md` 銝� `docs/04-architecture.md` 蝚砌� � � � �
2026-06-26 15:30:37 +08:00
4. � � `docs/06-tasks.md` � 𣇉洵銝� 銝� `TODO` 銝𥪯� 韏� `DONE` � � 遙� ~ � �
5. 撠� 砲隞餃𦛚� 嗆� � 㺿銝� `DOING` � �
## 蝏湔擪閫� �
2026-06-26 16:09:09 +08:00
- � 啣遣 `config/chrome/editor/gui/workers` � 𡝗㺿 CDP � 㗇𥋘� 典� 嚗峕凒� 唳𧋦� � � `04-architecture.md` � �
2026-06-26 15:30:37 +08:00
- 隞餃𦛚� 嗆� � � � 硋� 甇� [`06-tasks.md` ](06-tasks.md )嚗𥟇� 銵諹扇敶閗蕭� � [`../progress.md` ](../progress.md )� �
- � 祆� � 芯� � 坔� � 滚翰� 改� 銝滢� � 坔� � 游� � 脯� �