@maiyunnet/kebab 9.3.4 → 9.3.6

package/doc/kebab-rag.md

@@ -1360,7 +1360,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.3.4"` = `'9.3.4'`
+> `const` **VER**: `"9.3.6"` = `'9.3.6'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -3258,7 +3258,7 @@ lib/core/functions/clone.md
 
 > **clone**\<`T`\>(`obj`): `T`
 
-Defined in: [lib/core.ts:1006](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1006)
+Defined in: [lib/core.ts:1060](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1060)
 
 完整的克隆一份数组/对象
 
@@ -3322,7 +3322,7 @@ lib/core/functions/debug.md
 
 > **debug**(`message?`, ...`optionalParams`): `void`
 
-Defined in: [lib/core.ts:1040](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1040)
+Defined in: [lib/core.ts:1094](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1094)
 
 打印调试信息，线上环境不会打印
 
@@ -3357,7 +3357,7 @@ lib/core/functions/display.md
 
 > **display**(`message?`, ...`optionalParams`): `void`
 
-Defined in: [lib/core.ts:1053](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1053)
+Defined in: [lib/core.ts:1107](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1107)
 
 向控制台直接显示内容，一般情况下禁止使用
 
@@ -3462,7 +3462,7 @@ lib/core/functions/getLog.md
 
 > **getLog**(`opt`): `Promise`\<`false` \| `string`[][] \| `null`\>
 
-Defined in: [lib/core.ts:913](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L913)
+Defined in: [lib/core.ts:967](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L967)
 
 获取日志内容为一个数组
 
@@ -3568,7 +3568,7 @@ lib/core/functions/loadEnv.md
 
 > **loadEnv**(`dir`): `Promise`\<`void`\>
 
-Defined in: [lib/core.ts:1105](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1105)
+Defined in: [lib/core.ts:1159](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1159)
 
 加载 .env 文件到 process.env，若文件不存在则跳过
 
@@ -3597,7 +3597,7 @@ lib/core/functions/log.md
 
 > **log**(`opt`, `msg`, `fend?`): `void`
 
-Defined in: [lib/core.ts:807](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L807)
+Defined in: [lib/core.ts:861](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L861)
 
 写入文件日志
 
@@ -3638,7 +3638,7 @@ lib/core/functions/ls.md
 
 > **ls**(`opt`): `Promise`\<`object`[]\>
 
-Defined in: [lib/core.ts:967](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L967)
+Defined in: [lib/core.ts:1021](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1021)
 
 获取目录内文件/文件夹列表
 
@@ -3964,7 +3964,7 @@ lib/core/functions/removeGlobal.md
 
 > **removeGlobal**(`key`, `hosts?`): `Promise`\<`string`[]\>
 
-Defined in: [lib/core.ts:730](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L730)
+Defined in: [lib/core.ts:736](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L736)
 
 移除某个跨线程/跨内网服务器全局变量
 
@@ -3999,7 +3999,7 @@ lib/core/functions/resolveEnvVars.md
 
 > **resolveEnvVars**(`obj`): `void`
 
-Defined in: [lib/core.ts:1135](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1135)
+Defined in: [lib/core.ts:1189](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1189)
 
 将配置对象中的 ${ENV_VAR} 占位符替换为 process.env 的值
 
@@ -4028,7 +4028,7 @@ lib/core/functions/sendNpm.md
 
 > **sendNpm**(`path`, `hosts?`): `Promise`\<`string`[]\>
 
-Defined in: [lib/core.ts:646](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L646)
+Defined in: [lib/core.ts:649](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L649)
 
 向本机或局域网 RPC 发送 npm install 操作
 
@@ -4091,6 +4091,53 @@ PM2 操作类型
 
 `Promise`\<`string`[]\>
 
+lib/core/functions/sendProject.md
+---
+
+[**Documents for @maiyunnet/kebab**](../../../index.md)
+
+***
+
+[Documents for @maiyunnet/kebab](../../../index.md) / [lib/core](../index.md) / sendProject
+
+# Function: sendProject()
+
+> **sendProject**(`path`, `key`, `value`, `hosts?`): `Promise`\<`string`[]\>
+
+Defined in: [lib/core.ts:805](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L805)
+
+向本机或局域网 RPC 发送项目配置更新操作
+
+## Parameters
+
+### path
+
+`string`
+
+项目路径，相对 Kebab 根
+
+### key
+
+`string`
+
+要更新的键名（目前仅支持 staticVer）
+
+### value
+
+`string`
+
+要更新的值
+
+### hosts?
+
+`string`[] \| `"config"`
+
+局域网列表
+
+## Returns
+
+`Promise`\<`string`[]\>
+
 lib/core/functions/sendReload.md
 ---
 
@@ -4207,7 +4254,7 @@ lib/core/functions/setGlobal.md
 
 > **setGlobal**(`key`, `data`, `hosts?`): `Promise`\<`string`[]\>
 
-Defined in: [lib/core.ts:689](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L689)
+Defined in: [lib/core.ts:695](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L695)
 
 设置跨线程/指定的局域网主机的全局变量
 
@@ -4306,7 +4353,7 @@ lib/core/functions/updateCode.md
 
 > **updateCode**(`sourcePath`, `path`, `hosts?`, `config?`, `strict?`): `Promise`\<`Record`\<`string`, \{ `result`: `boolean`; `return`: `string`; \}\>\>
 
-Defined in: [lib/core.ts:742](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L742)
+Defined in: [lib/core.ts:748](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L748)
 
 上传并覆盖代码文件，config.json、kebab.json、.js.map、.ts, .gitignore 不会被覆盖和新创建
 
@@ -4359,7 +4406,7 @@ lib/core/functions/writeEventStreamHead.md
 
 > **writeEventStreamHead**(`res`): `void`
 
-Defined in: [lib/core.ts:1075](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1075)
+Defined in: [lib/core.ts:1129](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1129)
 
 ## Parameters
 
@@ -4384,7 +4431,7 @@ lib/core/functions/writeHead.md
 
 > **writeHead**(`res`, `statusCode`, `headers?`): `void`
 
-Defined in: [lib/core.ts:1064](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1064)
+Defined in: [lib/core.ts:1118](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1118)
 
 让 res 发送头部（前提是头部没有被发送才能调用本方法
 
@@ -4425,7 +4472,7 @@ lib/core/functions/write.md
 
 > **write**(`res`, `data`): `void`
 
-Defined in: [lib/core.ts:1087](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1087)
+Defined in: [lib/core.ts:1141](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L1141)
 
 向 res 发送数据
 
@@ -4509,6 +4556,7 @@ lib/core/index.md
 - [resolveEnvVars](functions/resolveEnvVars.md)
 - [sendNpm](functions/sendNpm.md)
 - [sendPm2](functions/sendPm2.md)
+- [sendProject](functions/sendProject.md)
 - [sendReload](functions/sendReload.md)
 - [sendRestart](functions/sendRestart.md)
 - [setCookie](functions/setCookie.md)
@@ -4594,7 +4642,7 @@ lib/core/interfaces/ILogOptions.md
 
 # Interface: ILogOptions
 
-Defined in: [lib/core.ts:790](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L790)
+Defined in: [lib/core.ts:844](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L844)
 
 log 设置的选项
 
@@ -4604,7 +4652,7 @@ log 设置的选项
 
 > `optional` **cookie?**: `Record`\<`string`, `string`\>
 
-Defined in: [lib/core.ts:796](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L796)
+Defined in: [lib/core.ts:850](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L850)
 
 ***
 
@@ -4612,7 +4660,7 @@ Defined in: [lib/core.ts:796](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **get?**: `Record`\<`string`, `any`\>
 
-Defined in: [lib/core.ts:795](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L795)
+Defined in: [lib/core.ts:849](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L849)
 
 ***
 
@@ -4620,7 +4668,7 @@ Defined in: [lib/core.ts:795](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **headers?**: `IncomingHttpHeaders`
 
-Defined in: [lib/core.ts:798](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L798)
+Defined in: [lib/core.ts:852](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L852)
 
 ***
 
@@ -4628,7 +4676,7 @@ Defined in: [lib/core.ts:798](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **hostname?**: `string`
 
-Defined in: [lib/core.ts:793](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L793)
+Defined in: [lib/core.ts:847](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L847)
 
 ***
 
@@ -4636,7 +4684,7 @@ Defined in: [lib/core.ts:793](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **path?**: `string`
 
-Defined in: [lib/core.ts:791](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L791)
+Defined in: [lib/core.ts:845](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L845)
 
 ***
 
@@ -4644,7 +4692,7 @@ Defined in: [lib/core.ts:791](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **req?**: `IncomingMessage` \| `Http2ServerRequest` \| `null`
 
-Defined in: [lib/core.ts:794](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L794)
+Defined in: [lib/core.ts:848](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L848)
 
 ***
 
@@ -4652,7 +4700,7 @@ Defined in: [lib/core.ts:794](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **session?**: `Record`\<`string`, `any`\>
 
-Defined in: [lib/core.ts:797](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L797)
+Defined in: [lib/core.ts:851](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L851)
 
 ***
 
@@ -4660,7 +4708,7 @@ Defined in: [lib/core.ts:797](https://github.com/maiyunnet/kebab/blob/master/lib
 
 > `optional` **urlFull?**: `string`
 
-Defined in: [lib/core.ts:792](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L792)
+Defined in: [lib/core.ts:846](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L846)
 
 lib/core/type-aliases/TPm2Action.md
 ---
@@ -4749,7 +4797,7 @@ lib/core/variables/global.md
 
 > `const` **global**: `Record`\<`string`, `any`\> = `{}`
 
-Defined in: [lib/core.ts:681](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L681)
+Defined in: [lib/core.ts:687](https://github.com/maiyunnet/kebab/blob/master/lib/core.ts#L687)
 
 跨进程全局变量
 
@@ -15745,7 +15793,7 @@ lib/text/functions/getFileExt.md
 
 > **getFileExt**(`path`): `string`
 
-Defined in: [lib/text.ts:527](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L527)
+Defined in: [lib/text.ts:533](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L533)
 
 获取文件后缀
 
@@ -15774,7 +15822,7 @@ lib/text/functions/getFileNameExt.md
 
 > **getFileNameExt**(`path`): `object`
 
-Defined in: [lib/text.ts:540](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L540)
+Defined in: [lib/text.ts:546](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L546)
 
 获取文件名和后缀
 
@@ -15811,7 +15859,7 @@ lib/text/functions/getFilename.md
 
 > **getFilename**(`path`, `ext?`): `string`
 
-Defined in: [lib/text.ts:507](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L507)
+Defined in: [lib/text.ts:513](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L513)
 
 获取文件名
 
@@ -15846,7 +15894,7 @@ lib/text/functions/htmlescape.md
 
 > **htmlescape**(`html`): `string`
 
-Defined in: [lib/text.ts:482](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L482)
+Defined in: [lib/text.ts:488](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L488)
 
 HTML 特殊字符转换为实体字符
 
@@ -15875,7 +15923,7 @@ lib/text/functions/int2str.md
 
 > **int2str**(`int`, `digits?`, `decimal?`): `string`
 
-Defined in: [lib/text.ts:740](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L740)
+Defined in: [lib/text.ts:746](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L746)
 
 为解决精度问题，将整数转换为小数字符串
 以下几个示例都是当 digits 为 3、decimal 为 2 时
@@ -16008,7 +16056,7 @@ lib/text/functions/isFalsy.md
 
 > **isFalsy**(`val`): `val is TFalsy`
 
-Defined in: [lib/text.ts:691](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L691)
+Defined in: [lib/text.ts:697](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L697)
 
 判断一个值是否是虚假的（为 null/undefined/空字符串/false/0）
 
@@ -16149,7 +16197,7 @@ lib/text/functions/isRealPath.md
 
 > **isRealPath**(`path`): `boolean`
 
-Defined in: [lib/text.ts:494](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L494)
+Defined in: [lib/text.ts:500](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L500)
 
 判断是否是绝对路径，是返回 true，相对路径返回 false
 
@@ -16178,7 +16226,7 @@ lib/text/functions/isTruthy.md
 
 > **isTruthy**\<`T`\>(`val`): `val is Exclude<T, TFalsy>`
 
-Defined in: [lib/text.ts:699](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L699)
+Defined in: [lib/text.ts:705](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L705)
 
 判断一个值是否是真实的（不为 null/undefined/空字符串/false/0）
 
@@ -16213,7 +16261,7 @@ lib/text/functions/logicalOr.md
 
 > **logicalOr**\<`T`, `T2`\>(`v1`, `v2`): `T` *extends* [`TFalsy`](../type-aliases/TFalsy.md) ? `T2` : `T`
 
-Defined in: [lib/text.ts:708](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L708)
+Defined in: [lib/text.ts:714](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L714)
 
 类似 || 运算符的效果
 
@@ -16398,7 +16446,7 @@ lib/text/functions/parseJson.md
 
 > **parseJson**\<`T`\>(`str`): `false` \| `T`
 
-Defined in: [lib/text.ts:602](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L602)
+Defined in: [lib/text.ts:608](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L608)
 
 将字符串解析为对象，返回 false 代表解析失败，支持 BigInt
 
@@ -16597,7 +16645,7 @@ lib/text/functions/str2int.md
 
 > **str2int**(`str`, `digits?`): `number`
 
-Defined in: [lib/text.ts:722](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L722)
+Defined in: [lib/text.ts:728](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L728)
 
 为解决精度问题，将字符串数字转换为整数显示
 以下几个示例都是当 digits 为 2 时
@@ -16637,7 +16685,7 @@ lib/text/functions/stringifyBuffer.md
 
 > **stringifyBuffer**(`buf`): `string`
 
-Defined in: [lib/text.ts:645](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L645)
+Defined in: [lib/text.ts:651](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L651)
 
 输出文本格式的 buffer
 
@@ -16666,7 +16714,7 @@ lib/text/functions/stringifyJson.md
 
 > **stringifyJson**(`obj`, `space?`): `string`
 
-Defined in: [lib/text.ts:632](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L632)
+Defined in: [lib/text.ts:638](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L638)
 
 将对象转换为 json 字符串，返回 false 代表解析失败，支持 BigInt
 
@@ -16701,7 +16749,7 @@ lib/text/functions/stringifyResult.md
 
 > **stringifyResult**(`rtn`): `string`
 
-Defined in: [lib/text.ts:562](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L562)
+Defined in: [lib/text.ts:568](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L568)
 
 将普通的返回 JSON 对象序列化为字符串
 
@@ -16730,7 +16778,7 @@ lib/text/functions/trimJson.md
 
 > **trimJson**(`json`): `any`
 
-Defined in: [lib/text.ts:653](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L653)
+Defined in: [lib/text.ts:659](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L659)
 
 递归删除 json 中的字符串首尾空格，会返回一个新的对象
 
@@ -16930,7 +16978,7 @@ lib/text/type-aliases/TFalsy.md
 
 > **TFalsy** = `false` \| `""` \| `0` \| `null` \| `undefined` \| *typeof* `NaN`
 
-Defined in: [lib/text.ts:685](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L685)
+Defined in: [lib/text.ts:691](https://github.com/maiyunnet/kebab/blob/master/lib/text.ts#L691)
 
 虚假值类型
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.3.4";
+export declare const VER = "9.3.6";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.3.4';
+export const VER = '9.3.6';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/core.d.ts

@@ -210,6 +210,14 @@ export declare function updateCode(sourcePath: string, path: string, hosts?: str
     'result': boolean;
     'return': string;
 }>>;
+/**
+ * --- 向本机或局域网 RPC 发送项目配置更新操作 ---
+ * @param path 项目路径，相对 Kebab 根
+ * @param key 要更新的键名（目前仅支持 staticVer）
+ * @param value 要更新的值
+ * @param hosts 局域网列表
+ */
+export declare function sendProject(path: string, key: string, value: string, hosts?: string[] | 'config'): Promise<string[]>;
 /** --- log 设置的选项 --- */
 export interface ILogOptions {
     'path'?: string;

package/lib/core.js

@@ -532,7 +532,10 @@ export async function sendPm2(name, action = 'restart', hosts) {
     if (hosts === 'config') {
         hosts = globalConfig.hosts;
     }
-    hosts ??= ['127.0.0.1'];
+    // --- 未传或 config 展开后为空数组，均回退到本机 ---
+    if (!hosts?.length) {
+        hosts = ['127.0.0.1'];
+    }
     // --- 局域网模式 ---
     const time = lTime.stamp();
     /** --- 返回成功的 host --- */
@@ -569,7 +572,10 @@ export async function sendNpm(path, hosts) {
     if (hosts === 'config') {
         hosts = globalConfig.hosts;
     }
-    hosts ??= ['127.0.0.1'];
+    // --- 未传或 config 展开后为空数组，均回退到本机 ---
+    if (!hosts?.length) {
+        hosts = ['127.0.0.1'];
+    }
     // --- 局域网模式 ---
     const time = lTime.stamp();
     /** --- 返回成功的 host --- */
@@ -659,7 +665,10 @@ export async function updateCode(sourcePath, path, hosts, config = true, strict
     if (hosts === 'config') {
         hosts = globalConfig.hosts;
     }
-    hosts ??= ['127.0.0.1'];
+    // --- 未传或 config 展开后为空数组，均回退到本机 ---
+    if (!hosts?.length) {
+        hosts = ['127.0.0.1'];
+    }
     /** --- 返回成功的 host --- */
     const rtn = {};
     for (const host of hosts) {
@@ -692,6 +701,48 @@ export async function updateCode(sourcePath, path, hosts, config = true, strict
     }
     return rtn;
 }
+/**
+ * --- 向本机或局域网 RPC 发送项目配置更新操作 ---
+ * @param path 项目路径，相对 Kebab 根
+ * @param key 要更新的键名（目前仅支持 staticVer）
+ * @param value 要更新的值
+ * @param hosts 局域网列表
+ */
+export async function sendProject(path, key, value, hosts) {
+    if (hosts === 'config') {
+        hosts = globalConfig.hosts;
+    }
+    // --- 未传或 config 展开后为空数组，均回退到本机 ---
+    if (!hosts?.length) {
+        hosts = ['127.0.0.1'];
+    }
+    // --- 局域网模式 ---
+    const time = lTime.stamp();
+    /** --- 返回成功的 host --- */
+    const rtn = [];
+    for (const host of hosts) {
+        const res = await lUndici.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+            'action': 'project',
+            'time': time,
+            'path': path,
+            [key]: value
+        }), globalConfig.rpcSecret), {
+            'timeout': 2
+        });
+        const content = await res.getContent();
+        if (!content) {
+            continue;
+        }
+        const str = content.toString();
+        if (str === 'Done') {
+            rtn.push(host);
+        }
+        else {
+            debug('[CORE][sendProject] rpc server content error:', str);
+        }
+    }
+    return rtn;
+}
 /**
  * --- 写入文件日志 ---
  * @param opt 选项

package/lib/text.js

@@ -393,7 +393,13 @@ export function queryParse(query) {
             continue;
         }
         const pos = i.indexOf('=');
-        const key = decodeURIComponent(pos === -1 ? i : i.slice(0, pos));
+        let key;
+        try {
+            key = decodeURIComponent(pos === -1 ? i : i.slice(0, pos));
+        }
+        catch {
+            key = pos === -1 ? i : i.slice(0, pos);
+        }
         let value = '';
         try {
             value = pos === -1 ? '' : decodeURIComponent(i.slice(pos + 1));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.3.4",
+  "version": "9.3.6",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [
@@ -22,8 +22,8 @@
     "#kebab/*": "./*"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.1034.0",
-    "@aws-sdk/lib-storage": "^3.1034.0",
+    "@aws-sdk/client-s3": "^3.1045.0",
+    "@aws-sdk/lib-storage": "^3.1045.0",
     "@litert/http-client": "^1.1.2",
     "@litert/mime": "^0.1.3",
     "@litert/redis": "^3.2.1",
@@ -32,33 +32,33 @@
     "@radix-ui/react-label": "^2.1.8",
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-switch": "^1.2.6",
-    "@tailwindcss/cli": "^4.2.4",
+    "@tailwindcss/cli": "^4.3.0",
     "@types/ssh2": "^1.15.5",
-    "@zilliz/milvus2-sdk-node": "^2.6.13",
-    "ajv": "^8.18.0",
+    "@zilliz/milvus2-sdk-node": "^3.0.0",
+    "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "ejs": "^5.0.2",
     "esbuild": "^0.28.0",
     "jszip": "^3.10.1",
-    "mysql2": "^3.22.2",
+    "mysql2": "^3.22.3",
     "node-cron": "^4.2.1",
-    "openai": "^6.34.0",
+    "openai": "^6.37.0",
     "pg": "^8.20.0",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "react-router-dom": "^7.14.2",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "react-router-dom": "^7.15.0",
     "ssh2": "^1.17.0",
     "svg-captcha": "^1.4.0",
     "tailwind-merge": "^3.5.0",
-    "tencentcloud-sdk-nodejs": "^4.1.219",
-    "undici": "^8.1.0"
+    "tencentcloud-sdk-nodejs": "^4.1.227",
+    "undici": "^8.2.0"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
     "@types/ejs": "^3.1.5",
-    "@types/node": "^25.6.0",
+    "@types/node": "^25.6.2",
     "@types/pg": "^8.20.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",

package/sys/master.js

@@ -195,6 +195,63 @@ function createRpcListener() {
                     }
                     break;
                 }
+                case 'project': {
+                    // --- 更新项目 kebab.json ---
+                    if (!msg.path || typeof msg.path !== 'string') {
+                        res.end('Invalid path');
+                        return;
+                    }
+                    // --- 参数校验前置，避免无效 IO ---
+                    if (!msg.staticVer || typeof msg.staticVer !== 'string') {
+                        res.end('Invalid staticVer');
+                        return;
+                    }
+                    let path = msg.path;
+                    if (path.startsWith('/')) {
+                        path = path.slice(1);
+                    }
+                    if (path.endsWith('/')) {
+                        path = path.slice(0, -1);
+                    }
+                    // --- 拒绝路径穿越，防止跳出 ROOT_CWD ---
+                    if (path.includes('..')) {
+                        res.end('Invalid path');
+                        return;
+                    }
+                    /** --- 最终的项目根目录，以 / 结尾，但用户传入的无所谓 --- */
+                    let to = kebab.ROOT_CWD + path;
+                    if (!to.endsWith('/')) {
+                        to += '/';
+                    }
+                    if (!await lFs.isDir(to)) {
+                        res.end('Path not found: ' + to);
+                        return;
+                    }
+                    const projectFile = to + 'kebab.json';
+                    if (!await lFs.isFile(projectFile)) {
+                        res.end('kebab.json not found in project path');
+                        return;
+                    }
+                    const projectContent = await lFs.getContent(projectFile, 'utf8');
+                    if (!projectContent) {
+                        res.end('Failed to read kebab.json');
+                        return;
+                    }
+                    const projectJson = lText.parseJson(projectContent);
+                    if (!projectJson) {
+                        res.end('Invalid kebab.json');
+                        return;
+                    }
+                    // --- 只允许更新 set.staticVer 字段 ---
+                    projectJson.set ??= {};
+                    projectJson.set.staticVer = msg.staticVer;
+                    const wrtn = await lFs.putContent(projectFile, lText.stringifyJson(projectJson, 4));
+                    if (!wrtn) {
+                        res.end('Failed to write kebab.json');
+                        return;
+                    }
+                    break;
+                }
                 case 'code': {
                     // --- 更新 code 代码包 ---
                     const rtn = await sRoute.getFormData(req);
@@ -221,9 +278,12 @@ function createRpcListener() {
                         to += '/';
                     }
                     if (!await lFs.isDir(to)) {
-                        res.end('Path not found: ' + to);
-                        await sRoute.unlinkUploadFiles(rtn.files);
-                        return;
+                        if (rtn.post['strict'] === '1') {
+                            res.end('Path not found: ' + to);
+                            await sRoute.unlinkUploadFiles(rtn.files);
+                            return;
+                        }
+                        await lFs.mkdir(to);
                     }
                     const buf = await lFs.getContent(file.path);
                     if (!buf) {
@@ -300,20 +360,23 @@ function createRpcListener() {
                         // --- 规则 2：kebab 子项目目录中，仅允许部署 ctr/data/stc/view/lib 子文件夹内的内容 ---
                         // --- 快速跳过：zip 中没有 kebab.json 时整个规则无需执行 ---
                         if (kebabProjectDirs.size > 0) {
-                            // --- 找最长（最精确）匹配的 kebab 项目目录，避免父子项目互相干扰 ---
-                            /** --- 当前文件所属的 kebab 子项目目录，例如 pat 为 "www/pika/ctr/" 时值为 "www/pika/"；无匹配则为 null --- */
-                            let longestMatch = null;
+                            // --- 找最浅（最外层）匹配的 kebab 项目目录 ---
+                            // --- 以最浅匹配为准，确保根层 kebab 规则优先于嵌套项目 ---
+                            // --- 例如 backup/ 自身也有 kebab.json，longestMatch 会选 backup/，使其根文件通过 ---
+                            // --- 改用 shortestMatch 则选根 ""，backup 的第一段不在白名单中，正确排除 ---
+                            /** --- 当前文件所属的最浅 kebab 子项目目录；无匹配则为 null --- */
+                            let shortestMatch = null;
                             for (const kdir of kebabProjectDirs) {
-                                /** --- 当前 kdir 是否比已有的 longestMatch 更精确（路径更深）--- */
-                                const isDeeper = longestMatch === null || kdir.length > longestMatch.length;
-                                if (pat.startsWith(kdir) && isDeeper) {
-                                    longestMatch = kdir;
+                                /** --- 当前 kdir 是否比已有的 shortestMatch 更浅（路径更短）--- */
+                                const isShallower = shortestMatch === null || kdir.length < shortestMatch.length;
+                                if (pat.startsWith(kdir) && isShallower) {
+                                    shortestMatch = kdir;
                                 }
                             }
-                            if (longestMatch !== null) {
+                            if (shortestMatch !== null) {
                                 // --- 取相对于 kebab 项目目录的路径，检查第一级子目录 ---
-                                /** --- 相对路径，例如若 pat 为 "www/pika/ctr/" 且 longestMatch 为 "www/pika/"，则 relPath 为 "ctr/" --- */
-                                const relPath = pat.slice(longestMatch.length);
+                                /** --- 相对路径，例如若 pat 为 "www/pika/ctr/" 且 shortestMatch 为 "www/pika/"，则 relPath 为 "ctr/" --- */
+                                const relPath = pat.slice(shortestMatch.length);
                                 if (relPath) {
                                     /** --- 路径的第一级子目录名，例如 "ctr" 或 "data"，用于判断是否在允许列表中 --- */
                                     const firstSeg = relPath.split('/')[0];

package/www/example/stc/view/react-router.page.d.ts

@@ -19,9 +19,9 @@
  * 如需打包为 .bundle.js，执行：node ./source/main build
  *
  * 【Tailwind CSS 构建】
- * bundle 模式下不再加载 CDN，需提前构建 CSS 产物。
- * 执行 node ./source/main build 时会自动构建同名 .css，无需单独执行。
- * 框架通过 _urlStc 和 _staticVer 自动拼接正确的带版本号 URL。
+ * 需提前执行 node ./source/main build -d source/www/example/stc 生成 CSS 产物。
+ * 框架通过 _staticPath 和 _staticVer 自动拼接带版本号 URL；
+ * import map、props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
  */
 interface IUser {
     'id': string;
@@ -42,17 +42,11 @@ interface IProps {
     '_staticVer': string;
     /** --- 框架注入：BrowserRouter 的 basename，如 /test/react-router-page --- */
     '_routerBase'?: string;
-    /** --- 框架注入：import map JSON 字符串 --- */
-    '_importMapJson'?: string;
-    /** --- 框架注入：水合脚本 --- */
-    '_hydrateScript'?: string;
-    /** --- 框架注入：fullProps 序列化 JSON --- */
-    '_propsJson'?: string;
 }
 /**
  * --- Kebab React BrowserRouter 全页面演示 ---
  * 框架负责用 StaticRouter（服务端）/ BrowserRouter（客户端）包裹本组件，
  * 组件内部只需使用 Routes/Route/Link 等，无需自行包裹 Router。
  */
-export default function ReactRouterPage({ title, serverTime, node, users, user, _urlBase, _urlStc, _staticVer, _importMapJson, _hydrateScript, _propsJson, }: IProps): import("react/jsx-runtime").JSX.Element;
+export default function ReactRouterPage({ title, serverTime, node, users, user, _urlBase, _urlStc, _staticVer, }: IProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/www/example/stc/view/react-router.page.js

@@ -20,9 +20,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * 如需打包为 .bundle.js，执行：node ./source/main build
  *
  * 【Tailwind CSS 构建】
- * bundle 模式下不再加载 CDN，需提前构建 CSS 产物。
- * 执行 node ./source/main build 时会自动构建同名 .css，无需单独执行。
- * 框架通过 _urlStc 和 _staticVer 自动拼接正确的带版本号 URL。
+ * 需提前执行 node ./source/main build -d source/www/example/stc 生成 CSS 产物。
+ * 框架通过 _staticPath 和 _staticVer 自动拼接带版本号 URL；
+ * import map、props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
  */
 import { useState, useEffect } from 'react';
 import { Routes, Route, Link, NavLink, useParams, useNavigate, useLocation, Outlet } from 'react-router-dom';
@@ -135,8 +135,6 @@ function PageNotFound() {
  * 框架负责用 StaticRouter（服务端）/ BrowserRouter（客户端）包裹本组件，
  * 组件内部只需使用 Routes/Route/Link 等，无需自行包裹 Router。
  */
-export default function ReactRouterPage({ title, serverTime, node, users, user, _urlBase, _urlStc, _staticVer, _importMapJson, _hydrateScript, _propsJson, }) {
-    return (_jsxs("html", { lang: "en", children: [_jsxs("head", { children: [_jsx("meta", { charSet: "UTF-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { suppressHydrationWarning: true, children: title }), _importMapJson
-                        ? _jsx("script", { src: "https://cdn.tailwindcss.com" })
-                        : _jsx("link", { rel: "stylesheet", href: `${_urlStc}view/react-router-page.css?v=${_staticVer}` }), _importMapJson && (_jsx("script", { type: "importmap", dangerouslySetInnerHTML: { '__html': _importMapJson } }))] }), _jsxs("body", { className: "bg-slate-50 min-h-screen", children: [_jsxs("div", { className: "max-w-2xl mx-auto px-4 py-10 space-y-6", children: [_jsxs("div", { className: "flex items-start justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-2xl font-bold text-slate-900", children: "Kebab React Router" }), _jsxs("p", { className: "text-slate-500 mt-1 text-sm", children: [_jsx("code", { className: "bg-slate-100 px-1.5 py-0.5 rounded font-mono text-xs", children: "router: 'browser'" }), "\u00A0mode \u2014 URL synced with routes"] })] }), _jsx("a", { href: `${_urlBase}`, className: "text-xs text-slate-400 hover:text-slate-600 transition-colors mt-1", children: "Back to Index" })] }), _jsx("div", { className: "bg-white rounded-xl shadow-sm border border-slate-200 px-4 py-3", children: _jsx(NavBar, {}) }), _jsx("div", { className: "bg-white rounded-xl shadow-sm border border-slate-200 p-6", children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(PageHome, { serverTime: serverTime, node: node }) }), _jsx(Route, { path: "/about", element: _jsx(PageAbout, {}) }), _jsx(Route, { path: "/user", element: _jsx(PageUsers, { users: users, urlBase: _urlBase }) }), _jsx(Route, { path: "/user/:id", element: _jsx(PageUserDetail, { user: user, urlBase: _urlBase }), children: _jsx(Route, { path: "profile", element: _jsx(PageUserProfile, {}) }) }), _jsx(Route, { path: "*", element: _jsx(PageNotFound, {}) })] }) }), _jsxs(Card, { className: "text-xs text-slate-500 space-y-1.5", children: [_jsx("p", { className: "font-semibold text-slate-700 text-sm", children: "How It Works" }), _jsxs("p", { children: ["\u2022 Server: framework wraps with ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "StaticRouter" }), " to SSR the matching route"] }), _jsxs("p", { children: ["\u2022 Client: hydration script wraps with ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "BrowserRouter" }), " for URL-synced navigation"] }), _jsxs("p", { children: ["\u2022 Data: one backend method (", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "_getRouteData" }), ") serves both SSR props and SPA API"] }), _jsxs("p", { children: ["\u2022 Deep links like ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "/test/react-router-page/user/42" }), " work out of the box"] })] })] }), _propsJson && (_jsx("script", { id: "__kebab_props__", type: "application/json", suppressHydrationWarning: true, dangerouslySetInnerHTML: { '__html': _propsJson } })), _hydrateScript && (_jsx("script", { type: "module", suppressHydrationWarning: true, dangerouslySetInnerHTML: { '__html': _hydrateScript } }))] })] }));
+export default function ReactRouterPage({ title, serverTime, node, users, user, _urlBase, _urlStc, _staticVer, }) {
+    return (_jsxs("html", { lang: "en", children: [_jsxs("head", { children: [_jsx("meta", { charSet: "UTF-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { suppressHydrationWarning: true, children: title }), _jsx("link", { rel: "stylesheet", href: `${_urlStc}view/react-router-page.css?v=${_staticVer}` })] }), _jsx("body", { className: "bg-slate-50 min-h-screen", children: _jsxs("div", { className: "max-w-2xl mx-auto px-4 py-10 space-y-6", children: [_jsxs("div", { className: "flex items-start justify-between", children: [_jsxs("div", { children: [_jsx("h1", { className: "text-2xl font-bold text-slate-900", children: "Kebab React Router" }), _jsxs("p", { className: "text-slate-500 mt-1 text-sm", children: [_jsx("code", { className: "bg-slate-100 px-1.5 py-0.5 rounded font-mono text-xs", children: "router: 'browser'" }), "\u00A0mode \u2014 URL synced with routes"] })] }), _jsx("a", { href: `${_urlBase}`, className: "text-xs text-slate-400 hover:text-slate-600 transition-colors mt-1", children: "Back to Index" })] }), _jsx("div", { className: "bg-white rounded-xl shadow-sm border border-slate-200 px-4 py-3", children: _jsx(NavBar, {}) }), _jsx("div", { className: "bg-white rounded-xl shadow-sm border border-slate-200 p-6", children: _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(PageHome, { serverTime: serverTime, node: node }) }), _jsx(Route, { path: "/about", element: _jsx(PageAbout, {}) }), _jsx(Route, { path: "/user", element: _jsx(PageUsers, { users: users, urlBase: _urlBase }) }), _jsx(Route, { path: "/user/:id", element: _jsx(PageUserDetail, { user: user, urlBase: _urlBase }), children: _jsx(Route, { path: "profile", element: _jsx(PageUserProfile, {}) }) }), _jsx(Route, { path: "*", element: _jsx(PageNotFound, {}) })] }) }), _jsxs(Card, { className: "text-xs text-slate-500 space-y-1.5", children: [_jsx("p", { className: "font-semibold text-slate-700 text-sm", children: "How It Works" }), _jsxs("p", { children: ["\u2022 Server: framework wraps with ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "StaticRouter" }), " to SSR the matching route"] }), _jsxs("p", { children: ["\u2022 Client: hydration script wraps with ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "BrowserRouter" }), " for URL-synced navigation"] }), _jsxs("p", { children: ["\u2022 Data: one backend method (", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "_getRouteData" }), ") serves both SSR props and SPA API"] }), _jsxs("p", { children: ["\u2022 Deep links like ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "/test/react-router-page/user/42" }), " work out of the box"] })] })] }) })] }));
 }

package/www/example/stc/view/react-router.page.tsx

@@ -19,9 +19,9 @@
  * 如需打包为 .bundle.js，执行：node ./source/main build
  *
  * 【Tailwind CSS 构建】
- * bundle 模式下不再加载 CDN，需提前构建 CSS 产物。
- * 执行 node ./source/main build 时会自动构建同名 .css，无需单独执行。
- * 框架通过 _urlStc 和 _staticVer 自动拼接正确的带版本号 URL。
+ * 需提前执行 node ./source/main build -d source/www/example/stc 生成 CSS 产物。
+ * 框架通过 _staticPath 和 _staticVer 自动拼接带版本号 URL；
+ * import map、props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
  */
 
 import { useState, useEffect } from 'react';
@@ -49,12 +49,6 @@ interface IProps {
     '_staticVer': string;
     /** --- 框架注入：BrowserRouter 的 basename，如 /test/react-router-page --- */
     '_routerBase'?: string;
-    /** --- 框架注入：import map JSON 字符串 --- */
-    '_importMapJson'?: string;
-    /** --- 框架注入：水合脚本 --- */
-    '_hydrateScript'?: string;
-    /** --- 框架注入：fullProps 序列化 JSON --- */
-    '_propsJson'?: string;
 }
 
 // --- 基础控件 ---
@@ -334,7 +328,7 @@ function PageNotFound() {
  * 组件内部只需使用 Routes/Route/Link 等，无需自行包裹 Router。
  */
 export default function ReactRouterPage({
-    title, serverTime, node, users, user, _urlBase, _urlStc, _staticVer, _importMapJson, _hydrateScript, _propsJson,
+    title, serverTime, node, users, user, _urlBase, _urlStc, _staticVer,
 }: IProps) {
     return (
         <html lang="en">
@@ -343,14 +337,9 @@ export default function ReactRouterPage({
                 <meta name="viewport" content="width=device-width, initial-scale=1" />
                 {/* eslint-disable-next-line @typescript-eslint/naming-convention */}
                 <title suppressHydrationWarning>{title}</title>
-                {/* --- CSS：dev 模式（无 bundle）用 Tailwind CDN；bundle 模式加载本地构建产物 --- */}
-                {_importMapJson
-                    ? <script src="https://cdn.tailwindcss.com" />
-                    : <link rel="stylesheet" href={`${_urlStc}view/react-router-page.css?v=${_staticVer}`} />}
-                {/* --- import map：让浏览器识别 bare import，esm.sh 自动解析依赖 --- */}
-                {_importMapJson && (
-                    <script type="importmap" dangerouslySetInnerHTML={{ '__html': _importMapJson }} />
-                )}
+                {/* --- import map 由框架自动注入在此标签前，无需手动添加 --- */}
+                {/* --- dev: 需先执行 node ./source/main build -d source/www/example/stc 生成 CSS --- */}
+                <link rel="stylesheet" href={`${_urlStc}view/react-router-page.css?v=${_staticVer}`} />
             </head>
             <body className="bg-slate-50 min-h-screen">
                 <div className="max-w-2xl mx-auto px-4 py-10 space-y-6">
@@ -403,23 +392,7 @@ export default function ReactRouterPage({
                     </Card>
                 </div>
 
-                {/* --- 框架注入：props JSON，供客户端水合读取 --- */}
-                {_propsJson && (
-                    <script
-                        id="__kebab_props__"
-                        type="application/json"
-                        suppressHydrationWarning
-                        dangerouslySetInnerHTML={{ '__html': _propsJson }}
-                    />
-                )}
-                {/* --- 框架注入：水合脚本 --- */}
-                {_hydrateScript && (
-                    <script
-                        type="module"
-                        suppressHydrationWarning
-                        dangerouslySetInnerHTML={{ '__html': _hydrateScript }}
-                    />
-                )}
+                {/* --- props JSON + 水合脚本由框架自动注入在此标签前，无需手动添加 --- */}
             </body>
         </html>
     );