cmhub/docs/current-state.md

# 蠖灘燕螳樒鴫迥ｶ諤�

> 譛ｬ譁�弍蜿ｯ隕�尠逧�ｽ灘燕蠢ｫ辣ｧ�瑚ｮｰ蠖穂ｻ｣遐∽ｸ惹ｻｻ蜉｡逵区攸逧�鴫螳樒憾諤�ｼ悟ｸｮ蜉ｩ AI coding agent 驕ｿ蜈榊宵逵玖ｮ｡蛻定€悟ｿｽ逡･莉灘ｺ鍋鴫迥ｶ縲�
> 蜴�彰謇ｧ陦梧ｵ∵ｰｴ霑ｽ蜉�蛻ｰ [`../progress.md`](../progress.md)�御ｸ崎ｦ∝惠譛ｬ譁�㍾螟咲ｻｴ謚､螳梧紛謇ｧ陦梧律蠢励€�

## 閨瑚ｴ｣霎ｹ逡�

- [`06-tasks.md`](06-tasks.md)�壻ｻｻ蜉｡逵区攸�檎ｻｴ謚､莉ｻ蜉｡迥ｶ諤√€∽ｾ晁ｵ門柱鬪梧噺隕∫せ縲�
- [`../progress.md`](../progress.md)�壽鴬陦梧ｵ∵ｰｴ�悟宵霑ｽ蜉�隶ｰ蠖墓ｯ剰ｽｮ謇ｧ陦後€�ｪ瑚ｯ√€�仆蝪槫柱蜀ｳ遲悶€�
- `current-state.md`�壼ｽ灘燕蠢ｫ辣ｧ�悟庄隕�尠譖ｴ譁ｰ蠖灘燕逶ｮ蠖輔€∝ｽ灘燕蜻ｽ莉､縲∝ｷｲ螳梧�鞫倩ｦ∝柱荳倶ｸ€豁･縲�

## 蠖灘燕蠢ｫ辣ｧ

- 譌･譛滂ｼ�2026-07-06
- 髦ｶ谿ｵ�啀hase 6 蠅槫ｼｺ��VP 蜷趣ｼ会ｼ娜hase 3 蟇ｹ螟� API 荳主�蛟ｼ蟾ｲ螳梧�蛻ｰ T-306�訓hase 4 逕ｨ謌ｷ遶ｯ T-501 豕ｨ蜀� / 逋ｻ蠖包ｼ�llauth�峨€ゝ-502 API Key 閾ｪ蜉ｩ邂｡逅�｡ｵ縲ゝ-503 荳ｪ莠ｺ荳ｭ蠢� / 隶ｰ蠖暮｡ｵ縲ゝ-504 蜈�€ｼ鬘ｵ荳� T-505 逕ｨ謌ｷ遶ｯ螳｡譬ｸ莨伜喧蟾ｲ螳梧��訓hase 5 T-401 霑占是蜷主床螳悟埋縲ゝ-402 MVP 螳梧紛鬪梧噺荳� T-403 驛ｨ鄂ｲ / 霑占｡梧枚譯｣蟾ｲ螳梧��訓hase 6 T-601 蜿ｯ逕ｨ蛻ｫ蜷榊書邇ｰ縲ゝ-602 django-admin 荳ｭ譁�喧隨ｬ 1-3 螻ゅ€ゝ-603 django-admin 蟄玲ｮｵ郤ｧ荳ｭ譁�喧縲ゝ-604 荳ｭ譁�撫諢溯ｯ肴悽蝨ｰ霑�ｻ､縲ゝ-605 蜈埼ぐ邂ｱ鬪瑚ｯ∫ｭ也払關ｽ蝨ｰ縲ゝ-606 蜈ｬ蠑€鬥夜｡ｵ + 螳｢謌ｷ遶ｯ荳玖ｽｽ蜈･蜿｣蟾ｲ螳梧��帛錘扈ｭ蜿ｯ扈ｧ扈ｭ螟�炊逵溷ｮ樊髪莉伜屓隹�芦雍ｦ髣ｭ邇ｯ縲∝ｮ｢謌ｷ遶ｯ荳玖ｽｽ蛹�書蟶��逵溷ｮ槫崟迚�€玲慮鬪瑚ｯ�
- 謚€譛ｯ譬茨ｼ夂ｳｻ扈� Python 3.12.3 + Django 5.2.15 + DRF 3.16.1 + django-allauth 65.18.0 + PyMySQL 1.1.3 + cryptography 49.0.0 + requests 2.34.2 + ahocorapy 1.6.2 + wechatpayv3 2.0.2 + python-alipay-sdk 3.4.0 + django-admin�娥ySQL 8.4 蟾ｲ謗･蜈･ settings�悟ｹｶ謾ｯ謖� `MYSQL_CONNECT_TIMEOUT` / `MYSQL_READ_TIMEOUT` / `MYSQL_WRITE_TIMEOUT`�帷畑謌ｷ遶ｯ蟾ｲ逕ｨ Django 讓｡譚ｿ SSR + Bootstrap + allauth 關ｽ蝨ｰ豕ｨ蜀檎匳蠖包ｼ帷函莠ｧ驛ｨ鄂ｲ蜿｣蠕�ｸｺ VPS / 螳晏｡� + Nginx + Gunicorn(gthread) + systemd�幄ｯｦ隗� `03-tech-stack.md` 荳� `deployment.md`
- 逕滉ｺｧ莉｣遐�ｼ壼ｷｲ譛画怙蟆� Django 蟾･遞矩ｪｨ譫ｶ�啻manage.py`縲～config/`�婬-002 蟾ｲ蛻帛ｻｺ `apps/users|portal|billing|ai|api`�婬-003 蟾ｲ謚願�螳壻ｹ� `User` 豕ｨ蜀瑚ｿ� django-admin�婬-004 蟾ｲ螳梧� email 蜚ｯ荳€諤ｧ縲（nit 迚域悽譁ｭ險€縲∥pp 鬘ｺ蠎上€～.env.example` 荳� `pyproject.toml`�婬-101 蟾ｲ譁ｰ蠅� `apps/ai/providers/`��rovider 謗･蜿｣縲∵ｳｨ蜀瑚｡ｨ縲…hat/gemini/images/images_edits 騾る�蝎ｨ�会ｼ婬-102 蟾ｲ譁ｰ蠅� `AiModel` / `ModelAlias`縲：ernet 蜉�蟇�ｯ�徴蟄伜お縲∝悪蜷崎ｧ｣譫舌€∥dmin 驟咲ｽｮ鬘ｵ縲～import_ai_models` 蟇ｼ蜈･蜻ｽ莉､�婬-103 蟾ｲ譁ｰ蠅� `AiConfigAuditLog` 螳｡隶｡陦ｨ縲∥dmin 蜿ｪ隸ｻ鬘ｵ髱｢蜥悟錘蜿ｰ菫晏ｭ�/蛻�髯､螳｡隶｡ hook�婬-104/T-105 蟾ｲ螳梧�蠖募宛 title/image smoke 荳主ｮ｡譬ｸ菫ｮ陦･�婬-201 蟾ｲ譁ｰ蠅� `UserWallet` / `ApiKey`縲～PointsLedger` / `CallRecord`縲∝ｯｹ蠎� admin 荳手ｿ∫ｧｻ�婬-202 蟾ｲ譁ｰ蠅� `PricingRule` / `ExchangeRate`縲～apps.billing.pricing` 隶｡雍ｹ隶｡邂怜�謨ｰ縲∥dmin 驟咲ｽｮ鬘ｵ荳手ｿ∫ｧｻ�婬-203 蟾ｲ譁ｰ蠅� `apps.billing.services`�悟ｮ樒鴫蟷ｶ蜿大ｮ牙�鬚�殴縲∵�蜉溽｡ｮ隶､荳主ｹらｭ牙､ｱ雍･騾€轤ｹ�婬-204 蟾ｲ譁ｰ蠅� `billing.0003_pointsledger_unique_ledger_change_type_per_call`�檎畑 MySQL 蜿ｯ關ｽ蝨ｰ逧� `ref_call + change_type` 螟榊粋蜚ｯ荳€郤ｦ譚溷�蠎暮亟驥榊､� refund�婬-301 蟾ｲ譁ｰ蠅� `apps.api.authentication.ApiKeyAuthentication` 荳� `ExternalApiView`�婬-302 蟾ｲ譁ｰ蠅樒函謌先磁蜿｣郛匁賜縲∝ｺ丞�蛹門勣縲∝崟迚�悽蝨ｰ蟄伜お蜥� `/api/v1/generate/title|image` 霍ｯ逕ｱ�婬-303 蟾ｲ譁ｰ蠅� `apps.billing.services.get_balance_snapshot()` 荳� `/api/v1/balance` 菴咎｢晄衍隸｢謗･蜿｣�婬-304 蟾ｲ譁ｰ蠅� `RechargeOrder`縲∝�蛟ｼ蝗櫁ｰ�ｪ檎ｭｾ騾る�蝎ｨ縲∝ｹらｭ牙�雍ｦ譛榊苅縲∝ｾｮ菫｡/謾ｯ莉伜ｮ晏屓隹�ｷｯ逕ｱ荳手ｿ∫ｧｻ `billing.0004_rechargeorder_and_more`�婬-305 蟾ｲ譁ｰ蠅� `create_recharge_order()`縲∝ｾｮ菫｡/謾ｯ莉伜ｮ晄沖遐∽ｸ句黒 mock/SDK 蜈･蜿｣縲～/api/v1/recharge/create` 荳� `/api/v1/recharge/status`�婬-306 蟾ｲ譁ｰ蠅� `apps.api.throttles`縲～apps.api.exceptions`縲～REST_FRAMEWORK` 螳牙�鮟倩ｮ､隶､隸√€∫函謌�/隶､隸∝､ｱ雍･髯先ｵ√€～image_url` SSRF 髦ｲ謚､荳主桃蠎泌､ｧ蟆丈ｸ企剞縲∝�蛟ｼ蜊慕ｬ秘≡鬚昜ｸ企剞�婬-501 蟾ｲ謗･蜈･ allauth�梧眠蠅� portal 霍ｯ逕ｱ縲∵ｳｨ蜀碁€る�蝎ｨ縲∫匳蠖�/豕ｨ蜀�/逋ｻ蜃ｺ讓｡譚ｿ蜥梧怙蟆� dashboard�梧ｳｨ蜀梧�蜉溷�蟒ｺ 0 轤ｹ髓ｱ蛹�ｸ比ｸ榊�襍�轤ｹ豬∵ｰｴ�婬-502 蟾ｲ譁ｰ蠅� `/apikeys`縲、PI Key 蛻帛ｻｺ陦ｨ蜊輔€∝�陦ｨ鬘ｵ蜥悟唖髯､�亥衰髞€�牙勘菴懶ｼ檎函謌仙錘譏取枚蜿ｪ譏ｾ遉ｺ荳€谺｡�悟�陦ｨ蜿ｪ譏ｾ遉ｺ prefix�婬-503 蟾ｲ謇ｩ螻� `/dashboard` 荳ｺ荳ｪ莠ｺ荳ｭ蠢�ｱ�€ｻ�悟ｹｶ譁ｰ蠅� `/records/recharge` 蜈�€ｼ隶ｰ蠖穂ｸ� `/records/usage` 豸郁ｴｹ隶ｰ蠖包ｼ悟宵隸ｻ螻慕､ｺ蠖灘燕逕ｨ謌ｷ謨ｰ謐ｮ�婬-504 蟾ｲ譁ｰ蠅� `/recharge` 鬘ｵ髱｢縲～RechargeCreateForm`縲∝�蛟ｼ蟇ｼ闊ｪ蜈･蜿｣蜥瑚ｽｮ隸｢閼壽悽�碁｡ｵ髱｢蛻帛ｻｺ pending 隶｢蜊輔€∝ｱ慕､ｺ莠檎ｻｴ遐∫･ｨ謐ｮ縲∬ｽｮ隸｢ `/api/v1/recharge/status`�瑚ｮ｢蜊� paid 蜷主姐譁ｰ菴咎｢晢ｼ婬-505 蟾ｲ謚� Bootstrap 5 CSS 荳� qrcode.js vendoring 蛻ｰ `apps/portal/static/portal/vendor/`�碁｡ｵ髱｢荳榊�萓晁ｵ� jsdelivr�悟ｹｶ謚雁�蛟ｼ隶ｰ蠖� / 豸郁ｴｹ隶ｰ蠖墓隼荳ｺ Django `Paginator` 蛻�｡ｵ�婬-401 蟾ｲ譁ｰ蠅� `adjust_wallet_points()` 謇句ｷ･隹�せ譛榊苅縲�蝶蛹� admin 荳鍋畑隹�せ陦ｨ蜊穂ｸ取ｨ｡譚ｿ�悟錘蜿ｰ蜿ｯ邂｡逅�/譽€邏｢逕ｨ謌ｷ縲�蝶蛹�€、PI Key�郁┳謨擾ｼ峨€∬ｮ｡雍ｹ隗��縲∵ｱ�紫縲∝�蛟ｼ隶｢蜊輔€∫せ謨ｰ豬∵ｰｴ蜥瑚ｰ�畑隶ｰ蠖包ｼ梧ｵ∵ｰｴ/隶｢蜊�/隹�畑隶ｰ蠖穂ｿ晄戟蜿ｪ隸ｻ�婬-402 蟾ｲ譁ｰ蠅� `docs/mvp-acceptance.md`�梧潔 P0 鬪梧噺遏ｩ髦ｵ隶ｰ蠖� MVP 螳梧紛鬪梧噺扈楢ｮｺ縲∵ｵ玖ｯ戊ｯ∵紺蜥悟ｷｲ遏･髯仙宛�婬-403 蟾ｲ譁ｰ蠅� `docs/deployment.md` 荳� `requirements-production.txt`�悟ｹｶ蝨ｨ settings 荳ｭ陦･鮨� `STATIC_ROOT`縲～CSRF_TRUSTED_ORIGINS`縲∝�莠ｫ `CACHES`縲？TTPS cookie縲｝roxy SSL 荳� HSTS 邇ｯ蠅�序驥乗髪謖�ｼ婬-601 蟾ｲ譁ｰ蠅� `apps.ai.catalog.get_public_model_catalog()`縲～GET /api/v1/models` 荳� portal `/models` 蜿ｪ隸ｻ鬘ｵ髱｢�悟宵螻慕､ｺ active 蜿ｯ隹�畑蛻ｫ蜷阪€∬�蜉帙€∵弍蜷ｦ髴€隕∝次蝗ｾ蜥檎せ謨ｰ蜊穂ｻｷ�御ｸ崎ｧ｣蟇� provider key�御ｸ肴垓髴ｲ蠎募ｱ� SKU / URL / key / `extra_body`�婬-604 蟾ｲ譁ｰ蠅� `apps.moderation`縲～SensitiveWord` 讓｡蝙�/admin/霑∫ｧｻ縲〔eyword provider縲∝ｽ剃ｸ€蛹也ｮ｡郤ｿ蜥悟�莠ｫ cache 迚域悽螟ｱ謨茨ｼ檎函謌先磁蜿｣蟾ｲ謾ｹ荳ｺ prompt 蜈亥ｮ｡蜀崎ｯｻ蜿門崟迚�/隶｡雍ｹ/謇｣轤ｹ/隹�ｸ頑ｸｸ�婬-606 蟾ｲ譁ｰ蠅槫�蠑€鬥夜｡ｵ `/`縲～DownloadRelease` 讓｡蝙�/admin/霑∫ｧｻ縲�
- 逕ｨ謌ｷ遶ｯ蟇ｼ闊ｪ�夐｡ｶ驛ｨ蟇ｼ闊ｪ active 迥ｶ諤∝ｷｲ菫ｮ螟搾ｼ形portal/base.html` 蝓ｺ莠� `request.resolver_match.url_name` 鬮倅ｺｮ蠖灘燕鬘ｵ髱｢蜈･蜿｣�悟ｹｶ逕ｨ `aria-current="page"` 譬�ｮｰ�帙€悟�蛟ｼ縲堺ｸ榊�蝨ｨ髱槫�蛟ｼ鬘ｵ蝗ｺ螳壽ｷｱ濶ｲ鬮倅ｺｮ縲�
- 豬玖ｯ包ｼ啜-601 蟾ｲ鬪瑚ｯ�ｼ啻.\init.ps1` 騾夊ｿ�ｼ�ython 3.12.3�御ｾ晁ｵ門ｷｲ貊｡雜ｳ�形manage.py check` 0 issues�梧遠蜊ｰ蜷ｯ蜉ｨ蜻ｽ莉､�会ｼ嫣py -3.12 -m py_compile apps\ai\catalog.py apps\api\views.py apps\api\urls.py apps\api\tests.py apps\portal\views.py apps\portal\urls.py apps\portal\tests.py` 騾夊ｿ�ｼ嫣py -3.12 manage.py check` 騾夊ｿ�ｼ嫣py -3.12 manage.py makemigrations --check --dry-run` 譌�蜿伜喧�嫣git diff --check` 騾夊ｿ�ｼ嫣py -3.12 manage.py test apps.api.tests.ModelsCatalogApiTests apps.portal.tests.PortalAccountFlowTests.test_models_page_requires_session_login apps.portal.tests.PortalAccountFlowTests.test_models_page_lists_public_aliases_prices_and_unpriced_state --keepdb --noinput --verbosity 2` 鬥匁ｬ｡霑占｡梧慮 3 譚｡ API 豬玖ｯ募ｷｲ騾夊ｿ�ｼ継ortal `setUpClass` 髦ｶ谿ｵ蝗�霑懃ｨ� MySQL 霑樊磁 43.128.3.240 雜�慮荳ｭ譁ｭ�幃囂蜷� `Test-NetConnection 43.128.3.240 -Port 3306` 譏ｾ遉ｺ `TcpTestSucceeded=True`�悟黒迢ｬ驥崎ｷ台ｸ､譚｡ portal 豬玖ｯ暮€夊ｿ�ｼ�2 tests OK縲５-403 蟾ｲ鬪瑚ｯ�ｼ啻./init.ps1` 蠑€蟾･蜑埼€夊ｿ�ｼ嫣py -3.12 manage.py check` 騾夊ｿ�ｼ嫣py -3.12 manage.py makemigrations --check --dry-run` 譌�蜿伜喧�嫣py -3.12 manage.py findstatic portal/vendor/bootstrap/bootstrap.min.css portal/vendor/qrcode/qrcode.js --verbosity 1` 謇ｾ蛻ｰ荳､荳ｪ譛ｬ蝨ｰ static 譁�ｻｶ�嫣py -3.12 manage.py check --deploy` 蝨ｨ蠖灘燕蠑€蜿� `.env` 荳倶ｻ�冠鬚�悄螳牙�驟咲ｽｮ隴ｦ蜻奇ｼ御ｸｴ譌ｶ豕ｨ蜈･逕滉ｺｧ蝙句ｮ牙�邇ｯ蠅�序驥擾ｼ亥性 HSTS includeSubDomains/preload�牙錘騾夊ｿ�ｼ�0 issues�嫣py -3.12 manage.py collectstatic --dry-run --noinput` 騾夊ｿ�ｼ碁｢�悄謾ｶ髮� 169 荳ｪ static 譁�ｻｶ�嫣py -3.12 manage.py createcachetable --dry-run cmhub_cache` 騾夊ｿ�ｼ瑚ｾ灘� MySQL cache 陦ｨ DDL�嫣py -3.12 -m compileall config` 騾夊ｿ�ｼ帛ｰ晁ｯ� `py -3.12 manage.py test apps.api --noinput --keepdb --verbosity 2` 譌ｶ 25 譚｡逕ｨ萓句ｷｲ騾夊ｿ�ｼ形GenerateApiTests` 14 譚｡蝗�霑懃ｨ� MySQL 霑樊磁驥咲ｽｮ/莠句苅荳ｭ譁ｭ陲ｫ隶ｰ ERROR�碁囂蜷� `Test-NetConnection 43.128.3.240 -Port 3306` 遶ｯ蜿｣蜿ｯ霎ｾ�悟黒迢ｬ驥崎ｷ� `py -3.12 manage.py test apps.api.tests.GenerateApiTests --noinput --keepdb --verbosity 2` 騾夊ｿ�ｼ�14 tests OK縲よｵ玖ｯ�/霑∫ｧｻ髦ｶ谿ｵ莉肴怏 allauth `account.EmailAddress` 譚｡莉ｶ蜚ｯ荳€郤ｦ譚溷惠 MySQL 荳贋ｸ榊庄蛻帛ｻｺ逧� `models.W036` 隴ｦ蜻奇ｼ帶悽鬘ｹ逶ｮ逕ｨ謌ｷ雍ｦ譛ｬ驍ｮ邂ｱ蜚ｯ荳€諤ｧ逕ｱ `user.email` 蜚ｯ荳€郤ｦ譚滓価諡�€�
- 譛€譁ｰ鬪瑚ｯ�ｼ啜-606 蜈ｬ蠑€鬥夜｡ｵ + 螳｢謌ｷ遶ｯ荳玖ｽｽ蜈･蜿｣蟾ｲ鬪瑚ｯ� `.\init.ps1` 騾夊ｿ�ｼ�ython 3.12.3�御ｾ晁ｵ門ｷｲ貊｡雜ｳ�形manage.py check` 0 issues�梧遠蜊ｰ蜷ｯ蜉ｨ蜻ｽ莉､�会ｼ嫣py -3.12 -m py_compile apps\portal\models.py apps\portal\admin.py apps\portal\views.py apps\portal\urls.py apps\portal\tests.py` 騾夊ｿ�ｼ嫣py -3.12 manage.py check` 騾夊ｿ�ｼ�0 issues�嫣py -3.12 manage.py makemigrations --check --dry-run` 騾夊ｿ�ｼ君o changes detected�嫣py -3.12 manage.py migrate portal` 蟾ｲ蠎皮畑 `portal.0001_initial` 蛻ｰ蠖灘燕謨ｰ謐ｮ蠎難ｼ嫣py -3.12 manage.py shell -c "... Client().get('/') ..."` 霑泌屓 `STATUS=200`縲�ｦ夜｡ｵ譬�ｯ�柱荳玖ｽｽ蛹ｺ譬�ｯ�插蟄伜惠�嫣py -3.12 manage.py findstatic portal/brand.css portal/vendor/bootstrap/bootstrap.min.css portal/vendor/qrcode/qrcode.js --verbosity 1` 蝮�伽蛻ｰ�嫣py -3.12 manage.py test apps.portal.tests.PortalAccountFlowTests.test_homepage_is_public_and_shows_anonymous_onboarding_without_release apps.portal.tests.PortalAccountFlowTests.test_homepage_shows_current_download_release apps.portal.tests.PortalAccountFlowTests.test_homepage_shows_dashboard_entry_for_authenticated_user apps.portal.tests.PortalAccountFlowTests.test_download_release_only_keeps_one_current_per_platform apps.portal.tests.PortalAccountFlowTests.test_authenticated_nav_highlights_current_page_only --noinput --verbosity 2` 騾夊ｿ�ｼ�5 tests OK縲Ａpy -3.12 manage.py test apps.portal.tests.PortalAccountFlowTests --keepdb --noinput --verbosity 2` 蟾ｲ驥崎ｷ托ｼ悟屏霑懃ｨ� MySQL `43.128.3.240` 蝨ｨ豬玖ｯ募ｺ楢ｿ∫ｧｻ髦ｶ谿ｵ霑樊磁雜�慮��2003 / WinError 10060�我ｸｭ譁ｭ�御ｸ肴弍譁ｭ險€螟ｱ雍･�帶焚謐ｮ蠎捺△螟榊錘髴€陦･霍� portal 謨ｴ扈�€�
- 譛€譁ｰ鬪瑚ｯ�ｼ啜-605 蜈埼ぐ邂ｱ鬪瑚ｯ∫ｭ也払蟾ｲ鬪瑚ｯ� `py -3.12 -m py_compile config\settings.py apps\portal\tests.py` 騾夊ｿ�ｼ嫣py -3.12 manage.py check` 騾夊ｿ�ｼ�0 issues�嫣py -3.12 manage.py makemigrations --check --dry-run` 騾夊ｿ�ｼ君o changes detected�帶峩譁ｰ蜷守噪豕ｨ蜀� / 逋ｻ蠖慕岼譬�ｵ玖ｯ� 3 tests OK�嫣py -3.12 manage.py test apps.portal --keepdb --noinput --verbosity 2` 騾夊ｿ�ｼ�26 tests OK�嫣git diff --check` 騾夊ｿ�ｼ御ｻ� Windows CRLF 謠千､ｺ縲ょ�驥� `py -3.12 manage.py test --keepdb --noinput --verbosity 2` 蟾ｲ蟆晁ｯ包ｼ悟書邇ｰ 131 tests�瑚ｷ大芦 95 tests 蜷手ｿ懃ｨ� MySQL `43.128.3.240` 蜃ｺ邇ｰ霑樊磁雜�慮 / WinError 10051�梧怙扈� 22 errors�幃囂蜷� `Test-NetConnection 43.128.3.240 -Port 3306` 譏ｾ遉ｺ `TcpTestSucceeded=True`�悟黒迢ｬ螟崎ｷ大､ｱ雍･襍ｷ轤ｹ逧� billing 蛻�ｻ�慮 17 譚｡荳壼苅逕ｨ萓� OK�悟ｹｶ蜿第殴轤ｹ逕ｨ萓区悽菴捺遠蜊ｰ `ok` 蜷主惠豬玖ｯ募ｺ� flush 髦ｶ谿ｵ蜀肴ｬ｡蝗� MySQL 霑樊磁雜�慮 / WinError 10060 隶ｰ ERROR縲らｻ楢ｮｺ�啜-605 逶ｸ蜈ｳ豬玖ｯ募ｷｲ騾夊ｿ�ｼ悟�驥丞黒谺｡扈ｿ蜿苓ｿ懃ｨ� MySQL 遞ｳ螳壽€ｧ髦ｻ蝪槭€�
- 譛€譁ｰ鬪瑚ｯ�ｼ啜-604 荳ｭ譁�撫諢溯ｯ肴悽蝨ｰ霑�ｻ､蟾ｲ鬪瑚ｯ� `py -3.12 -m py_compile config\settings.py apps\api\generation.py apps\api\tests.py apps\moderation\apps.py apps\moderation\models.py apps\moderation\normalization.py apps\moderation\policy.py apps\moderation\services.py apps\moderation\signals.py apps\moderation\versioning.py apps\moderation\providers\base.py apps\moderation\providers\keyword.py apps\moderation\tests.py` 騾夊ｿ�ｼ嫣py -3.12 manage.py check` 騾夊ｿ�ｼ�0 issues�嫣py -3.12 manage.py makemigrations --check --dry-run` 騾夊ｿ�ｼ君o changes detected�嫣py -3.12 manage.py test apps.moderation --keepdb --noinput --verbosity 2` 騾夊ｿ�ｼ�7 tests OK�帶眠蠅樒函謌先磁蜿｣逶ｮ譬�ｵ玖ｯ� 2 tests OK�嫣py -3.12 manage.py test apps.api.tests.GenerateApiTests --keepdb --noinput --verbosity 2` 騾夊ｿ�ｼ�16 tests OK縲よｵ玖ｯ墓悄莉�ｿ晉蕗 allauth 蝨ｨ MySQL 譚｡莉ｶ蜚ｯ荳€郤ｦ譚滉ｸ顔噪譌｢譛� `models.W036` 隴ｦ蜻翫€�
- 譛€譁ｰ鬪瑚ｯ�ｼ啜-603 django-admin 蟄玲ｮｵ郤ｧ荳ｭ譁�喧蟾ｲ謾ｶ蟆ｾ�壻ｺｺ蟾･遑ｮ隶､ `/admin/` 蟄玲ｮｵ譬�ｭｾ荳ｭ譁�喧�嫣py -3.12 manage.py check` 騾夊ｿ�ｼ�0 issues�嫣py -3.12 manage.py makemigrations --check --dry-run` 騾夊ｿ�ｼ君o changes detected�嫣py -3.12 manage.py test apps.users.tests apps.billing.tests.BillingAdminTests apps.ai.tests.AiModelAdminTests apps.ai.tests.AiConfigAuditAdminTests --keepdb --noinput --verbosity 2` 騾夊ｿ�ｼ�15 tests OK縲よｵ玖ｯ墓悄莉�ｿ晉蕗 allauth 蝨ｨ MySQL 譚｡莉ｶ蜚ｯ荳€郤ｦ譚滉ｸ顔噪譌｢譛� `models.W036` 隴ｦ蜻翫€�
- 郤ｿ荳� AI 譬�｢倡函謌千ｼｺ髯ｷ蟾ｲ菫ｮ螟搾ｼ�2026-07-06 逕ｨ蠖灘燕郤ｿ荳� `AI_KEY_ENCRYPTION_KEY` 驥肴眠蟇ｼ蜈･ `/secure/cmhub/ai_models.json`�御ｿｮ螟� `title-standard` 蟇ｹ蠎� `AiModel.api_key_encrypted` 譌�豕戊ｧ｣蟇�噪髣ｮ鬚倥€るｪ瑚ｯ�ｼ啻python3.12 manage.py check` 騾夊ｿ�ｼ嫣python3.12 manage.py smoke_ai_generation title` 逵溷ｮ櫁ｰ�畑謌仙粥�形model_used=gpt-5.5`�瑚€玲慮郤ｦ 16.9s�瑚ｿ泌屓 3 荳ｪ譬�｢假ｼ帷畑 `api_key.txt` 隨ｬ莠御ｸｪ Key 隹� `POST https://cm.833729.com/api/v1/generate/title` 謌仙粥霑泌屓 5 荳ｪ譬�｢假ｼ形points_cost=1`�御ｽ咎｢昜ｻ� 1010 謇｣蛻ｰ 1009縲�
- 郤ｿ荳顔Ο菫ｮ鬪瑚ｯ�ｼ啻/admin/billing/exchangerate/` 500 譬ｹ蝗�譏ｯ `ExchangeRateAdmin.date_hierarchy` 隗ｦ蜿� MySQL `CONVERT_TZ`�瑚€檎函莠ｧ MySQL 譛ｪ蜉�霓ｽ譌ｶ蛹ｺ陦ｨ�轡jango 謚� `ValueError: Database returned an invalid datetime value`�帛ｷｲ遘ｻ髯､ `apps.billing.admin` 荳ｭ 4 荳ｪ DateTime `date_hierarchy`�御ｿ晉蕗 `list_filter` 譌･譛溽ｭ幃€峨€るｪ瑚ｯ� `py -3.12 -m py_compile apps\billing\admin.py apps\billing\tests.py`縲～py -3.12 manage.py check`縲～py -3.12 manage.py test apps.billing.tests.BillingAdminTests.test_exchange_rate_changelist_renders_when_rates_exist --keepdb --noinput --verbosity 2` 蝮�€夊ｿ�€�
- Mock 謾ｯ莉俶署遉ｺ�啻PAYMENT_CALLBACK_MODE=mock` 譌ｶ�檎畑謌ｷ遶ｯ `/recharge` 逧�ｾ�髪莉倩ｮ｢蜊募玄蝓滉ｼ壽仞遉ｺ驢堤岼豬玖ｯ墓ｨ｡蠑乗署遉ｺ�瑚ｯｴ譏惹ｺ檎ｻｴ遐∝宵逕ｨ莠手＃隹�ｮ｢蜊募�蟒ｺ縲�｡ｵ髱｢貂ｲ譟灘柱迥ｶ諤∬ｽｮ隸｢�御ｸ崎�菴ｿ逕ｨ蠕ｮ菫｡謌匁髪莉伜ｮ晉悄螳樔ｻ俶ｬｾ�嫣sdk` 讓｡蠑丈ｸ肴仞遉ｺ隸･謠千､ｺ縲るｪ瑚ｯ� `py -3.12 -m py_compile apps\portal\views.py apps\portal\tests.py`縲～py -3.12 manage.py check`縲～py -3.12 manage.py test apps.portal.tests.PortalAccountFlowTests.test_recharge_page_post_creates_pending_order_without_crediting_wallet_or_ledger apps.portal.tests.PortalAccountFlowTests.test_recharge_page_does_not_show_mock_notice_in_sdk_mode --keepdb --noinput --verbosity 2` 蝮�€夊ｿ�€�
- 蠕ｮ菫｡豁｣蠑丈ｸ句黒辜ｭ菫ｮ�夂ｺｿ荳雁ｾｮ菫｡ Native 荳句黒螟ｱ雍･譬ｹ蝗�譏ｯ `wechatpayv3` SDK 髴€隕∵仞蠑� `pay_type=WeChatPayType.NATIVE`�御ｸ疲�蜉溷桃蠎比ｸｺ `(status_code, json_string)` tuple 閠碁撼 dict�帛ｷｲ蜈ｼ螳ｹ tuple/json 蜩榊ｺ泌ｹｶ隕�尠荳句黒荳惹ｸｻ蜉ｨ譟･蜊輔€らｺｿ荳顔畑菫ｮ螟榊錘逧� `_create_wechat_payment_order_with_sdk()` 蛻帛ｻｺ 1 蛻�ｯ頑妙鬚�髪莉倩ｯｷ豎ゑｼ檎｡ｮ隶､霑泌屓 `weixin://wxpay/bizpayurl` 逾ｨ謐ｮ縲ょ嘗�嗔ending 隶｢蜊穂ｸｻ蜉ｨ譟･蜊募ｼょｸｸ荳榊�隶ｩ `/api/v1/recharge/status` 霑泌屓 500�瑚€梧弍菫晄戟蠖灘燕隶｢蜊慕憾諤∬ｿ泌屓 200縲�
- 謾ｯ莉伜ｮ昜ｸｴ譌ｶ荳狗ｺｿ�夂ｺｿ荳頑髪莉伜ｮ晞｢�ｸ句黒霑泌屓 `isv.illegal-client-ip`�亥ｽ灘燕隹�畑 IP 荳榊惠謾ｯ莉伜ｮ晏庄菫｡蜷榊黒荳ｭ�会ｼ碁怙蝨ｨ謾ｯ莉伜ｮ晏ｼ€謾ｾ蟷ｳ蜿ｰ謚� VPS 蜃ｺ蜿｣ IP `43.128.3.240` 蜉�蜈･蜿ｯ菫｡ IP 蜷主�諱｢螟阪€ょ屏豁､逕ｨ謌ｷ遶ｯ `/recharge` 陦ｨ蜊墓嘯譌ｶ蜿ｪ螻慕､ｺ蟷ｶ謗･蜿怜ｾｮ菫｡謾ｯ莉假ｼ帛ｺ募ｱ� API縲∵ｨ｡蝙区椢荳ｾ縲∝屓隹�ｸ取髪莉伜ｮ� SDK 霍ｯ蠕�ｿ晉蕗荳榊唖縲�
- 謨ｰ謐ｮ�哂I 荳頑ｸｸ隹�畑荳取ｨ｡蝙矩�鄂ｮ蜿り€� `D:\chengma\cmbot`��src/services/ai_text_service.py`縲～ai_image_service.py`縲～config/ai_models.json`�会ｼ帷悄螳� `ai_models.json` 荳肴署莠､�碁怙騾夊ｿ� `import_ai_models` 蜻ｽ莉､蜉�蟇�ｯｼ蜈･
- 譬�㊥蜷ｯ蜉ｨ霍ｯ蠕�ｼ啗indows 逕ｨ `./init.ps1`�婉nix/WSL 逕ｨ `./init.sh`
- 譬�㊥鬪瑚ｯ∬ｷｯ蠕�ｼ啗indows 逕ｨ `py -3.12 manage.py check` / `py -3.12 manage.py test`
- 隶ｾ隶｡蝓ｺ郤ｿ��**閾ｪ蜉ｩ逕ｨ謌ｷ遶ｯ + 蟇ｹ螟� API + 霑占是蜷主床**荳牙粋荳€蜊穂ｽ難ｼ帷畑謌ｷ讓｡蝙� `User`(auth)/`UserWallet`(轤ｹ謨ｰ�碁煤 wallet 謇｣轤ｹ)/`ApiKey`(1:N�悟嶋蟶悟ｭ伜お)�帛ｯｹ螟紋ｸ､謗･蜿｣ + **閭ｽ蜉帛悪蜷� + Provider 騾る�蝎ｨ**�亥庄謠呈渠萓帛ｺ泌膚�会ｼ幄�蜉ｩ謇ｫ遐∝�蛟ｼ�帶ｳｨ蜀御ｸ埼€∫せ謨ｰ縲りｯｦ隗� `04-architecture.md` 荳� 2026-06-29 / 2026-07-01 逧� `progress.md` 蜀ｳ遲�
- 驟咲ｽｮ蝓ｺ郤ｿ�夊ｿ占｡檎識蠅�序驥城寔荳ｭ隗� `docs/env.md`�帷悄螳槫ｯ�徴/謾ｯ莉伜�隸∽ｸ榊ｾ怜�蜈･莉｣遐∵�譁�｡｣譬ｷ萓九€ら畑謌ｷ遶ｯ豕ｨ蜀檎ｭ也払蝗ｺ螳壻ｸｺ `ACCOUNT_EMAIL_VERIFICATION="none"`�壼�驍ｮ邂ｱ鬪瑚ｯ√€∵ｳｨ蜀悟叉蜿ｯ逕ｨ縲�ぐ邂ｱ莉榊ｿ�｡ｫ荳泌髪荳€�嫣DJANGO_EMAIL_BACKEND` / `DJANGO_DEFAULT_FROM_EMAIL` 莉�畑莠主錘扈ｭ蟇��∵伽蝗槭€�€夂衍謌匁△螟埼ぐ邂ｱ鬪瑚ｯ∫ｭ蛾ぐ莉ｶ閭ｽ蜉幢ｼ御ｸ堺ｽ應ｸｺ蠖灘燕豕ｨ蜀檎匳蠖募燕鄂ｮ譚｡莉ｶ縲ょ�蛟ｼ隶｢蜊募惠蛻帛ｻｺ譌ｶ髞∝ｮ壽ｱ�紫荳朱｢�ｮ｡轤ｹ謨ｰ�悟屓隹��雍ｦ菴ｿ逕ｨ隶｢蜊募€ｼ�御ｸ肴潔譁ｰ豎�紫驥咲ｮ励€よ髪莉伜屓隹�ｸ惹ｸ句黒逕ｱ `PAYMENT_CALLBACK_MODE` 謗ｧ蛻ｶ�壽悽蝨ｰ/豬玖ｯ募庄逕ｨ HMAC `mock`�檎函莠ｧ蠎比ｸｺ `sdk`�帑ｺ檎ｻｴ遐∵悽蝨ｰ譛画譜譛滓署遉ｺ逕ｱ `PAYMENT_QR_EXPIRES_MINUTES` 謗ｧ蛻ｶ縲５-306 襍ｷ蟇ｹ螟� API 螳牙�驟咲ｽｮ蛹�性 `API_GENERATE_THROTTLE_RATE`縲～API_AUTH_FAILURE_THROTTLE_RATE`縲～IMAGE_URL_MAX_BYTES`縲～IMAGE_URL_MAX_REDIRECTS`縲～IMAGE_URL_CONNECT_TIMEOUT_SECONDS`縲～IMAGE_URL_READ_TIMEOUT_SECONDS`縲～RECHARGE_MAX_AMOUNT_CNY`縲５-403 襍ｷ逕滉ｺｧ髱呎€√€∝�莠ｫ cache 荳� HTTPS 螳牙�驟咲ｽｮ蛹�性 `STATIC_URL`縲～STATIC_ROOT`縲～DJANGO_CACHE_BACKEND`縲～DJANGO_CACHE_LOCATION`縲～DJANGO_CSRF_TRUSTED_ORIGINS`縲～DJANGO_SESSION_COOKIE_SECURE`縲～DJANGO_CSRF_COOKIE_SECURE`縲～DJANGO_SECURE_SSL_REDIRECT`縲～DJANGO_SECURE_PROXY_SSL_HEADER`縲～DJANGO_SECURE_HSTS_SECONDS`縲５-604 襍ｷ蜀�ｮｹ螳牙�驟咲ｽｮ蛹�性 `MODERATION_ENABLED`縲～MODERATION_PROVIDER=keyword`縲～MODERATION_FAIL_CLOSED`縲～MODERATION_BLOCK_ON_REVIEW`縲～MODERATION_CACHE_VERSION_KEY`�帷函莠ｧ螟� worker 荳句ｿ�｡ｻ菴ｿ逕ｨ蜈ｱ莠ｫ cache 謇ｿ霓ｽ謨乗─隸咲沿譛ｬ蜿ｷ縲�
- 蠖灘燕 blocker�壼ｾｮ菫｡豁｣蠑丈ｸ句黒蟾ｲ閭ｽ霑泌屓莠檎ｻｴ遐�ｼ御ｽ�ｺｿ荳雁ｾｮ菫｡蝗櫁ｰ�崟蜃ｺ邇ｰ `PaymentVerificationError`�御ｻ埼怙蜊慕峡菫ｮ螟榊ｹｶ螳梧�窶應ｻ俶ｬｾ蜷手�蜉ｨ蜈･雍ｦ窶晞溜邇ｯ鬪梧噺�帶髪莉伜ｮ晄△螟堺ｾ晁ｵ門ｼ€謾ｾ蟷ｳ蜿ｰ謚� `43.128.3.240` 蜉�蜈･蜿ｯ菫｡ IP縲らｺｿ荳顔悄螳樊��｢倡函謌仙ｷｲ霍鷹€壼ｹｶ鬪瑚ｯ∵殴轤ｹ�帛崟迚�酔豁･逵溷ｮ櫁€玲慮鬟朱勦莉肴悴騾€�卦-403 蟾ｲ蝨ｨ `deployment.md` 譏守｡ｮ荳顔ｺｿ蜑榊ｿ�｡ｻ隶ｰ蠖慕悄螳槫崟迚� smoke 閠玲慮�帶悴霍鷹€壼燕蜿ｪ閭ｽ謖我ｿ晏ｮ郁ｶ�慮蜀�ｵ具ｼ御ｸ崎�螢ｰ遘ｰ蟾ｲ鬪瑚ｯ√€�

## 蠖灘燕逶ｮ蠖戊ｦ∫せ

| 霍ｯ蠕� | 迥ｶ諤� | 隸ｴ譏� |
| --- | --- | --- |
| `docs/` | 蟾ｲ譛� | 蜈ｨ螂� harness 譁�｡｣�婬-403 譁ｰ蠅� `deployment.md` |
| `AGENTS.md` / `CLAUDE.md` | 蟾ｲ譛� | 莉灘ｺ鍋ｺｧ蜈･蜿｣ |
| `progress.md` | 蟾ｲ譛� | 謇ｧ陦梧ｵ∵ｰｴ�悟ｷｲ隶ｰ蠖募､夊ｽｮ譁�｡｣蜀ｳ遲厄ｼ帛錘扈ｭ莉ｻ蜉｡扈ｧ扈ｭ霑ｽ蜉� |
| `init.sh` / `init.ps1` | 蟾ｲ譛� | 蜷ｯ蜉ｨ鬪瑚ｯ∝�蜿｣�悟ｷｲ蝗ｺ螳夂ｳｻ扈� Python 3.12 蜻ｽ莉､�悟ｹｶ譬｡鬪瑚ｧ｣驥雁勣迚域悽 `>=3.12,<3.14` |
| `requirements.txt` / `requirements-production.txt` / `pyproject.toml` | 蟾ｲ譛� | `requirements.txt` 邂｡譛ｬ蝨ｰ/蝓ｺ遑€霑占｡御ｾ晁ｵ厄ｼ嫣requirements-production.txt` 霑ｽ蜉� Linux 逕滉ｺｧ Gunicorn�嫣pyproject.toml` 關ｽ蝨ｰ `requires-python`�婬-101 譁ｰ蠅� `requests`�婬-102 菴ｿ逕ｨ譌｢譛� `cryptography` 蛛� Fernet 蜉�蟇�ｼ婬-501 譁ｰ蠅� `django-allauth` |
| `config/`��jango 蟾･遞具ｼ� | 蟾ｲ譛� | T-001 蛻帛ｻｺ�悟性 settings / urls / wsgi / asgi |
| `apps/`��sers/portal/billing/ai/api/moderation�� | 蟾ｲ譛� | T-002 蛻帛ｻｺ�嫣apps/users` 蟾ｲ螳壻ｹ芽�螳壻ｹ� `User`�婬-003 蟾ｲ豕ｨ蜀� admin 荳� admin smoke test�婬-004 蟾ｲ扈� `User.email` 蜉�蜚ｯ荳€郤ｦ譚滂ｼ婬-101 蟾ｲ譁ｰ蠅� `apps/ai/providers`�婬-102 蟾ｲ譁ｰ蠅� `apps/ai/security.py`縲～aliases.py`縲～importers.py`縲［anagement command 荳� `ai.0001_initial` 霑∫ｧｻ�婬-103 蟾ｲ譁ｰ蠅� `apps/ai/audit.py` 荳� `ai.0002_aiconfigauditlog` 霑∫ｧｻ�婬-104/T-105 蟾ｲ譁ｰ蠅� `smoke_ai_generation` 蠖募宛 title/image smoke 蜻ｽ莉､�婬-201 蟾ｲ蝨ｨ users 關ｽ `UserWallet` / `ApiKey`�悟惠 billing 關ｽ `PointsLedger` / `CallRecord`�婬-202 蟾ｲ蝨ｨ billing 關ｽ `PricingRule` / `ExchangeRate` 荳� `pricing.py`�婬-203/T-303/T-304/T-305 蟾ｲ蝨ｨ `apps/billing/services.py` 關ｽ謇｣轤ｹ/騾€轤ｹ縲∽ｽ咎｢晏ｿｫ辣ｧ縲∝�蛟ｼ蜈･雍ｦ荳主�蛟ｼ荳句黒�婬-401 蟾ｲ蝨ｨ `apps/billing/services.py` 關ｽ `adjust_wallet_points()`�悟惠 `apps/users/admin.py` 荳� `apps/users/templates/admin/users/userwallet/adjust_points.html` 關ｽ髓ｱ蛹�焔蟾･隹�せ蜈･蜿｣�婬-304/T-305 蟾ｲ蝨ｨ `apps/billing/payment_gateways.py` 關ｽ蝗櫁ｰ�ｪ檎ｭｾ縲［ock 荳句黒荳� SDK 蜈･蜿｣�婬-301~T-306 蟾ｲ蝨ｨ api 關ｽ驩ｴ譚�€∫函謌先磁蜿｣郛匁賜縲∝ｺ丞�蛹門勣縲∝崟迚�ｭ伜お縲∽ｽ咎｢晄衍隸｢縲∝�蛟ｼ蝗櫁ｰ�€∝�蛟ｼ荳句黒/迥ｶ諤∵衍隸｢縲～image_url` SSRF 髦ｲ謚､縲∫函謌�/隶､隸�剞豬∽ｸ守ｻ滉ｸ€ 429 髞呵ｯｯ蜩榊ｺ費ｼ婬-501 蟾ｲ蝨ｨ portal 關ｽ allauth 豕ｨ蜀�/逋ｻ蠖�/逋ｻ蜃ｺ霍ｯ逕ｱ縲∵ｨ｡譚ｿ縲∥dapter 荳� dashboard�婬-502 蟾ｲ蝨ｨ portal 關ｽ `/apikeys`縲、PI Key 蛻帛ｻｺ陦ｨ蜊輔€∝�陦ｨ讓｡譚ｿ荳主唖髯､�亥衰髞€�牙勘菴懶ｼ婬-503 蟾ｲ蝨ｨ portal 關ｽ荳ｪ莠ｺ荳ｭ蠢�ｱ�€ｻ縲∝�蛟ｼ隶ｰ蠖募柱豸郁ｴｹ隶ｰ蠖暮｡ｵ�婬-504 蟾ｲ蝨ｨ portal 關ｽ `/recharge` 蜈�€ｼ鬘ｵ縲∝�蛟ｼ陦ｨ蜊輔€∽ｺ檎ｻｴ遐∫･ｨ謐ｮ螻慕､ｺ蜥檎憾諤∬ｽｮ隸｢�婬-505 蟾ｲ蝨ｨ portal 關ｽ譛ｬ蝨ｰ vendor static 荳手ｮｰ蠖募�鬘ｵ�婬-601 蟾ｲ蝨ｨ `apps/ai/catalog.py` 關ｽ蜈ｬ蠑€讓｡蝙狗岼蠖包ｼ悟惠 api 關ｽ `/api/v1/models`�悟惠 portal 關ｽ `/models` 鬘ｵ髱｢蜥悟ｯｼ闊ｪ蜈･蜿｣�婬-604 蟾ｲ蝨ｨ moderation 關ｽ `SensitiveWord`縲〔eyword matcher縲∝ｽ剃ｸ€蛹悶€∝�莠ｫ cache 迚域悽螟ｱ謨井ｸ� admin�婬-606 蟾ｲ蝨ｨ portal 關ｽ蜈ｬ蠑€鬥夜｡ｵ縲～DownloadRelease`縲∽ｸ玖ｽｽ迚域悽 admin縲～brand.css` 荳朱ｦ夜｡ｵ讓｡譚ｿ |
| `manage.py` | 蟾ｲ譛� | T-001 蛻帛ｻｺ |
| `tests/` | 蠕�ｻｺ | 髫丞推莉ｻ蜉｡陦･蜈� |

## 莉ｻ蜉｡逵区攸迥ｶ諤�

莉ｻ蜉｡迥ｶ諤∽ｻ･ [`06-tasks.md`](06-tasks.md) 荳ｺ蜃�ｼ悟紙蜿ｲ謇ｧ陦瑚ｮｰ蠖戊ｧ� [`../progress.md`](../progress.md)縲�

- 蟾ｲ螳梧��啜-001 蛻晏ｧ句喧 Django + DRF 鬘ｹ逶ｮ鬪ｨ譫ｶ�婬-002 蟒ｺ遶� apps 逶ｮ蠖輔€∬�螳壻ｹ� User 荳朱�鄂ｮ�婬-003 謗･騾� django-admin 荳取怙蟆乗ｵ玖ｯ包ｼ婬-004 Phase 0 鬪ｨ譫ｶ螳｡譬ｸ菫ｮ陦･�婬-101 Provider 騾る�蝎ｨ螻� + 遘ｻ讀� cmbot 隹�畑�婬-102 AiModel + ModelAlias 讓｡蝙� + 蛻ｫ蜷崎ｧ｣譫撰ｼ婬-103 驟咲ｽｮ蜿俶峩螳｡隶｡�婬-104 霍鷹€壻ｸ€谺｡蠖募宛譬�｢倡函謌撰ｼ婬-105 Phase 1 AI 螻ょｮ｡譬ｸ菫ｮ陦･�婬-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 讓｡蝙具ｼ婬-202 PricingRule / ExchangeRate 讓｡蝙� + 隶｡雍ｹ隶｡邂暦ｼ婬-203 蟷ｶ蜿大ｮ牙�謇｣轤ｹ / 騾€轤ｹ�婬-204 Phase 2 隶｡雍ｹ譬ｸ蠢�ｮ｡譬ｸ蜉�蝗ｺ�婬-301 API Key 驩ｴ譚�ｼ婬-302 逕滓�譬�｢� / 蝗ｾ迚�磁蜿｣�婬-303 菴咎｢晄衍隸｢謗･蜿｣�婬-304 蜈�€ｼ蝗櫁ｰ�ｼ婬-305 謇ｫ遐∝�蛟ｼ荳句黒 + 霓ｮ隸｢�婬-306 Phase 3 蟇ｹ螟� API 螳牙�蜉�蝗ｺ�婬-501 豕ｨ蜀� / 逋ｻ蠖包ｼ�llauth�会ｼ婬-502 API Key 閾ｪ蜉ｩ邂｡逅�｡ｵ�婬-503 荳ｪ莠ｺ荳ｭ蠢� / 隶ｰ蠖暮｡ｵ�婬-504 蜈�€ｼ鬘ｵ�域沖遐� + 霓ｮ隸｢蛻ｰ雍ｦ�会ｼ婬-505 Phase 4 逕ｨ謌ｷ遶ｯ螳｡譬ｸ莨伜喧�婬-401 霑占是蜷主床螳悟埋�婬-402 螳梧紛鬪梧噺 MVP�婬-403 驛ｨ鄂ｲ / 霑占｡梧枚譯｣�婬-601 蜿ｯ逕ｨ蛻ｫ蜷榊書邇ｰ�婬-602 django-admin 荳ｭ譁�喧�育ｬｬ 1-3 螻ゑｼ会ｼ婬-603 django-admin 荳ｭ譁�喧�育ｬｬ 4 螻つｷ蟄玲ｮｵ郤ｧ�会ｼ婬-604 荳ｭ譁�撫諢溯ｯ肴悽蝨ｰ霑�ｻ､�婬-605 蜈埼ぐ邂ｱ鬪瑚ｯ∫ｭ也払關ｽ蝨ｰ�婬-606 蜈ｬ蠑€鬥夜｡ｵ + 螳｢謌ｷ遶ｯ荳玖ｽｽ蜈･蜿｣縲�
- 豁｣蝨ｨ霑幄｡鯉ｼ壽裏縲�
- 蠕�ｼ€蟋具ｼ夂恚譚ｿ蠖灘燕譌�譁ｰ逧�ｼ門捷莉ｻ蜉｡�帑ｹ句錘蜿ｯ扈ｧ扈ｭ螟�炊逵溷ｮ樊髪莉伜屓隹�芦雍ｦ髣ｭ邇ｯ縲��鄂ｮ蟷ｶ蜿大ｸ�ｮ｢謌ｷ遶ｯ荳玖ｽｽ蛹�€∫悄螳槫崟迚�€玲慮鬪瑚ｯ�ｼ梧�莉� Backlog 諡�眠莉ｻ蜉｡縲�
- 蠖灘燕 blocker�壽髪莉伜膚謌ｷ逵溷ｮ槫ｯ�徴/隸∽ｹｦ荳守函莠ｧ SDK 萓晁ｵ紋ｻ榊ｾ�署萓幢ｼ帛ｾｮ菫｡蝗櫁ｰ�芦雍ｦ髣ｭ邇ｯ莉埼怙逵溷ｮ樊髪莉倬ｪ梧噺�帷悄螳� AI 譬�｢倡函謌仙ｷｲ蝨ｨ郤ｿ荳願ｷ鷹€夲ｼ悟崟迚�函謌千悄螳櫁€玲慮莉埼怙陦･豬九€�
- 荳倶ｸ€荳ｪ蜿ｯ鬚�叙莉ｻ蜉｡�夂恚譚ｿ蠖灘燕譌�譁ｰ逧�ｼ門捷莉ｻ蜉｡�碁怙蜈育｡ｮ隶､荳倶ｸ€鬘ｹ荳壼苅莨伜�郤ｧ謌匁眠蠅樔ｻｻ蜉｡縲�

## 蠖灘燕蜿ｯ霑占｡悟�螳ｹ

```bash
# Windows PowerShell
py -3.12 -m pip install -r requirements.txt
py -3.12 manage.py check
py -3.12 manage.py test
py -3.12 manage.py runserver
py -3.12 manage.py import_ai_models path\to\ai_models.json --create-default-aliases
py -3.12 manage.py smoke_ai_generation title --recorded
py -3.12 manage.py smoke_ai_generation image --recorded

# Unix / WSL
python3.12 -m pip install -r requirements.txt
python3.12 manage.py check
python3.12 manage.py test
python3.12 manage.py runserver
python3.12 manage.py import_ai_models path/to/ai_models.json --create-default-aliases
python3.12 manage.py smoke_ai_generation title --recorded
python3.12 manage.py smoke_ai_generation image --recorded

# Linux production
python3.12 -m pip install -r requirements-production.txt
python3.12 manage.py migrate
python3.12 manage.py createcachetable cmhub_cache
python3.12 manage.py collectstatic --noinput
gunicorn config.wsgi:application --bind 127.0.0.1:8001 --workers 2 --worker-class gthread --threads 4 --timeout 120
gunicorn config.wsgi:application --bind 127.0.0.1:8002 --workers 1 --worker-class gthread --threads 4 --timeout 360
```

蠖灘燕蟇ｹ螟� API��

- `POST /api/v1/generate/title`
- `POST /api/v1/generate/image`
- `GET /api/v1/balance`
- `GET /api/v1/models`
- `POST /api/v1/recharge/create`�育畑謌ｷ遶ｯ session + CSRF��
- `GET /api/v1/recharge/status`�育畑謌ｷ遶ｯ session��
- `POST /api/v1/recharge/callback/wechat`
- `POST /api/v1/recharge/callback/alipay`

蠖灘燕逕ｨ謌ｷ遶ｯ鬘ｵ髱｢��

- `GET /`
- `GET/POST /signup`
- `GET/POST /login`
- `GET/POST /logout`
- `GET /dashboard`
- `GET/POST /recharge`
- `GET/POST /apikeys`
- `POST /apikeys/<id>/delete`
- `GET /models`
- `GET /records/recharge`
- `GET /records/usage`

蠖灘燕鬪ｨ譫ｶ蜿ｯ霑占｡後€５-002 蟾ｲ蝨ｨ鬥匁ｬ｡霑∫ｧｻ蜑榊�蟒ｺ閾ｪ螳壻ｹ� User�悟ｹｶ謖� `env.md` 謗･蜈･ MySQL 8.4 / utf8mb4�幄ｿ懃ｨ� MySQL 蟾ｲ螳梧� Django 蛻晏ｧ玖ｿ∫ｧｻ縲５-003 蟾ｲ謗･騾� django-admin�梧ｵ玖ｯ募庄蛻帛ｻｺ/髞€豈� `test_cmhub` 豬玖ｯ募ｺ難ｼ帛ｽ灘燕霑懃ｨ� MySQL 蟇ｹ鬚醍ｹ∝ｻｺ蠎�/髞€蠎謎ｻ榊庄閭ｽ髣ｴ豁�ｶ�慮�悟ｿ�ｦ∵慮逕ｨ `--keepdb` 荳比ｸｲ陦瑚ｷ第ｵ玖ｯ輔€５-004 蟾ｲ蠎皮畑 `users.0002_alter_user_email`�形user.email` 蟾ｲ譛牙髪荳€邏｢蠑輔€５-101 逧� AI provider 螻ょ宵蛛� HTTP 隹�畑荳主桃蠎碑ｧ｣譫撰ｼ婬-102 蟾ｲ謚� provider 霑占｡碁�鄂ｮ謗･蛻ｰ謨ｰ謐ｮ蠎� `AiModel` / `ModelAlias`�形resolve_alias()` 豈乗ｬ｡譟･蠖灘燕 active 驟咲ｽｮ蟷ｶ謖� `text` / `image` 閭ｽ蜉帶�｡鬪後€５-103 蟾ｲ陦･ `AiConfigAuditLog`�径dmin 菫晏ｭ�/蛻�髯､ `AiModel` / `ModelAlias` 譌ｶ隶ｰ蠖� actor縲∥ction縲》arget縲…hanged_fields縲…hanges縲…reated_at�悟ｯ�徴蜿ｪ隶ｰ蠖� empty/set 迥ｶ諤√€５-104/T-105 蟾ｲ逕ｨ荳ｴ譌ｶ蝗樊ｻ夐�鄂ｮ霍鷹€壼ｽ募宛譬�｢伜柱蠖募宛蝗ｾ迚�函謌舌€５-201 蟾ｲ關ｽ蝨ｰ髓ｱ蛹�€、PI Key縲∫せ謨ｰ豬∵ｰｴ蜥瑚ｰ�畑隶ｰ蠖包ｼ哂PI Key 譏取枚蜿ｪ蝨ｨ蛻帛ｻｺ helper 霑泌屓�悟ｺ灘�蜿ｪ蟄� hash/prefix�佞allRecord 蜿ｪ蟄� `result_ref`/`result_summary`�梧ｲ｡譛� provider raw 蟄玲ｮｵ縲５-202 蟾ｲ關ｽ蝨ｰ `PricingRule` / `ExchangeRate`�夊ｮ｡雍ｹ謖� `operation_type + alias + resolution` 譟･ active 隗���御ｼ伜�邊ｾ遑ｮ蛻�ｾｨ邇�ｼ悟�蝗樣€€鮟倩ｮ､莉ｷ�帷ｼｺ隗��謚� `NoPricingRuleError(code="no_pricing_rule")`�幃≡鬚晄困轤ｹ謨ｰ謖牙ｽ灘燕 active 豎�紫蜷台ｸ句叙謨ｴ縲５-203 蟾ｲ關ｽ蝨ｰ `precharge_call()` / `mark_call_success()` / `refund_call_points()`�夐｢�殴髞�蝶蛹�｡鯉ｼ御ｽ咎｢昜ｸ崎ｶｳ荳榊�隹�畑/豬∵ｰｴ�帛､ｱ雍･騾€轤ｹ髞∬ｰ�畑隶ｰ蠖募ｹｶ蟷らｭ牙� refund 豬∵ｰｴ縲５-204 蟾ｲ螳梧�螟榊粋蜚ｯ荳€郤ｦ譚溷刈蝗ｺ�悟ｹｶ蜿門ｾ嶺ｸ€谺｡螳梧紛 `manage.py test` 蜊墓ｬ｡蜈ｨ扈ｿ縲５-301 蟾ｲ關ｽ蝨ｰ `Authorization: Bearer <API_KEY>` 驩ｴ譚�ｼ壽�蜉溷錘 `request.user` 荳ｺ謇€螻樒畑謌ｷ縲～request.auth` 荳ｺ `ApiKey`�檎ｼｺ螟ｱ/譌�謨� Key 霑泌屓 401�檎畑謌ｷ謌� Key 遖∫畑霑泌屓 403�悟､夜Κ API 荳肴磁蜿� Web session縲５-302 蟾ｲ關ｽ蝨ｰ逕滓�謗･蜿｣�夊ｯｷ豎ょ悪蜷崎ｧ｣譫仙錘謖芽ｧ��隶｡雍ｹ�碁｢�殴謌仙粥謇崎ｰ�畑 Provider�梧�蜉溽｡ｮ隶､隹�畑隶ｰ蠖包ｼ形AiProviderError` / `AiCapabilityError` 遲牙､ｱ雍･霍ｯ蠕�ｼ夐€€轤ｹ�帛崟迚�ｻ捺棡菫晏ｭ伜芦譛ｬ蝨ｰ media 蟷ｶ霑泌屓 URL縲５-303 蟾ｲ關ｽ蝨ｰ菴咎｢晄衍隸｢謗･蜿｣�啻GET /api/v1/balance` 扈ｧ謇ｿ螟夜Κ API Key 驩ｴ譚�ｼ瑚ｯｻ蜿� billing 菴咎｢晏ｿｫ辣ｧ蟷ｶ霑泌屓蜈ｼ螳ｹ蟄玲ｮｵ `user` / `points_balance`�御ｻ･蜿贋ｸ榊性驍ｮ邂ｱ逧� `account.username` / `account.display_name`�梧ｵ玖ｯ戊ｦ�尠菴咎｢昜ｸ取ｵ∵ｰｴ邏ｯ蜉�荳€閾ｴ縲５-304 蟾ｲ關ｽ蝨ｰ蜈�€ｼ蝗櫁ｰ�ｼ啻RechargeOrder` 菫晏ｭ倅ｸ句黒髞∝ｮ夂噪驥鷹｢�/豎�紫/轤ｹ謨ｰ�悟ｾｮ菫｡/謾ｯ莉伜ｮ晏屓隹��鬪檎ｭｾ蜀肴潔隶｢蜊募ｹらｭ牙�雍ｦ�碁㍾螟榊屓隹�ｸ埼㍾螟榊刈轤ｹ�碁≡鬚昜ｸ堺ｸ€閾ｴ荳榊�雍ｦ�帑ｸｻ蜉ｨ譟･蜊募�蠎募庄隹�畑 `query_and_apply_recharge_payment(order_no, query_func)` 螟咲畑蜷御ｸ€蜈･雍ｦ霍ｯ蠕�€５-305 蟾ｲ關ｽ蝨ｰ謇ｫ遐∽ｸ句黒荳手ｽｮ隸｢�夂畑謌ｷ遶ｯ session 逋ｻ蠖募錘蜿ｯ `POST /api/v1/recharge/create` 蛻帛ｻｺ pending 隶｢蜊募ｹｶ諡ｿ蛻ｰ mock/SDK 莠檎ｻｴ遐∫･ｨ謐ｮ�形GET /api/v1/recharge/status` 蜿ｪ霑泌屓譛ｬ莠ｺ隶｢蜊募ｹｶ蝨ｨ pending 譌ｶ蟆晁ｯ穂ｸｻ蜉ｨ譟･蜊戊｡･蜈･雍ｦ�妁PI Key 荳崎�隹�畑霑吩ｸ､荳ｪ逕ｨ謌ｷ遶ｯ謗･蜿｣縲５-306 蟾ｲ關ｽ蝨ｰ蟇ｹ螟� API 螳牙�蜉�蝗ｺ�啻image_url` 荳玖ｽｽ蝨ｨ謇｣轤ｹ蜑榊★蜊剰ｮｮ逋ｽ蜷榊黒縲∝�鄂大慍蝮€譬｡鬪後€�㍾螳壼髄騾占ｷｳ譬｡鬪悟柱蜩榊ｺ泌､ｧ蟆丈ｸ企剞�侫RF 蜈ｨ螻€鮟倩ｮ､荳榊�髫仙ｼ丞星逕ｨ Session/Basic�帷函謌先磁蜿｣謖� Key 髯先ｵ�ｼ瑚ｮ､隸∝､ｱ雍･謖� IP 髯先ｵ�ｼ帛�蛟ｼ荳句黒譛牙黒隨秘≡鬚昜ｸ企剞縲５-501/T-605 蟾ｲ關ｽ蝨ｰ allauth 豕ｨ蜀� / 逋ｻ蠖包ｼ啻ACCOUNT_EMAIL_VERIFICATION="none"`�悟�驍ｮ邂ｱ鬪瑚ｯ√€∵ｳｨ蜀悟叉蜿ｯ逕ｨ�碁ぐ邂ｱ莉榊ｿ�｡ｫ荳泌髪荳€�帶ｳｨ蜀梧�蜉溷�蟒ｺ 0 轤ｹ髓ｱ蛹�€∽ｸ榊�轤ｹ謨ｰ豬∵ｰｴ縲５-502 蟾ｲ關ｽ蝨ｰ API Key 閾ｪ蜉ｩ邂｡逅�ｼ啻/apikeys` 逋ｻ蠖戊ｮｿ髣ｮ�檎函謌仙錘螳梧紛譏取枚蜿ｪ譏ｾ遉ｺ荳€谺｡�悟�陦ｨ蜿ｪ譏ｾ遉ｺ prefix�御ｸ肴仞遉ｺ hash 謌門紙蜿ｲ譏取枚�帛唖髯､荳ｺ蜷企楳 `revoked`�悟衰髞€蜷主､夜Κ API 霑泌屓 403縲５-503 蟾ｲ關ｽ蝨ｰ荳ｪ莠ｺ荳ｭ蠢�ｸ手ｮｰ蠖暮｡ｵ�啻/dashboard` 螻慕､ｺ蜑ｩ菴咏せ謨ｰ縲∝�蛟ｼ諤ｻ鬚昴€∝�雍ｦ轤ｹ謨ｰ縲∝〝豸郁€礼せ謨ｰ蜥梧怙霑題ｮｰ蠖包ｼ嫣/records/recharge` 螻慕､ｺ蠖灘燕逕ｨ謌ｷ蜈�€ｼ隶｢蜊包ｼ嫣/records/usage` 螻慕､ｺ蠖灘燕逕ｨ謌ｷ consume/refund 轤ｹ謨ｰ豬∵ｰｴ蟷ｶ蜈ｳ閨碑ｰ�畑菫｡諱ｯ�帶園譛�

## 蠑€蟋狗ｼ也�∝燕譽€譟･

1. 隸ｻ莉灘ｺ鍋ｺｧ `AGENTS.md` / `CLAUDE.md`縲�
2. 隸ｻ `docs/00-ai-start-here.md`縲�
3. 隸ｻ `docs/05-coding-rules.md`�亥ｰ､蜈ｶ隨ｬ 8 闃りｵ�≡螳牙��峨€�
4. 蝨ｨ `docs/06-tasks.md` 鬚�叙隨ｬ荳€荳ｪ `TODO` 荳比ｾ晁ｵ門插 `DONE` 逧�ｻｻ蜉｡�婬-606 蟾ｲ螳梧��檎恚譚ｿ蠖灘燕譌�譁ｰ逧�ｼ門捷莉ｻ蜉｡縲�
5. 荳倶ｸ€豁･髴€蜈育｡ｮ隶､荳壼苅莨伜�郤ｧ�梧�謚顔悄螳樊髪莉伜屓隹�芦雍ｦ髣ｭ邇ｯ縲∝ｮ｢謌ｷ遶ｯ荳玖ｽｽ蛹�書蟶�€∫悄螳槫崟迚�€玲慮鬪瑚ｯ∵究謌先眠莉ｻ蜉｡縲�

## 扈ｴ謚､隗��

莉｣遐∫憾諤∝序蛹匁慮蜷梧ｭ･譖ｴ譁ｰ譛ｬ譁�ｼ壽眠蠅�/遘ｻ蜉ｨ蜈･蜿｣譁�ｻｶ縲∝�蟋句喧譯�楔謌匁ｨ｡蝮励€∽ｻｻ蜉｡迥ｶ諤∝序蛹悶€∵眠蠅槫庄霑占｡悟多莉､縲∝書邇ｰ譁�｡｣荳惹ｻ｣遐∽ｸ堺ｸ€閾ｴ縲�

- 莉ｻ蜉｡迥ｶ諤∝序蛹門酔豁･ [`06-tasks.md`](06-tasks.md)縲�
- 豈剰ｽｮ謇ｧ陦瑚ｮｰ蠖輔€�ｪ瑚ｯ∝多莉､縲�仆蝪槭€∝�遲冶ｿｽ蜉�蛻ｰ [`../progress.md`](../progress.md)縲�
- 譛ｬ譁�ｻｶ蜿ｪ菫晉蕗蠖灘燕蠢ｫ辣ｧ�御ｸ堺ｿ晉蕗螳梧紛蜴�彰縲�