Qiaomu Codex yordamida rasm yaratish qo‘llanmasi: Claude, Cursor va istalgan Agent avval uslubni tanlab, so‘ng rasm yaratsin

Loyiha haqida

qiaomu-codex-imagegen Codex’ning ichki tasvir yaratish imkoniyatlarini MCP xizmati, buyruqlar qatori vositasi va Agent Skill ko‘rinishida taqdim etadi. O‘rnatilgandan so‘ng Claude Code, Codex, Cursor yoki buyruqlarni bajara oladigan boshqa Agent tabiiy tildagi so‘rov asosida tasvir fayllarini yaratishi mumkin.

U oddiy “bitta prompt kiriting va tasvir oling” yondashuvidan farq qiladi: sukut bo‘yicha avval suggest_directions orqali mexanizmi turlicha bo‘lgan kamida to‘rtta uslub yo‘nalishini tavsiya qiladi. Foydalanuvchi yo‘nalishni tanlagach, compose_prompt to‘liq promptni yaratadi, so‘ng tasvir hosil qilinib, natija tekshiriladi.

Loyihada 24 turdagi sahna shabloni, 48 ta preset, 66 ta umumiy uslub va 20 nafar Mondo poster dizayneri uslubi mavjud. Shuningdek, matn, faktlar, kompozitsiya va qabul qilish mezonlariga oid qoidalar ham taqdim etiladi. Bu vosita muqova, poster, ijtimoiy tarmoq tasvirlari, mahsulot vizuallari va ma’lumotnoma tasvirlarini o‘zgartirish uchun mos.

Asosiy ish jarayoni

1. Yo‘nalishlarni tavsiya qilish: mavzu va foydalanish holatiga ko‘ra, matn ustuvor, yassi tuzilma, fotografik portret, mahsulotning yaqin plani yoki material-makon kabi mexanizmi turlicha bo‘lgan kamida to‘rtta yo‘nalishni qaytaradi.
2. Yo‘nalishni tanlash: foydalanuvchi bir yoki bir nechta yo‘nalishni tanlashi yoki qarorni Agent’ga topshirishi mumkin. Qoniqarsiz natija bo‘lsa, mavjud yo‘nalishlarni chiqarib tashlab, qayta tavsiya so‘rash mumkin.
3. Promptni kengaytirish: shablon o‘zgaruvchilarini to‘liq promptga joylaydi va bir vaqtda istisnolar, qabul qilish shartlari, taxminlar hamda yetishmayotgan ma’lumotlarni taqdim etadi.
4. Tasvir yaratish: tanlangan har bir yo‘nalish uchun bittadan tasvir yaratiladi. Qayta yaratish va turkumli kontent tayyorlashni osonlashtirish uchun amalda ishlatilgan JSON ma’lumotlari tasvir yonida saqlanadi.
5. Qabul qilish va qayta ishlash: Agent tasvirni qabul qilish shartlari bo‘yicha bandma-band tekshiradi. Talablarga javob bermasa, faqat tegishli qism o‘zgartirilib, tasvir yana bir marta yaratiladi.

Agar foydalanuvchi uslubni oldindan aniq ko‘rsatgan bo‘lsa, masalan, “Mondo uslubidan foydalaning” desa yoki to‘g‘ridan-to‘g‘ri T03 ni taqdim etsa, tizim yo‘nalish tanlash bosqichini o‘tkazib yuborib, bevosita promptni shakllantirish yoki yaratish bosqichiga o‘tishi mumkin.

O‘rnatishdan oldingi tayyorgarlik

Ishlatishdan oldin quyidagi muhitni tayyorlang:

• Node.js 18 yoki undan yuqori versiya: node --version orqali tekshirish mumkin.
• Codex CLI: uni o‘rnatish va tizimga kirish kerak. Buyruq mavjudligini codex --version orqali tasdiqlang.
• Tasvir yaratish huquqi: joriy Codex hisobida tasvir yaratish imkoniyati bo‘lishi kerak. Avval Codex’da qo‘lda bitta tasvir yaratib, tekshirish tavsiya etiladi.

Loyihaning o‘zi qaramliklarsiz Node.js loyihasidir, ammo haqiqiy tasvir yaratish uchun mahalliy kompyuterda ishlaydigan Codex CLI va hisobdagi limit talab etiladi.

Agent Skill’ni o‘rnatish

Agar foydalanayotgan Agent Agent Skills’ni qo‘llab-quvvatlasa, quyidagi buyruqni bevosita bajaring:

npx skills add joeseesun/qiaomu-codex-imagegen

Skill Agent’ga sahna, uslub, tavsif va qabul qilish usullarini tushunishga yordam beradi hamda MCP yoki loyiha tarkibidagi buyruqlar qatori vositasi orqali tasvirlar yaratadi.

MCP xizmatini ro‘yxatdan o‘tkazish

Claude Code’da ro‘yxatdan o‘tkazish

Quyidagi yo‘lni loyiha joylashgan haqiqiy katalog yo‘liga almashtiring:

claude mcp add --scope user qiaomu-codex-imagegen -- node /绝对路径/qiaomu-codex-imagegen/scripts/mcp-server.mjs

Boshqa MCP mijozlarida sozlash

Cursor, Codex yoki boshqa MCP mijozlari konfiguratsiya fayliga quyidagilarni qo‘shishi mumkin:

{
  "mcpServers": {
    "qiaomu-codex-imagegen": {
      "command": "node",
      "args": ["/绝对路径/qiaomu-codex-imagegen/scripts/mcp-server.mjs"]
    }
  }
}

MCP xizmati yettita vositani taqdim etadi:

• suggest_directions: bepul va tezkor tarzda mexanizmi turlicha bo‘lgan kamida to‘rtta uslub yo‘nalishini tavsiya qiladi.
• compose_prompt: shablon va presetlarni to‘liq promptga kengaytiradi hamda istisnolar, qabul qilish shartlari va yetishmayotgan ma’lumotlarni qaytaradi.
• generate_image: yangi tasvir yaratadi yoki ma’lumotnoma tasvirini o‘zgartiradi hamda fayl yo‘li va piksel o‘lchamlarini qaytaradi.
• search_prompts va get_prompt: mahalliy ma’lumotnoma promptlari to‘plamini qidiradi va o‘qiydi.
• build_prompt: soddalashtirilgan yo‘l uchun yaratilgan promptni oldindan ko‘rsatadi, ammo tasvir yaratmaydi.
• list_catalog: sahna presetlari, shablonlar, uslub kalitlari va mahalliy ma’lumotlar to‘plami holatini ko‘rsatadi.

Faqat buyruqlar qatoridan foydalanish

Agar MCP kerak bo‘lmasa, repozitoriyni klonlab, CLI’ni bevosita ishga tushirish mumkin:

git clone https://github.com/joeseesun/qiaomu-codex-imagegen
cd qiaomu-codex-imagegen
node scripts/cli.mjs "窗边翻开的书，书页上升起咖啡的热气" --preset xiaohongshu

Sukut bo‘yicha yaratilgan tasvirlar ~/Pictures/qiaomu-codex-imagegen/<日期> manziliga saqlanadi. --out, --name va --json orqali chiqish katalogi, fayl nomi va mashina o‘qiy oladigan natijani boshqarish mumkin.

Asosiy foydalanish: avval yo‘nalishlarni tavsiya qilish

Poster, muqova va ijtimoiy tarmoq tasvirlari uchun avval “tavsiya qilish, so‘ng yaratish” jarayonidan foydalanish ma’qul. Quyidagi buyruq “kofe do‘konidagi bir oylik kitob o‘qish tadbiri” uchun bir nechta yo‘nalishni tavsiya qiladi, ammo tasvir yaratish limitini sarflamaydi:

node scripts/cli.mjs suggest "一个月的咖啡店阅读活动" --for 视频封面

Natijada odatda har bir yo‘nalishning vizual mexanizmi, uslubiy cheklovi, to‘ldirilishi kerak bo‘lgan ma’lumotlar va ma’lumotnoma misollari ko‘rsatiladi. Bitta yo‘nalishni tanlashingiz yoki Agent’dan bir nechta yo‘nalishni parallel yaratib, taqqoslashni so‘rashingiz mumkin.

Shablon promptini kengaytirish

Yo‘nalish aniqlangach, avval to‘liq prompt va qabul qilish shartlarini ko‘rish mumkin:

node scripts/cli.mjs compose --template T03-1 --var topic=谷雨 --var subject=嫩芽 --var headline=谷雨

Shablon o‘zgaruvchilar asosida tizimli tavsif yaratadi. Unda asosiy obyekt va uslubdan tashqari matn iyerarxiyasi, bo‘sh joy, xavfsiz hudud, muvaffaqiyatsizlik shartlari va tekshiruv mezonlari ham bo‘lishi mumkin. Promptni oldindan ko‘rish rasmiy yaratishdan avval yetishmayotgan o‘zgaruvchilar yoki haddan tashqari uzun matnlarni aniqlashga yordam beradi.

Shablon yordamida tasvir yaratish

Prompt to‘g‘ri ekaniga ishonch hosil qilgach, tasvirni bevosita yaratish mumkin:

node scripts/cli.mjs generate --template T03-1 --var topic=谷雨 --var subject=嫩芽 --var headline=谷雨

Loyihada ulkan harflar va kichik hikoya, obyektning ramkadan chiqishi, markaziy yorug‘lik oralig‘i, sharqona siyohli tahrir, qog‘oz haykal va to‘qimachilik landshafti, fotografik portret, oziq-ovqatning yaqin plani, texnologik mahsulotning asosiy vizuali, me’moriy chizma va axborot kartasi kabi 24 turdagi shablon mavjud. Turli shablonlar faqat rang yoki filtrni emas, balki kompozitsiya mexanizmi, materiallar o‘rtasidagi munosabat, matn iyerarxiyasi va asosiy obyektlar o‘rtasidagi aloqani ham o‘zgartiradi.

Preset va uslublar yordamida tezkor yaratish

Agar sahna va uslub ma’lum bo‘lsa, yo‘nalish tavsiyasidan foydalanmasdan soddalashtirilgan yo‘lni tanlash mumkin. Masalan, uchta video muqovasi variantini yaratish:

node scripts/cli.mjs "一个巨大的红色播放键像日出一样升起" --preset video-cover --style saul-bass --count 3

Ko‘p ishlatiladigan sahna presetlari:

• xiaohongshu va xiaohongshu-square: Xiaohongshu uchun 3:4 yoki kvadrat muqova.
• video-cover: YouTube, Bilibili va boshqalar uchun 16:9 gorizontal muqova.
• video-vertical: Douyin, WeChat Channels va Reels uchun 9:16 vertikal muqova.
• wechat-cover: rasmiy akkaunt uchun 2.35:1 sarlavha tasviri.
• x-cover: X shaxsiy sahifasi uchun 5:2 muqova.
• moments: Moments uchun 4:5 poster.
• poster va movie-poster: umumiy va kinoposterlar.
• book-cover, album-cover, article va paper: kitob, albom, maqola va ilmiy-ommabop material tasvirlari.

Masalan, yozuvsiz kinoposter yaratish uchun Mondo uslubidan foydalaning:

node scripts/cli.mjs "沙漠中巨大的沙虫轮廓，渺小的人影" --preset movie-poster --style olly-moss

Tasvir ichidagi matnni boshqarish

Poster va muqovalarda odatda faqat bitta sarlavha emas, balki sarlavha, kichik sarlavha, axborot qatori yoki belgi ham kerak bo‘ladi. Matnni ko‘rsatish uchun --text dan foydalaning:

node scripts/cli.mjs "一座灯塔" --preset wechat-cover --text "夜航船"

Xitoycha yoki uzun matn bo‘lsa, qisqa jumlalarni har bir belgi bo‘yicha aniq taqdim etish va yaratishdan keyin kattalashtirib tekshirish tavsiya qilinadi. Loyiha tavsifida aytilishicha, model xitoycha matn va kichik shriftli axborot qatorlarini yaratishda hanuz mayda xatolarga yo‘l qo‘yishi mumkin. Portret yoki axborot qatlami talab qilinmaydigan mahsulotning yaqin plani uchun esa yozuvsiz variantdan foydalanish mumkin.

Ma’lumotnoma tasvirini o‘zgartirish

--ref orqali bir yoki bir nechta ma’lumotnoma tasvirini taqdim etish mumkin. Tasvir yo‘li mutlaq yo‘l bo‘lishi kerak:

node scripts/cli.mjs "保持同一支铅笔，背景换成暖米色纸张" --ref /abs/pencil.png --ratio 1:1

Bu usul fonni almashtirish, asosiy obyektni o‘zgartirmaslik yoki ayrim vizual qismlarni sozlash uchun mos. Loyiha tasvirni yashirincha qirqmaydi. Yakuniy nisbat talabga mos kelmasa, natijada o‘lchamdagi farq ko‘rsatiladi.

Promptni oldindan ko‘rish va mahalliy misollarni qidirish

Faqat promptni tekshirib, tasvir yaratmaslik uchun quyidagidan foydalaning:

node scripts/cli.mjs "咖啡和书" --preset xiaohongshu --show-prompt

Agar ixtiyoriy mahalliy ma’lumotlar to‘plami tayyorlangan bo‘lsa, o‘xshash misollarni ham qidirish mumkin:

node scripts/cli.mjs search "节气 茶" --limit 5

Ma’lumotlar to‘plamida taxminan 689 ta ma’lumotnoma prompti va kichik tasvirlar mavjud, ammo bu uchinchi tomon ma’lumotlari repozitoriy bilan birga tarqatilmaydi. Ma’lumotlar to‘plami bo‘lmasa ham, shablonlar, uslublar va tasvir yaratish jarayoni odatdagidek ishlaydi.

Ilg‘or sozlamalar va amaliy tavsiyalar

Turkumli tasvirlar uchun yo‘nalishni bir xil saqlash

Xiaohongshu uchun bir guruh tasvir yoki bir nechta muqova tayyorlayotganda, avvalgi tasvir uchun shablon va uslubni tanlab, keyingi tasvirlarda ham shu uslubiy cheklov, nisbat va axborot tuzilmasini davom ettirish tavsiya qilinadi. Bu har bir tasvirga alohida “o‘xshash uslub” deb yozishdan ko‘ra, izchillikni saqlashga yordam beradi.

Parallel variantlardan foydalanishda limitni nazorat qilish

--count 1 dan 4 tagacha variantni parallel yaratishi mumkin, ammo har bir rasm Codex yoki OpenAI hisobidagi limitdan foydalanadi. Bitta rasm odatda taxminan 30–60 soniya vaqt oladi; parallel yaratishlar soni qancha ko‘p bo‘lsa, sarf ham shuncha ortadi.

Shaffof fon muammosini hal qilish

Loyiha yaratilgan natijalardagi shaffof joylarni aniqlaydi. Standart holatda shaffof joylar aniqlansa, ular oq fonga tekislanadi; agar shaffof fonni saqlash zarur bo‘lsa, transparent_background: true parametridan foydalanish mumkin. Bu ishlov ayrim rasm ko‘rish dasturlari shaffof joylarni qora chegara sifatida ko‘rsatishining oldini oladi.

Codex yo‘li va kutish vaqtini belgilash

Agar tizim Codex’ni topa olmasa, bajariluvchi fayl yo‘lini QIAOMU_CODEX_BIN muhit o‘zgaruvchisi orqali belgilash mumkin. Yaratish jarayoni vaqt tugashi bilan yakunlansa, --timeout qiymatini oshiring yoki avval tavsifni soddalashtiring:

node scripts/cli.mjs "咖啡店阅读活动封面" --preset video-cover --timeout 120000

Mahalliy korpus paketini yaratish

Agar sizda archive.json, prompts/ va images/ kataloglarini o‘z ichiga olgan arxiv katalogi bo‘lsa, quyidagini bajaring:

node scripts/build-corpus.mjs /path/to/提示词归档

Standart korpus katalogi ~/.local/share/qiaomu-codex-imagegen/corpus bo‘lib, uni QIAOMU_CORPUS_DIR orqali boshqa joyga yo‘naltirish mumkin. Korpus paketidan faqat mahalliy kompyuterda foydalanish tavsiya etiladi; ruxsatsiz uchinchi tomon kontentini yubormang yoki uzatmang.

O‘rnatish muvaffaqiyatli yakunlanganini tekshirish

Loyiha oflayn testlar va katalogni tekshirish buyruqlarini taqdim etadi:

npm test
node scripts/cli.mjs --list
node scripts/cli.mjs "一个红色圆" --show-prompt

npm test rasmlar yaratish limitidan foydalanmaydi. U shablonlarni yig‘ish, matn rejimi, tuzilmalarni almashtirish, yo‘nalishlar xilma-xilligi, korpusdan qidirish, shaffof fon bilan ishlash va protokol kabi funksiyalarni tekshirish uchun ishlatiladi.

Ko‘p beriladigan savollar

• cannot start codex: Codex CLI o‘rnatilganini tekshiring yoki QIAOMU_CODEX_BIN ni sozlang.
• codex finished without producing an image: Codex’ga kirish holatini va hisobda rasm yaratish huquqi borligini tekshiring.
• timed out: Kutish vaqtini oshiring yoki tavsif murakkabligini kamaytiring.
• Nisbat kutilganidek emas: Tavsifda nisbatni yana bir bor ta’kidlang yoki --ratio dan foydalaning; vosita tasvirni avtomatik va bildirmasdan kesmaydi.
• Yo‘naltiruvchi rasm topilmadi: --ref qiymatini mutlaq yo‘lga o‘zgartiring.

Xulosa

qiaomu-codex-imagegen’ning asosiy maqsadi oddiygina bir jumlani rasm modeliga uzatish emas, balki sahna, uslub, kompozitsion munosabatlar, matn iyerarxiyasi va qabul qilish mezonlarini qayta foydalanish mumkin bo‘lgan ish jarayoniga birlashtirishdir. Agent Skill yoki MCP’dan boshlab, Agent’ga yo‘nalishlarni tavsiya qilish va jarayonni boshqarishni topshirishingiz mumkin; shuningdek, CLI orqali preset, uslub, nisbat, matn va yo‘naltiruvchi rasmlarni aniq boshqarishingiz mumkin.

Muqova, plakat va turkum rasmlarni barqaror yaratish talab qilinadigan vazifalar uchun “avval yo‘nalishlarni tavsiya qilish, keyin promptni batafsil ishlab chiqish, yaratishdan so‘ng shartlar asosida qabul qilish” jarayonidan foydalanish tavsiya etiladi. Rasm ichidagi rasmiy foydalaniladigan matn va o‘lchamlarni esa qo‘lda qayta tekshiring.