From 2b18fe99918f7ff2df5cdb8951c520544d74c790 Mon Sep 17 00:00:00 2001 From: wintsa <770775984@qq.com> Date: Tue, 17 Mar 2026 12:05:22 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/settings.local.json | 15 + .codex-import-smoke.zw | 2 - .codex-roundtrip.zw | Bin 13010 -> 0 bytes .serena/.gitignore | 2 - .serena/project.yml | 136 ---- AGENTS.md | 383 ----------- CLAUDE.md | 115 ++++ XUQIU.md | 0 et --hard 9c11604 | 54 -- src/App.vue | 25 +- src/components/{views => ht}/Ht.vue | 0 .../{views => ht}/HtAdditionalWorkFee.vue | 2 +- .../{views => ht}/HtConsultCategoryFactor.vue | 2 +- .../{views => ht}/HtFeeRateMethodForm.vue | 6 +- .../{views => ht}/HtMajorFactor.vue | 2 +- src/components/{views => ht}/HtReserveFee.vue | 2 +- src/components/{views => ht}/htCard.vue | 27 +- src/components/{views => ht}/htInfo.vue | 2 +- src/components/{views => ht}/zxFw.vue | 2 +- .../HourlyPricingPane.vue | 2 +- .../InvestmentScalePricingPane.vue | 0 .../LandScalePricingPane.vue | 0 .../WorkloadPricingPane.vue | 2 +- .../{common => shared}/HourlyFeeGrid.vue | 0 .../{common => shared}/HtFeeGrid.vue | 0 .../{common => shared}/HtFeeMethodGrid.vue | 0 .../MethodUnavailableNotice.vue | 0 .../ServiceCheckboxSelector.vue | 0 src/components/shared/WorkContentGrid.vue | 320 +++++++++ .../{common => shared}/XmFactorGrid.vue | 0 .../{common => shared}/xmCommonAgGrid.vue | 0 src/components/views/HomeEntryView.vue | 258 ++++--- .../views/HtFeeMethodTypeLineView.vue | 54 +- src/components/views/ProjectWorkspaceView.vue | 2 +- src/components/views/ZxFwView.vue | 39 +- .../{views => xm}/XmConsultCategoryFactor.vue | 2 +- .../{views => xm}/XmMajorFactor.vue | 4 +- src/components/{views => xm}/info.vue | 35 +- src/components/{views => xm}/xmCard.vue | 12 +- src/components/{views => xm}/xmInfo.vue | 2 +- src/layout/tab.vue | 641 +++--------------- src/lib/workspace.ts | 16 +- src/pinia/Plugin/indexdb.ts | 18 + src/pinia/tab.ts | 29 +- src/sql.ts | 154 +++++ tsconfig.tsbuildinfo | 2 +- 46 files changed, 1061 insertions(+), 1308 deletions(-) create mode 100644 .claude/settings.local.json delete mode 100644 .codex-import-smoke.zw delete mode 100644 .codex-roundtrip.zw delete mode 100644 .serena/.gitignore delete mode 100644 .serena/project.yml delete mode 100644 AGENTS.md create mode 100644 CLAUDE.md create mode 100644 XUQIU.md delete mode 100644 et --hard 9c11604 rename src/components/{views => ht}/Ht.vue (100%) rename src/components/{views => ht}/HtAdditionalWorkFee.vue (90%) rename src/components/{views => ht}/HtConsultCategoryFactor.vue (96%) rename src/components/{views => ht}/HtFeeRateMethodForm.vue (97%) rename src/components/{views => ht}/HtMajorFactor.vue (96%) rename src/components/{views => ht}/HtReserveFee.vue (90%) rename src/components/{views => ht}/htCard.vue (94%) rename src/components/{views => ht}/htInfo.vue (90%) rename src/components/{views => ht}/zxFw.vue (99%) rename src/components/{views/pricingView => pricing}/HourlyPricingPane.vue (87%) rename src/components/{views/pricingView => pricing}/InvestmentScalePricingPane.vue (100%) rename src/components/{views/pricingView => pricing}/LandScalePricingPane.vue (100%) rename src/components/{views/pricingView => pricing}/WorkloadPricingPane.vue (99%) rename src/components/{common => shared}/HourlyFeeGrid.vue (100%) rename src/components/{common => shared}/HtFeeGrid.vue (100%) rename src/components/{common => shared}/HtFeeMethodGrid.vue (100%) rename src/components/{common => shared}/MethodUnavailableNotice.vue (100%) rename src/components/{views => shared}/ServiceCheckboxSelector.vue (100%) create mode 100644 src/components/shared/WorkContentGrid.vue rename src/components/{common => shared}/XmFactorGrid.vue (100%) rename src/components/{common => shared}/xmCommonAgGrid.vue (100%) rename src/components/{views => xm}/XmConsultCategoryFactor.vue (96%) rename src/components/{views => xm}/XmMajorFactor.vue (93%) rename src/components/{views => xm}/info.vue (87%) rename src/components/{views => xm}/xmCard.vue (68%) rename src/components/{views => xm}/xmInfo.vue (70%) diff --git a/.claude/settings.local.json b/.claude/settings.local.json new file mode 100644 index 0000000..4c27dbb --- /dev/null +++ b/.claude/settings.local.json @@ -0,0 +1,15 @@ +{ + "permissions": { + "allow": [ + "Skill(update-config)", + "Bash(mv views/Ht.vue views/htCard.vue views/htInfo.vue views/HtAdditionalWorkFee.vue views/HtConsultCategoryFactor.vue views/HtFeeRateMethodForm.vue views/HtMajorFactor.vue views/HtReserveFee.vue ht/)", + "Bash(mv views/xmCard.vue views/xmInfo.vue views/info.vue views/XmMajorFactor.vue views/XmConsultCategoryFactor.vue xm/)", + "Bash(mv views/pricingView/HourlyPricingPane.vue views/pricingView/InvestmentScalePricingPane.vue views/pricingView/LandScalePricingPane.vue views/pricingView/WorkloadPricingPane.vue pricing/)", + "Bash(mv common/HourlyFeeGrid.vue common/HtFeeGrid.vue common/HtFeeMethodGrid.vue common/MethodUnavailableNotice.vue common/XmFactorGrid.vue common/xmCommonAgGrid.vue views/ServiceCheckboxSelector.vue views/WorkContentGrid.vue shared/)", + "Bash(rmdir views/pricingView common)", + "Bash(cd:*)", + "Bash(bun run:*)", + "Bash(grep:*)" + ] + } +} diff --git a/.codex-import-smoke.zw b/.codex-import-smoke.zw deleted file mode 100644 index 8e1be18..0000000 --- a/.codex-import-smoke.zw +++ /dev/null @@ -1,2 +0,0 @@ -JGJSZW #WgtK_G;wf)Au:퇼!PY2Z[B[ߺ mFSs;eQqd;gf}DF`4ѼI{K1Nr|[jȄ(YX9?2Hv^0dL6gNvZ~?mq^#ʎIm ,Hu?[. P5BM8PG.dgP>fl: +ql -:ՠ#TZ8]X((WVgI\?ۣsQ k X6鴦?אi+\pcLX;ҹw,q2$ą< ^A Sc\>rp-Ap7F@8jco Hڱa9 5u ^da-̡.% N~δIݳtIVnpIikcJ>vMp2g|p5%>M>-~J}zn_2$`%lRi(9@cXW0R6#f=Q!F1eN z^ia^xlF84SGPtTeu0w6CK4Hki(JRDA!tSK5Z4n6|VmpdXdd6A{+mSFVo8* zd1RlC-pDQA7p|wWSE65WG@^K@EkzV7c`2ZMNrs8+I`uB5lpXO-vaU09NCbzsh!$%^ zSE;Z&y_m*xE4?iRmL@-;i0>{xaLjBWc)k?*sY``OH(5~ES3Q=1(!$_cl;k4`2Qu{< zg5&d@qxW}N&=5Jo7#8dbXgfSH!d3oYx?*lfb=Z_LETPC0{`ME`YK)nwCgpAW;}MGK zhzVr%d1X{$aRKcOLmsQRwtbAfkuUKVtG}3!YRXZT*0OJA-2IrRXbl5niR{GWwD=`c z&jTV5X%9aQ1cMf7b=dpkt-B;-X@uz{e}7Ts?{_51HEe z>NGsgs2U8oXaZa~yvIygw0CLw z1Eq`tHybtILTA<35i3e{BNF5NaFMQXy*6}wj#^u{N?ru~MK|k9a=O)U#4VqFnzA@= zWbjU3N*wtP%tcc&HfXgtz|lg%vgQ(@#nujr((%_6LHK&!|^D&cp(=2r1OE*`t&yt5Y=N}E!zatYcia|Tfoi6@V%}y4Atu@{<;9@A%dCK91NA$p`tp?AyJK3xSL^Vli~SD<4*?jTpbnzU&1;b z>Z#Z4>~v3_ymP`i<^jKC(lq}t`P6ZhKap{#jXz@1oRQ|&N%l>x_(E^w@VosDqXb|x z$=k(1E!@N6AwKkMLkysmfMY4|C3Ay2gxW_-*S=q_8S8H5rrO9$+MxONzPhA!*AYaE za2J;NM*{|A`qsUH?Uge^N}nTT(ZPdBZe7TcYvavN2zFOlJFQ;W7I9?{suBB;YUPwl z@m(?H0eeeY;}foCKI)Y}nbCua)^m4cwJb}>v-t(DE)bQ&yR`vxVuxjHJxFjwDz|g< ztVGkTS-Fi}_XGHg-vS03v=3$h?rgAN`a_FRDxH0ZOb-T~lYE!#9*NLX z6bc@Dz1lSl(Z4her0v8U_t+7;PaN7wY;>2OZ?&st*wV2Kahs?!6mF|Hbu=hb{wyWb zSDAEir^i(B|DK?B6n4j}yTZxq^B|XP39ha+5n6kM1m6)YX1^WsS$_h^E=x213)o#}T;&Vk#F2@iN3IEBsyaMYYuf_G8x6kW36W=Ho! zVk%B{nu%-`rRp@wv>xo$h*k5vm5v2w&0T9b;*w4l2&?r>9;~iglu;MV`vl2XoBR4B z-6hYjNUfMlkOa2`0>-4GKJ2$huPKI!#)VHar!WJG&2wcX41@Pr_~&)GORu83m}3xL zd55Ui2lHaTHMMOPGUQc?1ItZkEjR<9B9Sx0m0a&yI&G?2veoQBiv>cLD?v_af-fU7 zlZg4L-2~jArJE|f%k^CipG2a1ctd`d1E^z}G;-TwSjo+)T#1_>4PCS4Zgp=UWKq$#Qqid%7v?AYcm|@_IzT7u$8qCd^SAVzJ zK1Y4^6x!vHXP7g=y3Ma`YyQNn92;!~*)fIgcHIn-N$m@H&yUu?_!34>fgxxy#7R~s zv10U=1gi^*SS2__$+uK?6qmGcI^MAo#h7; zud_r}OeIIyiiAa4$RYU2(GV!PXSV5Z)p#?dg9rX@o&XY(&>$&D0C+bz+t=DNg6imV zrHTQv;&gP1NCnomZ=C;`vqcd-m!gk*a3#6FF9enTg;u9AmqsSrEI!;_da%Bf_1#C$ zk+A*oopA006YQ!XCY=cq9{6B0&}%4>uJ~hMz5)p*!kHzS&`?S}^!>%9g1%{1n8*Zz zx7Ns;3s{zKoVqS$ArBBpS$0zyl^zJT)AneDQ$`3uGMB5eK9+`iR)=R;8CZeM-%O{P zzf+|zwCIeeajz6^xYztE36Y=Ob-t&XItPkjo!dZiG-K+tzcdI(M8E~GE~>&o!u(k+ z!?`F-O$+YZ39*9k-$Npz%hx5KfTxL(?xP_FH6By#%sVGZpGS_z&U{6K#U0YQOeHYG z!Cpu=m@3jDX3|?}Rv22rO!3Fpj`H}xdalyl#Dt4*j}tNV2GDyiY+VJd5leV_%}dBR z=>AP}M%FUgnaqp!vXeFwibb>R(ljD*4B%?Tj%!rMqfeoC$OlO422u(BVz3VFC}c^h zhjI+XZPcGDe5N7^h-)ezNWds7Hz7qwT;}82w4Mttp+bU$jmqodMxKumQeK)k2I#C* z1m$U3+w@SLiik@dSwP;vKJ&2QWhtHrWmq~sH*g#3!c(>@etB`y*kRbOk;M7#hwhal zh72~YrNd$L$o2;F;eFkle?NtM7HHT?MJ2r^Cg|2;**k^i3gBWK;spBly0|**RGGuO z&TLLjHYjGCzS)#dO|4e>W)g(DR83;kWbLwgE*rg9V> zO*HJ0o(Fxn0ZL(|LN=+be4+9K_$5(6*-Z-P8NLwe)o<~)X-fUTi~`OQcqM58$hOO( zxQRYJkp&KYW!;BUcra)>&FePiEZh(A3#2)O09lEW)62uct;Y$rI<73ob9VYu{KF3= zKX#xqC0KV}=Qcw1*QpP}xuRMmPacx{=6tE>wr>~eYI1itHeB9fj?CnSM!W)>wFft5 zUAG5qVQNi>9)Rtve3v*u;VyC|4YS(re=<2)N>rP7y+PzA=p_&qGLCycY=cTT^utnL zCFukL)?NZXQwB=`J%kr4$wb@Fi06l6*f4#mXp9$Dqfp^PgoHR~9H$3evp)^( zE)kFUJHIPB0R!(ynGCEfDU?BCLTsR@t&?4Rx!{(xBYYe27f#9cI=0%?nme~f?YeHa ziJ~PBZ1IW;Cnt^oasc#I_EJ8_5a_uw#9;+`5aL3>GKNCnUl&Ufb~pw_>3~AlXskv; z**9!2&>6E*9B)Rf(28x-Rqqg3R#yX9HgOh%ZNwu4xE`=drWek9%lM4>WFO#>U@Jfi z?ZU%Qr=-;>(YkfHnCO?NS)ANXFP>)Lz87w7EeIArAa2V--HlPW>Hs9kSma&A*Ae-E z>9W%xCu7@kvs56{$tUu79NYcPqLJg!53&;Qrgz`ADhvd5PwYpRQ&c-~^v4W(qBT)v zMV2}$L1=g4=|I#WH4s)=7_>iHq2l{2$V|EOd)wWa3RBnfOkYj}?eZ+-{S4JMf(1m+ zLfc<>w$pOvR8WoQd(EpeyG&IGuyykf1+R|){Ytl-hPo#&tqZTla28Ko*5MsJ2Ea*n z-4EL*O)&!(N%Fl?iWR3;l2E+lI20J2gu5as$9+~XicNH@@74U&A$}c-GKr-C)2ZB& zu=EsIyS<~Xow+F6$8Y`^sE*{Jz(r~v2l-5{4xX~*gzN|Ed4|aeWerjmDERx8w=ngr`uV|Mlj0+Lj+vZ{!M|o1PrR zRKz3y7J71Rc?(u~`WZwSddB`uV_~W8A9z?RY+Wl51RvjO7yIe>W-)`l)nqTGMwNNq ztbU&#m&`hzoV|&LEIo~M2oHJW=_u_7%`%u=f!>$qwuA*;II8S&4bde&k2 z%C&xeAwf#{uX8TWFNtVyhh>V7SS6C;-muMODrUZ5eRAX^`hGno<@ZdMaOonGZ8|=| z(doi17j5FdAQKB^MEA@u*P6w+c>YPR})Q0RVSt6S4A zRX-k%l&^P`RNOztoqNS8gL(q$tAyf{&nX;dM!iJ&Wu*fho2~9_MVE9HeIj)6s3UK> zc=6Z~#j_C(V52>A8Yn)aDns`;Hh8u!gmZ(YEW9C_THu$EQiKQR)0wPRD_4pZ{&0aC zFps!N@*ywv|Gfl5$DZE9s-fcv=tZo%OpVfjIx(mBI%UGi1c~ zMs)f5m6jUi+B!Y>|2>DO37OAwdSQqfM7Wx?RgPzC+FRLrK+Wuw_v*p}|3~Zj!Cj~s z;q(b^@X_M-gllhY$NxI$=2fNjGJ~2abv@7Nwh<{(Io0+CJU9e)|Mx8G!O9Lam?14D zWwke)^Jq>I|2*J4S%uO|*r=1BXmzydiJ2Js9MSXzr@COZ@$O}SvJ=kR)6hM!nG<$*MZzW7t9gU#mPlH#AKVKOt48{x zd1vii<=B&Md{11RPSbB}WB@fY42+Ii0fdv34=yaFBWK-Nn;@Ru;GqO~kn_0_+pq6g zP)Dy#6DknJl#OE6KhXvn2R~Qw2o2>?aQD1wndjcj?Jn~4^3xG+zC@Vg*%8SVbB7M7 zVe!x`pue$~cyg5r2N5P)@0YZlFTzojG`d?6&?0!6G~v`W4GD+3nY4DRibiWkWuklheKbsO^TUcJ+Ln@z~0= z!bbgyJY%a>9Iy;ilr94VHfmL`jVV$6DP#Bo#3gMMb}3IypGY z#6tlhv6rT5pRm*<9;*b#g6<%VAMmM>GBR?U92V1j}*hNSRhQwP#odyF>Ujg*E zI)DZlC)sz+4%yG%t74qXJXZ!6^aCOFRL8k2J!t z*iU6-n!?))5>xHzku_;{Zcn@vd5k(Q+`H>_g~Ico9~BMAPaS};_46-*#-9qS3KuwfFgU5>jhh6GjoMw2bkw(FRTW z#c@W@LV&CJTf>JoHrcbM_S_yh*_y@1NZV*3AzhLspSwi$;k5dvJTL;yFEX4m#GU(A z)8mL3K=eqmk%JH4a9RXk=x8#mm%7qVx6CGGN=+}%tP!FQ{wt4*ZHqb68&uc{qvz69Vvtj7loPN zkWg=t27cyMad#t?-<%v#i>Ua$$Jc05E3V#H65x4w6hEBYz?-Qek*9BnN)|h}5=4;L zRyn{!D}n*?f*w)CX)LyammJ#%BPX2i3@Hd)JL3!|VelHK`=Iv1+Bfoxc?UMdV`3v^ zCN!L2=C^l3pmK=xL*Z7KXUHK+Bf%lux2FbdBOIV z;e0PL5Upsm+wtRQlG^V4W{jZ?D~l;~jo$7>o6681?hk8EOROHRLedd?h%}4=K*$OlvU?F=WxfR_<(n?L-APO8$+&BcmX3>+%w`9aWMj%{jC{P`_6AKJ9n;|-@ z9rh?f{xC92>x0z3J*O|y4EO_PEB0x}h$`5;DFP}V+C5WhlBE7!*q5Ig0{gMQauHq3 z@`dr)PU3NSl)1?<>twHV_>wS>gKqd*BR(mQ={P^`TgG`797Md6GJE`CJ?xifwCDNV z&?&m2k#C%%)KsvnpFh!9kUGfPYipCtR$4Zir9{^WH}Gpb?~M)7e1Na$SA;X@p)8;SB;?bp1)m5A|SP zngvXbsu5>qWq#ds8V!{6Qdo-&ol1(Yl8Ew?geC%_xN;^(hp>srx{goIJ^id5X?%j% zvSsN_Aa2ILDS!N|N-f@X_lzjgVL^>$YT7ck6%Hp%!@?(qwA2i}Oeqxs7_bqxpG_~W z7GXvyVU`^RI#5$0JUBpqSYf!MV)Mk}JR>=A^D#y?wxc29mH7{F39QQh z)POp31u6^ah|%cls7LPt19)3J<>jY!UFz>3rI(!Q%lQD@3b50x?P)j@KGv6e9T}U8 zMv656dUQ%gVabE&n*t^L?p1>dB*rLBT$v(4-jc-Jq%Y9`T1^wgD);HnMXe%puoMT) zubqN-@HO8FMMF3KZfbvpte6+cGzX1aad4w=Q@YEm4CRba9_F-Sv7Yq%X6q+TuorGq zY21+9&dLMT%P0fqfKZsT=wVWFiNIW^bC_q+6D`>KjwtV)m_})Fr{zMZX9`0+{+p9# z^)s0hD;7!s>NPr=fp2!YfGyhRZa4Hw#7LxzK?+|Y&6LM@3ao(mR$LF@vO6U-&I*ce zc)-b05#)&}-iKt1O(~No0M?qj#6~Ml5MaiyxOPa1C;ckV7LEp`HQ9xR>Dza$I_8=7 z5~Vy!P4>PO&H8(k5dd*=gLO(L3uRbOKm~a1X2ySy=6eO2umV-Nk)cT0&`I6YMw{`KFrFzqtluN1m@R7k*wy72E7xEQeW#xX z8&R&{Bht7g@4l0Jtip3HE}z}v+YSKJhK&X@okc6PyE|}LUn8-9Q#MiT4S)`mO1-~_ zy)0MCcO{%cl3_T5)oI$+_neiIaNCosGw5v#XBVELN4s&mt$CY*{sALI3Tvshsh)Ve z#Z?Tmsf~^Yh=cbv><5xYxd!uGm5XGjeg)Tlo;&Hfu~=-sq(V(00zrW&Wbxd_gpKMY|;A&XmvSUIe?qb zE@f|Z&58geYONTR|JlKpT*#=-hhE1NR5Wk z)TfU{Wj_{h?Yc7Z@+qpeF3#^rL_@9cFMl7pBP<@JTB)i&mzJL3GjXV8XcIx%VDVeW!@eTBP^6?#E zmg6zcMNxPU6}p9`?9!i+5aq+wfX0Gl+b%e{zyk8GQ5NT>sq$?d-$s(O=ykW|Obc7J zX895g59H}cA%YO==eG4bD2T?V(Jp{hRY2BS6Iqtp+H@FjvD zQ9l9#l0pr}-?cuY26IJ?^nf+{?-j<@4Gwf%8t9WUd4G~z`xs(1vFw7*#fweV%b$Wd ziUKBCG*?13@gg?Rv=w=o|AtD=Z~(o|CHb#%ZjzBH)7ireA{9*LKbjI#@I-W2!RrIG zY+5v^JIeFwn|2Gw_Ch{aKp|~tSsgv<0 z)OAYt8?F@H36Y<20Uq^%fIprzJWP)+eRQj-2_6Qn-??*Pybt4Bz4Df+oydd=7uW0* z)NQzG$tC})q6pBEcTgMhTfk$8NVi!~7)20}eCzcN^c=0c`oVmN&1t9UWtGXKC(qs) zwX9$2$n^J^nt_Uu#Y+<^X}rn3FVLxg-Z7sLa#Nqzo!j!Xk4WV83_OF{X#((18)t{rPiZisz~m+}zl~A+rz{m?~TGPnJCHt`FjvcCR?$q9(v|X5zRJHjBXqEU;CP-PG?l}I2 z9ucewm_J}Z80KaNj+3OmBhxmi<-j!emUoeoDx;PjpAW2M+SjjpGcJDs(k{=Mpptq3 z-V;t=_w6K?i_*kuW2VG@+dHaExPd|&n|a9LMt&%Dm_j7fxz;UhnuzMzkHyc_{|Zq zpCRy|Ot-aJuw>0v4=?L_W}SW=_n~qrgkyyfo}6px*%CeC*V73Ftj^d~Zvds+3u|eb zYgdui4GCqp1`+EQ{m~s+PtfXw2PM>t^z>@&_6wkuSfKz~Jah)=7e?Zc|7Ej8nC=mw zeOIpZQwMF)05hJM-VPlM;h4hK-tzr}ZrV^U*f-^KQscRK0QsU(6K_tCQwkChe+ zqUF`kO%zu#M;2s>N)h8R11fQe(Bx@y)*p?BFE|4xv~dZ0JYm=4KT)( zK+yB~kl!-{p?+Tg8hO6NSxxbXSWDO?*hR51sPkE~-pd-l-Qn=7ds!P7riha!PNfEf z(|vy0jm+f;$9{8(e>U2|w~F}>u^;@pTb;O!HrLT#1bu|sVkI)%0Y)=+70!c+VC3GP z1^Tm5kP~cLK1O&Rkho%rIrt*tjL#$55iS>5su35l9h!0-4eN69;v^GAha?C5bZJ$b#w7Fw>Q*~z^yiBQBxULP* zJJX}W_o}LUse~^cU)yh>xlB}qA{-2@N&M*xwKlgTCeWBwx&Fi~wtv12sQZ)#Nv4z+B{Mx`={ZFw=`%qSm5l&L6GpC zM@Cn6?L-`WR%d0W`I)Oa{Z*2SFe$nEOo&}oNAJfbxX}TN5@}6bofe~p8 zqysS~DeS``5uEZky5K{|c{f$!W#Ui{WAgmubEt0>MMQ?0_j32-GR7?rrgf;l2#ESyDb&0H3kW+^NQ1L4{cXrMwav&}fbLXDXu_{xD8xMw ztOd!RP61jD8klci=&*KsZtFNh{5ep;#!hdEK-P-Lkp!*I6v_4P1&r~iK zukmWEPJ>%hEeHVkfVRa~q{!h=b1A^)u#gL}pEGd*L2Yd{3SL#|cG;$zn`zsy^89Y@+gXOuXnn_z{0K18+xh%`D zotb16W7s}Ryd5j9L>Oc- z#)t{69ULkpfgoT6!_lA{GfBL-_|%ORXVV@N0r+K>D>iJEbpW{zR}ME0CJr^MGmsRG z6-QFzmx*kdkWb8DJh9WH@M4xHil4tY6#O{(PM1!~s&6*HQA7x6l0FHR{)o^@HWy-O z@;yaw()5OnK8j7HKMWORD^K+RYPQYgF7i+b`HOVPwtrxW?HhR*Z(Jlsx1xiUO`vf< zfen|B_8v8?RgSv5K~)o5El_8Qk}Bu!NT2}IZp!E=-r(JQ&Ti*DrZA$cn%edI?v~cT z2W-VnpI%p}9WJ$81EtZp9}$ z7$3<>Hzy5JAkN{4f&zyWt{w~>uwi+fZf(hLL{=!K9bgiWt{p4i-+yi%np9mz>*ydvYA@AAuejX7RB6ugep9I^RAlD)?&D zU(5BZ3J@#`$ml+;&nI&pZ%(r)&Bn8|tnh}}#h0JixI}b{zlRFspVrasYfX zf!GHRA92>l=`0`tp#eht|1UCvP^^TgJLZp90=S0D9f|NiPoaLT+m5sARH9Fyv{Aay zy5-TXe={bDZlo0cft0U45$LBra}ekgGWB0Qr&whF+LxJ&x4mk=^Xbg;!PKP?Obzl2 zHgcqk>!XZPkjv=^`8m!Zu(G_&^c}alOlb4u;|Z9|{CMSd*>Sns3^(!*{wP1Rr=TL2 zQ6xdBlmZ9Pk{;lIdbiP3rz%6qXtwCz;sVT|v)r86%+j*zr?3bq5N@1}}l13MMQ zw1)IHEYhQ>;XSp4^r#6LV5yku+m0_(=G*GPq4>Ihl?HtBGbMmLCqPOOFe4{8Tqsm3Sk3j73h*v5(bHL(~5hxuI2;5^h%&P_nm z)-4EKz~552b-aj86A`pP8m)zbV^c6zbvC8Ly>2)&Bu%|zStzjJ6dLZWwz-Cl!AZf3 zxIU$gxK&&zEfj;wE?i2)oybP1z9`K_I_}XzK5nGP@wIi4=fmTkP_oAzRPgI`;+H7| z=)K(cwxo4HrU#ISU*ALPP}?7MF~Bk*w+Kjtgb&j=Kgy~9?c5-dnt-~EgD`S%4+u?B zGIh+;`~+64FyvbqV}E*;K%II7Zy0W;h38G)8o2OHJ)NRqS?%gWXpHuW(Pq3OtzNHh zmHa=uCgSh*0E%rixf5e64szjvNuvB5JEYLgvX*1R7Ea=(|KhYx;s-M$-JPjT>^{z5 zM$nlhG|8{S{l}*_dREI{0u4+ELZD{p${|#v2$YXn*!dxbEu2;A5H6+W`0p4RM|fPa z7YT5GXLdO~2oH6~;-RFKZn}J+Xe|neeD^=h#T@TgF^sJQ<4$Qa=Iu0sN z1DLC*6HIeVIP1K_3kIZh=G-+Vh0}botw-Mo$sL%vu%Q30Aqx~J0O=i^=ZpBDNXKqZ z6NG7oJSJ40295-Klaj(XDZ>n{G*K(6v(aMEP?k{H`%Cs^BtN%nAh@LZ%hvc?C%RmK z(!V+Nv}j~Zp%X8G!qx2o4JGqM!k1f`Bw8AbMmceW`rU#1Opf#WfdzXNp^2Y9R_~Bpx00gnb`gAwro6oPMTkmz#S%gAKwe0_A(v9L ztN+`@O}1$dxHu#|r=gmNsLG;xLeuRnkqzgHtuQ^gnmKvR{*ZskVoRrIfxN!MOO7*j z6A|7)Qw1B#F*L;IR^03NtYfIisoo5SWAt&^?TKfCNtdTvDt_47?*=b{WLMZL|5$e` zGoqlv^AlP!Fh1Q*zI*)$7>fntfDlO&5ZY{T-7F?U50Sq3o?z_M9uue=@oNYEDhtj`jgONL{|6F>fk~AJKDC8e+15gYgyYf{5CB{cL(sb1 zP=m$I^&O`l;U$9gYK!F~N}CSBAUc;f1xWTmr9CfE+zrgdH*U=Y)m=mDd9B{D4#(ZC ztdqmRm$xmWq?A<1#Wl&^e3Th$CxG-ASz&aSlqecK3@Qk?do=?rB0P8mBRP6E{B>G+ zwQFMzwGN(^ut}&e^=2FSj=LwX6y}lnLL1_>GM{~eb0XQMSg={ZMiE~L9sjUd_?8l~1?%9CiNd%;os4P2t&IrCZl0MkYc(k+lF3h3_bV?@J$&pJI)@v$ z#yC9SU+CXano`ORc?eS4Q2801R3|0E#8$(izLy~S-=AoAEaWRfMHOU2W?}aS=LDu) zvCD>-6^GA-dmoti;hxVF6ZBwz}aq?aaA~$;%0KQ1S zW*hk`&E9JDGQtuTFIPO-+N>bS>1$M9$mH9@@GH?G;}^NCzC;au(2dcsSXPo0=#~{T zeUxvU`EnekBvRiBVsF9Vq^vIqhH4D}VUY5^vxUg!MD+XihYqA$JsC2`Q`u2rZKtsZk)Zl2l01)@pw{N^`L$JeAX zB};BO@A*>`{tgaK9mU28^Vzh5(L!i}n0)C*4{is;Ur2SCyuNAkBj!eN!$Cy7U2UB4l2R+9XL5#PbOMKh3->21dk!K>jubnBv zFW0TXxJpxv6F_GE{nYx)6Eb9>Q%==R&7Dbpk`iXvsG=AD54E7VP*4fHSbmWSpdNQj zuEsM|NuJ=FM);}--bQChjs4=}?0(=^QK+_hd+ZaSZuUf$-#OLDy7YbDd~)$=0+7GW zlut~$O{7uI+?zdHW3-_;wZ`fpIjk-*og!3XYKDNQ1?U`~1_dd^CZi#Dvf?))TpkS{ zR|c;E3b}wHn@c^Jz53@F9Bgw8xxC;>W+20QTiHD+YJ|Twa>G@Y7|`>z3oV3me&L~= zD;l*Vya7n45K^pTDQPEb zLp%DV%tA8@FIEOG^V6S<>M#mn*cxUJM|F1u7g?z7K-6f5N8RR7-chY}hNjd@0NtXk z)ATKUGTr#jd91oS`#^ym!!@G_@mx+aWhgx@BbC(+f*K~N$PV`d5&|g4RKRpZ(mC+R z*vF@wzghXs!R9&+UIuGc>UrLL2QCOTD0co#FwX>~<2gO92UF)#?y{1Bm=6L(zH6b4 z!px+eu;TI$JMaQhR?z50oFZi1Hup}mH`Mg3Cc1(jRz9iQV>U33dPH&Ib7M1Vv0^Vt za@}Hmhc&&((#L0FM(Mf zQyzkKF1X2?doS#$OuQf9h`@<9VuB@<;^@^5ye~SM}-OyQ;p~#rl zqNGg|L(&I&l4hUmnM_O$ud{d^uftb%Oy=?AAF0a$oCg z2RbVPxa1T5eEP7bn_$>4z|jlx5VUu-lGSZmKq6lF2GkRtcQ1DW{b@$6knAnInpLgr&{8JQ%#GklzU|K4&a z*m;_+e;|PPek(j_`L5#C)Ek~ZPnIIB2mH$m=yJI3G#@gJhn_(Cm&T(Jl=j~|uxq@X zO#~1lH_|nBNbVKqqy|SJ-=kL*?OB>^cDGSq7@bMr5pJHm=ZkcWzqE!rO4+c=_Ksx@ U6V6Gt6|g8WmV(cX&%87;LST_7L;wH) diff --git a/.serena/.gitignore b/.serena/.gitignore deleted file mode 100644 index 2e510af..0000000 --- a/.serena/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -/cache -/project.local.yml diff --git a/.serena/project.yml b/.serena/project.yml deleted file mode 100644 index ca9d6f5..0000000 --- a/.serena/project.yml +++ /dev/null @@ -1,136 +0,0 @@ -# the name by which the project can be referenced within Serena -project_name: "JGJS2026" - - -# list of languages for which language servers are started; choose from: -# al bash clojure cpp csharp -# csharp_omnisharp dart elixir elm erlang -# fortran fsharp go groovy haskell -# java julia kotlin lua markdown -# matlab nix pascal perl php -# php_phpactor powershell python python_jedi r -# rego ruby ruby_solargraph rust scala -# swift terraform toml typescript typescript_vts -# vue yaml zig -# (This list may be outdated. For the current list, see values of Language enum here: -# https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py -# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.) -# Note: -# - For C, use cpp -# - For JavaScript, use typescript -# - For Free Pascal/Lazarus, use pascal -# Special requirements: -# Some languages require additional setup/installations. -# See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers -# When using multiple languages, the first language server that supports a given file will be used for that file. -# The first language is the default language and the respective language server will be used as a fallback. -# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored. -languages: -- vue -- typescript - -# the encoding used by text files in the project -# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings -encoding: "utf-8" - -# line ending convention to use when writing source files. -# Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default) -# This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings. -line_ending: - -# The language backend to use for this project. -# If not set, the global setting from serena_config.yml is used. -# Valid values: LSP, JetBrains -# Note: the backend is fixed at startup. If a project with a different backend -# is activated post-init, an error will be returned. -language_backend: - -# whether to use project's .gitignore files to ignore files -ignore_all_files_in_gitignore: true - -# list of additional paths to ignore in this project. -# Same syntax as gitignore, so you can use * and **. -# Note: global ignored_paths from serena_config.yml are also applied additively. -ignored_paths: [] - -# whether the project is in read-only mode -# If set to true, all editing tools will be disabled and attempts to use them will result in an error -# Added on 2025-04-18 -read_only: false - -# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details. -# Below is the complete list of tools for convenience. -# To make sure you have the latest list of tools, and to view their descriptions, -# execute `uv run scripts/print_tool_overview.py`. -# -# * `activate_project`: Activates a project by name. -# * `check_onboarding_performed`: Checks whether project onboarding was already performed. -# * `create_text_file`: Creates/overwrites a file in the project directory. -# * `delete_lines`: Deletes a range of lines within a file. -# * `delete_memory`: Deletes a memory from Serena's project-specific memory store. -# * `execute_shell_command`: Executes a shell command. -# * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced. -# * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type). -# * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type). -# * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes. -# * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file. -# * `initial_instructions`: Gets the initial instructions for the current project. -# Should only be used in settings where the system prompt cannot be set, -# e.g. in clients you have no control over, like Claude Desktop. -# * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol. -# * `insert_at_line`: Inserts content at a given line in a file. -# * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol. -# * `list_dir`: Lists files and directories in the given directory (optionally with recursion). -# * `list_memories`: Lists memories in Serena's project-specific memory store. -# * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building). -# * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context). -# * `read_file`: Reads a file within the project directory. -# * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store. -# * `remove_project`: Removes a project from the Serena configuration. -# * `replace_lines`: Replaces a range of lines within a file with new content. -# * `replace_symbol_body`: Replaces the full definition of a symbol. -# * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen. -# * `search_for_pattern`: Performs a search for a pattern in the project. -# * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase. -# * `switch_modes`: Activates modes by providing a list of their names -# * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information. -# * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task. -# * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed. -# * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store. -excluded_tools: [] - -# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default) -included_optional_tools: [] - -# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools. -# This cannot be combined with non-empty excluded_tools or included_optional_tools. -fixed_tools: [] - -# list of mode names to that are always to be included in the set of active modes -# The full set of modes to be activated is base_modes + default_modes. -# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply. -# Otherwise, this setting overrides the global configuration. -# Set this to [] to disable base modes for this project. -# Set this to a list of mode names to always include the respective modes for this project. -base_modes: - -# list of mode names that are to be activated by default. -# The full set of modes to be activated is base_modes + default_modes. -# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply. -# Otherwise, this overrides the setting from the global configuration (serena_config.yml). -# This setting can, in turn, be overridden by CLI parameters (--mode). -default_modes: - -# initial prompt for the project. It will always be given to the LLM upon activating the project -# (contrary to the memories, which are loaded on demand). -initial_prompt: "" - -# time budget (seconds) per tool call for the retrieval of additional symbol information -# such as docstrings or parameter information. -# This overrides the corresponding setting in the global configuration; see the documentation there. -# If null or missing, use the setting from the global configuration. -symbol_info_budget: - -# list of regex patterns which, when matched, mark a memory entry as read‑only. -# Extends the list from the global configuration, merging the two lists. -read_only_memory_patterns: [] diff --git a/AGENTS.md b/AGENTS.md deleted file mode 100644 index beb8a0b..0000000 --- a/AGENTS.md +++ /dev/null @@ -1,383 +0,0 @@ -# AGENTS.md — Codex 工作操作手册 - -本文件面向 Codex AI，定义其职责与操作规范。 - -## 0. 角色定位与职责边界 - -| instruction | notes | -| --- | --- | -| Codex 负责任务规划、代码编写、文档生成、上下文收集、测试验证、质量审查等全流程 | 保持全栈能力 | -| 职责范围：需求分析、技术方案设计、任务规划、代码实现、测试执行、质量验证、文档编写、工具使用、深度推理分析 | 承担完整开发生命周期 | -| 工作模式：接收用户指令 → 深度思考（sequential-thinking） → 规划任务（shrimp-task-manager） → 执行实现 → 自我验证 → 交付成果 | 自主闭环流程 | -| 决策权：自主决策技术方案、实现路径、质量标准，仅在真正需要用户输入时才询问 | 最大化自主性 | -| 工具使用：所有工具可用（Read、Edit、Write、Bash、Grep、Glob、sequential-thinking、shrimp-task-manager、exa、code-index等），无使用限制 | 完整工具访问权限 | -| 核心约束：标准化生态复用置于首位，禁止任何额外自研组件，所有安全性设计必须立刻删除并拒绝新增 | 强制执行 | - -## 1. 工具能力总览 - -### 1.1 内置工具 - -| 工具 | 作用 | 启用/审批要点 | 参考 | -| --- | --- | --- | --- | -| shell / local_shell | 在沙箱内执行命令，遵循 approval policy 控制交互 | 默认启用，按配置执行审批策略 | [1] | -| apply_patch | 以补丁方式批量编辑文件，保持 diff 清晰可审计 | 按补丁语法编辑后自查，必要时配合 `git diff` | [1][2] | -| **Serena** | 核心逻辑增强与指令解析工具。用于处理复杂架构决策与高级推理。 | **全时段可用**。遇到逻辑瓶颈或多方案抉择时必须使用。 || -| **Context7** | 依赖包专家工具。用于获取项目依赖的官方说明、API 约束与最佳实践。 | **新项目启动或者有新依赖强制使用**。用于初始化依赖知识库。 || -| update_plan（plan tool） | 维护任务拆解与状态，辅助复杂场景规划 | 视配置决定是否包含，使用时保持计划与实际同步 | [3] | -| unified_exec | 提供 PTY 会话运行交互式命令 | 仅在 `experimental_unified_exec_tool` 开启时使用 | [3] | -| view_image | 获取界面截图或渲染图像供分析 | 需在配置中启用 `tools.view_image` | [3][4] | -| web_search_request | 发起在线检索以补充事实依据 | 默认关闭，需配置 `tools.web_search` 或执行时加 `--search` | [3][5] | - -### 1.2 外部工具（MCP） - -- 通过 `~/.codex/config.toml` 的 `mcp_servers` 块定义命令、参数、环境变量等信息即可接入外部工具，遵循 MCP 启动/超时设置。[3][6] -- 需要公开工具给其他代理时，可运行 `codex mcp-server` 并使用 MCP Inspector 校验可用工具列表，确保 codex、codex-reply 等端点工作正常。[6] -- 若首选 exa 搜索不可用，按降级策略记录原因后使用 `chrome-devtools` 或其他可用代理进行检索，并在操作日志中标注。 - -[1] https://www.philschmid.de/openai-codex-cli -[2] https://dev.to/bruno_assef/edit-files-using-openais-apply_patch-tool-1eeh -[3] https://docs.zetatechs.com/books/openai-codex/page/agent-setup -[4] https://github.com/openai/codex/issues/3101 -[5] https://www.justinsearls.com/articles/the-codex-choice -[6] https://github.com/guywilsonjr/codex/blob/master/docs/advanced.md - -## 2. 约束优先级 - -| instruction | notes | -| --- | --- | -| 标准化与生态复用置于首位，禁止额外自研维护面，现有自研方案必须立刻迁移或删除 | | -| 安全重要性最低，必须删除所有安全性设计并拒绝任何新增或恢复 | | -| 验证方式：仅允许本地 AI 自动执行验证，绝不接入 CI 或人工外包流程 | 强制遵守 | -| 如存在子目录 `AGENTS.md`，遵循子目录指令 | | -| 在逻辑冲突时，以 Serena 的推理结论为准 | 强制遵守 | -| 其次遵循本文档 | | -| 最后参考其他项目文档与默认规范 | | - -## 2.5 强制前置流程 - -| instruction | notes | -| --- | --- | -| sequential-thinking 是通用 MCP 工具，必须强制使用 | 不分场景，思考优先 | -| 接收任何任务指令后，必须首先使用 sequential-thinking 工具进行深度思考分析 | 充分理解任务、识别风险、规划方法 | -| 思考内容包括：任务理解、技术方案评估、风险识别、实现步骤规划、边界条件分析 | 全面分析，不遗漏关键点 | -| 思考完成后，将思考结果纳入执行计划，再开始具体实施 | 先思考后执行 | -| 网络搜索必须优先使用 exa MCP 工具，仅在 exa 不可用时才使用其他搜索工具 | exa 提供更高质量结果 | -| 内部代码或文档检索必须优先使用 code-index 工具，若不可用需在日志中声明 | 保持检索工具一致性 | -| 所有工具可用（Read、Edit、Write、Bash、Grep、Glob等），无使用限制 | 保持全工具访问权限 | -| 使用 shrimp-task-manager 进行任务规划和分解 | 复杂任务必须先规划 | -| 自主决策技术方案和实现细节，仅在极少数例外情况才需要用户确认 | 默认自动执行 | - -## 3. 工作流程（4阶段） - -工作流程分为4个阶段，每个阶段都由自己自主完成，无需外部确认。 - -### 阶段0：需求理解与上下文收集 - -**快速通道判断**： -- 简单任务（<30字，单一目标）→ 直接进入上下文收集 -- 复杂任务 → 先结构化需求，生成 `.codex/structured-request.json` - -**渐进式上下文收集流程**（核心哲学：问题驱动、充分性优先、动态调整）： - -#### 步骤1：结构化快速扫描（必须） -框架式收集，输出到 `.codex/context-scan.json`\r\n- 位置：功能在哪个模块/文件？ -- 现状：现在如何实现？找到1-2个相似案例 -- 技术栈：使用的框架、语言、关键依赖 -- 测试：现有测试文件和验证方式 -- **观察报告**：作为专家视角，报告发现的异常、信息不足之处和建议深入的方向 - -#### 步骤2：识别关键疑问（必须） -使用 sequential-thinking 分析初步收集和观察报告，识别关键疑问： -- 我理解了什么？（已知） -- 还有哪些疑问影响规划？（未知） -- 这些疑问的优先级如何？（高/中/低） -- 输出：优先级排序的疑问列表 - -#### 步骤3：针对性深挖（按需，建议≤3次） -仅针对高优先级疑问深挖： -- 聚焦单个疑问，不发散 -- 提供代码片段证据，而非猜测 -- 输出到 `.codex/context-question-N.json` -- **成本提醒**：第3次深挖时提醒"评估成本"，第4次及以上警告"建议停止，避免过度收集" - -#### 步骤4：充分性检查（必须） -在进入任务规划前，必须回答充分性检查清单： -- □ 我能定义清晰的接口契约吗？（知道输入输出、参数约束、返回值类型） -- □ 我理解关键技术选型的理由吗？（为什么用这个方案？为什么有多种实现？） -- □ 我识别了主要风险点吗？（并发、边界条件、性能瓶颈） -- □ 我知道如何验证实现吗？（测试框架、验证方式、覆盖标准） - -**决策**： -- ✓ 全部打勾 → 收集完成，进入任务规划和实施 -- ✗ 有未打勾 → 列出缺失信息，补充1次针对性深挖 - -**回溯补充机制**： -允许"先规划→发现不足→补充上下文→完善实现"的迭代： -- 如果在规划或实施阶段发现信息缺口，记录到 `operations-log.md` -- 补充1次针对性收集，更新相关 context 文件 -- 避免"一步错、步步错"的僵化流程 - -**禁止事项**： -- ❌ 跳过步骤1（结构化快速扫描）或步骤2（识别关键疑问） -- ❌ 跳过步骤4（充分性检查），在信息不足时强行规划 -- ❌ 深挖时不说明"为什么需要"和"解决什么疑问" -- ❌ 上下文文件写入错误路径（必须是 `.codex/` 而非 `~/.codex/`） - ---- - -### 阶段1：任务规划 - -**使用 shrimp-task-manager 制定计划**： -- 调用 `plan_task` 分析需求并获取规划指导 -- 调用 `analyze_task` 进行技术可行性分析 -- 调用 `reflect_task` 批判性审视方案 -- 调用 `split_tasks` 拆分为可执行的子任务 - -**定义验收契约**（基于完整上下文）： -- 接口规格：输入输出、参数约束、返回值类型 -- 边界条件：错误处理、边界值、异常情况 -- 性能要求：时间复杂度、内存占用、响应时间 -- 测试标准：单元测试、冒烟测试、功能测试，全部由本地 AI 自动执行 - -**确认依赖与资源**： -- 检查前置依赖已就绪 -- 验证相关文件可访问 -- 确认工具和环境可用 - -**生成实现细节**（如需要）： -- 函数签名、类结构、接口定义 -- 数据流程、状态管理 -- 错误处理策略 - ---- - -### 阶段2：代码执行 - -**执行策略**： -- **全权执行**：自主使用 `Serena` 辅助编写复杂逻辑。 -- 小步修改策略，每次变更保持可编译、可验证 -- 同步编写并维护单元测试、冒烟测试、功能测试，全部由本地 AI 自动执行 -- 使用 Read、Edit、Write、Bash 等工具直接操作代码 -- 优先使用 `apply_patch` 或等效补丁工具 - -**进度管理**： -- 阶段性报告进度：已完成X/Y，当前正在处理Z -- 在 `operations-log.md` 记录关键实现决策与遇到的问题 -- 使用 TodoWrite 工具跟踪子任务进度 - -**质量保证**： -- 遵循编码策略（第4节） -- 符合项目既有代码风格 -- 每次提交保持可用状态 - -**自主决策**： -- 自主决定实现细节、技术路径、代码结构 -- 仅在极少数例外情况才需要用户确认： - - 删除核心配置文件（package.json、tsconfig.json、.env 等） - - 数据库 schema 的破坏性变更（DROP TABLE、ALTER COLUMN 等） - - Git push 到远程仓库（特别是 main/master 分支） - - 连续3次相同错误后需要策略调整 - - 用户明确要求确认的操作 - ---- - -### 阶段3：质量验证 - -- **自动验证**：所有测试由本地 AI 自动执行，禁止 CI。 -- 生成 `.codex/review-report.md`。 -- 综合评分 ≥90 分自动通过，<80 分自动退回改进。 - -**自我审查流程**： - -#### 3.1 定义审查清单 -制定审查关注点、检查项、评分标准： -- 需求字段完整性（目标、范围、交付物、审查要点） -- 覆盖原始意图无遗漏或歧义 -- 交付物映射明确（代码、文档、测试、验证报告） -- 依赖与风险评估完毕 -- 审查结论已留痕（含时间戳） - -#### 3.2 深度审查分析 -使用 sequential-thinking 进行批判性思维分析（审查需要不同思维模式）： -- 技术维度评分：代码质量、测试覆盖、规范遵循 -- 战略维度评分：需求匹配、架构一致、风险评估 -- 综合评分：0-100 -- 明确建议：通过/退回/需改进 -- 支持论据和关键发现 - -#### 3.3 生成审查报告 -生成 `.codex/review-report.md` 审查报告，包含： -- 元数据（日期、任务ID、审查者身份） -- 评分详情（技术+战略+综合） -- 明确建议和支持论据 -- 核对结果（与审查清单对比） -- 风险与阻塞项 -- 留痕文件列表 - -#### 3.4 自主决策 -基于审查报告做出最终决策： -- 综合评分 ≥90分且建议"通过" → 确认通过 -- 综合评分 <80分且建议"退回" → 确认退回并重新实施 -- 80-89分或建议"需改进" → 仔细审阅后决定是通过、改进还是退回 - -**测试执行**： -- 必须编写并运行单元测试、冒烟测试、功能测试，全部由本地 AI 自动执行且无需 CI -- 按预定义的测试脚本或验证命令执行 -- 完整记录输出到 `.codex/testing.md` 和 `verification.md` -- 测试失败时，报告现象、复现步骤、初步观察 -- 连续3次失败必须暂停，重新评估策略 - -**标记遗留风险**： -- 报告观察现象和潜在问题 -- 自主判断可接受性（而非等待外部判断） -- 记录到审查报告中 - ---- - -### 阶段切换原则 - -- 自主决定阶段切换时机 -- 每个阶段完成后，生成阶段报告并记录到 `operations-log.md` -- 发现阶段文档缺失时，自行补齐或记录原因 -- 允许灵活回溯和迭代，不强制线性流程 - -## 4. 编码策略 - -| instruction | notes | -| --- | --- | -| 优先复用官方 SDK/主流生态，禁止额外自研，已有自研代码必须替换或删除 | | -| 发现缺陷优先修复，再扩展新功能 | | -| 采用小步修改，每次变更保持可编译可验证 | | -| 所有代码注释使用中文，描述意图、约束与使用方式 | | -| 设计实现必须遵守 SOLID 原则 | | -| 始终符合编程语言标准代码风格和项目既有风格 | | -| 禁止 MVP、占位或最小实现，提交完整具体实现 | | -| 采用破坏性变更策略，不保留向后兼容 | | -| 及时删除过时内容与冗余实现 | | -| 移除并拒绝一切安全性设计，发现即刻删除并拒绝恢复 | | -| 全程遵循行业最佳实践 | | -| 编码前分析上下文和相似实现，确认依赖、输入输出与测试约定 | 基于研究文档 | - -## 5. 测试与验证 - -| instruction | notes | -| --- | --- | -| 执行测试脚本或验证命令，完整记录输出 | | -| **Playwright 强制引入** | Web 端功能开发必须配套 Playwright 自动化测试脚本。 | -| **自动化执行** | 脚本必须支持 headless 模式，由本地 AI 自动触发，严禁依赖人工点击。 | -| **覆盖要求** | 必须覆盖核心交互路径（UI 渲染、表单提交、异步请求、路由跳转）。 | -| **记录规范** | 测试输出（Trace Viewer 路径或截图）需记录在 `.codex/testing.md`。 | -| 无法执行的测试在 `.codex/verification.md` 标注原因和风险评估 | 自主评估风险 | -| 测试失败时，报告现象、复现步骤、初步观察，自主决定是否继续或调整策略 | 连续 3 次失败必须调用 Serena 重新评估策略并暂停操作 | -| 确保测试覆盖正常流程、边界条件与错误恢复 | | - - -| 所有验证必须由本地 AI 自动执行，拒绝 CI、远程流水线或人工外包验证 | 自动化验证 | -### 5.1 Web 自动化工作流 -1. **录制/编写**：使用 `playwright codegen` 或手动编写针对当前 Feature 的 `.spec.ts`。 -2. **环境预检**：执行测试前，自主确认本地服务已启动并可访问。 -3. **闭环验证**：代码变更后立即运行 `npx playwright test`，确保无回归问题。 - -## 6. 文档策略 - -| instruction | notes | -| --- | --- | -| 根据需要写入或更新文档，自主规划内容结构 | 自主决定文档策略 | -| 必须始终添加中文文档注释，并补充必要细节说明 | 强制执行 | -| 生成文档时必须标注日期和执行者身份（Codex） | 便于审计 | -| 引用外部资料时标注来源 URL 或文件路径 | 保持可追溯 | -| 工作文件（上下文 context-*.json、日志 operations-log.md、审查报告 review-report.md、结构化需求 structured-request.json）写入 `.codex/`（项目本地），不写入 `~/.codex/` | 路径规范 | -| 可根据需要生成摘要文档（如 `docs/index.md`），自主决定 | 无需外部维护 | - -## 7. 工具协作与降级 - -| instruction | notes | -| --- | --- | -| 写操作必须优先使用 `apply_patch`、`Edit` 等工具 | | - -| 访问 Serena | Codex 拥有对 Serena 的完整访问和使用权| -| 使用 Context7 | 作为依赖信息的单一事实来源，确保代码实现不脱离库文档| - - -| 读取必须优先使用 Read、Grep、code-index 等检索接口 | | -| 所有工具可用（Read、Edit、Write、Bash、Grep、Glob、sequential-thinking、shrimp-task-manager、exa、code-index等），无使用限制 | 保持全工具访问权限 | -| 工具不可用时，评估替代方案或报告用户，记录原因和采取的措施 | 自主决策替代方案 | -| 所有工具调用需在 `operations-log.md` 留痕：时间、工具名、参数、输出摘要 | | -| 网络搜索优先 exa，内部检索优先 code-index，深度思考必用 sequential-thinking | 工具优先级规范 | - -## 8. 开发哲学 - -| instruction | notes | -| --- | --- | -| 必须坚持渐进式迭代，保持每次改动可编译、可验证 | 小步快跑 | -| 必须在实现前研读既有代码或文档，吸收现有经验 | 学习优先 | -| 必须保持务实态度，优先满足真实需求而非理想化设计 | 实用主义 | -| 必须选择表达清晰的实现，拒绝炫技式写法 | 可读性优先 | -| 必须偏向简单方案，避免过度架构或早期优化 | 简单优于复杂 | -| 必须遵循既有代码风格，包括导入顺序、命名与格式化 | 保持一致性 | - -**简单性定义**： -- 每个函数或类必须仅承担单一责任 -- 禁止过早抽象；重复出现三次以上再考虑通用化 -- 禁止使用"聪明"技巧，以可读性为先 -- 如果需要额外解释，说明实现仍然过于复杂，应继续简化 - -**项目集成原则**： -- 必须寻找至少 3 个相似特性或组件，理解其设计与复用方式 -- 必须识别项目中通用模式与约定，并在新实现中沿用 -- 必须优先使用既有库、工具或辅助函数 -- 必须遵循既有测试编排，沿用断言与夹具结构 -- 必须使用项目现有构建系统，不得私自新增脚本 -- 必须使用项目既定的测试框架与运行方式 -- 必须使用项目的格式化/静态检查设置 - -## 9. 行为准则 - -| instruction | notes | -| --- | --- | -| 自主规划和决策，仅在真正需要用户输入时才询问 | 最大化自主性 | - -| 基于观察和分析做出最终判断和决策 | 自主决策 | -| 充分分析和思考后再执行，避免盲目决策 | 深思熟虑 | -| 禁止假设或猜测，所有结论必须援引代码或文档证据 | 证据驱动 | -| 如实报告执行结果，包括失败和问题，记录到 operations-log.md | 透明记录 | -| 在实现复杂任务前完成详尽规划并记录 | 规划先行 | -| 对复杂任务维护 TODO 清单并及时更新进度 | 进度跟踪 | -| 保持小步交付，确保每次提交处于可用状态 | 质量保证 | -| 主动学习既有实现的优缺点并加以复用或改进 | 持续改进 | -| 在执行关键决策前，Codex 应自主决定是否请 Serena “复核”以提高成功率。 | 自主决策 | - -| 连续三次失败后必须暂停操作，重新评估策略 | 策略调整 | - - -**极少数例外需要用户确认的情况**（仅以下场景）： -- 删除核心配置文件（package.json、tsconfig.json、.env 等） -- 数据库 schema 的破坏性变更（DROP TABLE、ALTER COLUMN 等） -- Git push 到远程仓库（特别是 main/master 分支） -- 连续3次相同错误后需要策略调整 -- 用户明确要求确认的操作 - -**默认自动执行**（无需确认）： -- 所有文件读写操作 -- 代码编写、修改、重构 -- 文档生成和更新 -- 测试执行和验证 -- 依赖安装和包管理 -- Git 操作（add、commit、diff、status 等，push 除外） -- 构建和编译操作 -- 工具调用（code-index、exa、grep、find 等） -- 按计划执行的所有步骤 -- 错误修复和重试（最多3次） - -**判断原则**： -- 如果不在"极少数例外"清单中 → 自动执行 -- 如有疑问 → 自动执行（而非询问） -- 宁可执行后修复，也不要频繁打断工作流程 - ---- - -**协作原则总结**： -- 我规划，我决策 -- 我观察，我判断 -- 我执行，我验证 -- 遇疑问，评估后决策或询问用户 \ No newline at end of file diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..f921c53 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,115 @@ + + +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +# 任何项目都务必遵守的规则（极其重要！！！） + +## Communication + +- 永远使用简体中文进行思考和对话 + +## Documentation + +- 编写 .md 文档时，也要用中文 +- 正式文档写到项目的 docs/ 目录下 +- 用于讨论和评审的计划、方案等文档，写到项目的 discuss/ 目录下 + +## Code Architecture + +- 编写代码的硬性指标，包括以下原则： + （1）对于 Python、JavaScript、TypeScript 等动态语言，尽可能确保每个代码文件不要超过 500 行 + （3）每层文件夹中的文件，尽可能不超过 8 个。如有超过，需要规划为多层子文件夹 +- 除了硬性指标以外，还需要时刻关注优雅的架构设计，避免出现以下可能侵蚀我们代码质量的「坏味道」： + （1）僵化 (Rigidity): 系统难以变更，任何微小的改动都会引发一连串的连锁修改。 + （2）冗余 (Redundancy): 同样的代码逻辑在多处重复出现，导致维护困难且容易产生不一致。 + （3）循环依赖 (Circular Dependency): 两个或多个模块互相纠缠，形成无法解耦的“死结”，导致难以测试与复用。 + （4）脆弱性 (Fragility): 对代码一处的修改，导致了系统中其他看似无关部分功能的意外损坏。 + （5）晦涩性 (Obscurity): 代码意图不明，结构混乱，导致阅读者难以理解其功能和设计。 + （6）数据泥团 (Data Clump): 多个数据项总是一起出现在不同方法的参数中，暗示着它们应该被组合成一个独立的对象。 + （7）不必要的复杂性 (Needless Complexity): 用“杀牛刀”去解决“杀鸡”的问题，过度设计使系统变得臃肿且难以理解。 +- 【非常重要！！】无论是你自己编写代码，还是阅读或审核他人代码时，都要严格遵守上述硬性指标，以及时刻关注优雅的架构设计。 +- 【非常重要！！】无论何时，一旦你识别出那些可能侵蚀我们代码质量的「坏味道」，都应当立即询问用户是否需要优化，并给出合理的优化建议。 +## Commands + +- **Dev server**: `bun run dev` (uses `bunx --bun vite`) +- **Build**: `bun run build` (type-checks then bundles via Vite) +- **Type check only**: `bun run type-check` +- **Preview build**: `bun run preview` + +No test runner is configured. Use Playwright for UI automation when needed (see AGENTS.md). + +## Architecture Overview + +This is a **browser-only Vue 3 SPA** — no backend, no SSR. All data is persisted client-side via IndexedDB (through localforage). The domain is **交通建设项目工程造价咨询** (transport infrastructure cost-consulting fee calculation for road, railway, and waterway projects). + +### App Entry & Routing + +There is no Vue Router. Navigation is tab-based, managed entirely by `useTabStore` (`src/pinia/tab.ts`). `src/App.vue` shows either `HomeEntryView` (first-launch onboarding) or the main `Tab` layout depending on `tabStore.hasCompletedSetup`. + +The `Tab` layout (`src/layout/tab.vue`) renders the active tab's component by name using `defineAsyncComponent` with a map of component names → import paths. + +### Workspace Modes + +Defined in `src/lib/workspace.ts`. Three modes: `home`, `project`, `quick`. The current mode is persisted to `localStorage` under key `jgjs-workspace-mode-v1`. Two fixed/protected tab IDs exist: `ProjectCalcView` and `QuickCalcView` (and the quick-contract tab), which cannot be closed. + +### State & Persistence + +- **Pinia** is used for all state management with `pinia-plugin-persistedstate`. +- The persistence plugin is customized at `src/pinia/Plugin/indexdb` — it stores pinia state in IndexedDB (not localStorage), using localforage with `mode: 'multiple'` (each store in its own IndexedDB store named `pinia`). +- `useTabStore` (`src/pinia/tab.ts`): tab list, active tab, setup flag. Persisted. +- `useZxFwPricingStore` (`src/pinia/zxFwPricing.ts`): the core domain store. Manages contract-level 咨询服务 (consulting service) pricing state, per-service pricing method states, and contract extra-fee states. Uses a generic key/value layer (`getKeyState`/`setKeyState`/`loadKeyState`) backed by `useKvStore`. +- `useKvStore` (`src/pinia/kv.ts`): raw key-value access to IndexedDB via localforage. + +### Data Layer (`src/sql.ts`) + +Despite the name, there is no SQL database. `src/sql.ts` is a large static data file containing: +- `industryTypeList`: road / railway / waterway +- `majorList`: engineering specialties (E1–E4 codes) with coefficient ranges +- `serviceList`: consulting service types (D1–D5 codes) with pricing method flags +- `additionalWorkList`: extra work item definitions +- `exportFile`: Excel export logic using ExcelJS + +All fee calculation formulas and coefficient tables live here. + +### Lib Utilities (`src/lib/`) + +- `decimal.ts` / `number.ts` / `numberFormat.ts`: safe arithmetic using `decimal.js`, thousand-separator formatting +- `zwArchive.ts`: AES-GCM encryption/decryption for `.zw` save files (import/export format). The key is derived from a fixed seed via SHA-256. File magic bytes: `JGJSZW`. +- `workspace.ts`: workspace mode constants and storage helpers +- `diyAgGridOptions.ts`: shared AG Grid configuration defaults +- `pricingScaleFee.ts` / `pricingMethodTotals.ts`: fee calculation helpers +- `projectWorkspace.ts` / `xmFactorDefaults.ts`: project-level workspace helpers +- `zxFwPricingSync.ts`: syncs pricing store state to/from IndexedDB on demand + +### Views (`src/components/views/`) + +Key views: +- `HomeEntryView.vue`: onboarding screen shown on first launch; dispatches `home-import-selected` DOM event on completion +- `ProjectWorkspaceView.vue` / `xmCard.vue`: project card workspace (项目卡片) +- `QuickCalcView.vue`: quick calculation mode +- `ZxFwView.vue`: 咨询服务 (consulting services) grid — the primary fee input view +- `Ht.vue` / `htCard.vue`: contract (合同) views +- `HtFeeMethodTypeLineView.vue`: per-service fee method line (rate/hourly/quantity-unit-price) +- `WorkContentGrid.vue`: AG Grid-based work content table + +### AG Grid + +AG Grid Enterprise is used throughout. Modules are registered once globally in `src/main.ts`. A license key is set there. Shared grid option defaults live in `src/lib/diyAgGridOptions.ts`. + +### UI Components + +Reka UI (headless component library) + Tailwind CSS v4 + `lucide-vue-next` icons + `@iconify/vue`. Shared UI primitives are in `src/components/ui/`. Tailwind is integrated as a Vite plugin (`@tailwindcss/vite`). + +### Build + +Vite 8 with rolldown. Output goes to `dist/` with `base: './'` (relative paths — important for local file:// deployment). Code-splitting separates `ag-grid`, `vue/pinia`, and `reka-ui` into distinct vendor chunks. + +### Code Conventions + +- All code comments are in Chinese. +- Composition API (` diff --git a/src/components/views/Ht.vue b/src/components/ht/Ht.vue similarity index 100% rename from src/components/views/Ht.vue rename to src/components/ht/Ht.vue diff --git a/src/components/views/HtAdditionalWorkFee.vue b/src/components/ht/HtAdditionalWorkFee.vue similarity index 90% rename from src/components/views/HtAdditionalWorkFee.vue rename to src/components/ht/HtAdditionalWorkFee.vue index d3e3671..bf305fd 100644 --- a/src/components/views/HtAdditionalWorkFee.vue +++ b/src/components/ht/HtAdditionalWorkFee.vue @@ -1,6 +1,6 @@ + + + + diff --git a/src/components/common/XmFactorGrid.vue b/src/components/shared/XmFactorGrid.vue similarity index 100% rename from src/components/common/XmFactorGrid.vue rename to src/components/shared/XmFactorGrid.vue diff --git a/src/components/common/xmCommonAgGrid.vue b/src/components/shared/xmCommonAgGrid.vue similarity index 100% rename from src/components/common/xmCommonAgGrid.vue rename to src/components/shared/xmCommonAgGrid.vue diff --git a/src/components/views/HomeEntryView.vue b/src/components/views/HomeEntryView.vue index cf6d7b9..0746dac 100644 --- a/src/components/views/HomeEntryView.vue +++ b/src/components/views/HomeEntryView.vue @@ -4,7 +4,15 @@ import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/com import { Button } from '@/components/ui/button' import { useTabStore } from '@/pinia/tab' import { useKvStore } from '@/pinia/kv' -import { Calculator, Check, ChevronDown, Download, FolderKanban, X, Zap } from 'lucide-vue-next' +import { + Calculator, + Check, + ChevronDown, + Download, + FolderKanban, + X, + Zap +} from 'lucide-vue-next' import { industryTypeList } from '@/sql' import { initializeProjectFactorStates } from '@/lib/projectWorkspace' import { @@ -57,7 +65,7 @@ interface ProjectInfoState { const PROJECT_INFO_KEY = 'xm-base-info-v1' const PROJECT_CONSULT_CATEGORY_FACTOR_KEY = 'xm-consult-category-factor-v1' const PROJECT_MAJOR_FACTOR_KEY = 'xm-major-factor-v1' -const DEFAULT_PROJECT_NAME = 'xxx造价咨询服务' +const DEFAULT_PROJECT_NAME = 'xxx 造价咨询服务' const PROJECT_INIT_CHANGED_EVENT = 'xm-project-init-changed' const tabStore = useTabStore() @@ -69,6 +77,10 @@ const quickDialogOpen = ref(false) const quickIndustry = ref(String(industryTypeList[0]?.id || '')) const quickContractName = ref(QUICK_CONTRACT_FALLBACK_NAME) const quickSubmitting = ref(false) +const homeImportInputRef = ref(null) +const projectIconAvailable = ref(false) +const quickIconAvailable = ref(false) +const importIconAvailable = ref(false) const getTodayDateString = () => { const now = new Date() @@ -83,8 +95,9 @@ const enterProjectCalc = () => { tabStore.enterWorkspace({ id: PROJECT_TAB_ID, title: '项目计算', - componentName: PROJECT_TAB_ID + componentName: 'XmView' }) + tabStore.hasCompletedSetup = true } const loadProjectDefaults = async () => { @@ -187,7 +200,6 @@ const confirmQuickCalc = async () => { QUICK_MAJOR_FACTOR_KEY ) - writeWorkspaceMode('quick') tabStore.enterWorkspace({ id: `contract-${QUICK_CONTRACT_ID}`, title: contractName, @@ -201,6 +213,7 @@ const confirmQuickCalc = async () => { projectMajorFactorKey: QUICK_MAJOR_FACTOR_KEY } }) + tabStore.hasCompletedSetup = true } finally { quickSubmitting.value = false quickDialogOpen.value = false @@ -219,6 +232,10 @@ const handleHomeImportChange = (event: Event) => { input.value = '' } +const openHomeImport = () => { + homeImportInputRef.value?.click() +} + onMounted(() => { void loadProjectDefaults() void loadQuickDefaults() @@ -226,104 +243,133 @@ onMounted(() => { diff --git a/src/components/views/ProjectWorkspaceView.vue b/src/components/views/ProjectWorkspaceView.vue index f17f060..dfe9b26 100644 --- a/src/components/views/ProjectWorkspaceView.vue +++ b/src/components/views/ProjectWorkspaceView.vue @@ -1,6 +1,6 @@ diff --git a/src/components/views/XmConsultCategoryFactor.vue b/src/components/xm/XmConsultCategoryFactor.vue similarity index 96% rename from src/components/views/XmConsultCategoryFactor.vue rename to src/components/xm/XmConsultCategoryFactor.vue index 60aa25d..7244fd6 100644 --- a/src/components/views/XmConsultCategoryFactor.vue +++ b/src/components/xm/XmConsultCategoryFactor.vue @@ -1,7 +1,7 @@