递归火山软件开发平台

标题: neimeng原创【重磅分享】火山编程 AI 技能书 v1.2 [打印本页]

作者: neimemg 时间: 昨天 22:52
标题: neimeng原创【重磅分享】火山编程 AI 技能书 v1.2
各位火山友,大家好!  更新版本首发新版本

一、为什么要有这套东西；有感兴趣：qq群1125107030
────────────────────────────────────────────────────

用过 AI 写火山程序的朋友都知道痛点:你让它写个按钮事件,
它给你吐一段 C++ 或者干脆发明不存在的火山语法;你问封装
怎么写,它连 @嵌入式方法是什么都不知道。原因很简单——
AI 的训练数据里几乎没有火山平台的资料,《封装语法》这种
手册它更没见过。

我的解法:把火山官方文档、真实项目经验、踩坑记录,全部
整理成一套 AI 可直接读取的「技能书」。装进 AI 工具后,AI
回答火山问题前会先查本地官方手册,写代码会遵守真实项目
验证过的模式——一句话,AI 从"瞎编"变成"有据可查"。

这个方法我已经完整跑通:全程用这套技能书指导 AI 写出了
客服记录管理软件(增删改/过滤/JSON存档,真实编译),过
程中踩的坑又回写成技能书的经验章节,形成闭环。

二、这套书里到底有什么(详细清单)
────────────────────────────────────────────────────

完全自包含,一个目录拷到任何机器即用,共约 2100 个文件:

【技能 1:volcano-programming —— 火山编程总纲】
  · 火山视窗/安卓/服务器三平台自动路由,答语法前必查手册
  · 视窗≈C++、安卓≈Java、服务器≈Go 的概念映射与互译
  · C/C++ 开源库封装成火山视窗类库的完整工作流(下详)

【技能 2:volcano-window-wrapper —— 视窗封装库检索】
  · 本地封装库源码(.wsv + C++ 包装层)检索复用
  · 已装类库 HTML 手册(119 个库入口目录)路由

【技能 3:exui-volcano —— Exui 界面库开发】
  · Exui.wsv 与 ExuiApi.h 双真源原则、设计器资源规则
  · 窗口四种创建模式、布局器万分比、元素事件分派顺序
  · 大列表暂停重画/允许重画防闪烁模式等

【参考文件 A:syntax-reference.md —— 语法权威速查】
  从《封装语法2026.html》全文 3050 行逐行提炼:
  · 11 种基本数据类型表(含服务器平台特例、变整数=指针)
  · 全部命令关键字精确语义:循环四参数全可省略、判断循
环、挂接事件/取消挂接(标记值机制)、位运算、调试检查
  · 中英文操作符优先级全表(≈近似等于、Mod、&&...)
  · 视窗空对象语义(带空白标志的真实实例,赋值即清空)
  · 系统属性全表 + 全局扩展属性全表(@常量类、@别名类
六种、@全局类、@编译条件...)
  · @视窗.* 全部 27 项插件属性:外部头/源/库/资源文件、
附属文件、附加编译参数(cpp/asm/link)、需求VS版本、
修饰符组与 $(env) 内嵌变量表
  · _OnInitExtra / _OnCleanupExtra 等 10 个编译器自动调
用的类钩子方法(官方 13 封装宏的底层原理)
  · 编译自动宏表(_VOL_DEBUG/_VOL_DLL/_VOL_HIGH_DPI...)
  · 视窗平台硬限制:非嵌入式方法无数组参数/返回、部件
DLL 规则、界面模块三基类

【参考文件 B:language-guide.md —— 应用编程速成】
  全部提炼自可编译真实项目:
  · 程序骨架(启动类/窗口程序类/创建主窗口固定套路)
  · 事件模式:接收事件三要素、来源对象分流、挂接机制
  · 线程三连(是否需要退出→停止→启动)与死锁警告
  · @视窗.布局字符串全解(id/pos/parent_id/client_size)
  · 画板自绘:离屏缓冲防闪烁、乘于屏幕DPI、绘图 API
  · 网络(网页访问/URL编码)、YYJSON 读写双套 API
  · 文件/时间/文本/数组常用命令
  · 2800 行农场游戏验证过的架构:JSON 配置驱动、存档
版本迁移、存档安全锁、分页、GM 面板、每日重置

【参考文件 C:packaging-guide.md —— 封装全流程】
  · 三种封装模式选型表:直封(参考 Mailslot)/vol_ 包装
层(参考 curl/MFC扩展组件库)/启动模板模式
  · 事件封装全链路

begin 静态回调→OnNotify→@<事件名>
触发(curl 进度事件逐行拆解,可直接照抄的模板)
  · 官方 13 封装宏速查(DECLARE_REF_OBJECT_CLASS 系列、
DECLARE_STRUCT_CLASS、GET/SET_STRUCT_MEMBER...)
  · 宏消重模式:一个 @def_macro 覆盖几十个同类方法
  · 启动模板七处改造点清单(w_mfc_startup 实例:关闭标
准启动、改链接入口、CWinApp 映射火山虚拟方法...)
  · @视窗.输入/输出/结构类:免写 C 的 DLL 导入导出
  · 测试先行流程:最小测试类→验证→增量→事件→模板

【参考文件 D:doc-index.md —— 手册地图】
  手册清单、检索技巧、官网补抓规律(HTML 转纯文本)

【官方手册 5 件】
  视窗手册 19.5MB / 安卓手册 33.8MB / 服务器手册 8.5MB /
  封装语法2026.html(权威)/ 火山视窗封装宏.md

【完整封装示例库 2000+ 文件】
  win_base 核心 C++、60+ 个 .wsv 封装库(curl 新旧版、
  mysql、openssl、sqlite、HP-Socket、MFC/WTL 界面、
  WebView2/CEF/ECharts、Office COM、串口设备...)、启动
  模板、MFC 扩展组件库全套源码

【Codex 用户福利】
  包内保留 Codex 专属系统技能(.system,59 文件),即装即用

三、可信度:每一条都有出处,错了已修
────────────────────────────────────────────────────

这套书的知识不是凭空写的,做了三层核验:

  1. 《封装语法2026.html》全文 3050 行逐行精读后提炼,与
   手册冲突处以手册原文为准;
  2. 应用层模式全部来自三个可编译的真实项目;
  3. 逐字回查,累计修正 8 处偏差,例如:
   - @禁止流程检查的准确定义:是"关闭返回值分支检查",
   嵌入式方法自动禁止,网上流传的"必须分号结尾"说法
   只是经验性提醒
   - 文件编码真相:2026 版 .wsv 是 UTF-8 无 BOM(旧版才是
   UTF-16 LE BOM),规则改为"先探测、保留原编码、绝不
   静默转换"
   - parent_id 省略时的真实父级、循环参数省略规则等

  拿不准的内容全部诚实标注推断依据,AI 不会把猜测当官方
  语法教给用户。

四、实战检验:不是纸上谈兵
────────────────────────────────────────────────────

我用这套技能书全程指导 AI 开发,真实经历了完整编译周期:

  · 客服记录管理软件:六字段录入/删除/JSON 自动存档/启动有感兴趣：qq群1125107030
自动载入,普通写法(官方例程同款结构)
  · 过程中 AI 踩的坑,全部回写成技能书经验章节:
   1) 取循环索引() 只能用在计次循环体内——在循环()
      里用会编译报错,这是编译器亲口证实的硬约束,现在
      写进了语法速查
   2) 首次编译失败先删 _int 目录清缓存(按需编译可能混
      入新旧系统库 obj)
   3) 系统类库 LNK2019 符号错位的判断方法与桥接方案
      (写补丁时连 NULL 宏不能用这种细节都记了:外部源
      文件独立编译没有 Windows 头,要用字面量 0)
等等很多很多坑

  这意味着:你用这套书时,AI 已经知道这些坑,不会再踩。
且我们最强大的一点是：无需你去自己去火山软件麻烦的去创建文件，你只需要把指令给ai，拿起水壶烧水泡茶喝就可以了。

五、支持的工具与安装
────────────────────────────────────────────────────

  · ZCode:skills 下技能文件夹 → ~\.agents\skills$全局)
或项目 .zcode\skills\
  · Claude Code / 任何遵循 Agent Skills 规范的工具:复制
到其用户级技能目录(如 ~\.claude\skills$有感兴趣：qq群1125107030
  · Codex:包内已带 agents\openai.yaml 与 .system 系统技
能,完整可用
  · 资源定位"包根优先":docs 与视窗封装和技能放一起即
免配置;也支持 VOLCANO_DOCS / VOLCANO_WRAPPER_LIB /
VOLCANO_LIB_SNAPSHOT 环境变量
  · 技能文件全部 UTF-8 无 BOM,任何工具直接读

六、下载
────────────────────────────────────────────────────

  · 精简版 4.1MB技能 + 官方手册,语法问答、应用开发全可用,适合先试水（测试版）
  · 完整版 323MB:含全部 2000+ 封装示例文件,封装实战开箱即用（解压后1.73G）（正式可全面开发版）

  版本:v1.2(2026-09-14)最新更新

七、注意事项
────────────────────────────────────────────────────

  1. AI 生成的代码建议先编译验证(技能书内建流程就这么
   要求 AI 的:最小测试→验证→增量)
  2. .vcip 是火山插件私有二进制格式,AI 无法直接解包,需
   装入 IDE 后使用
  3. 火山 IDE 需自行安装(带 VS2019 生成工具的 C++ 环境)
  4.用过ai的都知道ai难免出些问题所以有问题发给ai让他自己在修改

有问题、报错、想加功能覆盖更多场景,直接回帖,我持续迭
代。写得仓促,错误在所难免,欢迎拍砖!

希望这套书能帮更多火山友把 AI 真正用起来。有感兴趣：qq群1125107030
不必多说 AI以来
══════════════════════════════════════════════════════════════

作者: 火绒 时间: 1 小时前
是需要进群购买的,想白嫖完整版的，就别进了

欢迎光临递归火山软件开发平台 (https://bbs.voldp.com/)