Leagan 1.0.0-alpha.1is déanaí
Caibidil 2.27
Cásanna tógála
Leabhar cócaireachta de thrí thógáil déag, ó scil aonair go seachadadh aerbhearnaithe. Tugann gach oideas an sprioc, na bloic thógála, na céimeanna agus na horduithe, an geata a chruthaíonn gur oibrigh sé, agus an méid a athraíonn de réir eagráin agus foirm sheachadta.
d'aistrigh AI an leathanach seo ón mbunleagan Béarla. Má tá aon rud doiléir, is é an leathanach Béarla an tagairt. Léigh an leathanach seo i mBéarla

Seo iad na hoidis a úsáidim nuair a deir duine éigin in Corrán Orbital, nó ag custaiméir, "ba mhaith linn go ndéanfadh Nexus X". Tá gach ceann acu gearr d'aon ghnó. Tá an réasúnaíocht atá taobh thiar de na céimeanna sna caibidlí roimh an gceann seo: caibidil 2.20, Scileanna, agus caibidil 2.21, The Plugin SDK, a phléann leis an bhfoireann forbartha bogearraí, ansin caibidil 2.23, Pacáistí fearainn, agus na trí chaibidil ina diaidh faoi thógáil. Anseo gheobhaidh tú an sprioc, na bloic thógála atá le húsáid, na céimeanna, na horduithe, an geata a léiríonn gur éirigh leis, agus na nótaí faoin eagrán agus faoin seachadadh.
Is é an geata an rud is tábhachtaí. Bíonn oideas críochnaithe nuair a bhíonn a gheata glas. Is rud é gach geata sa chaibidil seo is féidir leat a rith nó a ritheann an t-ardán duit, agus scoireann gach ceann acu le luach nach náid é nó diúltaíonn sé le cód nuair nach gcomhlíontar é.
| Cás | Príomhbhloc tógála | An geata a chruthaíonn é | Eagrán |
|---|---|---|---|
| Scil nua de chuid Skills Engine | Pacáiste SKILL.md |
skill:validate gan aon earráid |
Community agus Enterprise |
Scil léiriúcháin le host_callback |
Léiriúchán breiseáin skills[] |
create-nexus-plugin validate agus nexus-gates |
Community agus Enterprise |
| Pacáiste atá ann cheana a leathnú | pack.json le inherits |
Seiceáil polasaí lionsa ag an ngeata píolótach | Enterprise agus ceadúnas pacáiste |
| Pacáiste nua ón tús | Cosán órga na bpacáistí fearainn | Geataí stáitsithe agus píolótacha | Enterprise |
| Nascóir sonraí | Scil plugin_queue |
validate, nexus-gates, diúltú do thrácht amach |
Community agus Enterprise |
| Uirlis MCP (Model Context Protocol) | mcpTools[] an léiriúcháin |
validate (gan aon chomhcheanglóirí ag an mbarrleibhéal) |
Community agus Enterprise |
| Siopa ar líne lipéid bháin | domains agus branding an léiriúcháin |
Riail phoiblí scope-adherence |
Enterprise agus an breiseán Storefront |
| Pacáiste misin Edge | Pacáiste misin | Cásanna tástála ar bord, dhá cheann de thrí shíniú | Enterprise agus an breiseán Nexus Edge |
| Seachadadh le bearna aeir | Beart séalaithe | nexus-airgap verify |
Enterprise |
| Modúl do Enterprise amháin | @adverant/nexus-spi |
Geata na líne ceadúnais, tógálacha eagráin | Enterprise |
| An croí oscailte a fhorcáil nó a leathnú | Foinse Community | Tástálacha, lint agus seiceáil cineálacha | Community |
| Aip néil an eagráin Team | Braisle foilsitheora | Eisiúint shínithe, athbhreithniú, deonú don chustaiméir | Team |
| Aip inmheánach atá ann cheana a fhilleadh | /plugin-create |
migrate, validate, nexus-gates |
Community agus Enterprise |
1. Scil nua Skills Engine
Is é an sprioc píosa treorach in-athúsáidte is féidir leis an gcúntóir, le gníomhairí, le sreafaí oibre agus le huirlisí forbróra go léir a rith, mar shampla comhdú custaim a sheiceáil i gcoinne a rialacha. Is iad do bhloic thógála pacáiste SKILL.md i bhfillteán atá ainmnithe as an scil, skill.yaml roghnach le haghaidh truicear agus clibeanna, agus fillteán roghnach scripts/ atá cuachta leis.
- Cruthaigh
skills/<slug>/agus scríobhSKILL.mdle réamhábhar:name(kebab-case, cothrom le hainm an fhillteáin),description(suas le 500 carachtar),allowed-tools, agus go roghnachtriggers,capabilitiesagusversion. - Scríobh an corp don mhúnla: cathain is ceart an scil a úsáid, a céimeanna, samplaí, agus an rud nach mór di gan é a dhéanamh choíche.
- Cuir cásanna tástála leis. Cuir ceann isteach ina bhfuil treoir curtha san ionchur nach mór don scil gan í a leanúint.
- Bailíochtaigh, féach ar an bplean uaslódála, ansin uaslódáil.
- Foilsigh. Coinnítear scil a chuireann uirlis scríbhneoireachta leis go dtí go gceadaíonn beirt ainmnithe í le heochracha pasála, agus ní féidir leis an moltóir a athrú féin a cheadú.
npm run skill:validate skills/check-a-customs-filing
npm run skill:upload skills/check-a-customs-filing --dry-run
npm run skill:upload skills/check-a-customs-filingIs é skill:validate an geata, agus ní mór dó nialas earráidí a thuairisciú sular féidir aon rud a fhoilsiú. Is iad na hearráidí blocála ainm nó cur síos ar iarraidh agus slug nó cineál poist dúblach. Má uaslódáiltear ábhar atá foilsithe cheana, filltear an leagan atá ann (CONTENT_HASH_ALREADY_PUBLISHED), mar sin is sábháilte an uaslódáil a athdhéanamh.
Faigheann Community an cruthaitheoir iomlán, an leabharlann, leaganacha, aistriú siar, iompórtáil agus tástálacha. Ar Enterprise, téann an foilsiú trí scáth agus canárach freisin: ritheann an leagan ceadaithe i scáth, ansin d'aonad amháin taobh thiar de gheataí ainmnithe, ansin do chách, agus stopann sé é féin mura gcomhlíontar geata. Do chustaiméir le bearna aeir, taistealaíonn scileanna réamhshínithe taobh istigh den bheart séalaithe (cás 9).
2. Scil forógra le host_callback
Is é an sprioc ríomh cinntitheach i do bhreiseán féin is féidir leis an ardán a sheoladh, mar shampla taifead eachtra a oscailt ó léamh. Úsáidfidh tú ró in skills[] an léiriúcháin leis an tsraith host_callback, agus bealach /internal i do chúlchóras atá cosanta ag garda seirbhíse an SDK.
- Fógair an scil:
idi lower_snake,tier: "host_callback",classificationag uasteorainn iontaoibhe do bhreiseáin nó faoina bun,inputSchema,outputSchemaagustimeoutMsidir 1 soicind agus 6 uair an chloig. - Líon
hostCallback: ainm do Service féin, a phort, cosán coibhneasta mar/internal/skills/excursion_open, an dá uasteorainn beart (maxRequestBytesagusmaxResponseBytes), agustenantHeader: "X-Organization-ID". - Fógair an bealach in
api.endpoints[]leauth: "service-key"nóauth: "internal", agus cosain é lerequireServicenóserviceMiddleware, agus ná húsáid garda raon an úsáideora choíche. - Bailíochtaigh, rith na geataí, agus lig don ionduchtú na scileanna a shioncronú leis an gclárlann trí
compileRegistry. Ní scríobhann tú SQL na clárlainne de láimh choíche.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testCuireann validate rialacha shioncronú na clárlainne féin i bhfeidhm sula ndéantar aon rud a shioncronú, agus diúltaítear do gach ceann le cód an ghlacadóra. Diúltaítear do chosán ina bhfuil scéim, // nó cúlslais mar thrasbhunús. Is é ENDPOINT_BYTE_CAP_REQUIRED uasteorainn beart ar iarraidh, is é FIELD_NOT_FOR_TIER réimse ó shraith eile, agus is é TIMEOUT_OUT_OF_BOUNDS teorainn ama lasmuigh den raon. Ansin seiceálann nexus-gates go bhfuil an garda seirbhíse ar an mbealach /internal agus go bhfuil sé fógartha internal nó service-key. Is é an péire geataí sin an cruthúnas.
Is sioncronú dearbhaithe é. Postáil an tacar iomlán scileanna gach uair, mar díchumasaítear scil a fhágann tú amach, agus cuir do chéim imscartha ar ceal ar aon stádas seachas 200. Ar Enterprise, seiceáiltear sioncronú breiseáin ina iomláine: má sháraíonn scil amháin riail, ní ghlactar le haon chuid den sioncronú sin (PLUGIN_SYNC_ALL_OR_NOTHING) agus leanann an leagan roimhe ar aghaidh ag rith. Ní féidir le breiseán le hiontaoibh pobail na sraitheanna a shroicheann múnla a úsáid, tool_using agus llm_only; teastaíonn iontaoibh core nó verified uathu sin.
3. Pacáiste atá ann cheana a leathnú
Is é an sprioc tionscal nó fothionscal nua a athúsáideann an chuid is mó de phacáiste atá ann cheana, mar shampla iasachtú agus díospóidí cártaí bunaithe ar chruth an phacáiste Árachais. Is é an bloc tógála pack.json a ainmníonn a thuismitheoir in inherits agus nach gcuireann leis ach a bhraislí lionsa agus a fhocail féin.
- Tosaigh an pacáiste le cosán órga na bpacáistí fearainn, ansin socraigh
inheritsar aitheantas an phacáiste thuismitheora. - Cuir do bhraislí
lensféin leis, gach ceann lena shuíocháin, a chuspóir agus a thagairt foclóra. - Cuir d'fhocail leis an bhfoclóir le gluais shimplí do gach ceann. Marcáil téarma
exactnuair nach mór é a thaispeáint mar atá sé scríofa. - Athúsáid lionsaí comhroinnte seachas do chuid féin a tharraingt: is lionsa comhroinnte amháin é córas rialála a theastaíonn ó roinnt pacáistí, mar shampla clár de theicneolaíocht sheachfhoinsithe.
- Seiceáil an slabhra ceadúnais. Faigheann do phacáiste riachtanais bhreiseáin a thuismitheora le hoidhreacht.
- Réamhamharc ar gach lionsa mar dhuine ar bhrainse sintéiseach.
{ "id": "fintech", "name": "Banking and payments", "version": "0.1", "inherits": "insurance" }Is é an cruthúnas seiceáil pholasaí an gheata phíolótaigh, a dhearbhaíonn nach ndéanann gach lionsa ach a bhonn a chúngú agus go gcoinníonn sé réimsí pearsanta as de réir réamhshocraithe. Diúltaítear le LENS_CANNOT_WIDEN do lionsa a dhéanann iarracht an rud a cheileann a bhonn a thaispeáint. Ó thaobh an cheadúnaithe de, diúltaíonn an consól ceadúnas a eisiúint do do phacáiste gan na breiseáin a theastaíonn óna thuismitheoir; teastaíonn Seomraí cinnidh agus taifid shéalaithe ón bpacáiste Árachais.
Is de chuid Enterprise iad pacáistí fearainn agus ceadúnaítear iad in aghaidh an phacáiste. Teastaíonn an breiseán Aipeanna móibíleacha freisin ó scáileáin ghutháin pacáiste. Ní féidir le pacáiste linbh an bhlaosc, na comhpháirteanna ná na rialacha scríbhneoireachta a athrú.
4. Pacáiste nua ón tús
Is é an sprioc amharc tionscail amháin ar Nexus: a mhúnla eolais, na lionsaí do gach ról, an fhianaise a iarrann a rialacha, agus an breiseán a choinníonn a shonraí cothrom le dáta. Téann Caibidil 2.24, Ingearach saincheaptha a thógáil ó cheann ceann, tríd an tógáil seo go hiomlán; seo an leagan gearr.
- Rith cosán órga na bpacáistí fearainn agus déan cur síos ar an bpacáiste: cuspóir, aonaid, an bunmhúnla agus na rialacha a mhapálann sé.
- Tóg an múnla eolais ar bhunmhúnla agus aicmigh gach airí agus tú á chur leis.
- Léigh an plean, deimhnigh a mhéarlorg le d'eochair phasála, agus cruthaigh.
- Múnlaigh na lionsaí sa Tógálaí lionsaí, gach ceann ag cúngú bunlionsa.
- Scríobh an breiseán agus aon scileanna Skills Engine a theastaíonn ón bpacáiste.
- Gin sonraí sintéiseacha síolaithe leis na cásanna corra is cás leat, agus réamhamharc ar gach lionsa mar dhuine.
- Ardaigh ón spás forbartha go stáitsiú, go haonad píolótach, ansin go gach aonad.
Is é an cruthúnas na geataí ardaithe: gach tástáil ag éirí leo ar na brainsí sintéiseacha isteach sa stáitsiú, ansin beirt athbhreithneoirí nach iad an t-údar, ansin 14 lá sa phíolóta le hearráidí faoi 1 as 1,000. Ní féidir aon chéim a scipeáil (GATE_CANNOT_BE_SKIPPED). Is de chuid Enterprise iad pacáistí. Ar Community ní thairgtear cosán órga na bpacáistí fearainn.
5. Nascóir sonraí
Is é an sprioc sonraí ó chóras seachtrach a bheith ag sreabhadh isteach i dtáblaí do bhreiseáin féin de réir sceidil, mar shampla imeachtaí geata ó chóras oibriúcháin teirminéil. Is iad na bloic thógála scil plugin_queue, oibrí a tharraingíonn do scuaine, imirce don sprioctábla, agus seoladh amach atá fógartha sa léiriúchán.
- Fógair scil
plugin_queuelequeueNamelitrithe<plugin name>.<name>. Ní cheadaítear idirstad, agus caithfidh an t-ainm a bheith sa léiriúchán, mar cuireann an t-ceolfhoirneoir isteach sa scuaine sin go díreach. - Scríobh an t-oibrí a tharraingíonn an scuaine agus a ghlaonn ar an gcóras seachtrach.
- Fógair seoladh an chórais sheachtraigh mar sheoladh amach. Cuirtear bac ar aon rud nach bhfuil liostaithe.
- Stóráil a dtagann isteach i do scéimre féin, le
organization_id,owner_user_idagusbusiness_unit_idar gach ró. - Léigh dintiúr an chórais sheachtraigh de réir ainm ón timpeallacht, agus liostaigh an athróg in
scripts/ci/required-env. - Seol na tarraingtí trí UNO, an t-inneall sreafa oibre, agus ná húsáid amadóir a ghlaonn ar innill go díreach choíche.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only no-credentials --only no-direct-compute --only migrations-are-scoped
node scripts/ci/required-envSeiceálann validate ainm na scuaine agus an teorainn ama i gcoinne rialacha shioncronú na clárlainne. Cruthaíonn na trí gheata nach bhfuil aon dintiúr múnla ann, nach bhfuil aon ríomh díreach ann agus go bhfuil an tábla raonaithe i gceart. Rith nexus-gates iomlán sula ndéanann tú brú, mar cúngaíonn --only an rith agus deir sé amhlaidh ina achoimre. Ag am rite, stoptar glao ar sheoladh nár fhógair an léiriúchán ag an imeall le EGRESS_NOT_DECLARED.
Tagann nascóirí an ardáin féin le tiomántáin, vicithe, stórais phoist agus córais oidhreachta, le gabháil athruithe agus le líneáiste, leis an mbreiseán Nascóirí sonraí. Is breiseán é nascóir a thógann tú féin agus oibríonn sé ar aon eagrán. Is leathnú é seoladh amach a chur leis in eisiúint níos déanaí, agus coinnítear é go dtí go nglacann beirt athbhreithneoirí leis.
6. Uirlis MCP
Is é an sprioc uirlis ar féidir le Claude Code, le gníomhairí agus le cliaint eile MCP (Model Context Protocol) glaoch uirthi, mar shampla stair iniúchta árthaigh a chuardach. Is é an bloc tógála iontráil in mcpTools[] an léiriúcháin, le name, description agus inputSchema.
- Ainmnigh an uirlis agus déan cur síos simplí uirthi. Is é an cur síos an rud a léann múnla chun cinneadh a dhéanamh an nglaofaidh sé uirthi.
- Scríobh
inputSchemamar scéimre réada amháin. Ná cuironeOf,allOfnáanyOfag a bharrleibhéal. - Coinnigh an bealach a fhreastalaíonn ar an uirlis taobh thiar den gharda raoin, cosúil le gach bealach
/apieile, ionas go dtagann an tionóntacht ó chomhartha an ghlaoiteora. - Bailíochtaigh an léiriúchán.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.jsonIs é validate an cruthúnas: diúltaítear do chomhcheanglóir barrleibhéil ag am an údaraithe, mar ag am rite chuirfeadh sé an uirlis ar ceal do gach fo-ghníomhaire MCP a iompórtálann í, agus bheadh an uirlis ann gan aon duine in ann glaoch uirthi.
Ar Enterprise, liostaítear gach uirlis ar féidir le IDE (timpeallacht forbartha comhtháite) glaoch uirthi i gcatalóg uirlisí Workbench lena sraith, cé acu an athraíonn sí rudaí nó nach n-athraíonn, méarlorg greamaithe agus na róil a fhéadfaidh í a úsáid. Má athraíonn cur síos d'uirlise in eisiúint nua, coinníonn an chatalóg an uirlis go dtí go ndéanann duine athbhreithniú ar an athrú. Is d'aon ghnó é sin: is trí chur síos athraithe is féidir le huirlis tosú ag iarraidh ar mhúnla rud nár cheart di. Diúltaítear le CONNECTION_SCOPE_EXCEEDED do ghlao ar aon rud lasmuigh de phas an ghlaoiteora.
7. Aghaidh siopa lipéad bán
Is é an sprioc aip a úsáideann custaiméirí do chustaiméara féin, ar fhearann an chustaiméara agus ina bhranda, gan rian ar bith de Adverant. Is iad na bloic thógála bloic domains agus branding an léiriúcháin, cúntóirí síniú isteach an SDK, agus breiseán Storefront / lipéad bán an chustaiméara.
- Cuir fearann an chustaiméara in
domains[]marprimary, le haonaliases. - Líon
branding:appName,tagline,primaryColor,accentColor,passkeyRpIdcothrom leis an bhfearann, agusoauthClientRef. - Sínigh daoine isteach trí chúntóirí síniú isteach an SDK, agus fógair a dhá bhealach phoiblí go beacht, le
auth: "public"agusallowAnonymous: true. - Seol gach glao tosaigh tríd an seachfhreastalaí liosta ceadaithe cúlchórais don tosach. Ná cuir seoladh seirbhíse sa chliant choíche.
- Fág íocaíochtaí faoi riarthóir an chustaiméara, a nascann geataí íocaíochta agus a shocraíonn an tseiceáil amach brandáilte.
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --only scope-adherence --only api-contractIs é scope-adherence an cruthúnas. Ní ligeann sé isteach bealach /api gan gharda ach amháin nuair a fhógraíonn an léiriúchán an modh agus an cosán beacht sin mar phoiblí agus gur ceann de na bealaí síniú isteach é an cosán; teipeann ar aon fhógra poiblí eile agus ainmníonn sé an dá chosán cheadaithe. Ansin déanann api-contract difríocht idir na bealaí fógartha agus na bealaí fíora sa dá threo. Diúltaíonn definePlugin freisin do frontend.basePath nach cosán coibhneasta den bhunús céanna é.
Is é an breiseán Storefront / lipéad bán ar Enterprise atá i gceist le lipéad bán, agus ceadúnaíonn sé íocaíochtaí freisin. Ní théann sonraí cárta i dteagmháil le Nexus riamh. Is le riarthóir an chustaiméara an branda, agus aimsíonn an t-ardán é ón eagraíocht seachas ó do chód.
8. Pacáiste misin Edge
Is é an sprioc misean nua nó nuashonraithe do shatailít nó do dhrón a ritheann Nexus Edge, mar shampla cuibheoir aimsithe long a chur le misean faire muirí. Is é an bloc tógála pacáiste misin, a thógtar agus a shínítear ar an talamh.
- Tosaigh ón bpacáiste reatha ar an leathanach Pacáiste misin a thógáil, a dhréachtaíonn an leagan nua ón seanleagan agus a mharcálann gach athrú.
- Ná hathraigh ach a bhfuil de dhíth ar an misean. Coinnigh na codanna móra, an tsamhail teanga agus an t-ointeolaíocht, seasmhach nuair is féidir.
- Seiceáil an tábla socrúcháin ag gach céim laghdaithe, ionas go n-oireann gach clár fós don rud a ritheann sé.
- Rith cásanna tástála ar bord an phacáiste ar rig tástála leis na cláir chéanna.
- Seol é le síniú: tá dhá shíniú as trí ag teastáil.
- Eisigh é chuig ardán amháin. Téann sé isteach sa sliotán díomhaoin agus ní chuirtear ar siúl é ach amháin tar éis dá chásanna tástála pas a fháil ar bord.
- Leathnaigh amach chuig an gcéad ardán eile tar éis seachtain gan fadhb.
Níl aon orduithe san oideas seo; déantar é i leathanaigh Nexus Edge an chonsóil. Is é an cruthúnas na cásanna tástála ar bord, a chaithfidh pas a fháil uile sula gcuirtear an pacáiste ar siúl, agus an dá shíniú. Má theipeann ar thástáil ar bord, fanann an t-ardán ar a phacáiste roimhe sin agus íoslódáiltear an teip ar an gcéad phas eile. Diúltaítear le PACK_NOT_CHECKED_FOR_HARDWARE pacáiste a shuiteáil ar chrua-earraí nár seiceáladh dó é.
Is breiseán é Nexus Edge, a cheadúnaítear in aghaidh an ardáin nó in aghaidh an chabhlaigh. Fanann pacáistí bailí fad atá ardán as teagmháil. Tá an nasc suas cúng, mar sin pleanáil méideanna dá réir: bhí ár n-eisiúint 1.5 412 MB, i gcomparáid le 9.8 GB do phacáiste le samhail teanga nua.
9. Seachadadh aerbhearnaithe chuig custaiméir
Is é an sprioc do bhreiseán nó do phacáiste a bheith suiteáilte ag láthair custaiméara gan aon líonra. Is iad na bloic tógála cuachta séalaithe ó @adverant/nexus-sovereign, d'eochair sínithe eisiúna, agus bealaí eisiúna an chustaiméara féin.
- Tóg an breiseán agus a íomhánna díreach mar a dhéanfá do chustaiméir ceangailte, agus gach geata glas.
- Déan cuachta séalaithe leis an bpróifíl
airgap, ina bhfuil na híomhánna, na himirceanna, na scileanna réamhshínithe agus SBOM (bille ábhar bogearraí) leis na ceadúnais. - Sínigh é le d'eochair eisiúna Ed25519.
- Fíoraigh é tú féin ar mheaisín glan.
- Seol an cuachta ar mheáin, agus seol d'eochair phoiblí agus SHA-256 an chuachta ar bhealach ar leith.
- Fíoraíonn oibreoir an chustaiméara an cuachta le d'eochair, agus ansin tugann sé an eisiúint isteach trína bhealaí eisiúna féin.
nexus-airgap bundle
nexus-airgap verify --bundle cold-chain-0.4.0.tar.gz --trusted-key corran-release.pub.pem --profile airgapTógann nexus-airgap bundle an cuachta ó chumraíocht do chuachta. Is é an cruthúnas nexus-airgap verify ar thaobh an chustaiméara. Déanann sé gach comhad a haiseáil arís, diúltaíonn sé d'aon chomhad nach liostaíonn an léiriú, éilíonn sé sínitheoir iontaofa, agus diúltaíonn sé do chuachta nach bhfuil a liosta ceadaithe líonra folamh. Teipeann ar chomhad athraithe le BUNDLE_INTEGRITY_VIOLATION. Níor cheart d'aon duine an seiceáil dhian a mhúchadh riamh chun dul thairis.
Is le Enterprise suiteálacha scoite ón líonra. Ní cheadaítear d'aon rud sa chuachta aon rud a fháil le linn suiteála, agus tagann samhail a theastaíonn ón mbreiseán ó fhreastalaí samhlacha an chustaiméara féin tríd an AI (intleacht shaorga) Provider Router.
10. Modúl Enterprise amháin
Is é an sprioc cumas dúnta ceadúnaithe a cheanglaíonn leis an gcroí oscailte, mar shampla rian iniúchta le coinneáil fhada nach ndíoltar ach le custaiméirí Enterprise. Is é an bloc tógála an pacáiste comhéadain @adverant/nexus-spi, agus gan aon rud eile ó Community.
- Coinnigh cóip den phacáiste comhéadain tógtha, greamaithe ag leibhéal beart, i do stór mar phacáiste áitiúil
file:, lena ghreamúSHA256SUMS. - Scríobh
RouteModule(nóScreenModuledo scáileáin chonsóil) ina choinne, leis an ngrúpa gné a bhfreastalaíonn sé air. - Rith gach bealach taobh thiar de
ctx.requireScope, agus seiceáil deontas an mhodúil féin sula bhfreagraíonn tú. - Diúltaigh le
LICENCE_LOCKEDnuair nach bhfuil teideal ag an eagraíocht, agus taispeáin réamhbhlaiseadh na gné, ní a cuid sonraí riamh. - Coinnigh an stór taobh istigh den líne ceadúnais, agus ansin tóg crann comhdhéanta gach eagráin.
npm ci
npm test
npm run buildIs é an cruthúnas riail na líne ceadúnais: gan aon iompórtáil ó raon Community ach amháin an pacáiste comhéadain, gan aon iompórtáil choibhneasta amach as an stór, agus gan aon spleáchas file:, link: ná workspace: lasmuigh de. Ansin caithfidh na trí ordú thuas pas a fháil i ngach crann eagráin comhdhéanta, ní i do chrann oibre amháin. Tá creatlach an mhodúil in Caibidil 2.25, Tógáil do gach eagrán.
Lódálann modúl isteach i seirbhís Community ag an tús, ar shuiteálacha a bhfuil a ghrúpa gné ar a gceadúnas. Gan an deontas sin diúltaíonn sé, mar sin seoltar an tógáil chéanna i ngach áit agus ní dhéanann sé faic san áit nach bhfuil sé ceadúnaithe.
11. An croí oscailte a fhorcáil nó a leathnú
Is é an sprioc athrú ar Community féin, a choinnítear i do ghabhlóg nó a chuirtear ar ais. Is é an bloc tógála foinse Community faoin Apache License, Version 2.0.
- Gabhlaigh an stór agus déan brainse ó
main. - Is fearr breiseán nó scil más féidir leis an rud atá uait a bheith ina cheann díobh. Is ortsa a bheidh athrú ar an gcroí a chothabháil ar gach eisiúint.
- Déan an t-athrú le tástálacha a theipeann gan é.
- Rith na seiceálacha a ritheann an tionscadal sula moltar aon rud.
- Coinnigh an comhad NOTICE, agus ná húsáid ainmneacha ná trádmharcanna Adverant thar a rá cárb as a dtáinig an obair.
git checkout -b feature/your-change
npm test
npm run lint
npm run typecheckIs é an cruthúnas na trí sheiceáil sin a bheith ag éirí, móide an fhianaise gur theip ar gach tástáil nua roimh d'athrú. Coinnigh airí amháin den chroí oscailte fíor i do ghabhlóg: ritheann Community gníomhaire ó cheann ceann ar shamhail áitiúil gan eochair agus gan líonra. Briseann athrú a bhriseann é sin an rud a fhágann Community inúsáidte ann féin.
Is le Community amháin é seo. Baineann aon rud nach mór a choinneáil dúnta le modúl Enterprise (cás 10) ina ionad, ionas go bhfanfaidh an líne ceadúnais in áit ar féidir le duine ar bith í a aithint.
12. Aip néil d'eagrán Team
Is é an sprioc aip ar féidir le custaiméirí Team a shuiteáil. Ní ritheann Team ach ar néal Adverant, mar sin ní shroicheann an aip iad ach tríd an gcatalóg. Is iad na bloic tógála breiseán agus braisle foilsitheora: do bhraisle fhíorúil féin ar néal Adverant le sonraí samplacha.
- Tóg agus tástáil ar an mbraisle foilsitheora, le sonraí samplacha amháin.
- Fógair gach rud a theastaíonn ón aip ina léiriú, agus faic níos mó.
- Eisigh é sínithe, le haghaidh athbhreithniú Adverant agus liostú sa chatalóg.
- Suiteálann gach custaiméir é, ag deonú gach raon fógartha aonad ar aonad.
Tagann an cruthúnas in dhá chuid. Cuireann an eisiúint shínithe athbhreithnithe isteach sa chatalóg thú. Ansin cinneann deontas an chustaiméara cad is féidir leis an aip a shroicheadh ag a láthair, agus diúltaítear le CONNECTION_SCOPE_EXCEEDED d'aon ghlao nár fhógair sí. Ní féidir leat raon atá in easnamh a chur leis ach in eisiúint nua a ndéanann an custaiméir athbhreithniú uirthi.
Níl aon bhealach ag braisle foilsitheora chuig aon chustaiméir, agus diúltaítear le TENANT_BOUNDARY d'iarratas ar shonraí custaiméara ansin. Is féidir le custaiméirí torthaí tástála a roinnt leat, ach ní a gcuid sonraí riamh. Áirítear le Team an cumas oibríochtaí sreabha oibre, mar sin má sheolann d'aip sreabha oibre, is féidir le custaiméirí Team iad a chur chun cinn idir timpeallachtaí iad féin.
13. Aip inmheánach atá ann cheana a chuimsiú mar bhreiseán
Is é an sprioc aip a ritheann do chuideachta cheana féin, tugtha isteach in Nexus ionas go bhfaigheann sí síniú isteach, leithlisiú agus rialachas mar oidhreacht. Is iad na bloic tógála an scil /plugin-create don chéad dréacht, agus uirlisí léirithe agus geataí an SDK chun é a chríochnú.
- Rith
/plugin-createleis an stór. Déanann sé anailís ar an gcód agus roghnaíonn sé straitéis fhillte, agus ansin gineann sé an t-inneall cúil, na himirceanna, an comhéadan úsáideora (UI), an léiriú agus na tástálacha. - Ardaigh an léiriú go conradh v2. Cuireann
migratena trí abairt dlí leis agus bogann sédomaingodomains[], agus diúltaíonn sé pointe iontrála a chumadh. - Cuir garda raoin an SDK in ionad aon luach tionónta a léann an fillteán ó cheanntásca.
- Cuir
organization_id,owner_user_idagusbusiness_unit_idle gach tábla, le príomheochracha a thosaíonn leis an tionónta. - Fógair gach bealach lena cheart, agus suiteáil mórleabhar na ndiúltuithe.
- Rith na geataí go mbeidh siad glas.
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin migrate nexus.manifest.json --write
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testIs é an cruthúnas nexus-gates ag scor le 0, agus scope-adherence, one-fence, migrations-are-scoped, crud-adherence agus api-contract uile ag éirí. Bí ag súil go dteipfidh ar an gcéad rith ar fhormhór díobh; thuairiscigh ár gceann féin gach bealach mar bhealach gan raon, toisc go raibh muinín ag an dréacht as ceanntásca a d'fhéadfadh an brabhsálaí a shocrú. Níl aon lasc deisiúcháin ag na geataí, d'aon ghnó.
Oibríonn aipeanna fillte ar aon eagrán. Ní dhéantar imscaradh ach trí bhealaí eisiúna na suiteála, mar sin déan neamhaird d'aon chomhaid imscartha a scríobh an dréacht. Is ar an obair leithlisithe a chaitear an t-am: pleanáil ar laethanta d'aip fhíor, ní uaireanta.


