Craft Anything 双系统安装与模型接入教程:macOS 和 Windows 完整指南

图片[1]-Craft Anything 双系统安装与模型接入教程:macOS 和 Windows 完整指南-雾祈心语

一、Craft Anything 是什么?

Craft Anything 是一个 AI 辅助开发工具。它可以根据自然语言需求,帮助用户创建网站、应用和游戏,也可以读取已有项目并协助修改。

它的基本工作方式是:

  1. 用户描述需求;
  2. AI 分析需求并制定计划;
  3. AI 在本地项目目录中创建或修改文件;
  4. 调用本地开发工具进行构建和检查;
  5. 根据构建结果继续修复问题。

Craft Anything 本身主要负责项目管理和 AI 协作,实际构建仍然依赖本机的开发环境,例如 Rust、Node.js、Python 或其他编译工具。

项目地址:

https://github.com/storytold/craft-anything

官方最新版 Release:

Craft Anything v0.6.1


二、准备工作

安装前建议准备:

  • macOS 或 Windows 电脑;
  • 稳定的网络环境;
  • 一个兼容 OpenAI API 的模型服务;
  • API 地址;
  • 模型 ID;
  • API 密钥;
  • 足够的磁盘空间;
  • 项目文件夹的读写权限。

API 密钥属于敏感信息,不要发布到博客、截图或 GitHub 仓库中。


三、macOS 安装教程

1. 下载 Craft Anything

打开官方 Release 页面:

下载 Craft Anything v0.6.1

根据 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. 安装应用

  1. 双击下载的 .dmg 文件;
  2. 将 Craft Anything 拖入 Applications;
  3. 打开「应用程序」;
  4. 双击启动 Craft Anything;
  5. 如果 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 页面:

下载 Craft Anything v0.6.1

在 Assets 中选择 Windows 安装包。通常根据系统架构选择:

  • x64:大多数普通 Windows 电脑;
  • arm64:Windows ARM 设备。

如果你的电脑是 Intel 或 AMD 处理器,通常选择 x64。

下载完成后,双击安装程序,根据向导完成安装。


2. 安装 Rust

Windows 推荐使用 Rust 官方安装器:

下载 rustup-init.exe

安装步骤:

  1. 下载并运行 rustup-init.exe;
  2. 在安装界面输入 1,选择默认安装;
  3. 等待安装完成;
  4. 关闭并重新打开 PowerShell;
  5. 检查 Rust 是否安装成功。

在 PowerShell 中执行:

cargo --version
rustc --version

如果能显示版本号,说明 Rust 已经安装成功。


3. 安装 Windows 编译工具

Windows 构建部分 Rust 项目时,还需要 C++ 编译工具。

推荐安装:

Visual Studio Build Tools

安装时勾选:

  • 使用 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 可能会把测试内容当作一个真实项目来处理。

例如它可能自动:

  1. 创建 Rust 项目;
  2. 生成源代码;
  3. 执行 cargo build;
  4. 检查构建结果。

如果出现:

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

完成模型接入后,建议先用“只回复模型连接正常”的方式测试,再创建简单项目,最后进行正式开发。

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容