Wandesk

一个壳,一个知道一切的 AI 内核,一个 workerd。剩下的全是应用。

一个开源的 AI 桌面。说一句话,内置 agent 把应用写进你的工作区,桌面当场长出图标。每个应用都是标准的 Cloudflare Worker 网站,有自己的 origin 和自己的 SQLite。自带模型,全部本地,无需注册。

官网 · English · 应用契约 · Discord

---

跑起来

需要 Node.js 22+。用 Chrome 或桌面壳 —— Safari 不解析 *.localhost。

git clone https://github.com/Sider-ai/wandesk.git
cd wandesk
npm install
npm run build:overseer   # 编 overseer(workerd 里的那层监理)
npm run dev              # 内核 9600 + 壳 5180

打开 http://localhost:5180,右键桌面 →「个性化」旁边的「设置」填模型(任何 Responses 或 Chat Completions 兼容接口),然后打开助理,说一句话让它造个应用。

生产态单端口:

npm run build && npm start   # http://localhost:9600

桌面应用(Electron):

npm run app                  # 构建并打开桌面壳
npm run dist:mac             # macOS .app(钥匙串里有 Developer ID 就顺手签)
npm run dist:mac:release     # 签名 + 公证的 .dmg,见 build/README.md
npm run dist:win             # Windows 安装包,要在 Windows 上跑

只想用?到 wandesk.cn 下载打包好的 macOS / Windows 版本。

它是怎么搭的

shell/          🖥 壳:只管画
  ui/           React —— 桌面、窗口、任务栏、AppFrame(应用的 iframe 宿主)
  desktop/      Electron:拉起内核,窗口指向它
kernel/         🧠 内核:知道一切
  ai/ agent/    AI 内核(与 AGENT 仓库双向同步,纯 JS 零依赖)
  syscall/      一个文件一个 binding:ai / db / assets / proc / fs / ui
  apps/         应用生命周期:扫描 / token / 预装落地 / 目录监听
  memory/       长期记忆 —— 只经 env.AI 注入,应用读不到原文
  data/         内核自己的 SQLite(会话 / 记忆 / 设置 / 活动流水)
runtime/        ⚙️ workerd:应用的用户态
  overseer.js   路由 <token>.localhost + 注入 binding 垫片 + AppStore(env.DB 的 SQLite 就在这)
  supervisor.ts 起停 workerd
apps/           📦 预装应用 —— 每个都是完整的 Worker 网站

一个应用长什么样

apps/notes/
├── app.json     { id, name, icon, mounts }   ← 四个字段,没了
├── server.js    export default { async fetch(req, env) {…} }
└── public/      index.html + style.css

「安装」= 目录存在,「移除」= 删目录。 AI 用 write 造应用,宿主零改动、不重启 —— 新目录一落地,桌面立刻长出图标。

完整契约见 CONTRACT.md。

每个应用一个 origin

应用挂在 http://<token>.localhost:<port>/ —— 站在自己网站的根上, 所以 /style.css、fetch("/api/…") 这些绝对路径都成立,localStorage 也彼此隔开。 token 由装机密钥推导、跨重启稳定。

没有原生应用

活动栏和桌面上的一切都是应用,包括助理和文件。它们和你自己造的应用拿一样的 binding、跑在同一个 workerd 里、数据落在自己的库里(apps/<id>/data.db 能直接撬)。

壳里唯一不是应用的是「设置」和「个性化」—— 它们配置的是框架本身。 凡是「配置框架」的属于壳,凡是「做事」的一律是应用。

env.AI:唯一的智能面

应用之间不共享数据,应用共享的是同一个知道一切的 agent。

应用不需要知道系统里有什么,它只说一句话:

return env.AI.stream({ summary: "助理:回答用户", prompt: text });

记忆、上下文、工具的汇聚发生在内核。内核因此不必长出任何领域概念 —— 它永远不知道「笔记」是什么,这是 AI 能无限造应用的前提。

预装应用

💬 Assistant	🗂 Files	📔 Notebook
👛 Ledger	📖 Reader	⛅ Weather
🗞️ Hacker News	💭 Imagine	🔮 I Ching
💕 Love House	📱 Phone	🃏 Three-Card Poker
🎱 Pool	🏎️ Dusk Racer	🚀 Aircraft

随包发,首次启动落地到工作区;之后与你自己造的应用再无区别,可改可删。每个应用的源码都在 apps/<id>/src 里,改完在应用目录里 npm install && npm run build 即可重新构建。

数据在哪

	位置
工作区	~/wandesk(WANDESK_WORKSPACE 可改)
内核库	<workspace>/.wandesk/kernel.db
应用库	<workspace>/.wandesk/store/…/*.sqlite(apps/<id>/data.db 是指向它的链接)
你的文件	<workspace>/

几句实话

• env.AI.run 背后的 agent 手里有无沙箱 bash,能力也是全开的 —— 只在你信任的机器上用。
• 代码库现在是纯英文的:提示词与注释均为英文。
• workerd 单平台约 150MB,发行包要带。

社区

• 官网:https://wandesk.cn · 国际站:https://wandesk.ai
• Discord:https://discord.gg/VUfTzCvz
• Issues:https://github.com/Sider-ai/wandesk/issues

欢迎 PR、bug 报告和应用点子。比小修复大的改动,先开 issue 聊一下。

找上一代(Tauri 壳、每应用一个 React 模块)?保留在 v1 分支。

协议

ISC