Pacáistiú an bhreiseáin
Ar an leathanach seo
An ceacht athscríofa an 3 Samhain, 2026 bunaithe ar an leathanach Package your plugin i ndoiciméadú Breiseáin OpenAI. Thug an ceacht roimhe seo cur síos ar thógáil “pacáiste” do “Siopa ChatGPT” nach raibh ann riamh ag baint úsáide as comhad léirithe in easnamh. Déantar breiseán a phacáistiú le comhad léirithe
plugin.jsona leanann scéima Breiseáin Ghníomhairí. Foinse: Package your plugin.
Cén fáth pacáistiú
Nuair a bheidh do scileanna scríofa agat agus, más gá, an freastalaí MCP tógtha agat, is é an chéim dheireanach ná iad a chur le chéile in aonad inshuite. Tugann pacáistiú céannacht chobhsaí do do bhreiseán agus insíonn sé do ChatGPT agus do Codex cé na scileanna, naisc freastalaí MCP, agus acmhainní a bhaineann le chéile. Fanann an chomhéadan úsáideora agus an loighic fíordheimhnithe laistigh den fhreastalaí MCP; ní dhéanann an comhad léirithe ach an chomhtháthú sin a nascadh le chuid eile an bhunáisc.
Struchtúr pacáiste iniompartha
Tá comhad léirithe plugin.json ag fréamh breiseáin iniompartha, ag dearbhú scéima Breiseáin Ghníomhairí. Is féidir leis an bhfillteán fillteán skills/, comhad mcp.json le haghaidh freastalaithe MCP a dháiltear leis an mbreiseán, agus sócmhainní amhairc in assets/ a bheith ann freisin.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Oireann an comhad léirithe íosta do chúpla líne amháin. Feidhmíonn an t-ainm, atá cobhsaí agus i kebab-case, mar aitheantóir agus mar spásainm do chomhpháirteanna; faightear scileanna go huathoibríoch in skills/ gan gá le dearbhú sainráite.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes"
}
Cónaíonn gach scil in skills/<name>/SKILL.md, le ceanntásc a sholáthraíonn a ainm agus a chur síos, agus treoracha ina dhiaidh sin:
---
name: compte-rendu
description: Drafts meeting minutes from team notes.
---
Retrieve meeting notes using list_notes, group them by topic,
then draft a summary: decisions, action items with owners, and open points.
An freastalaí MCP a dhearbhú
Dearbhaítear freastalaithe MCP a dháiltear leis an mbreiseán in mcp.json ag an bhfréamh, ag baint úsáide as an scéima chomhfhreagrach agus ag sonrú cineál iompair do gach freastalaí:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Dearbhaítear fíordheimhniú an fhreastalaí sa chomhad céanna seo, faoi extensions["com.openai"].auth do gach freastalaí – baineann sé leis an bhfreastalaí, ní leis an gcomhad léirithe. Chun cur isteach poiblí, seolann tú an críochphointe HTTPS cianda; leanann freastalaithe áitiúla conair ar leith atá curtha in áirithe do bhreiseáin deisce.
Meiteashonraí sonrach do OpenAI
Dearbhaítear cur i láthair na comhadlainne, mapálacha le freastalaithe MCP atá cláraithe cheana, agus hacaí in oibiacht extensions.com.openai de plugin.json na fréimhe, cé go bhfanann an chéannacht iniompartha (name, version, description) ag an bhfréamh:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes",
"extensions": {
"com.openai": {
"interface": {
"displayName": "Team Notes",
"shortDescription": "Notes and meeting minutes",
"developerName": "Your Team",
"category": "Productivity",
"capabilities": ["Read", "Write"],
"websiteURL": "https://example.com",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": ["Use Team Notes to draft Monday's meeting minutes."],
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
}
}
}
}
Tá conairí san oibiacht seo coibhneasta le fréamh an bhreiseáin agus tosaíonn siad le ./. Ba chóir dul le sócmhainní amhairc (composerIcon, logo, screenshots) in ./assets/ de ghnáth. Ní úsáidtear an réimse apps ach chun pointe a dhéanamh ar chomhad .app.json ina bhfuil mapálacha le freastalaithe MCP atá cláraithe cheana i ChatGPT.
Is féidir leat scil tosaithe a dhearbhú freisin trí extensions.com.openai.onboardingSkill (mar shampla, ./skills/setup/SKILL.md: treoraíonn sé an t-úsáideoir tar éis an tsuiteála chun spás oibre a roghnú nó roghanna a shocrú. Déan tástáil air i gcomhrá nua agus le linn suiteála atá ar siúl cheana féin.
Glactar fós le formáid níos sine, le comhad léirithe in .codex-plugin/plugin.json, chun comhoiriúnachta: ní úsáidtear é ach mura bhfuil an oibiacht extensions.com.openai i láthair, toisc nach ndéantar an dá cheann a chumasc. Ba chóir do phacáistí nua plugin.json na fréimhe a úsáid.
An bealach tapa: @plugin-creator
Tá scil, @plugin-creator, i ChatGPT agus Codex a ghineann an struchtúr duit – faoi láthair sa fhormáid comhoiriúnachta .codex-plugin/. Chun freastalaí MCP a cheangal leis, ceangail an freastalaí sin i ChatGPT ar dtús (Add custom MCP server, ansin Create as a plugin), tabhair faoi deara an t-aitheantóir teicniúil ceangail ón URL brabhsálaí – tosaíonn sé le plugin_asdk_app – agus soláthair é do @plugin-creator sa Mhód Oibre (nó do $plugin-creator i Codex). Is féidir leis an scil iontráil margaidh phearsanta a chruthú freisin, rud a ligeann duit an breiseán a shuiteáil agus a thástáil ó do fhoinse comhadlainne áitiúla.
Margaí áitiúla
Is catalóg JSON de bhreiseáin é margadh. Feidhmíonn sé le haghaidh scríbhneoireachta, tástála, agus dáileadh foirne taobh le taobh an eolaire phoiblí: sa Mhód Oibre nó i Codex, feictear gach margadh mar fhoinse inroghnaithe san eolaire breiseáin. Seo an bealach a ndéanfaidh tú tástáil ar an mbreiseán iomlán sula gcuireann tú isteach é (Ceacht 9).
Hacaí: deasc amháin
Ní thacaítear le hacaí saolré ach do bhreiseáin a shuiteáiltear de láimh san aip deisce Codex, agus ní bhíonn breiseán ina bhfuil siad incháilithe don eolaire poiblí. Má tá do bhreiseán dírithe ar fhoilsitheoireacht, fág ar lár iad.
Príomhphointí
- Pacáiste iniompartha:
plugin.json(scéima Breiseáin Ghníomhairí),skills/,mcp.json,assets/ - Dearbhaítear an freastalaí MCP in
mcp.jsonlena chineál iompair; téann an fíordheimhniú ann freisin - Téann an cur i láthair, na mapálacha, agus an scil tosaithe in
extensions.com.openai - Gineann
@plugin-creatoran struchtúr; úsáidtear margadh áitiúil le haghaidh tástála - Níl breiseán le hacaí incháilithe don eolaire poiblí