Isifundo se-McOracle: Kusukela Esiprofethweni Esingahleliwe Kuya Ezincomweni Zemenyu Yangempela Naseku-odeni Okuphephile

Yini i-McOracle

IMcOracle (Isiprofetho se-McDonald's) iyisipiliyoni se-AI oracle esisesimweni se-Skill kuphela. Abasebenzisi bangabuza noma yimuphi umbuzo, bese uhlelo lusebenzisa imojuli ye-Python secrets ukukhetha ngokungahleliwe ngempela impendulo eyodwa kweziprofetho zesiShayina ezingu-104 ezidalwe ekuqaleni. Bese luhlanganisa i-MCP esemthethweni yaseMcDonald's China ukuze luhlole izitolo zangempela, imenyu etholakalayo nezintengo, lukhiqize “IsAmbulo se-McDonald's” kanye nekhadi lesiphetho.

Umgomo oyinhloko wephrojekthi uthi: isiprofetho singaba ngokungahleliwe, kodwa imikhiqizo nezintengo kufanele kube ngokoqobo. Iziprofetho zivela kudatha engaguquki esendaweni yokugcina ikhodi, azidalwa yisistimu okwesikhashana; ukudla, izitolo nezintengo kusetshenziswa kuphela idatha ebuyiswe yi-MCP; uma intengo ingakaqinisekiswa, kuboniswa “Intengo ayikaqinisekiswa”. Ngaphambi kokuba umsebenzisi aqinisekise ngokusobala, uhlelo aludali i-oda, futhi ukudalwa kwe-oda akusho ukuthi inkokhelo iphumelele.

Inqubo ephelele yokusebenza

Uchungechunge olujwayelekile lwe-McOracle lunezigaba ezinhlanu:

1. Umsebenzisi ubuza umbuzo noma ucela ngokuqondile isiprofetho se-McDonald's.
2. scripts/draw-oracle.py ikhetha isiprofetho ngokungahleliwe ngempela ku-references/oracle-library.json, bese ikhiya umphumela walolu hambo.
3. Uma umsebenzisi edinga izincomo zokudla, i-Skill isebenzisa i-MCP ukuhlola izitolo eziseduze, imenyu etholakalayo nemininingwane yokudla.
4. Intengo iqinisekiswa nge-calculate-price, bese kusetshenziswa scripts/generate-card.py ukukhiqiza ikhadi lesiphetho le-PNG elingu-1200×1600.
5. Ngemva kokuba umsebenzisi ephendule ngokusobala ethi “Qinisekisa i-oda” kuphela, uhlelo luphinde luhlole imininingwane ye-oda bese lubiza create-order. Ngemva kwalokho umsebenzisi kusafanele azikhokhele esebenzisa isango elisemthethweni.

Uma umsebenzisi efuna ukukhetha isiprofetho kuphela, inqubo iphela esigabeni sokuqala; indawo ayiphoqelelwa futhi i-MCP ayibizwa.

Amamojuli ayinhloko nesakhiwo sephrojekthi

Iphrojekthi yakhiwe kakhulu ngamamojuli alandelayo:

• Oracle Engine: draw-oracle.py nomtapo weziprofetho kuphethe ukukhetha ngokungahleliwe, ukukhiya umphumela nokulawula ukukhetha kabusha.
• Recommendation Engine: recommendation-rules.md ihlanganisa amalebula eziprofetho nezinkomba zokudla, bese inikeza izincomo ngokusekelwe kwimenyu yangempela kanye nesabelomali.
• MCP Adapter: SKILL.md kanye ne-MCP_INTEGRATION.md kuchaza ukulandelana kwamathuluzi, imithetho yamapharamitha nokuphathwa kwamaphutha.
• Card Generator: generate-card.py isebenzisa i-Pillow ukudweba ithempulethi elibomvu lewayini negolide ngokohlelo, bese ihlanganisa izithombe zemikhiqizo ezisemthethweni.
• Order Safety Controller: validate-order.py isebenzisa umshini wezimo ukulawula inqubo yokuqinisekisa nokuvimbela ama-oda angaqinisekisiwe.
• Skill Orchestrator: SKILL.md ichaza izimo zokuqalisa, inqubo yokwenza, ifomethi yokuphumayo nezidingo zokuphepha.

Umtapo weziprofetho uqukethe okuqukethwe kwasekuqaleni okungu-104, okuhlanganisa izigaba eziyisishiyagalombili: ezivumayo, eziphikayo, ezokulinda, ezokuthatha isinyathelo, eziphendukayo, zenhlanhla, ezihlekisayo nezikhethekile ze-McDonald's. Isiprofetho ngasinye sinekhodi, umbhalo, isigaba, amalebula, incazelo, iseluleko sesenzo, amalebula ezincomo netimu ebonakalayo.

Ukufaka okuncike ku-Python

Iphrojekthi idinga i-Python 3.9 noma ngaphezulu. Indawo yokuthuthukisa isebenzisa i-Python 3.13. Ikhadi lesiphetho elisemthethweni lihlelwa yi-Pillow, ngakho i-Pillow kufanele ifakwe; izikripthi zokukhetha isiprofetho nokuphepha kwe-oda zona azidingi i-API yokukhiqiza izithombe.

git clone <your-repo-url> McOracle
cd McOracle
pip install Pillow

Uma usebenzisa i-macOS noma i-Linux, qinisekisa ukuthi uhlelo lunefonti ekwazi ukubonisa isiShayina. Isikripthi sizokhetha ifonti etholakalayo ohlwini lwamakhandidethi. Ikhadi elisemthethweni alidingi ukumiswa kwe-API Key yokukhiqiza izithombe.

Ukufaka njenge-WorkBuddy Skill

1. Thola iphrojekthi bese ufaka okuncike kuyo.
2. Kopisha yonke ifolda ye-McOracle/ kufolda ye-Skill yomsebenzisi ~/.workbuddy/skills/McOracle/, noma kufolda ye-{workspace}/.workbuddy/skills/McOracle/ yendawo yokusebenza yamanje.
3. Vula i-MCP yaseMcDonald's China kuma-connector e-WorkBuddy.
4. Vula ingxoxo usebenzise amagama afana nokuthi “Isiprofetho se-McDonald's”, “Dweba isiprofetho” noma “Isiprofetho sanamuhla” ukuze uqale i-Skill.

Ungabuza nombuzo ojwayelekile, njengokuthi “Ngifanele yini ukuyeka umsebenzi?”. Uma ufuna ukwenza lonke uchungechunge, ungathi “Ngifuna isiphetho esiphelele sanamuhla se-McDonald's”. Izinguqulo ezahlukene ze-WorkBuddy zingase zibe nezidingo ezahlukene zemethadatha yokubhalisa i-Skill; engeza ukumiswa okufanele ngokwenguqulo yendawo.

Ukumisa i-MCP esemthethweni yaseMcDonald's China

Ngaphambi kokusebenzisa izitolo, imenyu nezintengo zangempela ezincomweni, funda umhlahlandlela osemthethweni wokusebenzisa i-MCP ukuze ufunde indlela yokufaka isicelo se-Token, bese ugcwalisa ukumiswa ku-WorkBuddy ngaphansi kokuthi “Ama-connector” → “I-connector yangokwezifiso” → “Misa i-MCP”.

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Faka i-Token yakho esikhundleni se-YOUR_MCP_TOKEN, futhi ungayifaki i-Token endaweni yokugcina ikhodi. Amathuluzi amakhulu asetshenziswa yiphrojekthi afaka now-time-info, query-nearby-stores, query-meals, query-meal-detail kanye ne-calculate-price. Ithuluzi elihlobene nama-oda, i-create-order, lingabizwa kuphela ngemva kokuqinisekiswa okusobala komsebenzisi.

Ukusetshenziswa kokuqala: ukukhetha isiprofetho

Qalisa umyalo olandelayo empandeni yephrojekthi ukuze ukhethe isiprofetho esisodwa sombuzo othile:

python scripts/draw-oracle.py --question '今天吃什么？'

Umphumela wokukhetha ubhalwa ku-scripts/_oracle_state.json futhi ukhiywe kulolu hambo. Ngale ndlela, incazelo, izincomo kanye nekhadi lesiphetho elilandelayo kuzosebenzisa isiprofetho esifanayo, ngaphandle kokushintsha ngephutha ngenxa yokufundwa kaningi.

Ukuze ubuke umphumela okhiyiwe noma ucele ukukhetha kabusha:

python scripts/draw-oracle.py --peek
python scripts/draw-oracle.py --redraw

I---redraw kufanele isetshenziswe kuphela lapho umsebenzisi ecela ngokusobala ukukhetha kabusha. Uhlelo alushintshi isiprofetho ngokwalo lapho lukhiqiza incazelo noma ikhadi lesiphetho.

Ukukhiqiza ikhadi lesiphetho

Ikhadi lesiphetho lisebenzisa ithempulethi elingaguquki elibomvu lewayini negolide, ngaphandle kwesevisi yokukhiqiza izithombe. Ingemuva line-gradient ebomvu emnyama yewayini, umngcele wegolide onezendlalelo ezimbili, indandatho ekhanyayo emaphakathi nemihlobiso yamachashazi ezinkanyezi; umbhalo uhlelwa yi-Pillow ukuze kugwenywe ukuphazamiseka noma ukuchichima kwesiShayina, amakhodi nezintengo.

Uma izithombe zemikhiqizo ezisemthethweni zibuyiswe yi-MCP futhi intengo iqinisekiswe nge-calculate-price, ikhadi elisemthethweni lingakhiqizwa kanje:

python scripts/generate-card.py \
  --oracle-id 'NO.021' \
  --answer '别在深夜做决定。' \
  --interpretation '凌晨一点的你和上午十点的你，不是同一个人。' \
  --item-name '板烧鸡腿堡三件套' \
  --item-price 34.5 \
  --price-verified \
  --item-image-url 'https://menu-img.mcd.cn/.../MS_9900005462_320.png' \
  --out examples/oracle-card-NO021-official.png

Ubukhulu bokuphumayo okusemthethweni yi-1200×1600 PNG. I---price-verified ingasetshenziswa kuphela uma intengo iqinisekiswe ngempela yi-MCP; intengo yesibonelo akumele ithathwe njengentengo yesikhathi sangempela.

Isu lokwehlisa izinga lezinto zezithombe

Umkhiqizo oyinhloko uphathwa ngokubaluleka okulandelayo:

1. Kusetshenziswa kuqala izithombe ezisemthethweni zemikhiqizo ezibuyiswe yi-query-meals noma yi-query-meal-detail.
2. Uma singekho isithombe esisemthethweni, kungasetshenziswa --item-image ukuze kunikezwe umfanekiso ozimele womqondo, futhi ubhalwe ngokweqiniso njengomfanekiso womqondo.
3. Uma izinto zangaphandle zingatholakali, isikripthi sisebenzisa imifanekiso eyakhelwe ngaphakathi ehlelwe ngohlelo yamabhega, amafries ne-Coke.
4. Uma zonke izinto zingatholakali, kukhishwa ikhadi elithi “Izinto ezibonakalayo zokudla azitholakali”, ngekhodi yokuphuma engu-2 kanye ne-JSON ok=false ebika ukwehluleka.

Iphrojekthi ayisebenzisi indandatho engenalutho ukwenza sengathi iwukudla, futhi ayilebuli umfanekiso womqondo njengokungathi uyisithombe esisemthethweni sangempela.

Ukuqedela isipiliyoni esiphelele engxoxweni

Ingxoxo ejwayelekile ingahamba kanje:

Wena: Isiprofetho se-McDonald's, ingabe namuhla kufanele ngiyeke umsebenzi?
McOracle: Ikhetha isiprofetho, ibuyise umbhalo, incazelo, iseluleko sesenzo nesexwayiso sezindaba ezibalulekile, futhi inganikeza izincomo zanamuhla.

Wena: Ngilungele ukufaka i-oda
McOracle: Ibonisa isifinyezo se-oda esinezitolo, indlela yokulanda, imikhiqizo nezintengo, bese ikucela ukuthi uqinisekise.

Wena: Qinisekisa i-oda
McOracle: Iphinde iqinisekise intengo, ibize i-create-order, bese ibuyisa inombolo ye-oda yangempela kanye nesango lokukhokha elisemthethweni.

“Bheka”, “Ngincomele okuthile” kanye nokuthi “Ngilungele ukufaka i-oda” akusho ukuqinisekiswa kokugcina. Inqubo ye-oda ingaqhubeka kuphela ngemva kokuba umsebenzisi ephendule ngokusobala ethi “Qinisekisa i-oda”.

Indlela yokuphepha kwama-oda

Isilawuli sokuphepha kwama-oda sihlola isimo se-oda namapharamitha abalulekile. Uma isitolo, umkhiqizo, inani, intengo noma indlela yokulanda ishintsha, ukuqinisekiswa kwangaphambilini kuba yize; uhlelo kufanele luphinde lubonise isifinyezo futhi lucele ukuqinisekiswa.

Iphrojekthi ayikhokhi ngokuzenzakalelayo, futhi ayenzi izinombolo zama-oda mbumbulu noma imilayezo ethi i-oda liphumelele. Ngemva kokudalwa kwe-oda lisasesigabeni sokulinda inkokhelo esingaphandle kwenqubo yokukhokha esemthethweni; umsebenzisi kufanele aqedele inkokhelo ngokwakhe ekhasini elisemthethweni. Ukuzilanda esitolo kanye ne-drive-thru kusebenzisa orderType=1, kanti ukulethwa kusebenzisa orderType=2 futhi kudinga ikheli lokulethwa; lezi zinhlobo ezimbili zamapharamitha azikwazi ukuxubana.

Ukusebenzisa ngokuzimela umboniso wokuphepha kwama-oda

Isikripthi sama-oda sinikeza umboniso we-Mock osekelwe kumqondo kuphela, futhi asidali i-oda langempela:

python scripts/validate-order.py demo

Lo mboniso ulungele ukuhlola imithetho yokuqinisekisa ngaphambi kokuxhuma i-MCP yangempela, okuhlanganisa ukuthi i-oda alinakwenziwa ngaphandle kokuqinisekiswa, inkulumo engaqondakali ayibalwa njengokuqinisekisa, izinguquko kumapharamitha ze-oda zenza ukuqinisekiswa kube yize, nokuthi ukudalwa kwe-oda akusho ukuphumelela kwenkokhelo.

Ukuqhuba izivivinyo

Iphrojekthi inamaqoqo amathathu ezivivinyo, ahlanganisa umqondo weziprofetho, ukukhiqizwa kwamakhadi esiphetho kanye nomshini wezimo zokuphepha kwama-oda:

python tests/test-oracle.py
python tests/test-card.py
python tests/test-order-safety.py

I-README ibhala ukuthi umphumela wamanje yizivivinyo ezingu-24 eziphumelele zonke. Izivivinyo zeziprofetho ziqinisekisa idatha engu-104, ubunye bamakhodi, izigaba eziyisishiyagalombili, ukungahleliwe nokukhiya kwesimo; izivivinyo zamakhadi ziqinisekisa i-PNG yangempela, ubukhulu, ukwehliswa lapho izinto zingekho, igatsha lentengo engaqinisekisiwe nokuhlelwa kombhalo omude; izivivinyo zama-oda zisebenzisa i-Mock ukuqinisekisa izinguquko eziphephile zesimo, azibizi i-MCP yangempela futhi azidali ama-oda.

Izincomo zokusebenzisa ezithuthukile

Hlukanisa isiprofetho sokuzijabulisa nesinqumo sangempela

Iziprofetho zenzelwe ukuzijabulisa nokukhuthaza kuphela; azibikezeli ikusasa futhi azikwazi ukuthatha indawo yokwahlulela kwangempela. Imibuzo ephathelene nokuyeka umsebenzi, ukutshalwa kwezimali, impilo, umthetho noma ezezimali kufanele icatshangelwe kanye nezimo eziqondile futhi kuboniswane nochwepheshe.

Hlukanisa njalo intengo eqinisekisiwe nentengo yesibonelo

Amayunithi ezintengo abuyiswa yi-MCP “ama-fen”, ngakho kufanele ahlukaniswe ngo-100 ngaphambi kokuboniswa, futhi izintengo ziyashintsha ngokuhamba kwesikhathi. Uma ukuqinisekiswa kwesikhathi sangempela kungakaqedwa, kufanele kuboniswe “Intengo ayikaqinisekiswa”; ungabonisi intengo yesibonelo ekhadini noma engxoxweni esikhundleni sentengo yesikhathi sangempela.

Phatha iziqinisekiso nobumfihlo

IToken ne-API Key kufanele kufundwe kuphela ngokumiswa kwe-connector noma ngeziguquguquko zemvelo; akufanele kubhalwe kukhodi yomthombo noma kuthunyelwe endaweni yokugcina ikhodi. Iphrojekthi akufanele igcine ubumfihlo bomsebenzisi, ama-Cookie, izinombolo zama-oda noma iziqinisekiso zomuntu siqu. Lapho uthumela i-Issue noma i-Pull Request, ungafaki lolu lwazi olubucayi.

Qonda imingcele yamakhono amanje

Ukuseshwa kwezitolo, ukuseshwa kwemenyu, imininingwane yokudla, ukubalwa kwentengo, ukulanda izithombe ezisemthethweni kanye nokukhiqizwa kwamakhadi esiphetho sekuqinisekiswe ngokusetshenziswa kwangempela. Uxhumano oluphelele “lokufaka i-oda—ukukhokha—ukubheka isimo futhi”, uchungechunge lwe-McDelivery kanye nezinqubo zokuthola nokusebenzisa amakhuphoni kusenezingxenye ezingakahlolwa ngokuphelele; ngakho akufanele kuchazwe njengokuthi sekuqinisekiswe ekupheleni kuya ekupheleni.

Isiphetho

I-McOracle ihlanganisa idatha emisiwe yesiphrofetho, ukukhethwa okungahleliwe ngempela, imenyu esemthethweni ye-MCP ebuyekezwa ngesikhathi sangempela, kanye nokuhlelwa kwezithombe okuhlelwe ngohlelo ukuze kwakhe i-WorkBuddy Skill ejabulisayo. Ungaqala ngokusebenzisa iskripthi sesiphrofetho kuphela, noma ulungiselele i-MCP ukuze uthole izincomo ezengeziwe zezitolo, izitsha namaz价格. Lapho uyisebenzisa, khumbula le migomo emithathu: isiprofetho esokuzijabulisa, amanani kufanele aqinisekiswe ngesikhathi sangempela, futhi ungalokothi udale i-oda ngaphambi kokuba umsebenzisi aqinisekise ngokucacile.

Isiphetho singahleliwe, kodwa amanani kufanele abe ngokoqobo.