@mingfuyun/star-allinone 0.3.2 → 0.3.3

package/README.md

@@ -1,6 +1,18 @@
 # @mingfuyun/star-allinone
 
-星系运维前端能力包 - 包含Cron表达式生成器等实用组件
+星系运维前端能力包。运行时只导出 Cron / CustomDrawer / BaseModal / HocModal / ErrorBoundary。表格、布局、权限包装在**业务仓**，不在本包。
+
+**导入合同（写错会被 `doctor` 拦住）：**
+
+| 能力 | 从哪里 import | 不要 |
+| --- | --- | --- |
+| 弹层 overlays | `import { CustomDrawer, BaseModal, HocModal } from '@mingfuyun/star-allinone'` | 不要从 `@/components/CustomDrawer` 抄一份 |
+| 错误边界 | `import { ErrorBoundary } from '@mingfuyun/star-allinone'` | — |
+| Cron | `import { Cron } from '@mingfuyun/star-allinone'` | — |
+| 管理列表表格 | `import MFProTable from '@/components/CommonTable/MFProTable'` | **没有** `MFTablePro`。不要从本包 import 表格 |
+| 请求 | `import Service from '@/services'`（内部 `MFRequest`） | 页面不要直接 axios |
+
+Peer 是 **React 18.3.1**，不是 React 19。
 
 ## 📦 安装
 
@@ -35,9 +47,10 @@ pnpm exec star-allinone skills sync --dry-run
 pnpm exec star-allinone skills sync
 pnpm exec star-allinone gen service --operation "GET /api/v1/devices/"
 pnpm exec star-allinone gen page --feature Widgets --route /widgets --title 组件管理 --list-operation "GET /api/v1/widgets/"
+pnpm exec star-allinone doctor
 ```
 
-`gen service` 按 OpenAPI/Swagger 写一条 `MFRequest` 方法和对应类型。`gen page` 生成标准列表页骨架，并可先生成相关 Service。
+`gen service` 按 OpenAPI/Swagger 写一条 `MFRequest` 方法和对应类型。`gen page` 按 schema 生成列类型、必填和 enum 表单，探测到 `src/components/Page/Container/config.tsx` 时注册 Tab。`doctor` 检查配置、OpenAPI、`MFProTable` 路径、Skill 是否过期、以及错误 import。
 
 `list` 查看包内公共 skill。`sync` 把它们写入当前项目的 `.agents/skills/shared-*`，会整体替换过期的 `shared-*`，但不会改 `custom-*`。仓库根没有 `AGENTS.md` 时，会从 `examples/AGENTS.md` 补一份，已有文件不覆盖。
 
@@ -132,52 +145,15 @@ pnpm install
 
 ### 在 Umi 项目中使用
 
-如果您的项目使用 **Umi** 框架，组件库会自动从您的项目中获取 `@umijs/max` 的能力（如 `useAccess`）。
-
-**确保安装 peerDependencies：**
-
-```bash
-# Umi 项目通常已经安装了 @umijs/max，如果没有，请安装：
-npm install @umijs/max
-# 或
-yarn add @umijs/max
-# 或
-pnpm add @umijs/max
-```
-
-**工作原理：**
-
-1. 组件库通过 `webpack externals` 配置，不会打包 `@umijs/max`
-2. 运行时，组件库会从业务项目的 `node_modules` 中动态获取 `@umijs/max`
-3. 组件库中的权限相关功能（如 `MFTablePro` 的权限过滤）会自动使用您项目中的 `useAccess` Hook
-
-**示例：在 Umi 项目中使用带权限的组件**
+本包 **不导出表格**。Umi Max 管理端列表用业务仓自己的 `MFProTable`（权限过滤走项目里的 `useAccess` / `withAuth`）：
 
 ```tsx
-import React from 'react';
-import { MFTablePro } from '@mingfuyun/star-allinone';
-import { useAccess } from '@umijs/max';
-
-function TablePage() {
-  // 组件库会自动使用您项目中的 useAccess
-  // 无需手动传递，组件库内部会自动获取
-  return (
-    <MFTablePro
-      columns={[
-        {
-          title: '操作',
-          dataIndex: 'action',
-          render: (_, record) => (
-            <Button permission="edit">编辑</Button>
-          ),
-        },
-      ]}
-      // ... 其他配置
-    />
-  );
-}
+import MFProTable from '@/components/CommonTable/MFProTable';
+import { CustomDrawer, HocModal } from '@mingfuyun/star-allinone';
 ```
 
+完整 props 合同见同步后的 `.agents/skills/shared-project-conventions/references/mfprotable.md`。
+
 ## 🚀 快速开始
 
 ### 基础使用
@@ -603,12 +579,12 @@ function Page() {
 
 ## 📋 依赖要求
 
-- React >= 19.1.1
-- React-DOM >= 19.1.1
+- React **18.3.1**（`peerDependencies`，与星眼/星链一致）
+- React-DOM 18.3.1
 - Antd >= 5.27.3
-- cron-validator >= 1.4.0 (用于Cron表达式验证)
+- cron-validator >= 1.4.0（Cron 表达式验证）
 
-**重要提示**：组件库使用 `peerDependencies` 管理 React 和 Antd，确保你的项目中已安装这些依赖。
+**重要提示**：不要把本包升到 React 19。业务仓和脚手架都是 React 18。
 
 ### 常见问题排查
 
@@ -628,35 +604,19 @@ function Page() {
    public-hoist-pattern[]=*react*
    ```
 
-#### 2. "Cannot read properties of undefined (reading 'recentlyCreatedOwnerStacks')" 错误
+#### 2. 多个 React 实例
 
-这是 React 19 的一个已知问题，可能的原因和解决方案：
+`Invalid hook call` 或 owner stack 报错，通常是 hoist 出了两份 React。用 `pnpm list react` 确认只有 18.3.1，并在 `.npmrc` 中 hoist React：
 
-1. **React 版本问题**：确保使用 React 19.0.0 或更高版本（推荐 19.1.1+）
-2. **多个 React 实例**：确保项目中只有一个 React 实例
-   ```bash
-   # 检查是否有多个 React 实例
-   npm ls react
-   # 或
-   pnpm list react
-   ```
-3. **pnpm 配置**：如果使用 pnpm，在 `.npmrc` 中添加：
-   ```ini
-   shamefully-hoist=true
-   public-hoist-pattern[]=*react*
-   public-hoist-pattern[]=*react-dom*
-   ```
-4. **清除缓存**：尝试清除构建缓存和 node_modules
-   ```bash
-   rm -rf node_modules .next dist build
-   npm install
-   # 或
-   pnpm install
-   ```
-5. **降级到 React 18**：如果问题持续，可以考虑暂时使用 React 18：
-   ```bash
-   npm install react@^18.0.0 react-dom@^18.0.0
-   ```
+```ini
+shamefully-hoist=true
+public-hoist-pattern[]=*react*
+public-hoist-pattern[]=*react-dom*
+```
+
+## 云效门禁
+
+业务仓流水线没有仓库内 YAML。建议在云效构建步骤里显式跑 `pnpm typecheck && pnpm lint`。本包的 `npm test` 只跑 codegen fixtures。发版前可用 `ANALYZE=1` 看 chunk。xlsx / 编辑器 / 图表必须 `import()`，不要写进 `app.ts`。
 
 ## 🔧 开发
 

package/examples/AGENTS.md

@@ -4,23 +4,35 @@ This is a Umi Max + Ant Design 5 PC admin app. Shared skills live in `.agents/sk
 
 Always-on instructions are this file. Do not add `.cursor/rules`.
 
+Peer React is **18.3.1**. The npm package does not export a table.
+
+## Import contract
+
+- Lists: `import MFProTable from '@/components/CommonTable/MFProTable'`. There is no `MFTablePro`. Never import a table from `@mingfuyun/star-allinone`.
+- Overlays: `import { CustomDrawer, BaseModal, HocModal } from '@mingfuyun/star-allinone'`. Do not add or keep `src/components/CustomDrawer` (or local BaseModal / HocModal).
+- Package runtime exports only: `Cron`, `CustomDrawer`, `BaseModal`, `HocModal`, `ErrorBoundary`.
+- Pages: `import Service from '@/services'`. Do not call axios or `src/services/request.tsx` from pages.
+
+Props for `MFProTable` are in `.agents/skills/shared-project-conventions/references/mfprotable.md` after skills sync.
+
 ## Default workflow
 
 User-facing shared entries only:
 
 - One endpoint: `pnpm exec star-allinone gen service --operation "METHOD /path/"` or `$shared-api-to-service`.
 - Pages: `$shared-design-to-page`. Standard lists run `pnpm exec star-allinone gen page` inside that skill.
+- Project health: `pnpm exec star-allinone doctor`.
 - Review and commit: `$shared-review-and-submit`. Wait for confirmation.
 - Test publish: `$shared-publish-test` after explicit pipeline confirmation.
 
 ## Hard rules
 
 - For non-trivial changes, read `.agents/skills/shared-project-conventions/references/architecture.md`.
-- Pages use `import Service from '@/services'`. Do not call axios or `src/services/request.tsx` from pages.
-- Lists: `MFProTable`. Forms: `ProForm`. Overlays: `CustomDrawer`, `BaseModal`, `HocModal` from `@mingfuyun/star-allinone`.
 - Keep columns and actions in `const.tsx`. Empty cells render as `-`.
 - Keep DTOs in the domain `typings.d.ts` namespace. Preserve backend snake_case.
 - Do not edit `src/services/request.tsx` for a single endpoint.
 - Every `await` uses try/catch. Do not use `Modal.confirm`.
 - After TypeScript changes run `pnpm typecheck`.
+- Do not treat `pnpm test` as unit tests unless that script actually runs a test runner.
+- Heavy modules (`xlsx`, editors, charts) must be `import()`. Do not add them to `src/app.ts`.
 - If `.agents/project/conventions.md` or `.agents/project/review-rules.md` exists, apply them as additions only.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingfuyun/star-allinone",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "星系运维前端能力包",
   "main": "dist/index.js",
   "bin": {
@@ -40,7 +40,9 @@
     "publish:dev": "node scripts/publish.js --dev",
     "skills:sync": "node scripts/cli.js skills sync",
     "skills:list": "node scripts/cli.js skills list",
+    "doctor": "node scripts/cli.js doctor",
     "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
     "test": "node scripts/gen/fixtures/run.js",
     "dev": "webpack --mode=none --watch",
     "clean": "rm -rf dist"
@@ -76,7 +78,7 @@
     "webpack-cli": "^5.1.4"
   },
   "peerDependencies": {
-    "react": "18.3.1"
+    "react": "^18.3.1"
   },
   "publishConfig": {
     "access": "public",

package/scripts/cli.js

@@ -17,6 +17,7 @@ function usage() {
   console.log(`Usage:
   star-allinone skills list
   star-allinone skills sync [--target <dir>] [--dry-run]
+  star-allinone doctor [--target <dir>]
   star-allinone gen service --operation "GET /api/v1/devices/" [--spec <file>] [--domain Devices] [--mock-file] [--dry-run]
   star-allinone gen page --feature Widgets --route /widgets --title 组件管理 --list-operation "GET /api/v1/widgets/" [--create-operation ...] [--update-operation ...] [--delete-operation ...] [--dry-run]
 
@@ -26,8 +27,10 @@ skills sync writes package skills/shared/* to <project>/.agents/skills/shared-*.
 It never writes ~/.codex/skills and never modifies custom-* skills.
 If <project>/AGENTS.md is missing, it copies examples/AGENTS.md once.
 
+doctor checks config, OpenAPI, MFRequest, MFProTable, skill sync, and bad imports.
+
 gen service writes one MFRequest method and types from OpenAPI/Swagger.
-gen page scaffolds a list + drawer + confirm page and can generate services first.`);
+gen page scaffolds a list + drawer + confirm page from OpenAPI schema and can generate services first.`);
   process.exitCode = 1;
 }
 
@@ -174,10 +177,28 @@ function syncProject(options) {
     copySkill(path.join(skillsRoot, skillName), destination, skillName, prefix, variables, options);
   }
   pruneStaleShared(destination, prefix, syncedNames, options);
+  writeSyncStamp(destination, prefix, syncedNames, options);
   seedAgentsMarkdown(target, options);
   console.log(`${options.dryRun ? 'Would sync' : 'Synced'} shared skills -> ${destination}`);
 }
 
+function writeSyncStamp(destination, prefix, syncedNames, options) {
+  const pkg = readJson(path.join(root, 'package.json'));
+  const file = path.join(destination, '.star-allinone-sync.json');
+  const payload = `${JSON.stringify(
+    {
+      packageName: pkg.name,
+      packageVersion: pkg.version,
+      publicSkillPrefix: prefix,
+      skills: syncedNames,
+    },
+    null,
+    2,
+  )}\n`;
+  console.log(`${options.dryRun ? '[dry-run] ' : ''}${path.relative(path.dirname(destination), file)}`);
+  if (!options.dryRun) fs.writeFileSync(file, payload);
+}
+
 function seedAgentsMarkdown(target, options) {
   const dest = path.join(target, 'AGENTS.md');
   const source = path.join(root, 'examples', 'AGENTS.md');
@@ -195,6 +216,12 @@ function main() {
     if (positional.length) return usage();
     return syncProject(options);
   }
+  if (group === 'doctor') {
+    const args = [command, ...rest].filter((item) => typeof item === 'string');
+    const { options, positional } = parseArgs(args);
+    if (positional.length) return usage();
+    return require('./gen/doctor').runDoctor(process.cwd(), options);
+  }
   if (group === 'gen') {
     const { options, positional } = parseArgs(rest);
     if (positional.length) return usage();

package/scripts/gen/doctor.js

@@ -0,0 +1,293 @@
+const crypto = require('crypto');
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '../..');
+const SHARED_SKILLS = path.join(PACKAGE_ROOT, 'skills', 'shared');
+const DEFAULT_PREFIX = 'shared-';
+const LOCAL_OVERLAYS = ['CustomDrawer', 'BaseModal', 'HocModal'];
+const REQUIRED_CONFIG_KEYS = ['project', 'serviceDir'];
+const KNOWN_CONFIG_KEYS = new Set([
+  'project',
+  'publicSkillPrefix',
+  'serviceDir',
+  'openapi',
+  'publishPipelineId',
+  'sharedSkills',
+  'variables',
+]);
+const IGNORE_DIRS = new Set([
+  'node_modules',
+  'dist',
+  '.git',
+  '.umi',
+  'coverage',
+  '.turbo',
+]);
+
+function readJson(file) {
+  return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+
+function existsAny(root, relatives) {
+  return relatives.find((relative) => fs.existsSync(path.join(root, relative)));
+}
+
+function walkFiles(dir, results = []) {
+  if (!fs.existsSync(dir)) return results;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (IGNORE_DIRS.has(entry.name)) continue;
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      walkFiles(full, results);
+      continue;
+    }
+    if (/\.(ts|tsx|js|jsx)$/.test(entry.name)) results.push(full);
+  }
+  return results;
+}
+
+const TEMPLATE_EXT = new Set(['.md', '.json', '.yml', '.yaml', '.txt']);
+
+function render(content, variables) {
+  return content.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (_, key) => {
+    const value = key.split('.').reduce((current, part) => current?.[part], variables);
+    return value == null ? `{{${key}}}` : String(value);
+  });
+}
+
+function hashTree(dir, variables) {
+  if (!fs.existsSync(dir)) return '';
+  const files = [];
+  const walk = (current, relative) => {
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      const nextRel = relative ? `${relative}/${entry.name}` : entry.name;
+      const full = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        walk(full, nextRel);
+        continue;
+      }
+      let content = fs.readFileSync(full);
+      if (variables && TEMPLATE_EXT.has(path.extname(entry.name).toLowerCase())) {
+        content = Buffer.from(render(content.toString('utf8'), variables));
+      }
+      files.push({ rel: nextRel, content });
+    }
+  };
+  walk(dir, '');
+  files.sort((a, b) => a.rel.localeCompare(b.rel));
+  const digest = crypto.createHash('sha256');
+  for (const file of files) {
+    digest.update(file.rel);
+    digest.update('\0');
+    digest.update(file.content);
+    digest.update('\0');
+  }
+  return digest.digest('hex');
+}
+
+function listPackageSkills() {
+  if (!fs.existsSync(SHARED_SKILLS)) return [];
+  return fs.readdirSync(SHARED_SKILLS, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort();
+}
+
+function check(ok, level, message) {
+  return { ok, level, message };
+}
+
+function runDoctor(cwd, options = {}) {
+  const root = path.resolve(options.target || cwd);
+  const findings = [];
+  const configFile = path.join(root, '.star-allinone.json');
+
+  if (!fs.existsSync(configFile)) {
+    findings.push(check(false, 'error', `Missing ${path.relative(root, configFile)}`));
+    printReport(root, findings);
+    return findings;
+  }
+
+  let config;
+  try {
+    config = readJson(configFile);
+    findings.push(check(true, 'ok', '.star-allinone.json'));
+  } catch (error) {
+    findings.push(check(false, 'error', `.star-allinone.json is not valid JSON: ${error.message}`));
+    printReport(root, findings);
+    return findings;
+  }
+
+  const unknownKeys = Object.keys(config).filter((key) => !KNOWN_CONFIG_KEYS.has(key));
+  if (unknownKeys.length) {
+    findings.push(check(false, 'warn', `Unknown config keys: ${unknownKeys.join(', ')}`));
+  }
+  for (const key of REQUIRED_CONFIG_KEYS) {
+    if (!config[key]) {
+      findings.push(check(false, 'error', `Config missing required "${key}"`));
+    }
+  }
+
+  const serviceDir = config.serviceDir || 'src/services';
+  if (!fs.existsSync(path.join(root, serviceDir))) {
+    findings.push(check(false, 'error', `serviceDir not found: ${serviceDir}`));
+  } else {
+    findings.push(check(true, 'ok', `serviceDir ${serviceDir}`));
+  }
+
+  const requestFile = existsAny(root, [
+    `${serviceDir}/request.tsx`,
+    `${serviceDir}/request.ts`,
+  ]);
+  if (!requestFile) {
+    findings.push(check(false, 'error', `MFRequest helper missing under ${serviceDir}/request.(ts|tsx)`));
+  } else {
+    const content = fs.readFileSync(path.join(root, requestFile), 'utf8');
+    if (!content.includes('MFRequest')) {
+      findings.push(check(false, 'error', `${requestFile} does not define MFRequest`));
+    } else {
+      findings.push(check(true, 'ok', requestFile));
+    }
+  }
+
+  if (config.openapi) {
+    if (fs.existsSync(path.join(root, config.openapi))) {
+      findings.push(check(true, 'ok', `openapi ${config.openapi}`));
+    } else {
+      findings.push(check(false, 'error', `openapi file not found: ${config.openapi}`));
+    }
+  } else {
+    findings.push(check(false, 'error', 'Config missing "openapi"'));
+  }
+
+  if (!config.publishPipelineId) {
+    findings.push(check(false, 'warn', 'Config missing "publishPipelineId"; $shared-publish-test cannot run'));
+  } else {
+    findings.push(check(true, 'ok', `publishPipelineId ${config.publishPipelineId}`));
+  }
+
+  const tableFile = existsAny(root, [
+    'src/components/CommonTable/MFProTable.tsx',
+    'src/components/CommonTable/MFProTable.ts',
+  ]);
+  if (!tableFile) {
+    findings.push(check(false, 'error', 'MFProTable missing at src/components/CommonTable/MFProTable.tsx (app-local, not this package)'));
+  } else {
+    findings.push(check(true, 'ok', tableFile));
+  }
+
+  if (!fs.existsSync(path.join(root, 'AGENTS.md'))) {
+    findings.push(check(false, 'warn', 'Missing AGENTS.md; run skills sync once to seed it'));
+  } else {
+    findings.push(check(true, 'ok', 'AGENTS.md'));
+  }
+
+  const prefix = config.publicSkillPrefix || DEFAULT_PREFIX;
+  const skillsDir = path.join(root, '.agents', 'skills');
+  const stampFile = path.join(skillsDir, '.star-allinone-sync.json');
+  const packageJson = readJson(path.join(PACKAGE_ROOT, 'package.json'));
+  if (fs.existsSync(stampFile)) {
+    try {
+      const stamp = readJson(stampFile);
+      if (stamp.packageVersion && stamp.packageVersion !== packageJson.version) {
+        findings.push(check(false, 'warn', `skills synced from ${stamp.packageVersion}, package is ${packageJson.version}. Run skills sync`));
+      } else {
+        findings.push(check(true, 'ok', `skills sync stamp ${stamp.packageVersion || packageJson.version}`));
+      }
+    } catch (error) {
+      findings.push(check(false, 'warn', `.star-allinone-sync.json is not valid JSON: ${error.message}`));
+    }
+  } else if (fs.existsSync(skillsDir)) {
+    findings.push(check(false, 'warn', 'Missing .agents/skills/.star-allinone-sync.json; run skills sync'));
+  }
+  const packageSkills = listPackageSkills();
+  if (!fs.existsSync(skillsDir)) {
+    findings.push(check(false, 'error', 'Missing .agents/skills. Run pnpm exec star-allinone skills sync'));
+    for (const skill of packageSkills) {
+      findings.push(check(false, 'error', `Shared skill not synced: ${prefix}${skill}. Run pnpm exec star-allinone skills sync`));
+    }
+  } else {
+    for (const skill of packageSkills) {
+      const publicName = `${prefix}${skill}`;
+      const dest = path.join(skillsDir, publicName);
+      const source = path.join(SHARED_SKILLS, skill);
+      if (!fs.existsSync(dest)) {
+        findings.push(check(false, 'error', `Shared skill not synced: ${publicName}. Run pnpm exec star-allinone skills sync`));
+        continue;
+      }
+      const variables = {
+        ...config,
+        ...config.variables,
+        sharedSkillName: publicName,
+        project: { ...config, ...config.variables },
+      };
+      if (hashTree(source, variables) !== hashTree(dest)) {
+        findings.push(check(false, 'warn', `${publicName} is stale vs this package. Run pnpm exec star-allinone skills sync`));
+      } else {
+        findings.push(check(true, 'ok', publicName));
+      }
+    }
+  }
+
+  const pkgFile = path.join(root, 'package.json');
+  if (fs.existsSync(pkgFile)) {
+    const pkg = readJson(pkgFile);
+    const dep = pkg.dependencies?.['@mingfuyun/star-allinone']
+      || pkg.devDependencies?.['@mingfuyun/star-allinone'];
+    if (!dep) {
+      findings.push(check(false, 'warn', 'package.json does not depend on @mingfuyun/star-allinone'));
+    } else {
+      findings.push(check(true, 'ok', `@mingfuyun/star-allinone ${dep}`));
+    }
+    const testScript = pkg.scripts?.test || '';
+    if (/\bmax\s+dev\b/.test(testScript)) {
+      findings.push(check(false, 'warn', 'package.json "test" runs max dev. Rename it to start:test / dev:test so agents do not treat it as unit tests'));
+    }
+  }
+
+  for (const overlay of LOCAL_OVERLAYS) {
+    const overlayDir = path.join(root, 'src/components', overlay);
+    if (fs.existsSync(overlayDir)) {
+      findings.push(check(false, 'error', `Local ${overlay} at src/components/${overlay} should be removed; import from @mingfuyun/star-allinone`));
+    }
+  }
+
+  const files = walkFiles(path.join(root, 'src'));
+  const badTable = [];
+  const localOverlay = [];
+  const tableFromPackage = /import\s+(?:type\s+)?(?:\{[^}]*\bMF(?:TablePro|ProTable)\b[^}]*\}|MF(?:TablePro|ProTable))\s+from\s+['"]@mingfuyun\/star-allinone['"]/;
+  const localDrawer = /from\s+['"]@\/components\/(?:CustomDrawer|BaseModal|HocModal)(?:\/[^'"]*)?['"]/;
+  for (const file of files) {
+    const content = fs.readFileSync(file, 'utf8');
+    const relative = path.relative(root, file);
+    if (tableFromPackage.test(content)) badTable.push(relative);
+    if (localDrawer.test(content)) localOverlay.push(relative);
+  }
+  if (badTable.length) {
+    findings.push(check(false, 'error', `MFProTable/MFTablePro imported from the npm package in ${badTable.join(', ')}. Use @/components/CommonTable/MFProTable`));
+  } else {
+    findings.push(check(true, 'ok', 'No table imports from @mingfuyun/star-allinone'));
+  }
+  if (localOverlay.length) {
+    findings.push(check(false, 'error', `Local overlay imports (use @mingfuyun/star-allinone): ${localOverlay.join(', ')}`));
+  } else {
+    findings.push(check(true, 'ok', 'Overlay imports use @mingfuyun/star-allinone or none found'));
+  }
+
+  printReport(root, findings);
+  return findings;
+}
+
+function printReport(root, findings) {
+  console.log(`star-allinone doctor (${root})`);
+  for (const item of findings) {
+    const tag = item.level === 'ok' ? 'OK  ' : item.level === 'warn' ? 'WARN' : 'ERR ';
+    console.log(`${tag}  ${item.message}`);
+  }
+  const errors = findings.filter((item) => item.level === 'error').length;
+  const warnings = findings.filter((item) => item.level === 'warn').length;
+  console.log(`\n${errors} error(s), ${warnings} warning(s)`);
+}
+
+module.exports = { runDoctor, hashTree };