npm - botrun-horse - Versions diffs - 2.29.2 → 2.30.0 - Mend

botrun-horse 2.29.2 → 2.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (574) hide show

package/botrun-c/api/rate-limit-export-1763620678737.csv ADDED Viewed

@@ -0,0 +1,79 @@
+Email,UID,Plan,Plan_Default_RPM,Plan_Default_TPM,Plan_Default_RPD,Has_Custom_Limits,Custom_RPM,Custom_TPM,Custom_RPD,Effective_RPM,Effective_TPM,Effective_RPD,Current_RPM,Current_TPM,Current_RPD,RPM_Usage,TPM_Usage,RPD_Usage
+baby.ff.74@gmail.com,074xGzIKWyfKTBt1NMIj9lxi5mO2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+cyh6800@gmail.com,0l3CZEWySQRTre9nK5NbW2tbZuK2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+damonwheeler.49353@gmail.com,15diNdor1XPCqJ2P6wqGVNXY2wj2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+alanmcdonald.32283@gmail.com,1XIowNy4HGRPlaEMoGyp167NPHC3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+mathewmack.80060@gmail.com,3ESZBFrWzLgs44njrsPz1EUzwmn2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+4pf8n66zw8@privaterelay.appleid.com,4QbgM0jDNWOouL766csx2cArvBI3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+wengroy@cameo.tw,4pv86sko5cU0QaJfhdGaGX4X6EC3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+67t9mkbtnk@privaterelay.appleid.com,4vY2UXsPV0ScVF0K8FdusC3sVvD3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+jenniferburke.60761@gmail.com,5t6pR87INEQI0Bzs9wICBfXlosI3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+panda19931217@gmail.com,6ylRoOUFPNYoMdLrpfiwkIu13ES2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+c8qhmy98s5@privaterelay.appleid.com,7B96LKJkkxQFGIe7eqCJTnfJmBG3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+hsiehchenwei@gmail.com,7mGPpuvOMIRlZ5OM393fhMTJSFs1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+doloresford.28835@gmail.com,7rABEj7qwwW2DZF4hSpIqFq0ftT2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+kurtwilkerson.72437@gmail.com,7vnwPxWSFMgeoSFbnYNWxC9sa8G2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+wangjc4880@gmail.com,9ViSzhoa1gh5fksw32df1sL2Irm2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+chelseagoodwin.91828@gmail.com,AAYoPdQ9t3RxyY8E0P9oHvwYfu82,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+z7vw2hngcc@privaterelay.appleid.com,B0BfOjPzhsT9LxlVzgFdZbcGqAx1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+carole1727@gmail.com,Bdtffme4xDMYuzM3k5MktjI7Rbj2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,3,0 / 6 (0.0%),0 / 200000 (0.0%),3 / 32 (9.4%)
+sophiawalton.16586@gmail.com,CyDM7L6KuzcUp7YrHOJKjaTBpIo2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+chiao@cameo.tw,Dw80lHsTKbVx2gnFhqY8u8vQaOO2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+puredriller@gmail.com,EScVZzMfMTQXMZqZzs0SODTLLZA2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+rooseveltlawrence.13599@gmail.com,EyAPWPwi3TcoBOmpUFMSOQMihxA3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+doyletran.65284@gmail.com,G2LkVsol1MUFqg1OFEPDqNG5Nft2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+slyviacornish.21923@gmail.com,G48xSyzjG8en7cefEAqxeywBI9n1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+sherylmoreno.92785@gmail.com,G9b65PfuvDeb7QGOSmxBm3wobG13,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+florfusco.97738@gmail.com,Gh0alXRc2hNgF3QgZN2glWXEfKH3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+nicolechouhsuan@gmail.com,HrKmi28Y8oOxgNAmlVyvsxyeVY33,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+tatumantonio.97087@gmail.com,IVSFMyfSZQS49cAvdMqCQVhXAQQ2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+ruyuhuang0114@gmail.com,JCUEuIyDcrc9EL0xxc9BI3Ynihf2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+yhmcgjdknr@privaterelay.appleid.com,LILMxQ2iMLdMHaxgS6MgRf2kyEF3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+laticiamorrissey.08735@gmail.com,LdN6sjyCeXVvTAhDG0Pp6l7eBZc2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+j930kiki@gmail.com,MAt5EEy1gDMuip4OBh39wbxOGrI3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+myrtlemorales.86102@gmail.com,N6uR6g50NzSMq5shlSle8wKXBzs2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+sebastian.hsu@gmail.com,OifAYJI4Ahd0MjcoeFP3ICE0mBK2,Lite,6,200000,32,NO,,,,6,200000,32,1,0,3,1 / 6 (16.7%),0 / 200000 (0.0%),3 / 32 (9.4%)
+brandonstone.73941@gmail.com,PJRok9xkqoWVOMZtCyz9uWTwGpr2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+dominicklucas.04963@gmail.com,PVw7tLUYjEQSsPWcSlRq0YeU9193,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+lamarsnyder.41018@gmail.com,UEUQgywOKAbPJG7VXpaD7g9KheN2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+angelmoreno.97881@gmail.com,VP0ZiZGlOYROKS25DB9TFDIIR6x2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+bigcookie.lee@cameo.tw,Vw4RiBecVcThTINSLrGOMeH8gBh2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+emilycastillo.19245@gmail.com,XoVqksGaaKeLgYZY9B97pEvCIiu1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,5,0 / 6 (0.0%),0 / 200000 (0.0%),5 / 32 (15.6%)
+elantievs@gmail.com,Z1K8JtzNZSc5Y3dBHTh1QWCgrYq2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+pzwcfmw8k2@privaterelay.appleid.com,a98XTRS3lRM9QOgaa1llySNDTEF2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+bohachu@gmail.com,bVD7t0Fb7SMX3LPpMzVzCLCkd4o2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,5,0 / 6 (0.0%),0 / 200000 (0.0%),5 / 32 (15.6%)
+alanadrayton.25979@gmail.com,bcfG9DqGQ5dEQyu8OqCZPk9MZrR2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+carole1727@cameo.tw,bnhdOrsoxVOPhP74Cc98Q2PYTyg1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+j7b5s9fvqs@privaterelay.appleid.com,cqZX4WcpnYUZ9XzIIhbffsmKNI12,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+bigcookie.lee@gmail.com,dOm7yvwDQKWG1P3INuIyqWDMKJo1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+percymclaughlin.52788@gmail.com,dR1UggRCbWeY68jHFXWjzl8nmRH2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+sheilamurphy.41021@gmail.com,ei8GV4vZecNogCfHB2ASA9Img0s2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,4,0 / 6 (0.0%),0 / 200000 (0.0%),4 / 32 (12.5%)
+paularuiz.99731@gmail.com,gQukHcW5hxV4tzhR59crtGUdwdo2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+pattywalker.97672@gmail.com,gXR36LK3KThKZdtTqaI3zyV2C9o1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+cristinarobbins.01279@gmail.com,gwq3BvuRaqcyjQb3lOgEKnyag6E2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+zihjia@cameo.tw,hYmTj2q5t6U5fFNTNfXWscXCYV82,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+caseypatton.33043@gmail.com,i2RlRXFIPRVouih1ctggxQFvfZz1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+cbh@cameo.tw,i3E68HNl9MP8XAZXbE7UUviH8u42,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+aarontucker.10914@gmail.com,iaizyW2GUfUqjA7C7mD19fDFjgO2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+shaneriley.97945@gmail.com,jhRc5S0B76MTb7nPvUveZm6ddPB2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+yiting.lu.twts@gmail.com,joSg22zBKIZGFgs5kFxwxqLlfCd2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+fthdfbyh8v@privaterelay.appleid.com,l5oxo7AANZZhoybwU8T9e4Dv8Iy2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+sharondavidson.61073@gmail.com,mVW1dimOJQTFhgmSyeDqKWlXg3p1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+marionlynch.57940@gmail.com,nLaoTOc8EYcDgrQj7MK3lD8ZjRn2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+sharondavidson.47725@gmail.com,s8uL0VeQYAaLsnR20gv8qa0yoT52,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+estellepowell.12869@gmail.com,sjMQY0QPtUOYkgKFJtspxJzkRrm1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+aidoer@cameo.tw,t1ZdkoObjMf8j7jwiUUFC1kOvTt1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+arturogreen.04119@gmail.com,tHkoaXyATOeZL0JvFps1b5Jj73c2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+wengroy@gmail.com,tJBNx4FKIoY5DF3xbIJU55G1Tfj1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,2,0 / 6 (0.0%),0 / 200000 (0.0%),2 / 32 (6.3%)
+ar_user665@icloud.com,tTpB72AiUoeJMrion7lpNZo4DmD2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+test-user-mcp-tools@test.local,test-user-mcp-tools,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+brandymurray.85566@gmail.com,tve6IL5hjge1Z30ANVBSw3qbYqw2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+janinekao@cameo.tw,u4AMoTVEcQhhEHcOH5DXtRnQSzx1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+shelleyfletcher.49503@gmail.com,v950T3aRcsh4NedmsKiwrYZBeyS2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+wilfredfleming.82632@gmail.com,vDxGctXD0jSRNNXAMzFEwaLSvRg1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+nathannorth2005@gmail.com,ydR5Q2SwKfc6Q9dSOZa3G0w2iEk2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+captain840507@gmail.com,yjZVlgL50hbucn7xhMvIttAk4fG2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+morrisblack.76137@gmail.com,yk6Q0ObVW7ZXPPdDMvj7r8uJ7qH3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,1,0 / 6 (0.0%),0 / 200000 (0.0%),1 / 32 (3.1%)
+sherrylawrence.09038@gmail.com,ywSqkAYaXFa0xJfMcQ8uHo0lX4r1,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+fredromero.18370@gmail.com,z3DBlDSd2jckxmbw3793NUMJR7E3,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)
+caisiou921@gmail.com,zF2PwjVluBXnaxiUTwQe5bmDPbE2,Lite,6,200000,32,NO,,,,6,200000,32,0,0,0,0 / 6 (0.0%),0 / 200000 (0.0%),0 / 32 (0.0%)

package/botrun-c/api/scripts/README-migrate-plan-free.md ADDED Viewed

@@ -0,0 +1,197 @@
+# Plan-Free RPD 限制遷移工具
+## 📝 用途
+當 `plan-free` 方案的 RPD（每日請求數）限制從 **8 次/天** 提升到 **16 次/天** 時，需要執行此遷移工具。
+### 為什麼需要遷移？
+雖然程式碼中的 `Plan.ts` 已經更新為新的限制值（16），但 Firestore 中已經存在的 RPD 計數器仍然會影響使用者：
+- ✅ **新使用者**：自動使用新限制（16 次/天）
+- ⚠️ **現有使用者**：如果今天已經發送了 8 次請求，會被舊計數器阻擋
+- 🔴 **被封鎖的使用者**：已達到 8 次限制的使用者，需要等到明天才能繼續使用
+**此工具的作用**：清除所有 `plan-free` 使用者的 RPD 計數器，讓他們立即享有新的限制（16 次/天）。
+---
+## 🚀 使用方式
+### 1. Dry Run（建議先執行）
+先執行 dry-run 模式，查看會影響哪些使用者，但不實際刪除：
+```bash
+# 從專案根目錄執行
+sh/migrate-plan-free.sh --dry-run
+```
+輸出範例：
+```
+🚀 Plan-Free RPD 限制遷移工具
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📝 說明: 從 RPD 8 → 16 的遷移
+⚠️  【DRY RUN 模式】只顯示資訊，不會實際刪除
+🔍 步驟 1: 搜尋所有 plan-free 使用者...
+✅ 找到 150 位 plan-free 使用者
+🔍 步驟 2: 收集 RPD 計數器...
+✅ 找到 75 個 RPD 計數器需要清除
+📊 步驟 3: 計數器詳情
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🔴 已達舊限制 rpd:user-123:2025-11-15... (count: 8)
+  🟢 正常 rpd:user-456:2025-11-15... (count: 3)
+  🔴 已達舊限制 rpd:user-789:2025-11-15... (count: 9)
+⚠️  其中 12 位使用者已達到舊限制（需立即清除）
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ DRY RUN 完成
+👉 若要實際執行，請移除 --dry-run 參數：
+   tsx scripts/migrate-plan-free-rpd.ts
+```
+### 2. 實際執行遷移
+確認 dry-run 的結果後，執行實際遷移：
+```bash
+# 從專案根目錄執行
+sh/migrate-plan-free.sh
+```
+輸出範例：
+```
+🚀 Plan-Free RPD 限制遷移工具
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📝 說明: 從 RPD 8 → 16 的遷移
+🔍 步驟 1: 搜尋所有 plan-free 使用者...
+✅ 找到 150 位 plan-free 使用者
+🔍 步驟 2: 收集 RPD 計數器...
+✅ 找到 75 個 RPD 計數器需要清除
+📊 步驟 3: 計數器詳情
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🔴 已達舊限制 rpd:user-123:2025-11-15... (count: 8)
+  ...
+⚠️  其中 12 位使用者已達到舊限制（需立即清除）
+🗑️  步驟 4: 清除計數器...
+  ⏳ 進度: 10/75
+  ⏳ 進度: 20/75
+  ...
+  ⏳ 進度: 70/75
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 遷移完成！
+📊 統計資訊:
+   • 影響使用者數: 75
+   • 清除計數器數: 75
+   • 立即解除封鎖: 12 位
+🎉 所有 plan-free 使用者現在享有新的 RPD 限制（16 次/天）
+```
+---
+## 📋 注意事項
+### ✅ 安全性
+- **只清除 RPD 計數器**：不會影響 RPM（每分鐘）和 TPM（每分鐘 Token）限制
+- **只針對 plan-free**：不會影響 `plan-max-1` 或 `plan-max-2` 使用者
+- **Dry-run 優先**：建議先執行 dry-run 確認影響範圍
+### 🕐 執行時機
+- **建議時機**：非尖峰時段（例如凌晨）
+- **執行頻率**：只需執行一次
+- **執行時長**：取決於使用者數量，通常 < 1 分鐘
+### 🔄 可重複執行
+此腳本是**冪等的**（idempotent），可以安全地重複執行：
+- 如果沒有計數器需要清除，會顯示「沒有需要清除的計數器」
+- 不會產生錯誤或副作用
+---
+## 🛠️ 技術細節
+### 工作原理
+1. **查詢 Firestore**：搜尋所有 `plan: 'plan-free'` 的使用者
+2. **收集計數器**：找出這些使用者的所有 RPD 計數器（格式：`rpd:userId:YYYY-MM-DD`）
+3. **顯示統計**：計算有多少使用者已達到舊限制（8 次）
+4. **清除計數器**：刪除所有 RPD 計數器
+### 為什麼只清除 RPD？
+- **RPM**（每分鐘請求數）：60 秒後自動過期，無需清除
+- **TPM**（每分鐘 Token 數）：60 秒後自動過期，無需清除
+- **RPD**（每日請求數）：24 小時才過期，需要立即清除以解除封鎖
+### 檔案位置
+- **TypeScript 腳本**：`api/scripts/migrate-plan-free-rpd.ts`
+- **Shell 包裝**：`sh/migrate-plan-free.sh`
+- **說明文件**：`api/scripts/README-migrate-plan-free.md`
+---
+## 🧪 測試建議
+### 本地測試
+如果想在本地環境測試，建議：
+1. 使用測試用的 Firestore 專案
+2. 執行 `seed-rate-limit-test-data.ts` 建立測試資料
+3. 先執行 `--dry-run` 確認行為
+4. 執行實際遷移
+5. 檢查測試使用者是否能繼續使用
+### 生產環境執行
+1. **備份**：確認 Firestore 有自動備份
+2. **Dry-run**：先執行 dry-run 確認影響範圍
+3. **通知**：若有維護視窗，可提前通知使用者
+4. **執行**：執行實際遷移
+5. **驗證**：檢查被封鎖的使用者是否能正常使用
+---
+## ❓ 常見問題
+### Q: 遷移會影響正在使用的使用者嗎？
+**A**: 不會。清除 RPD 計數器只會讓使用者的配額重置，不會中斷正在進行的請求。
+### Q: 如果遷移執行到一半失敗怎麼辦？
+**A**: 腳本會拋出錯誤並停止。已清除的計數器不會復原，但可以安全地重新執行腳本繼續遷移。
+### Q: 遷移後，舊的 8 次限制還會生效嗎？
+**A**: 不會。程式碼中的 `Plan.ts` 已更新為 16 次，新的檢查會使用新的限制值。
+### Q: 需要重啟 API 服務嗎？
+**A**: 不需要。Rate Limit 是即時檢查的，不需要重啟。
+---
+## 📞 聯絡資訊
+如有問題或需要協助，請參考：
+- **Rate Limit README**: `api/src/rate-limit/README.md`
+- **Reset Rate Limit 工具**: `admin/reset-rate.sh`（重置單一使用者）

package/botrun-c/api/scripts/check-users.ts ADDED Viewed

@@ -0,0 +1,45 @@
+#!/usr/bin/env tsx
+/**
+ * 檢查 Firestore users collection 中的使用者資料
+ */
+import { Firestore } from '@google-cloud/firestore';
+const db = new Firestore();
+async function checkUsers() {
+  console.log('📊 檢查 Firestore users collection...\n');
+  const snapshot = await db.collection('users').get();
+  if (snapshot.empty) {
+    console.log('❌ users collection 是空的！沒有任何使用者資料。');
+    console.log('\n💡 提示：');
+    console.log('   - 使用者第一次登入時，系統應該會自動建立使用者文件');
+    console.log('   - 或者你可以手動在 Firestore 中建立使用者文件\n');
+    return;
+  }
+  console.log(`✅ 找到 ${snapshot.size} 個使用者文件\n`);
+  console.log('='.repeat(60));
+  snapshot.forEach(doc => {
+    const data = doc.data();
+    console.log(`\n👤 User ID: ${doc.id}`);
+    console.log(`   Email: ${data.email || 'N/A'}`);
+    console.log(`   Display Name: ${data.displayName || 'N/A'}`);
+    console.log(`   Plan: ${data.plan || 'N/A (預設 Lite)'}`);
+    console.log(`   Created: ${data.createdAt?.toDate?.() || 'N/A'}`);
+  });
+  console.log('\n' + '='.repeat(60));
+  console.log('\n💡 Rate Limit 行為：');
+  console.log('   - 有設定 plan 的使用者：使用該 plan 的限制');
+  console.log('   - 沒有設定 plan 的使用者：預設使用 Lite');
+  console.log('   - 使用者登入後發送訊息時，會自動套用 Rate Limit\n');
+}
+checkUsers().catch(error => {
+  console.error('❌ 執行失敗:', error);
+  process.exit(1);
+});

package/botrun-c/api/scripts/delete-firestore-docs.js ADDED Viewed

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * 簡單的 Firestore 文件刪除腳本
+ * 使用純 JavaScript，不需要 tsx
+ */
+const { Firestore } = require('@google-cloud/firestore');
+const db = new Firestore();
+async function deleteDocuments(collectionName, docIds) {
+  console.log(`\n🗑️  準備刪除 ${docIds.length} 個文件...`);
+  let deleted = 0;
+  for (const docId of docIds) {
+    try {
+      await db.collection(collectionName).doc(docId).delete();
+      console.log(`  ✅ 已刪除: ${docId}`);
+      deleted++;
+    } catch (error) {
+      console.error(`  ❌ 刪除失敗 ${docId}:`, error.message);
+    }
+  }
+  console.log(`\n✅ 成功刪除 ${deleted}/${docIds.length} 個文件\n`);
+}
+async function main() {
+  const collectionName = process.argv[2];
+  const docIds = process.argv.slice(3);
+  if (!collectionName || docIds.length === 0) {
+    console.error('❌ 使用方式: node delete-firestore-docs.js <collection> <docId1> [docId2] ...');
+    process.exit(1);
+  }
+  await deleteDocuments(collectionName, docIds);
+}
+main().catch(error => {
+  console.error('❌ 執行失敗:', error);
+  process.exit(1);
+});