声明：本文为技术分享，介绍一个自研的开源桌面工具的设计与实现，非商业推广。工具本身免费，自带模型 Key（BYOK）。

一、为什么要做这个工具

网站除了设计框架和逻辑，还有配环境、装依赖、调样式、平时运营迭代。

• 想做一个待办清单，要先npm create vite、装 React、写样式、起服务、开浏览器……还没写业务代码，半小时就没了。
• 想部署上线，还要买服务器、装宝塔、传代码、配域名、申请 SSL——又是一个下午。
• 在线 AI 编程工具把代码传到云端，企业项目不敢用；绑死一家模型 API，切换成本又高。

于是我做了一个桌面工具sitely（一句话建站，一键部署上线）：用大白话描述想法，AI 在本机生成完整可运行的全栈代码，右侧实时预览，满意后一键部署到自己的服务器（宝塔 / Docker）。代码全程不出本机，模型随便换（自带 Key 即可）。

二、核心功能

1. 一句话生成全栈应用

输入「做一个带登录的任务管理系统，后端 SQLite」，内置的技能会把任务拆解成：数据模型 → 接口 → 页面骨架 → 交互 → 联调 → 自检，逐目录生成，依赖自动安装，构建报错自动定位根因重试。默认选型 Vite + React + TypeScript，后端 FastAPI + SQLite 或 Express + better-sqlite3，全部参数化查询。

2. 右侧实时预览

生成完点一下 ▶，工具自动检测项目类型（package.json / app.py），起本地 dev server，解析端口后在右侧窗格内嵌预览。端口被占用自动换端口；依赖缺失自动npm install自愈；退出时自动清理进程，不留孤儿。

3. 一键部署到你的服务器

内置部署技能 + MCP 部署服务器：

每次部署操作都有权限确认与二次确认，危险命令会被拦截。

4. 记忆与技能

• 记忆管理器：USER.md（用户画像）/ MEMORY.md（环境事实）双 Tab，可视化查看、编辑、删除；删除不影响功能，只是不再个性化。
• 技能系统：内置技能只读保护，用户可以自己加技能；GitHub 上 Hermes 生态的现成技能也能接入。

5. 隐私与安全设计

• 所有代码生成在本地完成，数据不出本机。
• API Key 用系统安全存储加密（safeStorage），明文不落盘、日志脱敏。
• 模型会话由应用统一管理：任务型消息自动切主模型，闲聊切轻量对话模型。

三、技术架构

┌──────────────────────────────────────────────┐ │ Electron 桌面应用 │ │ ┌─────────┐ ┌─────────┐ ┌───────────────┐ │ │ │ 项目树 │ │ Monaco │ │ 预览窗格 │ │ │ │ (IPC fs)│ │ 编辑器 │ │ (iframe+dev) │ │ │ └────┬────┘ └────┬────┘ └───────┬───────┘ │ │ │ │ │ │ │ ┌────▼────────────▼───────────────▼───────┐ │ │ │ main.js（ACP 客户端） │ │ │ │ 会话管理/权限桥接/模型路由/预览管理 │ │ │ └─────────────────┬────────────────────────┘ │ └────────────────────┼───────────────────────────┘ │ ACP（JSON-RPC over stdio） ▼ ┌──────────────────────────┐ │ Hermes Agent (MIT) │ │ agent loop / 记忆 / 技能 │ │ 4 大技能 + MCP 部署服务器 │ └────────────┬─────────────┘ │ ┌────────────┼────────────┐ ▼ ▼ ▼ 模型 API 宝塔 OpenAPI SSH / Docker (BYOK) (建站/SSL) (compose 部署)

关键设计决策：

1. 大脑用 Hermes Agent（Nous Research，MIT License）：agent loop、记忆、技能、MCP 全套现成，不用自己从零写。集成走官方 ACP 协议（hermes acpstdio JSON-RPC，VS Code / Zed 同款路径），代码约百行接完。
2. 模型调用全部收口到 Hermes：前端不直连任何模型 API，主模型 + 对话模型都是会话级路由，换模型只改配置。
3. 部署不依赖在线服务：MCP 部署服务器在本机跑，直连你自己的服务器，没有中间商。
4. 内置运行时：Node + Python + Hermes 打包在安装包里（压缩后 124MB），用户机器无需预装任何环境，干净 Windows 直接能用。

四、实测数据

• 10 场景验收评测（待办 / 博客 / 看板 / 登录+CRUD+SQLite / FastAPI 全栈 / 电商 / 后台 / 宝塔部署 / Docker 部署 / 多页应用）：简单场景一次生成通过，部署场景在真实服务器端到端成功。
• 真实部署验证：宝塔建站 + Let's Encrypt SSL + HTTP→HTTPS、Node 全栈 Docker 部署（compose 构建 + 数据卷挂载）均已跑通。
• 安装体验：安装包 200MB，安装约 2分钟，首次启动解压约 30 秒）。

五、适用人群

• 产品经理 / 创业者：一句话搭 MVP，验证想法，不用等开发排期。
• 企业 IT：快速搭建内部工具（待办、审批、数据看板），数据不出内网。
• 个人开发者：把重复的 CRUD 后台交给 AI，专注业务逻辑。
• 非技术岗：运营、行政、设计用对话搭小工具，把重复性工作自动化。

六、上手方式

Windows 10/11 64 位，无需预装 Node / Python：

使用前准备一个 OpenAI 兼容的 API Key（DeepSeek / 通义 / 智谱 / 自定义均可），在设置页填入即可。当前为试用版，欢迎使用和反馈。

提示：安装包暂未购买代码签名证书，Windows 可能提示「已保护你的电脑」，点「更多信息 → 仍要运行」即可；可用发布页的 SHA256 校验文件完整性。首次使用如遇问题，反馈邮箱见 README。

七、技术栈与开源

本产品为独立项目，与 Nous Research 无隶属关系；源码与第三方许可明细见仓库THIRD_PARTY.md。

欢迎技术交流与功能建议。本地优先 + 模型自由切换，是我做这个工具坚持的两个原则：数据是你的，模型也是你的。