# unigui-framework-skill

**Repository Path**: shock_hack_admin/unigui-framework-skill

## Basic Information

- **Project Name**: unigui-framework-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uniGUI Framework · Claude Code Skill

> uniGUI = Unified GUI。让 Delphi 开发者用写桌面应用的方式写 Web 应用，但底层仍然是 Web——有状态、多线程、无 GC、24/7 运行。

这是一个 [Claude Code](https://claude.com/claude-code) Skill，把 **116 篇 uniGUI 官方文档**（版本 1.60.0）浓缩成一套可即用的知识体系与思维模型。装上之后，Claude 就成了你的 uniGUI 技术顾问——帮你理解 Web 开发范式转换、避开常见陷阱、设计可扩展的架构。

---

## ✨ 这个 Skill 包含什么

| 模块                         | 内容                                                                                                       |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| 🧠**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 目录：

```bash
git clone https://github.com/elvis-shi-Canada/unigui-framework-skill.git \
  ~/.claude/skills/unigui-framework-skill
```

### 方式二：单项目安装

clone 到项目的 `.claude/skills/` 目录下：

```bash
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`）：

1. **版本滞后风险** — 新版本可能引入新特性或改变行为
2. **不覆盖所有 API** — 某些边缘控件和高级特性细节可能未完全涵盖
3. **无实际项目经验** — 基于文档分析，某些「潜规则」和「坑」可能未被覆盖
4. **Sencha Ext JS 依赖** — 前端依赖 Ext JS，其版本/许可变更可能影响 uniGUI
5. **无法替代官方文档** — 具体 API 签名请参考官方 CHM 文档
6. **不覆盖 C++Builder** — 主要基于 Delphi 视角
7. **移动端覆盖有限** — TUnimXXX 控件未深入分析

---

## 📄 License

[MIT](./LICENSE)