From a77d83fe0ee40518aa057fa3e69f50538c72873a Mon Sep 17 00:00:00 2001 From: lyingbug Date: Wed, 14 Oct 2026 23:41:16 +0800 Subject: [PATCH] feat(search): add RRF controls in a tabbed settings popover (#4300) --- docs/assets/search-settings-rrf.png | Bin 0 -> 14399 bytes frontend/src/api/retrieval.ts | 3 + .../src/components/GlobalCommandPalette.vue | 62 +++- frontend/src/i18n/locales/en-US.ts | 9 + frontend/src/i18n/locales/ja-JP.ts | 9 + frontend/src/i18n/locales/ko-KR.ts | 9 + frontend/src/i18n/locales/ru-RU.ts | 9 + frontend/src/i18n/locales/zh-CN.ts | 9 + frontend/src/i18n/locales/zh-TW.ts | 9 + .../views/settings/RetrievalSettings.test.ts | 136 ++++++++ .../src/views/settings/RetrievalSettings.vue | 305 ++++++++++++------ 11 files changed, 444 insertions(+), 116 deletions(-) create mode 100644 docs/assets/search-settings-rrf.png create mode 100644 frontend/src/views/settings/RetrievalSettings.test.ts diff --git a/docs/assets/search-settings-rrf.png b/docs/assets/search-settings-rrf.png new file mode 100644 index 0000000000000000000000000000000000000000..ac525b76aa1ea015db8440ac0e261db6e931a473 GIT binary patch literal 14399 zcmdVBWmJ`KxArX|Asy1)2$B+#3X4)&5s*$%x?93UNvAZTh=?=@3n}SFL=dD)Lb_4v zo!tL>zx&zm81FNlJ@%*PgJUpYt>wDT^E&4|j^8}42u*b*f@?I_u3Wi7prVY>zH$XE z5B@RXpu=z6h~kQ_Tp_-qg1Gz8D|0=|yIyVN;-aQk#5gxYH3#b+Npktaf># zCj*&x>x58w{yvxlb0;}t%uZbN zpVkLbZqok9WJMBxVC1c}=#0_&5_*y|y)pg?uU!6=g_ZSJ)ivf4PU4!C6`LZdwwp$W z>pv~b&ApO`aG6Vl<3!pvT0-#Bgr5)!J4<+%%7w3ywh=_gue1zGS+OCBM+KGXBD>Z8ky-FuC+V1e^k=J=1!IjBgobL7V zH|={QaH!E3(~3OXUrf~4eVi*7Qf)s$NH5{GGv5x|oF(PGd%UyoN$)Yv96M(DMCB8W z;>Vv3w`MeIAAZo*kUhH<0W=bGWWwc{JrY^Ujo4rO>*J3IsF-8Gw!2C1J{`_Z=!ys7-$lkdvM_qt|M{D=yYFbit+NZ;qDdc zmKsk~+gFCgIeqDNH{5dnSz$%~*<<6`5$Vao3#~8tC)=$=YV0cblV-eHP3~(yGNte7!o{4Qow&}z?vA~_iy`%c zUebfATs|RAVKGW(=b7MHU9KU4*yQ$FX;VeySI5JF z%-du;3Uv0LQzDZkJsloP$b~<=Dpp$iDSDdv-P_&W{)WMd@>>qy^P?l$+*bzCIul#q zG%FLvsTLU43S}s3_om!@s*=xgKZUm-w_BO%$#HeTP{YymeGIwh?=^B{+<%i7TF%=p z8mwaHkV}gY+FfZ4BU%>D5DJp2Aj7f!!p?LxDlmbw)`kdnfsw~4X6^S?DjyXN%wEEN zpVfD-a0;|a9=s=%tMu4-+ynQN>m*Z_KJ}9p%N5-c!&)vUoX^5O`!@Jugm=q`>%tg( zY`PQJUtke@F4zhA{u1$gx100oHFBG=GG>vnC@TLQf9v#8( zDfkS-M^{nIqQh}mJ2N=tzI***0e^m7R?{RN-Ay<-T=W!%r=Q#vA}JKa8bsjKRrbHZ zVMfAP;xVol=f)u=52w%QPZ#0QD`VndIHVL(Dk}EgTk`sVsyU2$s()CzM*%q;*qtf&Ya!63)~LLY87Ntb)Kb{GtSRb9?j165}H%P+Sgt{;x*nnW|o zG8ho4u;7u<)7y{FHYC`!Te4c+MU?s+{C@g9-+eOgMroJHD?TGQ@qbp|=SY;?zfXfq zQihZE^mO=v#y4RtxeAu`cLuwa(}_|Z>s01SzgamrI83uDiRWps(Qq{-Xq)Q%%JGmgdFuc<1m_HiVluN9G-`T&rd&OLXx*QF9gi@q#(ALwN|nld7dWbI4xw=<0V{(?6dAm)oOa~f1}2J zB2@mF9Z#k{KA*W?frghC>Zz&#q3hP+gritSs>PCqUHL+s`lMOa(4pUA7s+(F{Y3RG z)&j~tTuN^3HcMm(vD^h82Q)z+ulK|)l*;S>`>x1TP9}GZ9+CBb@Y1-p_bHw2?a<-) z2HHtjuHxe1-OmuU_ww>Ol{F=0AxYTX9;kfsHCr}dx;AByRhge`PxjXby!`>GL6dM( zoSzk~uj}%Y2-EJvCPG8#Z#oQTgXVg*@yFQM*f6_ylzih^6t%E~9Ohk{lqnIb@6Jn; znNjX%A$k>oV_COdI}CL=513BWF;#4|Vr~2LThkMV*eMNFtYaQh5}T^taN-SS#w-^O z81acV-Bj6gv}CDOUQYPEPslh)GOvwf@)#XH?IuWLzfYmWCWb~_Ln=91g`@p_nO0v1WrMK*#0P@7Bt5k|J#DcuUTn3%4f{zv%+jV@yT|y z-rIHa)~56#QM|&nauNx*6{p=rmCc&eRI2prHy%3>?+|@{N8rhEm1c|$ z7d>ncpFt`$HkOc(PF$do2FvMqdk*?|z`=;_;vH{KiJCfw=f`t3(>{^sFN(0IKdWa+ zz%9GfK%Jw(x*cyCr+^Csw*lF60`NJx?UcF2Q7dcd5UZ=SE;k@=b#uB^G*3&!xoz z?H?8C3Euj)Ho!!^(p&GnmudM1R?~jGs`>p1Yzj2^?ljd*ac5|dMxWixO5=@Q2%Zhn zyJj1IOw4csi8xs^=@M}MhqExu@96hPq!An{MZ>s<4&!hghb!MOgtsRgn|?j06a#5F zmONQAJma%gjGMKHa$fL?yrEM#mcE=5(D?Y%Gtf5jJUP$*uFeEpOo^}Kj=UY$D_zpt z%Uy|Y|Az$BFxv|uuSk^?HEZ(bUJ+AYx|LCSC!KDD=u%VwA;h@|n-4m|d;B!E=qb?+9 z)`F=jy1$>{*y#N$Sr^r>scm7H8u%D)Q#*@I6^Htondh{OWd=14AV9q5BRK0D-g%Zc zY544aQ(7%{nEEVkWf#LB{r6zhQkZ!kMMR8n-r(wft z-AFNTz_p1bxzxtm;1kjlix7&6F0G|TbrhXsIaMyddJZ40Pd7-G#!Btt)Tt8qZUlXQ zuW@uJ-$gefs--NY#G8MdhB^H)1g~(pxM?9ql19`{{Mj&<#fEVb$h3!r4_DvRRXa@m zMmZSG9~c_Y4%gT^qlQz{29l9H@?CGhgCyZrnOV~$dMtLuqfx&A^Wr=JWw_KODlg!Tz`^^ z`?f~}E(NzXa)M~>#cNW+^>1&L;M=^ip$y`*45uA=*m$y8H|ce8e$>>z6fHI#{z~oE zHG{7cdls?M9sV&^Pev*~oMV+5^+8;+z)yQ-;@&8KW53gkxA7M{4*%R4ja=%;*okZkv9ma^MoF zyo#pT7Z6;JN6E)#iztYpIV45f?l?y(3w85)a6SH>uco3V;E0VdKw;xdV`FBJFg@1( z;@TGAoIvEjOcue4BW^b)ASIJ<#e-jrR*_NB<}`^tUff{mj_Pff3T4h(T{l;dZ^IYI z3$Za7E;|f1y9_(bJxgr(oYuEmf`eM=8(n_gTYL>_^;OX_>+7a`JF-{%X;Fef$UAu` zA#%`6A(mue?^LaSuCwo%lFp#YGo?b{ymha)EZx*8OyXWZca66fN_TFlskH1S&1cz< z(YR4g*4>i)w^%2ULv7pcVHx&+umD882)y;_9a=*wRkn=yF9|LQM173wOq(oyjEkmV z6hA#15fY`@Qtp~`7WU`Z3F8hDp&=m&(nogQdz?}i?^7ge$L?V9Kt-1-LQiLrU0Fuz z{CHvIwVIe@i8yI=MaHEvWFHN1N>&!}vK7~m=(Ji&!oi`M5s3FuPredxrzTT0wAht> z&L#JK$9qvT%?C^V(eB;GMdQ$tgf^&i#yLI-?g;!%{j*uWr`{H0Yr{`&hS`Gp)svhd zMU)0-` zIU$6H-2>r@{v)4sV9#Oxxb4EqR_Oecf(OHZ^hL}BR`_tRY$glPiXs_v_Y}mdB zzZJ^pB1@rsWJ$Qc87i`2_kIiwL2TNqwQ9278$=t8Ievm*TN%p_2Xf-3gaNh6yDzYQ z9+;~;nJXm~dTvcqr6SH$qa*Cz_^&vEJ1m#?{(k?5ui(-RX-VA#I8$Hw*ym_=|IWT3 zN>|HJ5OJ2zr%q6ashgb~p0MM+r)UfO@JzUtV+d5>3oHqNB>z_xW z7TwJpC%&|_*wNAY#$Z!#Q{~~rOL`TIN~b>46n0L+4M~6)p#0ln$PTfNpM6es5jddm zd8@IN#wMv3V@;4nnGxVL`7_utv3_u)W+q!%whjAU3h&dN)G<}9zB|gb3+E{vBrJb$ z=Da=7^7UEb?7vjvrKaGn&7P(8AQ;jq`u2uxT2EuKe`6AuImQTCQ<8=%lJn{bypGmd z4xC{dOf{8t=8_?Id?{`oI(Eu^RN27UZ8Y2JW1(s&7z5_fmrVN8#i|SkQHpv6Vt&Ug zeu0$z9^0RIfj%<7FTEOBuC)Rq-DzVb0`5C{X&5Uri`vK9;%0lz5%Y66WV6CQqvAAe zGz=4XSUhyo*}}7MvKL9~k`U&cd@48^(zQR%XV_{P$XM$0IzAQ#Op`RnJ#HtgTS)gw zU2(_I6&X2mxNFWC%#74>*~se{LS?!-BX-UBKGfE$|GukYK!TsE?=d>?*ke<1AZ-1v z5QmdLp>D!jw~m^70E)F2q+!L9Q!h%57b2eTe0t-^H??n z0!SBeNH9MfYgF`qZ(WcQXHh|VD=Wwpog=i62<^53=i(dqLAH0z&)1qsR9K?1m(x4L zD~@)8EMJ$)Qv_t_ zxjt47&CUcbVAOL1&{a0~gM7Q673>?1-%1l@CrMaFz}xwQ#B-SHOB3eY*gT-^BM=l6 zR3#!IA&HNVR}Tlbg1Sa`+l5V3R20Nb3{F--K>-SdGOTq8aZ74b4^P6%i1F3A=Xv|J zCooLrpPu(LapK>Y8qYS|Tje9;V|qo>DS9jqyf2R{jEIp#eL1{0v{(6*@AwdypftYAr60d5GD_f zaqNu(-uIzxN~sBpWR=sh;Sr_M*C_ciMQk5c)|$0qHHtcN63HCD7P|vSd+f3k$BQXMp!S+hcY7nqI0|Ymq_;131Ecl^1xJ~ z4iBgJquM05ISU`2tfqFOV{Ao7aA3<{a~wrw|E|3K?7o)nqN=J2A~Rn#O|Dk2-2Ck1 zi2rd_0c$Wvl|sAcl=~=vuZ<F1J_Gb93<&+>U;|mva?A3rou_ z-?o3YV>~b2t?~LTf*01_Dd9h`V8R&-w@5EgRyQ6F5KA$fyw|M*k$Ejfol)XiTYs z77m|RIX16i#y2be+!2g0>ANE5VX-z^8avgN6^nFE3^<+(b8I+B`5A(5wmO>v_Gd3y z*Z70>yO)1B1e){JGOT@Z^wiV%j6RPV`)*9ux>7yL4`sU#>tB{^9B}3?f!LxOrI6Qf zRxWQDYjZ)MX_dh3jGf8cV^t+|<>4oAui+e4cHOY-)N>s&^dirab|{Z+pd@rQDD>?J)o!1~8G+_~v2DL26-=<{h$x2td<=lD0!JS<>T z+UhTGhZ^{2 zC|RM8Th!%B0-9p#v6g(2(yAb0A}b*RxRawCoa@52xd%z*_FS)ZZC&FphwBLo(M`$&gJ`)(-A&6HOD&%5HL#rPM!J{0vx%zevm?r1S5~{-HM(1bD zOeyW&wVO4QazvMAtAl(;h9xjh6GShOdMX_b=jBWRi>}LN!Kmy>Lo%2Qx5@P}VAS>c z!il$Y{pZb}tQ$H;M}PmBe#Qs4+m}F2hTyB6+txVJe-;zHh@zg6sc|R;v6??Nzq5i} z%}i1;=8W-HW>Jq`Z0sw!rKcb_7)*kRm+1K^#mly>rMG?sGWMA6>mPj&j(oX4rq<{P z?V8naEUJr4k;0_*QxgvT{DjQ*7Yu8%7diXr=m_eq>oI|(w+X^~OP^TpI# z=3g)E`j{sSj9O9v+IQdNOvPIB<*E_7fPP*K1#?mtBO}x9W9*!%xXiq zW43mCvuM`v8d-AXZ;F{gyaJL@u_$A#+pagWuVqAe)RS4PF2ro#^BQO43U?NEnXh94 zpm>aT4H0yUE1wuk>r2T}e}+X*{2R4tPBk){){A$pl@WLM_h#B0qh8bwgt!1yRHY^w zUvI}0{-BqyInQd7s4w=yODiJdw3SE})2)kH6~;>r2anQC#ARUAg*Y1=g!x~F519&X zM|;_QRlDeZBWsSkquY$%4bv{Cio}V<;5fE3IxxH!18r|Xai%+l4!!_o4X{3J#7}+tbF;U}@9g*cuvUp5-lFmyG|J z>dMM!&LA!yO0y=E%4v|g|8YdJ@@Y!$*nwxvHrZC=311pE9bpIUcg}%Ce+K^61Sf)p zN`OCJq8M2C0)jRqY`L}Ni;VVZarK`HX==xe+znN|w`ZFNtX{O4ewBr3p(s%xU!2)7 zSOtL(V^utI#7x?sMN7=?9IOOU51rl#e$8Nx4D0HP5WYVf^?@{`rO|e@B+EID+EP@+ z?n?#}arZHZm|^Irb7v8>Dz|(DtYX-`TjJbWZ1Pol6F~CK6U*P(eaJywo6{3fH+Mer$)Azqw%SUh%xEb zXENso(xEp2@#4%zs%O{=IB}G$3Bfw4;U|H%QTOH}#N`a}BaDPxtOEF!p5XMQDF{T& z8byNU^BCM)M=EQDJ0kbR1X-9-QOs8(|D`DbT)m8laBj0|wOTaCnlU!#M7$*Z9bg`T zoD~{hw#Iq^5|y0Y|L;BsS}1%mD120)VaKt?brnoN?A+1%$J`C~g$zHBjp^}OC@Vc( zjUd(yTUl9wuRZT=M?U@^EMUZXAX7h}gbLr1E&TgjgZcN6Lbn+B?2kB}{56}a-`^)5 zg)NTqEE;z!3rMrsJNz^2HoqKm|9AEK|AzhF#krvMo&AEQgu`6I?y@{UZ+Tz3{sAcD z#g1$LWwic3{y&+e;B({aGeJT@F}xfP2AtQk@+rV<0a_q1*c4#2oNoKu>dYmCAWmVI z7k>b5b{*O@Zfc$+CL?RzCx$hrre3|I@Zlf7G{3-ZZE0~?>RSyTjClF-Wn?5Ua$RL5 zZfj1&y%%bn@9OAKZiaU*cR}THueaN`jo-Pw!ljJs?P|wAC%)XSYs{SUZZRl3RFq-g z?8N=cmvuEH#5?`J+kamJel?IITRLf5@x==NX?G0oKgk1jqW?4yk7}zY#~1-g^SpvQ zMcd2?3|fozE0^A2H*UA!d3@^!?hF%fS+DI`z`AFUG(f|{1&zFcDrx&Y^3lT3=|lqv z#Qw^+CYa}gEM2U`#;1zoH<1BN(XlbpB&(4vRj-{N2h$|*B@%LM*E^O$m*J6f#c`;m zBhm$Js7t_O5`pk_c`8R%2Xg~j&a_D1H82m5eptHU`qgo~s=Mm$`~THBkatdWL+M^2 z80@G`-5oUv@Skf50p-&Md6F6K{F4jLT9`fp*m+oLJT)<~v(Tv&O*2yU^Z}0t$bSX5 zxH7PA^X-w?ewgaXx*eJz zEWm$y40KgJTdKS5XM^w2_$S*=#}^%fZ-pJWg#$0^RlxaPPKZ&-so)MBvz!@Ny-R_)cZ5MCwGF652E>09OAlJV zvG=d*#?EeKH~t>1b&AgbvWKDjY&a74XLPYi({sQ$+b3~l5FKIB`Il5b_^u(Fd(Utm zZjxOq2w42e&v1B?J@I_J>S=Y@aWD7N4obR<22sc9Nf2wcPZSgtwa?E_wi@igkB0@N z30f%j9Or^C7de2XUBS~v+wd$Gz_hkq1 z2~U{D0PBj}>crt^j-;-CO(ZQ7j_Ub42&ca6RmcX4-}gtDQ^B|yEX*T7PV_!G_8E4k^NfR-pQrJxpGp= zaOtL@)gmjDxfy}hm}Uav>-o;sTc`y>CAND*WaOz@@a^Qx=ePcX9q?8#>Er02OnJ?{ z;7-HCD+9jZ&5M*P zBVeu$GyVB(S)NE5kv12?s@dr0{h(T~4T(c6WYO$xq-)F#7lR^ec3l}{Uf!Zh58APK zJ4YFk>IH*DaM?E)4-=5Q9S^<=^gr<^x{;8Z&%oM+ zwd!=e80|VEJ|DiKpAMqOK!XO2m86xxzMb>k5~PvjGE^(U#M9M%9VS~B;3k)Pv~LT+ zfU#7FMzlBh z+Qwt1n7pNJ?}m=o%HeVCgeKQb68<2C;?WaQJt&=#fPUs~YTpU8ldeuKug+|08bF$s z;`Xr*U&;8kI|RBMa=jg8QpPAb?-1@ zKURKSjEEr3UpKtQ7R6;5IJeZ_Jx-$({<>LW!CFvXs1;7fOLA_PZyjxZ+5U(6o1M(^ zp<~zaSV-g=6$@x3f*Y9#V1)Y-R?}!fzJSm-j6Vv8ru!P1rTb(%*WKyE)W_l(5mM%{ zm^iCA*Dx`uDGCa?Ga9_|^E9KMMEB`Ha>`j4cX8?VTp;`XMFVQSM-m#D;$}UTnJ;hy zQbXJyP0iE#M1*mNpt!`jU?2moD`cUE+JTt6`M5v4svclVl%50i?XtTGZJ)xsl#Vv1 zy8ZUrG1uh~am?CPxiU{_I>~C1t}tTnUiD?Aj5#U7@lot5!i(^B>=7?qDu0)n3HD{5 zA!KE^P$#m%=9bDwAO-1vf#86{ay_3BcUT&AFlR8{wcB_}X7J+hrao`S?VxoO2uRFypS046viz-9d6^GdBRTvD^#`3&@)RKlyQP0p0AVpb568wo935F7 zZj~-FDqkn@p_P5^2NWgPWI`>tB_)qN(IcvM1RUrT*dyGuf+HAPa4ul)~=#l zFWwsMrI8aSLRo<4turF+WPi04q2A0Z6b;0t+#*b$bPFYD+i8R}C1UfDZ|fkzbv= zS>|bnT)p-aaY@*ir*c@FwbRCM=XlsWx|NkF9}wLq{wH(6eGdeVasU}CX>c#qwq9IY z{1|Th8)C%axuP5!HQ!q?mH?H1>CW79&J^Wv&5QSHmx|Log#e+TaC=^87TpD~r4VyD z8OytfsHmvO$i!)OYCd|(!BdADURC>u@Q?CtZu`K=oZEz+3>3-g;$sPswyka(m#@m{ zNGO?ew&@`2UKt!g-OoLbo6L#xWoK>PkE^N$&Mln{b2 zx3GX3{QnV@m+J9p*(ypG)FXxuB?SdVg8zHW5KxaxSEoNFZ3@l7COO-^kcBY=;-$;+ zw%NZmW!qM;BR}k%0`t*5#TJrR1h3*Fsr`I!N|UfC+y?pUQreCFN-&RIvf`fz&#O0( z*mN8z)PZHQEX!3XRM?UGu^G8I7asTgDil2%>6W=jJ~WR&u{6fDodAqKLG*Saoy7{*#a zCR30Pfei=i-#Rps$`x*`Kr{^K>dTlx-%tQ&_kR4NLXCaL<-E*hH>Mlv?gXJf9m-S5 zqi#)zTI?5_Sr2EzQCp|rH@3@MEGsKB0Eq)Bm$$Phu|2?#su>`V$@vV$0is&FLcvy! zs7b_T^b>d(CGIpWSNe}w=s!>j;!R4mZo zy`_FwnTDMXTA+P>b-UX zQ~X$rsh_ze@EJ*{Q^o&U*vr4wxK>i<)d_Rx|EgBeoLB{Xs6Y0FU*_hF>O4+Gqg?a7 z*D-n^YVsgQ#{b!H!CW{3S8e@qwOzNTsn{0KY6zA6>Waspu24)1;xB@VOCAd8+NVQo zTYOQd;H!A!YIfzY577Rmlr2F35Njf_K0#hb1pQ^(>%vhaXH(UN_LDQO3#qG2<;hNya01u`N7)g*0;CVg!H68Y8*`rdtp}5 zyZ#qYZdtLY!{iw3gs!nSWF~L)-5z$8wTS%5fS&R|Na@>ohMWlh8=nx z*FtaPo508S8Gn|Gv?l@#t>hi=WsoTC>%pl->~N`Vt^R&;C>oKB$SS*3wyJwed^RJ6 z*X0R)S?;Vm-Gj+UyQ&?!ko)i9)gQ&QX4DZz^Pt11g{}MMhRQ8Ep;2N@mDi#6oHs8c zN3e@kwxghA+`$#OP2!gmG_;3(!CXq7S|mnRK&H_8JE}F{bO*asyqJtb^>x5xH-Kpu z^n#&1kYs(rU;SWhAo$r@xI9`-^7hIV?7_=t1pJ@sSJ`|kZTwrPlE?v4fV&5ojn?++tUeDxD`d8q3+dIT!Z}wJut`ooSb5O81~(K|LGQK;=o53+%(%j@f?YgMEZmSd`5E zpnMW_hy9!j zKb+6{K?qG?jp>V5k_&J;3s+k8Rzpxj>d~axQk4f^!F5M9453Ok)#%ZB`w3B&P{cl! zd}gs&p|Wb5<>NT5e`#koAxPsPsv#k@$XNeG`FIPGo#l+OUIx6eku@F2jr#J%OTIjZ zlErnJr2F_Up6`idjU0~`sD#UXPd)x2SY>J4Wl0cI-{Xy-SOvN4~DxAk9 z`3fD^0tbuAVLG#@*cs_WmlT=Np4Wtrn1{McIv8aTMJ)Pud~wssv|Kdk{Y()3 z?($57^d-F1FMw5KjBo}rFw6UyT~g(-hZwkT5u3{Zh*Mj@>2-G`JZI7Q>~rv}#nlT{ zO+CYxV&Ua=49r8#5%#e?>sIfizz&xa$~}|b(d#$bS;iq9;c-qy3-0x zw|=J)e><@V9#P*jP6y%+B3yz@`~)iN0g4FX3acjsjOJ$lh;kOI8~r?QzQ0u>(telv za8bUv&5-=`f%eA&TKy21TE@~#rr=z?ie6H1Inxt(9o4KXdL?b)KKnE4M^*KE1Cn{H znq(|KePMYrsyTWg^)BY03{}~)E6TU}RLpUOQv3Ka(OoF(xx20061muX!i*wT!!o{L zmp{2oEyCpc=aQvYC#zD7;jm|QYL3d-K`RGsWO&9^E|2CcVyt|FTQS?t(DSGc$@})a zEG#S{Mp9RE^r<6bn;l8dthII&Mj7zipa^t z1-=~%uGbl|kQItwRuYMI0miHQ?Vzn1OXcOA`N8;QQfVY$c!(=SADl$Ha&gxIp$;@+~dO zf7`f!a!Vt)HZ|qrg`NjYpp4|2&=y-?<8c%>e@M5^d$G}D>2~esvLsLAlN@y?DQ0(G=3Vs|ui_@7Q_TWpX9J23^Kp-AI zOk(B3fS7~e><5+z*8kA`(b38O=>9nP1g*zDENvq}k|_mb#`cigJy?F(d`B^uC-kW2 zI-VDnlfY%j;u+Y+rM3t%K&^zUVT+9+lRVV8^KQ)Er4&FuTPV4#|9_vO`X8Hs|9m>@ zt{#jzE+5_!!7)lb|DlZIJoREQ1Vm;J2|N%+gXH7o;OO}Gk9JTCgf{>EWEiC=^dvG) zbuJf9B#Q6uWSlsX&%QbMD&RAp-kUX+&_!X`aQWyMe;jhEDc}MwwZ>s8{SeUD4DdZ2 zxcWX=0-$L0%t+-k)9<-%@EiRKOWYL0amX-h)d5uDZ9u + :close-on-esc="!settingsVisible" destroy-on-close class="cmdk-dialog" @close="handleClose" @opened="onDialogOpened">
@@ -19,11 +19,24 @@ - - - + + @@ -130,7 +143,7 @@ {{ t('commandPalette.empty.askAi') }} - + {{ t('commandPalette.empty.adjustRetrieval') }} @@ -150,11 +163,6 @@
- - - -
@@ -205,7 +213,7 @@ const { agentsEnabled: () => deploymentCapabilities.isSupported('agents'), }) -const drawerVisible = ref(false) +const settingsVisible = ref(false) const inputRef = ref(null) const scrollRef = ref(null) @@ -499,6 +507,11 @@ const shortcutFor = (flatIndex: number): number | undefined => { } const onKeyDown = (e: KeyboardEvent) => { + if (settingsVisible.value && e.key === 'Escape') { + e.preventDefault() + settingsVisible.value = false + return + } if (e.key === 'ArrowDown') { e.preventDefault() moveSelection(1) @@ -542,7 +555,7 @@ const onInputKeyDown = (e: KeyboardEvent) => { } const handleClose = () => { - drawerVisible.value = false + settingsVisible.value = false commandPaletteStore.closePalette() } @@ -599,7 +612,7 @@ watch(open, (val) => { } else { clearResults() query.value = '' - drawerVisible.value = false + settingsVisible.value = false activeKbScope.value = null } }) @@ -860,9 +873,24 @@ onUnmounted(() => { } } -.cmdk-retrieval-drawer { - .section-header { - font-weight: 600; - } +.cmdk-settings-popover { + position: relative; + width: min(420px, calc(100vw - 32px)); + max-height: min(680px, calc(100dvh - 140px)); + overflow-y: auto; + overscroll-behavior: contain; + box-sizing: border-box; + padding: 12px 14px 14px; + &__close { position: absolute; top: 12px; right: 12px; } +} + + + diff --git a/frontend/src/i18n/locales/en-US.ts b/frontend/src/i18n/locales/en-US.ts index e70ee24b..e283b0e0 100755 --- a/frontend/src/i18n/locales/en-US.ts +++ b/frontend/src/i18n/locales/en-US.ts @@ -2563,6 +2563,15 @@ export default { } }, retrievalSettings: { + recallTab: 'Recall', + rerankTab: 'Reranking', + rrfTitle: 'Result fusion (RRF)', + rrfKLabel: 'RRF smoothing constant (K)', + rrfKDescription: 'Larger values reduce the advantage of top-ranked results. Default: 60; 0 uses the default.', + rrfVectorWeightLabel: 'RRF vector weight', + rrfVectorWeightDescription: 'Controls the contribution of vector search to merged results. Default: 0.7; 0 uses the default. Weights do not need to sum to 1.', + rrfKeywordWeightLabel: 'RRF keyword weight', + rrfKeywordWeightDescription: 'Controls the contribution of keyword search to merged results. Default: 0.3; 0 uses the default. Weights do not need to sum to 1.', title: 'Search Settings', description: 'Configure global retrieval parameters for knowledge search and message search', embeddingTopKLabel: 'Vector Search Top K', diff --git a/frontend/src/i18n/locales/ja-JP.ts b/frontend/src/i18n/locales/ja-JP.ts index 9d6a2a34..91128ef4 100644 --- a/frontend/src/i18n/locales/ja-JP.ts +++ b/frontend/src/i18n/locales/ja-JP.ts @@ -2563,6 +2563,15 @@ export default { } }, retrievalSettings: { + recallTab: '検索候補', + rerankTab: '再ランキング', + rrfTitle: '結果の統合(RRF)', + rrfKLabel: 'RRF 平滑化定数 (K)', + rrfKDescription: '値が大きいほど上位の検索結果の優位性が小さくなります。既定値は 60。0 は既定値を使用します。', + rrfVectorWeightLabel: 'RRF ベクトル重み', + rrfVectorWeightDescription: '統合結果に対するベクトル検索の影響を調整します。既定値は 0.7。0 は既定値を使用します。重みの合計を 1 にする必要はありません。', + rrfKeywordWeightLabel: 'RRF キーワード重み', + rrfKeywordWeightDescription: '統合結果に対するキーワード検索の影響を調整します。既定値は 0.3。0 は既定値を使用します。重みの合計を 1 にする必要はありません。', title: '検索設定', description: 'ナレッジベース検索とメッセージ検索に共通する検索パラメータを設定します', embeddingTopKLabel: 'ベクトル検索のTop K', diff --git a/frontend/src/i18n/locales/ko-KR.ts b/frontend/src/i18n/locales/ko-KR.ts index abb6ac76..60670f11 100755 --- a/frontend/src/i18n/locales/ko-KR.ts +++ b/frontend/src/i18n/locales/ko-KR.ts @@ -5606,6 +5606,15 @@ export default { howToEnable: '지식 그래프를 활성화하는 방법?' }, retrievalSettings: { + recallTab: '검색 후보', + rerankTab: '재순위 지정', + rrfTitle: '결과 통합 (RRF)', + rrfKLabel: 'RRF 평활 상수 (K)', + rrfKDescription: '값이 클수록 상위 검색 결과의 우위가 줄어듭니다. 기본값은 60이며, 0은 기본값을 사용합니다.', + rrfVectorWeightLabel: 'RRF 벡터 가중치', + rrfVectorWeightDescription: '통합 결과에 대한 벡터 검색의 영향을 조정합니다. 기본값은 0.7이며, 0은 기본값을 사용합니다. 가중치의 합이 1일 필요는 없습니다.', + rrfKeywordWeightLabel: 'RRF 키워드 가중치', + rrfKeywordWeightDescription: '통합 결과에 대한 키워드 검색의 영향을 조정합니다. 기본값은 0.3이며, 0은 기본값을 사용합니다. 가중치의 합이 1일 필요는 없습니다.', title: '검색 설정', description: '전역 검색 파라미터를 설정합니다. 지식베이스 검색과 메시지 검색이 이 설정을 공유합니다', embeddingTopKLabel: '벡터 검색 Top K', diff --git a/frontend/src/i18n/locales/ru-RU.ts b/frontend/src/i18n/locales/ru-RU.ts index 591a063a..c3aa7aeb 100755 --- a/frontend/src/i18n/locales/ru-RU.ts +++ b/frontend/src/i18n/locales/ru-RU.ts @@ -5606,6 +5606,15 @@ export default { howToEnable: 'Как включить граф знаний?' }, retrievalSettings: { + recallTab: 'Отбор', + rerankTab: 'Переранжирование', + rrfTitle: 'Объединение результатов (RRF)', + rrfKLabel: 'Константа сглаживания RRF (K)', + rrfKDescription: 'Чем больше значение, тем меньше преимущество первых результатов. По умолчанию: 60; 0 использует значение по умолчанию.', + rrfVectorWeightLabel: 'Вес векторного поиска RRF', + rrfVectorWeightDescription: 'Влияние векторного поиска на объединённые результаты. По умолчанию: 0.7; 0 использует значение по умолчанию. Сумма весов не обязана равняться 1.', + rrfKeywordWeightLabel: 'Вес поиска по ключевым словам RRF', + rrfKeywordWeightDescription: 'Влияние поиска по ключевым словам на объединённые результаты. По умолчанию: 0.3; 0 использует значение по умолчанию. Сумма весов не обязана равняться 1.', title: 'Настройки поиска', description: 'Настройте глобальные параметры поиска, общие для поиска по знаниям и сообщениям', embeddingTopKLabel: 'Векторный поиск Top K', diff --git a/frontend/src/i18n/locales/zh-CN.ts b/frontend/src/i18n/locales/zh-CN.ts index 79e7bbe7..38c5d300 100755 --- a/frontend/src/i18n/locales/zh-CN.ts +++ b/frontend/src/i18n/locales/zh-CN.ts @@ -5608,6 +5608,15 @@ export default { howToEnable: '如何启用知识图谱?' }, retrievalSettings: { + recallTab: '召回', + rerankTab: '重排序', + rrfTitle: '结果融合(RRF)', + rrfKLabel: 'RRF 平滑常数 (K)', + rrfKDescription: '值越大,排名靠前结果的优势越小。默认 60;设为 0 使用默认值。', + rrfVectorWeightLabel: 'RRF 向量权重', + rrfVectorWeightDescription: '控制向量检索对融合结果的影响。默认 0.7;设为 0 使用默认值。两项权重之和无需等于 1。', + rrfKeywordWeightLabel: 'RRF 关键词权重', + rrfKeywordWeightDescription: '控制关键词检索对融合结果的影响。默认 0.3;设为 0 使用默认值。两项权重之和无需等于 1。', title: '搜索设置', description: '配置知识库搜索和消息搜索的全局检索参数', embeddingTopKLabel: '向量检索数量 (Top K)', diff --git a/frontend/src/i18n/locales/zh-TW.ts b/frontend/src/i18n/locales/zh-TW.ts index ca069c27..c61831d6 100644 --- a/frontend/src/i18n/locales/zh-TW.ts +++ b/frontend/src/i18n/locales/zh-TW.ts @@ -5608,6 +5608,15 @@ export default { howToEnable: '如何啟用知識圖譜?' }, retrievalSettings: { + recallTab: '召回', + rerankTab: '重排序', + rrfTitle: '結果融合(RRF)', + rrfKLabel: 'RRF 平滑常數 (K)', + rrfKDescription: '值越大,排名靠前結果的優勢越小。預設 60;設為 0 使用預設值。', + rrfVectorWeightLabel: 'RRF 向量權重', + rrfVectorWeightDescription: '控制向量檢索對融合結果的影響。預設 0.7;設為 0 使用預設值。兩項權重之和無需等於 1。', + rrfKeywordWeightLabel: 'RRF 關鍵詞權重', + rrfKeywordWeightDescription: '控制關鍵詞檢索對融合結果的影響。預設 0.3;設為 0 使用預設值。兩項權重之和無需等於 1。', title: '搜尋設定', description: '設定知識庫搜尋和訊息搜尋的全局檢索參數', embeddingTopKLabel: '向量檢索數量 (Top K)', diff --git a/frontend/src/views/settings/RetrievalSettings.test.ts b/frontend/src/views/settings/RetrievalSettings.test.ts new file mode 100644 index 00000000..11c48474 --- /dev/null +++ b/frontend/src/views/settings/RetrievalSettings.test.ts @@ -0,0 +1,136 @@ +import assert from 'node:assert/strict' +import { readFileSync } from 'node:fs' +import { test } from 'node:test' +import { runInNewContext } from 'node:vm' +import { compileScript, parse } from '@vue/compiler-sfc' +import ts from 'typescript' +import * as vue from 'vue' + +const source = readFileSync(new URL('./RetrievalSettings.vue', import.meta.url), 'utf8') +const { descriptor } = parse(source) +const script = compileScript(descriptor, { id: 'retrieval-settings-test' }).content +const compiled = ts.transpileModule(script, { + compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2022 }, +}).outputText + +const baseConfig = { + embedding_top_k: 50, + vector_threshold: 0.15, + keyword_threshold: 0.3, + rerank_top_k: 10, + rerank_threshold: 0.2, + rerank_model_id: 'existing-model', +} + +type RrfField = 'rrf_k' | 'rrf_vector_weight' | 'rrf_keyword_weight' +type SettingsState = { + localConfig: Record + handleParamChange: () => void + handleRrfChange: (field: RrfField, value: number | string) => void +} + +async function editConfig( + config: Record, + edit: (state: SettingsState) => void, + canEdit = true, +) { + let mounted: (() => Promise) | undefined + const timers = new Map void>() + let timerID = 0 + const setTimeout = (callback: () => void) => { + timers.set(++timerID, callback) + return timerID + } + const clearTimeout = (id: number) => timers.delete(id) + const writes: Record[] = [] + const mocks: Record = { + vue: { ...vue, onMounted: (callback: () => Promise) => { mounted = callback } }, + 'tdesign-vue-next': { MessagePlugin: { success() {}, error() {} } }, + 'vue-i18n': { useI18n: () => ({ t: (key: string) => key }) }, + '@/components/ModelSelector.vue': {}, + '@/stores/auth': { useAuthStore: () => ({ hasRole: () => canEdit }) }, + '@/api/retrieval': { + getTenantRetrievalConfig: async () => ({ data: config }), + updateTenantRetrievalConfig: async (body: Record) => { + // Exercise the JSON serialization used for the PUT request. + writes.push(JSON.parse(JSON.stringify(body))) + return { data: body } + }, + }, + } + const sandbox = { + exports: {} as { default: { setup: (props: object, ctx: object) => SettingsState } }, + require: (name: string) => { + assert.ok(name in mocks, `Unexpected component import: ${name}`) + return mocks[name] + }, + console, setTimeout, clearTimeout, window: { setTimeout, clearTimeout }, + } + runInNewContext(compiled, sandbox) + const state = sandbox.exports.default.setup({}, { expose() {} }) + assert.ok(mounted) + await mounted() + assert.equal(writes.length, 0, 'loading the config must not save it') + for (const [id, callback] of timers) { + timers.delete(id) + callback() + } + edit(state) + for (const [id, callback] of timers) { + timers.delete(id) + callback() + } + await Promise.resolve() + return writes +} + +for (const [name, rrf] of [ + ['custom RRF parameters', { rrf_k: 90, rrf_vector_weight: 0.2, rrf_keyword_weight: 0.8 }], + ['omitted RRF parameters', {}], + ['explicit zero RRF parameters', { rrf_k: 0, rrf_vector_weight: 0, rrf_keyword_weight: 0 }], +] as const) { + test(`editing Top K preserves ${name} in the serialized PUT body`, async () => { + const config = { ...baseConfig, ...rrf } + const writes = await editConfig(config, state => { + state.localConfig.embedding_top_k = 25 + state.handleParamChange() + }) + assert.equal(writes.length, 1) + assert.deepEqual(writes[0], { ...config, embedding_top_k: 25 }) + }) +} + +for (const [field, value] of [ + ['rrf_k', 90], + ['rrf_vector_weight', 1.25], + ['rrf_keyword_weight', 0.45], +] as const) { + test(`editing ${field} saves the new value and preserves the other settings`, async () => { + const config = { ...baseConfig, rrf_k: 75, rrf_vector_weight: 0.85, rrf_keyword_weight: 0.15 } + const writes = await editConfig(config, state => state.handleRrfChange(field, value)) + assert.deepEqual(writes, [{ ...config, [field]: value }]) + }) +} + +test('RRF edits coalesce into one save and zero selects the server default', async () => { + const writes = await editConfig(baseConfig, state => { + state.handleRrfChange('rrf_k', 80) + state.handleRrfChange('rrf_k', 0) + state.handleRrfChange('rrf_vector_weight', 0) + state.handleRrfChange('rrf_keyword_weight', 0) + }) + assert.deepEqual(writes, [{ ...baseConfig, rrf_k: 0, rrf_vector_weight: 0, rrf_keyword_weight: 0 }]) +}) + +test('cleared, invalid and fractional K inputs do not overwrite saved values', async () => { + const writes = await editConfig({ ...baseConfig, rrf_k: 75, rrf_vector_weight: 0.8 }, state => { + for (const value of ['', -1, NaN, Infinity]) state.handleRrfChange('rrf_vector_weight', value) + state.handleRrfChange('rrf_k', 1.5) + }) + assert.deepEqual(writes, []) +}) + +test('non-admins cannot change RRF configuration', async () => { + const writes = await editConfig(baseConfig, state => state.handleRrfChange('rrf_k', 90), false) + assert.deepEqual(writes, []) +}) diff --git a/frontend/src/views/settings/RetrievalSettings.vue b/frontend/src/views/settings/RetrievalSettings.vue index 401d3765..c7de474d 100644 --- a/frontend/src/views/settings/RetrievalSettings.vue +++ b/frontend/src/views/settings/RetrievalSettings.vue @@ -1,115 +1,146 @@