Skip to content

PROJECT_STRUCTURE_DETAILED.md

Latest commit

 

History

History
125 lines (101 loc) · 12.3 KB

PROJECT_STRUCTURE_DETAILED.md

File metadata and controls

125 lines (101 loc) · 12.3 KB

Python 妞ゅ湱娲伴惄顔肩秿缂佹挻鐎拠锔剧矎鐠囧瓨妲戦敍鍫濇儓閸忣剙鍙￠懗钘夊閿?

閺堫剚鏋冨锝嗘Ц娴犳挸绨辩痪褉鈧粏顕涚紒鍡楊嚤閼割亜娴橀垾婵撶礉閻劋绨箛顐︹偓鐔锋礀缁涙棑绱?

  1. 娴狅絿鐖滈弨鎯ф憿闁?
  2. 閺傜増膩閸ф顩ф担鏇熷复閸?
  3. 閸忣剙鍙￠懗钘夊閹簼绠炴径宥囨暏閿涘牆鎸ㄩ崗?Collection/shared/common閿?

1. 閺嶅湱娲拌ぐ鏇☆嚛閺?

d:\code\Python閿?

  • .github/閿涙I 娑撳氦鍤滈崝銊ュ濞翠胶鈻奸柊宥囩枂閵?- .vscode/閿涙碍婀伴崷?IDE 闁板秶鐤嗛妴?- Collection/閿涙碍鐗宠箛鍐х瑹閸斺€插敩閻胶娲拌ぐ鏇礄娑撹绱戦崣鎴濆隘閿涘鈧?- docs/閿涙艾鍙忕仦鈧弬鍥ㄣ€傞惄顔肩秿閿涘牐绻嶇悰灞惧閸愬被鈧胶绮ㄩ弸鍕嚛閺勫簺鈧焦涓嶉悶鍡氼潐閼煎喛绱氶妴?- scripts/閿涙碍鐗寸痪褑鍓奸張顒婄礄娑撴槒顩﹂弰?Windows 閸氼垰濮╅幍鐟邦槱閻炲棴绱氶妴?- gasgx_article_content_collection_worker.py閿涙asGx 濮濓絾鏋冮柌鍥肠閸忕厧顔愭稉璇插弳閸欙絻鈧?- p17.py閿涙艾宸婚崣鎻掑悑鐎圭懓鍙嗛崣锝忕礄鏉烆剙褰傞崚鐗堟煀閸忋儱褰涢敍澶堚偓?- watch_gasgx_article_content_collection_worker.ps1閿涙碍顒滈弬鍥櫚闂嗗棛娲冮崥顒冨壖閺堫兙鈧?- watch_p17.ps1閿涙艾宸婚崣鎻掑悑鐎瑰湱娲冮崥顒冨壖閺堫兙鈧?- requirements.txt閿涙碍鐗寸痪褌绶风挧鏍モ偓?- scheduled_tasks_full_list.csv閿涙俺顓搁崚鎺嶆崲閸斺剝绔婚崡鏇☆唶瑜版洏鈧?

2. Collection 娑撹鍞惍浣稿隘缂佹挻鐎?

Collection/閿?

  • configs/閿涙氨绮烘稉鈧柊宥囩枂閿涘潊pps/profiles/rules閿涘鈧?- gasgx/閿涙asGx 娑撴艾濮熷Ο鈥虫健閵?- cybercar/閿涙ybercar 娑撴艾濮熷Ο鈥虫健閵?- other/閿涙艾鍙炬禒鏍缁斿浼愰崗?濡€虫健閵?- shared/閿涙俺娉曞Ο鈥虫健閸忣剙鍙￠懗钘夊閿涘牓鍣搁悙鐧哥礆閵?- scripts/閿涙ollection 缁狙嗗壖閺堫剨绱欑拋鈥冲灊娴犺濮熷▔銊ュ斀閵嗕浇绻嶇悰宀冨壖閺堫剨绱氶妴?- data/閿涙俺绻嶇悰灞奸獓閻椻晪绱欓弮銉ョ箶閵嗕胶濮搁幀浣碘偓涔籩crets 缁涘绱氶妴?- docs/閿涙瓖elegram 閺堝搫娅掗崡蹇氼唴娑撳氦绻嶇悰灞惧閸愬被鈧?- templates/閿涙碍膩閸ф膩閺夊尅绱欓弬鏉款杻濡€虫健娴ｈ法鏁ら敍澶堚偓?

3. 娑撴艾濮熷Ο鈥虫健閸掑棗灏?

3.1 GasGx

  • Collection/gasgx/gasgx_article_link_collection_module/
    • 娴ｆ粎鏁ら敍姘舵懠閹恒儱褰傞悳鑸偓浣界箖濠娿們鈧礁骞撻柌宥冣偓浣瑰闁?scrape_queue閵? - 閹恒劏宕橀崗銉ュ經閿涙瓪python -m Collection.gasgx.gasgx_article_link_collection_module.cli`
  • Collection/gasgx/gasgx_article_content_collection_module/
    • 娴ｆ粎鏁ら敍姘Х鐠?scrape_queue 閹舵挻顒滈弬鍥モ偓浣稿瀻閺嬫劑鈧焦瑕嗛弻鎾扁偓浣稿絺鐢啨鈧? - 閹恒劏宕橀崗銉ュ經閿涙瓪python -m Collection.gasgx.gasgx_article_content_collection_module.cli`
  • Collection/gasgx/gasgx_canadian_natural_gas_data_acquisition_module/
    • 娴ｆ粎鏁ら敍姘閹峰灝銇囨径鈺冨姧濮樻梹鏆熼幑顕€鍣伴梿鍡曠瑢閸忋儱绨遍妴?

3.2 CyberCar

  • Collection/cybercar/cybercar_video_capture_and_publishing_module/
    • 娴ｆ粎鏁ら敍姘辩閺夋劙鍣伴梿鍡愨偓浣割槱閻炲棎鈧線顣╃€孤扳偓浣割樋楠炲啿褰撮崣鎴濈閵? - 閹恒劏宕橀崗銉ュ經閿涙瓪python -m Collection.cybercar.cybercar_video_capture_and_publishing_module.cli`

3.3 Other

  • Collection/other/script_control_center/
    • 娴ｆ粎鏁ら敍姘冲壖閺堫剙鐫嶇粈鎭掆偓浣瑰⒔鐞涘矁顕Ч鍌涚Х鐠愬箍鈧浇鍓奸張顒佹暈閸愬苯鎮撳銉ｂ偓?- Collection/other/notebooklm_link_tools/
    • 娴ｆ粎鏁ら敍姝俹tebookLM 閻╃鍙ч柧鐐复瀹搞儱鍙块妴?- Collection/other/omnicode_ui_prototype/
    • 娴ｆ粎鏁ら敍姝嶪 閸樼喎鐎烽妴?

4. 閸忣剙鍙￠懗钘夊鐠囷妇绮忕拠瀛樻閿涘牓鍣搁悙鐧哥礆

閸忣剙鍙￠懗钘夊娴ｅ秳绨敍姝欳ollection/shared/`

4.1 common閿涘牊鐗宠箛鍐槻閻劌鐪伴敍?

鐠侯垰绶為敍姝欳ollection/shared/common/`

  • env.py
    • 閻劑鈧棑绱伴崝鐘烘祰 .env閿涘瞼绮烘稉鈧悳顖氼暔閸欐﹢鍣虹憗鍛版祰閸忋儱褰涢妴? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪load_dotenv_if_available`
  • paths.py
    • 閻劑鈧棑绱扮捄顖氱窞鐟欏嫯瀵栭崠鏍︾瑢閻╃顕?缂佹繂顕捄顖氱窞鐟欙絾鐎介妴? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪resolve_local_path閵嗕梗normalize_path_text閵嗕梗portable_relpath`
  • session.py
    • 閻劑鈧棑绱癏TTP 娴兼俺鐦介妴涓唎okie 濞夈劌鍙嗛妴浣烘瑜版洘鈧焦顥呴弻銉ｂ偓浣虹秹妞ゅ灚濮勯崣鏍モ偓? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪create_http_session閵嗕梗load_auth_cookies閵嗕梗check_login_state`
  • supabase.py
    • 閻劑鈧棑绱癝upabase 閸戭厽宓佺憴锝嗙€芥稉搴☆吂閹撮顏崚娑樼紦閵? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪resolve_supabase_credentials閵嗕梗create_supabase_client
  • meta.py
    • 閻劑鈧棑绱版禒?HTML 閹惰棄褰囬崺铏诡攨 meta 娣団剝浼呴妴?- notify.py
    • 閻劑鈧棑绱伴柇顔绘/SMS 闁氨鐓＄紒鐔剁鐎圭偟骞囬妴? - 閺€顖涘瘮閿涙瓔MTP閵嗕阜esend閵嗕竻revo閵嗕胶鐓穱锛勭秹閸忓磭鐡戦妴?- bot_notify.py
    • 閻劑鈧棑绱伴張鍝勬珤娴滄椽鈧氨鐓＄紒鐔剁閸忋儱褰涢敍鍦礶Com/Telegram/Email閿涘鈧? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪send_notification閵嗕梗resolve_telegram_bot_settings
  • telegram_api.py
    • 閻劑鈧棑绱癟elegram API 闁氨鏁ょ拫鍐暏鐏忎浇顥婇敍鍫ュ櫢鐠囨洏鈧浇绉撮弮韬测偓渚€鏁婄拠顖氼槱閻炲棴绱氶妴? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪call_telegram_api`
  • telegram_bot_registry.py
    • 閻劑鈧棑绱伴張鍝勬珤娴滅儤鏁為崘宀冦€冮崝鐘烘祰閵嗕浇顫夐懠鍐ㄥ閵嗕礁顤冮崚鐘虫暭閺屻儯鈧礁鍙ч柨顔肩摟/handler 缁狅紕鎮婇妴? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪load_registry閵嗕梗save_registry閵嗕梗set_bot_handler_type`
  • telegram_bot_dispatch.py
    • 閻劑鈧棑绱伴幐澶婂彠闁款喖鐡х捄顖滄暠閺堝搫娅掓禍鍝勮嫙閸欐垿鈧焦绉烽幁顖樷偓? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪resolve_bot_by_keyword閵嗕梗send_text_by_keyword
  • telegram_chat_id_resolver.py
    • 閻劑鈧棑绱伴崺杞扮艾 BotFather 閺傚洦婀伴崪?getUpdates 鐟欙絾鐎?chat_id閵?- telegram_bot_manager_worker.py
    • 閻劑鈧棑绱伴幀鑽ゎ吀閺堝搫娅掓禍?worker閿涘牏娣幎銈嗘暈閸愬矁銆冮妴浣告嚒娴犮倗顓搁悶鍡礆閵?- telegram_multi_bot_guard_worker.py
    • 閻劑鈧棑绱版径?bot 閸楁洝绻樼粙?guard閿涘瞼绮烘稉鈧潪顔款嚄楠炴儼鐭鹃悽?manager/cybercar/passive閵?- xfyun_spark.py
    • 閻劑鈧棑绱伴弰鐔轰紑濡€崇€烽柊宥囩枂娑撳氦鐨熼悽銊ョ殱鐟佸懌鈧? - 鐢摜鏁ょ猾浼欑窗SparkAIClient
  • script_registry_trigger.py
    • 閻劑鈧棑绱伴懘姘拱閸欐ɑ娲挎禍瀣╂娑撳孩鏁為崘宀冃曢崣鎴濇珤閵?- coding_completion_notify.py
    • 閻劑鈧棑绱扮紓鏍垳鐎瑰本鍨氶崥搴ㄢ偓姘辩叀閼辨艾鎮庨敍鍫濆綁閺囧瓨鎲崇憰?+ 閸欐垿鈧緤绱氶妴?- __init__.py
    • 閻劑鈧棑绱扮€电懓顦荤€电厧鍤崗顒€鍙?API閿涘牊甯归懡鎰矤鏉╂瑩鍣风€电厧鍙嗛敍灞藉櫤鐏忔垼鐨熼悽銊︽煙閼帮箑鎮庨敍澶堚偓? 瀵ら缚顔呴敍?
  • 閺傜増膩閸фぞ绱崗鍫濐槻閻?Collection.shared.common閿涘矂浼╅崗宥夊櫢婢跺秴鐤勯悳浼粹偓姘辩叀閵嗕箑elegram閵嗕浇鐭惧鍕瑢娴兼俺鐦介柅鏄忕帆閵?- 闂団偓鐟?Telegram 閺冩湹绱崗鍫㈢矋閸氬牞绱癭telegram_bot_registry + telegram_bot_dispatch + telegram_multi_bot_guard_worker`閵?

4.2 pipeline

鐠侯垰绶為敍姝欳ollection/shared/pipeline/`

  • classification.py
    • 閻劑鈧棑绱癎asGx 鐟欏嫬鍨崝鐘烘祰閵嗕焦鏋冮張顒€鍨庣猾姹団偓浣稿敶鐎?hash 鐠侊紕鐣婚妴? - 鐢摜鏁ら崙鑺ユ殶閿涙瓪load_gasgx_rules閵嗕梗classify_text_with_gasgx_rules

4.3 storage

鐠侯垰绶為敍姝欳ollection/shared/storage/`

  • schema.sql
    • 閻劑鈧棑绱伴弽绋跨妇鐎涙ê鍋嶇紒鎾寸€€规矮绠熼敍鍫濈紦鐞涖劋绗岀紒鎾寸€崣鍌濃偓鍐跨礆閵?

4.4 templates

鐠侯垰绶為敍姝欳ollection/shared/templates/`

  • 娴ｆ粎鏁ら敍姘閺屾挻膩閺夊尅绱欐俊?GasGx 妞ょ敻娼板Ο鈩冩緲閿涘鈧?

5. 闁板秶鐤嗘稉搴ょ箥鐞涘本鏆熼幑?

5.1 闁板秶鐤?

  • Collection/configs/apps/閿涙艾绨查悽銊ч獓闁板秶鐤嗛敍鍫熌侀崸妤呭帳缂冾喓鈧礁鍙ч柨顔跨槤闁板秶鐤嗙粵澶涚礆閵?- Collection/configs/profiles/閿涙氨鐝悙?閸╃喎鎮曢幎鎾冲絿缁涙牜鏆愰妴?- Collection/configs/rules/閿涙俺顫夐崚娆愭Ё鐏忓嫸绱欐俊鍌氬瀻缁槒顫夐崚娆欑礆閵?

5.2 閺佺増宓佹稉搴ｅЦ閹?

  • Collection/data/runtime/閿涙俺绻嶇悰灞炬埂鏉堟挸鍤妴?- Collection/data/runtime/logs/閿涙碍妫╄箛妞尖偓?- Collection/data/runtime/secrets/閿涙碍鏅遍幇鐔煎帳缂冾噯绱欐俊?Telegram 濞夈劌鍞界悰顭掔礆閵?

6. 閼存碍婀扮仦鍌滅波閺?

6.1 閺嶅湱楠?Windows 閼存碍婀?

鐠侯垰绶為敍姝歴cripts/windows/`

  • 娑撴槒顩﹂悽銊ょ艾閸忕厧顔愰崗銉ュ經閸滃苯鐖舵す璇叉儙閸斻劊鈧?- 閺傛澘顤冩禍鍡曠闁款喗顥呴弻銉窗run_repo_contract_checks.bat

6.2 Collection 缁?Windows 閼存碍婀?

鐠侯垰绶為敍姝欳ollection/scripts/windows/`

  • 鐠佲€冲灊娴犺濮熷▔銊ュ斀/閸欏秵鏁為崘宀冨壖閺堫兙鈧?- 濡€虫健鏉╂劘顢戦懘姘拱閿涘潉run_*.ps1`閿涘绱濇担婊€璐熺拋鈥冲灊娴犺濮熼幒銊ㄥ礃閸忋儱褰涢妴?- Telegram 閻╃鍙х€瑰牊濮?缁狅紕鎮婇懘姘拱娑旂喎婀銈囨窗瑜版洏鈧?

7. 閺傜増膩閸ф甯撮崗銉ョ紦鐠侇喛鐭惧鍕剁礄瑜版挸澧犻弽鍥у櫙閿?

  1. 娴犲孩膩閺夊灝顦查崚璁圭窗Collection/templates/module_starter/
  2. 鐎瑰本鍨氶張鈧亸蹇擃殩缁撅讣绱癭main.py閵嗕梗cli.py閵嗕梗config.py閵嗕梗README.md閵嗕梗module_manifest.yaml`
  3. 鐞?Windows 鏉╂劘顢戦懘姘拱閿涙瓪Collection/scripts/windows/run_.ps1`
  4. 閺囧瓨鏌婄槐銏犵穿閺傚洦銆傞敍姝歞ocs/FILES.md閵嗕梗docs/repo/WORKSPACE_STRUCTURE.md
  5. 閹笛嗩攽閺嶏繝鐛欓敍? - python Collection/scripts/validate_module_contract.py
    • scripts/windows/run_repo_contract_checks.bat
  6. 閸欏倻鍙?VS Code + Codex 娴ｆ粈绗熷ù浣瑰⒔鐞涘苯鐣炬担宥勭瑢閺€璺哄經閿涙瓪docs/standards/CODEX_WORKFLOW.md`

8. 缂佸瓨濮㈢憰浣圭湴

  • 閻╊喖缍嶉妴浣稿弳閸欙絻鈧線鍘ょ純顔煎綁閺囨潙鎮楅敍灞界箑妞よ鎮撳銉︽纯閺傜増婀伴弬鍥ㄣ€傛稉搴ｆ祲閸忓磭鍌ㄥ鏇熸瀮濡楋絻鈧?- 閸忣剙鍙￠懗钘夊鐠嬪啯鏆ｉ敍鍫濇尐閸?shared/common閿涘鎮楅敍宀勬付閸氬本顒為弴瀛樻煀鐠嬪啰鏁ょ痪锕€鐣剧拠瀛樻閵?

9. VS Code + Codex 瀵偓閸欐垵鐣炬担宥呭弳閸?

  • 閹笛嗩攽閹靛鍞介敍姝歞ocs/VS_CODE_CODEX_MODULE_SOP.md`
  • 鐎圭偞鍨弽铚傜伐閿涙瓪docs/standards/CODEX_WORKFLOW.md`
  • 闁插秶鍋ｆ禍褏澧块敍姝欼mpact Map閿涘牆鍙嗛崣?闁板秶鐤?鏉╂劘顢戦弮?闁氨鐓?鐠嬪啫瀹抽敍?+ Change Receipt`
  • 閺堚偓鐏忓繘鐛欓弨璺烘嚒娴犮倧绱? - python -m <your.module>.cli --help
    • python -m <your.module>.cli --dry-run
    • python Collection/scripts/validate_module_contract.py
    • scripts/windows/run_repo_contract_checks.bat