openxiangda 1.0.125 → 1.0.126

package/lib/cli.js

@@ -5500,6 +5500,7 @@ function inferNotificationResourceCode(item) {
 
 function extractResourceValues(value, spec) {
   if (spec.key === 'notifications') return extractNotificationResourceValues(value);
+  if (spec.key === 'menus') return extractMenuResourceValues(value);
   if (Array.isArray(value)) return value;
   if (!value || typeof value !== 'object') return [value];
   for (const key of spec.pluralKeys || []) {
@@ -5509,6 +5510,32 @@ function extractResourceValues(value, spec) {
   return [value];
 }
 
+function extractMenuResourceValues(value) {
+  const baseValues = (() => {
+    if (Array.isArray(value)) return value;
+    if (!value || typeof value !== 'object') return [value];
+    if (Array.isArray(value.menus)) return value.menus;
+    if (value.resource && typeof value.resource === 'object') return [value.resource];
+    return [value];
+  })();
+  const result = [];
+  const visit = (item, parentCode) => {
+    if (!item || typeof item !== 'object' || Array.isArray(item)) {
+      result.push(item);
+      return;
+    }
+    const { children, ...rest } = item;
+    const code = rest.code || rest.resourceCode;
+    result.push(parentCode && !rest.parentCode && !rest.parentId ? { ...rest, parentCode } : rest);
+    if (!Array.isArray(children)) return;
+    for (const child of children) {
+      visit(child, code || parentCode);
+    }
+  };
+  for (const item of baseValues) visit(item, null);
+  return result;
+}
+
 function extractNotificationResourceValues(value) {
   if (Array.isArray(value)) return value;
   if (!value || typeof value !== 'object') return [value];

package/openxiangda-skills/references/resource-manifest-cheatsheet.md

@@ -708,6 +708,8 @@ export default async function (ctx) {
 
 ## 12. Menu — `src/resources/menus/<code>.json`
 
+菜单可以写成单个资源文件，也可以在 `menus.json` 中用 `children` 声明树形结构；`resource validate|plan|publish` 会把 children 展开成独立菜单资源，并自动给子菜单补 `parentCode`。
+
 ```json
 {
   "code": "main",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.125",
+  "version": "1.0.126",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/templates/openxiangda-react-spa/AGENTS.md

@@ -58,7 +58,7 @@ openxiangda runtime deploy --profile <name>
 
 ## 权限资源
 
-React SPA 页面需要声明菜单 code、route code 和 path pattern。默认菜单资源在 `src/resources/menus/menus.json`：
+React SPA 页面需要声明菜单 code、route code 和 path pattern。默认菜单资源在 `src/resources/menus/menus.json`；可以用 `children` 声明树形菜单，`resource validate|plan|publish` 会展开成独立菜单资源：
 
 ```json
 {