创建 V2 扩展¶

什么时候用？¶

手上有一个 Arduino 库、一份传感器手册，或仅有一份功能需求，想从零做一个新的 Mind+ V2 扩展库
目标目录还不存在，或是一个空目录
需要 AI 帮你把「想要什么积木」翻译成符合 V2 规范的配置、积木定义和代码生成器

不适合的情况

如果你要改的是已有的 V2 扩展，请用已有 V2 升级；如果你有一个 V1 扩展库要迁移，请用V1 → V2 转换。创建流程要求目标目录为空，不会覆盖现有项目

具体要描述什么？¶

你需要提供	说明	是否必需
需求	这个扩展是做什么的、包了哪个库、积木应该长什么样	必需
库源码/资料路径	用于确认接口与依赖	有则更好
目标目录	可指定父目录或工作目录	必需
运行模式	上传模式 / Python 积木模式	必需
支持主板	Arduino UNO、掌控板、行空板K10/M10...	可选
扩展身份	`id` / `author` / 版本号	可选

关于扩展身份与查重

如果官方已收录同 author + id 的库，会使用已存在的库继续开发（非本人仓库先 fork）；如果只有 id 与他人重名，新目录会自动追加作者后缀作为去重手段

推荐提示词¶

方案 A：最小可用（推荐首次使用）¶

使用 mindplus-extension-skills，为 DFRobot 的 XX 传感器创建 Mind+ V2 上传模式扩展
库源码在 extensions/xx-source，输出到 extensions/xx-v2
积木先按库的主要功能来设计，具体积木我等你列出来再确认
完成后走 Basic 审查，先不要发布

方案 B：积木规格说清楚¶

使用 mindplus-extension-skills 创建 Mind+ V2 扩展:
- 来源：extensions/xx-source（Arduino 库）
- 目标目录：extensions/xx-v2
- 模式：上传模式
- 积木：初始化、读取温度、读取湿度；引脚为下拉选择，量程为下拉选择
- 支持主板：Arduino UNO、掌控板
- id：xxsensor，author：<你的作者名>
完成创建并走 Basic 审查，先不要发布

方案 C：Python 积木模式¶

使用 mindplus-extension-skills 创建一个 Python 积木模式扩展
需求：封装 XX 算法，提供「载入模型」「识别」「获取结果」三块积木
输出到 extensions/xx-py，依赖按我提供的 requirements.txt 原样记录，不要自行升级版本，只做创建和审查

方案 D：创建后直接发布¶

按方案 B 完成创建并通过 Basic 审查后，提交并推送到 gitee.com/<你的账号>/ext2-xx 的 master 分支

AI 会怎么做¶

查重与来源选择（Lite） —— 先按模式查询官方收录清单与 Gitee 官方组织，确认这个库是否已经存在；若已存在且不属于你，会先核验令牌并 fork。详见代码审核
整理规格 —— 把你用大白话描述的需求整理成结构化的扩展规格；缺少会影响实现的产品决策时，会停下来问你，而不是猜
准备脚手架 —— 使用固定版本的 Builder 脚手架
安装依赖 —— 环境可用且在你的授权范围内时，最多尝试一次 npm install
生成扩展文件 —— 创建规范化的文件：config.json、index.js、func.js、图标与多语言文件等，并保持ID、参数顺序与默认值
补齐仓库说明 —— 把脚手架自带的 README 模板替换为有依据的项目说明（功能、积木清单、使用示例、变更记录）
静态检查 —— 运行配置、资源引用、本地化、生成器映射等检查；构建可用时再执行一次 npm run build
发布前审查（Basic） —— 核对八项必需检查：配置合规、静态完整性、源码语义、恶意代码、构建通过、积木可见、积木可用、包体积不超过 5,000,000 字节。未通过不发布
交接结果 —— 输出项目路径、已通过的检查、未执行的项目及原因