Tagairt an bhlúire: cumraigh agus saincheap

Is é aidisclose.js an script ar an suíomh a léann do mhaiféist ai-disclosure.json agus a rindreálann na nochtaí a éilíonn an dlí: meirge idirghníomhaíochta do róbait chomhrá, fógra ábhair leanúnach, lipéid infheicthe ar mheáin mharcáilte, agus meiteashonraí leathanaigh inléite ag meaisín. Tá sé saor ó spleáchais, thart ar 8.2 KB nuair a bhíonn sé comhbhrúite le gzip, agus comhlíonann sé WCAG 2.1 AA.

Is é an leathanach seo an tagairt iomlán do chumraíocht agus saincheapadh. Chun na céimeanna suiteála ardán ar ardán (WordPress, Shopify, Webflow, bainisteoirí clibeanna), féach an treoir suiteála. Is féidir leat an doiciméad seo a léamh freisin mar markdown amh.

Forbhreathnú

Tiomáineann clib scripte amháin gach rud. Ar luchtú, faigheann an blúire do mhaiféist, ansin rindreálann sé an méid a dhearbhaíonn an mhaiféist amháin:

Meirge idirghníomhaíochta, do chóras conversational: fógra go bhfuil an cuairteoir ag caint le IS.
Fógra ábhair, do chóras content-generation le scope: site nó scope: page: sceallóg bheag leanúnach. Nuair a chliceáiltear é, osclaítear míniú gairid le téacs an fhógra, ainm d'fhoilsitheora agus cuspóir an chórais ón maiféist, agus nasc leis an gcomhad maiféiste; nascann téacs an fhógra le míniú i ngnáththeanga ar aidisclose.io. Osclaíonn an suaitheantas "déanta ag daoine" an cárta céanna leis an ainm foilsitheora.
Lipéid in aghaidh an eiliminte, ar aon eilimint a mharcálann tú le data-ai-content: suaitheantas "IS" infheicthe, chomh maith le data-digital-source-type inléite ag meaisín.
Meiteashonraí leathanaigh: <link rel="ai-disclosure"> agus <meta name="ai-disclosure"> a dhíríonn ar do mhaiféist.
Suaitheantas "déanta ag daoine", nuair a shocraíonn an mhaiféist noAiDeclared.

Tá gach rud thíos roghnach. Gan aon chumraíocht, léann an blúire do /.well-known/ai-disclosure.json, rindreálann sé i dteanga an chuairteora ar fud 28 logán, leanann sé rogha sholas nó dorcha an chórais oibriúcháin, agus cruachann sé os cionn barraí toilithe fianán aitheanta ionas nach bhforluíonn an dá cheann riamh.

Suiteáil

Cuir an chlib leis uair amháin, i dteimpléad comhroinnte do shuímh, i gceanntásc an téama, nó sa bhainisteoir clibeanna, agus seolfar le gach leathanach í. Is féidir léi suí sa <head> nó áit ar bith roimh </body>; cuirtear ar athló í, mar sin ní athraíonn a suíomh an t-iompar:

<script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>

Gan aon tréithe, léann an blúire an mhaiféist ag https://YOURDOMAIN/.well-known/ai-disclosure.json. Mura féidir le d'ardán comhad a fhreastal ag fréamh an fhearainn, óstáil an mhaiféist le AIDisclose agus dírigh an chlib uirthi de réir eochrach:

<script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>

Mura féidir teacht ar an maiféist, logálann an blúire rabhadh consóil agus ní rindreálann sé aon fhógraí atá bunaithe ar an maiféist, ionas nach dtaispeánann teip ar aisghabháil fógra buille faoi thuairim riamh. Rindreálann meiteashonraí leathanaigh, do lipéid [data-ai-content], agus meirge a chuirtear i bhfeidhm le data-banner="true" fós.

Cumraíocht

Tá trí bhealach ann chun an blúire a chumrú. Úsáid cibé ceann a oireann do d'ardán.

1. Tréithe ar an gclib scripte. An bealach is simplí, gan aon chód breise:

<script src="https://cdn.aidisclose.io/v1/aidisclose.js"
        data-theme="light" data-lang="fr" defer></script>

2. Réad cumraíochta domhanda. Sainigh window.AIDiscloseConfig sula ritheann an script. Nochtann sé an tacar iomlán roghanna, lena n-áirítear na roghanna roghnóra nach bhfuil aon fhoirm tréithe acu:

<script>
  window.AIDiscloseConfig = {
    theme: 'light',
    mountSelector: '#ai-disclosure-slot',
    triggerSelector: '#chat-launcher',
  };
</script>
<script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>

3. Túsú de láimh. Cuir data-manual leis chun tús uathoibríoch a chur ar athló, ansin glaoigh ar AIDisclose.init() tú féin nuair a bheidh d'fheidhmchlár réidh (áisiúil i bhfeidhmchláir aonleathanaigh):

<script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-manual defer></script>
<script>
  AIDisclose.init({ theme: 'dark', persistentChip: false });
</script>

Má tá níos mó ná foinse amháin i láthair, buann window.AIDiscloseConfig: sáraíonn sé araon tréithe na clibe scripte agus aon réad a chuirtear ar aghaidh chuig AIDisclose.init().

Tagairt roghanna

Tá dromchla na roghanna cobhsaí don líne 1.x.

Rogha	Tréith	Luachanna	Réamhshocrú	Éifeacht
`theme`	`data-theme`	`light`, `dark`, `auto`	`auto`	Scéim dathanna. Leanann `auto` rogha córais oibriúcháin an chuairteora.
`siteKey`	`data-aidisclose`	teaghrán	gan aon cheann	Luchtaigh an mhaiféist arna hóstáil ag AIDisclose don eochair seo in ionad an chomhaid well-known.
`manifestUrl`	`data-manifest-url`	URL	`/.well-known/ai-disclosure.json`	Léigh an mhaiféist ó URL saincheaptha.
`lang`	`data-lang`	cód BCP-47	`<html lang>` an leathanaigh, nó teanga an chuairteora	Cuir teanga taispeána i bhfeidhm.
`banner`	`data-banner`	`true`, `false`	auto	Cuir an meirge idirghníomhaíochta ann nó as go héigeantach. Fágtha gan socrú, taispeántar é ach amháin nuair a dhearbhaíonn do mhaiféist córas comhráiteach (róbat comhrá).
`persistentChip`	—	`true`, `false`	`true`	Taispeáin nó cuir faoi chois mion-sceallóg laghdaithe an mheirge idirghníomhaíochta (an philéar bheag ar a n-íoslaghdaítear é).
`alwaysShow`	—	`true`, `false`	`false`	Taispeáin an meirge arís ar gach cuairt, ag déanamh neamhairde de dhíbhe an chuairteora (a mheabhraítear i `localStorage` an bhrabhsálaí).
`mountSelector`	—	roghnóir CSS	gan aon cheann	Rindreáil an meirge inlíne laistigh den eilimint seo in ionad an fhorleagain socraithe ag an mbun.
`triggerSelector`	—	roghnóir CSS	gan aon cheann	Ná taispeáin an meirge idirghníomhaíochta ach amháin tar éis don chuairteoir an eilimint seo a chliceáil, cosúil le lainseálaí comhrá. Ní thaispeánann leathanaigh gan eilimint a mheaitseálann aon mheirge, mar sin nochtann róbat comhrá atá ar roinnt leathanach ansin amháin. Oibríonn lainseálaithe a instealltar tar éis luchtaithe fós. Feiceann cuairteoir a dhíbh an meirge níos luaithe an mhion-sceallóg fós.
`adjacentSelector`	—	roghnóir CSS	gan aon cheann	Cuir lipéad in aice le heilimint nach féidir leat a mharcáil go díreach, cosúil le giuirléid dhúnta nó iframe.
`observe`	—	`true`, `false`	`true`	Bí ag faire ar an DOM le haghaidh ábhair a chuirtear leis níos déanaí agus déan é a lipéadú. Socraigh `false` ar leathanaigh atá go hiomlán statach.
`beaconUrl`	—	URL	gan aon cheann	Postáil rabhcán gan ainm `{siteKey, flag}` ar imeachtaí suntasacha. Gan fianáin, gan sonraí pearsanta.

Ní luach rogha é data-manual: cuireann a láithreacht ar an gclib tús uathoibríoch ar athló ionas gur féidir leat glaoch ar AIDisclose.init() tú féin.

Téamú agus cuma

Socraigh an scéim ionsuite le theme (light, dark, nó auto). Chun do bhranda a mheaitseáil go beacht, sáraigh airíonna saincheaptha CSS an bhlúire i do stílbhileog féin. Sainítear iad ar .aid-banner, .aid-chip:

Athróg	Rialaíonn
`--aid-bg`	Cúlra
`--aid-fg`	Téacs
`--aid-line`	Imlíne
`--aid-btn`	Imlíne an chnaipe díbhe
`--aid-btnfg`	Téacs an chnaipe díbhe
`--aid-hov`	Ainliú an chnaipe díbhe

.aid-banner, .aid-chip {
  --aid-bg: #0b1020;
  --aid-fg: #e8eaed;
  --aid-line: #2a2f36;
}

Ní sheolann an blúire aon rialacha !important agus úsáideann sé roghnóirí ísealsonracha, mar sin buann do CSS. Is iad na crúcaí ranga .aid-banner, .aid-chip, .aid-badge, .aid-badge-inline, .aid-wrap, .aid-ai (fógra ábhair), agus .aid-hm ("déanta ag daoine"). Athstíligh spásáil, ga, agus scáth orthu seo go díreach.

De réir réamhshocraithe, is forleagan socraithe é an meirge ag bun an amhairc. Socraigh mountSelector chun é a rindreáil inlíne agus statach laistigh d'eilimint a rialaíonn tú, ionas go suíonn sé laistigh de do leagan amach féin.

Foclaíocht shaincheaptha

Iompraíonn an meirge agus an sceallóg téacs logántaithe cruinn i 28 teanga as an mbosca. Chun an fhoclaíocht a shárú:

In aghaidh na teanga, sa mhaiféist. Cuir disclosure.texts le córas, eochraithe de réir cód teanga. Úsáideann an blúire do théacs don teanga chuairteora a mheaitseálann:

{
  "disclosure": {
    "texts": { "en": "Some copy on this page was drafted with AI.", "fr": "Une partie du texte a été rédigée avec de l'IA." }
  }
}

In aghaidh na heiliminte. Cuir data-ai-label le heilimint mharcáilte chun lipéad an tsuaitheantais sin a shocrú.

Nuair a shocraíonn córas editorialResponsibility.humanReview: true agus nach bhfuil a ábhar cruthaithe nó ionramháilte go hiomlán ag IS, léann an fógra go huathoibríoch "cuidithe ag IS, athbhreithnithe ag duine" i dteanga an chuairteora, in ionad "cruthaithe ag IS".

Ag marcáil d'ábhar IS

Ní lipéadaíonn an blúire ach an méid a mharcálann tú. Cuir data-ai-content le haon eilimint atá cruthaithe ag IS:

<img data-ai-content src="/img/generated.webp" alt="…">
<p data-ai-content>AI-drafted summary…</p>
<video data-ai-content src="/clip.mp4"></video>

Faigheann gach eilimint mharcáilte suaitheantas "IS" infheicthe agus data-digital-source-type inléite ag meaisín (trainedAlgorithmicMedia mar réamhshocrú, luach atá comhoiriúnach le IPTC agus schema.org). Cuir data-ai-label leis le haghaidh téacs lipéid saincheaptha, nó socraigh data-digital-source-type tú féin le bheith níos sonraí.

Le haghaidh IS nach féidir leat anótáil go díreach, cosúil le giuirléid chomhrá tríú páirtí in iframe dúnta, úsáid adjacentSelector chun lipéad a chur in aice leis, nó triggerSelector chun an meirge idirghníomhaíochta a nochtadh nuair a osclaíonn an ghiuirléid.

Is féidir le fógra cruthaithe ábhair an suíomh iomlán a chlúdach (disclosure.scope: "site") nó leathanaigh ar leith (disclosure.scope: "page" le liosta disclosure.pages de globanna cosáin, cosúil le /blog/*). Tá tosaíocht ag meaitseáil raon leathanaigh ar cheann raon suímh, agus ní rindreálann córas raon leathanaigh gan cosán meaitseála aon rud ansin.

Feidhmchláir aonleathanaigh agus creataí

Faireann an blúire an DOM le MutationObserver agus athmheasann sé an fógra infheidhme ar athruithe bealaigh, ionas go bhfuil ábhar agus leathanaigh a chuirtear leis tar éis luchtaithe fós lipéadaithe. In SPA:

Coinnigh observe ag a réamhshocrú (true) ionas go ngabhtar ábhar arna rindreáil ag an gcliant.
Má chuireann tú túsú ag brath ar ullmhacht an fheidhmchláir, cuir data-manual leis agus glaoigh ar AIDisclose.init() tar éis do do chreat feistiú.
Nuashonraítear fógraí raon leathanaigh go huathoibríoch agus an bealach ag athrú; níl aon ghlao in aghaidh an bhealaigh de dhíth.

Ná socraigh observe: false ach ar leathanaigh atá go hiomlán statach nach n-instealltar aon rud iontu tar éis luchtaithe.

Polasaí Slándála Ábhair

Má chuireann tú Polasaí Slándála Ábhair i bhfeidhm, ceadaigh an blúire go sainráite.

Tábhachtach

Cuireann script-src 'self' docht bac ar bhlúire an CDN go ciúin, agus ní rindreálann na nochtaí riamh. Is é seo an chúis is coitianta nach sroicheann suíomh a dhearbhaítear i gceart Leibhéal 2.

script-src: cuir https://cdn.aidisclose.io leis, nó féinóstáil aidisclose.js ó do bhunphointe féin agus coinnigh 'self'.
style-src: instealann an blúire a stíleanna inlíne, mar sin is leor 'unsafe-inline'. Mura gceadaíonn tú stíleanna inlíne, fillfidh sé ar aidisclose.css a luchtú ó eolaire na scripte, mar sin ceadaigh https://cdn.aidisclose.io i style-src freisin (nó féinóstáil an comhad sin taobh leis an script).
connect-src: is den bhunphointe céanna í aisghabháil na maiféiste don chomhad well-known agus ní theastaíonn aon rud breise. Má luchtaíonn tú an mhaiféist de réir eochrach, ceadaigh https://cdn.aidisclose.io.

Aisghabhtar an mhaiféist gan dintiúir, mar sin freastail go poiblí í: ní bhfaighidh críochphointe a éilíonn fianáin nó fíordheimhniú iad.

Leaganú agus sláine

Freastalaíonn an CDN trí rian:

Leanann /v1/aidisclose.js an t-eisiúint 1.x is déanaí. Molta don chuid is mó de shuímh.
Is leagan seasta, do-athraithe é /v1.0.0/aidisclose.js ar féidir leat a phionnáil, le Sláine Fo-acmhainne:

<script src="https://cdn.aidisclose.io/v1.0.0/aidisclose.js"
        integrity="sha384-…" crossorigin="anonymous" defer></script>

Leanann /latest/aidisclose.js an t-eisiúint is nuaí trasna na mórleaganacha i gcónaí.

Chun an hais SRI a phionnáil a fháil, tóg an blúire: priontálann npm run build i packages/snippet é (tá an fhoinse oscailte ar GitHub).

Do chomhéadan nochta féin a thógáil

Is féidir leat do chomhéadan nochta féin a rindreáil in ionad an chinn ionsuite. Níl aon lasc mhúchta amháin ann: ní chuireann data-banner="false" agus persistentChip: false faoi chois ach an meirge idirghníomhaíochta agus a sceallóg, agus rindreálann fógraí ábhair, suaitheantais [data-ai-content] in aghaidh na heiliminte, agus an suaitheantas "déanta ag daoine" ó do mhaiféist agus do mharcáil fós. Ciallaíonn comhéadan atá go hiomlán saincheaptha gan a bheith ag brath orthu sin agus do chomhéadan féin a rindreáil.

Nóta

Fíoraíonn seiceálaí AIDisclose an rindreáil trí mharcáil an bhlúire tagartha a bhrath. Tá nochtadh atá tógtha go hiomlán de láimh bailí, ach ní bhraitear go huathoibríoch é, mar sin fanann an suíomh ag Leibhéal 1 (Dearbhaithe) seachas Leibhéal 2 (Rindreáilte) mura n-atáirgeann do mharcáil shaincheaptha an méid a bhfuil an seiceálaí ag lorg. Má tá Leibhéal 2 tábhachtach duit, coinnigh an rindreáil ionsuite agus athstíligh le CSS í.

Inrochtaineacht

Comhlíonann an comhéadan rindreáilte WCAG 2.1 AA: imlínte :focus-visible infheicthe ar rialuithe idirghníomhacha, róil agus lipéid chearta, codarsnacht a sheasann i solas agus i ndorchadas, agus beochan faoi rialú prefers-reduced-motion. Braitheann an blúire barraí toilithe fianán aitheanta freisin agus cruachann sé os a gcionn ionas nach mbíonn nochtaí i bhfolach taobh thiar de CMP riamh. Ar scáileáin an-chúng, osclaíonn an meirge idirghníomhaíochta mar an sceallóg dhlúth ionas nach gclúdaíonn sé ábhar riamh.

#Forbhreathnú

#Suiteáil

#Cumraíocht

#Tagairt roghanna

#Téamú agus cuma

#Foclaíocht shaincheaptha

#Ag marcáil d'ábhar IS

#Feidhmchláir aonleathanaigh agus creataí

#Polasaí Slándála Ábhair

#Leaganú agus sláine

#Do chomhéadan nochta féin a thógáil

#Inrochtaineacht