@morya-ui/mcp 0.2.3 → 0.2.4

package/data/example-coverage.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-09-14T03:19:40.333Z",
-  "catalogGeneratedAt": "2026-09-14T03:19:36.680Z",
+  "generatedAt": "2026-09-14T07:44:52.185Z",
+  "catalogGeneratedAt": "2026-09-14T07:44:48.362Z",
   "components": [
     {
       "id": "Accordion",
@@ -2100,10 +2100,8 @@
       },
       "slots": {
         "total": 1,
-        "covered": 0,
-        "missing": [
-          "default"
-        ]
+        "covered": 1,
+        "missing": []
       },
       "methods": {
         "total": 0,

package/dist/__tests__/tools.test.js

@@ -107,12 +107,58 @@ describe('@morya-ui/mcp handlers', () => {
         const result = read(handlers.search({ query: 'toolbar', scope: 'snippets', limit: 5 }));
         expect(result.items.some((item) => item.type === 'snippet' && item.id === 'list-toolbar')).toBe(true);
     });
-    it('flags double-border page composition issues', () => {
+    it('suggests double-border page composition as advisory standard', () => {
         const result = read(handlers.validatePage({
             code: '<MLayoutContent><MCard><MTable bordered /></MCard></MLayoutContent>',
         }));
-        expect(result.ok).toBe(false);
-        expect(result.issues.some((issue) => issue.type === 'double-border')).toBe(true);
+        expect(result.ok).toBe(true);
+        expect(result.advisory).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'double-border')).toBe(true);
+    });
+    it('suggests MScrollbar over inline overflow scroll styles', () => {
+        const result = read(handlers.validatePage({
+            code: '<div style="overflow:auto;height:20rem"><MTable /></div>',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'native-scroll' && item.standardId === 'scroll')).toBe(true);
+    });
+    it('suggests MScrollbar over overflow in style blocks', () => {
+        const result = read(handlers.validatePage({
+            code: '<template><div class="panel">x</div></template><style>.panel { max-height: 20rem; overflow-y: auto; }</style>',
+        }));
+        expect(result.ok).toBe(true);
+        expect(result.suggestions.some((item) => item.type === 'native-scroll')).toBe(true);
+    });
+    it('returns scrollable-panel snippet for scroll queries', () => {
+        const result = read(handlers.getPageSnippet({ section: 'scrollable-panel' }));
+        expect(result.id).toBe('scrollable-panel');
+        expect(result.template).toContain('MScrollbar');
+        expect(result.imports).toContain('MScrollbar');
+    });
+    it('keeps recommend_page focused on pattern matching', () => {
+        const result = read(handlers.recommendPage({ intent: '用户列表页', pageType: 'list' }));
+        expect(result.matchedPattern).toBe('admin-list');
+        expect(result.nextStep).toContain('get_design_rules');
+        expect(result.pageStandards).toBeUndefined();
+        expect(result.scrollStandards).toBeUndefined();
+    });
+    it('keeps get_golden_page focused on source code', () => {
+        const result = read(handlers.getGoldenPage({ page: 'list-page' }));
+        expect(result.source).toContain('MLayout');
+        expect(result.nextStep).toContain('get_design_rules');
+        expect(result.pageStandards).toBeUndefined();
+        expect(result.scrollStandards).toBeUndefined();
+    });
+    it('exposes page standards from get_design_rules', () => {
+        const result = read(handlers.getDesignRules({ mode: 'zh-CN' }));
+        expect(result.meta.nature).toBe('recommended');
+        expect(result.standards.some((item) => item.id === 'scroll')).toBe(true);
+        expect(result.standards.some((item) => item.id === 'feedback')).toBe(true);
+    });
+    it('reads page scroll decision guide by id', () => {
+        const result = read(handlers.recommendComponent({ decision: 'page-scroll-choice' }));
+        expect(result.id).toBe('page-scroll-choice');
+        expect(result.options.some((option) => option.component === 'MScrollbar')).toBe(true);
     });
     it('lists component decision guides when query is omitted', () => {
         const result = read(handlers.recommendComponent({ limit: 5 }));

package/dist/decisions.js

@@ -227,6 +227,76 @@ export const componentDecisions = [
             },
         ],
     },
+    {
+        id: 'page-scroll-choice',
+        title: '页面滚动如何选择',
+        titleEn: 'Choosing page scroll strategy',
+        question: '这是整页滚动、组件内置滚动，还是业务手写的局部滚动区？',
+        questionEn: 'Is this whole-page scroll, built-in component scroll, or a hand-written local scroll region?',
+        keywords: [
+            'scroll',
+            'scrollbar',
+            '滚动',
+            '滚动条',
+            'overflow',
+            '页面滚动',
+            'layout scroll',
+            'panel scroll',
+        ],
+        options: [
+            {
+                component: 'MLayout fillViewport',
+                when: [
+                    '整页后台列表/表单/仪表盘',
+                    '需要 Header + Content + 可选 Sider 的应用骨架',
+                    '页面主滚动应随 Layout 主题化',
+                ],
+                whenEn: [
+                    'Full admin list/form/dashboard pages',
+                    'App shell with header, content, and optional sider',
+                    'Main page scroll should follow the layout theme',
+                ],
+                avoidWhen: ['单个卡片内部的小块内容', '需要业务自行控制滚动的 Dialog/Drawer 内容'],
+                avoidWhenEn: ['Small regions inside a single card', 'Dialog/Drawer bodies where apps control scrolling'],
+            },
+            {
+                component: 'MScrollbar',
+                when: [
+                    '业务自行限高的卡片正文、侧栏、日志列表，且希望主题化滚动条',
+                    'Dialog / Drawer 等内容区需要主题滚动时由业务显式包一层',
+                    '组件未内置滚动、又需要统一滚动外观时',
+                ],
+                whenEn: [
+                    'App-owned capped regions (card bodies, side panels, logs) that want themed scrollbars',
+                    'Dialog / Drawer content where the app opts into themed scrolling',
+                    'No built-in component scroll, but a consistent scrollbar look is desired',
+                ],
+                avoidWhen: [
+                    'Dialog / Drawer / Popover / Splitter 等用户内容插槽被组件库强行包滚动',
+                    'Textarea 等原生控件自身的滚动',
+                    'MTable / MLayoutContent / Select 弹出层等已内置滚动的区域',
+                ],
+                avoidWhenEn: [
+                    'Library-forced scroll around user content slots such as Dialog, Drawer, Popover, or Splitter',
+                    'Native control scrolling such as Textarea',
+                    'Areas that already scroll internally (MTable, MLayoutContent, Select popups)',
+                ],
+            },
+            {
+                component: 'Built-in (no extra wrapper)',
+                when: [
+                    'MLayout、MTable、MVirtualScroller、菜单/下拉面板等已内置 MScrollbar',
+                    '浮层菜单与子菜单（Dropdown/ContextMenu/TieredMenu/Menu flyout）',
+                ],
+                whenEn: [
+                    'MLayout, MTable, MVirtualScroller, and menu/select panels already scroll internally',
+                    'Overlay menus and nested flyouts (Dropdown/ContextMenu/TieredMenu/Menu flyout)',
+                ],
+                avoidWhen: ['在已内置滚动的组件外再包一层滚动容器'],
+                avoidWhenEn: ['Wrapping another scroll container around built-in scroll chrome'],
+            },
+        ],
+    },
     {
         id: 'surface-nesting-choice',
         title: '如何避免双边框与多余容器',

package/dist/page-snippets.js

@@ -348,6 +348,55 @@ const recentRows = ref<Record<string, unknown>[]>([])`,
         avoid: ['不要手写 min-height: 100vh'],
         avoidEn: ['Do not hand-write min-height: 100vh'],
     },
+    {
+        id: 'scrollable-panel',
+        title: '局部可滚动面板',
+        titleEn: 'Scrollable local panel',
+        description: '业务自行限高滚动时的可选写法：显式使用 MScrollbar。组件内置滚动区无需再包。',
+        descriptionEn: 'Optional pattern when the app wants a themed capped scroll region. Do not wrap component-owned scroll chrome again.',
+        pageTypes: ['list', 'form', 'dashboard', 'detail', 'common'],
+        keywords: [
+            'scroll',
+            'scrollbar',
+            '滚动',
+            '滚动条',
+            'overflow',
+            'max-height',
+            'panel',
+            'card body',
+            'sidebar',
+            'log',
+        ],
+        imports: ['MScrollbar', 'MCard'],
+        template: `<MCard title="活动日志">
+  <MScrollbar max-height="16rem">
+    <ul style="margin:0;padding:0;list-style:none">
+      <li v-for="item in logLines" :key="item.id" style="padding:var(--m-space-2) 0;border-bottom:1px solid var(--m-color-border)">
+        {{ item.text }}
+      </li>
+    </ul>
+  </MScrollbar>
+</MCard>`,
+        scriptSetup: `const logLines = [
+  { id: '1', text: '用户 admin 登录成功' },
+  { id: '2', text: '导出任务已完成' },
+  { id: '3', text: '配置已保存' },
+]`,
+        rules: [
+            '整页主滚动推荐 MLayout fillViewport',
+            '固定高度用 height；仅超出时才滚动用 max-height',
+            'MTable / Layout / 菜单下拉等通常已内置滚动，一般无需再包一层',
+            'Dialog / Drawer 内容滚动由业务自行决定，需要主题滚动时再包 MScrollbar',
+        ],
+        rulesEn: [
+            'Main page scroll: prefer MLayout fillViewport',
+            'Use height for fixed viewports; use max-height when scroll should appear only on overflow',
+            'MTable / Layout / menu popups usually scroll internally; an extra wrapper is often unnecessary',
+            'Dialog / Drawer content scrolling is app-owned; wrap MScrollbar only when themed scroll is desired',
+        ],
+        avoid: ['整页壳写 overflow:auto', '重复包裹已内置滚动的组件'],
+        avoidEn: ['overflow:auto on the page shell', 'Double-wrapping components that already scroll'],
+    },
 ];
 export function findPageSnippet(id) {
     const key = id.trim().toLowerCase().replace(/[-_\s]/g, '');

package/dist/patterns.d.ts

@@ -20,7 +20,29 @@ export interface PagePattern {
     avoid: string[];
 }
 export declare const pagePatterns: PagePattern[];
+export interface PageStandard {
+    id: string;
+    title: string;
+    titleEn: string;
+    recommend: string[];
+    recommendEn: string[];
+    discouraged?: string[];
+    discouragedEn?: string[];
+    mcp?: {
+        snippet?: string;
+        decision?: string;
+    };
+}
+/** Advisory page-writing standards for MCP and human authors — not enforced blockers. */
+export declare const pageStandards: PageStandard[];
 export declare const designRules: {
+    readonly meta: {
+        readonly nature: "recommended";
+        readonly noteZh: "standards 为页面书写标准（推荐实践）；特殊场景可偏离。validate_page 仅给出参考建议。";
+        readonly noteEn: "standards are recommended page-writing practices; deviations are fine when justified. validate_page is advisory only.";
+    };
+    /** Page writing standards — single source for layout, scroll, tokens, feedback, a11y, etc. */
+    readonly standards: PageStandard[];
     readonly tokens: {
         readonly colors: readonly ["--m-color-primary", "--m-color-surface", "--m-color-text", "--m-color-border"];
         readonly spacing: "--m-space-*";
@@ -29,8 +51,8 @@ export declare const designRules: {
         readonly motion: "--m-motion-fast/normal";
     };
     readonly composition: {
-        readonly workflow: readonly ["For full pages: recommend_page then get_golden_page before writing layout code.", "For local edits: get_page_snippet(section) for filters/toolbar/form-actions/KPI blocks instead of reading the whole golden page.", "Use MLayout fillViewport as the app shell; put MPageContent inside MLayoutContent.", "Prefer MPage* components over scoped CSS for filters, toolbars, headers, form surfaces, and KPI cards.", "Use MSpace or MFlex for control groups inside MPageFilters; use MPageToolbar for title + primary action."];
-        readonly snippets: readonly ["list-filters", "list-toolbar", "list-table", "list-row-actions", "form-header", "form-body", "form-actions", "dashboard-kpi-grid", "dashboard-chart-card", "layout-app-shell"];
+        readonly workflow: readonly ["For full pages: recommend_page → get_golden_page → get_design_rules.", "For local edits: get_page_snippet(section) for filters/toolbar/form-actions/KPI/scrollable-panel blocks.", "Use MLayout fillViewport as the app shell; put MPageContent inside MLayoutContent.", "Prefer MPage* components over scoped CSS for filters, toolbars, headers, form surfaces, and KPI cards.", "Use MSpace or MFlex for control groups inside MPageFilters; use MPageToolbar for title + primary action."];
+        readonly snippets: readonly ["list-filters", "list-toolbar", "list-table", "list-row-actions", "form-header", "form-body", "form-actions", "dashboard-kpi-grid", "dashboard-chart-card", "layout-app-shell", "scrollable-panel"];
         readonly pageStack: {
             readonly list: readonly ["MLayout", "MLayoutHeader", "MLayoutContent", "MPageContent", "MPageFilters", "MPageToolbar", "MTable"];
             readonly form: readonly ["MLayout", "MLayoutHeader", "MLayoutContent", "MPageContent", "MPageHeader", "MPageSection", "MForm"];
@@ -94,7 +116,7 @@ export declare const designRules: {
         };
         readonly doc: "docs/feedback-message-vs-toast.md";
     };
-    readonly global: readonly ["优先使用组件库组件和 --m-* Token，不重复维护第二套色板", "操作反馈默认 message；无 detail 禁止用 toast.add({ summary only })", "图标按钮必须提供 aria-label 或 ariaLabel", "表单字段必须有可见 label 或等价的可访问名称", "浮层默认 Teleport 到 body；只有有明确布局约束时才改 appendTo", "优先使用组件的 documented variant，不通过深层 CSS 覆盖内部样式"];
+    readonly global: readonly ["优先使用组件库组件和 --m-* Token", "操作反馈默认 message；仅一行文案时优先于 toast", "图标按钮建议提供 aria-label；表单字段建议有可见 label", "浮层默认 Teleport 到 body；有明确布局约束时再改 appendTo", "优先使用组件 documented variant，少写深层 CSS 覆盖"];
 };
 export declare function findPattern(input: string): PagePattern | undefined;
 export declare function scorePattern(pattern: PagePattern, query: string): number;

package/dist/patterns.js

@@ -324,7 +324,127 @@ export const pagePatterns = [
         ],
     },
 ];
+/** Advisory page-writing standards for MCP and human authors — not enforced blockers. */
+export const pageStandards = [
+    {
+        id: 'layout-shell',
+        title: '页面骨架',
+        titleEn: 'Page shell',
+        recommend: [
+            '后台页根布局使用 MLayout fillViewport',
+            'MLayoutContent 内使用 MPageContent 统一 padding 与区块间距',
+            '写整页前先 get_golden_page 复制对应类型结构',
+        ],
+        recommendEn: [
+            'Use MLayout fillViewport as the admin page root',
+            'Place MPageContent inside MLayoutContent for consistent padding and section gap',
+            'Call get_golden_page before writing a full page and copy the matching structure',
+        ],
+        discouraged: ['手写 min-height:100vh', '在 MLayoutContent 上写 padding/gap'],
+        discouragedEn: ['Hand-written min-height:100vh', 'Padding/gap on MLayoutContent instead of MPageContent'],
+        mcp: { snippet: 'layout-app-shell' },
+    },
+    {
+        id: 'page-sections',
+        title: '页面区块组件',
+        titleEn: 'Page section components',
+        recommend: [
+            '筛选区用 MPageFilters，标题+操作用 MPageToolbar，表单区用 MPageSection',
+            '列表页 MTable 直接放在 MPageContent 内',
+            '局部区块优先 get_page_snippet（filters / toolbar / form-actions 等）',
+        ],
+        recommendEn: [
+            'Use MPageFilters, MPageToolbar, and MPageSection for filters, headers/actions, and forms',
+            'Place MTable directly in MPageContent on list pages',
+            'Prefer get_page_snippet for local blocks such as filters, toolbar, or form-actions',
+        ],
+        discouraged: ['手写 .page-filters / .page-toolbar 类', '用 MCard 包裹 MPageFilters 或 bordered MTable'],
+        discouragedEn: [
+            'Hand-written .page-filters / .page-toolbar classes',
+            'Wrapping MPageFilters or bordered MTable with MCard',
+        ],
+        mcp: { decision: 'surface-nesting-choice' },
+    },
+    {
+        id: 'scroll',
+        title: '滚动',
+        titleEn: 'Scroll',
+        recommend: [
+            '组件内置滚动区（Layout 壳、菜单/下拉面板、Table 视口等）使用内置 MScrollbar',
+            'Dialog / Drawer / Popover / Splitter 等内容区不强制主题滚动；需要时由业务自行包 MScrollbar',
+            '已内置滚动的组件通常无需再外包一层',
+        ],
+        recommendEn: [
+            'Component-owned scroll chrome (Layout shell, menu/select panels, Table viewport) uses built-in MScrollbar',
+            'Do not force themed scroll into Dialog / Drawer / Popover / Splitter content; apps can wrap MScrollbar when needed',
+            'Components that already scroll internally usually need no extra wrapper',
+        ],
+        discouraged: [
+            '在 Dialog / Drawer / Popover / Splitter / Textarea 等用户内容区强行内置 MScrollbar',
+            '业务代码定制 ::-webkit-scrollbar 替代组件内置滚动',
+            '重复包裹已内置滚动的组件',
+        ],
+        discouragedEn: [
+            'Forcing MScrollbar into user content areas such as Dialog, Drawer, Popover, Splitter, or Textarea',
+            '::-webkit-scrollbar styling instead of component-owned scroll chrome',
+            'Extra scroll wrappers around components that already scroll',
+        ],
+        mcp: { snippet: 'scrollable-panel', decision: 'page-scroll-choice' },
+    },
+    {
+        id: 'tokens',
+        title: '设计令牌',
+        titleEn: 'Design tokens',
+        recommend: ['颜色、间距、圆角、字号优先 --m-* Token', '控件宽度等局部尺寸可用 inline style'],
+        recommendEn: [
+            'Prefer --m-* tokens for color, spacing, radius, and typography',
+            'Inline styles are fine for local control widths',
+        ],
+        discouraged: ['页面级 hex / 裸 rgb() 色值', '维护第二套色板变量'],
+        discouragedEn: ['Page-level hex or raw rgb() colors', 'Maintaining a second color palette'],
+    },
+    {
+        id: 'feedback',
+        title: '操作反馈',
+        titleEn: 'Action feedback',
+        recommend: [
+            '单行结果（已保存/已删除）默认 message.success / error',
+            '需要标题+补充说明时用 toast',
+            '危险操作配合 MConfirmDialog',
+        ],
+        recommendEn: [
+            'Default single-line results to message.success / error',
+            'Use toast when a summary plus detail is needed',
+            'Pair destructive actions with MConfirmDialog',
+        ],
+        discouraged: ['只有一行文案却用 toast', '删除等危险操作无确认'],
+        discouragedEn: ['Toast for single-line-only feedback', 'Destructive actions without confirmation'],
+        mcp: { decision: 'overlay-choice' },
+    },
+    {
+        id: 'accessibility',
+        title: '无障碍',
+        titleEn: 'Accessibility',
+        recommend: [
+            '图标按钮提供 aria-label 或 ariaLabel',
+            '表单控件有可见 label 或等价可访问名称',
+            '筛选区、表格等语义区域可加 aria-label',
+        ],
+        recommendEn: [
+            'Provide aria-label or ariaLabel on icon-only buttons',
+            'Give form controls a visible label or equivalent accessible name',
+            'Add aria-label to semantic regions such as filter bars or tables when helpful',
+        ],
+    },
+];
 export const designRules = {
+    meta: {
+        nature: 'recommended',
+        noteZh: 'standards 为页面书写标准（推荐实践）；特殊场景可偏离。validate_page 仅给出参考建议。',
+        noteEn: 'standards are recommended page-writing practices; deviations are fine when justified. validate_page is advisory only.',
+    },
+    /** Page writing standards — single source for layout, scroll, tokens, feedback, a11y, etc. */
+    standards: pageStandards,
     tokens: {
         colors: ['--m-color-primary', '--m-color-surface', '--m-color-text', '--m-color-border'],
         spacing: '--m-space-*',
@@ -334,8 +454,8 @@ export const designRules = {
     },
     composition: {
         workflow: [
-            'For full pages: recommend_page then get_golden_page before writing layout code.',
-            'For local edits: get_page_snippet(section) for filters/toolbar/form-actions/KPI blocks instead of reading the whole golden page.',
+            'For full pages: recommend_page → get_golden_page → get_design_rules.',
+            'For local edits: get_page_snippet(section) for filters/toolbar/form-actions/KPI/scrollable-panel blocks.',
             'Use MLayout fillViewport as the app shell; put MPageContent inside MLayoutContent.',
             'Prefer MPage* components over scoped CSS for filters, toolbars, headers, form surfaces, and KPI cards.',
             'Use MSpace or MFlex for control groups inside MPageFilters; use MPageToolbar for title + primary action.',
@@ -351,6 +471,7 @@ export const designRules = {
             'dashboard-kpi-grid',
             'dashboard-chart-card',
             'layout-app-shell',
+            'scrollable-panel',
         ],
         pageStack: {
             list: ['MLayout', 'MLayoutHeader', 'MLayoutContent', 'MPageContent', 'MPageFilters', 'MPageToolbar', 'MTable'],
@@ -403,12 +524,11 @@ export const designRules = {
         doc: 'docs/feedback-message-vs-toast.md',
     },
     global: [
-        '优先使用组件库组件和 --m-* Token，不重复维护第二套色板',
-        '操作反馈默认 message；无 detail 禁止用 toast.add({ summary only })',
-        '图标按钮必须提供 aria-label 或 ariaLabel',
-        '表单字段必须有可见 label 或等价的可访问名称',
-        '浮层默认 Teleport 到 body；只有有明确布局约束时才改 appendTo',
-        '优先使用组件的 documented variant，不通过深层 CSS 覆盖内部样式',
+        '优先使用组件库组件和 --m-* Token',
+        '操作反馈默认 message；仅一行文案时优先于 toast',
+        '图标按钮建议提供 aria-label；表单字段建议有可见 label',
+        '浮层默认 Teleport 到 body；有明确布局约束时再改 appendTo',
+        '优先使用组件 documented variant，少写深层 CSS 覆盖',
     ],
 };
 export function findPattern(input) {

package/dist/tools.js

@@ -685,8 +685,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
                     listGoldenPages().find((item) => item.patternId === best.pattern.id)?.id ||
                     best.pattern.id;
                 return locale === 'en-US'
-                    ? `Call get_golden_page("${goldenId}"), get_pattern, get_design_rules, then get_component/get_example. Pass includeScaffold: true for MPage* starter code. Run validate_page on the result.`
-                    : `调用 get_golden_page("${goldenId}")、get_pattern、get_design_rules，再用 get_component/get_example 查 API。需要 starter 时传 includeScaffold: true（已使用 MPage* 组件）。生成后请 validate_page 校验。`;
+                    ? `Call get_golden_page("${goldenId}"), get_pattern, get_design_rules, then get_component/get_example. Pass includeScaffold: true for starter code. Optionally validate_page.`
+                    : `调用 get_golden_page("${goldenId}")、get_pattern、get_design_rules，再用 get_component/get_example 查 API。需要 starter 时传 includeScaffold: true。可选用 validate_page。`;
             })(),
         };
         if (args.includeScaffold) {
@@ -720,8 +720,8 @@ export function createToolHandlers(catalog = loadCatalog()) {
             file: payload.record.file,
             source: payload.source,
             nextStep: locale === 'en-US'
-                ? 'Copy this structure and replace business data. Prefer MPage* components over custom scoped CSS.'
-                : '复制此结构并替换业务数据。优先使用 MPage* 组件，而不是自定义 scoped CSS。',
+                ? 'Copy this structure and replace business data. Prefer MPage* components; see get_design_rules for page standards.'
+                : '复制此结构并替换业务数据。优先使用 MPage* 组件；页面标准见 get_design_rules。',
         });
     }
     function listGoldenPageCatalog(args = {}) {
@@ -800,75 +800,130 @@ export function createToolHandlers(catalog = loadCatalog()) {
     function validatePage(args) {
         const locale = resolveLocale(args.mode);
         const code = args.code || '';
-        const issues = [];
+        const suggestions = [];
         if (/#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})\b/i.test(code)) {
-            issues.push({
+            suggestions.push({
+                standardId: 'tokens',
                 type: 'raw-color',
                 message: locale === 'en-US'
-                    ? 'Use --m-* design tokens instead of hex colors.'
-                    : '请使用 --m-* 设计令牌，不要写 hex 色值。',
+                    ? 'Standard: prefer --m-* design tokens over hex colors.'
+                    : '标准建议：颜色优先使用 --m-* 设计令牌，而非 hex 色值。',
             });
         }
         if (/\brgb\s*\(/i.test(code) && !/--m-/.test(code)) {
-            issues.push({
+            suggestions.push({
+                standardId: 'tokens',
                 type: 'raw-color',
                 message: locale === 'en-US'
-                    ? 'Use --m-* tokens instead of raw rgb()/rgba() page styles.'
-                    : '页面样式请使用 --m-* 令牌，不要写裸 rgb()/rgba()。',
+                    ? 'Standard: prefer --m-* tokens over raw rgb()/rgba() in page styles.'
+                    : '标准建议：页面样式优先 --m-* 令牌，而非裸 rgb()/rgba()。',
             });
         }
         if (/<MCard\b[^>]*>[\s\S]*?<MTable\b[^>]*\bbordered\b/i.test(code)) {
-            issues.push({
+            suggestions.push({
+                standardId: 'page-sections',
                 type: 'double-border',
                 message: locale === 'en-US'
-                    ? 'Avoid wrapping bordered MTable with MCard; place MTable directly in MPageContent.'
-                    : '避免用 MCard 包裹 bordered 的 MTable；表格应直接放在 MPageContent 内。',
+                    ? 'Standard: place bordered MTable directly in MPageContent instead of wrapping it with MCard.'
+                    : '标准建议：bordered 的 MTable 直接放在 MPageContent 内，通常不必再包 MCard。',
             });
         }
         if (/<MLayoutContent\b/i.test(code) && !/<MPageContent\b/i.test(code)) {
-            issues.push({
+            suggestions.push({
+                standardId: 'layout-shell',
                 type: 'missing-page-content',
                 message: locale === 'en-US'
-                    ? 'Prefer MPageContent inside MLayoutContent for consistent page spacing.'
-                    : '建议在 MLayoutContent 内使用 MPageContent 统一页面间距。',
+                    ? 'Standard: prefer MPageContent inside MLayoutContent for consistent page spacing.'
+                    : '标准建议：MLayoutContent 内使用 MPageContent 统一页面间距。',
             });
         }
         if ((/\bpage[-_](?:list|form|dashboard)?[-_]?(?:filters|toolbar|content|header)\b/i.test(code) ||
             /class="[^"]*filters/i.test(code)) &&
             !/<MPage(?:Content|Filters|Toolbar|Header|Section|Stat)\b/i.test(code)) {
-            issues.push({
+            suggestions.push({
+                standardId: 'page-sections',
                 type: 'custom-page-css',
                 message: locale === 'en-US'
-                    ? 'Replace custom page section CSS with MPageFilters, MPageToolbar, MPageHeader, or MPageSection.'
-                    : '请用 MPageFilters / MPageToolbar / MPageHeader / MPageSection 替代自定义页面区块 CSS。',
+                    ? 'Standard: prefer MPageFilters, MPageToolbar, MPageHeader, or MPageSection over custom page section CSS.'
+                    : '标准建议：筛选/工具栏/表单区块优先 MPage* 组件，少写自定义 page section CSS。',
             });
         }
         if (/<MPageFilters\b/i.test(code) && /<MCard\b[^>]*>[\s\S]*?<MPageFilters\b/i.test(code)) {
-            issues.push({
+            suggestions.push({
+                standardId: 'page-sections',
                 type: 'redundant-wrapper',
                 message: locale === 'en-US'
-                    ? 'Do not wrap MPageFilters in MCard; MPageFilters already provides the surface.'
-                    : '不要用 MCard 包裹 MPageFilters；MPageFilters 已自带表面样式。',
+                    ? 'Standard: MPageFilters already provides a surface; wrapping it in MCard is usually redundant.'
+                    : '标准建议：MPageFilters 已自带表面样式，通常不必再用 MCard 包裹。',
+            });
+        }
+        if (/style="[^"]*overflow(?:-y|-x)?\s*:\s*(auto|scroll)/i.test(code) ||
+            /<style\b[^>]*>[\s\S]*?overflow(?:-y|-x)?\s*:\s*(auto|scroll)/i.test(code)) {
+            suggestions.push({
+                standardId: 'scroll',
+                type: 'native-scroll',
+                message: locale === 'en-US'
+                    ? 'Standard: prefer MScrollbar or MLayout scroll regions over overflow:auto/scroll in page styles.'
+                    : '标准建议：页面滚动优先 MLayout 主滚动或 MScrollbar，少写 overflow:auto/scroll。',
+            });
+        }
+        if (/::-webkit-scrollbar|scrollbar-width\s*:/i.test(code)) {
+            suggestions.push({
+                standardId: 'scroll',
+                type: 'custom-scrollbar-css',
+                message: locale === 'en-US'
+                    ? 'Standard: prefer MScrollbar or layout defaults over native scrollbar CSS in product code.'
+                    : '标准建议：业务代码优先 MScrollbar 或 Layout 默认滚动，少定制原生滚动条样式。',
+            });
+        }
+        if (/min-height\s*:\s*100vh/i.test(code) && !/<MLayout\b[^>]*fill-viewport/i.test(code)) {
+            suggestions.push({
+                standardId: 'layout-shell',
+                type: 'viewport-height',
+                message: locale === 'en-US'
+                    ? 'Standard: prefer MLayout fillViewport over hand-written min-height:100vh page shells.'
+                    : '标准建议：整页高度优先 MLayout fillViewport，少写 min-height:100vh。',
             });
         }
         return textResult({
-            ok: issues.length === 0,
-            issues,
-            recommendations: locale === 'en-US'
-                ? designRules.composition.workflow
-                : [
-                    '生成页面前先调用 recommend_page 与 get_golden_page。',
-                    'MLayout 使用 fillViewport；MLayoutContent 内放 MPageContent。',
-                    '筛选区用 MPageFilters，标题+操作用 MPageToolbar，表单用 MPageSection。',
-                    '列表表格不要额外包 MCard。',
-                ],
+            ok: true,
+            advisory: true,
+            summary: locale === 'en-US'
+                ? suggestions.length === 0
+                    ? 'No deviations from page standards detected.'
+                    : `${suggestions.length} advisory suggestion(s).`
+                : suggestions.length === 0
+                    ? '未发现与页面标准的明显偏差。'
+                    : `${suggestions.length} 条参考建议。`,
+            suggestions,
+            nextStep: locale === 'en-US'
+                ? 'See get_design_rules.standards for the full recommended page standards.'
+                : '完整页面标准见 get_design_rules.standards。',
         });
     }
     function getDesignRules(args = {}) {
         const locale = resolveLocale(args.mode);
-        if (locale === 'zh-CN')
-            return textResult(designRules);
+        if (locale === 'zh-CN') {
+            return textResult({
+                meta: designRules.meta,
+                standards: designRules.standards,
+                tokens: designRules.tokens,
+                composition: designRules.composition,
+                actions: designRules.actions,
+                status: designRules.status,
+                feedback: designRules.feedback,
+                global: designRules.global,
+            });
+        }
         return textResult({
+            meta: designRules.meta,
+            standards: designRules.standards.map((item) => ({
+                id: item.id,
+                title: item.titleEn,
+                recommend: item.recommendEn,
+                discouraged: item.discouragedEn,
+                mcp: item.mcp,
+            })),
             tokens: {
                 colors: ['--m-color-primary', '--m-color-surface', '--m-color-text', '--m-color-border'],
                 spacing: '--m-space-*',
@@ -892,10 +947,10 @@ export function createToolHandlers(catalog = loadCatalog()) {
                 doc: 'docs/feedback-message-vs-toast.md',
             },
             global: [
-                'Prefer library components and --m-* tokens; do not maintain a second color system.',
-                'Default action feedback to message; do not use toast with summary-only text.',
-                'Icon-only buttons must provide aria-label or ariaLabel.',
-                'Form controls must have a visible label or an equivalent accessible name.',
+                'Prefer library components and --m-* tokens.',
+                'Default action feedback to message; prefer message over toast for single-line-only text.',
+                'Icon-only buttons should provide aria-label or ariaLabel.',
+                'Form controls should have a visible label or an equivalent accessible name.',
                 'Overlays teleport to body by default; only change appendTo for a clear layout constraint.',
                 'Prefer documented component variants over deep CSS overrides.',
             ],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morya-ui/mcp",
   "type": "module",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "MCP server for morya-ui — component docs, examples, and usage guidance for AI coding agents.",
   "license": "MIT",
   "homepage": "https://github.com/morya-space/morya-ui/tree/main/packages/ui-mcp#readme",