అవలోకనం

వర్క్‌స్పేస్ నిర్వాహకులు GitHub నుంచి ప్లగిన్ మార్కెట్‌ప్లేస్‌ను తమ వర్క్‌స్పేస్ డైరెక్టరీలోకి దిగుమతి చేసుకోవచ్చు. మార్కెట్‌ప్లేస్ అనేది దిగుమతి చేసుకోవాల్సిన ప్లగిన్‌లను జాబితా చేసే JSON కేటలాగ్. దిగుమతి తర్వాత, రోజువారీ సమకాలీకరణ రిపోజిటరీలోని మార్పులతో ప్లగిన్‌లను తాజాగా ఉంచుతుంది.


మార్కెట్‌ప్లేస్ సమకాలీకరణ ప్లగిన్ కంటెంట్‌ను దిగుమతి చేస్తుంది. ఇది వర్క్‌స్పేస్ సభ్యుల ఖాతాలను అనుసంధానించదు లేదా ప్లగిన్‌లో ఉన్న యాప్‌లకు ప్రాప్యతను మంజూరు చేయదు.


ప్లగిన్‌లు, వాటిలో ఉన్న యాప్‌ల పరిచయం కోసం, ChatGPT మరియు Codexలో ప్లగిన్‌లు చూడండి.

మీరు ప్రారంభించడానికి ముందు

• మార్కెట్‌ప్లేస్ రిపోజిటరీతో పాటు అది సూచించే ప్రతి ఇతర రిపోజిటరీని చదవగల GitHub ఖాతాను ఉపయోగించండి. github.comలోని పబ్లిక్, ప్రైవేట్ రిపోజిటరీలకు మద్దతు ఉంది.

• దిగుమతి చేసే ఖాతాకు ఆ రిపోజిటరీల ప్రాప్యత కోసం అవసరమైన GitHub సంస్థ ఆమోద ప్రక్రియను పూర్తి చేయండి.

• రిపోజిటరీ కంటెంట్‌ను సమీక్షించండి. ప్రతి ప్లగిన్‌కు విడిగా ఆమోదం అవసరం లేకుండానే దిగుమతి ప్రక్రియ చెల్లుబాటయ్యే అన్ని ప్లగిన్‌లను ప్రాసెస్ చేస్తుంది. భవిష్యత్తు సమకాలీకరణలు కొత్త ప్లగిన్‌లను జోడించగలవు.

కొత్త ప్లగిన్‌లు మొదట అందుబాటులో ఉంది అనే ఇన్‌స్టాలేషన్ సెట్టింగ్‌తో ఉంటాయి. ఇన్‌స్టాల్ చేసేటప్పుడు ప్రామాణీకరణ జరుగుతుంది. కొత్త మార్కెట్‌ప్లేస్‌లలో స్వయంచాలక రోజువారీ సమకాలీకరణ ప్రారంభించబడి ఉంటుంది. దిగుమతి తర్వాత, ప్రతి ప్లగిన్ వర్క్‌స్పేస్ సెట్టింగ్‌లను, అవసరమైన యాప్‌లను సమీక్షించండి.

మార్కెట్‌ప్లేస్‌ను దిగుమతి చేయండి

1. నిర్వాహక కన్సోల్‌కు వెళ్లి, కావాల్సిన ChatGPT వర్క్‌స్పేస్‌ను ఎంచుకుని, ప్లగిన్‌లు తెరవండి. తర్వాత జోడించు ఎంచుకుని, మార్కెట్‌ప్లేస్‌ను దిగుమతి చేయి ఎంచుకోండి.

2. మూలంలో రిపోజిటరీ యూఆర్ఎల్‌ను నమోదు చేయండి. ఉదాహరణకు, https://github.com/example/team-plugins. బ్రాంచ్ లేదా ఫోల్డర్ యూఆర్ఎల్ కాకుండా, రిపోజిటరీ యూఆర్ఎల్‌ను మాత్రమే ఉపయోగించండి.

3. మార్కెట్‌ప్లేస్ ఉపడైరెక్టరీలో ఉంటే, ఆ డైరెక్టరీని పాత్లో నమోదు చేయండి. ఉదాహరణకు, team-tools/.agents/plugins/marketplace.json కోసం team-tools నమోదు చేయండి. రిపోజిటరీ మూల డైరెక్టరీ కోసం పాత్ను ఖాళీగా వదిలేయండి. మానిఫెస్ట్ ఫైల్ పేరును నమోదు చేయవద్దు.

4. కావాలనుకుంటే బ్రాంచ్, ట్యాగ్ లేదా కమిట్ను నమోదు చేయండి. రిపోజిటరీ డిఫాల్ట్ బ్రాంచ్‌ను ఉపయోగించడానికి దాన్ని ఖాళీగా వదిలేయండి. భవిష్యత్తు కమిట్‌లను పొందడానికి బ్రాంచ్‌ను ఉపయోగించండి. నిర్దిష్ట కమిట్‌ను ఎంచుకుంటే అదే సంచికలో ఉంటుంది.

5. మార్కెట్‌ప్లేస్‌ను దిగుమతి చేయి ఎంచుకుని, అడిగినప్పుడు GitHub ప్రాప్యతకు అనుమతి ఇవ్వండి.

6. దిగుమతి ఫలితాలు సమీక్షించండి. తర్వాత దిగుమతి చేసిన ప్రతి ప్లగిన్‌ను తెరిచి, దాని ఇన్‌స్టాలేషన్ విధానాన్ని, అవసరమైన యాప్‌లను కాన్ఫిగర్ చేయండి.

చాలా పెద్ద మార్కెట్‌ప్లేస్‌లను మొదటిసారి దిగుమతి చేయడానికి 1 గంట వరకు పట్టవచ్చు. ఆ తర్వాత రోజువారీ సమకాలీకరణలకు సాధారణంగా కొన్ని నిమిషాలు పడుతుంది.

ప్లగిన్‌ను దిగుమతి చేయలేకపోతే, నివేదికలో లోపానికి వివరణ ఉంటుంది. అయినా, చెల్లుబాటయ్యే ఇతర ప్లగిన్‌లను దిగుమతి చేయవచ్చు.

మద్దతు ఉన్న ఆకృతులు

ఎంచుకున్న డైరెక్టరీలో మద్దతు ఉన్న మానిఫెస్ట్ ఉండాలి:

• Codex మార్కెట్‌ప్లేస్ కోసం .agents/plugins/marketplace.json.

• Claudeకు అనుకూలమైన మార్కెట్‌ప్లేస్ కోసం .claude-plugin/marketplace.json.

• మార్కెట్‌ప్లేస్ మానిఫెస్ట్ లేనప్పుడు, స్వతంత్ర Claude ప్లగిన్ కోసం .claude-plugin/plugin.json.

మార్కెట్‌ప్లేస్ నమోదులు అదే రిపోజిటరీలోని ప్లగిన్ ఫోల్డర్‌లను లేదా మద్దతు ఉన్న GitHub రిపోజిటరీ మూలాలను సూచించవచ్చు. ఇతర Git హోస్ట్‌లు, npm వంటి ప్యాకేజీ రిజిస్ట్రీ మూలాల నుంచి వర్క్‌స్పేస్‌లోకి దిగుమతి చేయడానికి మద్దతు లేదు.

మద్దతు ఉన్న ఆకృతులు, JSON ఉదాహరణలు, మూల ఫీల్డ్‌ల కోసం, ప్లగిన్ నిర్వహణ చూడండి.

వర్క్‌స్పేస్ ప్రాప్యతను కాన్ఫిగర్ చేయండి

GitHub ప్లగిన్ కంటెంట్‌ను అందిస్తుంది. వర్క్‌స్పేస్ సెట్టింగ్‌లు ఇన్‌స్టాలేషన్‌ను, ప్రామాణీకరణను నియంత్రిస్తాయి. దిగుమతి, సమకాలీకరణ ప్రక్రియలు AVAILABLE లేదా ON_USE వంటి రిపోజిటరీ విధాన విలువలను వర్తింపజేయవు. మీ వర్క్‌స్పేస్‌లోని ప్రతి ప్లగిన్ కోసం ఈ సెట్టింగ్‌లను కాన్ఫిగర్ చేయండి.


అర్హత ఉన్న ప్రతి పాత్రకు అందుబాటులో ఉంది లేదా ఇన్‌స్టాల్ చేయబడింది ఎంచుకోవడానికి ఇన్‌స్టాలేషన్ విధానం ఉపయోగించండి. అవసరమైన యాప్‌లను కూడా ప్రారంభించాలి. సభ్యులకు అనుసంధానిత సేవకు ప్రాప్యత ఉండాలి, అవసరమైన ప్రామాణీకరణను కూడా పూర్తి చేయాలి.


ప్లగిన్ నవీకరణను సమకాలీకరించినా, ఇప్పటికే ఉన్న ప్లగిన్‌ను GitHub నిర్వహణకు మార్చినా, దాని వర్క్‌స్పేస్ విధానాలు అలాగే ఉంటాయి. ప్లగిన్‌ను దిగుమతి చేయడం వల్ల యాప్ ప్రాప్యత మంజూరు కాదు, సభ్యుల ఖాతాలు అనుసంధానం కావు.


వర్క్‌స్పేస్‌లో విభాగాల మధ్య వెళ్లడం, యాప్ ప్రాప్యత, వర్క్‌స్పేస్ నియంత్రణల గురించి తెలుసుకోవడానికి, ప్లగిన్‌లు, యాప్‌ల కోసం నిర్వాహక నియంత్రణలు, భద్రత, నిబంధనల అనుసరణ చూడండి.

ప్లగిన్‌లను తాజాగా ఉంచండి

కొత్త మార్కెట్‌ప్లేస్‌లు ప్రతిరోజూ నవీకరణల కోసం తనిఖీ చేస్తాయి. స్వయంచాలక సమకాలీకరణ కోసం వేచి ఉండకుండా నవీకరణను అభ్యర్థించడానికి:

1. నిర్వాహక కన్సోల్‌కు వెళ్లి, కావాల్సిన ChatGPT వర్క్‌స్పేస్‌ను ఎంచుకుని, ప్లగిన్‌లు తెరవండి.

2. మార్కెట్‌ప్లేస్‌లు తెరిచి, మార్కెట్‌ప్లేస్‌ను ఎంచుకోండి.

3. ఇప్పుడే సమకాలీకరించు ఎంచుకోండి.

సమకాలీకరణ కొత్త మార్కెట్‌ప్లేస్ నమోదులను జోడించగలదు, ఇప్పటికే ఉన్న ప్లగిన్‌లను నవీకరించగలదు. రిపోజిటరీ మార్పులను విలీనం చేసే ముందు సమీక్షించండి. ఎందుకంటే స్వయంచాలక సమకాలీకరణ మరో దిగుమతి దశ అవసరం లేకుండానే కొత్త ప్లగిన్‌లను దిగుమతి చేయగలదు.

సమకాలీకరణ ఫలితాలను సమీక్షించండి

సమకాలీకరణ తర్వాత, దాని స్థితిని, సేవ్ చేసిన నివేదికను సమీక్షించండి. పూర్తయింది — N లోపాలు అంటే సమకాలీకరణ పూర్తయిందని, కానీ కొన్ని ప్లగిన్‌లను ప్రాసెస్ చేయలేకపోయిందని అర్థం.


ఇప్పటికే ఉన్న ప్లగిన్‌కు వచ్చిన నవీకరణ చెల్లకపోతే, చివరిగా పనిచేసిన దాని సంచిక అలాగే ఉంచబడుతుంది. అయినా, చెల్లుబాటయ్యే ఇతర నవీకరణలు పూర్తికావచ్చు. నివేదికలో పేర్కొన్న సమస్యను GitHubలో పరిష్కరించండి. తర్వాత మళ్లీ ప్రయత్నించడానికి ఇప్పుడే సమకాలీకరించు ఎంచుకోండి.


విడిగా దిగుమతి చేసిన ప్లగిన్ కోసం మీ నిర్వాహక వీక్షణలో తాజాపరచు కనిపిస్తే, ఆ ప్లగిన్‌ను తాజాపరచడానికి దాన్ని ఉపయోగించండి. ప్లగిన్ జాబితాను తాజాపరచు కనిపిస్తున్న జాబితాను మాత్రమే మళ్లీ లోడ్ చేస్తుంది. ఇది GitHub నుంచి సమకాలీకరించదు.

తొలగింపు ప్రభావాలను అర్థం చేసుకోండి

రిపోజిటరీ నుంచి నమోదును తీసివేసినా, వర్క్‌స్పేస్‌లోకి దిగుమతి చేసిన దాని నకలు తొలగించబడదు. ఆ ప్లగిన్‌కు ఇక మూలంలో లేదు అనే గుర్తు జోడించబడుతుంది.


ChatGPTలో మార్కెట్‌ప్లేస్‌ను తొలగిస్తే, దాని నుంచి దిగుమతి చేసిన ప్లగిన్‌లన్నీ తొలగించబడతాయి. GitHubను మళ్లీ అనుసంధానించడానికి లేదా యాజమాన్యాన్ని మార్చడానికి మార్కెట్‌ప్లేస్‌ను తొలగించవద్దు.

GitHub ప్రాప్యతను మళ్లీ అనుసంధానించండి లేదా మార్చండి

మార్కెట్‌ప్లేస్ సమకాలీకరణ దాన్ని దిగుమతి చేసిన నిర్వాహకుని GitHub అనుసంధానాన్ని ఉపయోగిస్తుంది. ఆ ఖాతాకు మార్కెట్‌ప్లేస్ రిపోజిటరీతో పాటు అది సూచించే రిపోజిటరీలన్నింటికీ ప్రాప్యత కొనసాగాలి.

అసలు ఖాతాను మళ్లీ అనుసంధానించండి

1. దిగుమతి కోసం ఉపయోగించిన GitHub ఖాతాకు అవసరమైన అన్ని రిపోజిటరీల ప్రాప్యత ఇప్పటికీ ఉందని నిర్ధారించుకోండి.

2. మార్కెట్‌ప్లేస్‌ను మొదట దిగుమతి చేసిన నిర్వాహకుని, ChatGPTలో GitHub ప్లగిన్‌ను తెరిచి తమ ఖాతాను మళ్లీ అనుసంధానించమని అడగండి.

కొత్త నిర్వాహకునికి బదిలీ చేయండి

కొత్త వర్క్‌స్పేస్ నిర్వాహకుడు తన సొంత GitHub అనుసంధానాన్ని ఉపయోగించి అదే మార్కెట్‌ప్లేస్‌ను దిగుమతి చేసుకోవచ్చు:

1. నిర్వాహక కన్సోల్‌కు వెళ్లి, కావాల్సిన ChatGPT వర్క్‌స్పేస్‌ను ఎంచుకుని, ప్లగిన్‌లు తెరవండి. తర్వాత జోడించు > మార్కెట్‌ప్లేస్‌ను దిగుమతి చేయి ఎంచుకోండి.

2. ఇప్పటికే ఉన్న మార్కెట్‌ప్లేస్ కోసం ఉపయోగించిన అవే మూలం, పాత్, బ్రాంచ్, ట్యాగ్ లేదా కమిట్ విలువలను నమోదు చేయండి.

3. మార్కెట్‌ప్లేస్‌ను దిగుమతి చేయి ఎంచుకుని, అడిగినప్పుడు GitHub ప్రాప్యతకు అనుమతి ఇవ్వండి.

ఇకపై సమకాలీకరణలు కొత్త నిర్వాహకుని GitHub అనుసంధానాన్ని ఉపయోగిస్తాయి. కొత్త నిర్వాహకుని ఖాతాకు మార్కెట్‌ప్లేస్ రిపోజిటరీతో పాటు అది సూచించే ప్రతి రిపోజిటరీని చదివే అనుమతి ఉండాలి.

ఇప్పటికే ఉన్న ప్లగిన్‌ను GitHub నిర్వహణకు మార్చండి

ఆర్కైవ్‌గా అప్‌లోడ్ చేసిన లేదా ఇంకా GitHub మూలం ద్వారా నిర్వహించని వర్క్‌స్పేస్ ప్లగిన్‌ను నిర్వహించడానికి మీరు మార్కెట్‌ప్లేస్‌ను ఉపయోగించవచ్చు. ఇప్పటికే ఉన్న ప్లగిన్ అదే వర్క్‌స్పేస్‌లో ఉండాలి, దాని పేరు కూడా అదే ప్లగిన్ పేరుతో సరిపోలాలి. వేరే GitHub మూలం ద్వారా నిర్వహించే ప్లగిన్‌ను ఈ విధంగా మీ నిర్వహణలోకి తీసుకోలేరు.


మీ మార్కెట్‌ప్లేస్‌లో ఇప్పటికే ఉన్న ప్లగిన్‌ను గుర్తించడానికి:

1. నిర్వాహక కన్సోల్‌కు వెళ్లి, కావాల్సిన ChatGPT వర్క్‌స్పేస్‌ను ఎంచుకుని, ప్లగిన్‌లు తెరవండి. ప్లగిన్‌ను తెరవండి.

2. దాని యూఆర్ఎల్‌లో /admin/plugins/ తర్వాత ఉన్న ప్లగిన్ ఐడీని కాపీ చేయండి.

3. మార్కెట్‌ప్లేస్‌లోని plugins శ్రేణిలో సంబంధిత నమోదులో name, source పక్కన ఆ ఐడీని pluginIdగా చేర్చండి. దాన్ని ప్లగిన్‌కు చెందిన plugin.json ఫైల్‌లో చేర్చవద్దు.

ప్లగిన్ ఐడీ, భాగస్వామ్య సెట్టింగ్‌లు, వర్క్‌స్పేస్ విధానాలు అలాగే ఉంటాయి. ఇకపై నవీకరణలకు GitHub మూలంగా ఉంటుంది, కాబట్టి తర్వాత ఆర్కైవ్‌లను అప్‌లోడ్ చేసి దీన్ని భర్తీ చేయలేరు.


ఈ మార్పుకు ఉదాహరణ, అవసరాల కోసం, ప్లగిన్ నిర్వహణ చూడండి.

ఇప్పటికే ఉన్న యాప్‌ను సూచించండి

ప్లగిన్ మూల డైరెక్టరీలోని .app.json ద్వారా ఇప్పటికే ఉన్న యాప్‌ను ప్లగిన్ సూచించవచ్చు. ఫైల్ పేరు ప్రారంభంలో చుక్కను చేర్చండి. ప్లగిన్ ఐడీకి బదులుగా యాప్ ఐడీని ఉపయోగించండి. స్థానిక ప్లగిన్ కోసం, .codex-plugin/plugin.jsonలోని apps ఫీల్డ్‌ను ./.app.jsonగా సెట్ చేయండి.


ఈ సూచన యాప్‌ను సృష్టించదు లేదా అదనపు అనుమతులను మంజూరు చేయదు. యాప్‌కు ఇప్పటికే ఉన్న వర్క్‌స్పేస్ ప్రాప్యత, ప్రామాణీకరణ, చర్యల నియంత్రణలు, అనుసంధానిత సేవ అనుమతులు యథావిధిగా వర్తిస్తాయి.


JSON ఆకృతి కోసం, ప్లగిన్ నిర్వహణ చూడండి.

డెస్క్‌టాప్‌లో మాత్రమే అనే లేబుల్‌ను అర్థం చేసుకోండి

డెస్క్‌టాప్‌లో మాత్రమే అని గుర్తించిన ప్లగిన్ వెబ్‌లోని ChatGPTలో పనిచేయదు. దిగుమతి చేసిన ప్లగిన్‌లు MCP సర్వర్‌లను ప్రకటించినప్పుడు, ఉదాహరణకు mcp.json లేదా .mcp.jsonలో, వాటికి ఈ లేబుల్ రావచ్చు. సర్వర్ రిమోట్ HTTPS యూఆర్ఎల్‌ను ఉపయోగిస్తున్నా ఇది వర్తిస్తుంది.



.app.json సూచనను జోడించినంత మాత్రాన డెస్క్‌టాప్‌లో మాత్రమే లేబుల్ తొలగిపోదు. సూచించిన ఏ యాప్ అయినా సభ్యుని పాత్రకు అందుబాటులో ఉండాలి. దాని సాధారణ ప్రాప్యత, ప్రామాణీకరణ అవసరాలు యథావిధిగా వర్తిస్తాయి.