From e582d423bdf08e63a27bbed10bff125e050f6c50 Mon Sep 17 00:00:00 2001 From: nb213 Date: Wed, 9 Sep 2026 08:33:44 +0800 Subject: [PATCH] =?UTF-8?q?feat(provider):=20AI=20=E6=B8=A0=E9=81=93=20-?= =?UTF-8?q?=20=E6=96=B0=E5=A2=9E=20Atlas=20Cloud=20Chat=20=E5=8D=8F?= =?UTF-8?q?=E8=AE=AE=E6=8F=92=E4=BB=B6=20(#445)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> Co-authored-by: binyangzhu000-sudo <224954946+binyangzhu000-sudo@users.noreply.github.com> --- .../protocol/official_catalog_test.go | 35 ++ plugin-packages/atlascloud-chat.yingce-plugin | Bin 0 -> 7836 bytes plugin-packages/atlascloud-chat/README.md | 5 + .../atlascloud-chat/docs/interface.md | 354 ++++++++++++++++++ plugin-packages/atlascloud-chat/manifest.json | 244 ++++++++++++ plugin-packages/generate-catalog.mjs | 1 + 6 files changed, 639 insertions(+) create mode 100644 plugin-packages/atlascloud-chat.yingce-plugin create mode 100644 plugin-packages/atlascloud-chat/README.md create mode 100644 plugin-packages/atlascloud-chat/docs/interface.md create mode 100644 plugin-packages/atlascloud-chat/manifest.json diff --git a/backend/internal/protocol/official_catalog_test.go b/backend/internal/protocol/official_catalog_test.go index 2c7df04ee..168545f79 100644 --- a/backend/internal/protocol/official_catalog_test.go +++ b/backend/internal/protocol/official_catalog_test.go @@ -86,6 +86,41 @@ func TestOfficialProtocolPackagesAreSelfContainedDeclarativePlugins(t *testing.T } } +func TestOfficialAtlasCloudChatProfile(t *testing.T) { + data, err := os.ReadFile(filepath.Join("..", "..", "..", "plugin-packages", "atlascloud-chat.yingce-plugin")) + if err != nil { + t.Fatal(err) + } + pkg, err := ParsePluginPackage(data) + if err != nil { + t.Fatal(err) + } + provider := pkg.Manifest.Contributes.Providers[0] + if provider.ID != "atlascloud-chat" || provider.BaseURL != "https://api.atlascloud.ai" || provider.Auth.Type != "bearer" { + t.Fatalf("Atlas Cloud provider metadata = %#v", provider) + } + + adapter := officialPackageAdapter(t, "atlascloud-chat.yingce-plugin", "atlascloud-chat") + spec, err := adapter.BuildCreate(context.Background(), RequestContext{Request: GenerationRequest{ + Model: "openai/gpt-5.6-luna", + Messages: []Message{{Role: "user", Content: "hello"}}, + }}) + if err != nil { + t.Fatal(err) + } + body := manifestTestBody(t, spec) + if spec.Method != "POST" || spec.Path != "/v1/chat/completions" || body["model"] != "openai/gpt-5.6-luna" { + t.Fatalf("Atlas Cloud request = %#v, body = %#v", spec, body) + } + result, err := adapter.ParseCreate(context.Background(), []byte(`{"choices":[{"message":{"content":"atlas ok"}}],"usage":{"total_tokens":3}}`)) + if err != nil { + t.Fatal(err) + } + if result.Status != StatusSucceeded || result.Result == nil || result.Result.Text != "atlas ok" { + t.Fatalf("Atlas Cloud response = %#v", result) + } +} + func assertManifestContractMatchesPackage(t *testing.T, packageName string, manifestRaw []byte, interfaceDocs string) { t.Helper() start := strings.Index(interfaceDocs, manifestContractStart) diff --git a/plugin-packages/atlascloud-chat.yingce-plugin b/plugin-packages/atlascloud-chat.yingce-plugin new file mode 100644 index 0000000000000000000000000000000000000000..27b4cda7228586d021b3dce1c84073240dae4dd5 GIT binary patch literal 7836 zcmZ{Jbxa&k_a!cc;!@n*U5mRE*P_K;r?^XTE3O3wcX!vph5}P`aJS+v+b^5!=J#zj zFDLijym$UNf4tOW}8O3J9pvO8I7>AJFl z6j^m$XFwdP8m==6tXtc@4S`43%P0Bgc~6d`PX|zk{JQhNPUq1kJCTCByFUH4bAxvv zLs#49Rlcpq(9yAvs%i{3pG|w-K$#s= z05o@{d7f(=y!^Xnu`|PqZ-3YC{e1IJ4+9!q&SPul^Ig_o{qJAOoNB=LwOR_};~eY_ zO6uOrvp0<`_eWFs60z;=`L!oL{D8@(-V(KE!an`=a;&_R0;B4JEWH%N)bz~U%8VSG zst_t5>f8qy_5YzkWjf7QWpo%AZ7vuX?0*_qx>$H{*g1Pzxm%lCSpCxiO6;J8YjEcm zDC@G8sFeGtpsI==d&=I$qB-FRNtaEg?~nlRwm``o7)zMTll9=xIq)?k`(;yMSc;Qr zuPjPk%C13u^#|*#e?5O77}-0pp{@AMe6I65?>N|^tCdc;#91U#E-f}XK;iH>KIP9} z9rjCv4AzD8mnf6YfbAkezrW}*>A;1sa3F7~GC4T&z3Q+3tJn0Y<4O$A6C z;s5jsXT%|)w!>uhej*B)JhZWB(Dg0CZ*3R9z}XILe-wZtOWsReApda5R5)FP5xImP)o1#g}eOQc)1L9^+IR zpQhB!FxfU`e#jsLoY8IWJmz+`#S>mXct=xW{e(0=+LxFuU67CUw)+{~)`y!;^&^Xc zw&UA&E#7Lb>|(l*_4R6vwnPKrXwf_0@#7=S6{WDTK^KK$%RdUpdZ45dFtHak=_br0 z=sTri24l#Ws9w*NW#~$7hHM1ONDpPLK|rxAC)yM`eNiG=F6Io@57FjY>}bDmHpsD0VdB8Qq1FV^}Xm_Lsn#7xGw zCaCi#^fJCLfD%^@WOJeXS*WN<9AxHWwiyKAKKeDFhN9eM5=qTdFT$vn2dJyIR)(7|>1xdpX5p54HTvMZY7#je@=$=h zyQ>xjVxYC;b=+_Xk>2IWO4qVmZk05i+^h-0-ccd-@LZ8?1h(axyh!A(vL z^^ky=&|mD~ zAxM&-t1o+g0!S)`kjlL-xFE1U2iesxZQBHJTi7XHhUZ13N1PLPQm!2(8?~O*DBMw` zvtIG2M;Ukb$YXof`!sBe1@IOi98VN^HbCniX0)?X$d@7udW7+B&*od`dTq4KAUXo2AVieqO0TDQe-W{ofYidta zzBBBEuHmbJiU;n54ds?PlZ%MkI`YLtIyN&I#A)Dib8xA4r-z7Sj)`Pb{LvM$@f`b% z#|WG=$5$B<#@O3fvje>P67g@$JOf!^sKk{;sDCeR0)JlbA7F!LCg)}6a_aEsXC@Og zuJ*s3z7qSRw}U&P{iUcs1d$flS95!I z*}KtV2(;e{2W+m}ahKf}$gcZ(9AXo(`{)M|OixJU`G#R;I4C1(YKG^ueQhW5{2J_l z1igV;CqWn6vpzrJJ0d~e)_EgbV!usq3)tY_;qXP+LB}OvDmnRhX08Gh*eD0Im>p;uP9Vy=@uGmUg>nm|l?Mj~)a^ym1;E*EMwfDPU8I-da@ zL>1B~{VJ(9{^vVlZ!h&7aUfSb!2rQ81l6IM!Z?zQF-4Wm+r>~{X93c=V7_V>%nCM44Qq^Ht@pZeMpQFKSIEW1#LE zttcpi;c3J+Bl88-vCU{a8+lVCG8^3DW-H4G&Fv*}ch@g%0!1yZV>3oExt(_T z1ju74x(%bH*vTmfbHb7!-j%(|$-1yPtk3(Ygea!b%IERIM zh-7UVY2?wU);#*(PP?65YOwK?r7lWZ1DrA<>;QHYyp3Eo&8eFCc=gp?xLaB;zp!w3 zHNwO*eT!RjihTp`MWW)~56>U9Y!>@(6Y|f+zeA5n4!eKPdo>j|xoqm1j!lc9e)AEE}yvHf_DRpU7d#>={6{J6Ho#5yK$))`}$IXD&2HUov@$ zMZ6>U-7M1~zED+>9M>XX?1Lw{SX|(Mpaa|BkKYkQ0yji9@v;xU0;J)5P#Iohwrk5N z=(oazD6eT6XPyu?nLT57USZ)Qia{tn7`z&2CwFv-hNW?s7$6JzXN*q8L$nWLXeLG^ z;seXwZ>6QF_((hZEgl0JQAXJ14;Dw}RM?%@P8Zw*A;EB* zdZGOiyk;=7P&eyY5rRDzs(NFqDu3d}Z@+t3hPNin0WJ|+GKJdsh{wYwyB)_JhQpl9bn=+O z?(MTkoeuQNM%ETZKLK3OTqF-C7U{3NSunG>6s_Vs9`Zq`KITSAwAq(!9&P5R1OsUb zoeJ9(nP1dp^h?Z>yE%VTvfj*}VXyQm$3|v*5gjK5f76JiEUVMXbhE5}t;Q|GBC14# zGe5Hxp&i9cF@(VgZ7DtD)FecqrWT`)wFAPB9{vq{5VA&LjvX{JluMy2#jf$Ey}j=e zZs=Z9ljnxd3_kVG9NireAbfJ_0xEFpB!cC4q>AGC(xZ8!5ia^1#}t%NH1nHj83M4V z{kJhVI{qj)DPhbuC{dWX93lCjzEWyJ0vMRcZD?;xkqhm+zmTG~;@(C+WQIFt?z(3q zTk0#`qw$BkeNg;7z5j*YaY}BX64nT*rKzEVo`s7;B&5`9Zoi4-_)3b97h{imc~^cF z-}!iqM3UrfX^)T+MhW%nWSUH4F;jipJ8*J+H}AjLBU3`#!o}X@mH39d)?85_=2X zZ5AgS@O%xMud`BGD+|R4E;LjM8uDr4{8GF&N}CcK$R>R0)g6g9zj*5R<=2-&edUX! zJ8u!Tm#e(2J#_2x>Evp^^uT8&d|ZK+{kmT_o`f-*7My{^d6~s`)HnmFr;~VGNi>`L z^h{)&hEj#gk>_7Ll8;(7!ZYi`@TUqDOC)vH&RxN>Zh*4=u9w1oq;bV5)}DB}3B^>Rx0QH`e2xx)`*plvH(lZl-0%8ec7I$-nD+6%i0Y_ zethEyS+zdD9}ep@ecA!7&>$B16X)x^SJ+sEQ{B5YNa9bMPdC&JweN>F%%ps@PRn@3 z$|F;f$5D=G2Gix3>x=)op_@VKxpn@wvcZLQSH%(f$E@8%Y&CpI5B<4(DKV6brxo|I zFGL_9;qHBZmvqOaHo`H`P|8w(@R0;aViUkAXqYeY}@!#g*WbSNdZRO#~ZtvmZ4E_4m z0~drJc%Y}!?4wZG|Lt1A$tewO`~xFrw3vkTzY6Vo0?|5 z`}Q|G){0agD?K7;s#1P#{w*T6cS=P~4Qxv*QftZd0du|#T%%SX7SMYMp^3rK@Bjtb zb|z0*Q!}KF>vQwqEc&`v3@UKr_FVlK*HHPXvdP6)pc(JY{8fQ8HnGx2I8|ewnEZ4k zY(i1AGPha2PB8a<)}#ACFrbRys@T9d7hgx+sjHzw#ttVNd+}$7XbxMW9&wu~pUJwj zbB{nn!Uk^G+~0#nJA1l4!i)O;_UneWqMe1q2z58=nB>LeaZI+Q;iY=nEh`*d zJhu~$uRA~Y)s*7}Aab`%od)&`6H1P}4!df@sk)cGRlKp}&cT$`M9kpK`}J&(6Wcd~ z>oL?lZhcFcpIP0dm{s+1N5lPpMe72=^b{iB(cdpts?{THuX_#NqLciK)W7D4aGXGh zv#Qm*(s;@Omjh@GKhaPpFcIFIrddkOhgD>6EX>|ms3a}+wr;dmVrK90?Il(gGMO5^ zh>(*{A9##L+v06EjBP=R>Cc3;T&5W|n)6+Xk3Nc;D`){!+vI-NjFoqWZI}uMRj5Uq zJo3gsqDGsJjFg7B%=CdhG*|?MjOJOt+xTwIB0FC2=zm2Jd3caP^JGP0r@)(^^?CK> z#tIklo~n(sh*x!PpibTress-GIO43`)j^q>wdUOVG_qG58}gn|XyJ05(ia ztX~%{eB{Esi`@ zTc#polONt~Egndpp5t{`@1~esGx&6P&;c?$oY;Q7qMMxK1{x!yson&4uH5h}@hv}~ z%@;V+P?_s@{tYNML+flFk#<*XsWnL~$$riKbfTAr9W*(8DmXGi&{)UBwD|&_z$T8! zhm8y$bcn=fLw^F{`$43>&uctQ==l-X>cbJ0`ocaPdK*2%blSc3p3ur;$WHR~$9-T^ z4Xj6rR9VsE$$rmb?!iJG^7V2ZZzc8mEsZF=jbIE#Q-ptQ(gA(uq-^sY&G*^e1Syki zLo2Ot1qc8Tr}tr9{<4puDQjyN#USkdr2K|FjY5*LO9*{bz6m7AB_?uHLI5_!g|ew@ z=+smejt#IzP{gX68ZFXhD zKj+np^%nKFBgWT%G@I@wa$m_8>;hjtJMM410j4EQvQ<9KN8 zF1#?3WR&P*eqKLF%6J}iC(bF|cdxL_&E5FT5$`z4gXjkwn-OfNdQILqUU3cDl?jqr z>{pY^Pq>pGE#c`-YSKc|VwkHI^*NCOGGvx*caZ z1l3aXbyz87J0yzW;VIf{ZYM;cX(5~tc zcpM9@^e!5*&Yyf??N+uZJnR@Iidj#%RbTi>~Eu=&8t`NI~28&&i4pOv9fm1Bm@ra z97$bX{xKk?RgAYyuaMc%xn|y`y}Leg;EJVP-a@WR*5k7H+pv5~^ThdES7P=?pUhs5 zZ^?>3e@Ll`V1|OB%-m`wP-S?LM$}TzvAW&AFG6e`IsPs$RY)PZ(?|KQ|#S$^MyuaM+4IJmN)7pPqIw_SvJ6BC$39yP7DL7h31$YEiZl5n*oe z@MMBDy2_sfa8~%QuiU?#Cxn)|27y~rkw$<0T!$K=FD3!uHy9tq=__UX1>OAGO|l%= z#2lTSw%V$L1V5|ZSEcC1*A;m_C$HM`*3hNcrw$jkjIf9_dr3PtOeRqur?u_BdL54B z`JS<#r!(zOST?;7qu{e4A0cuBK5(NOQQJ8We4bhsc(698%HqMj#iVQh0AJ8|b8D<# z?(7;=tw%m!tUGY2a-Kx1Tf_1_;4kWwjKk`5+sSl|YWvYVUZl0sv<+Q*`k*QAYwDzF ziLv(E?8`%;n@ePiPQ_XIi?PKy-cIelmUB=mo9$?$vgP%4%6uJ(PC{RG=V-hIRqan&J;cYMx!bjyyh{e>ikv@B8%# zHCltK65LAF>k*FS*lgCp*Yh}5=T4hSG`JdoR@D&lO#J}|!av>=*vz~>?j8*^^&HH+ z9Nm=k4*Wa--x{BOUKa4KsJs700bBz|Yt2+cIQGVv45cT@uz}q zJcSr*wBR}z?R+)Z^Ups6?mX3mLw0m7gE3=#{0Kw44RWdCS!@*T;#R9{oNEjD6g-=1 zKnBhHXla7A>D41oYq|vXvz~LDhdn#t?nHeff2odL0Wr7@CgYs$q7scvVijhfi!Rtv z#xL0!h|t!jNqgl@JtjDxLp=^u7ECZE1kNbiP*>c!rjA;S58 zRXiq+uJ1OPt!{98;tURo6Or4!-BqWmBVxy`CjDe4>xwejoF?BWYsUZr?x#<5OMSpN zfCf7>VuSaA^9wSRTLJNPP+FL9SWScn z7EvJa3Zd|I9ES>>slkqvIZEx2jhh)9=C`~0Y;Imct}k$F*(-s~#j)Rv$ww4#I)~<| zK6ypEvh$LIyMUcx`Ou=o7(Ao3pBR1NGU!g2l7`cJ;|r9M`PBy_Y2G|QT9BKUx3#x-<= zxw&xpa}U}8-F^=xe2GztfmMtViyjAHCd!}y(w)6Ln@sshY?gosK<(`~CM7reyt|KuAV8@X7C~`3pblyBlC?Rq z6kB!LIjw`Txu$NL2n7?$TU)YAbQyezCs-F7)+5kgBI!7CS~@13@=%g{X$-Y-c3T(p zN*DHy7#9$?S;z72Bb{XUl7RsmcbZ6U)D3rkFZ-_la9i7W;(*#&K0u-TFlA$^sF0>Y zKX_yo#80(H?JtQPS@-G`54E7icU5RVaw7U6UQ08rpJ6?tP6bQxHa}zs;>WT&-Wk?!b zYCE8L3Mw)EzpJD!R5lN3)GXq$K{>SnLC?|MA`~PIKw{`=2Bj)OYP@1DO46`jd_@ie<~uH zGxlvh!4KXgkCvQ{Ko{8V_PBKoB{Y_lSv_q@kYh(xNxcfgLx^M?}0=m4YY%wbGB>?~cKlA~hnjcz)1V#3XBej~Z>f?0^Py3!bk(ooJ|#$r&` zM#FAt8RpDw6%YVG60Zb6@vjIy)Z6CUF%en&j417BdIh|{Q9<5OO3cgG&cBBCz@?qn z&SR5_h=A%GfC*VjWO{qT4IXBv^sElva&qsfkq`o37BHc?$(uYfu(kT%_lo3$LB~pF zM`m}lDg2|5j)6^I*$y&rFKH`(5Y%$`OCfnz26an1C~ka*=TbD;^`0dNSVTvMm5kf2 z3-7czp(MTSt|1t;P*3n__j_$TwzudJCRS8LJqg)nJc%pFod(_GKGX2VA z3oPkhPeR}M{GTKpsAe`p{9;_L;qQuO(KI{qZ}95MuyEw?|NmI`pSJ)5`wzg7|8)N+ z;6elZ*a0{lD#u|4R@2=WhHDb3 +## Manifest 完整接口定义 + +以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。 + +```json +{ + "apiVersion": "yingce.plugin/v2", + "id": "atlascloud-chat", + "name": "Atlas Cloud Chat", + "version": "2.0.0", + "author": "Atlas Cloud / 影策", + "description": "Atlas Cloud Chat 独立请求协议插件。", + "documentation": "<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>", + "permissions": [ + "generation.run", + "media.read" + ], + "configuration": { + "fields": [ + { + "name": "apiKey", + "type": "secret", + "label": "API Key", + "required": true + } + ] + }, + "contributes": { + "providers": [ + { + "id": "atlascloud-chat", + "label": "Atlas Cloud Chat", + "capabilities": [ + "text" + ], + "scopes": [ + "admin.system-channel", + "user.custom-channel", + "canvas", + "creation", + "agent" + ], + "baseUrl": "https://api.atlascloud.ai", + "requiresPublicMediaUrls": false, + "auth": { + "type": "bearer", + "field": "apiKey" + }, + "parameters": [ + { + "name": "model", + "type": "string", + "required": true, + "mapping": "model", + "description": "上游模型 ID。" + }, + { + "name": "messages", + "type": "message[]", + "required": true, + "mapping": "provider message container", + "description": "包含历史消息和当前用户输入。" + }, + { + "name": "instructions", + "type": "string", + "required": false, + "mapping": "system/instructions", + "description": "系统指令。" + }, + { + "name": "temperature", + "type": "number", + "required": false, + "mapping": "temperature", + "description": "采样温度。" + }, + { + "name": "top_p", + "type": "number", + "required": false, + "mapping": "top_p", + "description": "核采样参数。" + }, + { + "name": "max_tokens", + "type": "integer", + "required": false, + "mapping": "max_tokens/max_output_tokens", + "description": "最大输出 token。" + }, + { + "name": "tools", + "type": "array", + "required": false, + "mapping": "tools/toolConfig", + "description": "工具定义。" + }, + { + "name": "tool_choice", + "type": "object|string", + "required": false, + "mapping": "tool_choice", + "description": "工具选择策略。" + }, + { + "name": "response_format", + "type": "object", + "required": false, + "mapping": "response_format/text", + "description": "结构化输出配置。" + }, + { + "name": "stream", + "type": "boolean", + "required": false, + "mapping": "stream", + "description": "流式开关；后台任务当前以最终响应归一。" + } + ], + "create": { + "method": "POST", + "path": "/v1/chat/completions", + "contentType": "application/json", + "body": { + "model": { + "$ref": "request.model" + }, + "messages": { + "$ref": "request.messages" + }, + "temperature": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.temperature" + } + }, + "top_p": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.top_p" + } + }, + "max_tokens": { + "$omitEmpty": { + "$coalesce": [ + { + "$ref": "request.extra.max_tokens" + }, + { + "$ref": "request.providerOptions.atlascloud-chat.max_tokens" + } + ] + } + }, + "tools": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.tools" + } + }, + "tool_choice": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.tool_choice" + } + }, + "response_format": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.response_format" + } + }, + "stream": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.stream" + } + }, + "provider": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.provider" + } + }, + "transforms": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.transforms" + } + }, + "extra_body": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.extra_body" + } + } + } + }, + "agent": { + "method": "POST", + "path": "/v1/chat/completions", + "contentType": "application/json", + "body": { + "$merge": [ + { + "$ref": "request.extra.agent.chatCompletion" + }, + { + "model": { + "$ref": "request.model" + } + } + ] + } + }, + "response": { + "status": "succeeded", + "textPaths": [ + "choices.0.message.content", + "choices.0.text" + ], + "reasoningPaths": [ + "choices.0.message.reasoning_content" + ], + "usage": { + "$ref": "response.usage" + }, + "errorPaths": [ + "error.code" + ], + "messagePaths": [ + "error.message" + ] + }, + "agentResponse": { + "textPaths": [ + "choices.0.message.content", + "choices.0.text" + ], + "reasoningPaths": [ + "choices.0.message.reasoning_content" + ], + "toolCallsPath": "choices.0.message.tool_calls", + "toolCallIdPaths": [ + "id" + ], + "toolCallNamePaths": [ + "function.name" + ], + "toolCallArgumentsPaths": [ + "function.arguments" + ] + } + } + ] + } +} +``` + diff --git a/plugin-packages/atlascloud-chat/manifest.json b/plugin-packages/atlascloud-chat/manifest.json new file mode 100644 index 000000000..0a9456563 --- /dev/null +++ b/plugin-packages/atlascloud-chat/manifest.json @@ -0,0 +1,244 @@ +{ + "apiVersion": "yingce.plugin/v2", + "id": "atlascloud-chat", + "name": "Atlas Cloud Chat", + "version": "2.0.0", + "author": "Atlas Cloud / 影策", + "description": "Atlas Cloud Chat 独立请求协议插件。", + "documentation": "# Atlas Cloud Chat\n\n该目录是独立官方协议插件源码。后端从生成的 `atlascloud-chat.yingce-plugin` 包加载，不依赖系统内置 `host:` 适配器。\n\n完整接口见 [docs/interface.md](docs/interface.md)。\n\n---\n\n# Atlas Cloud Chat 接口字段\n\n## 协议身份\n\n- 插件 ID：`atlascloud-chat`。\n- Provider ID：`atlascloud-chat`。\n- 能力：`text`。\n- 默认 Base URL：`https://api.atlascloud.ai`。\n- 鉴权驱动：`bearer`。\n- 创建：`POST /v1/chat/completions`。\n- Agent：`POST /v1/chat/completions`。\n- 生命周期：同步响应。\n\n## 配置字段\n\n| 字段 | 类型 | 必填 | 含义 |\n| --- | --- | --- | --- |\n| `apiKey` | secret | 是 | API Key |\n\n## 统一字段映射\n\n| 统一字段 | 类型 | 必填 | 上游映射 | 说明 |\n| --- | --- | --- | --- | --- |\n| `model` | string | 是 | `model` | 上游模型 ID。 |\n| `messages` | message[] | 是 | `provider message container` | 包含历史消息和当前用户输入。 |\n| `instructions` | string | 否 | `system/instructions` | 系统指令。 |\n| `temperature` | number | 否 | `temperature` | 采样温度。 |\n| `top_p` | number | 否 | `top_p` | 核采样参数。 |\n| `max_tokens` | integer | 否 | `max_tokens/max_output_tokens` | 最大输出 token。 |\n| `tools` | array | 否 | `tools/toolConfig` | 工具定义。 |\n| `tool_choice` | object|string | 否 | `tool_choice` | 工具选择策略。 |\n| `response_format` | object | 否 | `response_format/text` | 结构化输出配置。 |\n| `stream` | boolean | 否 | `stream` | 流式开关；后台任务当前以最终响应归一。 |\n\n## 上游请求模板逐字段清单\n\n下表由插件请求模板生成，覆盖 body、query、headers 和 multipart 文件声明中的每个字段。\n\n| 上游位置 | 值或转换表达式 |\n| --- | --- |\n| `create.method` | `\"POST\"` |\n| `create.path` | `\"/v1/chat/completions\"` |\n| `create.contentType` | `\"application/json\"` |\n| `create.body.model` | `{\"$ref\":\"request.model\"}` |\n| `create.body.messages` | `{\"$ref\":\"request.messages\"}` |\n| `create.body.temperature` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.temperature\"}}` |\n| `create.body.top_p` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.top_p\"}}` |\n| `create.body.max_tokens` | `{\"$omitEmpty\":{\"$coalesce\":[{\"$ref\":\"request.extra.max_tokens\"},{\"$ref\":\"request.providerOptions.atlascloud-chat.max_tokens\"}]}}` |\n| `create.body.tools` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.tools\"}}` |\n| `create.body.tool_choice` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.tool_choice\"}}` |\n| `create.body.response_format` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.response_format\"}}` |\n| `create.body.stream` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.stream\"}}` |\n| `create.body.provider` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.provider\"}}` |\n| `create.body.transforms` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.transforms\"}}` |\n| `create.body.extra_body` | `{\"$omitEmpty\":{\"$ref\":\"request.providerOptions.atlascloud-chat.extra_body\"}}` |\n| `agent.method` | `\"POST\"` |\n| `agent.path` | `\"/v1/chat/completions\"` |\n| `agent.contentType` | `\"application/json\"` |\n| `agent.body` | `{\"$merge\":[{\"$ref\":\"request.extra.agent.chatCompletion\"},{\"model\":{\"$ref\":\"request.model\"}}]}` |\n\n## Provider 扩展键\n\n- `providerOptions.atlascloud-chat.extra_body`\n- `providerOptions.atlascloud-chat.max_tokens`\n- `providerOptions.atlascloud-chat.provider`\n- `providerOptions.atlascloud-chat.response_format`\n- `providerOptions.atlascloud-chat.stream`\n- `providerOptions.atlascloud-chat.temperature`\n- `providerOptions.atlascloud-chat.tool_choice`\n- `providerOptions.atlascloud-chat.tools`\n- `providerOptions.atlascloud-chat.top_p`\n- `providerOptions.atlascloud-chat.transforms`\n\n动态模型或工作流允许使用文档声明的完整 `parameters/input/extra_body` 对象；该对象是协议本身的开放 schema，不会被宿主裁剪。\n\n## 响应映射逐字段清单\n\n| 映射位置 | 上游路径或转换表达式 |\n| --- | --- |\n| `response.status` | `\"succeeded\"` |\n| `response.textPaths[0]` | `\"choices.0.message.content\"` |\n| `response.textPaths[1]` | `\"choices.0.text\"` |\n| `response.reasoningPaths[0]` | `\"choices.0.message.reasoning_content\"` |\n| `response.usage` | `{\"$ref\":\"response.usage\"}` |\n| `response.errorPaths[0]` | `\"error.code\"` |\n| `response.messagePaths[0]` | `\"error.message\"` |\n| `agentResponse.textPaths[0]` | `\"choices.0.message.content\"` |\n| `agentResponse.textPaths[1]` | `\"choices.0.text\"` |\n| `agentResponse.reasoningPaths[0]` | `\"choices.0.message.reasoning_content\"` |\n| `agentResponse.toolCallsPath` | `\"choices.0.message.tool_calls\"` |\n| `agentResponse.toolCallIdPaths[0]` | `\"id\"` |\n| `agentResponse.toolCallNamePaths[0]` | `\"function.name\"` |\n| `agentResponse.toolCallArgumentsPaths[0]` | `\"function.arguments\"` |\n\n## 响应与错误\n\n插件把上游 task/status/text/media/usage 映射为统一结果。临时媒体 URL 标记为 ephemeral，由宿主立即下载持久化。HTTP 错误、业务 code 和 error object 保持失败语义，不包装成成功。\n\n## 兼容边界\n\n该插件实现该平台公开的 OpenAI Chat Completions 线协议 profile；平台专有字段通过 providerOptions 命名空间透传，未声明支持的 OpenAI 字段仍由模型 capability profile 校验。\n\n\n## Manifest 完整接口定义\n\n以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。\n\n```json\n{\n \"apiVersion\": \"yingce.plugin/v2\",\n \"id\": \"atlascloud-chat\",\n \"name\": \"Atlas Cloud Chat\",\n \"version\": \"2.0.0\",\n \"author\": \"Atlas Cloud / 影策\",\n \"description\": \"Atlas Cloud Chat 独立请求协议插件。\",\n \"documentation\": \"<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>\",\n \"permissions\": [\n \"generation.run\",\n \"media.read\"\n ],\n \"configuration\": {\n \"fields\": [\n {\n \"name\": \"apiKey\",\n \"type\": \"secret\",\n \"label\": \"API Key\",\n \"required\": true\n }\n ]\n },\n \"contributes\": {\n \"providers\": [\n {\n \"id\": \"atlascloud-chat\",\n \"label\": \"Atlas Cloud Chat\",\n \"capabilities\": [\n \"text\"\n ],\n \"scopes\": [\n \"admin.system-channel\",\n \"user.custom-channel\",\n \"canvas\",\n \"creation\",\n \"agent\"\n ],\n \"baseUrl\": \"https://api.atlascloud.ai\",\n \"requiresPublicMediaUrls\": false,\n \"auth\": {\n \"type\": \"bearer\",\n \"field\": \"apiKey\"\n },\n \"parameters\": [\n {\n \"name\": \"model\",\n \"type\": \"string\",\n \"required\": true,\n \"mapping\": \"model\",\n \"description\": \"上游模型 ID。\"\n },\n {\n \"name\": \"messages\",\n \"type\": \"message[]\",\n \"required\": true,\n \"mapping\": \"provider message container\",\n \"description\": \"包含历史消息和当前用户输入。\"\n },\n {\n \"name\": \"instructions\",\n \"type\": \"string\",\n \"required\": false,\n \"mapping\": \"system/instructions\",\n \"description\": \"系统指令。\"\n },\n {\n \"name\": \"temperature\",\n \"type\": \"number\",\n \"required\": false,\n \"mapping\": \"temperature\",\n \"description\": \"采样温度。\"\n },\n {\n \"name\": \"top_p\",\n \"type\": \"number\",\n \"required\": false,\n \"mapping\": \"top_p\",\n \"description\": \"核采样参数。\"\n },\n {\n \"name\": \"max_tokens\",\n \"type\": \"integer\",\n \"required\": false,\n \"mapping\": \"max_tokens/max_output_tokens\",\n \"description\": \"最大输出 token。\"\n },\n {\n \"name\": \"tools\",\n \"type\": \"array\",\n \"required\": false,\n \"mapping\": \"tools/toolConfig\",\n \"description\": \"工具定义。\"\n },\n {\n \"name\": \"tool_choice\",\n \"type\": \"object|string\",\n \"required\": false,\n \"mapping\": \"tool_choice\",\n \"description\": \"工具选择策略。\"\n },\n {\n \"name\": \"response_format\",\n \"type\": \"object\",\n \"required\": false,\n \"mapping\": \"response_format/text\",\n \"description\": \"结构化输出配置。\"\n },\n {\n \"name\": \"stream\",\n \"type\": \"boolean\",\n \"required\": false,\n \"mapping\": \"stream\",\n \"description\": \"流式开关；后台任务当前以最终响应归一。\"\n }\n ],\n \"create\": {\n \"method\": \"POST\",\n \"path\": \"/v1/chat/completions\",\n \"contentType\": \"application/json\",\n \"body\": {\n \"model\": {\n \"$ref\": \"request.model\"\n },\n \"messages\": {\n \"$ref\": \"request.messages\"\n },\n \"temperature\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.temperature\"\n }\n },\n \"top_p\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.top_p\"\n }\n },\n \"max_tokens\": {\n \"$omitEmpty\": {\n \"$coalesce\": [\n {\n \"$ref\": \"request.extra.max_tokens\"\n },\n {\n \"$ref\": \"request.providerOptions.atlascloud-chat.max_tokens\"\n }\n ]\n }\n },\n \"tools\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.tools\"\n }\n },\n \"tool_choice\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.tool_choice\"\n }\n },\n \"response_format\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.response_format\"\n }\n },\n \"stream\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.stream\"\n }\n },\n \"provider\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.provider\"\n }\n },\n \"transforms\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.transforms\"\n }\n },\n \"extra_body\": {\n \"$omitEmpty\": {\n \"$ref\": \"request.providerOptions.atlascloud-chat.extra_body\"\n }\n }\n }\n },\n \"agent\": {\n \"method\": \"POST\",\n \"path\": \"/v1/chat/completions\",\n \"contentType\": \"application/json\",\n \"body\": {\n \"$merge\": [\n {\n \"$ref\": \"request.extra.agent.chatCompletion\"\n },\n {\n \"model\": {\n \"$ref\": \"request.model\"\n }\n }\n ]\n }\n },\n \"response\": {\n \"status\": \"succeeded\",\n \"textPaths\": [\n \"choices.0.message.content\",\n \"choices.0.text\"\n ],\n \"reasoningPaths\": [\n \"choices.0.message.reasoning_content\"\n ],\n \"usage\": {\n \"$ref\": \"response.usage\"\n },\n \"errorPaths\": [\n \"error.code\"\n ],\n \"messagePaths\": [\n \"error.message\"\n ]\n },\n \"agentResponse\": {\n \"textPaths\": [\n \"choices.0.message.content\",\n \"choices.0.text\"\n ],\n \"reasoningPaths\": [\n \"choices.0.message.reasoning_content\"\n ],\n \"toolCallsPath\": \"choices.0.message.tool_calls\",\n \"toolCallIdPaths\": [\n \"id\"\n ],\n \"toolCallNamePaths\": [\n \"function.name\"\n ],\n \"toolCallArgumentsPaths\": [\n \"function.arguments\"\n ]\n }\n }\n ]\n }\n}\n```\n\n", + "permissions": [ + "generation.run", + "media.read" + ], + "configuration": { + "fields": [ + { + "name": "apiKey", + "type": "secret", + "label": "API Key", + "required": true + } + ] + }, + "contributes": { + "providers": [ + { + "id": "atlascloud-chat", + "label": "Atlas Cloud Chat", + "capabilities": [ + "text" + ], + "scopes": [ + "admin.system-channel", + "user.custom-channel", + "canvas", + "creation", + "agent" + ], + "baseUrl": "https://api.atlascloud.ai", + "requiresPublicMediaUrls": false, + "auth": { + "type": "bearer", + "field": "apiKey" + }, + "parameters": [ + { + "name": "model", + "type": "string", + "required": true, + "mapping": "model", + "description": "上游模型 ID。" + }, + { + "name": "messages", + "type": "message[]", + "required": true, + "mapping": "provider message container", + "description": "包含历史消息和当前用户输入。" + }, + { + "name": "instructions", + "type": "string", + "required": false, + "mapping": "system/instructions", + "description": "系统指令。" + }, + { + "name": "temperature", + "type": "number", + "required": false, + "mapping": "temperature", + "description": "采样温度。" + }, + { + "name": "top_p", + "type": "number", + "required": false, + "mapping": "top_p", + "description": "核采样参数。" + }, + { + "name": "max_tokens", + "type": "integer", + "required": false, + "mapping": "max_tokens/max_output_tokens", + "description": "最大输出 token。" + }, + { + "name": "tools", + "type": "array", + "required": false, + "mapping": "tools/toolConfig", + "description": "工具定义。" + }, + { + "name": "tool_choice", + "type": "object|string", + "required": false, + "mapping": "tool_choice", + "description": "工具选择策略。" + }, + { + "name": "response_format", + "type": "object", + "required": false, + "mapping": "response_format/text", + "description": "结构化输出配置。" + }, + { + "name": "stream", + "type": "boolean", + "required": false, + "mapping": "stream", + "description": "流式开关；后台任务当前以最终响应归一。" + } + ], + "create": { + "method": "POST", + "path": "/v1/chat/completions", + "contentType": "application/json", + "body": { + "model": { + "$ref": "request.model" + }, + "messages": { + "$ref": "request.messages" + }, + "temperature": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.temperature" + } + }, + "top_p": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.top_p" + } + }, + "max_tokens": { + "$omitEmpty": { + "$coalesce": [ + { + "$ref": "request.extra.max_tokens" + }, + { + "$ref": "request.providerOptions.atlascloud-chat.max_tokens" + } + ] + } + }, + "tools": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.tools" + } + }, + "tool_choice": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.tool_choice" + } + }, + "response_format": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.response_format" + } + }, + "stream": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.stream" + } + }, + "provider": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.provider" + } + }, + "transforms": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.transforms" + } + }, + "extra_body": { + "$omitEmpty": { + "$ref": "request.providerOptions.atlascloud-chat.extra_body" + } + } + } + }, + "agent": { + "method": "POST", + "path": "/v1/chat/completions", + "contentType": "application/json", + "body": { + "$merge": [ + { + "$ref": "request.extra.agent.chatCompletion" + }, + { + "model": { + "$ref": "request.model" + } + } + ] + } + }, + "response": { + "status": "succeeded", + "textPaths": [ + "choices.0.message.content", + "choices.0.text" + ], + "reasoningPaths": [ + "choices.0.message.reasoning_content" + ], + "usage": { + "$ref": "response.usage" + }, + "errorPaths": [ + "error.code" + ], + "messagePaths": [ + "error.message" + ] + }, + "agentResponse": { + "textPaths": [ + "choices.0.message.content", + "choices.0.text" + ], + "reasoningPaths": [ + "choices.0.message.reasoning_content" + ], + "toolCallsPath": "choices.0.message.tool_calls", + "toolCallIdPaths": [ + "id" + ], + "toolCallNamePaths": [ + "function.name" + ], + "toolCallArgumentsPaths": [ + "function.arguments" + ] + } + } + ] + } +} diff --git a/plugin-packages/generate-catalog.mjs b/plugin-packages/generate-catalog.mjs index 5383f2513..a8e1c976d 100644 --- a/plugin-packages/generate-catalog.mjs +++ b/plugin-packages/generate-catalog.mjs @@ -212,6 +212,7 @@ for (const [id, name, vendor, baseUrl] of [ ["fireworks-chat", "Fireworks Chat", "Fireworks AI", "https://api.fireworks.ai/inference"], ["nvidia-nim-chat", "NVIDIA NIM Chat", "NVIDIA", "https://integrate.api.nvidia.com"], ["openrouter-chat", "OpenRouter Chat", "OpenRouter", "https://openrouter.ai/api"], + ["atlascloud-chat", "Atlas Cloud Chat", "Atlas Cloud", "https://api.atlascloud.ai"], ["litellm-proxy-chat", "LiteLLM Proxy Chat", "LiteLLM", "http://127.0.0.1:4000"], ["newapi-chat", "NewAPI Chat", "NewAPI", "http://127.0.0.1:3000"], ["vllm-chat", "vLLM OpenAI-Compatible", "vLLM", "http://127.0.0.1:8000"],