Files
cmshoppe/docs/current-state.md
T

184 lines
47 KiB
Markdown
Raw Normal View History

# 敶枏�摰䂿緵�嗆��
> �祆��臬虾閬������滚翰�改�霈啣�隞��銝𦒘遙�∠��輻��啣��嗆����
> ��蟮�扯�瘚�偌餈賢��� [`../progress.md`](../progress.md)嚗䔶��冽𧋦���憭滚��湔𠯫敹𨰜��
## 敶枏�敹怎�
2026-07-04 15:13:15 +08:00
- �交�嚗�2026-07-04
2026-07-04 17:14:29 +08:00
- �嗆挾嚗间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 �餃�靽脲暑銝擧�瘚卝��-103b �餃�璉�瘚贝‘����� Shopee accounts �餃�憿萸��-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�梢埯���/�游��扳��桐��脯��-514 �罱鷄�� 擐𡝗活蝛箇𠶖���撖澆㨃����-515 �寞活�嗆挾餈𥕦漲�餉���-516 �删��匧笆朣鐥鷄�U��-517 �方挽蝵桀��箔��澆捆摮埈挾皜����-518 �∪椰�𤩺�蝷箄��箇�隞嗅�摨虫��硔��-519 �,I����蹂遙�∟�摨行辺銝𡒊鍂�瑕虾霂餅��冽𠯫敹𨰜��-520 �,I���撠�𢒰�舫�厩��𣂼��喋��-521 靘肽�皜��嚗����𧋦 requirements嚗剹��-522 CI �芸𢆡頝𤏸祗瘜� + �訫� / GUI 瘚贝���-523 ��� `app/gui.py` 銝� `app/gui/` ����-523a ��/�� �唬�頧株�銵��皜�征�屸𢒰�亙��曄內��-404b ���霂行�憿萄�頧賢仃韐� toast �芸𢆡�閗繮��-524 PyInstaller �枏�銝箏�摰㕑� exe��-526 `app/ai.py` + `appconfig` �亙� cmhub backend��-527 �方挽蝵� cmhub 蝵穃��X踎��-528 �∟恣韐寥�霂舀�蝷箔�雿䠷�撅閧內��
2026-07-04 15:13:15 +08:00
- ���舀�嚗䥪ython 3.10+嚗峕覔�桀� `requirements.txt` ���餈鞱�靘肽�嚗灷itHub Actions 雿輻鍂 Windows + Python 3.11 �芸𢆡頝𤏸祗瘜訫��訫�/GUI 瘚贝�嚗釶yInstaller onedir �枏�銝� Windows �滚�鋆� exe嚗𥡝䌊�� CDP嚗òebsocket-client + requests嚗㚁�SQLite嚗ìqlite3嚗�+ `config.json` + openpyxl + AI嚗Ê̌irect: `config/ai_models.json` �𡁶鍂 HTTP嚗𢲷mhub: `config.json` backend + `config/cmhub.json` Key嚗㚁�GUI PySide6 5 Tab嚗�歇摰𡄯���
2026-07-04 17:14:29 +08:00
- �煺漣隞��嚗𡁜歇撱箇� `app/` �� + �孵��� `main.py`嚗𢱌app/cdp.py` 銝箏歇撉諹� CDP 摨訫漣嚗�歇�箏� `CDP.close()` �剖� WebSocket 銝� `close_tab()` �喲𡡒瘚讛��� target嚗𢱌app/editor.py` 撌脣�鋆�蒈敶閧𠶖���瘚卝���憸�/撠�𢒰/���/�湔鰵�厰僼�賢�嚗峕�撘����霂行�憿菜𧒄隡𡁜�鋆� toast �閗繮撟嗅銁霂行�憿萄�頧賢仃韐交𧒄銝𦠜筑���憭望�/�䭾��鞟��躰秤�笔�嚗䈣open_product()` ���憭梯揖隡𡁜��剜𧋦頧株䌊�冽鰵撱箇�憭梯揖 tab嚗���函鍂�瑕歇�� tab 銝滚��哨�撟嗅銁���蝏𤘪��𤾸蘨�喲𡡒�祈蔭�芸𢆡�啣遣������颲煾△ 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嚗䈣config/cmhub.json` cmhub Key 霂餃�/�梶� helper嚗䔶誑�� `mask_secret()`��sanitize_for_log()`��redact_secrets()` �𤩺�靽⊥��望�撌亙�嚗𢱌app/ai.py` 撌脣��� `gen_title()`/`gen_cover()`/`generate_batch()`嚗峕𣈲�� direct �𡁶鍂 HTTP �� cmhub 蝵穃� backend嚗𩥇irect �厰�霈斗���/�曄�璅∪�靚�鍂嚗稪mhub �� Base URL + ���/�笔㦛�怠�靚�鍂 title/image/models/balance �亙藁嚗𣬚��� `image_url` 摰匧�銝贝蝸�舘蓮�砍𧑐 JPEG嚗諹恣韐� metadata �朞�鈭衤辣�噼�隡惩枂嚗䔶�靽萘��滩����霂航��譌��㦛�� URL/base64 閫����esolution resize��pg_quality 靽嘥���� `ai.generate_cover` �㗇𥋘�芰��鞉�憸䀹���僎�烐�憸睃�撟嗅�撠�𢒰���鞉辺 `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/` 撌脩眏 T-523 ���銝� PySide6 GUI �������
- 瘚贝�嚗䫤tests/` 撌脣遣蝡页�T-522 撌脫鰵憓� GitHub Actions �� push / pull_request �芸𢆡餈鞱�霂剜�璉��乩��券� unittest嚗苽-006 �𡒊滲�餉��孵𢆡敹�◆餈鞱� `python -m unittest discover -s tests`嚗���滩��� appconfig/db/config/accounts/chrome �臬𢆡銝𤾸翰�瑟䲮撘�/editor �餃�璉�瘚页��� Shopee accounts �餃�憿蛛�銝𤾸��� tab �笔𦶢�冽������祕��△憭望�/�鞱� toast �閗繮��凒�唳��笔��喲𡡒�祈蔭�啣� 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 ���/�𣳇膄�厰僼�瑕���-514 擐𡝗活蝛箇𠶖���撖澆㨃����-515 �寞活�嗆挾餈𥕦漲�餉���-516 �删��匧笆朣鐥鷄�U��-517 �方挽蝵桀��箔��澆捆摮埈挾皜����-518 �∪椰�𤩺�蝷箄��箇�隞嗅�摨虫��硔��-519 �,I����蹂遙�∟�摨行辺銝𡒊鍂�瑕虾霂餅��冽𠯫敹𨰜��-520 �,I���撠�𢒰�舫�厩��𣂼��喋��-524 PyInstaller �枏��亙藁/��遣�𡁏𧋦/�穃��桀��⊿���-526 cmhub backend mock��-527 霈曄蔭憿� cmhub backend ��揢/�怠�銝𧢲�/worker mock��-528 �︷mhub雿䠷��曄內/霈∟晶�亙�/�寞㺭銝滩雲銝剜迫�鞟內嚗�2026-07-01 撌脣��� 5 銝芰�摰𧼮���� T-404 �湔鰵撉峕𤣰嚗��蝏� CDP/Shopee �孵𢆡隞漤�瘚贝�����见𢆡撉諹���
2026-07-04 15:13:15 +08:00
- �唳旿嚗䫤config.json`��config/ai_models.json`��config/cmhub.json`��cmshopee.db`��cmshopee.db-*`��chrome_user_data_dir/`��images/`��logs/`��prompts/`��title_prompt.txt`��build/`��dist/` 撌脩眏 `.gitignore` �㘾膄嚗𥕦���� API Key �砍𧑐�擧�靽嘥�雿��摮�/�䀹凒�嗆�蝷綽�UI �梶�嚗峕𠯫敹�/撖澆枂敹�◆�望�嚗𥡝��亙‵�坔��� Excel 銝𡁜𦛚��辣暺䁅恕敹賜裦嚗峕���征璅⊥踎 `shopee敺����遙�⊥芋��.xlsx` �舀�鈭歹�`app/appconfig.py` 擐𡝗活霂餃�蝻箏仃�� `config.json` �嗡��冽𧋦�啣�暺䁅恕�滨蔭嚗䈣app/db.py` 靚�鍂 `init_db()` �嗡��冽𧋦�啣�撱� SQLite DB��
## �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-07-04 15:13:15 +08:00
- 摮睃�嚗䫤config.json`嚗���刻挽蝵桀� AI backend �㗇𥋘嚗�+ `config/ai_models.json`嚗Ê̌irect AI 璅∪�皜��銝擧𧋦�唳��� Key嚗�+ `config/cmhub.json`嚗Ếmhub �砍𧑐�擧� Key嚗�+ SQLite `cmshopee.db`嚗�揭��/隞餃𦛚/��𧫴畾萇��頣�撖���砍𧑐�擧�隞�����+ openpyxl嚗𠄌xcel嚗�+ �砍𧑐 `images/`嚗�唂/�啣��g�嚗𥕦���/API Key 靽嘥��硋��湔𧒄�鞟內嚗��蝷箏��亙�/撖澆枂敹�◆�望���
- 憭朞揭�琿�蝳鳴�瘥讛揭�瑞𡠺蝡� user-data-dir嚗�� profile嚗剹��
- 韐血噡�𥪯遙�∠�摰𡄯�隞� Excel�𨅯��𨧀�嘥�銝箸�憡���芸龪�滨裦餈��蝏𤘪�撘寧�瘙��颯��
2026-07-01 14:30:49 +08:00
- �扯�嚗𡁻�霈文�韐血噡銝脰�����∪仃韐亦誧蝏哨��� �𣂷��峕��交𧋦頧格凒�啜�齿��殷�璉��亙蘨�躰�銵峕𠯫敹堒�瘙��鳴�銝齿�撘� Shopee����𣂷漱蝥蹂�����嫣遙�∠𠶖����� �臬��臬�韐血噡撟嗉�嚗���諹揭�瑕僎銵䎚���韐血噡��葡銵䕘�撟嗉挽蝵格��寞�憭扳凒�唳辺�啜��𢅛 �孵稬���憪𧢲凒�啜�滚�����笔��湔鰵摰匧�霈曄蔭撘寧�蝖株恕敶枏�蝑偦�㕑��氬��遙�⊥㺭�譌����孵之撠誩�憸�恣�寞活嚗𤤿&霈文��𡁏𧋦頧株揭�� Chrome/CDP/�餃����璉�嚗峕𧊋�臬𢆡�𡝗𧊋�餃��坔撕蝒堒��箄揭�瑕僎銝剜迫����芸𢆡�枏� Chrome嚗𥡝揭�瑕停蝏芸��㗇鸌�鞉辺�嫘�峕凒�啜�齿�鈭斤瑪銝𠺪��孵稬�𨀣迫�𦒘��滚�憪衤�銝��⊥�銝衤��嫘��
2026-07-04 15:13:15 +08:00
- AI嚗䫤app/ai.py` �舀� `backend=direct` 銝� `backend=cmhub`��irect 璅∪��� `config/ai_models.json` �滨蔭�滚𦛚��/璅∪�/Key嚗峕𣈲�� chat JSON 銝� images_edits multipart嚗𢲷mhub 璅∪��� `config.json` �� Base URL/�怠��� `config/cmhub.json` Key �滨蔭嚗𣬚��鞱��𧼮�潔�����矋�霈∟晶 metadata �朞�鈭衤辣隡惩枂����𣂼�摰寧凒�亦鍂鈭擧凒�堆��砍𧑐�蹱﹝+�𧼮� Excel 靘𥡝蕭皞胯��
2026-07-02 22:38:08 +08:00
- �餃�嚗帋犖撌亦蒈敶� + 蝔见�璉�瘚页�銝滩䌊�函蒈敶𤏪�����鍳�函蒈敶𨰻�滚蘨�舀�撘�撖孵�韐血噡瘚讛��其�鈭箏極�餃�嚗𢞖𪆓�峕�瘚讠蒈敶𨰻�滚���/�a�璉��芷�霂�蒈敶閙����� Shopee tab �嗆�瘚见���蛹 `https://<region_host>/`嚗��霈� `https://seller.shopee.tw/`嚗㚁�憿菟𢒰頝喳� `accounts.shopee.tw/seller/login` �嗅歇�𡒊&�支蛹�芰蒈敶𤏪�擐𡝗活�芷�韐血噡��笆摨磰揭�� Chrome �芸鍳�冽��芰蒈敶閙𧒄嚗𢞖� �� 摨𠉛��冽��扯��漤�璉��鞟內嚗�僎撘訫紡�領𪆓嚗𢞖𢅛 銝漤�暺睃鍳�函撩憭梯揭�� Chrome��
## 敶枏��桀�閬��
| 頝臬� | �嗆�� | 霂湔� |
| --- | --- | --- |
| `docs/` | 撌脫� | �� harness coding ��﹝��� |
2026-07-03 09:26:27 +08:00
| `docs/packaging.md` | 撌脫� | T-524 鈭批枂嚗䥪yInstaller �枏��賭誘���撣�𤌍敶閙��斗𧋦�唳㺭�株��踺���甈∟�銵峕㺭�桐�蝵桀��冽��见𢆡閬���湔鰵甇仿炊 |
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` |
| `chrome-remote-debug-lan.md` | 撌脫� | WSL�䁗indows CDP 頧砍��埝䰻霈啣� |
| `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` �航�銵��雿滚��� |
| `requirements.txt` | 撌脫� | T-521 鈭批枂嚗𡁻�摰朞�銵峕𧒄�湔𦻖靘肽� PySide6 6.5.3��penpyxl 3.1.3��equests 2.31.0��ebsocket-client 1.6.1��illow 9.5.0嚗𥟇揢��/CI 雿輻鍂 `python -m pip install -r requirements.txt` |
2026-07-03 09:26:27 +08:00
| `requirements-build.txt` | 撌脫� | T-524 鈭批枂嚗𡁏���㴓憓��韏吔����鋆��銵䔶�韏硋�摰㕑� PyInstaller 5.13.2嚗𥕢�雿靝蛹餈鞱��嗡�韏𡝗�隞� |
| `.github/workflows/tests.yml` | 撌脫� | T-522 鈭批枂嚗䮝ush / pull_request �芸𢆡�� `windows-latest` + Python 3.11 摰㕑� `requirements.txt`嚗諹挽蝵� `QT_QPA_PLATFORM=offscreen`嚗諹�銵� `python -m compileall app main.py` 銝� `python -m unittest discover -s tests` |
2026-07-03 09:26:27 +08:00
| `cmshopee.spec` / `scripts/build_exe.ps1` | 撌脫� | T-524 鈭批枂嚗䥪yInstaller onedir ��遣�滨蔭銝𤾸�撣�𤌍敶閙嵗撉諹��穿�`cmshopee.spec` 銝滚ㄟ�擧𧋦�唳㺭�� `datas`嚗諹��祆��� `dist\\cmshopee` 銝滚鉄�滨蔭��B��㦛����𠯫敹𨰜��hrome �餃�����鞟內霂� |
2026-07-04 17:14:29 +08:00
| `app/gui/` | 撌脫� | T-523 鈭批枂嚗𡁶眏�� `app/gui.py` ����� PySide6 GUI �������� `__init__.py` 蝏抒賒�澆捆 `from app import gui` / `from app.gui import MainWindow`嚗𢱌main_window.py` �� MainWindow嚗䈣models.py` �� 3 銝� TableModel嚗䈣widgets.py` �曇𠧧��/蝛箇𠶖��/�寞活�餉�/helper嚗䈣workers.py` �曉�雿� GUI workers嚗䈣tabs/` �� �㗒�� Tab嚗� 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/T-514/T-515/T-516/T-517/T-518/T-519/T-520/T-527/T-528 鈭批枂嚗䥪ySide6 `QMainWindow` + 鈭� Tab嚗偦▲�� Tab �誯俈霂舐��瑕�嚗𤤿�銝�霂凋��脫踎����﹦𢅛�嗆����齿艶�脯��𢅛撘�憪𧢲凒�� warning �瑕����撖澆��⊿��啣���滯��𪆓�餃��嗆�����𢅛Tab warning 撠誩��嫘����斗��� danger �瑕�����﹦𢅛擐𡝗活蝛箇𠶖���撖澆㨃����寞活�嗆挾餈𥕦漲�餉�嚗𥕞� 撖澆����撖澆��厰僼��紡�交��餅���鸌甈�/摨烾唍/���ID/�嗆����剹����斗鸌甈∟蔓�𣳇膄�厰僼��QTableView` 隞餃𦛚�𡑒”��𧊋�寥�蝑偦�劐��亥���扇�����唂����批��� worker嚗�唂撠�𢒰頝臬��㗇鸌甈�/摨烾唍/隞餃𦛚蝏��嚗剹������韐血噡撠梁貌憸��銝𢛶𪆓撘訫紡�������鞱䌊�典��嗘��见𢆡�滩�������銵峕𠯫敹𡑒��橘��� AI���撌血𢰧撣�����蝷箄�蝞∠���鸌甈�/摨烾唍/���ID/�嗆����㗇���遙�∪�銵具��鰵����埈𧋦�啁�颲㻫���憪讠���/�𨀣迫/���銝𤾸㦛���餈𥕦漲�~����餅鰵�批��a�閫���鍂�瑕虾霂餉䌊�冽��杗I���餈鞱��亙����蝵桃��鞟��靝� `GenerateWorker`嚗𥕞𢅛 �湔鰵shopee�寞活/摨烾唍/���ID/�嗆����㗇���遙�∪�銵具���憪𧢲凒�唬蜓�厰僼���蝵格凒�啁𠶖��𢰧�株��𨰻��hopee �湔鰵摰匧��行⏛銝汿���敺�霈曄蔭�滩歲頧研���峕��交𧋦頧格凒�啜�齿��柴���憪𧢲凒�啁&霈文撕蝒𨰜��ApplyWorker` 璉���/��鸌銝脰�/�㕑揭�瑕僎銵䎚��揭�瑚�蝡臬藁憸�����銵峕𠯫敹𨰜���鞉辺 `set_applied`��䌊�典��嗵��𨅯� Excel�������餃撕蝒𦯀��见𢆡�𧼮��滩�嚗𥕞𪆓 韐血噡蝞∠�銵冽聢��揭�瑕撕蝒𨰜�����𧋦�唳����摮䀹�蝷箝��鍳�函蒈敶𨰻���瘚讠蒈敶𨰻��翰�瑟䲮撘𧶏��� 霈曄蔭 AI backend �㗇𥋘嚗𩥇irect 璅∪�靽萘�璅∪�銝𧢲���鰵憓�/�𣳇膄��祕���颲㻫����交�����砍𧑐�擧�靽嘥��鞟內���霂閗��� worker���霈方��脖��㚁�cmhub 璅∪��𣂷� Base URL��PI Key�����/�笔㦛�冽����溻����啣��溻���霂閗���/�乩�憸嘥� `config/cmhub.json` 靽嘥�嚗偦�𡁶鍂�����㺭��楝敺�垢���蝵柴����� Shopee �湔鰵摰匧�銝擧�銵峕芋撘讛挽蝵桐�靽萘�嚗屸�憸穃���/�扯�璅∪���躹�滨蔭��抅蝖�霈暹鴌��躹�𡒊蔭嚗䈣test_item_id`/`dry_run` �澆捆摮埈挾�删鍂�瑕�����桅�𡁏凒�唬��漤獈�剜迤撘𤩺凒�堆��∪��X芋�踴��𡖂摮䀝蛹/�滚𦶢��/�𣳇膄�滢�憸烐�雿𨅯歇�嗆�餈䜘�峕芋�踵�雿栶�滩��𤏪��,I���摨閖�撌脣��䭾�憸�/�曄��諹�摨行辺嚗諹�銵峕𠯫敹堒歇�嫣蛹�冽��航粉��䌊�冽��具����讐��蹂遙�⊥𠯫敹梹�銝婙鷄�祈蔭�𣬚��𣂼��W㦛����鞉𧋦颲��嚗剹�滚��喲�霈文��剖僎����硋� `ai.generate_cover`嚗���剜𧒄�芰��鞉�憸睃僎餈𥕦��舀凒�啁𠶖����︷mhub璅∪�隡𡁏遬蝷箇��𣂼����雿嗵��堆�霈啣� points_cost/call_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 �滚𦛚��𤌍敶訫�撱箝��垢����溻��鍳�函蒈敶𨰻���瘚讠蒈敶𨰻��翰�瑟䲮撘� |
| `app/editor.py` | 撌脫� | T-001/T-103/T-205b/T-207/T-501c/T-502/T-404b + T-404 銵乩�鈭批枂嚗𡁶蒈敶閧𠶖���瘚卝���撘����憿萸��祕��△�㰘蝸憭梯揖 toast �閗繮銝𤾸���仃����𨬭��粉/�蹱�憸塩��粉/銝贝蝸撠�𢒰�����郊撉文�靚���凒�唳郊撉文�靚��������喲𡡒�芸𢆡�啣遣���憿� tab���隡惩�蝑匧��曄�蝞∠��函迅摰𠾼����颱�隡惩��擧釣�交�隞嗅僎璉�瘚� CDN �擧�撠�𢒰��凒�啣��Y�銝���嵗撉峕唂撠�𢒰憭�遢�滚�蝥蹂�蝚砌�撘𨬭���憭滚㦛�� toast �𡒊&憭梯揖��△�V蜓�湔鰵�厰僼��hopee 蝡嗵�靘抒&霈斗�銝餅��柴��pply_task嚗𥟇凒�唳��笔��舀�霈曄蔭�喲𡡒�祈蔭�芸𢆡�啣遣���憿� |
2026-07-04 16:29:15 +08:00
| `app/appconfig.py` | 撌脫� | T-002/T-501c/T-503/T-504/T-520/T-526/T-527 鈭批枂嚗䫤config.json` 暺䁅恕�潦��粉�踺��凒�啜��楝敺�/蝡臬藁/AI ��㺭霂餃���I `backend=direct/cmhub` �� `ai.cmhub` 暺䁅恕�潦��config/cmhub.json` Key helper��hopee �湔鰵摰匧�銝� dry-run/憭朞揭�瑕僎銵屸�霈文�潘��∠��𣂼��a�霈文��剔� `ai.generate_cover`嚗𥟇�蝏脲��笔�畾萄��伐��𣂷��𤩺��潭����������亙��望�銝舘䌊�望��祆𤜯�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-04 17:14:29 +08:00
| `app/ai.py` | 撌脫� | T-301/T-303 + AI���霂𦠜鱏銵乩� + T-519/T-520/T-526/T-528 鈭批枂嚗䫤gen_title()`/`gen_cover()`/`generate_batch()`嚗𥟇𣈲�� direct 暺䁅恕璅∪��渲��� cmhub 蝵穃� backend嚗𢲷mhub 雿輻鍂 `CMHubError` 蝏𤘪��㚚�霂胯��uple timeout���撟���笔㦛霂餉��嗡��滚���image_url` 摰匧�銝贝蝸��fetch_cmhub_models()` �怠��𤑳緵��fetch_cmhub_balance()` 雿䠷��亥砭�� metadata 鈭衤辣嚗𥯨irect 靽萘��𡁶鍂 HTTP 靚�鍂��仃韐仿�霂𨰻���霂航��𧶏�撠�𢒰�� resolution/jpg_quality 靽嘥�撟嗆��寞活/摨烾唍/隞餃𦛚頝臬��賜�嚗𥟇鸌�讐��𣂼虾�� `ai.generate_cover` 頝唾�撠�𢒰�嗆挾嚗峕�憸䀹��笔朖�坔�餈𥕦� generated嚗𥕦��臬��X𧒄���憸睃�撠�𢒰���摨血�靚����鞉辺�賢���仃韐交�霈啜���隞�/�躰秤�噼����甇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-04 17:14:29 +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/T-514/T-515/T-516/T-517/T-518/T-519/T-520/T-523/T-523a/T-404b/T-524/T-526/T-527/T-528 鈭批枂嚗窃tdlib unittest �箏漣嚗𥡝��� appconfig/db/config/accounts/chrome/editor/excel/ai/image_paths/prompts/gui/workers/packaging |
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-07-04 15:13:15 +08:00
| `config.json` / `config/ai_models.json` / `config/cmhub.json` / `cmshopee.db` / `cmshopee.db-*` / `chrome_user_data_dir/` / `images/` / `logs/` / `prompts/` / `title_prompt.txt` | �砍𧑐摮睃銁�𡝗������嚗�歇敹賜裦 | �恍�蝵柴����乓����~��蒈敶閙����㦛����𧋦�啗��剜𠯫敹堒��冽��鞟內霂㵪�銝齿�鈭斤��砍�嚗𥕦���/API Key 靽嘥��硋��湔𧒄�鞟內嚗��蝷�/�亙�/撖澆枂�望� |
## 撌脤�霂���𨥈��閗揭�瘀�
- 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 �𣂼���
## 隞餃𦛚�𧢲踎�嗆��
隞餃𦛚�嗆��誑 [`06-tasks.md`](06-tasks.md) 銝箏�嚗���脰扇敶閗� [`../progress.md`](../progress.md)��
2026-07-04 17:14:29 +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嚗�蒈敶蓥�瘣颱�璉�瘚页���-103b嚗�蒈敶閙�瘚贝‘����� Shopee accounts �餃�憿蛛���-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嚗���﹦𢅛 擐𡝗活蝛箇𠶖���撖澆㨃�����-515嚗�鸌甈⊿𧫴畾菔�摨行�餉�嚗剹��-516嚗��蝑偦�匧笆朣鐥鷄�g���-517嚗�𪈠霈曄蔭��躹 + 皜���澆捆摮埈挾嚗剹��-518嚗�鷄撌行��鞟內霂滚躹蝏�辣撖�漲隡睃�嚗剹��-519嚗�鷄AI����蹂遙�∟�摨行辺 + �冽��航粉皛𡁜𢆡�亙�嚗剹��-520嚗�鷄AI���撠�𢒰�舫�厩��𣂼��喉���-521嚗��韏𡝗��𤏪������ requirements嚗剹��-522嚗㇃I嚗朞䌊�刻�霂剜� + �訫� / GUI 瘚贝�嚗剹��-523嚗���� `app/gui.py` 銝� `app/gui/` �����-523a嚗�鷄/�� �唬�頧株�銵��皜�征�屸𢒰�亙��曄內嚗剹��-404b嚗����祕��△�㰘蝸憭梯揖 toast �芸𢆡�閗繮嚗剹��-524嚗㇊yInstaller �枏�銝箏�摰㕑� exe嚗剹��-526嚗Ǒapp/ai.py` + `appconfig` �亙� cmhub backend嚗剹��-527嚗�𪈠霈曄蔭 cmhub 蝵穃��X踎嚗剹��-528嚗�鷄霈∟晶�躰秤�鞟內 + 雿䠷�撅閧內嚗剹��
- 銝衤�銝芸虾憸��隞餃𦛚嚗関-525嚗���� ruff lint + format嚗㚁�Phase 7 cmhub 撖寞𦻖撌脣��僐��
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-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-02 16:47:37 +08:00
- T-511 撌脣��琜�蝏煺�霂凋��脫踎撣賊�撌脤� T-523 餈�� `app/gui/widgets.py`嚗𥕞��﹦𢅛隞餃𦛚銵函𠶖��㮾�喳��朞� `Qt.ForegroundRole` �匧��� `stage/status` 餈𥪜� `QColor`嚗����/憭梯揖/�亥�/敺����/餈𥡝�銝剖��思蝙�� success/danger/muted/pending/info嚗䔶��劐葉��遬蝷箸�獢�′�寥�嚗䔶�蝏蹱芦�朞��瑕��脯��
2026-07-01 17:56:27 +08:00
- 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-07-02 09:57:06 +08:00
- T-514 撌脣��琜��罱鷄�W��㰘蝠�讐征�嗆���撖澆㨃����㰘揭�瑟𧒄�曄內���敺�韐血噡蝞∠��齿��桀僎頝唾蓮����㕑揭�瑚��牐遙�⊥𧒄����鞟內�惩紡�� Excel��鷄����鐥������𢅛����鐥鷄���嚗𥕦㨃��蘨�� UI 撘訫紡嚗䔶��寞�銵��韐血噡/Chrome/�餃����璉���
2026-07-02 10:21:39 +08:00
- T-515 撌脣��琜��罱鷄�W銁�䁅��箔��寞遬蝷箸鸌甈∟�摨行�餉�嚗峕�敶枏��寞活/�券��寞活�𡁜��餅㺭��紡�乓��歇�����歇�����歇�湔鰵��仃韐乓��裦餈���Z�摨行�餉�雿輻鍂敶枏��寞活�券�隞餃𦛚嚗䔶��堒虾�湔鰵�𡑒”餈�誘�𣂼�嚗𥟇㺭�格䔉�� `db.list_tasks()`嚗䔶��啣�銵剁�頧臬��斗鸌甈⊿�霈支�霈∪���
- T-516 撌脣��琜��惩紡�仿���‘朣𣂼��箝�����D��𠶖����㚁�蝑偦�㗇�銝𢛶鷄�W笆朣琜�敶枏�蝑偦�厩��𦦵鍂鈭𢛶�銵冽聢�曄內�䎚�屸���唂���/�批��U�滢��刻��湛�撖澆�瘙��餅���鸌甈∟�摨行�餉��峕𧊋�寥��圈�隞齿�敶枏��寞活�券�隞餃𦛚蝏蠘恣嚗𥟇𧊋�寥��厰僼蝏抒賒�典��滨��厩��𨅯�蝑𥕦枂�芸龪�滢遙�~��
2026-07-02 10:59:21 +08:00
- T-517 撌脣��琜��方挽蝵桅△撠��玺hopee �湔鰵摰匧� / �扯�璅∪��滚�蝵桐蛹�祉���躹嚗����抅蝖�霈暹鴌嚗�楝敺��蝡臬藁嚗剹�滚�蝵殷�`test_item_id`��dry_run` 銝滚��厩鍂�瑕虾�滢��找辣嚗䔶�摮䁅挽蝵桐�靽萘� `test_item_id` �澆捆摮埈挾撟嗅𤐄摰� `dry_run=false`嚗𢞖𢅛�峕��交𧋦頧格凒�啜�滩祗銋劐��塩��
2026-07-02 11:26:03 +08:00
- T-518 撌脣��琜��,I���撌行�靽萘�璅⊥踎�㗇𥋘���颲穃�摰嫘��鰵撱�/靽嘥�蝑厰�憸穃�����𠰴��X芋�踴��𡖂摮䀝蛹 / �滚𦶢�� / �𣳇膄�齿𤣰�𥡝��⊥𧋦憿萸�峕芋�踵�雿栶�滩��𤏪��其�隞滩��典��劐�摮�/�滚𦶢��/�𣳇膄�寞�嚗���支�甈∠&霈扎���霂臬���� prompts ��辣蝏𤘪�銝滚�嚗䔶�瘨匧� AI/Shopee/CDP��
- T-519 撌脣��琜��,I���摨閖�憓𧼮����/�曄�銝斗辺�祉�餈𥕦漲�∴��唳��淾I���餈鞱��亙��齿㺿銝箇鍂�瑕虾霂颯��䌊�冽��具����讐��蹂遙�⊥𠯫敹梹��亙��曄內�祈蔭撘�憪卝���憸�/�曄�撘�憪衤��𣂼������D/摨烾唍����典仃韐仿�霂𨰻��仃韐乓���甇Z窈瘙��摰峕�瘙��鳴�銝齿遬蝷� API Key�������ookie��oken����渲窈瘙����ase64 �曄��𤥁��� prompt嚗䔶��孵� AI/DB/Excel/Shopee/CDP �詨�瘚����
2026-07-02 15:17:11 +08:00
- T-520 撌脣��琜��,I���憿萄��𨬭�𣬚��𣂼��W㦛����鞉𧋦颲��嚗剹�滚��喉�暺䁅恕�喲𡡒隞仿��齿��譍漣�笔㦛��芋�𧢲��穿��喲𡡒�嗆�憸条��鞉��笔朖�臬�摨栞��� generated嚗䈣new_cover_path=NULL`嚗𢞖𢅛�芣凒�唳�憸䀝�銝滚����霈豢凒�啣��U�漤獈�哨�撘��舀𧒄靽脲�����𤾸㦛��舅畾萇��鞉�蝔卝��𧊋�� DB schema��I HTTP �讛悅��xcel��hopee/CDP �湔鰵瘚����
2026-07-04 17:14:29 +08:00
- T-528 撌脣��琜��,I���憿萄銁 cmhub backend 銝𧢲遬蝷箇��𣂼����雿嗵��堆�GenerateWorker 霂餃�霈∟晶 metadata嚗峕� points_cost��oints_balance��all_id �坔��望�餈鞱��亙�嚗偦��� CMHubError.code=insufficient_points �嗅撕�箝�𣬚��唬�頞喉�霂瑕����潦�滚僎銝剜迫�祈蔭�芸�憪衤遙�∴�銝漤�銝剜��躰秤摮㛖泵銝脣龪�溻��𧊋�� AI HTTP �讛悅��B schema��xcel��hopee/CDP 瘚����
2026-07-02 16:09:59 +08:00
- T-521 撌脣��琜��寧𤌍敶閙鰵憓� `requirements.txt` 撟園�摰𡁜��滩�銵䔶�韏𣇉��穿�`docs/03-tech-stack.md` �� `docs/README.md` 撌脫㺿銝� `python -m pip install -r requirements.txt` 摰㕑�嚗𥟇𧊋�啣�餈鞱��嗡�韏硔��𧊋�嫣��∩誨����
2026-07-02 16:28:04 +08:00
- T-522 撌脣��琜��啣� `.github/workflows/tests.yml`嚗�銁 push / pull_request 銝羓鍂 Windows + Python 3.11 摰㕑� `requirements.txt`嚗諹挽蝵� `QT_QPA_PLATFORM=offscreen`嚗諹䌊�刻�銵諹祗瘜閙��亙��券��訫�/GUI 瘚贝�嚗𡱰I 銝滩��亦�摰� Shopee �𣇉�摰� AI��
2026-07-02 16:47:37 +08:00
- T-523 撌脣��琜��� `app/gui.py` 撌脫�銝� `app/gui/` ����砍�撖澆�頝臬�靽脲��澆捆嚗𥟇𧋦頧桐蛹蝥舐��������芣㺿 Shopee/CDP��I��B��xcel 銵䔶蛹��
2026-07-02 17:32:51 +08:00
- T-523a 撌脣��琜��∠��颯���憪讠��僐�溻��𢅛�孵稬�峕��交𧋦頧格凒�啜�齿����憪𧢲凒�啜�齿𧒄嚗��皜�征撖孵��屸𢒰��唂�亙��曄內撟嗅��交𧋦頧桀�憪𧢲�閬��餈鞱�銝剖蘨餈賢��祈蔭�亙������ `run_logs/run_log_events` �峕𧋦�� `logs/` 銝滚��扎����芸𢆡瘛瑕�敶枏�餈鞱��屸𢒰��
- T-404b 撌脣��琜�`open_product()` �典紡�芸���祕��△�滚�摰㕑� toast �閗繮嚗𣬚�敺�祕��△�喲睸���頞�𧒄�嗡�霂餃���餈� `.eds-toasts`/toast/message ����𢠃△�Y�摮矋��𦠜�蝖桀���仃��/���銝滚���/�䭾��鞟掩 toast 銝𦠜筑銝� `���憭望�嚗�<�笔�toast>`嚗𥕦��𨅯仃韐亙��笔銁 `open_product()` ���嚗峕𧋦頧株䌊�冽鰵撱箇�憭梯揖 tab 隡𡁜��哨�憭滨鍂�冽�撌脫� tab 銝滚��哨��惩�銵兩�𣈯𧫴畾菊�嘥��芸銁餈嗵掩�𡒊&憭望��躰秤�嗆遬蝷算�𨅯���仃���嘅�摨訫�隞滢��� `stage=imported/status=failed`嚗��隞𡝗�撘�憭梯揖隞齿遬蝷算�𨅯仃韐乒�腈��
- T-524 撌脣��琜��啣� PyInstaller onedir �枏��滨蔭���撱箄��砍��穃��桀��⊿�嚗𥟇�����臬𢆡�嗅極雿𦦵𤌍敶訫��� `cmshopee.exe` ���函𤌍敶𤏪�擐𡝗活餈鞱��� exe �𣬚漣���/雿輻鍂�砍𧑐�滨蔭��B��㦛����𠯫敹𨰜��蒈敶閙����鞟內霂㵪��穃������蔭餈嗘��砍𧑐�唳旿嚗𣬚鍂�瑕�蝏剜凒�圈��典��剔�摨誩�閬��蝔见���辣����蹱𧋦�唳㺭�桃��孵���
2026-07-04 17:14:29 +08:00
- Phase 7 cmhub 蝵穃�撖寞𦻖撌脣��琜�T-526 撌脫𦻖 `app/ai.py`/`appconfig` backend嚗𣊁-527 撌脣��鐥𪈠霈曄蔭憿� cmhub backend ��揢��𢆡����滢��剹���霂閗���/�乩�憸� worker �� mock �閙�嚗𣊁-528 撌脣��鐥鷄cmhub雿䠷�撅閧內��恣韐寞𠯫敹堒��寞㺭銝滩雲銝剜迫�鞟內嚗𥕢�銝�甇亙��� T-525 ruff��
2026-07-02 17:32:51 +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��
- �砍𧑐 `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 頝臬��澆捆銝滩�蝘颯��
## 敶枏��航�銵��摰�
```bash
2026-07-02 16:09:59 +08:00
# 摰㕑����靘肽�嚗㇍-521 �𠬍�
python -m pip install -r requirements.txt
# 摰㕑��枏�靘肽�撟嗆�撱箏�摰㕑� exe嚗㇍-524 �𠬍�
python -m pip install -r requirements-build.txt
2026-07-03 09:26:27 +08:00
powershell -ExecutionPolicy Bypass -File scripts\build_exe.ps1
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 �詨��砍𧑐�唳旿璉���
2026-07-04 15:13:15 +08:00
git check-ignore -v -- config.json config/ai_models.json config/cmhub.json cmshopee.db chrome_user_data_dir/ images/
2026-06-27 09:02:05 +08:00
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-27 09:17:20 +08:00
# �訫�瘚贝�嚗㇍-006 �𡒊滲�餉��孵𢆡敹��嚗�
2026-06-26 16:27:33 +08:00
python -m unittest discover -s tests
# �閗揭�琿𡡒�荔�銝齿�鈭斤瑪銝𠺪�
2026-06-26 17:05:18 +08:00
python prototypes/demo.py # ��郊嚗㇍-000 �𦒘�憿寧𤌍�孵紡�� app.cdp嚗�
set AUTO=1 && python prototypes/demo.py # �芸𢆡嚗Ếmd嚗�
# �笔��𣂷漱嚗�馬�𠬍�T-404 �滢�閬��憭扳鸌�𧶏�
set UPDATE=1 && python prototypes/demo.py
```
�滨蔭�∩辣嚗�
- Chrome 撌脩鍂�� user-data-dir 撣� `--remote-debugging-port` + `--remote-allow-origins=*` �臬𢆡撟嗥蒈敶� Shopee��
2026-07-02 16:09:59 +08:00
- 撌脫�靘𥟇覔�桀� `requirements.txt` ���餈鞱�靘肽�嚗𥟇揢�箝��I �𡝗鰵�臬�雿輻鍂 `python -m pip install -r requirements.txt`��
2026-06-26 16:09:09 +08:00
- PySide6 敶枏��臬�撌脣虾撖澆�嚗��霂���� 6.5.3嚗㚁�GUI 摰䂿緵�箏�雿輻鍂 PySide6��
- 暺䁅恕餈� `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+��
## 撘�憪讠����璉���
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` 蝚砌�����
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`��
- 隞餃𦛚�嗆����硋�甇� [`06-tasks.md`](06-tasks.md)嚗𥟇�銵諹扇敶閗蕭�� [`../progress.md`](../progress.md)��
- �祆��芯��坔��滚翰�改�銝滢��坔��游��脯��