openxiangda 1.0.24 → 1.0.25

package/lib/cli.js

@@ -72,7 +72,7 @@ Usage:
   openxiangda workspace init [dir] [--name package-name] [--install] [--profile name --app-type APP_XXX]
   openxiangda workspace init [dir] --profile <name> --app-name <app-name> [--install]
   openxiangda workspace bind --profile <name> --app-type <APP_XXX>
-  openxiangda workspace publish --profile <name> [--prune]
+  openxiangda workspace publish --profile <name> [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources] [--prune]
   openxiangda app list [--profile name] [--json]
   openxiangda app create <name> [--profile name] [--description text]
   openxiangda app snapshot <APP_XXX> [--profile name] [--json]
@@ -660,6 +660,7 @@ async function workspace(args) {
   }
 
   if (subcommand === 'publish') {
+    const publishOptions = normalizeWorkspacePublishOptions(flags);
     const state = loadProjectState();
     const bound = state.profiles?.[profileName];
     if (!bound?.appType) {
@@ -672,15 +673,30 @@ async function workspace(args) {
       profileName,
       `/openxiangda-api/v1/apps/${encodeURIComponent(bound.appType)}/snapshot`
     );
-    runWorkspacePublish(profileName, profile, bound.appType);
-    await publishResourcesForWorkspace(config, profileName, {
-      quiet: true,
-      prune: Boolean(flags.prune),
-    });
+    runWorkspacePublish(profileName, profile, bound.appType, publishOptions.workspaceArgs);
+    if (publishOptions.includeResources) {
+      if (publishOptions.dryRun) {
+        const manifest = loadWorkspaceResources();
+        const validation = validateWorkspaceResources(manifest);
+        if (validation.errors.length > 0) {
+          fail(`资源配置校验失败: ${validation.errors[0]}`);
+        }
+        const target = getWorkspaceTarget(config, profileName, {});
+        const plan = await buildResourcePlan(config, target, manifest);
+        printResourcePlan(plan);
+      } else {
+        await publishResourcesForWorkspace(config, profileName, {
+          quiet: true,
+          prune: Boolean(flags.prune),
+        });
+      }
+    } else if (!publishOptions.quietResourceSkip) {
+      print('已跳过 src/resources 发布；如需同时发布资源，传 --resources。');
+    }
     return;
   }
 
-  fail('用法: openxiangda workspace init|bind|publish');
+  fail('用法: openxiangda workspace init|bind|publish [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources]');
 }
 
 async function app(args) {
@@ -2060,7 +2076,7 @@ async function commands(args) {
       'platform add|list|use|remove',
       'auth status|refresh|logout',
       'env',
-      'workspace init|bind|publish [--app-name] [--prune]',
+      'workspace init|bind|publish [--app-name] [--changed|--since|--form|--page|--only|--dry-run|--force|--resources|--skip-resources|--prune]',
       'app list|create|snapshot',
       'form list|create|bind|pull|publish',
       'page list|publish|bind|releases|activate',
@@ -5070,7 +5086,60 @@ async function refreshProfile(config, profileName) {
   };
 }
 
-function runWorkspacePublish(profileName, profile, appType) {
+function readStringFlag(flags, key) {
+  const value = flags[key];
+  if (value === undefined || value === null || value === false) return '';
+  if (value === true) fail(`--${key} 需要提供值`);
+  return String(value).trim();
+}
+
+function normalizeWorkspacePublishOptions(flags) {
+  const targetForm = readStringFlag(flags, 'form');
+  const targetPage = readStringFlag(flags, 'page');
+  const only = readStringFlag(flags, 'only');
+  const since = readStringFlag(flags, 'since');
+  const changed = Boolean(flags.changed || flags['changed-only']);
+  const dryRun = Boolean(flags['dry-run']);
+  const force = Boolean(flags.force);
+  const skipResources = Boolean(flags['skip-resources']);
+  const includeResourcesFlag = Boolean(flags.resources || flags['include-resources']);
+  const prune = Boolean(flags.prune);
+
+  if (targetForm && targetPage) {
+    fail('workspace publish 不能同时使用 --form 和 --page，请分两次发布');
+  }
+  if (changed && (targetForm || targetPage || only)) {
+    fail('workspace publish --changed 不能与 --form、--page 或 --only 同时使用');
+  }
+  if (since && !changed) {
+    fail('workspace publish --since 只能与 --changed 一起使用');
+  }
+  if (skipResources && prune) {
+    fail('workspace publish --skip-resources 不能与 --prune 同时使用');
+  }
+
+  const workspaceArgs = [];
+  if (targetForm) workspaceArgs.push('--form', targetForm);
+  if (targetPage) workspaceArgs.push('--page', targetPage);
+  if (only) workspaceArgs.push('--only', only);
+  if (changed) workspaceArgs.push('--changed');
+  if (since) workspaceArgs.push('--since', since);
+  if (dryRun) workspaceArgs.push('--dry-run');
+  if (force) workspaceArgs.push('--force');
+
+  const targeted = Boolean(targetForm || targetPage || only || changed);
+  const includeResources =
+    !skipResources && (includeResourcesFlag || prune || !targeted);
+
+  return {
+    workspaceArgs,
+    dryRun,
+    includeResources,
+    quietResourceSkip: !targeted || skipResources,
+  };
+}
+
+function runWorkspacePublish(profileName, profile, appType, publishArgs = []) {
   const packageFile = path.join(process.cwd(), 'package.json');
   if (!fs.existsSync(packageFile)) {
     fail('当前目录没有 package.json，无法识别工作区发布脚本');
@@ -5088,7 +5157,9 @@ function runWorkspacePublish(profileName, profile, appType) {
 
   const usePnpm = fs.existsSync(path.join(process.cwd(), 'pnpm-lock.yaml'));
   const command = usePnpm ? 'pnpm' : 'npm';
-  const args = usePnpm ? ['run', scriptName] : ['run', scriptName];
+  const args = publishArgs.length
+    ? ['run', scriptName, '--', ...publishArgs]
+    : ['run', scriptName];
   const result = spawnSync(command, args, {
     cwd: process.cwd(),
     stdio: 'inherit',

package/openxiangda-skills/SKILL.md

@@ -79,6 +79,7 @@ When the user provides a root domain such as `https://yida.wisejob.cn/`, use it
 - If there is no `sy-lowcode-app-workspace`, create one with `openxiangda workspace init <dir>` before writing forms, pages, or JS_CODE nodes.
 - Never treat `openxiangda form create` as page generation. It only creates a low-level platform form shell for diagnostics or for workspace publish internals. The source of user-facing pages is `sy-lowcode-app-workspace`.
 - Publish normal form pages, workflow form pages, and custom code pages through `openxiangda workspace publish --profile <name>` from the app workspace.
+- For routine AI edits, avoid reflexive full publish. First run `openxiangda workspace publish --profile <name> --changed --dry-run`, then use `--changed`, `--page <pageCode>`, `--form <formCode>`, or `--only pages/a,forms/b`. Use full publish only when broad shared/config changes intentionally affect many modules.
 - Never store token data in the project directory. User tokens live in `~/.openxiangda/profiles.json`; project state lives in `.openxiangda/state.json` and stores only IDs and mappings.
 - Use logical resource codes in local files. Platform-specific IDs such as `formUuid`, `pageId`, `workflowId`, and `automationId` must be isolated by profile.
 - Put engineering-managed resources in `src/resources/` and use `openxiangda resource validate|plan|publish|pull`. `workspace publish` publishes workspace forms/pages first, then runs non-destructive resource upsert. Only pass `--prune` when the user explicitly wants local manifests to delete platform-side extras.

package/openxiangda-skills/references/best-practices.md

@@ -140,6 +140,23 @@ groups or backend-side JS_CODE checks.
 - Keep interaction styles consistent across PC and mobile, but do not force the
   same layout component onto both viewports.
 
+## Library Selection
+
+- Do not hand-write mature controls or engines. Use platform components for
+  personnel, departments, files, images, rich text, locations, and data lists.
+- Use `antd` / `antd-mobile` for standard controls, overlays, tables, steps,
+  tabs, forms, and feedback. Avoid raw native inputs unless the behavior is
+  truly trivial and already styled by a wrapper.
+- Use ECharts for charts and dashboards.
+- Use GSAP for complex timeline/scroll/sequence animations; simple transitions
+  can stay in CSS. If an animation-specific skill is available, read it before
+  implementing.
+- For drag/drop, virtual lists, calendars, spreadsheet-like input, QR/barcode,
+  or export/import, research maintained packages and official docs before
+  writing code.
+- New dependencies should have a clear reason and a small adapter layer in the
+  app, not copied third-party internals.
+
 ## Template Catalog
 
 - `customer-profile`: standard form schema with validation, members,

package/openxiangda-skills/references/component-guide.md

@@ -4,14 +4,40 @@
 
 ---
 
-## 1. 核心原则
-
-1. **平台组件优先**：所有平台组件已经接入了组织架构、文件存储、权限、多端适配等平台能力，重写一遍 = 丢能力 + 后续无法维护。
-2. **基于 antd / antd-mobile 包装**：自定义组件必须站在 antd 之上，保证 PC 和移动端的基础体验一致。
-3. **样式走变量与语义类**：使用 CSS 变量、Tailwind 语义类，**禁止**在 JSX 中硬编码颜色、间距、字号、圆角。
-4. **不覆盖组件内部 class**：组件库内部类名（`ant-select-selector` 等）是私有 API，下个版本就可能变。
-
----
+## 1. 核心原则
+
+1. **平台组件优先**：所有平台组件已经接入了组织架构、文件存储、权限、多端适配等平台能力，重写一遍 = 丢能力 + 后续无法维护。
+2. **基于 antd / antd-mobile 包装**：自定义组件必须站在 antd 之上，保证 PC 和移动端的基础体验一致。
+3. **成熟能力先调研开源方案**：图表、动画、拖拽、虚拟列表、富文本、日历、导入导出、复杂表格等，不要直接手写。先查当前项目依赖、官方文档和维护状态，再决定使用库或轻量封装。
+4. **样式走变量与语义类**：使用 CSS 变量、Tailwind 语义类，**禁止**在 JSX 中硬编码颜色、间距、字号、圆角。
+5. **不覆盖组件内部 class**：组件库内部类名（`ant-select-selector` 等）是私有 API，下个版本就可能变。
+
+---
+
+## 1.1 开源库选型规则
+
+AI 在实现成熟交互前必须先判断是否已有可靠组件或库：
+
+| 场景 | 优先方案 | 说明 |
+| --- | --- | --- |
+| PC 表单控件、筛选、弹窗、表格、步骤条 | `antd` | 不要用原生 `<input>` / `<select>` 复刻。用 `Input`、`Input.Search`、`Select`、`DatePicker`、`Table`、`Modal`、`Drawer`、`Form` 等。 |
+| 移动端操作、列表、弹层、Tab | `antd-mobile` | 移动端不要强行套 PC 组件。 |
+| 平台数据录入能力 | `openxiangda` 平台字段组件 | 人员、部门、附件、图片、富文本、位置、数据管理列表优先平台组件。 |
+| 图表、仪表盘、经营看板 | `echarts` + `echarts-for-react` | 不要手写 canvas/SVG 图表，除非只是非常小的装饰图形。 |
+| 复杂时间轴动画、编排动画、滚动动画 | `gsap` | 需要动画库时先查 GSAP 官方文档；如果当前 Agent 有动画/GSAP skill，先读取该 skill。简单 hover/transition 用 CSS 即可。 |
+| 拖拽排序、看板、可拖卡片 | `@dnd-kit/*` | 不要自己处理 pointer/mouse/touch 全套事件。 |
+| 大列表虚拟滚动 | antd Table virtual / `rc-virtual-list` | 不要一次渲染几千行 DOM。 |
+| 日期时间处理 | `dayjs` + antd 日期组件 | 不要手写日期解析、时区格式化。 |
+| 富文本 | 平台 `EditorField` 或成熟编辑器封装 | 不要用 contenteditable 从零做编辑器。 |
+
+选型流程：
+
+1. 先看模板 `package.json` 已有依赖，已有依赖优先复用。
+2. 没有依赖但功能成熟复杂时，调研官方文档、维护状态、包体积和授权，再通过包管理器加入。
+3. 页面代码只写业务适配层，不复制第三方库内部逻辑。
+4. 新增依赖后，在提交说明或实现注释中保留一句选择原因。
+
+---
 
 ## 2. 必须使用平台组件（重做即丢能力）
 

package/openxiangda-skills/references/pages/publish-flow.md

@@ -6,6 +6,32 @@ Preferred publish command:
 openxiangda workspace publish --profile <name>
 ```
 
+For day-to-day AI edits, prefer a targeted publish:
+
+```bash
+# Preview what git-touched forms/pages would publish.
+openxiangda workspace publish --profile <name> --changed --dry-run
+
+# Publish only git-touched src/forms/* and src/pages/* modules.
+openxiangda workspace publish --profile <name> --changed
+
+# Publish one code page or one form when the changed module is known.
+openxiangda workspace publish --profile <name> --page dashboard
+openxiangda workspace publish --profile <name> --form customer
+
+# Publish several explicit modules.
+openxiangda workspace publish --profile <name> --only pages/dashboard,forms/customer
+```
+
+Do not use full workspace publish as a reflex. Full publish is only appropriate
+when many modules were intentionally changed, shared/config changes affect many
+pages, or the incremental cache needs a repair pass. For a single page edit,
+publish that page.
+
+Targeted publish skips `src/resources` by default. Add `--resources` if resource
+manifests changed too, or run `openxiangda resource plan|publish` separately.
+Use `--skip-resources` when you explicitly want forms/pages only.
+
 The CLI injects:
 
 - `OPENXIANGDA_PROFILE`

package/openxiangda-skills/skills/openxiangda-app/SKILL.md

@@ -55,6 +55,7 @@ openxiangda workspace bind --profile <name> --app-type APP_XXX
 - Store platform-specific IDs only in `.openxiangda/state.json`.
 - Use logical local codes for forms, pages, workflows, automations, and menus.
 - Before scaffolding a new business app, read `../../references/best-practices.md` and pick an architecture from the initialized `examples/best-practices/` catalog. Do not generate a large single-file app page when a template pattern already covers the scenario.
+- When publishing after app edits, prefer targeted commands (`workspace publish --changed --dry-run`, then `--changed`, `--page`, `--form`, or `--only`). Do not publish all forms/pages just because one page changed.
 - Use `openxiangda app snapshot <APP_XXX> --profile <name> --json` before changing an existing app.
 
 ## Resource State

package/openxiangda-skills/skills/openxiangda-core/SKILL.md

@@ -142,6 +142,18 @@ openxiangda workspace publish --profile prod
 
 The CLI checks that the target profile is logged in and bound to an app. It then runs the workspace publish script with these environment variables:
 
+For normal development, inspect and publish only changed or targeted modules:
+
+```bash
+openxiangda workspace publish --profile dev --changed --dry-run
+openxiangda workspace publish --profile dev --changed
+openxiangda workspace publish --profile dev --page dashboard
+openxiangda workspace publish --profile dev --form customer
+openxiangda workspace publish --profile dev --only pages/dashboard,forms/customer
+```
+
+Do not run a full publish automatically after a single page or form edit. Full publish is for intentional broad changes, shared/config changes that affect many modules, or cache repair. Targeted publish skips resources by default; pass `--resources` or run `openxiangda resource publish` when resource manifests changed.
+
 - `OPENXIANGDA_PROFILE`
 - `OPENXIANGDA_BASE_URL`
 - `OPENXIANGDA_ACCESS_TOKEN`

package/openxiangda-skills/skills/openxiangda-form/SKILL.md

@@ -39,6 +39,12 @@ Then publish:
 openxiangda workspace publish --profile <name>
 ```
 
+For a single form edit, publish that form only:
+
+```bash
+openxiangda workspace publish --profile <name> --form <formCode>
+```
+
 The workspace publish script receives `OPENXIANGDA_BASE_URL`, `OPENXIANGDA_ACCESS_TOKEN`, and `OPENXIANGDA_APP_TYPE` from the CLI. It creates/binds the platform form shell only when needed, syncs form metadata, builds the React form page bundle, uploads assets, and registers the bundle.
 
 ## Low-level Commands
@@ -77,5 +83,6 @@ Read these references only when writing or reviewing schema:
 - Put validation on field-level `rules`; never generate old top-level validation arrays under `schema.rules`. Top-level `rules` is only for `FormEffect[]` with `when` and `then`.
 - Always provide `options` for option components. `SelectField`, `MultiSelectField`, `RadioField`, `CheckboxField`, and `CascadeSelectField` must not be emitted with `options` undefined. See `../../references/component-guide.md` for the full list and `../../references/platform-data-model.md` for the `{label, value}` storage contract.
 - Workflow form pages use the same workspace form structure plus workflow v3 configuration; publish the form page bundle through workspace publish before treating it as complete.
+- After editing one form, use `workspace publish --form <formCode>` or preview `--changed --dry-run`; do not run full workspace publish by default.
 - Use `openxiangda form pull` or app snapshot before overwriting an existing form.
 - Before assuming a value shape (e.g. dates, attachments, member fields, option fields), verify against `../../references/platform-data-model.md` instead of guessing.

package/openxiangda-skills/skills/openxiangda-page/SKILL.md

@@ -16,6 +16,19 @@ cd /path/to/sy-lowcode-app-workspace
 openxiangda workspace publish --profile <name>
 ```
 
+For a page-only edit, prefer targeted publish:
+
+```bash
+openxiangda workspace publish --profile <name> --page <pageCode>
+```
+
+If multiple files changed and the target is not obvious, preview first:
+
+```bash
+openxiangda workspace publish --profile <name> --changed --dry-run
+openxiangda workspace publish --profile <name> --changed
+```
+
 If the workspace does not exist yet, initialize it first:
 
 ```bash
@@ -61,8 +74,10 @@ Read these references only when editing page code:
 - Store live `pageId`, `routeKey`, and `legacyFormUuid` under the current profile only.
 - Use `openxiangda/runtime` for platform data access instead of hardcoding backend URLs in page code.
 - For reminders, alerts, and business messages, declare `src/resources/notifications/` first and call `sdk.notification`; do not hardcode notification API URLs.
+- Before hand-writing mature UI behavior, consult `../../references/component-guide.md` and use established libraries: platform components for platform data fields, antd/antd-mobile for controls and overlays, ECharts for charts, GSAP for complex animation timelines, and maintained packages such as dnd-kit for drag/drop. Do not rebuild mature controls with raw DOM/native inputs.
 - Named imports from `@ant-design/icons` are supported by the `openxiangda` workspace build proxy, which enumerates icon module exports at runtime.
 - Publish through `openxiangda workspace publish --profile <name>` unless there is a specific repair reason to call `page publish` directly.
+- After editing one code page, publish with `--page <pageCode>` instead of triggering all forms/pages. Use `--changed --dry-run` before `--changed` when git touched several modules.
 - Do not create custom code pages by writing platform schema directly. The source is React workspace code plus `page.config.ts`.
 - Do not scatter hardcoded `/view/...&isRenderNav=false` URLs through page code. Use the runtime navigation API or the local route helper generated for the app shell.
 - Platform menus should bind only the formal app-shell code page for user-facing entry points. Original forms, workflows, and native view pages may remain as development / maintenance resources or permission targets, but should not become the product navigation shell.

package/package.json

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

package/packages/sdk/src/build-source/scripts/publish-all.mjs

@@ -17,6 +17,7 @@ import {
   normalizeOnly,
   planIncrementalPublish,
   printPlan,
+  resolveGitChangedWorkspaceTargets,
 } from "./utils/incremental.mjs";
 
 const require = createRequire(import.meta.url);
@@ -36,11 +37,8 @@ const dryRun = Boolean(args["dry-run"]);
 const targetForm = args.form || "";
 const targetPage = args.page || "";
 const force = Boolean(args.force);
-const only = targetForm
-  ? [`forms/${targetForm}`]
-  : targetPage
-    ? [`pages/${targetPage}`]
-    : normalizeOnly(args.only);
+const changedOnly = Boolean(args.changed || args["changed-only"]);
+const changedSince = args.since || "HEAD";
 
 if (args.help || args.h) {
   console.log(`
@@ -54,6 +52,8 @@ publish-all - 同步、构建、上传并注册应用工作区产物
   --form <name>    只发布指定表单
   --page <name>    只发布指定代码页
   --only <list>    只发布指定模块，如 forms/customer,pages/dashboard
+  --changed        只发布 git 变更触达的 src/forms/* 和 src/pages/*
+  --since <ref>    配合 --changed 使用，默认 HEAD
   --force          忽略增量缓存，强制发布
   --help, -h       显示帮助信息
 `);
@@ -64,6 +64,45 @@ if (targetForm && targetPage) {
   console.error("❌ --form 和 --page 不能同时使用，请分两次发布");
   process.exit(1);
 }
+if (changedOnly && (targetForm || targetPage || args.only)) {
+  console.error("❌ --changed 不能与 --form、--page 或 --only 同时使用");
+  process.exit(1);
+}
+
+const changedTargets = changedOnly
+  ? resolveGitChangedWorkspaceTargets({ since: changedSince })
+  : null;
+if (changedTargets && !changedTargets.available) {
+  console.error(`❌ 无法读取 git 变更: ${changedTargets.error}`);
+  process.exit(1);
+}
+if (changedTargets?.globalFiles?.length) {
+  console.warn(
+    `[publish] --changed 检测到 shared/config 变更: ${changedTargets.globalFiles.join(", ")}`,
+  );
+  console.warn(
+    "[publish] 将只发布直接变更的 forms/pages；若 shared 改动影响其他模块，请显式使用 --only 或不传 --changed。",
+  );
+}
+if (changedTargets?.resourceFiles?.length) {
+  console.warn(
+    `[publish] --changed 检测到资源变更: ${changedTargets.resourceFiles.join(", ")}`,
+  );
+  console.warn("[publish] publish-all 只处理 forms/pages；资源请通过 openxiangda resource plan|publish 处理。");
+}
+
+const only = changedOnly
+  ? changedTargets.only
+  : targetForm
+    ? [`forms/${targetForm}`]
+    : targetPage
+      ? [`pages/${targetPage}`]
+      : normalizeOnly(args.only);
+
+if (changedOnly && only.length === 0) {
+  console.log("✅ 没有检测到 src/forms 或 src/pages 的 git 变更，跳过发布");
+  process.exit(0);
+}
 
 const buildId = process.env.APP_BUILD_ID || createBuildId();
 const childEnv = {

package/packages/sdk/src/build-source/scripts/utils/incremental.mjs

@@ -1,4 +1,5 @@
 import crypto from "node:crypto";
+import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { rootDir } from "./load-config.mjs";
@@ -124,6 +125,100 @@ export function normalizeOnly(value) {
     .filter(Boolean);
 }
 
+function runGit(args) {
+  const result = spawnSync("git", args, {
+    cwd: rootDir,
+    encoding: "utf-8",
+  });
+  if (result.error || result.status !== 0) {
+    return {
+      ok: false,
+      error: result.error?.message || result.stderr || result.stdout || "git command failed",
+      stdout: "",
+    };
+  }
+  return {
+    ok: true,
+    error: "",
+    stdout: result.stdout || "",
+  };
+}
+
+function uniqueSorted(values) {
+  return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+
+function parseGitNameOnly(stdout) {
+  return String(stdout || "")
+    .split(/\r?\n/)
+    .map((item) => item.trim().replace(/\\/g, "/"))
+    .filter(Boolean);
+}
+
+function workspaceTargetForFile(filePath) {
+  const matched = filePath.match(/^src\/(forms|pages)\/([^/]+)\//);
+  if (!matched) return null;
+  return `${matched[1]}/${matched[2]}`;
+}
+
+function isGlobalWorkspaceFile(filePath) {
+  return (
+    filePath === "package.json" ||
+    filePath === "pnpm-lock.yaml" ||
+    filePath === "package-lock.json" ||
+    filePath === "yarn.lock" ||
+    filePath === "app-workspace.config.ts" ||
+    filePath === "tailwind.config.cjs" ||
+    filePath === "postcss.config.cjs" ||
+    filePath === "vite.config.ts" ||
+    filePath === "tsconfig.json" ||
+    filePath === "src/index.css" ||
+    filePath.startsWith("src/shared/")
+  );
+}
+
+export function resolveGitChangedWorkspaceTargets(options = {}) {
+  const since = options.since || "HEAD";
+  const insideWorkTree = runGit(["rev-parse", "--is-inside-work-tree"]);
+  if (!insideWorkTree.ok || insideWorkTree.stdout.trim() !== "true") {
+    return {
+      available: false,
+      error: insideWorkTree.error || "not a git worktree",
+      files: [],
+      only: [],
+      resourceFiles: [],
+      globalFiles: [],
+    };
+  }
+
+  const changed = runGit(["diff", "--name-only", "--relative", since, "--"]);
+  if (!changed.ok) {
+    return {
+      available: false,
+      error: changed.error,
+      files: [],
+      only: [],
+      resourceFiles: [],
+      globalFiles: [],
+    };
+  }
+
+  const untracked = runGit(["ls-files", "--others", "--exclude-standard"]);
+  const files = uniqueSorted([
+    ...parseGitNameOnly(changed.stdout),
+    ...(untracked.ok ? parseGitNameOnly(untracked.stdout) : []),
+  ]);
+
+  return {
+    available: true,
+    error: "",
+    files,
+    only: uniqueSorted(files.map(workspaceTargetForFile).filter(Boolean)),
+    resourceFiles: files.filter((item) => item.startsWith("src/resources/")),
+    globalFiles: files.filter(isGlobalWorkspaceFile),
+  };
+}
+
 function createIncrementalPlan(modules, options = {}, cache = null) {
   const only = normalizeOnly(options.only);
   const selected = only.length

package/packages/sdk/src/build-source/scripts/utils/incremental.test.ts

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { spawnSync } from "node:child_process";
 
 import { afterEach, describe, expect, it, vi } from "vitest";
 
@@ -31,6 +32,24 @@ function createWorkspace() {
   return dir;
 }
 
+function runGit(workspaceRoot: string, args: string[]) {
+  const result = spawnSync("git", args, {
+    cwd: workspaceRoot,
+    encoding: "utf-8",
+  });
+  if (result.status !== 0) {
+    throw new Error(`git ${args.join(" ")} failed: ${result.stderr || result.stdout}`);
+  }
+}
+
+function commitWorkspace(workspaceRoot: string) {
+  runGit(workspaceRoot, ["init"]);
+  runGit(workspaceRoot, ["config", "user.email", "test@example.com"]);
+  runGit(workspaceRoot, ["config", "user.name", "Test User"]);
+  runGit(workspaceRoot, ["add", "."]);
+  runGit(workspaceRoot, ["commit", "-m", "initial"]);
+}
+
 async function loadIncremental(rootDir: string) {
   const previousRoot = process.env.LOWCODE_WORKSPACE_ROOT;
   process.env.LOWCODE_WORKSPACE_ROOT = rootDir;
@@ -75,4 +94,47 @@ describe("incremental publish cache", () => {
 
     expect(incremental.planIncrementalPublish(modules).changed).toHaveLength(0);
   });
+
+  it("resolves git changed files to workspace publish targets", async () => {
+    const workspaceRoot = createWorkspace();
+    commitWorkspace(workspaceRoot);
+
+    fs.writeFileSync(
+      path.join(workspaceRoot, "src", "pages", "dashboard", "index.tsx"),
+      "export default function Dashboard() { return 'changed'; }\n",
+      "utf-8",
+    );
+    fs.mkdirSync(path.join(workspaceRoot, "src", "forms", "customer"), {
+      recursive: true,
+    });
+    fs.writeFileSync(
+      path.join(workspaceRoot, "src", "forms", "customer", "schema.ts"),
+      "export default { code: 'customer' };\n",
+      "utf-8",
+    );
+    fs.mkdirSync(path.join(workspaceRoot, "src", "resources"), {
+      recursive: true,
+    });
+    fs.writeFileSync(
+      path.join(workspaceRoot, "src", "resources", "menus.json"),
+      "[]\n",
+      "utf-8",
+    );
+    fs.mkdirSync(path.join(workspaceRoot, "src", "shared"), {
+      recursive: true,
+    });
+    fs.writeFileSync(
+      path.join(workspaceRoot, "src", "shared", "format.ts"),
+      "export const format = String;\n",
+      "utf-8",
+    );
+
+    const incremental = await loadIncremental(workspaceRoot);
+    const changed = incremental.resolveGitChangedWorkspaceTargets();
+
+    expect(changed.available).toBe(true);
+    expect(changed.only).toEqual(["forms/customer", "pages/dashboard"]);
+    expect(changed.resourceFiles).toEqual(["src/resources/menus.json"]);
+    expect(changed.globalFiles).toEqual(["src/shared/format.ts"]);
+  });
 });

package/templates/sy-lowcode-app-workspace/examples/best-practices/design-style.md

@@ -24,6 +24,12 @@ OpenXiangda business apps should feel like focused operational tools.
 
 - Use platform CSS variables, Tailwind semantic classes, Ant Design, and
   antd-mobile.
+- Use mature packages for mature interactions: antd controls instead of native
+  inputs, ECharts for charts, GSAP for complex animation timelines, and
+  maintained drag/drop or virtual-list libraries when those behaviors are
+  required.
+- Research package docs and current maintenance before adding a new dependency;
+  write business adapters instead of copying library internals.
 - Keep page styles in `styles.css`; avoid large inline style objects.
 - Keep reusable visual states in shared components: status tags, query states,
   confirmation triggers, and operation timelines.

package/templates/sy-lowcode-app-workspace/package.json

@@ -18,6 +18,7 @@
     "register": "lowcode-workspace register",
     "register-bundle": "lowcode-workspace register",
     "publish:all": "lowcode-workspace publish-all",
+    "publish:changed": "lowcode-workspace publish-all --changed",
     "openxiangda:publish": "lowcode-workspace publish-all",
     "ai:update": "pnpm dlx openxiangda@latest lowcode-workspace update --channel latest",
     "ai:migrate": "pnpm dlx openxiangda@latest lowcode-workspace migrate",