# 火山技能书通用版 v1.1 视窗更新报告

neimemg

# 火山技能书通用版 v1.1 视窗更新报告

**更新日期：2026 年 9 月 26 日**

火山技能书通用版现已更新至 **v1.1**。

本次更新主要整理并补充火山视窗相关资料，重点完善 `.wsv` 源程序、`.vgrp` 模块以及 `.vprj/.vsln` 项目文件的格式说明，同时增强 AI 对火山视窗项目结构和封装语法的检索能力。

## 一、新增资料

### 1. 火山 `.wsv` 文件格式标准

新增完整的火山文本源程序格式说明，包括：

- 完整程序数据和剪切程序数据
- 文档格式及版本声明
- 包、类、方法、参数、常量和变量定义
- 属性表及系统属性
- 注释行、嵌入行和语句行规则
- 特殊内容的转义及空属性表写法

AI 在创建、读取、修复或修改 `.wsv` 文件时，可以先根据该规范检查文件结构，减少格式错误。

### 2. 火山视窗模块资料

新增 `.vgrp` 模块定义格式及模块使用说明，包括：

- 模块名称、版本、作者和说明
- 项目类型标识符
- 模块依赖关系
- `unique_mark` 唯一标记
- 模块源文件及过滤器路径
- 火山视窗常见系统模块清单

这部分资料可以用于分析模块依赖、生成模块配置和查找系统类库路径。

### 3. 火山视窗项目文件技术规范

新增 `.vprj` 项目文件和 `.vsln` 解决方案文件的结构说明，包括：

- 解决方案与项目的关联方式
- `root_filter` 和 `child_filter` 层次结构
- 模块过滤器配置
- 项目源文件列表
- 项目构建设置
- 活动项目和构建顺序
- DLL、EXE 和控制台项目配置
- Win32、x64、调试目录和输出文件设置

同时增加一致性检查规则：

- 增删 `filter<N>` 后同步维护 `num_child_filters`
- 增删 `file<N>` 后同步维护 `num_files`
- 修改项目文件时保留未知字段及原有项目设置

### 4. 封装语法 Markdown 检索版

新增《火山视窗平台封装语法手册》的 Markdown 检索版本，方便 AI 快速搜索：

- 火山名称、立即数和数据类型
- 系统属性和扩展属性
- 嵌入行及替换符号
- 类、方法、事件和参数定义
- `@视窗.*` 封装属性
- 界面模块和部件 DLL
- 编译条件、外部文件和链接设置

Markdown 版本主要用于快速定位内容，涉及属性名称、参数顺序和替换符号时，仍以原始《封装语法2026.html》和真实可编译源码为最终依据。

## 二、技能检索能力更新

本次同步更新了 `volcano-programming` 和 `volcano-window-wrapper` 两个技能。

AI 现在可以根据文件类型自动选择对应资料：

| 文件或问题 | 优先查阅资料 |
| --- | --- |
| `.wsv` 文本结构 | 火山wsv文件格式标准 |
| `.vgrp` 模块定义 | 火山视窗模块信息 |
| `.vprj/.vsln` 项目结构 | 火山视窗项目文件格式技术规范 |
| 普通火山视窗语法 | 火山视窗完整手册 |
| 封装属性和替换符号 | 封装语法手册及 HTML 原文 |
| C/C++ 类库封装 | 封装指南及现有封装实例 |

技能书的手册索引、应用编程指南和视窗封装检索规则也已同步更新。

## 三、编码规则修正

补充资料中部分内容将项目文件编码描述为固定 UTF-8。结合实际火山项目文件，本版改为更加稳妥的处理规则：

1. 新建文本格式文件优先使用 UTF-8 无 BOM。
2. 修改已有 `.wsv`、`.v`、`.vgrp`、`.vprj` 或 `.vsln` 文件前，必须先检测实际编码。
3. 保留原文件的编码、BOM 和换行格式。
4. 不根据扩展名批量转码。
5. 兼容 UTF-8 无 BOM 和旧项目中可能存在的 UTF-16 LE with BOM。

该修正可以避免 AI 修改项目后造成中文乱码、IDE 无法读取或文件整体发生无关变化。

## 四、兼容性说明

- 本次没有修改现有火山封装源码和二进制文件。
- 原有 `docs`、`视窗封装` 和技能目录结构保持不变。
- 新资料作为补充文档加入，不影响原有手册。
- 封装语法仍以官方原始手册和真实源码为准。
- 新增文档及技能文件均保持 UTF-8 无 BOM。

## 五、更新后的资料范围

目前通用版已经包含：

- 火山视窗完整手册
- 火山视窗封装语法权威手册
- 火山视窗封装语法 Markdown 检索版
- 火山视窗封装宏资料
- `.wsv` 文件格式标准
- `.vgrp` 模块格式和模块清单
- `.vprj/.vsln` 项目文件技术规范
- 火山视窗封装源码及实例库
- 火山编程、视窗封装和 Exui 专项技能

## 六、结语

本次 v1.1 更新主要补齐了火山视窗文件格式和项目结构方面的资料。

更新后，AI 不仅能够查询火山语法和类库，还可以更准确地理解、检查和修改火山视窗的源程序、模块、项目及解决方案文件。后续如发现资料遗漏或实际项目与规范存在差异，将继续根据真实项目和可编译源码进行修正。
需要正式版进群
小宇火山技能书官方交流群1125107030