一个可在本地运行的工程设计产品原型。用户可以在画布中组合图元、填写设计需求，让模型分析结构并生成概念图，再选择产品图类型或继续完成工程目标。项目包含 React 前端与 Express API 服务。

• 可编辑画布、工程图元和手绘工具；设计保存在浏览器本地。
• AI 设计理解、建议与待确认项、概念图和多类型产品图展示。
• 面向工程软件的目标输入及教程、脚本等结果展示。
• 模型配置与连接诊断。模型生成需要自行配置相应服务的密钥和模型权限；未连接时部分界面可作为本地演示使用。

建议使用 Node.js 24.5 或更新版本，或 Node.js 22.21 及更新的 22.x 版本，并安装 pnpm。项目使用 pnpm-lock.yaml 固定依赖版本。

git clone https://github.com/enviousmigra/kaiwu-anAIdesigner.git
cd kaiwu-anAIdesigner
pnpm install --frozen-lockfile
Copy-Item .env.example .env
pnpm dev

打开 http://localhost:5173。开发命令同时启动 Vite 前端和 http://localhost:3001 的 API 服务。首次使用 AI 功能前，在本地 .env 中填写所用服务的密钥、模型标识及可选代理地址；不要提交 .env。.env.example 只包含空白示例值。

运行 pnpm build 可进行 TypeScript 检查并生成前端构建文件。生产前端构建位于 dist/；API 服务可用 pnpm start 单独启动。直接打开构建页面而不运行 API 服务，无法使用依赖后端的模型功能。

默认模型提供商为火山方舟，可通过 AI_PROVIDER、ARK_API_KEY、ARK_MODEL_ENDPOINT、ARK_IMAGE_MODEL 配置。工程代码模型可通过 ENGINEERING_CODE_PROVIDER 与 DEEPSEEK_API_KEY 等变量配置。更多网络与代理说明见 server/NETWORK.md。使用者应自行申请密钥并遵守模型服务条款；仓库不包含密钥。

原有预览说明保留在 README-预览.txt。

项目代码采用 MIT License。字体、图片和其他素材不随代码一并以 MIT 授权；使用或再发布这些素材时，应分别核对其权利和许可。工程图素材的来源见 SOURCE-AND-RIGHTS.txt 和同目录的 sources.json；思源黑体的许可证见 SourceHanSans-LICENSE.txt。