openxiangda 1.0.93 → 1.0.95

package/lib/cli.js

@@ -237,6 +237,10 @@ async function update(args) {
   const requestedSubcommand = args[0] && !args[0].startsWith('--') ? args[0] : 'check';
   const parsedArgs = requestedSubcommand === args[0] ? args.slice(1) : args;
   const { flags } = parseArgs(parsedArgs);
+  if (wantsSubcommandHelp(requestedSubcommand, flags)) {
+    print('用法: openxiangda update check|install [--json] [--registry https://registry.npmjs.org] [--no-skills]');
+    return;
+  }
   const registry = normalizeNpmRegistry(flags.registry || OFFICIAL_NPM_REGISTRY);
 
   if (requestedSubcommand === 'check') {
@@ -457,8 +461,12 @@ async function design(args) {
 
 async function doctor(args) {
   const { flags } = parseArgs(args);
+  if (flags.help || flags.h) {
+    print('用法: openxiangda doctor [--profile name] [--app-type APP_XXX] [--agent codex] [--json]');
+    return;
+  }
   const config = loadConfig();
-  const profileName = flags.profile || config.currentProfile;
+  const profileName = resolveDoctorProfileName(config, flags);
   const result = {
     cli: {
       version: CURRENT_VERSION,
@@ -553,6 +561,24 @@ async function doctor(args) {
   printDoctorReport(result);
 }
 
+function resolveDoctorProfileName(config, flags) {
+  if (flags.profile) return flags.profile;
+  const state = loadProjectState();
+  const boundEntries = Object.entries(state.profiles || {}).filter(([, bound]) => bound?.appType);
+  const requestedAppType = flags['app-type'];
+  if (requestedAppType) {
+    const matched = boundEntries.find(([, bound]) => bound.appType === requestedAppType);
+    if (matched) return matched[0];
+  }
+  if (config.currentProfile && state.profiles?.[config.currentProfile]?.appType) {
+    return config.currentProfile;
+  }
+  if (boundEntries.length === 1) {
+    return boundEntries[0][0];
+  }
+  return config.currentProfile;
+}
+
 function printDoctorReport(result) {
   const lines = [
     `OpenXiangda doctor v${result.cli.version}`,
@@ -577,6 +603,10 @@ function printDoctorReport(result) {
 async function platform(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda platform add|list|use|remove');
+    return;
+  }
   const config = loadConfig();
 
   if (subcommand === 'add') {
@@ -652,6 +682,16 @@ async function platform(args) {
 
 async function login(args) {
   const { flags, positional } = parseArgs(args);
+  if (
+    flags.help ||
+    flags.h ||
+    positional[0] === 'help' ||
+    positional[0] === '--help' ||
+    positional[0] === '-h'
+  ) {
+    print('用法: openxiangda login <platform-url> [--profile name] [--no-open] [--json]');
+    return;
+  }
   const config = loadConfig();
   const rawUrl = positional[0];
   const profileName = flags.profile || config.currentProfile || 'default';
@@ -765,6 +805,10 @@ function normalizePlatformSessionUrl(value, baseUrl) {
 async function auth(args) {
   const [subcommand, ...rest] = args;
   const { flags } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda auth status|refresh|logout [--profile name] [--json]');
+    return;
+  }
 
   if (subcommand === 'status') {
     const config = loadConfig();
@@ -819,6 +863,10 @@ async function auth(args) {
 
 async function env(args) {
   const { flags } = parseArgs(args);
+  if (flags.help || flags.h) {
+    print('用法: openxiangda env [--profile name] [--json]');
+    return;
+  }
   const config = loadConfig();
   const globalEnv = loadGlobalEnv();
   const profileName = flags.profile || config.currentProfile;
@@ -856,6 +904,12 @@ async function env(args) {
 async function feedback(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print(
+      '用法: openxiangda feedback preview|submit --summary <text> [--type bug] [--severity medium] [--profile name] [--yes] [--json]'
+    );
+    return;
+  }
 
   if (subcommand !== 'preview' && subcommand !== 'submit') {
     fail(
@@ -1279,6 +1333,10 @@ function summarizeOssEnv(globalEnv) {
 async function workspace(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda workspace init|bind|publish [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources]');
+    return;
+  }
   const config = loadConfig();
 
   if (subcommand === 'init') {
@@ -1411,6 +1469,10 @@ async function workspace(args) {
 async function app(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda app list|create|snapshot [--profile name] [--json]');
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -1481,6 +1543,10 @@ function extractCreatedAppType(data) {
 async function form(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda form list|create|bind|pull|publish [--profile name] [--json]');
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -1589,6 +1655,10 @@ async function form(args) {
 async function page(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda page list|publish|bind|releases|activate [--profile name] [--json]');
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -1709,6 +1779,10 @@ async function page(args) {
 async function menu(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda menu list|create|update|sort|bind|delete [--profile name] [--json]');
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -2794,6 +2868,12 @@ async function notification(args) {
 async function permission(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print(
+      '用法: openxiangda permission role-list|role-create|role-update|role-delete|role-bind|role-users|role-add-users|page-group-list|page-group-create|page-group-update|page-group-delete|page-group-bind|form-group-list|form-group-create|form-group-update|form-group-delete|form-group-bind|form-summary|menu-permissions|audit'
+    );
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -3246,6 +3326,12 @@ async function permission(args) {
 async function settings(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print(
+      '用法: openxiangda settings get|save|indexes|indexes-save|data-management|data-management-save|public-access|public-access-save|public-access-delete'
+    );
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -3841,6 +3927,16 @@ function formatBytes(value) {
 async function inspect(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (
+    subcommand === 'help' ||
+    subcommand === '--help' ||
+    subcommand === '-h' ||
+    flags.help ||
+    flags.h
+  ) {
+    print('用法: openxiangda inspect app|form|workflow|automation|permissions [--profile name] [--json]');
+    return;
+  }
   const config = loadConfig();
   const profileName = flags.profile || config.currentProfile;
 
@@ -3947,6 +4043,7 @@ async function commands(args) {
       'permission form-group-list|form-group-create|form-group-update|form-group-delete|form-group-bind|form-summary|menu-permissions',
       'settings get|save|indexes|indexes-save|data-management|data-management-save|public-access|public-access-save|public-access-delete',
       'resource validate|plan|publish|pull|typegen|explain',
+      'runtime deploy|releases|activate',
       'inspect app|form|workflow|automation|permissions',
       'feedback preview|submit',
       'skill install|status|bootstrap',
@@ -3980,6 +4077,10 @@ function printWorkspaceInitReport(result) {
 async function skill(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
+  if (wantsSubcommandHelp(subcommand, flags)) {
+    print('用法: openxiangda skill install|status [--agent codex|claude|qoder|dual] [--dest <skills-dir>] [--force] [--dry-run] [--json]\n      openxiangda skill bootstrap [<dir>] [--force] [--dry-run] [--json]');
+    return;
+  }
   const options = {
     agent: flags.agent || 'codex',
     dest: flags.dest,
@@ -4965,6 +5066,9 @@ function validateWorkspaceResources(manifest) {
   const errors = [];
   const warnings = [];
   const counts = {};
+  if (!fs.existsSync(manifest.baseDir)) {
+    warnings.push('未发现 src/resources；多资源正式开发请在该目录声明资源，或使用一等 CLI 子命令进行只读诊断/小步维护');
+  }
   for (const spec of RESOURCE_SPECS) {
     const items = manifest[spec.key] || [];
     counts[spec.key] = items.length;

package/lib/design-gates.js

@@ -219,15 +219,77 @@ const DESIGN_GATE_TOPICS = [
   },
 ];
 
+const DESIGN_GATE_TOPIC_ALIASES = {
+  app: 'new-app',
+  application: 'new-app',
+  dashboard: 'complex-page',
+  page: 'complex-page',
+  pages: 'complex-page',
+  login: 'auth',
+  register: 'auth',
+  registration: 'auth',
+  sso: 'auth',
+  public: 'public-access',
+  guest: 'public-access',
+  visitor: 'public-access',
+  visitors: 'public-access',
+  permission: 'permissions',
+  role: 'permissions',
+  roles: 'permissions',
+  workflow: 'workflow-automation',
+  automation: 'workflow-automation',
+  function: 'workflow-automation',
+  functions: 'workflow-automation',
+  'app-function': 'workflow-automation',
+  js_code: 'workflow-automation',
+  jscode: 'workflow-automation',
+  connector: 'connector-notification',
+  connectors: 'connector-notification',
+  notification: 'connector-notification',
+  notifications: 'connector-notification',
+  integration: 'connector-notification',
+  integrations: 'connector-notification',
+  webhook: 'connector-notification',
+  resource: 'resource-maintenance',
+  resources: 'resource-maintenance',
+  maintenance: 'resource-maintenance',
+};
+
+function resolveTopicSelection(topicCode) {
+  if (!topicCode || topicCode === 'all') {
+    return { requested: ['all'], wanted: null, unknown: [] };
+  }
+  const knownCodes = new Set(DESIGN_GATE_TOPICS.map(topic => topic.code));
+  const requested = String(topicCode)
+    .split(/[,/|+\s]+/)
+    .map(item => item.trim())
+    .filter(Boolean);
+  const wanted = new Set();
+  const unknown = [];
+  for (const item of requested) {
+    const normalized = item.toLowerCase();
+    const code = DESIGN_GATE_TOPIC_ALIASES[normalized] || normalized;
+    if (knownCodes.has(code)) {
+      wanted.add(code);
+    } else {
+      unknown.push(item);
+    }
+  }
+  return { requested, wanted, unknown };
+}
+
 function selectTopics(topicCode) {
-  if (!topicCode || topicCode === 'all') return DESIGN_GATE_TOPICS;
-  const wanted = new Set(String(topicCode).split(',').map(item => item.trim()).filter(Boolean));
-  return DESIGN_GATE_TOPICS.filter(topic => wanted.has(topic.code));
+  const selection = resolveTopicSelection(topicCode);
+  if (!selection.wanted) return DESIGN_GATE_TOPICS;
+  return DESIGN_GATE_TOPICS.filter(topic => selection.wanted.has(topic.code));
 }
 
 function getDesignGates(topicCode) {
+  const selection = resolveTopicSelection(topicCode);
   return {
     hardRule: DESIGN_GATE_HARD_RULE,
+    requestedTopics: selection.requested,
+    unknownTopics: selection.unknown,
     topics: selectTopics(topicCode),
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.93",
+  "version": "1.0.95",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {
@@ -67,6 +67,7 @@
     "test:resource-plan": "node scripts/resource-plan-smoke.mjs",
     "test:design-gates": "node scripts/design-gates-smoke.mjs",
     "test:resource-cli": "node scripts/resource-cli-smoke.mjs",
+    "test:help-no-side-effects": "node scripts/help-no-side-effects-smoke.mjs",
     "test:app-function-fallback": "node scripts/app-function-source-fallback-smoke.mjs",
     "test:runtime-deploy": "node scripts/runtime-deploy-smoke.mjs",
     "test:skill-install": "bash scripts/skill-install-smoke.sh",