Ej-pro AI编写易语言增强技能

408089597 · 发表于 7 天前

AI **严格从命令库查询**真实命令后再写
**双层验证**保证代码可运行
**完整的易语言语法规则**指导
**4451 条精易模块 + 核心库**命令支持

非嵌入 RAG**：不依赖向量数据库和嵌入模型，零下载、零外部依赖
用户主动维护**：命令库由您主动增删改，AI 不会偷偷写库
严格只信库**：AI 不会"猜"命令，库中没有就组合实现
双层校验**：生成前查类方法 → 生成后两轮严格校验

| 指标 | 数量 | 说明 |
|------|------|------|
| **命令总数** | **4451** 条 | 全部来自易语言支持库 |
| **参数总数** | **6022** 个 | 命令参数信息 |
| **核心命令** | **48** 条 | 永久注入的高频基础命令 |
| **索引关键词** | **9296** 个 | 倒排索引 |
| **命令库大小** | 7.4 MB | `commands.json` |
| **轻量索引** | 501 KB | `commands_index_lite.json` |

| 类型 | 数量 | 占比 |
|------|------|------|
| 子程序 | 2260 | 50.8% |
| 常量 | 1350 | 30.3% |
| DLL 命令 | 685 | 15.4% |
| 数据类型 | 69 | 1.6% |
| 类 | 68 | 1.5% |
| 资源 | 19 | 0.4% |

| 来源 | 命令数 | 说明 |
|------|--------|------|
| 易语言核心支持库 | 669 | 基础命令 |
| 易语言特殊支持库 | 15 | 系统底层 |
| 精易模块 | 3700+ | 第三方增强 |
| 其他 | 67 | 数据类型/类/资源 |

/易语言增加 <命令内容>       # 添加命令到库
/易语言删除 <命令名>       # 从库删除
/易语言更新 <命令名> <新内容> # 更新命令
/易语言查询 <关键词>       # 查询命令库

当您要求 AI 写易语言代码时，AI 会自动：

1. **必查**：从 `commands.json` 检索相关命令
2. **必用**：严格只用库中真实存在的命令
3. **必验**：生成后双层校验

### 2. 不允许凭记忆写命令

所有命令必须从 `commands.json` 实时查询，AI 不会"猜"。库中没有的命令不能凭空出现，只能用库中已有命令组合实现。

### 3. 用户主动维护命令库

AI **不会自动**增删改命令库，只有您显式使用 `/易语言` 命令时才会修改。这是项目的基本约定。

### 4. 命令名唯一

冲突时三选一：保留旧 / 更新 / 改名。命令名是命令库的主键。

architecture/
├── index.json          # 总索引
├── features/core.json # 功能树（5 大功能簇，23 个叶子节点）
├── modules/structure.json  # 模块详情（7 个模块满足底线）
├── data/data.json    # 数据拓扑
├── pages/delivery.json # 交付物列表
└── tasks/state.json # 任务状态

| 模块 | 功能 |
|------|------|
| M0_skill_entry | 技能入口与路由 |
| M1_command_store | 命令库存储（增删改查）|
| M2_parser_engine | 9 种格式解析引擎 |
| M3_retrieval | 6 层关键词检索 + 混合检索 |
| M4_codegen | 代码生成（严格使用库中命令）|
| M5_validator | 4 项合规校验 |
| M6_conflict_resolver | 冲突三选一处理 |

用户查询
  ↓
混合检索 (RRF 融合)
  ├── 关键词通道 (40%) - enhanced_search.py
  │ - 精确 / 前缀 / 关键词 / 英文 / 描述 / 拼音
  └── 语义通道 (60%) - semantic_search.py
   - TF-IDF + 同义词扩展
  ↓
Top-15 相关命令
  ↓
注入 AI 上下文

- 格式-1：子程序简洁式
- 格式-2：文档式命令
- DLL 命令
- 常量
- 数据类型
- 类
- 资源
- 通用导入器
- 参数修复器

- 详细语法 → [`docs/grammar-rules.md`](docs/grammar-rules.md)
- 查询原则 → [`docs/query-principles.md`](docs/query-principles.md)
- 格式解析规则 → [`docs/import-formats.md`](docs/import-formats.md)
- 命令操作规则 → [`docs/command-rules.md`](docs/command-rules.md)

1. **命令存在性校验**：所有调用必须在库中
2. **控制流首尾配对校验**：`如果` / `如果结束`、`判断循环` / `判断循环尾` 等必须配对
3. **变量声明校验**：使用前必须先 `变量` 声明
4. **类型与参数个数校验**：实参形参个数、类型必须一致

| 阶段 | 基础消耗 | 节省比例 |
|------|----------|----------|
| 初始（无优化） | ~180 万 tokens | 0% |
| SKILL.md 精简 | ~7,100 tokens | 99.6% |
| 深度瘦身（目录分层 + 核心拆分） | ~1,860 tokens | 99.9% |

| 文件 | 行数 | 功能 |
|------|------|------|
| `enhanced_search.py` | 85 | 关键词检索入口 |
| `hybrid_search.py` | 74 | 混合检索入口 |
| `search_engine.py` | 139 | 检索核心引擎 |
| `validate_before_codegen.py` | 62 | 代码验证入口 |
| `validator_core.py` | 103 | 验证核心引擎 |

- `import_format1.py` - 格式-1：子程序简洁式
- `import_core_lib.py` - 格式-2：文档式命令
- `import_dll.py` - DLL 命令导入
- `import_constant.py` - 常量导入
- `import_datatype.py` - 数据类型导入
- `import_class.py` - 类导入
- `import_resource.py` - 资源导入
- `fix_core_lib_params.py` - 参数修复
- `universal_importer.py` - 通用导入器

- `code_validator.py` - 四项合规校验
- `semantic_search.py` - TF-IDF 语义检索
- `optimize_index.py` - 索引优化
- `synonyms.py` - 同义词词典

| 文档 | 行数 | 内容 |
|------|------|------|
| [`docs/grammar-rules.md`](docs/grammar-rules.md) | 110 | 易语言语法规则完整参考 |
| [`docs/query-principles.md`](docs/query-principles.md) | 63 | 查询原则（不列具体命令）|
| [`docs/import-formats.md`](docs/import-formats.md) | 76 | 9 种导入格式 |
| [`docs/command-rules.md`](docs/command-rules.md) | 89 | 命令操作和错误速查 |
| [`SKILL.md`](SKILL.md) | 80 | 技能说明（AI 必读）|

- 语法规则 → [`docs/grammar-rules.md`](docs/grammar-rules.md)
- 查询原则 → [`docs/query-principles.md`](docs/query-principles.md)
- 格式解析规则 → [`docs/import-formats.md`](docs/import-formats.md)
- 命令操作规则 → [`docs/command-rules.md`](docs/command-rules.md)
- 架构切片 → [`architecture/`](architecture/)
- 代码示例 → [`examples/`](examples/)
- 技能定义（AI 必读）→ [`SKILL.md`](SKILL.md)

Ej-pro/
├── README.md                # 项目说明（本文件）
├── SKILL.md                # 技能说明（AI 必读）
├── LICENSE                # MIT 许可证
├── .gitignore
├── architecture.json       # 架构元数据
├── commands.json          # 命令库（4451 条，7.4 MB）
├── commands_index_lite.json  # 轻量索引（501 KB）
├── architecture/          # rwgj 架构切片
│ ├── index.json
│ ├── features/
│ ├── modules/
│ ├── data/
│ ├── pages/
│ └── tasks/
├── scripts/                # 工具脚本
│ ├── enhanced_search.py
│ ├── hybrid_search.py
│ ├── search_engine.py
│ ├── validate_before_codegen.py
│ ├── strict_check.py
│ ├── validator_core.py
│ ├── importers/          # 9 个导入器
│ └── tools/             # 4 个辅助工具
├── examples/                # 5 个真实场景示例
│ ├── 访问百度示例.e
│ ├── 网页抓取与正则解析.e
│ ├── 多对象综合示例.e
│ ├── 读取kldai提取登录链接.e
│ └── 线程安全日志系统.e
└── docs/                   # 4 个技能文档
├── grammar-rules.md
├── query-principles.md
├── import-formats.md
└── command-rules.md

- **本项目仓库**：<https://github.com/40508597/ej-pro>
- **rwgj 任务架构**：<https://github.com/405089597/rwgj_sy>
- **架构切片**：[`architecture/`](architecture/)
- **代码示例**：[`examples/`](examples/)
- **技能文档**：[`docs/`](docs/)
- **AI 技能定义**：[`SKILL.md`](SKILL.md)