პლაგინის გამოქვეყნება — AiHummer დოკუმენტაცია

შექმნილია პლაგინი პლაგინების განვითარების ნაკრები? თქვენ შეგიძლიათ გამოაქვეყნოთ ეს ორი გზა:

პირადი (თვითისთვის) — ატვირთეთ თქვენს* ინფრასტრუქტურაში. არტეფაქტი არასოდეს გტოვებს ამას.
სამეგობრო (ყველასთვის) — გამოაქვეყნეთ თქვენი პერსონალური ოფისი ში my.aihummer.ru, აპლიკაციების მაღაზია სტილი: ჩატვირთეთ კომპლექტი, შეავსეთ მაღაზიის გვერდი, გაიარეთ შემოწმება, და ის აღმოჩნდება ხელმოწერილი საზოგადოების კატალოგი, რომელიც შეიძლება დაინსტალირდეს თითოეული ასლისგან.

ანალოგია: დაყენება .vsix ხელით (საკუთარი) წარმოადგენს აპლიკაციების მაღაზიაში გამოქვეყნებასთან შედარებით (საზოგადოება).

[!WARNING] საზოგადოების დანამატების დაყენება ახლა შეუძლებელია — ეს კავშირის ხარვეზი არაა. გასაღები, რომლითაც საზოგადოების კატალოგი იწერებოდა, გაუქმებულია; ახალი გასაღების გამოსვლამდე ხელმოწერის შემოწმება ასეთ ჩანაწერებს უარყოფს. ამისგან დამოუკიდებლად, მესამე მხარის კოდი ჯერ არ ეშვება სერვისად თქვენს სერვერზე: იზოლირებული გაშვების გარემოს გაჩენამდე ნებადართულია მხოლოდ ის ინტეგრაციები, რომლებიც თავიანთ მხარეს მუშაობენ და ქსელით უერთდებიან.

რას ნახავთ: «დაყენების» დაჭერის შემდეგ გამოჩნდება ჩვეული შეტყობინება «ყენდება», მაგრამ დანამატი დაყენებულთა სიაში არასოდეს გამოჩნდება. უარის მიზეზი იწერება კარიბჭის ჟურნალში — გახსენით ჟურნალები მართვის პანელში.

რა მუშაობს დღეს:

AiHummer-ის დანამატები ოფიციალური კატალოგიდან — ყენდება ჩვეულებრივ, მათ სხვა, მოქმედი ხელმოწერა აქვთ;

MCP-სერვერი HTTP-ით — უერთდება როგორც ხელსაწყოების წყარო პროგრამირების გარეშე, კოდი თქვენს მხარეს რჩება;

ინტეგრაცია OpenAPI სპეციფიკაციით — იგივე, დასაყენებელი სერვისის გარეშე.

საკუთარი დანამატის ხელით ატვირთვა ხელმოწერის შემოწმებას გადის, მაგრამ გაეშვება მხოლოდ როგორც დისტანციური MCP HTTP-ით ან OpenAPI ინტეგრაცია; აწყობა, რომელიც იმავე სერვერზე სერვისად უნდა გაეშვას, უარყოფილი იქნება.

პირადი რეჟიმი — თქვენი მაგალითისთვის დაყენება

გამოიყენეთ ეს მხოლოდ მაშინ, როცა გჭირდებათ პლაგინი: შიდა დანამატი, მომხმარებლის ინტეგრაცია, სატესტო შეკრება.

ქვეითები

დაწყვეთ და დააწინაურეთ პაკეტი:

aihummer plugin package ./my-plugin
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

გადაატვირთეთ ეს ერთ-ერთ ორ გზაში:
- ადმინის ინტერფეისი → პლაგინები → «პლაგინი ატვირთე» — გადაიტანეთ პაკეტი; ან
- CLI:
```
aihummer plugin publish --private --instance https://your-instance \
  --token <admin-token> my-plugin-1.0.0.tar.gz
```
კაპოტის ქვეშ ეს არის POST /v1/admin/modules/upload (ბოლო კომპონენტებით, integrations:write): არტეფაქტი ეშვება _INSTANCE ობიექტების საცავი (AIHUMMER_BLOB_DIR) ქვეშ blob: ლინკი და კატალოგის სტრიქონი რეგისტრირებულია origin = local-private, visibility = private.
პლაგინი ჩნდება მარკეტში ტეგით პრივატული და ადგენს საშუალებით ნორმალური გზა — სანბოქსირებული systemd ერთეული + მდგომარეობის კონტროლი.

ნდობა: განმტკიცებული გასაღები და ნდობის საცავი

პირველადი არტეფაქტები უნდა მიიღოს ხელმოწერა. როდესაც თქვენ იტვირთავთ დანამატს უცნობი საკითით ხელმოწერილს, ადმინისტრატორის ინტერფეისი გთავაზობთ დაამყარეთ ავტორის კლავიატურა შეინახება ბრენდირებული სერთიფიკატების საცავში (ერთ შპრიცზე). დადასტურების შემდეგ ხელმოწერა შემოწმდება ყოველი ინსტალაციისა და განახლების დროს.

არტეფაქტები ებიდან ოფიციალური წყაროს შემოწმება დამაგრებული რეესტრის კლავი ბირთვში — ნდობა დეფოლტურად, დამატებითი მოქმედებების გარეშე.
პრივატული არტეფაქტები შემოწმდება ინსპექტორის ნდობის საცავში არსებული გასაღებებით.
გარეშე ხელმოწერის პაკეტები უარყოფილია — გარდა განვითარების რეჟიმისა ადგილობრივი განმეორებისათვის: AIHUMMER_PLUGIN_DEV_UNSIGNED=1.

[!WARNING] AIHUMMER_PLUGIN_DEV_UNSIGNED=1 გამორთავს ხელმოწერის შემოწმებას და განკუთვნილია მხოლოდ ადგილობრივი განვითარებისათვის. არასოდეს გაანათეთ ეს გარე ხელმისაწვდომი მაგალითზე.

საზოგადოების რეჟიმი — გამოქვეყნება პირადი კაბინეტის მეშვეობით

პლაგინის ხელმისაწვდომობისათვის ყოველი მაგალითად, გამოაქვეყნეთ ეს თქვენი პერსონალური ოფისი ში my.aihummer.ru, ასევე, როგორც თქვენ აპლიკაციას აპლიკაციების მაღაზიაში ატვირთავთ. თქვენ ატვირთავთ კომპილაციას, შეავსებთ მაღაზიის გვერდს და გაგზავნით შემოწმებაზე; პირველ რიგში ხდება ავტომატური AI შემოწმება, შემდეგ საბოლოო გადაწყვეტილებას იღებს ადამიანის მოდერატორი, და დამტკიცების შემდეგ არტეფაქტი გაფორმებულია და გამოქვეყნებულია საზოგადოების კატალოგში.

სრული ნაბიჯ-ნაბიჯ სახელმძღვანელო მდებარეობს გაგზავნეთ პლაგინი. მოკლედ:

შეაგროვონ და შეფუთონ თქვენი პლაგინი SDK-თი (aihummer plugin package) — არტეფაქტი არის დაჭერილი .tar.gz მგზავრი მას manifest.json.
გაიხსენით «ჩემი პლაგინები» კარადაში და შექმენით მიწოდება: ჩამოტვირთვა ობიექტი, შეავსეთ მედათების შენახვა (სახელი და აღწერილობები RU + EN, ვერსია, აიკონი, სკრინშოტები, კატეგორია, ნებაყოფლობითი სიბრალის ბმული, ცვლილებების ჟურნალი) და განცხადება შესაძლებლობების მანიფესტი.
გაგზავნა შესამოწმებლად. ავტომატიზირებული კმაყოფილების მიმოხილვა ამოწმებს წარმოდგენილს შესაბამისობისთვის ეს მოვლენების მიმოხილვის პოლიტიკა (უსაფრთხოება, მანიფესტი) სისწორე, სავსება, შინაარსი), შემდეგ a ადამიანური მოდერატორი კითხულობს ანგარიშს და იღებს გადაწყვეტილებას. ავტომატიზაცია არასდროს გამოქვეყნდება საკუთარ თავზე.
დამტკიცების შემდეგ არტეფაქტი არის დაჭერილი და გამოქვეყნდა საერთო community-catalog.json CDN-ზე. ყოველი მაგალითი, რომელსაც დაამატა კომუნიკაცია ხედავს პლაგინს; ბირთვი ენდობა მას მეშვეობით დამაგრებული რეესტრის კლავი — თითოეული ოპერატორისთვის ნდობის ნაბიჯი არ არის საჭირო.

[!NOTE] გამოქვეყნების ძველი საჯარო პროცესი გაუქმებულია; ზემოთ აღწერილი პირადი კაბინეტის ნაკადი — «ჩემი პლაგინები» — ახლა კომუნიტეტის გამოქვეყნების ერთადერთი გზაა. კომუნიტეტის პლაგინები უფასოა; შეგიძლიათ დაამატოთ ნებაყოფლობითი დონაციის ბმული.

[!NOTE] პირველი მხარის პლაგინები (აინშტაინი, SIP, Bitrix24, pocket-agent, os-client) არიან ამგვარად არ იბეჭდება — ისინი გრძელდება AiHummer CI-ის საკუთარ კონვეიერის საშუალებით და ხვდებიან განახლებული ოფიციალური კატალოგი. პირადი კაბინეტის ნაკადი განკუთვნილია საზოგადოება (მესამე მხარე) პლაგინები.

მოდერაცია

ყველა საზოგადოება გადის ავტო-მოწმენა (სრულადობა, შესაძლებლობების მანიფესტი, ხელმოწერა და უსაფრთხოების შემოწმება), შემდეგ ხელოვნური ინტელექტის რისკის მიმოხილვა, და ბოლოს, ა სავალდებულო ხელით (ადამიანის) გადახედვა AiHummer-ის გუნდით. არც ავტომატიზაცია და არც ხელოვნური ინტელექტი თვითონ არასოდეს აქვეყნებს — გადაწყვეტილებას ყოველთვის იღებს მოდერატორი, და არაფერი ხვდება კატალოგში მათი დამტკიცების გარეშე. გამოქვეყნებული დანამატი, რომელიც მოგვიანებით აღმოჩნდა მავნე ან დაზიანებული შეიძლება იყოს გაუქმებული და წაიშალა კატალოგიდან შემდეგ სინქრონიზაციაზე.

კომუნიტეტის კატალოგი როგორც დამატებითი წყარო

კომუნიტეტის მოდულები გამოქვეყნებულია საერთო community-catalog.json ეს აკეთებს არა პირველი დონის კურატირებული კატალოგის გადაწერა. ინსტანცია მას ამატებს როგორც დამატებით წყაროს პლაგინები → წყაროები (ან POST /v1/admin/modules/catalog/sources). ყურება ინსტალაცია და განახლებები და მოვლენების მიმოხილვა და დონეები.

პლაგინის სიცოცხლის ციკლი (App Store)

მარკეტპლეისი მუშაობს როგორც ნამდვილი App Store — თითოეულ პლებინის აქვს იდენტურობა (მუდმივი იდენთიფიკატორი + ავტორი), რომლის ქვეშაც ის გაცემულია ვეფსი.

ვერსიები და განახლებები

განახლება პირდაპირ ეცემა ახალი ვერსია მოწინავე პუბლიკაციის მქონე პლაგინის შესახებ: იგივე სლაგი, მისი საკუთარი ცვლილებების ჟურნალი, მისი საკუთარი მიმოხილვა და მოდერაცია. მხოლოდ ერთი ვერსია შეიძლება განხილვაში იყოს ერთდროულად — თქვენ შემდეგს უგზავნით მას შემდეგ, რაც არსებული მიიღებს გადაწყვეტილებას. როდესაც ახალი ვერსია გამოქვეყნდება, წინა აღნიშნავს superseded, და კატალოგი + თითოეული ეგზემპლარი გადაადგილდეს ახალზე.

გეგმიური გამოქვეყნება

როდესაც მოდერატორი ამას დაამტკიცებს, ავტორი კონტროლავს გამოშვებას: გამოაქვეყნეთ ახლა ან დაგეგმეთ კონკრეტულ დროს — პლაგინი გააქტიურდება დანიშნულ დროს.

გამოქვეყნებიდან მოხსნა

პაუზა — დროებით დამალა პლაგინი: ის საჯარო კატალოგიდან და ინსტანციებიდან ქრება (შემდეგ სინქრონიზაციაზე), მაგრამ შენახულია და შეიძლება არსებობდეს გადამოტბოვებული ნებისმიერ დროს.
სიისგან მოხსნა — წაშალოთ დამატება მაღაზია სამუდამოდ.

როგორც კი პლაგინი გაუქმდება (ადგილობრივი დაყვანა ან გამოქვეყნებიდან მოხსნა), მისი ჩანაწერი წაიშლება community-catalog.jsonდა შემთხვევები აღარ აჩვენებენ ამას შემდეგ სინქრონიზაციაზე.

ავტორობა

პლაგინი გამოქვეყნებულია თქვენი ხილული სახელური (მაგალითად, თქვენი სტუდიის სახელი) — ან ანონიმურად. პუბლიკური კატალოგი და ვებინტერპრესი ინდივიდის აისახებს არჩეულ სახელს ან „ანონიმს“; თქვენი ნამდვილი ელფოსტის მისამართი/იდენტიფიკატორი არასდროს გამოიქვეყნება.

შემქმნელის სტატისტიკა

ყოველ პლოგინს აქვს საერთო სტატისტიკა: ჩამოტვირთვები, ინსტალაციები, აქტიური შემთხვევები და წაშლა, პლუს ყოველდღიური დიაგრამა. მხოლოდ გაერთიანებული მონაცემები — ინფორმაცია ცალკეული შემთხვევების შესახებ დეველოპერს არ მიეწოდება.

გამოსახულებისთვის პრემიები

თვის ყოველ პლაგინს, რომელსაც პირველად აქვეყნებთ, თქვენი გამოწერა AiHummer სარგებლობს ერთი უფასო თვე (გაცემულია თითოეულ პლაგინზე ერთხელ).

სად შემდეგ

გაგზავნა პირადი კაბინეტის საშუალებით — სრული ნაბიჯ-ნაბიჯ: მეტამონაცემები, შესაძლებლობების მანიფესტი, მიმოხილვა და AI–ს მოდერაცია.
პლაგინების განვითარების ნაკრები — ცხადი ველები და `aihummer პლაგინის ბრძანებები.
ინსტალაცია და განახლებები — განთავსება, რწმენის მოდელი, ხელმოწერილი განახლებები, დალაგება.
შემოწმების პოლიტიკა და სია — კრიტერიუმები, რომლებითაც პლაგინი გამოქვეყნებამდე მოწმდება.
მარკეტპლეისი: მიმოხილვა და დონეები — ოფიციალური ქმედებების რეესტრის წინააღმდეგ.