openxiangda 1.0.267 → 1.0.269

package/lib/skills.js

@@ -11,9 +11,9 @@ const MANAGER = 'openxiangda';
 
 const SKILL_SPECS = [
   {
-    name: 'openxiangda',
-    displayName: 'OpenXiangda',
-    shortDescription: '私有化低代码平台 CLI 与 AI skill 入口。',
+    name: 'openxiangda-v1',
+    displayName: 'OpenXiangda V1',
+    shortDescription: 'OpenXiangda V1 维护入口，仅用于 V1 工作区。',
     sourceRelativePath: 'openxiangda-skills',
     type: 'root',
   },
@@ -84,16 +84,8 @@ const SKILL_SPECS = [
   },
 ];
 
-const RETIRED_SKILL_SPECS = [
-  { name: 'openxiangda-v2', sourceRelativePath: 'v2/skills/openxiangda-v2' },
-  { name: 'openxiangda-v2-architecture', sourceRelativePath: 'v2/skills/openxiangda-v2-architecture' },
-  { name: 'openxiangda-v2-frontend', sourceRelativePath: 'v2/skills/openxiangda-v2-frontend' },
-  { name: 'openxiangda-v2-backend', sourceRelativePath: 'v2/skills/openxiangda-v2-backend' },
-  { name: 'openxiangda-v2-data-authz', sourceRelativePath: 'v2/skills/openxiangda-v2-data-authz' },
-  { name: 'openxiangda-v2-workflow-events', sourceRelativePath: 'v2/skills/openxiangda-v2-workflow-events' },
-  { name: 'openxiangda-v2-delivery', sourceRelativePath: 'v2/skills/openxiangda-v2-delivery' },
-  { name: 'openxiangda-v1-maintenance', sourceRelativePath: 'v2/skills/openxiangda-v1-maintenance' },
-];
+// V1 does not own V2 or the unified routing skill, including historical installs.
+const RETIRED_SKILL_SPECS = [];
 
 function getDefaultCodexSkillsDir(env = process.env) {
   const codexHome = env.CODEX_HOME || path.join(os.homedir(), '.codex');
@@ -232,7 +224,7 @@ function getSkillStatusReport(options = {}) {
   const env = options.env || process.env;
 
   // 获取目标目录列表
-  const skillsDirs = getDualSkillsDirs(agent, env);
+  const skillsDirs = options.dest ? [path.resolve(options.dest)] : getDualSkillsDirs(agent, env);
 
   const results = [];
   for (const skillsDir of skillsDirs) {
@@ -265,7 +257,7 @@ function installSkills(options = {}) {
   const force = Boolean(options.force);
 
   // 获取目标目录列表
-  const skillsDirs = getDualSkillsDirs(agent, options.env);
+  const skillsDirs = options.dest ? [path.resolve(options.dest)] : getDualSkillsDirs(agent, options.env);
 
   const results = [];
   for (const skillsDir of skillsDirs) {
@@ -410,7 +402,7 @@ function writeAgentMetadata(spec, skillDir) {
   const defaultPrompt =
     spec.defaultPrompt ||
     (spec.name === 'openxiangda'
-      ? '使用 $openxiangda 处理私有化低代码平台的登录、发布和诊断任务。'
+      ? '使用 $openxiangda-v1 处理 V1 工作区的登录、发布和诊断任务。'
       : `使用 $${spec.name} 处理对应的 OpenXiangda 低代码平台任务。`);
   const content = [
     'interface:',

package/lib/workspace-init.js

@@ -41,6 +41,7 @@ function initWorkspace(options = {}) {
     throw new Error('workspace init 绑定应用时必须同时提供 --profile 和 --app-type');
   }
 
+  const resolvedProfile = profileName ? getProfile(loadConfig(targetDir, { exact: true }), profileName) : null;
   ensureCanInitialize(targetDir, force, templateDir);
   copyTemplate(templateDir, targetDir, {
     __WORKSPACE_PACKAGE_NAME__: packageName,
@@ -49,8 +50,7 @@ function initWorkspace(options = {}) {
 
   let bound = null;
   if (profileName && appType) {
-    const config = loadConfig();
-    const resolved = getProfile(config, profileName);
+    const resolved = resolvedProfile;
     const state = {
       version: 1,
       profiles: {
@@ -125,11 +125,18 @@ function ensureCanInitialize(targetDir, force, templateDir) {
   const entries = fs
     .readdirSync(targetDir)
     .filter(name => !['.DS_Store'].includes(name));
-  if (entries.length > 0 && !force) {
+  if (entries.length > 0 && !force && !isAuthOnlyWorkspace(targetDir, entries)) {
     throw new Error(`目标目录非空: ${targetDir}。如需写入请传 --force`);
   }
 }
 
+function isAuthOnlyWorkspace(targetDir, entries) {
+  if (entries.length !== 1 || entries[0] !== '.openxiangda') return false;
+  const directory = path.join(targetDir, '.openxiangda');
+  if (!fs.lstatSync(directory).isDirectory() || fs.lstatSync(directory).isSymbolicLink()) return false;
+  return fs.readdirSync(directory).every(name => ['profiles.json', '.gitignore'].includes(name) && fs.lstatSync(path.join(directory, name)).isFile() && !fs.lstatSync(path.join(directory, name)).isSymbolicLink());
+}
+
 function normalizeRuntime(value) {
   return value === 'react-spa' || value === 'spa' ? 'react-spa' : 'legacy';
 }
@@ -154,7 +161,7 @@ function copyTemplate(sourceDir, targetDir, replacements, baseDir = sourceDir) {
 function shouldSkipTemplateEntry(baseDir, sourcePath, entryName) {
   if (TEMPLATE_IGNORE_NAMES.has(entryName)) return true;
   const relativePath = path.relative(baseDir, sourcePath).split(path.sep).join('/');
-  return TEMPLATE_IGNORE_PATHS.has(relativePath);
+  return TEMPLATE_IGNORE_PATHS.has(relativePath) || /^\.openxiangda\/(profiles\.json|session\.json)(\.|$)/.test(relativePath);
 }
 
 function applyReplacements(content, replacements) {

package/openxiangda-skills/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: openxiangda
-description: "Use OpenXiangda for private low-code platform work: app workspaces, forms, pages, resources, functions, automations, workflows, permissions, publishing, deployment, diagnosis, profiles, and the openxiangda CLI."
+name: openxiangda-v1
+description: "Maintain existing OpenXiangda V1 workspaces: forms, pages, resources, workflows, permissions, publishing and diagnosis. New applications default to V2; assess V2 adoption for V1 projects still in testing when capability coverage and migration cost permit."
 ---
 
 <!-- OpenXiangda-Policy-Version: 7 -->
@@ -13,10 +13,16 @@ This file is a router and safety card. Read only the one or two subskills select
 
 ## Select the runtime generation first
 
-If the workspace contains `openxiangda.config.ts`, `apps/web`, and `apps/server`, it is a platform-2.0 application. Stop this 1.x resource flow and use the independently released `$openxiangda-v2` unified skill. The 2.0 CLI operates on one immutable application package and does not use SDD or per-resource publishing.
+If the nearest workspace contains `openxiangda.config.ts` or `openxiangda-app.config.ts`, it is a platform-2.0 application; a Nest server is optional. Stop this 1.x resource flow and use the independently released `$openxiangda-v2` skill. The 2.0 CLI operates on one immutable application package and does not use SDD or per-resource publishing.
 
 If the workspace contains `app-workspace.config.ts`, forms/pages/resource manifests, or an existing 1.x state directory, continue with this router. Never migrate a stable 1.x application merely because platform 2.0 is available.
 
+For an existing V1 project, proactively check whether V2 covers its required capabilities, whether it is still in testing, and whether migration cost is manageable. When those conditions hold, recommend V2 first and explain the benefit, rebuild scope and verification cost. Use the unified entry's `openxiangda migrate assess --to v2` for source pointers; confirm the project design, data/workflow mapping, acceptance and rollback before implementing migration. Keep unknown conditions explicit and continue current maintenance with the matching engine until migration is authorized.
+
+## Installation and upgrade
+
+For CLI, Skill and MCP setup or upgrades, read the [unified installation guide](https://github.com/1377385356/openxiangda/blob/master/docs/getting-started.md#upgrade). Install the global launcher with Node.js 24+ using `npm install -g openxiangda@latest --registry=https://registry.npmjs.org`. Use that global command for `migrate assess`; a project-local V1 CLI does not implement it. Workspace updates remain on `legacy-v1`. Refresh matching skills after dependency updates and restart a configured V2 MCP client to load its new project version. Never automatically replace a V1 project dependency with V2.
+
 ## 1.x Delivery V2 is the normal 1.x release path
 
 When `app-workspace.config.ts` declares `deliveryVersion: 2`, all later V1 SDD,
@@ -227,3 +233,5 @@ The lease is app-level promotion ownership, while worktree ownership prevents tw
 - `../openxiangda-open-api/SKILL.md`
 
 Load a reference only when the selected subskill explicitly requires it. Workspace `AGENTS.md` remains authoritative for project-specific constraints.
+
+平台登录态只使用当前工作区的 `.openxiangda/profiles.json`，不再读取或合并全局 profiles。升级后请进入每个项目运行 `openxiangda login <platform-url>`。登录文件自动加入 Git 忽略规则，不得提交或打包。

package/openxiangda-skills/references/architecture-patterns.md

@@ -1,150 +1,150 @@
-# Architecture Patterns
-
-> 面向 AI Agent 的平台架构范式指南：理解「表单为数据存储中枢、代码页承载业务逻辑」的低代码开发模型，并据此构建可发布的应用。
-
----
-
-## 1. 平台设计理念
-
-### 1.1 表单 = 数据存储
-
-- **每个表单（Form）= 一张数据表**：表单 schema 定义即数据结构（字段、类型、校验、关联）。
-- 平台底层按字段建表：简单字段使用原生 SQL 类型列，复杂字段使用 json/jsonb 列存储结构化对象。AI 无需关心建表 DDL、迁移脚本或 CRUD 接口。
-- 表单除了承担「数据录入 UI」，还会自动暴露：列表查询、详情、增删改查 API、字段级权限、流程触发钩子。
-
-### 1.2 低代码 = Schema + 代码页
-
-```
-低代码应用 = 表单（定义数据结构）+ 代码页（实现业务逻辑/编排/可视化）
-```
-
-- **表单层**：声明式 schema (`src/forms/xxx/schema.ts`)，负责字段与数据契约。
-- **代码页层**：React/TSX (`src/pages/xxx/`)，负责非录入场景下的业务交互、数据可视化、聚合操作。
-
-### 1.3 「零后端开发」数据管理模式
-
-| 传统后端 | OpenXiangda 模式 |
-| --- | --- |
-| 设计表结构 + 迁移 | 编写表单 schema |
-| 编写 REST API | 平台自动生成数据 API |
-| 维护权限中间件 | 表单字段级权限 + 部门/角色 |
-| 自建文件存储 | `AttachmentField` 直接接入平台存储 |
+# Architecture Patterns
+
+> 面向 AI Agent 的平台架构范式指南：理解「表单为数据存储中枢、代码页承载业务逻辑」的低代码开发模型，并据此构建可发布的应用。
+
+---
+
+## 1. 平台设计理念
+
+### 1.1 表单 = 数据存储
+
+- **每个表单（Form）= 一张数据表**：表单 schema 定义即数据结构（字段、类型、校验、关联）。
+- 平台底层按字段建表：简单字段使用原生 SQL 类型列，复杂字段使用 json/jsonb 列存储结构化对象。AI 无需关心建表 DDL、迁移脚本或 CRUD 接口。
+- 表单除了承担「数据录入 UI」，还会自动暴露：列表查询、详情、增删改查 API、字段级权限、流程触发钩子。
+
+### 1.2 低代码 = Schema + 代码页
+
+```
+低代码应用 = 表单（定义数据结构）+ 代码页（实现业务逻辑/编排/可视化）
+```
+
+- **表单层**：声明式 schema (`src/forms/xxx/schema.ts`)，负责字段与数据契约。
+- **代码页层**：React/TSX (`src/pages/xxx/`)，负责非录入场景下的业务交互、数据可视化、聚合操作。
+
+### 1.3 「零后端开发」数据管理模式
+
+| 传统后端 | OpenXiangda 模式 |
+| --- | --- |
+| 设计表结构 + 迁移 | 编写表单 schema |
+| 编写 REST API | 平台自动生成数据 API |
+| 维护权限中间件 | 表单字段级权限 + 部门/角色 |
+| 自建文件存储 | `AttachmentField` 直接接入平台存储 |
 | 业务状态流转 | 表单 + `status` 字段 + 操作日志 + domain/service |
 | 真审批流程 | 表单 + workflow + js-code-nodes |
 
 AI Agent 在该平台上写代码时，**不应该考虑数据库、表结构、后端接口**——这些由表单 schema 自动派生。
-
----
-
-## 2. 标准 CRUD 数据流
-
-### 2.1 数据流向
-
-```
-┌──────────────┐    ┌─────────────────┐    ┌────────────────┐    ┌────────────┐
-│ 表单页       │───▶│ 数据存储        │───▶│ 数据管理页     │───▶│ 详情页     │
-│ (录入/编辑)  │    │ (平台数据表)    │    │ (列表/查询)    │    │ (查看)     │
-└──────────────┘    └─────────────────┘    └────────────────┘    └────────────┘
-       ▲                                            │
-       └────────────────────────────────────────────┘
-                     (从列表点编辑回填)
-```
-
-### 2.2 实现步骤
-
-1. **定义表单 schema**：`src/forms/xxx/schema.ts` → 生成数据表 + 录入页。
-2. **编写数据管理页**：`src/pages/xxx/index.tsx` 内使用 `DataManagementList` 组件做列表/查询/批量操作。
-3. **绑定菜单入口**：`openxiangda menu create --type=page --target=/pages/xxx`（指向自定义代码页，**而不是** view 类型）。
-
-### 2.3 反模式：不要使用平台内置 View
-
-> ❌ `openxiangda menu create --type=view --formUuid=FORM_XXX`
-
-平台内置 View 视图灵活性差：列宽/操作列/筛选项受限、无法嵌入业务交互、无法做联动。
-
-> ✅ **统一使用「自定义代码页 + `DataManagementList`」组合**。
-
-#### `DataManagementList` 的优势
-
-- 完全自定义列渲染（`render` 函数、React 节点）。
-- 自定义行操作 / 批量操作按钮。
-- 自定义筛选区（部门选择、人员选择、级联）。
-- 与页面内其他组件（Drawer、Modal、Tabs）自由组合。
-- 仍复用平台分页、查询、导出能力。
-
----
-
-## 3. 数据管理页的标准构建方式
-
-### 3.1 最小可用示例
-
-```tsx
-// src/pages/instrument-list/index.tsx
+
+---
+
+## 2. 标准 CRUD 数据流
+
+### 2.1 数据流向
+
+```
+┌──────────────┐    ┌─────────────────┐    ┌────────────────┐    ┌────────────┐
+│ 表单页       │───▶│ 数据存储        │───▶│ 数据管理页     │───▶│ 详情页     │
+│ (录入/编辑)  │    │ (平台数据表)    │    │ (列表/查询)    │    │ (查看)     │
+└──────────────┘    └─────────────────┘    └────────────────┘    └────────────┘
+       ▲                                            │
+       └────────────────────────────────────────────┘
+                     (从列表点编辑回填)
+```
+
+### 2.2 实现步骤
+
+1. **定义表单 schema**：`src/forms/xxx/schema.ts` → 生成数据表 + 录入页。
+2. **编写数据管理页**：`src/pages/xxx/index.tsx` 内使用 `DataManagementList` 组件做列表/查询/批量操作。
+3. **绑定菜单入口**：`openxiangda menu create --type=page --target=/pages/xxx`（指向自定义代码页，**而不是** view 类型）。
+
+### 2.3 反模式：不要使用平台内置 View
+
+> ❌ `openxiangda menu create --type=view --formUuid=FORM_XXX`
+
+平台内置 View 视图灵活性差：列宽/操作列/筛选项受限、无法嵌入业务交互、无法做联动。
+
+> ✅ **统一使用「自定义代码页 + `DataManagementList`」组合**。
+
+#### `DataManagementList` 的优势
+
+- 完全自定义列渲染（`render` 函数、React 节点）。
+- 自定义行操作 / 批量操作按钮。
+- 自定义筛选区（部门选择、人员选择、级联）。
+- 与页面内其他组件（Drawer、Modal、Tabs）自由组合。
+- 仍复用平台分页、查询、导出能力。
+
+---
+
+## 3. 数据管理页的标准构建方式
+
+### 3.1 最小可用示例
+
+```tsx
+// src/pages/instrument-list/index.tsx
 import { DataManagementList } from 'openxiangda';
-import { Tag, message } from 'antd';
-import { useNavigate } from 'react-router-dom';
-
-export default function InstrumentListPage() {
-  const navigate = useNavigate();
-
-  return (
-    <DataManagementList
-      formUuid="FORM_INSTRUMENT"
-      columns={[
-        { fieldId: 'name', title: '仪器名称' },
-        { fieldId: 'code', title: '编号', width: 140 },
-        {
-          fieldId: 'status',
-          title: '状态',
-          render: (val) => (
-            <Tag color={val.value === 'idle' ? 'green' : 'orange'}>
-              {val.label}
-            </Tag>
-          ),
-        },
-        { fieldId: 'department', title: '所属部门' },
-      ]}
-      actions={[
-        {
-          label: '预约',
-          onClick: (record) => navigate(`/forms/reservation/new?instrumentId=${record.id}`),
-        },
-        {
-          label: '编辑',
-          onClick: (record) => navigate(`/forms/instrument/${record.id}/edit`),
-        },
-      ]}
-      batchActions={['export', 'delete']}
-      filters={[
-        { fieldId: 'status', type: 'select' },
-        { fieldId: 'department', type: 'department-select' },
-        { fieldId: 'owner', type: 'user-select' },
-      ]}
-      onRowClick={(record) => navigate(`/pages/instrument-detail/${record.id}`)}
-    />
-  );
-}
-```
-
-### 3.2 关键 Props 速查
-
-| Prop | 类型 | 说明 |
-| --- | --- | --- |
-| `formUuid` | `string` | 绑定的表单（数据源） |
-| `columns` | `Column[]` | 列定义；`render` 可返回任意 React 节点 |
-| `actions` | `Action[]` | 行级操作按钮 |
-| `batchActions` | `('export' \| 'delete' \| BatchAction)[]` | 批量操作 |
-| `filters` | `Filter[]` | 筛选区字段；支持 `select` / `date-range` / `user-select` / `department-select` 等 |
-| `queryParams` | `Record<string, any>` | 固定查询条件（如「只看我创建的」） |
-| `onRowClick` | `(record) => void` | 行点击事件，常用于跳转详情 |
-
----
-
-## 4. 页面类型与适用场景
-
-| 页面类型 | 实现方式 | 适用场景 |
-| --- | --- | --- |
-| 表单录入 / 编辑页 | `src/forms/xxx/` (`schema.ts` + `page.tsx`) | 新增数据、修改数据 |
+import { Tag, message } from 'antd';
+import { useNavigate } from 'react-router-dom';
+
+export default function InstrumentListPage() {
+  const navigate = useNavigate();
+
+  return (
+    <DataManagementList
+      formUuid="FORM_INSTRUMENT"
+      columns={[
+        { fieldId: 'name', title: '仪器名称' },
+        { fieldId: 'code', title: '编号', width: 140 },
+        {
+          fieldId: 'status',
+          title: '状态',
+          render: (val) => (
+            <Tag color={val.value === 'idle' ? 'green' : 'orange'}>
+              {val.label}
+            </Tag>
+          ),
+        },
+        { fieldId: 'department', title: '所属部门' },
+      ]}
+      actions={[
+        {
+          label: '预约',
+          onClick: (record) => navigate(`/forms/reservation/new?instrumentId=${record.id}`),
+        },
+        {
+          label: '编辑',
+          onClick: (record) => navigate(`/forms/instrument/${record.id}/edit`),
+        },
+      ]}
+      batchActions={['export', 'delete']}
+      filters={[
+        { fieldId: 'status', type: 'select' },
+        { fieldId: 'department', type: 'department-select' },
+        { fieldId: 'owner', type: 'user-select' },
+      ]}
+      onRowClick={(record) => navigate(`/pages/instrument-detail/${record.id}`)}
+    />
+  );
+}
+```
+
+### 3.2 关键 Props 速查
+
+| Prop | 类型 | 说明 |
+| --- | --- | --- |
+| `formUuid` | `string` | 绑定的表单（数据源） |
+| `columns` | `Column[]` | 列定义；`render` 可返回任意 React 节点 |
+| `actions` | `Action[]` | 行级操作按钮 |
+| `batchActions` | `('export' \| 'delete' \| BatchAction)[]` | 批量操作 |
+| `filters` | `Filter[]` | 筛选区字段；支持 `select` / `date-range` / `user-select` / `department-select` 等 |
+| `queryParams` | `Record<string, any>` | 固定查询条件（如「只看我创建的」） |
+| `onRowClick` | `(record) => void` | 行点击事件，常用于跳转详情 |
+
+---
+
+## 4. 页面类型与适用场景
+
+| 页面类型 | 实现方式 | 适用场景 |
+| --- | --- | --- |
+| 表单录入 / 编辑页 | `src/forms/xxx/` (`schema.ts` + `page.tsx`) | 新增数据、修改数据 |
 | 数据管理页 | `src/pages/xxx/` 使用 `DataManagementList` | 列表、查询、批量操作、导出 |
 | 状态流转页 | 普通表单 + 状态字段 + 操作日志 + 代码页 service | 工单、订单、任务等业务状态变化 |
 | 流程表单页 | `src/forms/xxx/` 关联 workflow | 真实审批流程发起、节点处理、审批意见 |
@@ -159,84 +159,84 @@ export default function InstrumentListPage() {
 - 每次状态变更都由 service 完成，统一写操作日志并更新责任人、归属、更新时间和隐藏权限键等派生字段。
 - workflow 只用于真实审批：审批人、审批任务、同意/驳回、审批意见、节点权限、流程记录明确存在的场景。
 - 不要把「待处理 / 处理中 / 已完成 / 已关闭」这类状态流转建成流程表单。
-
----
-
-## 5. 多端架构（PC / Mobile）
-
-### 5.1 分离策略
-
-- **页面层按端独立**：`src/pages/pc/xxx/` 与 `src/pages/mobile/xxx/`，避免单文件内 `if (isMobile)` 满天飞。
-- **入口统一调度**：
-
-  ```tsx
-  // src/pages/instrument/index.tsx
+
+---
+
+## 5. 多端架构（PC / Mobile）
+
+### 5.1 分离策略
+
+- **页面层按端独立**：`src/pages/pc/xxx/` 与 `src/pages/mobile/xxx/`，避免单文件内 `if (isMobile)` 满天飞。
+- **入口统一调度**：
+
+  ```tsx
+  // src/pages/instrument/index.tsx
   import { useDeviceDetect } from 'openxiangda';
-  import PcPage from './pc';
-  import MobilePage from './mobile';
-
-  export default function InstrumentEntry() {
-    const { isMobile } = useDeviceDetect();
-    return isMobile ? <MobilePage /> : <PcPage />;
-  }
-  ```
-
-- **UI 库分端**：
-  - PC → `antd`
-  - Mobile → `antd-mobile`
+  import PcPage from './pc';
+  import MobilePage from './mobile';
+
+  export default function InstrumentEntry() {
+    const { isMobile } = useDeviceDetect();
+    return isMobile ? <MobilePage /> : <PcPage />;
+  }
+  ```
+
+- **UI 库分端**：
+  - PC → `antd`
+  - Mobile → `antd-mobile`
 - **逻辑层共享**：`src/domain/` 与 `src/shared/services/` 在两端复用，确保业务规则一处实现。
-
-### 5.2 共享 / 分离原则
-
-| 层 | PC/Mobile 是否共享 |
-| --- | --- |
-| 业务规则（domain） | ✅ 共享 |
-| 数据服务（services） | ✅ 共享 |
-| Hooks（hooks） | ✅ 多数共享，端相关的拆 `usePcXxx` / `useMobileXxx` |
-| 表单 schema | ✅ 共享（平台组件已多端适配） |
-| 页面布局 / 组件 | ❌ 分离 |
-
----
-
-## 6. 目录组织规范
-
-```
-src/
-├── forms/                  # 表单（每个目录 = 一张数据表）
-│   └── instrument/
-│       ├── schema.ts       # 字段定义
-│       └── page.tsx        # 录入页（可选自定义布局）
-├── pages/                  # 自定义代码页（含数据管理页）
-│   ├── instrument-list/    # 列表/管理
-│   ├── instrument-detail/  # 详情
-│   └── dashboard/          # 仪表盘等业务页
-├── domain/                 # 纯业务逻辑（无 UI、可单测）
-│   └── instrument/
-│       ├── rules.ts
-│       └── types.ts
-├── shared/
-│   ├── services/           # 数据服务层（封装 SDK 调用）
-│   ├── hooks/              # 跨页面 hooks
-│   ├── components/         # 跨页面共享组件
-│   └── utils/              # 通用工具函数
-└── js-code-nodes/          # 工作流 JS 脚本（由 build-js-code.mjs 打包）
-```
-
-### 6.1 命名约定
-
-- 目录与文件统一 `kebab-case`：`instrument-list/`，`use-instrument-form.ts`。
-- React 组件文件首字母大写：`DataPanel.tsx`，与默认导出一致。
-- 表单目录名 = 表单业务名（不含 `Form` 后缀）。
-- 数据管理页目录名建议 `xxx-list`，详情页 `xxx-detail`。
-
-### 6.2 依赖方向（单向）
-
-```
-pages ──▶ shared ──▶ domain
-forms ──▶ shared ──▶ domain
-```
-
-- `domain/` 不依赖 `shared/` 或 UI。
+
+### 5.2 共享 / 分离原则
+
+| 层 | PC/Mobile 是否共享 |
+| --- | --- |
+| 业务规则（domain） | ✅ 共享 |
+| 数据服务（services） | ✅ 共享 |
+| Hooks（hooks） | ✅ 多数共享，端相关的拆 `usePcXxx` / `useMobileXxx` |
+| 表单 schema | ✅ 共享（平台组件已多端适配） |
+| 页面布局 / 组件 | ❌ 分离 |
+
+---
+
+## 6. 目录组织规范
+
+```
+src/
+├── forms/                  # 表单（每个目录 = 一张数据表）
+│   └── instrument/
+│       ├── schema.ts       # 字段定义
+│       └── page.tsx        # 录入页（可选自定义布局）
+├── pages/                  # 自定义代码页（含数据管理页）
+│   ├── instrument-list/    # 列表/管理
+│   ├── instrument-detail/  # 详情
+│   └── dashboard/          # 仪表盘等业务页
+├── domain/                 # 纯业务逻辑（无 UI、可单测）
+│   └── instrument/
+│       ├── rules.ts
+│       └── types.ts
+├── shared/
+│   ├── services/           # 数据服务层（封装 SDK 调用）
+│   ├── hooks/              # 跨页面 hooks
+│   ├── components/         # 跨页面共享组件
+│   └── utils/              # 通用工具函数
+└── js-code-nodes/          # 工作流 JS 脚本（由 build-js-code.mjs 打包）
+```
+
+### 6.1 命名约定
+
+- 目录与文件统一 `kebab-case`：`instrument-list/`，`use-instrument-form.ts`。
+- React 组件文件首字母大写：`DataPanel.tsx`，与默认导出一致。
+- 表单目录名 = 表单业务名（不含 `Form` 后缀）。
+- 数据管理页目录名建议 `xxx-list`，详情页 `xxx-detail`。
+
+### 6.2 依赖方向（单向）
+
+```
+pages ──▶ shared ──▶ domain
+forms ──▶ shared ──▶ domain
+```
+
+- `domain/` 不依赖 `shared/` 或 UI。
 - `shared/` 不依赖 `pages/` 或 `forms/`。
 - 反向依赖（如 domain 导入 pages）= 立刻拒绝。