![图片[1]-Craft Anything 双系统安装与模型接入教程:macOS 和 Windows 完整指南-雾祈心语](https://bkm.mistora.cc/wp-content/uploads/2026/11/image-51-1024x576.png)
一、Craft Anything 是什么?
Craft Anything 是一个 AI 辅助开发工具。它可以根据自然语言需求,帮助用户创建网站、应用和游戏,也可以读取已有项目并协助修改。
它的基本工作方式是:
- 用户描述需求;
- AI 分析需求并制定计划;
- AI 在本地项目目录中创建或修改文件;
- 调用本地开发工具进行构建和检查;
- 根据构建结果继续修复问题。
Craft Anything 本身主要负责项目管理和 AI 协作,实际构建仍然依赖本机的开发环境,例如 Rust、Node.js、Python 或其他编译工具。
项目地址:
https://github.com/storytold/craft-anything
官方最新版 Release:
二、准备工作
安装前建议准备:
- macOS 或 Windows 电脑;
- 稳定的网络环境;
- 一个兼容 OpenAI API 的模型服务;
- API 地址;
- 模型 ID;
- API 密钥;
- 足够的磁盘空间;
- 项目文件夹的读写权限。
API 密钥属于敏感信息,不要发布到博客、截图或 GitHub 仓库中。
三、macOS 安装教程
1. 下载 Craft Anything
打开官方 Release 页面:
根据 Mac 芯片选择安装包:
- Apple Silicon:M1、M2、M3、M4 等;
- Intel:较早的 Intel Mac。
如果不确定,可以打开终端执行:
uname -m
显示以下内容代表 Apple Silicon:
arm64
显示以下内容代表 Intel:
x86_64
也可以直接下载通用版本:
craft-anything-0.6.1-macos-universal.dmg
2. 安装应用
- 双击下载的
.dmg文件; - 将 Craft Anything 拖入
Applications; - 打开「应用程序」;
- 双击启动 Craft Anything;
- 如果 macOS 弹出安全提示,确认打开官方安装包。
首次启动时会出现引导页面,可以选择:
- 「我是新手」:查看基础引导;
- 「显示全部内容」:查看完整工具说明;
- 「跳过设置」:直接进入应用。
3. 安装 Rust 构建环境
如果使用 Craft Anything 创建 Rust 项目,需要安装 Rust。
在终端执行:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
安装完成后重新打开终端,检查版本:
cargo --version
rustc --version
正常情况下会看到类似:
cargo 1.100.0
rustc 1.100.0
如果终端提示找不到 cargo,执行:
source "$HOME/.cargo/env"
然后再次检查:
cargo --version
4. macOS 配置模型
打开 Craft Anything,进入设置或首次启动的 AI 配置页。
如果使用 OpenAI 兼容接口,选择「按地址添加 AI」,填写:
| 配置项 | 填写内容 |
|---|---|
| 名称 | 自定义,例如 GPT |
| 地址 | 服务商提供的 API Base URL |
| 模型 | 服务商提供的模型 ID |
| API 密钥 | 对应的访问密钥 |
地址通常类似:
https://api.example.com/v1
注意:
- 地址要使用服务商提供的 Base URL;
- 模型名称必须填写完整的模型 ID;
- API 密钥不要带多余空格;
- 不要把 ChatGPT 登录密码当作 API 密钥;
- 只有兼容 OpenAI API 的服务才能直接使用这种方式接入。
四、Windows 安装教程
1. 下载 Windows 版本
打开官方 Release 页面:
在 Assets 中选择 Windows 安装包。通常根据系统架构选择:
x64:大多数普通 Windows 电脑;arm64:Windows ARM 设备。
如果你的电脑是 Intel 或 AMD 处理器,通常选择 x64。
下载完成后,双击安装程序,根据向导完成安装。
2. 安装 Rust
Windows 推荐使用 Rust 官方安装器:
安装步骤:
- 下载并运行
rustup-init.exe; - 在安装界面输入
1,选择默认安装; - 等待安装完成;
- 关闭并重新打开 PowerShell;
- 检查 Rust 是否安装成功。
在 PowerShell 中执行:
cargo --version
rustc --version
如果能显示版本号,说明 Rust 已经安装成功。
3. 安装 Windows 编译工具
Windows 构建部分 Rust 项目时,还需要 C++ 编译工具。
推荐安装:
安装时勾选:
- 使用 C++ 的桌面开发;
- MSVC 编译工具;
- Windows 11 SDK 或 Windows 10 SDK;
- CMake 工具(如果项目需要)。
安装完成后重新启动 Craft Anything。
4. Windows 配置模型
启动 Craft Anything 后,在模型设置中选择「按地址添加 AI」。
填写方式与 macOS 相同:
名称:GPT
地址:https://api.example.com/v1
模型:你的模型 ID
API 密钥:你的 API 密钥
保存后,在项目页面底部的「构建助手」下拉菜单中选择刚刚添加的模型。
五、第一次启动怎么选择?
Craft Anything 首次启动会询问用途。
如果是自己的软件或已经获得授权的软件,可以选择:
这是我的,或我已获准查看
如果主要是学习软件原理,可以选择:
我在学习事物的工作原理
如果需要创建网站、应用或游戏,在项目页面选择对应类型:
- 「网站」:创建网页项目;
- 「应用」:创建桌面或移动应用;
- 「游戏」:创建游戏项目;
- 「不使用任何文件,从头开始」:从空项目开始。
项目保存位置建议使用单独文件夹,例如:
macOS:
/Users/你的用户名/Desktop/CraftProjects
Windows:
C:\Users\你的用户名\Desktop\CraftProjects
不要直接把多个项目混在同一个目录中。
六、如何测试模型是否接入成功?
建议先进行一个不会修改文件的测试。
新建项目时选择:
不使用任何文件,从头开始
在需求框中输入:
只测试模型连接。请仅回复“模型连接正常”,不要创建项目、不要写入文件、不要运行任何命令、不要执行构建。
然后点击「开始」。
测试成功的表现
如果模型接入正常,通常会出现:
- AI 能正常回复;
- 能看到模型生成的文字;
- 右侧显示任务进度;
- 能显示 Token 或费用信息;
- 不会出现 API 连接错误。
常见错误
1. 无法连接服务器
可能原因:
- API 地址写错;
- 地址缺少
/v1; - 网络连接失败;
- 服务商暂时不可用。
2. 认证失败
可能原因:
- API 密钥错误;
- 密钥已经过期;
- 密钥前后存在空格;
- 使用了不支持该模型的密钥。
3. 模型不存在
可能原因:
- 模型 ID 写错;
- 模型名称不是服务商实际返回的名称;
- 当前账号没有该模型的访问权限。
七、为什么测试模型时会出现构建失败?
如果你输入的提示词不够严格,Craft Anything 可能会把测试内容当作一个真实项目来处理。
例如它可能自动:
- 创建 Rust 项目;
- 生成源代码;
- 执行
cargo build; - 检查构建结果。
如果出现:
cargo: command not found
说明模型已经收到请求,但本机没有安装 Rust,或者 Craft Anything 没有读取到 Rust 的 PATH。
这属于本地构建环境问题,不代表模型接入失败。
八、如何创建第一个项目?
确认模型连接正常后,可以创建一个简单项目进行测试。
例如输入:
请创建一个简单的待办事项网站,要求包含:
1. 添加待办事项;
2. 删除待办事项;
3. 标记完成;
4. 使用简洁的深色界面;
5. 先分析项目结构,再开始创建文件;
6. 创建完成后运行检查并报告结果。
如果是 Rust 桌面应用,可以输入:
请创建一个简单的 Rust 桌面待办事项应用。
先检查当前环境是否安装 cargo。
如果环境满足要求,再创建项目并运行 cargo build。
如果构建失败,请说明具体原因,不要伪造成功结果。
这样可以同时测试:
- 模型连接;
- 文件创建;
- 本地工具调用;
- 项目构建;
- 错误报告。
九、推荐的使用流程
建议按照以下顺序使用:
安装 Craft Anything
↓
安装 Rust、Node.js 或其他项目依赖
↓
配置 AI API 地址、模型和密钥
↓
使用纯文本测试模型连接
↓
创建一个简单示例项目
↓
运行构建和检查
↓
再开始正式项目
每个项目都建议单独保存,方便回滚和管理。
十、常见问题
1. Craft Anything 能不能直接恢复完整源码?
它可以帮助分析项目、整理资源、生成代码和重建功能,但无法保证把编译后的程序完全恢复成原始源码。
编译后的程序通常会丢失:
- 原始变量名;
- 注释;
- 项目目录结构;
- 构建脚本;
- 部分资源映射;
- 未打包的开发文件。
因此,逆向分析结果通常需要人工整理和修复,不能保证直接重新编译。
2. macOS 和 Windows 的配置是否一样?
基本流程相同:
- 下载对应系统版本;
- 安装 Rust 或其他构建工具;
- 配置模型服务;
- 创建项目;
- 运行测试。
区别主要在于:
- macOS 使用
.dmg; - Windows 使用
.exe或安装包; - Windows 通常需要额外安装 Visual Studio C++ Build Tools;
- 文件路径格式不同。
3. 是否必须使用 GPT?
不一定。只要服务提供商兼容 OpenAI API,就可以尝试接入其他模型。
关键是确认:
- API Base URL;
- 模型 ID;
- API 密钥;
- 接口是否支持 Craft Anything 需要的对话格式。
结语
Craft Anything 适合用自然语言配合 AI 创建和维护项目。安装应用只是第一步,真正影响构建成功率的是本机开发环境是否完整。
macOS 用户至少应准备:
Craft Anything
Rust
cargo
Windows 用户建议准备:
Craft Anything
Rust
cargo
Visual Studio Build Tools
Windows SDK
完成模型接入后,建议先用“只回复模型连接正常”的方式测试,再创建简单项目,最后进行正式开发。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!

















暂无评论内容