2026-07-01 17:42:10 +08:00
|
|
|
|
# 敶枏�摰䂿緵�嗆��
|
|
|
|
|
|
|
|
|
|
|
|
> �祆��臬虾閬������滚翰�改�霈啣�隞��銝𦒘遙�∠��輻��啣��嗆���撣桀𨭌 AI coding agent �踹��芰�霈∪���蕭�乩�摨梶緵�嗚��
|
|
|
|
|
|
> ��蟮�扯�瘚�偌餈賢��� [`../progress.md`](../progress.md)嚗䔶�閬�銁�祆��滚�蝏湔擪摰峕㟲�扯��亙���
|
|
|
|
|
|
|
|
|
|
|
|
## �諹提颲寧�
|
|
|
|
|
|
|
|
|
|
|
|
- [`06-tasks.md`](06-tasks.md)嚗帋遙�∠��選�蝏湔擪隞餃𦛚�嗆�����韏硋�撉峕𤣰閬����
|
|
|
|
|
|
- [`../progress.md`](../progress.md)嚗𡁏�銵峕�瘞湛��芾蕭�㰘扇敶閙�頧格�銵䎚���霂���獈憛𧼮��喟���
|
|
|
|
|
|
- `current-state.md`嚗𡁜��滚翰�改��航��𡝗凒�啣��滨𤌍敶𨰻����滚𦶢隞扎��歇摰峕��䁅��䔶�銝�甇乓��
|
|
|
|
|
|
|
|
|
|
|
|
## 敶枏�敹怎�
|
|
|
|
|
|
|
2026-07-03 09:07:21 +08:00
|
|
|
|
- �交�嚗�2026-07-03
|
2026-07-03 16:02:29 +08:00
|
|
|
|
- �嗆挾嚗䥪hase 5 �𤾸蝱銝𤾸�撣��Phase 3 撖孵� API 銝𤾸��澆歇摰峕��� T-306嚗釶hase 4 �冽�蝡� T-501 瘜典� / �餃�嚗Òllauth嚗剹��-502 API Key �芸𨭌蝞∠�憿萸��-503 銝芯犖銝剖� / 霈啣�憿萸��-504 ���潮△銝� T-505 �冽�蝡臬恣�訾��硋歇摰峕�嚗䔶�銝�甇� T-401 餈鞱𨯫�𤾸蝱摰��
|
2026-07-03 11:27:45 +08:00
|
|
|
|
- ���舀�嚗𡁶頂蝏� Python 3.12.3 + Django 5.2.15 + DRF 3.16.1 + django-allauth 65.18.0 + PyMySQL 1.1.3 + cryptography 46.0.7 + requests 2.34.2 + django-admin嚗㛈ySQL 8.4 撌脫𦻖�� settings嚗�僎�舀� `MYSQL_CONNECT_TIMEOUT` / `MYSQL_READ_TIMEOUT` / `MYSQL_WRITE_TIMEOUT`嚗𤤿鍂�瑞垢撌脩鍂 Django 璅⊥踎 SSR + Bootstrap + allauth �賢𧑐瘜典��餃�嚗𥡝祕閫� `03-tech-stack.md`
|
2026-07-03 16:02:29 +08:00
|
|
|
|
- �煺漣隞��嚗𡁜歇�㗇�撠� 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 銝𤾸恣�訾耨銵伐�T-201 撌脫鰵憓� `UserWallet` / `ApiKey`��PointsLedger` / `CallRecord`��笆摨� admin 銝舘�蝘鳴�T-202 撌脫鰵憓� `PricingRule` / `ExchangeRate`��apps.billing.pricing` 霈∟晶霈∠��賣㺭��dmin �滨蔭憿萎�餈�宏嚗苽-203 撌脫鰵憓� `apps.billing.services`嚗���啣僎�穃��券�������毺&霈支�撟��憭梯揖���對�T-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 �脫擪銝𤾸�摨𥪜之撠譍��僐����澆�蝚娪�憸苷��琜�T-501 撌脫𦻖�� allauth嚗峕鰵憓� portal 頝舐眏��釣�屸����具��蒈敶�/瘜典�/�餃枂璅⊥踎�峕�撠� dashboard嚗峕釣�峕��笔�撱� 0 �寥兝���銝滚�韏删�瘚�偌嚗苽-502 撌脫鰵憓� `/apikeys`��PI Key �𥕦遣銵典����銵券△����歹��𢠃�嚗匧𢆡雿頣�����擧���蘨�曄內銝�甈∴��𡑒”�芣遬蝷� prefix嚗苽-503 撌脫�撅� `/dashboard` 銝箔葵鈭箔葉敹���鳴�撟嗆鰵憓� `/records/recharge` ���潸扇敶蓥� `/records/usage` 瘨�晶霈啣�嚗�蘨霂餃�蝷箏��滨鍂�瑟㺭�殷�T-504 撌脫鰵憓� `/recharge` 憿菟𢒰��RechargeCreateForm`����澆紡�芸����頧株砭�𡁏𧋦嚗屸△�W�撱� pending 霈W����蝷箔�蝏渡�蟡冽旿��蔭霂� `/api/v1/recharge/status`嚗諹恥�� paid �𤾸��唬�憸嘅�T-505 撌脫� Bootstrap 5 CSS 銝� qrcode.js vendoring �� `apps/portal/static/portal/vendor/`嚗屸△�V��滢�韏� jsdelivr嚗�僎�𠰴��潸扇敶� / 瘨�晶霈啣��嫣蛹 Django `Paginator` ��△
|
|
|
|
|
|
- 瘚贝�嚗関-505 撌脤�霂��`./init.ps1` 撘�撌亙��朞�嚗𢱌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 findstatic portal/vendor/bootstrap/bootstrap.min.css portal/vendor/qrcode/qrcode.js --verbosity 1` �曉��砍𧑐 static ��辣嚗𢱌py -3.12 manage.py makemigrations --check --dry-run` �惩��吔�`py -3.12 -m compileall apps config` �朞�嚗𢱌rg -n "cdn\.jsdelivr|jsdelivr|qrcode@1\.5\.4" apps\portal\templates apps\portal\static` �惩𦶢銝哨�`py -3.12 manage.py test apps.portal --noinput --keepdb --verbosity 2` �朞�嚗�21 tests OK嚗�鉄 >50 �∪�憿菜�霂𤏪�嚗𥟇鰵憓𧼮�憿菜�霂訫�頝煾�朞�嚗�2 tests OK嚗㚁�`./init.ps1` �嗅偏�朞���㦛撠肽� `py -3.12 manage.py test apps.users apps.portal apps.api --noinput --keepdb --verbosity 2` 銝� `py -3.12 manage.py test apps.api --noinput --keepdb --verbosity 2`嚗䔶�餈𦦵� MySQL �刻�銵䔶葉憭𡁏活�箇緵 `OperationalError 2003/2013`��Packet sequence number wrong` �𤥁��仿�蝵殷��芸�敺堒�甈∪�蝏選�撌脤�朞���鍂靘𧢲��剛�憭梯揖���霂�/餈�宏�嗆挾隞齿� allauth `account.EmailAddress` �∩辣�臭�蝥行��� MySQL 銝𠹺��臬�撱箇� `models.W036` 霅血�嚗𥟇𧋦憿寧𤌍�冽�韐行𧋦�臭��抒眏 `user.email` �臭�蝥行��踵���
|
2026-07-02 11:07:44 +08:00
|
|
|
|
- �唳旿嚗鋫I 銝𦠜虜靚�鍂銝擧芋�钅�蝵桀��� `D:\chengma\cmbot`嚗Ǒsrc/services/ai_text_service.py`��ai_image_service.py`��config/ai_models.json`嚗㚁��笔� `ai_models.json` 銝齿�鈭歹����朞� `import_ai_models` �賭誘�惩�撖澆�
|
2026-07-01 18:01:23 +08:00
|
|
|
|
- ����臬𢆡頝臬�嚗阳indows �� `./init.ps1`嚗𢥧nix/WSL �� `./init.sh`
|
|
|
|
|
|
- ���撉諹�頝臬�嚗阳indows �� `py -3.12 manage.py check` / `py -3.12 manage.py test`
|
2026-07-01 17:42:10 +08:00
|
|
|
|
- 霈曇恣�箇瑪嚗�**�芸𨭌�冽�蝡� + 撖孵� API + 餈鞱𨯫�𤾸蝱**銝匧�銝��蓥�嚗𤤿鍂�瑟芋�� `User`(auth)/`UserWallet`(�寞㺭嚗屸� wallet ���)/`ApiKey`(1:N嚗��撣����)嚗𥕦笆憭碶舅�亙藁 + **�賢��怠� + Provider �����**嚗�虾�埝�靘𥕦����嚗𥡝䌊�拇醌����潘�瘜典�銝漤����啜��祕閫� `04-architecture.md` 銝� 2026-06-29 / 2026-07-01 �� `progress.md` �喟�
|
2026-07-03 11:27:45 +08:00
|
|
|
|
- �滨蔭�箇瑪嚗朞�銵𣬚㴓憓���誯�銝剛� `docs/env.md`嚗𤤿�摰𧼮���/�臭��剛�銝滚��坔�隞���𡝗�獢�甅靘卝��llauth �桃拳撉諹��睲縑�� `DJANGO_EMAIL_BACKEND` / `DJANGO_DEFAULT_FROM_EMAIL` �批�嚗峕𧋦�圈�霈� console backend嚗𣬚�鈭折��滨蔭�笔��桐辣�滚𦛚����潸恥�訫銁�𥕦遣�園�摰𡁏����憸�恣�寞㺭嚗��靚��韐虫蝙�刻恥�訫�潘�銝齿��唳����蝞𨰜��𣈲隞睃�靚��銝见��� `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`��
|
2026-07-03 10:34:37 +08:00
|
|
|
|
- 敶枏� blocker嚗関-306 銝羓瑪�� SSRF 憌𡡞埯撌脖耨憭㵪�餈𦦵� MySQL 餈墧𦻖隞滚虾�賢��X��湔�頞�𧒄嚗���湔�霂閖�憸��颲�鵭�園𡢿撟嗡���鍂 `--keepdb` 銝脰�頝㻫��凝靽�/�臭�摰萘�摰𧼮��瑕���/霂�髡銝𡒊�鈭� SDK 靘肽�隞滚��𣂷�/摰㕑�嚗𤤿�摰� AI 銝𦠜虜 smoke ��閬���滨蔭 `AI_KEY_ENCRYPTION_KEY` 撟嗅紡�� AiModel/ModelAlias��㦛���甇亦�摰噼�埈𧒄憌𡡞埯隞齿𧊋��嚗�歇�餉扇�� T-403��
|
2026-07-01 17:42:10 +08:00
|
|
|
|
|
|
|
|
|
|
## 敶枏��桀�閬��
|
|
|
|
|
|
|
|
|
|
|
|
| 頝臬� | �嗆�� | 霂湔� |
|
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
|
| `docs/` | 撌脫� | �典� harness ��﹝ |
|
|
|
|
|
|
| `AGENTS.md` / `CLAUDE.md` | 撌脫� | 隞枏�蝥批��� |
|
|
|
|
|
|
| `progress.md` | 撌脫� | �扯�瘚�偌嚗�歇霈啣�憭朞蔭��﹝�喟�嚗𥕦�蝏凋遙�∠誧蝏剛蕭�� |
|
2026-07-02 10:17:10 +08:00
|
|
|
|
| `init.sh` / `init.ps1` | 撌脫� | �臬𢆡撉諹��亙藁嚗�歇�箏�蝟餌� Python 3.12 �賭誘嚗�僎�⊿�閫���函��� `>=3.12,<3.14` |
|
2026-07-03 11:27:45 +08:00
|
|
|
|
| `requirements.txt` / `pyproject.toml` | 撌脫� | `requirements.txt` 蝞∟�銵䔶�韏吔�`pyproject.toml` �賢𧑐 `requires-python`嚗苽-101 �啣� `requests`嚗苽-102 雿輻鍂�X� `cryptography` �� Fernet �惩�嚗苽-501 �啣� `django-allauth` |
|
2026-07-01 18:01:23 +08:00
|
|
|
|
| `config/`嚗㇄jango 撌亦�嚗� | 撌脫� | T-001 �𥕦遣嚗�鉄 settings / urls / wsgi / asgi |
|
2026-07-03 16:02:29 +08:00
|
|
|
|
| `apps/`嚗ósers/portal/billing/ai/api嚗� | 撌脫� | 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` �賣緍��/���嫘���憸嘥翰�扼����澆�韐虫����潔��𤏪�T-304/T-305 撌脣銁 `apps/billing/payment_gateways.py` �賢�靚��蝑整��ock 銝见�銝� SDK �亙藁嚗苽-301~T-306 撌脣銁 api �賡�������鞉𦻖����鉝����堒��具��㦛����具���憸脲䰻霂U����澆�靚�����潔���/�嗆��䰻霂U��image_url` SSRF �脫擪�����/霈方��鞉�銝𡒊�銝� 429 �躰秤�滚�嚗苽-501 撌脣銁 portal �� allauth 瘜典�/�餃�/�餃枂頝舐眏��芋�踴��dapter 銝� dashboard嚗苽-502 撌脣銁 portal �� `/apikeys`��PI Key �𥕦遣銵典����銵冽芋�蹂��𣳇膄嚗����嚗匧𢆡雿頣�T-503 撌脣銁 portal �賭葵鈭箔葉敹���颯����潸扇敶訫�瘨�晶霈啣�憿蛛�T-504 撌脣銁 portal �� `/recharge` ���潮△����潸”�𨰻���蝏渡�蟡冽旿撅閧內�𣬚𠶖��蔭霂g�T-505 撌脣銁 portal �賣𧋦�� vendor static 銝舘扇敶訫�憿� |
|
2026-07-01 18:01:23 +08:00
|
|
|
|
| `manage.py` | 撌脫� | T-001 �𥕦遣 |
|
2026-07-01 17:42:10 +08:00
|
|
|
|
| `tests/` | 敺�遣 | �誩�隞餃𦛚銵亙� |
|
|
|
|
|
|
|
|
|
|
|
|
## 隞餃𦛚�𧢲踎�嗆��
|
|
|
|
|
|
|
|
|
|
|
|
隞餃𦛚�嗆��誑 [`06-tasks.md`](06-tasks.md) 銝箏�嚗���脫�銵諹扇敶閗� [`../progress.md`](../progress.md)��
|
|
|
|
|
|
|
2026-07-03 16:02:29 +08:00
|
|
|
|
- 撌脣��琜�T-001 �嘥��� Django + DRF 憿寧𤌍撉冽沲嚗苽-002 撱箇� apps �桀���䌊摰帋� User 銝𡡞�蝵殷�T-003 �仿�� django-admin 銝擧�撠𤩺�霂𤏪�T-004 Phase 0 撉冽沲摰⊥瓲靽株‘嚗苽-101 Provider ����典� + 蝘餅� cmbot 靚�鍂嚗苽-102 AiModel + ModelAlias 璅∪� + �怠�閫��嚗苽-103 �滨蔭�䀹凒摰∟恣嚗苽-104 頝煾�帋�甈∪��嗆�憸条��琜�T-105 Phase 1 AI 撅�恣�訾耨銵伐�T-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 璅∪�嚗苽-202 PricingRule / ExchangeRate 璅∪� + 霈∟晶霈∠�嚗苽-203 撟嗅�摰匧���� / ���對�T-204 Phase 2 霈∟晶�詨�摰⊥瓲�惩𤐄嚗苽-301 API Key �湔�嚗苽-302 ������ / �曄��亙藁嚗苽-303 雿䠷��亥砭�亙藁嚗苽-304 ���澆�靚��T-305 �怎����潔��� + 頧株砭嚗苽-306 Phase 3 撖孵� API 摰匧��惩𤐄嚗苽-501 瘜典� / �餃�嚗Òllauth嚗㚁�T-502 API Key �芸𨭌蝞∠�憿蛛�T-503 銝芯犖銝剖� / 霈啣�憿蛛�T-504 ���潮△嚗�醌�� + 頧株砭�啗揭嚗㚁�T-505 Phase 4 �冽�蝡臬恣�訾��硔��
|
2026-07-01 17:42:10 +08:00
|
|
|
|
- 甇�銁餈𥡝�嚗𡁏���
|
2026-07-03 10:34:37 +08:00
|
|
|
|
- 敶枏� blocker嚗朞�蝔� MySQL 餈墧𦻖敶枏�銝滨迅摰𡁏�敺��嚗𥟇𣈲隞睃��瑞�摰𧼮���/霂�髡銝𡒊�鈭� SDK 靘肽�隞滚��𣂷�嚗𤤿�摰� AI 銝𦠜虜 smoke 隞漤��滨蔭撖�𤨎�峕芋�𧢲㺭�桀��扯���
|
2026-07-03 16:02:29 +08:00
|
|
|
|
- 銝衤�銝芸虾憸��隞餃𦛚嚗�**T-401 餈鞱𨯫�𤾸蝱摰��**��
|
2026-07-01 17:42:10 +08:00
|
|
|
|
|
|
|
|
|
|
## 敶枏��航�銵��摰�
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-07-01 18:01:23 +08:00
|
|
|
|
# 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
|
2026-07-02 11:07:44 +08:00
|
|
|
|
py -3.12 manage.py import_ai_models path\to\ai_models.json --create-default-aliases
|
2026-07-02 13:58:34 +08:00
|
|
|
|
py -3.12 manage.py smoke_ai_generation title --recorded
|
2026-07-02 14:47:22 +08:00
|
|
|
|
py -3.12 manage.py smoke_ai_generation image --recorded
|
2026-07-01 18:01:23 +08:00
|
|
|
|
|
|
|
|
|
|
# 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
|
2026-07-02 11:07:44 +08:00
|
|
|
|
python3.12 manage.py import_ai_models path/to/ai_models.json --create-default-aliases
|
2026-07-02 13:58:34 +08:00
|
|
|
|
python3.12 manage.py smoke_ai_generation title --recorded
|
2026-07-02 14:47:22 +08:00
|
|
|
|
python3.12 manage.py smoke_ai_generation image --recorded
|
2026-07-01 17:42:10 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2026-07-03 08:36:30 +08:00
|
|
|
|
敶枏�撖孵� API嚗�
|
2026-07-02 22:41:37 +08:00
|
|
|
|
|
|
|
|
|
|
- `POST /api/v1/generate/title`
|
|
|
|
|
|
- `POST /api/v1/generate/image`
|
2026-07-03 08:36:30 +08:00
|
|
|
|
- `GET /api/v1/balance`
|
2026-07-03 09:34:07 +08:00
|
|
|
|
- `POST /api/v1/recharge/create`嚗�鍂�瑞垢 session + CSRF嚗�
|
|
|
|
|
|
- `GET /api/v1/recharge/status`嚗�鍂�瑞垢 session嚗�
|
2026-07-03 09:07:21 +08:00
|
|
|
|
- `POST /api/v1/recharge/callback/wechat`
|
|
|
|
|
|
- `POST /api/v1/recharge/callback/alipay`
|
2026-07-02 22:41:37 +08:00
|
|
|
|
|
2026-07-03 11:27:45 +08:00
|
|
|
|
敶枏��冽�蝡舫△�g�
|
|
|
|
|
|
|
|
|
|
|
|
- `GET/POST /signup`
|
|
|
|
|
|
- `GET/POST /login`
|
|
|
|
|
|
- `GET/POST /logout`
|
|
|
|
|
|
- `GET /dashboard`
|
2026-07-03 14:49:45 +08:00
|
|
|
|
- `GET/POST /recharge`
|
2026-07-03 11:51:46 +08:00
|
|
|
|
- `GET/POST /apikeys`
|
|
|
|
|
|
- `POST /apikeys/<id>/delete`
|
2026-07-03 14:00:00 +08:00
|
|
|
|
- `GET /records/recharge`
|
|
|
|
|
|
- `GET /records/usage`
|
2026-07-03 11:27:45 +08:00
|
|
|
|
|
2026-07-03 14:49:45 +08:00
|
|
|
|
敶枏�撉冽沲�航�銵䎚��-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` 撌脫��臭�蝝W���-101 �� AI provider 撅�蘨�� HTTP 靚�鍂銝𤾸�摨磰圾�琜�T-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 撌脰氜�唬�憸脲䰻霂X𦻖���`GET /api/v1/balance` 蝏扳㗁憭㚚� API Key �湔�嚗諹粉�� billing 雿䠷�敹怎�撟嗉��� `user` 銝� `points_balance`嚗峕�霂閗��碶�憸苷�瘚�偌蝝臬�銝��氬��-304 撌脰氜�啣��澆�靚��`RechargeOrder` 靽嘥�銝见�������憸�/瘙��/�寞㺭嚗�凝靽�/�臭�摰嘥�靚��撉𣬚倌�齿�霈W�撟���亥揭嚗屸�憭滚�靚���滚��删�嚗屸�憸苷�銝��港��亥揭嚗𥕢蜓�冽䰻�訫�摨訫虾靚�鍂 `query_and_apply_recharge_payment(order_no, query_func)` 憭滨鍂�䔶��亥揭頝臬���-305 撌脰氜�唳醌����蓥�頧株砭嚗𡁶鍂�瑞垢 session �餃��𤾸虾 `POST /api/v1/recharge/create` �𥕦遣 pending 霈W�撟嗆嚉�� mock/SDK 鈭𣬚輕��巨�殷�`GET /api/v1/recharge/status` �芾��墧𧋦鈭箄恥�訫僎�� pending �嗅�霂蓥蜓�冽䰻�閗‘�亥揭嚗𡩅PI Key 銝滩�靚�鍂餈嗘舅銝芰鍂�瑞垢�亙藁��-306 撌脰氜�啣笆憭� API 摰匧��惩𤐄嚗䫤image_url` 銝贝蝸�冽緍�孵��𡁜�霈桃蒾�滚����蝵穃𧑐���⊿����摰𡁜��鞱歲�⊿����摨𥪜之撠譍��琜�DRF �典�暺䁅恕銝滚��𣂼��舐鍂 Session/Basic嚗𤤿��鞉𦻖��� Key �鞉�嚗諹恕霂�仃韐交� IP �鞉�嚗𥕦��潔��閙��閧��煾�銝𢠃���-501 撌脰氜�� allauth 瘜典� / �餃�嚗䫤ACCOUNT_EMAIL_VERIFICATION="mandatory"`嚗峕釣�峕��笔�撱� 0 �寥兝������嗵��唳�瘞湛��芷�霂��蝞曹��賢遣蝡讠蒈敶� session��-502 撌脰氜�� API Key �芸𨭌蝞∠�嚗䫤/apikeys` �餃�霈輸䔮嚗𣬚��𣂼�摰峕㟲�擧��芣遬蝷箔�甈∴��𡑒”�芣遬蝷� prefix嚗䔶��曄內 hash �硋��脫�����𣳇膄銝箏��� `revoked`嚗�����𤾸��� API 餈𥪜� 403��-503 撌脰氜�唬葵鈭箔葉敹��霈啣�憿蛛�`/dashboard` 撅閧內�拐��寞㺭����潭�駁����韐衣��啜���瘨��㛖��啣���餈𤏸扇敶𤏪�`/records/recharge` 撅閧內敶枏��冽����潸恥�𤏪�`/records/usage` 撅閧內敶枏��冽� consume/refund �寞㺭瘚�偌撟嗅��磰��其縑�荔����厰△�W��芾粉銝𥪜蘨�交𧋦鈭箝��-504 撌脰氜�啣��潮△嚗䫤/recharge` GET 撅閧內雿䠷�����潸
|
2026-07-01 17:42:10 +08:00
|
|
|
|
|
|
|
|
|
|
## 撘�憪讠����璉���
|
|
|
|
|
|
|
|
|
|
|
|
1. 霂颱�摨梶漣 `AGENTS.md` / `CLAUDE.md`��
|
|
|
|
|
|
2. 霂� `docs/00-ai-start-here.md`��
|
|
|
|
|
|
3. 霂� `docs/05-coding-rules.md`嚗�陘�嗥洵 8 ����穃��剁���
|
2026-07-03 16:02:29 +08:00
|
|
|
|
4. �� `docs/06-tasks.md` 憸��蝚砌�銝� `TODO` 銝𥪯�韏硋� `DONE` ��遙�∴�敶枏�銝� T-401嚗剹��
|
2026-07-01 17:42:10 +08:00
|
|
|
|
5. 撠�砲隞餃𦛚�嗆��㺿銝� `DOING`��
|
|
|
|
|
|
|
|
|
|
|
|
## 蝏湔擪閫��
|
|
|
|
|
|
|
|
|
|
|
|
隞���嗆����𡝗𧒄�峕郊�湔鰵�祆�嚗𡁏鰵憓�/蝘餃𢆡�亙藁��辣���憪见�獢�沲�𡝗芋�𨰜��遙�∠𠶖����硔��鰵憓𧼮虾餈鞱��賭誘����唳�獢��隞��銝滢��氬��
|
|
|
|
|
|
|
|
|
|
|
|
- 隞餃𦛚�嗆����硋�甇� [`06-tasks.md`](06-tasks.md)��
|
|
|
|
|
|
- 瘥讛蔭�扯�霈啣����霂�𦶢隞扎��獈憛𠺶���蝑𤥁蕭�惩� [`../progress.md`](../progress.md)��
|
|
|
|
|
|
- �祆�隞嗅蘨靽萘�敶枏�敹怎�嚗䔶�靽萘�摰峕㟲��蟮��
|