openyida 2026.4.14 → 2026.4.15

package/bin/yida.js

@@ -388,6 +388,12 @@ async function main() {
       break;
     }
 
+    case 'list-forms': {
+      const { run } = require('../lib/app/list-forms');
+      await run(args);
+      break;
+    }
+
     case 'get-schema': {
       const { run } = require('../lib/app/get-schema');
       await run(args);

package/lib/app/export-app.js

@@ -18,45 +18,7 @@ const {
   requestWithAutoLogin,
 } = require('../core/utils');
 const { t } = require('../core/i18n');
-
-// ── 获取应用下所有表单页面列表 ────────────────────────
-
-async function fetchFormPageList(appType, authRef) {
-  const result = await requestWithAutoLogin((auth) => {
-    return httpGet(
-      auth.baseUrl,
-      `/dingtalk/web/${appType}/query/formnav/getFormNavigationListByOrder.json`,
-      { _api: 'Nav.queryList', _mock: false },
-      auth.cookies
-    );
-  }, authRef);
-
-  if (!result || result.success === false) {
-    throw new Error(t('export.fetch_forms_failed') + ': ' + (result ? result.errorMsg || t('common.unknown_error') : t('common.request_failed')));
-  }
-
-  const items = result.content || [];
-  const formPages = [];
-
-  for (const node of items) {
-    // 跳过系统导航项（待我处理、我已处理等）
-    if (node.navType === 'SYSTEM' || !node.formUuid) {
-      continue;
-    }
-
-    // 提取页面名称（title 是 i18n 对象）
-    const titleObj = node.title || node.i18nTitle || {};
-    const pageName = titleObj.zh_CN || titleObj.en_US || t('export.unnamed_form');
-
-    formPages.push({
-      formUuid: node.formUuid,
-      name: pageName,
-      formType: node.formType || '',
-    });
-  }
-
-  return formPages;
-}
+const { fetchFormPageList } = require('./form-navigation');
 
 // ── 获取单个表单 Schema ───────────────────────────────
 
@@ -114,7 +76,13 @@ async function run(args) {
   step(2, t('export.step_get_forms'));
   let formPages;
   try {
-    formPages = await fetchFormPageList(appType, authRef);
+    const forms = await fetchFormPageList(appType, authRef);
+    formPages = forms.map((form) => ({
+      formUuid: form.formUuid,
+      name: form.formName,
+      formType: form.formType,
+      pathName: form.pathName,
+    }));
   } catch (err) {
     chalkFail(err.message);
     process.exit(1);

package/lib/app/form-navigation.js

@@ -0,0 +1,65 @@
+'use strict';
+
+const {
+  httpGet,
+  requestWithAutoLogin,
+} = require('../core/utils');
+const { t } = require('../core/i18n');
+
+function resolveLocalizedText(value, fallback = '') {
+  if (!value) {
+    return fallback;
+  }
+
+  if (typeof value === 'string') {
+    return value;
+  }
+
+  if (typeof value === 'object') {
+    return value.zh_CN || value.en_US || value.zh_TW || fallback;
+  }
+
+  return fallback;
+}
+
+function normalizeFormNavigationNode(node) {
+  if (!node || node.navType === 'SYSTEM' || !node.formUuid) {
+    return null;
+  }
+
+  return {
+    formUuid: node.formUuid,
+    formName: resolveLocalizedText(node.title || node.i18nTitle || node.name, t('list_forms.unnamed_form')),
+    formType: node.formType || '',
+    pathName: node.pathName || '',
+  };
+}
+
+async function fetchFormPageList(appType, authRef) {
+  const result = await requestWithAutoLogin((auth) => {
+    return httpGet(
+      auth.baseUrl,
+      `/dingtalk/web/${appType}/query/formnav/getFormNavigationListByOrder.json`,
+      { _api: 'Nav.queryList', _mock: false },
+      auth.cookies
+    );
+  }, authRef);
+
+  if (!result || result.success === false) {
+    throw new Error(
+      t('list_forms.fetch_failed') + ': ' +
+      (result ? result.errorMsg || t('common.unknown_error') : t('common.request_failed'))
+    );
+  }
+
+  const items = Array.isArray(result.content) ? result.content : [];
+  return items
+    .map(normalizeFormNavigationNode)
+    .filter(Boolean);
+}
+
+module.exports = {
+  fetchFormPageList,
+  normalizeFormNavigationNode,
+  resolveLocalizedText,
+};

package/lib/app/list-forms.js

@@ -0,0 +1,105 @@
+'use strict';
+
+const {
+  loadCookieData,
+  triggerLogin,
+  resolveBaseUrl,
+} = require('../core/utils');
+const { t } = require('../core/i18n');
+const { fetchFormPageList } = require('./form-navigation');
+
+function parseArgs(args) {
+  const parsed = {
+    appType: '',
+    keyword: '',
+  };
+
+  if (args.length > 0) {
+    parsed.appType = args[0];
+  }
+
+  for (let index = 1; index < args.length; index++) {
+    if (args[index] === '--keyword' && args[index + 1]) {
+      parsed.keyword = args[index + 1];
+      index++;
+    }
+  }
+
+  return parsed;
+}
+
+function filterForms(forms, keyword) {
+  if (!keyword) {
+    return forms;
+  }
+
+  const normalizedKeyword = keyword.toLowerCase();
+  return forms.filter((form) => {
+    return [form.formName, form.formUuid, form.formType, form.pathName]
+      .filter(Boolean)
+      .some((value) => String(value).toLowerCase().includes(normalizedKeyword));
+  });
+}
+
+async function run(args) {
+  const parsed = parseArgs(args);
+  if (!parsed.appType) {
+    console.error(t('list_forms.usage'));
+    console.error(t('list_forms.example1'));
+    console.error(t('list_forms.example2'));
+    process.exit(1);
+  }
+
+  const SEP = '='.repeat(50);
+  console.error(SEP);
+  console.error(t('list_forms.title'));
+  console.error(SEP);
+  console.error(t('list_forms.app_id', parsed.appType));
+  if (parsed.keyword) {
+    console.error(t('list_forms.keyword', parsed.keyword));
+  }
+
+  console.error(t('common.step_login', 1));
+  let cookieData = loadCookieData();
+  if (!cookieData) {
+    console.error(t('common.login_no_cache'));
+    cookieData = triggerLogin();
+  }
+
+  if (!cookieData || !cookieData.cookies) {
+    console.error(t('list_forms.no_login'));
+    process.exit(1);
+  }
+
+  const authRef = {
+    csrfToken: cookieData.csrf_token,
+    cookies: cookieData.cookies,
+    baseUrl: resolveBaseUrl(cookieData),
+    cookieData,
+  };
+  console.error(t('common.login_ready', authRef.baseUrl));
+
+  console.error(t('list_forms.step_get'));
+  let forms;
+  try {
+    forms = await fetchFormPageList(parsed.appType, authRef);
+  } catch (error) {
+    console.error(t('list_forms.failed', error.message));
+    process.exit(1);
+  }
+
+  const filteredForms = filterForms(forms, parsed.keyword);
+  console.error(t('list_forms.found', filteredForms.length));
+
+  if (filteredForms.length === 0) {
+    console.error(t('list_forms.empty'));
+  }
+
+  console.log(JSON.stringify(filteredForms, null, 2));
+}
+
+module.exports = {
+  filterForms,
+  parseArgs,
+  run,
+};

package/lib/core/locales/en.js

@@ -84,6 +84,7 @@ Commands:
   create-page <appType> "<pageName>"                           Create a custom page, output pageId
   create-form create <appType> "<formName>" <fieldsJSON> [--layout <layout>] [--theme <theme>] [--label-align <align>]  Create a form page
   create-form update <appType> <formUuid> <changesJSON>        Update a form page
+  list-forms <appType> [--keyword <text>]                      List forms/pages in an app
   get-schema <appType> <formUuid>                              Get form Schema
   publish <sourceFile> <appType> <formUuid>                    Compile and publish a custom page
   verify-short-url <appType> <formUuid> <url>                  Verify if a short URL is available
@@ -147,6 +148,8 @@ Examples:
   openyida create-page APP_XXX "Game Home"
   openyida create-form create APP_XXX "Employee Info" fields.json
   openyida create-form update APP_XXX FORM-XXX '[{"action":"add","field":{"type":"TextField","label":"Notes"}}]'
+  openyida list-forms APP_XXX
+  openyida list-forms APP_XXX --keyword customer
   openyida get-schema APP_XXX FORM-XXX
   openyida publish pages/src/home.jsx APP_XXX FORM-XXX
   openyida verify-short-url APP_XXX FORM-XXX /o/myapp
@@ -424,6 +427,22 @@ Examples:
     failed: '  ❌ Failed to get Schema: {0}',
   },
 
+  list_forms: {
+    title: '  yidacli list-forms - App form/page list tool',
+    usage: 'Usage: openyida list-forms <appType> [--keyword <text>]',
+    example1: 'Example: openyida list-forms APP_XXX',
+    example2: '         openyida list-forms APP_XXX --keyword customer',
+    app_id: '  App ID:      {0}',
+    keyword: '  Keyword:     {0}',
+    step_get: '\n📋 Step 2: Fetch app forms/pages',
+    found: '  ✅ Found {0} matching items',
+    empty: '  ⚠️  No matching forms/pages found, outputting []',
+    unnamed_form: 'Unnamed page',
+    fetch_failed: 'Failed to fetch app navigation list',
+    failed: '  ❌ Query failed: {0}',
+    no_login: '  ❌ Unable to get valid login credentials',
+  },
+
   // ── lib/create-form.js ─────────────────────────────
   create_form: {
     create_title: '  yida-create-form-page - Yida Form Page Creation Tool',

package/lib/core/locales/zh.js

@@ -84,6 +84,7 @@ openyida - 宜搭命令行工具
   create-page <appType> "<页面名>"                             创建自定义页面，输出 pageId
   create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
   create-form update <appType> <formUuid> <修改JSON>           更新表单页面
+  list-forms <appType> [--keyword <关键词>]                    列出应用下的表单/页面
   get-schema <appType> <formUuid>                              获取表单 Schema
   publish <源文件路径> <appType> <formUuid>                    编译并发布自定义页面
   verify-short-url <appType> <formUuid> <url>                  验证短链接 URL 是否可用
@@ -148,6 +149,8 @@ openyida - 宜搭命令行工具
   openyida create-page APP_XXX "游戏主页"
   openyida create-form create APP_XXX "员工信息" fields.json
   openyida create-form update APP_XXX FORM-XXX '[{"action":"add","field":{"type":"TextField","label":"备注"}}]'
+  openyida list-forms APP_XXX
+  openyida list-forms APP_XXX --keyword 客户
   openyida get-schema APP_XXX FORM-XXX
   openyida publish pages/src/home.jsx APP_XXX FORM-XXX
   openyida verify-short-url APP_XXX FORM-XXX /o/myapp
@@ -396,6 +399,22 @@ openyida - 宜搭命令行工具
     failed: '  ❌ 获取 Schema 失败: {0}',
   },
 
+  list_forms: {
+    title: '  yidacli list-forms - 应用表单/页面列表查询工具',
+    usage: '用法: openyida list-forms <appType> [--keyword <关键词>]',
+    example1: '示例: openyida list-forms APP_XXX',
+    example2: '      openyida list-forms APP_XXX --keyword 客户',
+    app_id: '  应用 ID:  {0}',
+    keyword: '  关键词:   {0}',
+    step_get: '\n📋 步骤 2: 获取应用下的表单/页面列表',
+    found: '  ✅ 共找到 {0} 个匹配项',
+    empty: '  ⚠️  当前应用下没有匹配的表单/页面，将输出 []',
+    unnamed_form: '未命名页面',
+    fetch_failed: '获取应用导航列表失败',
+    failed: '  ❌ 查询失败: {0}',
+    no_login: '  ❌ 无法获取有效登录态',
+  },
+
   // ── lib/create-form.js ─────────────────────────────
   create_form: {
     create_title: '  yida-create-form-page - 宜搭表单页面创建工具',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.04.14",
+  "version": "2026.04.15",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "./bin/yida.js",

package/yida-skills/SKILL.md

@@ -2,7 +2,7 @@
 name: yida-skills
 description: "宜搭低代码平台 AI 开发助手。适用于一切业务数字化需求：创建登记表/申请表/信息收集表、设计审批流程、搭建数据报表/数据大屏、开发自定义页面、管理表单数据、闪记转PRD/会议纪要提取需求/需求文档生成、导出对话记录、编写公式/计算字段、配置连接器/外部API接入、设置权限/公开分享、集成自动化。当用户想要创建任何形式的表单、系统、页面、流程、报表，或提到员工管理、客户管理、费用报销、考勤打卡、项目管理等业务场景时触发。也适用于「宜搭」「yida」「低代码」「创建应用」「发布页面」「搭建系统」「PRD」「闪记」「会议记录」「对话导出」「公式」「连接器」「权限」「分享」「集成自动化」等关键词场景。"
 metadata:
-  version: 2026.04.14
+  version: 2026.04.15
 ---
 
 # 宜搭 AI 应用开发指南