{"id":"2f81b776-12fd-4940-b433-91a4846c92b3","entityType":"agent","slug":"clawhub-ldxs001-hug-html","name":"hug-html","canonicalUrl":"https://www.xpersona.co/agent/clawhub-ldxs001-hug-html","canonicalPath":"/agent/clawhub-ldxs001-hug-html","generatedAt":"2026-10-10T21:51:01.931Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T18:59:46.938Z","emptyReason":null},"description":"8种原子组件自由组合 + 3级约束, cell merging, two-level module system (base + composite), 7+ built-in templates, grid-aware visual editor, style presets, post-generation... Skill: hug-html Owner: ldxs001 Summary: 8种原子组件自由组合 + 3级约束, cell merging, two-level module system (base + composite), 7+ built-in templates, grid-aware visual editor, style presets, post-generation... Tags: chinese-error-handling:3.3.1, grid:3.3.1, html:3.3.1, latest:3.3.1, layout:3.3.1, module-library:3.3.1, style-presets:3.3.1, template:3.3.1, visual-editor:3.3.1 Version history: v3.3.1 | 2026-07-09T10:47:33.622Z |","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s1794v2r46s8y5d1r4jdd7ec5h84rw70:hug-html","sourceUrl":"https://clawhub.ai/ldxs001/hug-html","homepage":"https://clawhub.ai/ldxs001/skills/hug-html","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/ldxs001/hug-html","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/ldxs001/skills/hug-html","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"8种原子组件自由组合 + 3级约束, cell merging, two-level module system (base + composite), 7+ built-in templates, grid-aware visual editor, style presets, post-generation... "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:59:46.938Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:59:46.938Z","emptyReason":null},"stars":null,"forks":null,"downloads":1287,"packageName":null,"latestVersion":"3.3.1","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:59:46.938Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T18:59:46.938Z","lastCrawledAt":"2026-10-10T18:59:46.938Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T18:59:46.938Z","lastVerifiedAt":null,"highlights":[{"version":"3.3.1","createdAt":"2026-07-09T10:47:33.622Z","changelog":"v3.3.1","fileCount":26,"zipByteSize":91366},{"version":"3.3.0","createdAt":"2026-06-30T05:38:38.986Z","changelog":"v3.3.0: skill-standardization refactor全流程改造, 0 ERROR 0 WARN; 新增slug/displayName for SkillHub","fileCount":24,"zipByteSize":89511},{"version":"3.2.0","createdAt":"2026-06-26T13:07:19.900Z","changelog":"refactor改造完成: 路径集中管理+触发条件修正+示例质量提升+一致性审查修复","fileCount":26,"zipByteSize":91221},{"version":"3.0.4","createdAt":"2026-06-02T03:37:38.734Z","changelog":"hug-html v3.0.4 - 新增架构设计文档 references/architecture.md，完善模块结构说明 - 移除冗余 skill-card.md，精简文档结构 - SKILL.md 文档标签(tags)补充，支持元字段同步（meta_field_sync: true） - 文档结构优化，增加 references/architecture.md 引用 - 其他内容无功能性变更","fileCount":24,"zipByteSize":89626},{"version":"3.0.3","createdAt":"2026-05-30T19:49:31.417Z","changelog":"hug-html 3.0.3 - 移除了示例输出文件 data/output/component-demo.html。 - 不涉及功能或代码更改，仅为清理示例输出资源。","fileCount":23,"zipByteSize":88934},{"version":"3.0.0","createdAt":"2026-05-30T04:55:07.795Z","changelog":"**hug-html 3.0.0 — 全新组件式引擎，支持8种原子组件与多级约束** - 引入 8 种原子组件体系（text, image, icon, qrcode, table, divider, spacer, group）和自由组合能力 - 实现 3 级约束系统（fill / fit / clip），支持递归传递和精确布局控制 - 提供全新组件组合方式和组合逻辑（方向、比例、对齐），自定义灵活性大幅提高 - 增加 module_assembler 脚本，支持组件类型枚举、接口导出及系统演示 - 所有旧模板和模块引用保持向后兼容 - 新增 data/output/component-demo.html 作为组件系统演示 HTML 示例","fileCount":24,"zipByteSize":89771},{"version":"2.1.3","createdAt":"2026-05-29T20:11:39.721Z","changelog":"Version 2.1.3 - Removed obsolete FAQ entry file: references/faq-q4-fixed.md. - SKILL.md: No user-facing feature changes; core documentation and capabilities unchanged.","fileCount":23,"zipByteSize":82928},{"version":"2.1.1","createdAt":"2026-05-29T11:44:18.393Z","changelog":"No file changes detected in this release. - Version bumped to 2.1.1 in SKILL.md. - No feature changes, bug fixes, or documentation updates. - Functionality remains identical to 2.1.0.","fileCount":24,"zipByteSize":83266}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1794v2r46s8y5d1r4jdd7ec5h84rw70:hug-html","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T21:51:01.929Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-hug-html/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T18:59:46.938Z","emptyReason":null},"readme":"Skill: hug-html\n\nOwner: ldxs001\n\nSummary: 8种原子组件自由组合 + 3级约束, cell merging, two-level module system (base + composite), 7+ built-in templates, grid-aware visual editor, style presets, post-generation...\n\nTags: chinese-error-handling:3.3.1, grid:3.3.1, html:3.3.1, latest:3.3.1, layout:3.3.1, module-library:3.3.1, style-presets:3.3.1, template:3.3.1, visual-editor:3.3.1\n\nVersion history:\n\nv3.3.1 | 2026-07-09T10:47:33.622Z | user\n\nv3.3.1\n\nv3.3.0 | 2026-06-30T05:38:38.986Z | user\n\nv3.3.0: skill-standardization refactor全流程改造, 0 ERROR 0 WARN; 新增slug/displayName for SkillHub\n\nv3.2.0 | 2026-06-26T13:07:19.900Z | user\n\nrefactor改造完成: 路径集中管理+触发条件修正+示例质量提升+一致性审查修复\n\nv3.0.4 | 2026-06-02T03:37:38.734Z | user\n\nhug-html v3.0.4\n\n- 新增架构设计文档 references/architecture.md，完善模块结构说明\n- 移除冗余 skill-card.md，精简文档结构\n- SKILL.md 文档标签(tags)补充，支持元字段同步（meta_field_sync: true）\n- 文档结构优化，增加 references/architecture.md 引用\n- 其他内容无功能性变更\n\nv3.0.3 | 2026-05-30T19:49:31.417Z | user\n\nhug-html 3.0.3\n\n- 移除了示例输出文件 data/output/component-demo.html。\n- 不涉及功能或代码更改，仅为清理示例输出资源。\n\nv3.0.0 | 2026-05-30T04:55:07.795Z | user\n\n**hug-html 3.0.0 — 全新组件式引擎，支持8种原子组件与多级约束**\n\n- 引入 8 种原子组件体系（text, image, icon, qrcode, table, divider, spacer, group）和自由组合能力\n- 实现 3 级约束系统（fill / fit / clip），支持递归传递和精确布局控制\n- 提供全新组件组合方式和组合逻辑（方向、比例、对齐），自定义灵活性大幅提高\n- 增加 module_assembler 脚本，支持组件类型枚举、接口导出及系统演示\n- 所有旧模板和模块引用保持向后兼容\n- 新增 data/output/component-demo.html 作为组件系统演示 HTML 示例\n\nv2.1.3 | 2026-05-29T20:11:39.721Z | user\n\nVersion 2.1.3\n\n- Removed obsolete FAQ entry file: references/faq-q4-fixed.md.\n- SKILL.md: No user-facing feature changes; core documentation and capabilities unchanged.\n\nv2.1.1 | 2026-05-29T11:44:18.393Z | user\n\nNo file changes detected in this release.\n\n- Version bumped to 2.1.1 in SKILL.md.\n- No feature changes, bug fixes, or documentation updates. \n- Functionality remains identical to 2.1.0.\n\nv2.1.0 | 2026-05-29T11:19:04.318Z | user\n\nhug-html 2.1.0\n\n- 全面升级中文错误处理：所有脚本错误输出均为中文说明，附带修复建议，替代英文 Traceback。\n- 新增“能力边界”章节，明确列出技能支持和不支持的典型场景，便于用户理解适用范围。\n- 增加“错误排查”快速指引，常见错误附快速自助解决表格，提升上手体验。\n- 详细扩充触发场景示例与支持用例，覆盖更多实际业务需求描述。\n- 更新文档结构，强调中文报错机制、参数校验和调试模式说明。\n- 版本号提升至 2.1.0，推荐所有用户升级。\n\nv2.0.2 | 2026-05-29T10:40:59.041Z | user\n\nVersion 2.0.2\n\n- Major update: Introduces grid-based architecture, new scripts, and expanded modular editing for HTML templates.\n- Added grid_builder.py and supporting scripts for grid layout, test grids, and calendar specs.\n- Introduced JSON grid spec/template files (e.g., 3x3-merge.json, calendar-dashboard-interactive.json) for advanced, customizable N×M layouts.\n- Enhanced modularity: supports cell merging (rowspan/colspan), granular image/text/module editing, and user-defined templates.\n- Updated SKILL.md: documents four-layer architecture, core abilities, workflow, permissions, and new usage examples.\n- Removed obsolete documentation file (skill-card.md).\n\nv1.0.1 | 2026-05-28T09:29:25.440Z | auto\n\nhug-html 1.0.1\n\n- Improved FAQ quality and added more detailed antipattern explanations.\n- Updated writing standards to ensure term consistency.\n- Enhanced documentation on core abilities, workflows, and permissions.\n- SKILL.md now follows a progressive loading structure, referencing external detailed docs.\n- Clarified quick start commands and added explicit workflow descriptions.\n- No sensitive or critical system access required; permissions remain LOW.\n\nArchive index:\n\nArchive v3.3.1: 26 files, 91366 bytes\n\nFiles: _meta.json (127b), references/antipatterns.md (3238b), references/architecture.md (2366b), references/call-chains.md (6196b), references/changelog.md (9155b), references/examples.md (2633b), references/faq.md (10801b), references/guide.md (6904b), references/LICENSE.md (1067b), references/module-library.md (7305b), references/permissions.md (2486b), references/style-presets.md (2865b), scripts/_paths.py (568b), scripts/content_filler.py (11919b), scripts/gen_calendar_spec.py (20901b), scripts/gen_test_grids.py (8072b), scripts/grid_builder.py (88198b), scripts/module_assembler.py (22173b), scripts/template_generator.py (4823b), scripts/templates/3x3-merge.json (2428b), scripts/templates/3x3-mixed-styles.json (5518b), scripts/templates/4x2-app-card.json (2186b), scripts/templates/calendar-dashboard-interactive.json (20108b), scripts/visual_editor.py (21305b), skill-card.md (2658b), SKILL.md (10034b)\n\nFile v3.3.1:SKILL.md\n\n---\r\ndisplayName: hug-html\r\nname: hug-html\r\ntags: ['html', 'grid', 'template', 'visual-editor', 'module-library', 'style-presets', 'layout', 'chinese-error-handling']\r\nversion: 3.3.1\r\nauthor: Ldxs\r\nlicense: MIT\r\ndescription: 8种原子组件自由组合 + 3级约束, cell merging, two-level module system (base + composite), 7+ built-in templates, grid-aware visual editor, style presets, post-generation audit, user template save-as, Chinese error handling\r\nsensitive_access: false\r\ncritical_write: false\r\npermission_weight: LOW\r\ndata_dir: ../.standardization/hug-html/data/\r\nexternal_data_dir: true\r\ntrigger: 生成 HTML 模板/编辑 HTML/HTML 模块/网格布局/单元格合并/可视化编辑/输出自包含 HTML\r\ntrigger_negative: 仅询问概念/无文件生成需求/要求使用其他工具\r\nmeta_field_sync: true\r\ncreate_permissions_md: true\r\nlicense_compliance: true\r\n---\r\n# hug-html\r\n\r\n> → 详见核心能力的渐进式文件索引\r\n\r\n## 限制\r\n\r\n- **本技能的能力边界分为支持场景、不支持场景和边界情况三类。**\r\n- **生成推广卡片** — 应用推广、活动宣传、产品介绍的毛玻璃卡片。触发词：\"生成一个 APP 推广 HTML 卡片\"\r\n- **生成信息面板** — 带表格、参数、二维码的信息展示面板。触发词：\"做一个带二维码和参数描述的 HTML\"\r\n- **生成可视化编辑模板** — 带 Ctrl+E 可编辑的 HTML。触发词：\"生成一个可视化编辑的 HTML 模板\"\r\n- **生成日历/周历仪表板** — 假日管理、年份控制、工日统计的交互仪表板。触发词：\"生成一个周历交互 HTML\"\r\n- **生成双端对比卡片** — 左应用右元服务/双实体的对比展示。触发词：\"生成一个双端推广卡片\"\r\n- **内容填充** — 自动/手动填充 data-field 标记的文字和图片。触发词：\"给这个 HTML 模板填充示例内容\"\r\n- **方案模板固化** — 将当前设计保存为可复用的用户模板。触发词：\"把这个模板保存为 my-card\"\r\n- **自由创作 HTML** — AI 参考模块库直接编写自包含 HTML。触发词：\"帮我写一个毛玻璃风格的首页\"\r\n\r\n**不支持的场景：**\r\n- **复杂前端应用** — 不支持路由/状态管理/API 调用（替代：手写 React/Vue）\r\n- **多页面 HTML 站点** — 不处理页面间导航（替代：静态站点生成器）\r\n- **PDF / 图片输出** — 不直接生成图片或 PDF（替代：浏览器打印或截图）\r\n- **外部 CSS/JS 框架集成** — 强调零外部依赖（替代：手动引入 CDN）\r\n- **非网格布局的自由排版** — 基于 CSS Grid（替代：自由生成模式）\r\n- **后端交互** — 纯前端 HTML，无后端能力。影响：数据持久化需额外方案。替代：搭配 Flask/Node.js\r\n\r\n**边界情况：**\r\n- **网格越界** — row/col + rowspan/colspan 不能超过网格总行列数。影响：CSS Grid 异常渲染\r\n- **毛玻璃裁剪** — backdrop-filter 需要 overflow:hidden 容器\r\n- **JSON 模板路径** — --spec 支持绝对/相对路径和内置名，不存在有中文错误提示\r\n- **文件编码** — 必须 UTF-8，其他编码会导致乱码\r\n- **编辑模式兼容性** — Ctrl+E 需要 Chrome/Edge/Firefox，不支持 IE\r\n\r\n## 触发条件\r\n\r\n**正向触发：**\r\n- \"生成 HTML 模板\" / \"HTML template\" / \"hug html\"\r\n- \"编辑 HTML\" / \"可视化编辑 HTML\" / \"visual edit HTML\"\r\n- \"HTML 模块\" / \"HTML module library\"\r\n- \"网格布局\" / \"grid layout\" / \"N×M 网格\"\r\n- \"单元格合并\" / \"rowspan\" / \"colspan\"\r\n- 输出格式：自包含 HTML 文件（毛玻璃卡片风格）\r\n- \"我需要一个 APP 推广卡片，要有个二维码—可以用，支持\"\r\n- \"帮我做一个带表格和参数配置的 HTML 面板—支持，用 data-table + param-panel 模块\"\r\n- \"生成一个双端对比的推广页面—支持，用 header-dual + qr-dual\"\r\n- \"这个模板我想保存下来以后用—支持，用 --save-as 固化\"\r\n- \"给我生成的 HTML 加一个可视化编辑界面—支持，用 visual_editor.py\"\r\n\r\n**否定条件：**\r\n- 不触发：用户仅询问 HTML 语法概念，无文件生成需求\r\n- 不触发：用户明确请求其他特定技能\r\n\r\n## 核心能力\r\n\r\n> 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。\r\n\r\n| # | 能力 | 说明 |\r\n| --- |------| ------ |\r\n| 1 | **骨架结构** | N×M 网格、行列数、单元格合并（rowspan/colspan）、gap 间距 |\r\n| 2 | **骨架约束** | 3级约束（fill/fit/clip），递归传递到组件级别 |\r\n| 3 | **组件体系** | 8种原子组件（text/image/icon/qrcode/table/divider/spacer/group），自由组合 |\r\n| 4 | **组合逻辑** | 方向(row/column)、比例(ratios)、对齐(align)、8方向位置 |\r\n| 5 | **方案模板库** | 内置 7+ 预置{骨架+组件+样式}组合 + **用户可自定义固化** |\r\n| 6 | **样式预设** | 5 种内置风格：商务/科研/喜庆/丧事/技术，一键切换配色字体 |\r\n| 7 | **基础编辑** | 每个文字元素独立控制：字体家族(8种)/字重(100-900)/字号(9-48px)/字色/透明度 |\r\n| 8 | **图片编辑** | 点击输入 URL + 拖放文件替换，所有图片组件均支持 |\r\n| 9 | **生成后审计** | 自动检查 HTML 结构完整性、标签平衡、图片属性、网格越界、渲染风险 |\r\n| 10 | **统一接口** | `--export-interfaces` 导出完整接口定义 JSON，大模型可直接理解 |\r\n| 11 | **方案模板固化** | `--save-as <名>` 将任意生成固化为用户模板，后续按名引用 |\r\n| 12 | **自由生成模式** | AI 参考组件库，理解需求确定骨架→组合组件→约束→生成→审计 |\r\n| 13 | **参数约束** | 行列数 1-10, span≥1, gap 4-24px, 字号 9-48px, 字重 100-900 |\r\n| 14 | **向后兼容** | 旧格式 `\"module\": \"composite:xxx\"` 仍然支持 |\r\n| 14 | **中文错误处理** | 所有脚本内置中文错误提示、参数校验前置、安全文件操作、调试模式 |\r\n\r\n### 渐进式文件索引\r\n\r\n| 文件名 | 分类 | 包含内容 | 审计关联 |\r\n|--------|------|----------|----------|\r\n| `references/LICENSE.md` | 许可协议 | 开源许可证声明（MIT）。包含：MIT 许可证完整文本。 | R-26 |\r\n| `references/antipatterns.md` | 规范指南 | skill 编写中的常见反模式。包含：错误做法示例、正确做法示例、避坑指引。 | R-18 |\r\n| `references/architecture.md` | 架构设计 | skill-standardization 整体架构。包含：模块关系、数据流、核心设计决策。 | 无 |\r\n| `references/call-chains.md` | 参考文档 | 本文件定义 `hug-html` 技能的调用链，供 `skill-sub` 读取和执行。 | 无 |\r\n| `references/changelog.md` | 版本管理 | 版本更新日志。包含：版本号、更新类型、修复项、升级说明。 | R-24 |\r\n| `references/examples.md` | 使用示例 | 各场景完整执行示例。包含：CLI 命令、执行过程、输出结果。 | R-25 C-17 |\r\n| `references/faq.md` | 常见问题 | 常见疑问与解答。包含：问题分类、原因分析、解决方案。 | R-19, R-25 C-19 |\r\n| `references/guide.md` | 使用指南 | 三种执行模式操作教程。包含：audit/create/refactor 流程、参数说明、注意事项。 | 无 |\r\n| `references/module-library.md` | 参考文档 | ``` | 无 |\r\n| `references/permissions.md` | 权限与测试 | 权限扫描说明与测试结论。包含：风险等级、高权限操作说明、测试概览、计时统计。 | R-15, R-16 |\r\n| `references/style-presets.md` | 参考文档 | `hug-html` 支持 5 种常见风格的样式预设，通过 `content_filler.py --preset` 应用。 | 无 |\r\n## 快速开始\r\n\r\n**场景：生成推广卡片**\r\n用户需求：帮我做一个 APP 推广卡片，要有二维码，输出 HTML 文件\r\n系统执行：\r\n```bash\r\npython scripts/template_generator.py --type promo -o \"data/output/card.html\"\r\n```\r\n系统输出：data/output/card.html — 毛玻璃风格推广卡片，含二维码、产品名、宣传语\r\n\r\n**场景：可视化编辑**\r\n用户需求：给这个卡片加一个在线编辑功能，输出可编辑 HTML\r\n系统执行：\r\n```bash\r\npython scripts/visual_editor.py --template data/output/card.html -o data/output/editor.html\r\n```\r\n系统输出：data/output/editor.html — 带 Ctrl+E编辑界面，双击文字可更新\r\n\r\n**场景：生成周历仪表板**\r\n用户需求：做一个带假日管理的周历交互 HTML，输出仪表板\r\n系统执行：\r\n```bash\r\npython scripts/template_generator.py --type calendar-dashboard -o \"data/output/calendar.html\"\r\n```\r\n系统输出：data/output/calendar.html — 交互式周历，支持年份切换和工日统计\r\n## 工作流程\r\n\r\n本技能的执行流程包含以下编号列表（按顺序执行）：\r\n\r\n- **① 解析需求** — 输入 用户需求描述 → 输出 需求规格\r\n- **② 选择/创建 Grid Spec** — 输入 需求规格 → 输出 grid_spec.json\r\n- **③ 引用模块** — 输入 grid_spec.json, modules/ → 输出 module_config.json\r\n- **④ 生成 HTML** — 输入 grid_spec.json, module_config.json → 输出 *.html\r\n- **⑤ 生成编辑界面（可选）** — 输入 *.html → 输出 editor.html\r\n- **⑥ 内容填充（可选）** — 输入 editor.html → 输出 filled.html\r\n- **⑦ 方案模板固化（可选）** — 输入 filled.html → 输出 interfaces.json\r\n- **⑧ 输出结果** — 输入 最终 HTML → 输出 预览\r\n## 权限说明\r\n\r\n| 工具 | 访问级别 | 用途 |\r\n| ------ |----------| ------ |\r\n| Read | 只读 | 读取 Grid Spec、模块库、样式预设 |\r\n| Write | 写入 | 将输出 HTML 写入 `data/output/` |\r\n| Bash | 受限 | 运行内部处理脚本（限制在 `scripts/` 目录内） |\r\n\r\n- **不会**访问系统敏感路径或凭证文件\r\n- **不会**向外部网络发送数据\r\n- **不会**执行用户 Shell 配置文件\r\n- **不会**更新系统注册表或环境变量\r\n- **不会**执行用户 Shell 配置文件\n\nFile v3.3.1:_meta.json\n\n{\n \"ownerId\": \"kn75zfd51df61ajdyqtgvrs1hx84s4q6\",\n \"slug\": \"hug-html\",\n \"version\": \"3.3.1\",\n \"publishedAt\": 1783594053622\n}\n\nFile v3.3.1:references/antipatterns.md\n\n# 反模式手册\r\n\r\n本文档列出 hug-html 技能的常见反模式及正确做法。\r\n\r\n---\r\n\r\n## 反模式列表\r\n\r\n### ❌ 错误：在 SKILL.md 中粘贴大段代码\r\n\r\n**问题**：SKILL.md 应保持 ≤230 行，大段代码会导致文件臃肿，违反 R-17 渐进式加载规范。\r\n\r\n**正确做法**：将代码移到 `scripts/` 目录，在 SKILL.md 中描述调用方式。\r\n\r\n```markdown\r\n❌ 错误示例：\r\n```python\r\ndef generate_template():\r\n # ... 50行代码 ...\r\n```\r\n\r\n✅ 正确示例：\r\n调用 `scripts/template_generator.py --output --type `\r\n```\r\n\r\n---\r\n\r\n### ❌ 错误：使用相对路径 `./scripts/grid_builder.py`\r\n\r\n**问题**：相对路径在不同工作目录下会解析错误，导致脚本找不到。\r\n\r\n**正确做法**：使用相对路径（如 `scripts/grid_builder.py`），skill-standardization 审计工具会自动拼接安装目录。\r\n\r\n```markdown\r\n❌ 错误：python \"C:/Users/.../scripts/template_generator.py\"\r\n✅ 正确：python scripts/template_generator.py --output ../.standardization/hug-html/data/output/result.html\r\n```\r\n\r\n---\r\n\r\n### ❌ 错误：在 SKILL.md 中写\"详见脚本注释\"\r\n\r\n**问题**：用户无法看到脚本注释，且脚本注释容易过时。\r\n\r\n**正确做法**：将详细说明写入 `references/guide.md`，SKILL.md 只写必要信息。\r\n\r\n---\r\n\r\n### ❌ 错误：产出物路径指向安装目录\r\n\r\n**问题**：`artifact_paths` 应指向数据目录（`../.standardization/hug-html/data/output/`），而非安装目录下的 `data/output/`。\r\n\r\n**正确做法**：\r\n\r\n在 `SKILL.md` frontmatter 中：\r\n```yaml\r\nartifact_paths: [\"../.standardization/hug-html/data/output/\"]\r\n```\r\n\r\n在脚本中：\r\n```python\r\nfrom pathlib import Path\r\noutput_dir = Path(__file__).parent.parent.parent / \".standardization\" / \"hug-html\" / \"data\" / \"output\"\r\n```\r\n\r\n---\r\n\r\n### ❌ 错误：模块名拼写错误\r\n\r\n**问题**：`SKILL.md` 或 `references/` 中引用的模块名与实际文件名不一致，导致用户调用失败。\r\n\r\n**正确做法**：每次提及脚本名时，用绝对路径验证文件是否存在。\r\n\r\n```\r\n✅ 正确：python \"C:/Users/sm001/.workbuddy/skills/hug-html/scripts/template_generator.py\" --help\r\n```\r\n\r\n---\r\n\r\n### ❌ 错误：术语不一致\r\n\r\n**问题**：同一概念混用多个术语（如\"配置\"/\"配置\"、\"填充内容\"/\"填内容\"），增加理解成本。\r\n\r\n**正确做法**：全文统一术语。\r\n\r\n| 概念 | 统一术语 | 错误术语 |\r\n|------|----------|----------|\r\n| configuration | 配置 | 配置、setting |\r\n| fill content | 填充内容 | 填内容、填入 |\r\n| module | 模块 | 组件、component |\r\n| preset | 预设 | 预置、preset |\r\n| update | 更新 | 更新、modify |\r\n\r\n---\r\n\r\n## 检查清单\r\n\r\n- [ ] SKILL.md ≤ 230 行？\r\n- [ ] 无大段代码（>10行）直接在 SKILL.md 中？\r\n- [ ] 所有路径均为相对路径？\r\n- [ ] 无\"详见脚本注释\"等推卸责任的描述？\r\n- [ ] `artifact_paths` 指向数据目录而非安装目录？\r\n- [ ] 所有脚本名拼写正确且文件存在？\r\n- [ ] 术语全文统一？\r\n\r\n---\r\n\r\n> 本文档遵循 R-18 反模式引用规范，由 `skill-standardization v2.38.6` 生成。\n\nFile v3.3.1:references/architecture.md\n\n# 四层架构（细化）\r\n\r\nhug-html 采用四层架构设计，从抽象到具体逐层约束。\r\n\r\n```\r\n骨架 (Skeleton)\r\n├── 骨架结构 — N×M 网格、行列数、单元格合并(rowspan/colspan)、gap 间距\r\n├── 骨架样式 — 底板背景/渐变/透明度、外阴影、外边框、圆角、内外边距\r\n└── 约束模式 — fill(完全贴合) / fit(等比缩放) / clip(裁剪遮挡)\r\n\r\n模块 (Module) ← 组件组合 = {组件声明 + 约束 + 比例} 自由搭配\r\n├── 组件组合 — 8种原子组件自由搭配（text/image/icon/qrcode/table/divider/spacer/group）\r\n├── 组合逻辑 — 方向(row/column)、比例(ratios)、对齐(align/cross_align)\r\n└── 约束传递 — 骨架约束模块 → 模块约束组件（递归）\r\n\r\n组件 (Component) ← 8种原子类型\r\n├── text — 纯文本（title/body/caption 三种变体）\r\n├── image — 图片（支持 fit/cover/fill 填充模式）\r\n├── icon — 图标（FontAwesome / SVG 内联）\r\n├── qrcode — 二维码（API 生成）\r\n├── table — 数据表格（表头+行）\r\n├── divider — 分割线\r\n├── spacer — 空白占位\r\n└── group — 组合容器（递归包含子组件）\r\n\r\n基础样式 (Base)\r\n└── CSS 原语 — 字体/颜色/渐变/圆角/间距/阴影/边框\r\n```\r\n\r\n**编辑粒度**（可视化编辑器内）：\r\n| 可更新 | 不可更新（需改 Grid Spec） |\r\n|--------|---------------------------|\r\n| ✓ 图片内容（点击输入 URL / 拖放文件替换） | ✗ 骨架结构（行列数、合并方式、gap） |\r\n| ✓ 基础样式（每个文字元素独立：字体家族/字重/字号/字色） | ✗ 模块结构（组件的 HTML 骨架） |\r\n| ✓ 模块样式（通过 cell style 覆盖背景色/内边距） | ✗ 骨架样式（底板色/外阴影等） |\r\n\r\n**大模型使用流程**（自由生成模式）：\r\n1. 理解用户需求 → 确定骨架结构：几行几列、哪些单元格需要合并\r\n2. 确定约束模式：fill/fit/clip → 决定骨架对模块、模块对组件的约束\r\n3. 描述需要的组件 → 从8种原子组件中自由组合，放入对应骨架位置\r\n4. 配置组合逻辑：方向、比例、对齐方式\r\n5. 生成 HTML → 可直接用 `module_assembler.py` 或自由生成自包含 HTML\n\nFile v3.3.1:references/call-chains.md\n\n# call-chains.md — hug-html 调用链定义\r\n\r\n本文件定义 `hug-html` 技能的调用链，供 `skill-sub` 读取和执行。\r\n\r\n---\r\n\r\n## 调用链 1：generate-html（完整生成流程）\r\n\r\n**描述**：从需求分析到输出最终 HTML 的完整流程\r\n\r\n**触发方式**：`/hug-html generate --type --output `\r\n\r\n**步骤**：\r\n\r\n| 步骤 | 动作 | 调用脚本 | 输出 |\r\n|------|-------|------|------|\r\n| 1 | 解析需求 | （AI 理解用户意图） | 确定 `type`, `preset`, `modules` |\r\n| 2 | 生成模板 | `template_generator.py --type --output ` | `template.html` |\r\n| 3 | 填充内容（可选） | `content_filler.py --auto --template --output ` | `filled.html` |\r\n| 4 | 应用样式预设（可选） | `content_filler.py --preset

--template --output ` | `styled.html` |\r\n| 5 | 生成编辑界面（可选） | `visual_editor.py --template --output ` | `editor.html` |\r\n| 6 | 组装模块（可选） | `module_assembler.py --modules --output ` | `assembled.html` |\r\n| 7 | 输出最终文件 | （复制到 `data/output/final.html`） | `final.html` |\r\n\r\n**调用链 JSON**（`skill-sub` 格式）：\r\n\r\n```json\r\n{\r\n \"name\": \"generate-html\",\r\n \"description\": \"从需求到最终 HTML 的完整生成流程\",\r\n \"steps\": [\r\n {\"step\": 1, \"action\": \"parse-requirement\", \"tool\": \"AI\", \"output\": \"type,preset,modules\"},\r\n {\"step\": 2, \"action\": \"generate-template\", \"script\": \"template_generator.py\", \"args\": \"--type {type} --output data/output/template.html\"},\r\n {\"step\": 3, \"action\": \"fill-content\", \"script\": \"content_filler.py\", \"args\": \"--auto --template data/output/template.html --output data/output/filled.html\", \"optional\": true},\r\n {\"step\": 4, \"action\": \"apply-preset\", \"script\": \"content_filler.py\", \"args\": \"--preset {preset} --template data/output/template.html --output data/output/styled.html\", \"optional\": true},\r\n {\"step\": 5, \"action\": \"generate-editor\", \"script\": \"visual_editor.py\", \"args\": \"--template data/output/template.html --output data/output/editor.html\", \"optional\": true},\r\n {\"step\": 6, \"action\": \"assemble-modules\", \"script\": \"module_assembler.py\", \"args\": \"--modules {modules} --output data/output/assembled.html\", \"optional\": true},\r\n {\"step\": 7, \"action\": \"finalize\", \"tool\": \"AI\", \"output\": \"data/output/final.html\"}\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## 调用链 2：edit-html（编辑流程）\r\n\r\n**描述**：生成模板 → 生成编辑界面 → 用户编辑 → 导出最终 HTML\r\n\r\n**触发方式**：`/hug-html edit --template `\r\n\r\n**步骤**：\r\n\r\n| 步骤 | 动作 | 调用脚本 | 输出 |\r\n|------|-------|------|------|\r\n| 1 | 检查模板是否存在 | （AI 验证） | 模板路径 |\r\n| 2 | 生成可视化编辑界面 | `visual_editor.py --template --output ` | `editor.html` |\r\n| 3 | 提示用户在浏览器中编辑 | （AI 输出提示） | 编辑说明 |\r\n| 4 | 用户导出最终 HTML | （用户点击「生成最终 HTML」按钮） | `final.html` |\r\n| 5 | 提取编辑后内容（可选） | `content_filler.py --extract --output ` | `content.json` |\r\n\r\n**调用链 JSON**：\r\n\r\n```json\r\n{\r\n \"name\": \"edit-html\",\r\n \"description\": \"生成可视化编辑界面并导出最终 HTML\",\r\n \"steps\": [\r\n {\"step\": 1, \"action\": \"validate-template\", \"tool\": \"AI\", \"output\": \"template-path\"},\r\n {\"step\": 2, \"action\": \"generate-editor\", \"script\": \"visual_editor.py\", \"args\": \"--template {template} --output data/output/editor.html\"},\r\n {\"step\": 3, \"action\": \"prompt-user\", \"tool\": \"AI\", \"output\": \"edit-instructions\"},\r\n {\"step\": 4, \"action\": \"export-final\", \"tool\": \"user\", \"output\": \"final.html\"},\r\n {\"step\": 5, \"action\": \"extract-content\", \"script\": \"content_filler.py\", \"args\": \"--extract data/output/editor-output.html --output data/config/content.json\", \"optional\": true}\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## 调用链 3：assemble-with-modules（模块组装流程）\r\n\r\n**描述**：选择模块 → 组装 → 填充内容 → 输出\r\n\r\n**触发方式**：`/hug-html assemble --modules `\r\n\r\n**步骤**：\r\n\r\n| 步骤 | 动作 | 调用脚本 | 输出 |\r\n|------|-------|------|------|\r\n| 1 | 列出可用模块 | `module_assembler.py --list` | 模块列表 |\r\n| 2 | 组装选定模块 | `module_assembler.py --modules --output ` | `assembled.html` |\r\n| 3 | 填充内容（可选） | `content_filler.py --template --content --output ` | `filled.html` |\r\n| 4 | 生成编辑界面（可选） | `visual_editor.py --template --output ` | `editor.html` |\r\n\r\n**调用链 JSON**：\r\n\r\n```json\r\n{\r\n \"name\": \"assemble-with-modules\",\r\n \"description\": \"选择模块并组装成完整 HTML\",\r\n \"steps\": [\r\n {\"step\": 1, \"action\": \"list-modules\", \"script\": \"module_assembler.py\", \"args\": \"--list\"},\r\n {\"step\": 2, \"action\": \"assemble\", \"script\": \"module_assembler.py\", \"args\": \"--modules {modules} --output data/output/assembled.html\"},\r\n {\"step\": 3, \"action\": \"fill-content\", \"script\": \"content_filler.py\", \"args\": \"--template data/output/assembled.html --content data/config/content.json --output data/output/filled.html\", \"optional\": true},\r\n {\"step\": 4, \"action\": \"generate-editor\", \"script\": \"visual_editor.py\", \"args\": \"--template data/output/assembled.html --output data/output/editor.html\", \"optional\": true}\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## 注册方式（skill-sub）\r\n\r\n将以上 JSON 保存到 `data/config/call-chains.json`，或在 `skill-sub` 中注册：\r\n\r\n```bash\r\npython \"$(SKILL_DIR)/../skill-sub/scripts/chain_manager.py\" register --file \"C:/Users/sm001/.workbuddy/skills/hug-html/data/config/call-chains.json\"\r\n```\r\n\r\n---\r\n\r\n## 调用示例\r\n\r\n```bash\r\n# 使用 generate-html 调用链\r\npython \"$(SKILL_DIR)/../skill-sub/scripts/chain_executor.py\" run --chain generate-html --type promo --preset business\r\n\r\n# 使用 edit-html 调用链\r\npython \"$(SKILL_DIR)/../skill-sub/scripts/chain_executor.py\" run --chain edit-html --template \"data/output/template.html\"\r\n\r\n# 使用 assemble-with-modules 调用链\r\npython \"$(SKILL_DIR)/../skill-sub/scripts/chain_executor.py\" run --chain assemble-with-modules --modules \"color:gradient-purple,font:title-large,image:img-cover\"\r\n```\n\nFile v3.3.1:references/changelog.md\n\n## [3.3.1] - 2026-07-09\r\n\r\n### 修复\r\n- **displayName 统一为 kebab-case**：ClawHub/SkillHub 发布的显示名与技能名一致（），废除驼峰格式\r\n\r\n## [3.3.0] - 2026-07-09\r\n## [3.3.0] - 2026-06-30\r\n\r\n### 修复\r\n- refactor: hug-html\r\n\r\n---\r\n\r\n## [3.2.0] - 2026-06-26\r\n\r\n### 修复\r\n- refactor: hug-html\r\n\r\n---\r\n\r\n## [3.1.0] - 2026-06-26\r\n\r\n### 修复\r\n- refactor: hug-html\r\n\r\n---\r\n\r\n## 3.0.4 (2026-06-02) -- skill-standardization 改造\r\n\r\n### Changed\r\n- R-10: SKILL.md frontmatter tags 和 description 与 _meta.json 同步一致\r\n- R-04: description 删除版本号（_meta.json 和 SKILL.md 均去除）\r\n- R-20: changelog.md 术语统一（删除→删除）\r\n- **R-17**: SKILL.md 缩减至 181 行，非标章节按 body.json 三层规则处理:\r\n - 四层架构（细化）→ 渐进式: references/architecture.md\r\n - 能力边界 → 重命名: 限制\r\n - 错误处理说明 → 合并: 核心能力第14项\r\n - 附录 → 合并: 核心能力 ### 渐进式文件索引\r\n\r\n---\r\n\r\n## 3.0.3 (2026-05-31)\r\n\r\n### 修复\r\n- **R-01/R-07**: frontmatter 补全 trigger 和 trigger_negative 字段\r\n- **R-04**: description 删除版本号\r\n- **R-06**: 补回缺失的 H1 标题\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n## 3.0.2 (2026-05-30)\r\n\r\n### 修复\r\n- audit --fix 自动修正\r\n\r\n---\r\n\r\n## 3.0.1 (2026-05-30)\r\n\r\n### 修复\r\n- audit --fix 自动修正\r\n\r\n---\r\n\r\n## 3.0.0 (2026-05-30) — 组件式架构重构\r\n\r\n### 重大更新（MAJOR）\r\n- **架构重构**：从预置复合模块模板改为原子组件+声明式组合\r\n - 删除 14 个固定复合模块，替换为 8 种原子组件（text/image/icon/qrcode/table/divider/spacer/group）\r\n - 新增 3 级约束系统（fill/fit/clip），递归作用于骨架→模块→组件\r\n - 新增声明式组合逻辑：方向(row/column)、比例(ratios)、对齐(align/cross_align)\r\n - 新增 组件引擎， 支持新旧两种 Spec 格式\r\n\r\n### Changed\r\n- module_assembler.py 完全重写为组件引擎\r\n- grid_builder.py build_cell_html() 支持 components 字段\r\n- references/module-library.md 重写为组件系统文档\r\n- SKILL.md 四层架构、核心能力、快速开始全面更新\r\n\r\n---\r\n## 2.1.4 (2026-05-30)\r\n\r\n### 修复\r\n- audit --fix 自动修正\r\n\r\n---\r\n\r\n## 2.1.3 (2026-05-30) — R-12 合规完善\r\n\r\n### Changed\r\n- 所有脚本补充 DEFAULT_DATA_DIR_RAW + DATA_DIR R-12 定义\r\n- _meta.json 补充 data_dir 字段\r\n- 运行 fix_missing_data_dir 一键修复，R-12 审计通过\r\n\r\n\r\n# Changelog — hug-html\r\n\r\n\r\n\r\n## 2.1.2 (2026-05-30) — skill-standardization 改造 + R-12 脚本补全\r\n\r\n### Changed\r\n- 版本号 v2.1.1 → v2.1.2（SKILL.md + _meta.json + 脚本版本字符串三端统一）\r\n- SKILL.md frontmatter 补全 description 字段\r\n- SKILL.md 缩减至 ≤230 行（删除冗余空白行和 H1 标题）\r\n- 尾部版本声明更新为 2.1.2\r\n- 删除 references/faq-q4-fixed.md 遗留文件\r\n- template_generator.py / visual_editor.py / content_filler.py: 补充 DEFAULT_DATA_DIR_RAW + DATA_DIR R-12 定义\r\n- gen_calendar_spec.py: 补充 DEFAULT_DATA_DIR_RAW + DATA_DIR，保留 TEMPLATES_DIR 指向内置模板\r\n- _meta.json: 补充 data_dir 字段\r\n\r\n### Fixed\r\n- SKILL.md 版本号与 _meta.json 不一致问题\r\n- 4 个脚本缺少 R-12 合规的数据目录变量声明\r\n\r\n## 2.1.1 (2026-05-29) — skill-standardization 合规修正\r\n\r\n### Changed\r\n- 版本号 v2.1.0 → v2.1.1（`skill-standardization update --fix` 自动 bump）\r\n- `_meta.json` 补充 `data_dir` 字段，通过 R-12 检查\r\n- `scripts/grid_builder.py`：补充 `DEFAULT_DATA_DIR_RAW` R-12 数据目录字面量声明\r\n- `scripts/gen_test_grids.py`：补充 `DEFAULT_DATA_DIR_RAW` R-12 字面量\r\n- `scripts/module_assembler.py`：补充 `DEFAULT_DATA_DIR_RAW` R-12 字面量\r\n\r\n## 2.1.0 (2026-05-29) — 全面中文异常处理 + 能力边界定义\r\n\r\n### Added\r\n- 所有脚本集成中文错误处理机制：`show_error()` 函数统一输出 `❌ [错误类型] 说明 + 💡 修复建议`\r\n- `safe_read_json()` / `safe_write_text()` 安全文件操作工具，文件不存在/JSON 格式错误/编码异常均有中文指引\r\n- `--debug` 参数支持（grid_builder.py / template_generator.py / visual_editor.py），加参数显示完整堆栈\r\n- SKILL.md 新增「能力边界」章节：✅ 支持场景 / ❌ 不支持场景 / ⚠️ 边界情况，明确回答\"这个需求支不支持\"\r\n- SKILL.md 新增「错误排查」快速入门表格+「错误处理说明」章节\r\n- SKILL.md 触发场景补充多个复杂需求触发示例\r\n- faq.md 新增 Q11-Q17：错误码对照表、文件找不到修复、布局错乱排查、编辑器无响应、模板固化使用、能力边界判断\r\n\r\n### Changed\r\n- `grid_builder.py`: main() 包裹 try/except，所有文件读取/写入改用安全函数\r\n- `template_generator.py`: 重写为 try/except + 中文错误，引入 grid_builder 的 show_error/safe_read_json/safe_write_text\r\n- `visual_editor.py`: 重写为 try/except + 中文错误，模板不存在/读取失败均有中文指引\r\n- `content_filler.py`: 重写为 try/except + 中文错误，文件读取/JSON 解析/填充字段校验均有中文提示\r\n- `SKILL.md` frontmatter 版本号 v2.0.4 → v2.1.0\r\n\r\n## 2.0.1 (2026-05-29) — 完整交互 + 审计 + 标准化\r\n\r\n### Added\r\n- `scripts/grid_builder.py` — 核心网格引擎：N×M 网格布局、单元格合并（rowspan/colspan）\r\n- 两层级模块体系：Base（63 个 CSS 原语）+ Composite（14 个可复用 HTML 组件）\r\n- 内置 7 个方案模板：harmony-app、harmony-dual、calendar-dashboard(交互版)、promo、3x3-merge、4x2-app-card、3x3-mixed-styles\r\n- 泛化三个用户模板：harmony-app，harmony-dual，calendar-dashboard\r\n- `calendar-dashboard` 完整交互版：5×3 网格、年份控制、周末规则勾选、假日区间 CRUD、补班管理、周历视图、总工日统计\r\n- `grid_builder.py` 支持 `scripts` 字段注入自定义 JS，支持 `file` 字段引用外部 JSON 模板\r\n- `scripts/gen_calendar_spec.py` — 交互日历模板生成器\r\n- `scripts/gen_test_grids.py` — 测试 Grid Spec / 模块 JSON 生成工具\r\n- 图片编辑：点击输入 URL + 拖放文件替换（`editable-img` 类），所有复合模块图片均支持\r\n- 编辑器字体控制：字体家族（8种）、字重（100-900）、字号（9-48px）、字色拾色器\r\n- 5 种样式预设：business / academic / festive / mourning / tech，`style_preset` 字段一键切换\r\n- 生成后审计 `audit_html()`：检查 DOCTYPE、标签平衡、网格越界、单元格重叠、backdrop-filter 裁剪、背景异常\r\n- 生成说明 `print_generation_guide()`：每次生成强制输出编辑方法、创作模式、可用资源、审计说明\r\n- 方案模板固化 `--save-as <名>`：将任意 Grid Spec 保存为用户模板，自动版本管理\r\n- `--export-interfaces`：导出完整接口定义 JSON（Grid Spec schema + 63 base + 14 composite + 5 presets）\r\n- `scripts/templates/` 目录：内置文件型模板跟随技能安装（不丢失）\r\n- body 背景智能选择：玻璃卡用 `#000`，普通卡用 card bg 或 `#eef2f7`\r\n\r\n### Changed\r\n- `scripts/module_assembler.py` — 重写为 grid-aware（接受 grid spec 而非扁平模块列表）\r\n- `scripts/template_generator.py` — 重写，删除 `gen_body_*` 硬编码，使用 grid 框架，支持用户模板\r\n- `scripts/visual_editor.py` — 增强为网格感知编辑器 + 字体/字重/字号/字色独立控制 + 拖放图片\r\n- `scripts/content_filler.py` — 更新为 v2 接口\r\n- 所有复合模块图标从 `

` 改为 `` 可点击换图\r\n- 通用化模板内容：删除具体来源（刻在石头上/灯球色盘），改用通用占位符\r\n- header-entity/header-dual/qr-card/qr-dual/text-img-right 所有图片均加 `editable-img` 类\r\n- CSS cell style 去重：style dict 直接替换默认 bg/padding，不再叠加\r\n- 编辑器工具栏全面升级：B/I/U + 字体 + 字重 + 字号 + 拾色器 + 背景色 + 透明度\r\n- 数据库目录移至 `.standardization/hug-html/data/`，遵循 R-11/R-22 规范\r\n- `SKILL.md` — 四层架构定义（骨架结构/骨架样式/模块结构+样式/基础样式）\r\n- `references/guide.md` — 完整重写为 v2 网格架构教程\r\n- `references/module-library.md` — 完整重写为两层级模块说明\r\n- 版本号 `1.0.1` → `2.0.1`\r\n\r\n### Fixed\r\n- Grid Spec `cells` 位置统一：`grid.cells[...]` 为标准存储位置，兼容顶层 `cells`\r\n- 单元格 CSS 生成逻辑修正（style dict 重叠问题）\r\n- body 背景硬编码 `#000` 修复：根据模板类型智能选择\r\n- `backdrop-filter` 从 DEFAULT_CARD_STYLE 泄露到普通模板（导致内容裁剪）修复\r\n- 日历 JS 缺失 `