uniGUI = Unified GUI。让 Delphi 开发者用写桌面应用的方式写 Web 应用，但底层仍然是 Web——有状态、多线程、无 GC、24/7 运行。
这是一个 Claude Code Skill，把 116 篇 uniGUI 官方文档（版本 1.60.0）浓缩成一套可即用的知识体系与思维模型。装上之后，Claude 就成了你的 uniGUI 技术顾问——帮你理解 Web 开发范式转换、避开常见陷阱、设计可扩展的架构。
| 模块 | 内容 |
|---|---|
| 🧠7 个核心心智模型 | VCL for Web 抽象层、三层隔离架构、函数替代变量、资源生命周期、客户端对齐、接口隔离、HyperServer 多进程思维 |
| 🎯10 条决策启发式 | 层级归属法则、全局变量禁忌、数据库连接法则、TTimer 替换法则、try-finally 铁律、异步优先原则…… |
| 🗂️组件映射速查 | VCL → uniGUI 控件对照表（TButton→TUniButton、TTimer→TUniTimer 等）+ Web 独有控件 + 移动端控件 |
| 8 个最常见的 uniGUI Bug 来源及正确做法 | |
| 🚀部署决策树 | Standalone / Service / ISAPI / HyperServer 四种模式选型 + HyperServer Node 状态机 |
| ⚖️诚实边界 | 明确标注版本滞后、API 覆盖、移动端等局限——不吹牛 |
把本仓库 clone 到 Claude Code 的 skills 目录：
git clone https://github.com/elvis-shi-Canada/unigui-framework-skill.git \
~/.claude/skills/unigui-framework-skillclone 到项目的 .claude/skills/ 目录下：
git clone https://github.com/elvis-shi-Canada/unigui-framework-skill.git \
.claude/skills/unigui-framework-skill安装后无需任何配置，Claude Code 启动时自动发现并加载。
直接和 Claude 聊 uniGUI 相关的话题，它会自动激活这个 Skill。触发关键词包括：
uniGUI · UniGUI · Delphi Web · VCL转Web · Delphi SPA · HyperServer · uniGUI部署 · uniGUI最佳实践
也可以用于：架构设计、代码审查、VCL 迁移、性能优化、部署规划。
示例提问：
- 「我的 uniGUI 项目数据库连接放在 ServerModule 里，高并发时为什么会崩？」
- 「帮我把这个 VCL Form 迁移到 uniGUI，注意哪些坑？」
- 「1000 并发该选 ISAPI 还是 HyperServer？」
unigui-framework-skill/
├── SKILL.md # 主知识文件（加载到 Claude 上下文）
└── references/
└── research/ # 5 篇深度研究（按需引用）
├── 01-architecture.md # 架构与设计理念（27 篇官方文档）
├── 02-components.md # 组件体系与 API（32 篇）
├── 03-deployment.md # 部署与 HyperServer（30+ 篇）
├── 04-best-practices.md # 最佳实践与反模式（27 篇）
└── 05-verification.md # 调研验证
此 Skill 基于 uniGUI 官方文档（版本 1.60.0）提炼，存在以下局限（详见 SKILL.md）：
- 版本滞后风险 — 新版本可能引入新特性或改变行为
- 不覆盖所有 API — 某些边缘控件和高级特性细节可能未完全涵盖
- 无实际项目经验 — 基于文档分析，某些「潜规则」和「坑」可能未被覆盖
- Sencha Ext JS 依赖 — 前端依赖 Ext JS，其版本/许可变更可能影响 uniGUI
- 无法替代官方文档 — 具体 API 签名请参考官方 CHM 文档
- 不覆盖 C++Builder — 主要基于 Delphi 视角
- 移动端覆盖有限 — TUnimXXX 控件未深入分析