openyida 2026.5.19 → 2026.5.20

package/README.md

@@ -200,6 +200,24 @@ openyida data create form APP_XXX FORM_XXX --data-file .cache/openyida/data-impo
 openyida get-permission APP_XXX FORM_XXX
 ```
 
+`configure-process` 的流程 JSON 中，审批人可配置为发起人、指定成员、指定角色、部门主管或直属主管，例如：
+
+```json
+{
+  "nodes": [
+    {
+      "type": "approval",
+      "name": "主管审批",
+      "approver": {
+        "type": "user",
+        "users": [{ "id": "manager7350", "name": "九神" }],
+        "multiApproverType": "all"
+      }
+    }
+  ]
+}
+```
+
 When creating or updating test data with `openyida data`, Yida date fields must use 13-digit millisecond timestamps, for example `"dateField_xxx": 1719705600000`. Do not submit `YYYY-MM-DD` strings for `DateField` or `CascadeDateField` values.
 Temporary JSON, CSV, and one-off import scripts should live under `.cache/openyida/` so generated run artifacts do not clutter the repository root.
 
@@ -279,6 +297,7 @@ For overseas apps, pass `--locale en_US` or `--locale ja_JP` on creation command
 | `openyida corp-efficiency [overview\|details\|detail\|groups\|notify] [options] [--open\|--no-open]` | Query enterprise efficiency metrics, detail report entries, and related notification actions |
 | `openyida create-app "<name>"\|--name <name> [options] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create an application and output `appType` |
 | `openyida update-app <appType> --name "..."` | Update application metadata |
+| `openyida nav-group <list\|create\|rename\|delete\|move\|hide\|show> <appType> ...` | Manage sidebar navigation groups and move pages between groups |
 | `openyida app-permission <get\|set\|add\|remove\|search-user> ...` | Manage app primary admins, data admins, and developer members |
 | `openyida i18n <overview\|config\|languages\|list\|upsert\|delete\|translate\|translate-all\|upgrade> <appType> ...` | Manage app multilingual copy and language configuration |
 | `openyida export <appType> [output]` | Export an application migration package |
@@ -290,6 +309,9 @@ For overseas apps, pass `--locale en_US` or `--locale ja_JP` on creation command
 |---------|-------------|
 | `openyida create-form create <appType> "<name>" <fields.json> [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a form page |
 | `openyida create-form update <appType> <formUuid> <changes.json> [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Update a form page |
+| `openyida create-form patch <appType> <formUuid> <patch.json> [--open\|--no-open]` | Apply controlled schema patches for designer-only form settings |
+| `openyida create-form rule <appType> <formUuid> <rules.json> [--open\|--no-open]` | Configure field show/hide linkage and onChange auto-assignment rules |
+| `openyida create-form bind-datasource <appType> <formUuid> <fieldLabelOrId> <datasource.json> [--open\|--no-open]` | Bind URL/search data sources to SelectField/MultiSelectField-style option fields |
 | `openyida create-form add-option <appType> <formUuid> <fieldLabel> <option1> [option2] ...` | Append options to a SelectField/RadioField/CheckboxField/MultiSelectField |
 | `openyida list-forms <appType> [--keyword <text>]` | List forms in an application |
 | `openyida get-schema <appType> <formUuid\|--all> [--field <labelOrFieldId>]` | Fetch one form schema, batch export all, or pick a single field's full props |
@@ -308,9 +330,10 @@ For overseas apps, pass `--locale en_US` or `--locale ja_JP` on creation command
 | `openyida data <action> <resource> [args]` | Unified data management for forms, processes, tasks, and subforms |
 | `openyida data check <appType> <formUuid> <rules.json>` | Detect anomalous process-form records |
 | `openyida task-center <type> [options]` | Query todo, created, processed, CC, or proxy-submitted tasks |
+| `openyida agent-center <sub-command>` | Manage Yida process delegation and departure delegation |
 | `openyida basic-info <overview\|commodity\|grant\|capacity\|quota\|abs-path\|dataflow\|i18n\|domain>` | Query organization basic info, capacity, quotas, fixed-domain records, and domain settings |
 | `openyida get-permission <appType> <formUuid>` | Query form permission configuration |
-| `openyida save-permission <appType> <formUuid> [options]` | Save form permission configuration |
+| `openyida save-permission <appType> <formUuid> [options]` | Save form permission configuration, including raw `--field-permission <json>` |
 | `openyida corp-manager <sub-command>` | Manage platform admins, sub-admins, app admins, and address book visibility |
 | `openyida verify-short-url <appType> <formUuid> <url>` | Verify a short URL |
 | `openyida save-share-config <appType> <formUuid> <url> <isOpen> [openAuth]` | Save public access or sharing configuration |

package/bin/yida.js

@@ -705,6 +705,13 @@ async function main() {
       break;
     }
 
+    case 'nav-group':
+    case 'group': {
+      const { run: runNavGroup } = require('../lib/app/nav-group');
+      await runNavGroup(args);
+      break;
+    }
+
     case 'app-permission': {
       const { run: runAppPermission } = require('../lib/app-permission/app-permission');
       await runAppPermission(args);
@@ -919,6 +926,12 @@ async function main() {
       break;
     }
 
+    case 'agent-center': {
+      const { run: runAgentCenter } = require('../lib/agent-center/agent-center');
+      await runAgentCenter(args);
+      break;
+    }
+
     case 'flash-to-prd': {
       const { run: runFlashToPrd } = require('../lib/flash-note/flash-to-prd');
       await runFlashToPrd(args);

package/lib/agent-center/agent-center.js

@@ -0,0 +1,261 @@
+'use strict';
+
+const fs = require('fs');
+
+const {
+  listAgentTasks,
+  createAgentTask,
+  updateAgentTask,
+  cancelAgentTask,
+  isLeaderShip,
+  getLastDepartureAgent,
+  getAgentRange,
+} = require('./api');
+const { searchUsers } = require('../corp-manager/api');
+
+const USAGE = `openyida agent-center - 代理中心
+
+Usage:
+  openyida agent-center list [--status ALL|DIS|EFF|OUT|CANCEL] [--keyword TEXT] [--page N] [--size N]
+  openyida agent-center search-user <keyword> [--dept <text>] [--size N]
+  openyida agent-center create --source-user <userId> --target-user <userId> [--type normal|departure] [options]
+  openyida agent-center update <agentUuid> --target-user <userId> [--type normal|departure] [options]
+  openyida agent-center cancel <agentUuid> --type normal|departure
+  openyida agent-center range <agentUuid>
+  openyida agent-center is-leader
+  openyida agent-center last-departure
+
+Create/update options for normal agents:
+  --start <time>                 开始时间，例如 "2026-05-20 09:00" 或毫秒时间戳
+  --end <time>                   结束时间，例如 "2026-05-21 18:00" 或毫秒时间戳
+  --category execute|start       execute=代处理流程，start=代提交流程，默认 execute
+  --notify-source y|n            代理任务是否通知被代理人，默认 n
+  --range all|part               代理范围，默认 all
+  --range-form <appType:formUuid[,appType:formUuid]>
+  --range-json <json>            代理范围 JSON 数组，元素含 appType/formUuid
+  --range-file <file>            从 JSON 文件读取代理范围
+
+Examples:
+  openyida agent-center list --status EFF --size 20
+  openyida agent-center search-user "余浩" --dept "宜搭,钉钉官方同学"
+  openyida agent-center create --source-user 111 --target-user 222 --start "2026-05-20 09:00" --end "2026-05-21 18:00"
+  openyida agent-center create --type departure --source-user 111 --target-user 222
+  openyida agent-center cancel Agent_xxx --type departure
+`;
+
+function fail(message) {
+  console.error(message);
+  console.error(USAGE);
+  process.exit(1);
+}
+
+function parseCliOptions(tokens) {
+  const positionals = [];
+  const options = {};
+
+  for (let i = 0; i < tokens.length; i += 1) {
+    const token = tokens[i];
+    if (token.startsWith('--')) {
+      const key = token.slice(2).replace(/-/g, '_');
+      const next = tokens[i + 1];
+      const value = next && !next.startsWith('--') ? next : true;
+      if (Object.prototype.hasOwnProperty.call(options, key)) {
+        options[key] = Array.isArray(options[key]) ? options[key].concat(value) : [options[key], value];
+      } else {
+        options[key] = value;
+      }
+      if (value !== true) {
+        i += 1;
+      }
+    } else {
+      positionals.push(token);
+    }
+  }
+
+  return { positionals, options };
+}
+
+function splitList(value) {
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap(splitList);
+  }
+  return String(value).split(',').map(item => item.trim()).filter(Boolean);
+}
+
+function toPositiveInt(value, defaultValue) {
+  const parsed = Number.parseInt(value || `${defaultValue}`, 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return defaultValue;
+  }
+  return parsed;
+}
+
+function parseTimestamp(value, flagName) {
+  if (value === undefined || value === null || value === '') {
+    return undefined;
+  }
+  if (/^\d+$/.test(String(value))) {
+    return Number(value);
+  }
+  const normalized = String(value).trim().replace(/\//g, '-');
+  const parsed = Date.parse(normalized);
+  if (!Number.isFinite(parsed)) {
+    throw new Error(`${flagName} 不是有效时间：${value}`);
+  }
+  return parsed;
+}
+
+function parseRangeToken(token) {
+  const [appType, formUuid] = String(token).split(':').map(part => part && part.trim());
+  if (!appType || !formUuid) {
+    throw new Error(`代理范围格式必须是 appType:formUuid：${token}`);
+  }
+  return { appType, formUuid };
+}
+
+function parseRangeValue(options) {
+  if (options.range_file) {
+    return JSON.parse(fs.readFileSync(options.range_file, 'utf8'));
+  }
+  if (options.range_json) {
+    return JSON.parse(options.range_json);
+  }
+  const tokens = splitList(options.range_form || options.range_forms);
+  if (tokens.length > 0) {
+    return tokens.map(parseRangeToken);
+  }
+  return undefined;
+}
+
+function firstOption(options, keys) {
+  for (const key of keys) {
+    if (options[key] !== undefined) {
+      return options[key];
+    }
+  }
+  return undefined;
+}
+
+function buildMutationOptions(positionals, options) {
+  const typeFromPosition = ['normal', 'departure', 'depart', 'dismissed', 'NORMAL', 'DEPARTURE'].includes(positionals[0])
+    ? positionals.shift()
+    : undefined;
+  const rangeValue = parseRangeValue(options);
+  const rangeType = firstOption(options, ['range', 'agent_range_type', 'range_type']) || (rangeValue ? 'part' : undefined);
+  return {
+    type: firstOption(options, ['type', 'agent_type']) || typeFromPosition || 'normal',
+    sourceUserId: firstOption(options, ['source_user', 'source_user_id', 'from_user', 'source']),
+    targetUserId: firstOption(options, ['target_user', 'target_user_id', 'to_user', 'target']),
+    start: parseTimestamp(firstOption(options, ['start', 'gmt_start_date']), '--start'),
+    end: parseTimestamp(firstOption(options, ['end', 'gmt_end_date']), '--end'),
+    category: firstOption(options, ['category', 'agent_category']),
+    notifySource: firstOption(options, ['notify_source', 'origin_is_view']),
+    rangeType,
+    rangeValue,
+  };
+}
+
+function printJson(payload) {
+  console.log(JSON.stringify(payload, null, 2));
+}
+
+async function runList(options) {
+  printJson(await listAgentTasks({
+    status: options.status,
+    keyword: options.keyword || options.keywords,
+    page: toPositiveInt(options.page || options.page_index, 1),
+    size: toPositiveInt(options.size || options.page_size, 10),
+  }));
+}
+
+async function runSearchUser(positionals, options) {
+  const keyword = positionals[0];
+  if (!keyword) {
+    fail('缺少搜索关键词');
+  }
+  printJson(await searchUsers({
+    keyword,
+    dept: options.dept || options.department,
+    size: toPositiveInt(options.size, 50),
+  }));
+}
+
+async function runCreate(positionals, options) {
+  const mutation = buildMutationOptions(positionals, options);
+  printJson(await createAgentTask(mutation));
+}
+
+async function runUpdate(positionals, options) {
+  const agentUuid = positionals.shift();
+  if (!agentUuid) {
+    fail('缺少 agentUuid');
+  }
+  const mutation = buildMutationOptions(positionals, options);
+  printJson(await updateAgentTask({
+    ...mutation,
+    agentUuid,
+  }));
+}
+
+async function runCancel(positionals, options) {
+  const agentUuid = positionals[0];
+  if (!agentUuid) {
+    fail('缺少 agentUuid');
+  }
+  printJson(await cancelAgentTask({
+    agentUuid,
+    type: options.type || options.agent_type || positionals[1] || 'normal',
+  }));
+}
+
+async function runRange(positionals) {
+  const agentUuid = positionals[0];
+  if (!agentUuid) {
+    fail('缺少 agentUuid');
+  }
+  printJson(await getAgentRange({ agentUuid }));
+}
+
+async function run(args) {
+  const { positionals, options } = parseCliOptions(args);
+  const action = positionals.shift();
+
+  if (!action || action === '--help' || action === '-h') {
+    console.log(USAGE);
+    return;
+  }
+
+  if (action === 'list') {
+    await runList(options);
+  } else if (action === 'search-user') {
+    await runSearchUser(positionals, options);
+  } else if (action === 'create') {
+    await runCreate(positionals, options);
+  } else if (action === 'update') {
+    await runUpdate(positionals, options);
+  } else if (action === 'cancel' || action === 'revoke') {
+    await runCancel(positionals, options);
+  } else if (action === 'range') {
+    await runRange(positionals);
+  } else if (action === 'is-leader') {
+    printJson(await isLeaderShip());
+  } else if (action === 'last-departure') {
+    printJson(await getLastDepartureAgent());
+  } else {
+    fail(`未知 agent-center 子命令：${action}`);
+  }
+}
+
+module.exports = {
+  USAGE,
+  parseCliOptions,
+  splitList,
+  parseTimestamp,
+  parseRangeToken,
+  parseRangeValue,
+  buildMutationOptions,
+  run,
+};