openyida 2026.9.21 → 2026.9.22-beta.2

package/yida-skills/skills/yida-design/sub_skill/yida-design-plan/scripts/render_build_plan.py

@@ -144,7 +144,7 @@ def render_nav() -> str:
     for anchor, title, subtitle, icon in SECTIONS:
         icon_src = icon_data_uri(icon)
         icon_html = (
-            f'<span class="nav-icon-img" style="--nav-icon-image: url(\'{esc(icon_src)}\')" aria-hidden="true"></span>'
+            f'<img class="nav-icon-img" src="{esc(icon_src)}" alt="" aria-hidden="true" />'
             if icon_src
             else '<span class="nav-icon-fallback" aria-hidden="true"></span>'
         )
@@ -707,6 +707,14 @@ def render_data_models(data: dict[str, Any]) -> str:
                 rows,
             )
         )
+        sample = next((item for item in (data.get("execution") or {}).get("sampleDataPlan", []) if item.get("form") == model.get("name")), {})
+        records = sample.get("records", model.get("sampleRecords", []))
+        skip_reason = sample.get("skipReason") or model.get("skipSampleReason")
+        if records:
+            columns = list(dict.fromkeys(key for record in records for key in record))
+            parts += ["<h4>初始示例数据</h4>", table(columns, [[display_value(record.get(key)) for key in columns] for record in records])]
+        elif skip_reason:
+            parts.append(f'<p><strong>示例数据安排：</strong>{esc(skip_reason)}</p>')
     if not models:
         parts.append('<p class="muted">-</p>')
     parts.append("</section>")
@@ -749,6 +757,10 @@ def render_business_flows(data: dict[str, Any]) -> str:
 </div>
 """
         )
+    states = (data.get("execution") or {}).get("interactionStates") or {}
+    labels = {"empty": "无数据", "loading": "加载中", "error": "加载失败", "formEntry": "表单入口", "detail": "详情入口"}
+    if states:
+        parts += ["<h3>交互与异常处理</h3>", table(["场景", "处理方式"], [[labels.get(key, key), value] for key, value in states.items()])]
     if not flows:
         parts.append('<p class="muted">-</p>')
     parts.append("</section>")
@@ -769,6 +781,7 @@ def render_pages(data: dict[str, Any]) -> str:
         "<h3>自定义页面详情</h3>",
     ]
     execution_pages = (data.get("execution") or {}).get("pages", [])
+    applications = ((data.get("visualStyle") or {}).get("forUser") or {}).get("pageApplications", [])
     for detail in details:
         handoff = next((item.get("pageSpecHandoff", {}) for item in execution_pages if item.get("pageId") == detail.get("pageId")), detail.get("pageSpecHandoff") or {})
         primary_users = detail.get("primaryUsers") or []
@@ -859,27 +872,20 @@ def render_pages(data: dict[str, Any]) -> str:
 """
         binding_labels = {"form": "表单数据", "report": "报表数据", "connector": "外部系统数据", "static-empty": "静态内容或空态"}
         binding = handoff.get("dataBinding") or detail.get("dataBinding")
-        page_menu = handoff.get("navigation") or {}
-        app_custom = ((data.get("execution") or {}).get("appConfig") or {}).get("navigationType") == "custom"
-        standalone = handoff.get("entryMode") == "standalone"
-        variants = {"top": "顶部", "side": "侧边", "mixed": "顶部与侧边", "dock": "底部"}
-        menu_label = ("自定义" + variants.get(page_menu.get("variant"), "") + "菜单") if page_menu.get("type") == "custom" else (
-            "不设菜单" if page_menu.get("type") == "none" else "沿用应用自定义菜单" if app_custom else "未规划应用菜单，仅实现业务内容" if standalone else "沿用平台导航"
-        )
         data_rows = [
-            ["访问方式", "独立页面入口" if standalone else "应用工作区入口"],
-            ["页面菜单", menu_label],
-            ["页面实现边界", "按独立入口方案组织内容" if standalone else "只实现业务内容；跨模块使用平台菜单，同任务分类可用页内 Tab"],
-            ["导航影响范围", "应用采用自定义导航" if app_custom else "仅当前入口，应用工作区保留平台导航" if standalone else "保留平台导航"],
-            ["导航依据", page_menu.get("reason")],
             ["数据接入", binding_labels.get(binding, binding)],
             ["数据来源", display_value(handoff.get("dataSources") or detail.get("dataSources"))],
             ["主操作", handoff.get("primaryAction") or detail.get("primaryTask")],
+            ["空态原因", handoff.get("emptyReason") or detail.get("emptyReason")],
         ]
-        data_html = "".join(
-            f'<p><strong>{esc(label)}：</strong>{esc(value)}</p>'
-            for label, value in data_rows if value
-        )
+        data_html = table(["功能", "说明"], [row for row in data_rows if row[1]])
+        application = next((item for item in applications if item.get("pageId") == detail.get("pageId") or item.get("pageName") == detail.get("name")), {})
+        visual_rows = [[label, display_value(application.get(key))] for key, label in [
+            ("visualApplication", "视觉应用"), ("surface", "表面层次"), ("primaryAction", "操作呈现"), ("states", "状态表达")
+        ] if application.get(key)]
+        for memory in application.get("visualMemoryApplications", []):
+            visual_rows.append([memory.get("name") or "视觉重点", "；".join(display_value(memory.get(key)) for key in ["target", "reason", "application", "contentBinding", "userValue", "rule"] if memory.get(key))])
+        visual_html = ("<h4>页面视觉方案</h4>" + table(["设计项", "说明"], visual_rows)) if visual_rows else ""
         first_screen_label = "首屏结构" if is_new_page_schema else "首屏印象"
         signature_label = "标志性交互" if is_new_page_schema else "标志性时刻"
         parts.append(
@@ -895,6 +901,7 @@ def render_pages(data: dict[str, Any]) -> str:
   {pattern_context}
   <p><strong>权限说明：</strong>{esc(permission)}</p>
   {data_html}
+  {visual_html}
 </div>
 """
         )
@@ -912,14 +919,25 @@ def render_visual_details(data: dict[str, Any]) -> str:
     rows = [
         ("视觉方向", direction.get("label")), ("设计说明", direction.get("description")),
         ("色彩用法", (visual.get("colorStrategy") or {}).get("usage")),
-        ("素材现状", assets.get("materialStatus")),
+        ("层次表达", visual.get("hierarchySummary")), ("组件形态", visual.get("componentToneSummary")),
+        ("状态反馈", visual.get("stateSummary")), ("响应式布局", visual.get("responsiveSummary")),
+        ("图标风格", visual.get("iconSummary")),
+        ("素材现状", assets.get("materialStatus")), ("页面素材", assets.get("pages")),
         ("素材缺口", assets.get("missingAssets")), ("素材说明", assets.get("notes")),
     ]
+    profile = visual.get("themeProfile") or {}
+    rows += [(label, profile.get(key)) for key, label in [
+        ("tone", "整体气质"), ("surfaceStyle", "表面风格"), ("contrastLevel", "对比强度"),
+        ("brandIntensity", "品牌表达"), ("iconStyle", "图标形态"), ("motionLevel", "动效程度")
+    ]]
+    memories = visual.get("visualMemories") or []
+    for memory in memories if isinstance(memories, list) else [memories]:
+        if isinstance(memory, dict):
+            rows.append((memory.get("name") or "视觉重点", "；".join(display_value(memory.get(key)) for key in ["rule", "userValue", "failureMode"] if memory.get(key))))
+        else:
+            rows.append(("视觉重点", memory))
     rows = [(label, {"none": "暂无", "partial": "部分已有", "provided": "已提供"}.get(value, value) if isinstance(value, str) else value) for label, value in rows]
-    return "".join(
-        f'<p><strong>{esc(label)}：</strong>{esc(display_value(value))}</p>'
-        for label, value in rows if value
-    )
+    return table(["设计项", "方案"], [[label, display_value(value)] for label, value in rows if value])
 
 
 def display_value(value: Any) -> str:
@@ -941,29 +959,16 @@ def render_execution(data: dict[str, Any]) -> str:
     hidden_pages = execution.get("pageNavigation") or []
     if hidden_pages:
         parts += ["<h3>页面导航</h3>", table(["页面", "平台页面导航"], [[item.get("name"), "隐藏" if item.get("isRenderNav") is False else "显示"] for item in hidden_pages])]
-    if execution.get("entryModeSummary"):
-        parts += ["<h3>系统怎么使用</h3>", f'<p>{esc(execution["entryModeSummary"])}</p>']
-    for entry in (execution.get("entryRecommendation") or {}).get("entries", []):
-        rows = []
-
-        def entry_rows(items):
-            for item in items:
-                if item.get("children"):
-                    entry_rows(item["children"])
-                    continue
-                rows.append([item.get("label"), item.get("resource"),
-                             "默认进入" if item.get("key") == entry.get("defaultMenuKey") else "",
-                             "；".join(f'{access.get("resource", "")}：{access.get("dataScope", "")}' for access in item.get("access", []))])
-
-        entry_rows(entry.get("menu") or [])
-        parts += [f'<h3>{esc(entry.get("name", "业务入口"))}</h3>', table(["任务菜单", "业务资源", "默认落点", "数据范围"], rows)]
     if execution.get("explicitScope"):
         parts += ["<h3>本轮明确范围</h3>", f'<p>{esc(display_value(execution["explicitScope"]))}</p>']
-    navigation_order = [page_names.get(item, item) if isinstance(item, str) else display_value(item) for item in execution.get("navigationOrder", [])]
-    if not navigation_order:
-        fallback = execution.get("navigationFallback") or "按页面用途安排导航入口"
-        navigation_order = [fallback.replace("--auto-nav-order", "自动导航排序")]
-    parts += ["<h3>导航顺序</h3>", list_items(navigation_order)]
+    for key, title in [("resourceCreationOrder", "搭建顺序"), ("pageImplementationOrder", "页面交付顺序"), ("navigationOrder", "导航顺序"), ("acceptanceCriteria", "验收标准")]:
+        values = [page_names.get(item, item) if isinstance(item, str) else display_value(item) for item in execution.get(key, [])]
+        values = [str(item).replace("design.md", "视觉方案").replace("token", "主题变量") for item in values]
+        if key == "navigationOrder" and not values:
+            fallback = execution.get("navigationFallback") or "按页面用途安排导航入口"
+            values = [fallback.replace("--auto-nav-order", "自动导航排序")]
+        if values:
+            parts += [f"<h3>{title}</h3>", list_items(values)]
     return "".join(parts)
 
 

package/yida-skills/skills/yida-design/sub_skill/yida-design-plan/scripts/validate_design_themes.py

@@ -0,0 +1,190 @@
+#!/usr/bin/env python3
+"""Validate the design theme index and its full design.md templates."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+from pathlib import Path
+
+
+REQUIRED_HEADINGS = (
+    "设计总览",
+    "色彩",
+    "字体与排版",
+    "布局与间距",
+    "表面与层级",
+    "圆角与形状",
+    "组件",
+    "项目应用",
+    "设计规范与禁忌",
+)
+
+ALLOWED_PLACEHOLDERS = {
+    "PROJECT_NAME",
+    "BUSINESS_DOMAIN",
+    "EXPERIENCE_TOPOLOGY",
+    "THEME_SOURCE",
+    "PRIMARY_COLOR",
+    "COLOR_SOURCE",
+    "PROJECT_CONSTRAINTS",
+    "PRODUCT_TOPOLOGY_APPLICATION",
+    "PAGE_PATTERN_SUMMARY",
+    "PAGE_APPLICATIONS",
+    "PAGE_IMAGE_NEEDS",
+    "ASSET_GAPS",
+}
+
+CANDIDATE_RULE_FILES = (
+    "../../../yida-app/workflow/plan/step-2-confirm.md",
+    "references/visual-theme-selection.md",
+    "references/build-plan-schema.md",
+)
+
+LEGACY_TOKEN_KEY_RE = re.compile(
+    r"(?m)^\s+[\"']?(?:"
+    r"fontFamily|fontSize|fontWeight|lineHeight|letterSpacing|"
+    r"xs|sm|md|lg|xl|2xl|"
+    r"corner-(?:zero|circle|semicircle|\d+)"
+    r")[\"']?:"
+)
+TOKEN_SUFFIX_SHORTHAND_RE = re.compile(r"--[a-z0-9-]+/(?!\s*--)")
+TOKEN_WILDCARD_RE = re.compile(r"--[a-z0-9-]*\*")
+
+
+def frontmatter_value(text: str, key: str) -> str | None:
+    match = re.search(rf"(?m)^{re.escape(key)}:\s*[\"']?([^\"'\n]+)[\"']?\s*$", text)
+    return match.group(1).strip() if match else None
+
+
+def validate(skill_root: Path) -> list[str]:
+    errors: list[str] = []
+    index_path = skill_root / "templates" / "design-themes" / "index.json"
+    try:
+        index = json.loads(index_path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError) as exc:
+        return [f"无法读取主题索引 {index_path}: {exc}"]
+
+    themes = index.get("themes")
+    if not isinstance(themes, list) or not themes:
+        return ["templates/design-themes/index.json 缺少非空 themes 数组"]
+
+    seen_ids: set[str] = set()
+    seen_labels: set[str] = set()
+    seen_paths: set[str] = set()
+    for position, theme in enumerate(themes):
+        prefix = f"themes[{position}]"
+        if not isinstance(theme, dict):
+            errors.append(f"{prefix} 必须是对象")
+            continue
+
+        required = (
+            "themeId",
+            "label",
+            "description",
+            "templatePath",
+            "defaultProfile",
+        )
+        for field in required:
+            if theme.get(field) in (None, "", [], {}):
+                errors.append(f"{prefix} 缺少 {field}")
+
+        theme_id = str(theme.get("themeId") or "")
+        label = str(theme.get("label") or "")
+        template_path = str(theme.get("templatePath") or "")
+        if theme_id and theme_id in seen_ids:
+            errors.append(f"重复 themeId: {theme_id}")
+        if theme_id:
+            seen_ids.add(theme_id)
+        if label and label in seen_labels:
+            errors.append(f"重复 label: {label}")
+        if label:
+            seen_labels.add(label)
+        if template_path and template_path in seen_paths:
+            errors.append(f"重复 templatePath: {template_path}")
+        if template_path:
+            seen_paths.add(template_path)
+
+        full_path = skill_root / template_path
+        if not full_path.is_file():
+            errors.append(f"{prefix} 模板不存在: {template_path}")
+            continue
+        text = full_path.read_text(encoding="utf-8")
+        if frontmatter_value(text, "themeId") != theme_id:
+            errors.append(f"{template_path} 的 themeId 与索引不一致")
+
+        frontmatter_match = re.match(r"\A---\n([\s\S]*?)\n---", text)
+        if not frontmatter_match:
+            errors.append(f"{template_path} 缺少合法 YAML frontmatter")
+        else:
+            legacy_keys = sorted(set(LEGACY_TOKEN_KEY_RE.findall(frontmatter_match.group(1))))
+            if legacy_keys:
+                errors.append(f"{template_path} 含旧式 Token 属性名")
+
+        if TOKEN_SUFFIX_SHORTHAND_RE.search(text):
+            errors.append(f"{template_path} 含未展开的 Token 后缀缩写")
+        if TOKEN_WILDCARD_RE.search(text):
+            errors.append(f"{template_path} 含未展开的 Token 通配写法")
+
+        for heading in REQUIRED_HEADINGS:
+            if f"## {heading}" not in text:
+                errors.append(f"{template_path} 缺少章节：{heading}")
+
+        placeholders = set(re.findall(r"\{\{([A-Z0-9_]+)\}\}", text))
+        unknown = placeholders - ALLOWED_PLACEHOLDERS
+        missing = ALLOWED_PLACEHOLDERS - placeholders
+        if unknown:
+            errors.append(f"{template_path} 含未知占位符：{', '.join(sorted(unknown))}")
+        if missing:
+            errors.append(f"{template_path} 缺少标准占位符：{', '.join(sorted(missing))}")
+
+    template_dir = skill_root / "templates" / "design-themes"
+    indexed_files = {Path(path).name for path in seen_paths}
+    actual_files = {path.name for path in template_dir.glob("*.md") if path.name != "README.md"}
+    for filename in sorted(actual_files - indexed_files):
+        errors.append(f"主题模板未登记到索引：templates/design-themes/{filename}")
+    for filename in sorted(indexed_files - actual_files):
+        errors.append(f"索引引用了不存在的主题模板：templates/design-themes/{filename}")
+
+    for relative_path in CANDIDATE_RULE_FILES:
+        rule_path = skill_root / relative_path
+        try:
+            rule_text = rule_path.read_text(encoding="utf-8")
+        except OSError as exc:
+            errors.append(f"无法读取候选规则 {relative_path}: {exc}")
+            continue
+        for theme in themes:
+            if not isinstance(theme, dict):
+                continue
+            theme_id = str(theme.get("themeId") or "")
+            label = str(theme.get("label") or "")
+            if theme_id and theme_id in rule_text:
+                errors.append(f"{relative_path} 硬编码了主题 ID：{theme_id}")
+            if label and label in rule_text:
+                errors.append(f"{relative_path} 硬编码了主题名称：{label}")
+
+    return errors
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--skill-root",
+        type=Path,
+        default=Path(__file__).resolve().parents[1],
+        help="yida-build-plan skill root",
+    )
+    args = parser.parse_args()
+    errors = validate(args.skill_root.resolve())
+    if errors:
+        print("主题模板校验失败：")
+        for error in errors:
+            print(f"- {error}")
+        return 1
+    print("主题索引与完整 design.md 模板校验通过。")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/yida-skills/skills/yida-design/sub_skill/yida-design-plan/templates/design-themes/README.md

@@ -0,0 +1,98 @@
+# 完整主题模板维护规则
+
+## 用途
+
+本文件用于维护当前目录下的完整主题模板。正常生成项目 `design.md` 时读取 [visual-design.md](../../references/visual-design.md)，不读取本文件。
+
+## 文件职责
+
+- [index.json](index.json) 保存主题 ID、用户可读名称、视觉描述、模板路径和默认主题画像。
+- `<themeId>.md` 保存一份完整主题模板。
+- [validate_design_themes.py](../../scripts/validate_design_themes.py) 校验索引与模板是否一一对应。
+
+## 索引记录
+
+每条主题索引记录包含：
+
+| 字段 | 维护要求 |
+| --- | --- |
+| `themeId` | 在索引中唯一，并与模板 frontmatter 一致 |
+| `label` | 面向用户展示，在索引中唯一 |
+| `description` | 只描述视觉差异，不描述页面任务 |
+| `templatePath` | 指向真实存在的完整主题模板 |
+| `defaultProfile` | 保存候选筛选所需的默认主题画像 |
+
+一条索引记录对应一份模板；目录中的每份主题模板都必须登记在索引中。
+
+每份模板都是全应用主题，不按 `experienceTopology` 或 `businessDomain` 限制候选资格。产品形态只用于生成项目的主题应用说明，逐页视觉记忆点继续按真实内容契约匹配。
+
+## 模板结构
+
+模板 frontmatter 记录 `themeId`、项目级设计 Token 和项目化占位符。模板正文包含以下九个一级章节：
+
+1. 设计总览
+2. 色彩
+3. 字体与排版
+4. 布局与间距
+5. 表面与层级
+6. 圆角与形状
+7. 组件
+8. 项目应用
+9. 设计规范与禁忌
+
+模板通过“视觉 DNA”和“视觉记忆点应用策略”保存主题的稳定识别特征。生成流程按页面内容契约选择记忆点，不为套用主题新增业务内容。
+
+## 项目化占位符
+
+| 占位符 | 数据来源 |
+| --- | --- |
+| `{{PROJECT_NAME}}` | `meta.projectName` |
+| `{{BUSINESS_DOMAIN}}` | `meta.businessDomain` |
+| `{{EXPERIENCE_TOPOLOGY}}` | `meta.experienceTopology` |
+| `{{THEME_SOURCE}}` | `visualStyle.forUser.visualDirection.source`；旧计划兼容原选择来源 |
+| `{{PRIMARY_COLOR}}` | `visualStyle.forUser.colorStrategy.primaryColor` |
+| `{{COLOR_SOURCE}}` | `visualStyle.forUser.colorStrategy.source` |
+| `{{PROJECT_CONSTRAINTS}}` | `visualStyle.constraints` |
+| `{{PRODUCT_TOPOLOGY_APPLICATION}}` | `visualStyle.forDesignMd.productTopologyApplication` |
+| `{{PAGE_PATTERN_SUMMARY}}` | `pages.customPageDetails[]` 的页面模式与内容丰富度摘要 |
+| `{{PAGE_APPLICATIONS}}` | materialize 根据页面事实、主题标准和 `visualStyle.forUser.pageApplications[].visualMemoryApplications` 生成的完整逐页应用 |
+| `{{PAGE_IMAGE_NEEDS}}` | 页面图片等级和槽位摘要 |
+| `{{ASSET_GAPS}}` | `visualStyle.forUser.assetStrategy.missingAssets` |
+
+模板中的 `<基于……生成的实际色值>` 和 `<由……生成的实际色值>` 是 Token 推导指令。生成项目 `design.md` 时必须替换成具体 CSS 色值。
+
+## 维护操作
+
+### 新增主题
+
+1. 新建完整主题模板。
+2. 在主题索引中新增唯一记录。
+3. 运行模板校验。
+
+### 修改主题
+
+1. 修改目标主题模板。
+2. 保持索引 ID、路径和默认画像与模板一致。
+3. 运行模板校验。
+
+### 删除主题
+
+1. 从索引中删除目标记录。
+2. 删除对应模板。
+3. 运行模板校验。
+
+## 校验
+
+在 `yida-design-plan` 目录运行：
+
+```bash
+python scripts/validate_design_themes.py
+```
+
+校验通过表示：
+
+- 索引与主题模板一一对应。
+- 每份模板包含九个一级章节和全部标准占位符。
+- 全局与自定义页 Token 属性均使用完整的 `--` 开头 kebab-case 名称。
+- 正文中的多个 Token 分别完整书写，不使用后缀缩写或 `*` 通配写法。
+- 候选规则文件没有硬编码主题 ID 或主题名称。