悟空（Wukong）— 跑在本机的个人智能体

Wukong 是我为自己构建的本机个人智能体服务。它不是一个面向公众的多租户 SaaS，也不只是聊天机器人，而是一个能够在手机上随时接收任务、在本机调用受控工具，并持续积累上下文的个人 Agent。

为什么做

我需要的不是另一个必须坐在电脑前打开的 AI 对话框，而是一个可以 7×24 小时触达的个人服务：临时想到一件事时，直接从 Telegram 发出指令；需要检查状态、管理配置时，再回到本机 Dashboard。

与此同时，我不希望长期记忆、本地文件和运行凭据离开自己的机器。更重要的是，Agent 不能只“看起来完成了”，它需要知道一个任务执行到哪一步、工具是否重复调用、最终结果是否已经送达。

关键产品决策

• Telegram + Dashboard 双入口 — Telegram 负责低摩擦对话和移动访问，Dashboard 负责本机管理，两者服务不同场景
• 本地优先，而不是云端托管 — MongoDB、向量记忆、日志和备份都留在本机，核心数据边界清晰可控
• 把可靠性设计成运行时能力 — Run、Step、Attempt、Event 持久化记录执行过程，Tool 幂等和验证恢复避免重复副作用，Outbox 保证最终消息去重投递
• 限制工具权限 — 本地文件工具只开放查看、新增和编辑等受控操作；Git 工具只读检查状态、历史和 diff，不提供通用 Shell
• 学习不等于自动改写能力 — 任务结果可以沉淀为 Episode 和 Reasoning Entry，但不会自动生成或晋升 Skill；Skill 保持人工维护和明确审核

核心能力

Wukong 把长期记忆、Agent-Reach 网络搜索与网页读取、本地文件操作、只读 Git 检查、子代理资产和定时任务放进同一个运行环境。备份、恢复、健康检查和 macOS launchd 配置则让它不只是一段能跑的代码，而是一个可以持续维护的本机服务。

技术上使用 Python、FastAPI、Telegram Bot、MongoDB、Chroma 和 fastembed。对我来说，这些选型的意义不是堆叠技术栈，而是分别支撑快速交互、本地数据管理、语义检索和可观察的可靠执行。

项目价值

这个项目让我不断验证一个判断：个人 Agent 的价值不取决于功能数量，而取决于它能否长期存在于真实工作流中。入口要足够自然，记忆要能够追溯，工具权限要受到约束，失败也必须留下可以恢复的状态。

当前状态

Wukong 当前定位为个人本机服务，核心对话、记忆、工具、执行记录和运维能力都围绕这一边界持续迭代，不计划扩展为公网多租户平台。

查看 GitHub 仓库

← Vibe Coding