一个本地优先的个人 AI 助手,代码用 Python 编写,包含可读的 agent 循环、基于 SQLite 的记忆和内置评测。
ntygod/ZhiWei
本地优先的自托管个人 AI Agent,提供分层记忆、工具授权、工作流和多渠道接入。
- Star
- 137
- Fork
- 5
- 未关闭 Issue
- 1
- 最近提交
- 2个月前
这是什么?
ZhiWei(知微)是一个用 Java 和 Spring Boot 构建的自托管 AI Agent 系统,前端为 Vue 3 单页应用。所有数据以 SQLite 形式保存在本地 ~/.zhiwei/ 目录下,向量检索使用 sqlite-vec 扩展,无需依赖外部数据库服务。
记忆分为四层:当前会话的工作上下文、完整的对话记录、知识实体与关系网络,以及技能模板和用户偏好规则。Agent 采用 ReAct 循环(思考、调用工具、观察、回答),并能在等待用户确认、定时唤醒或外部数据就绪时挂起、恢复。内置 33 个技能,涵盖定时任务、浏览器自动化、代码沙箱执行和知识检索。
模型调用按生成、向量、精排和多模态四路独立路由,并带有熔断与故障转移。工具调用按会话、工作区、任务和长期四个范围授权。用户可通过 Web 界面、Tauri 桌面客户端,或飞书、钉钉、企微、QQ 机器人使用,部署方式包括 Windows 安装包、Docker Compose 和源码构建。
核心功能
- 01四层记忆分别管理工作上下文、对话历史、知识关系网络和可复用的技能模板。
- 02类 ReAct 的 Agent 循环,可在等待确认、定时或外部事件时挂起并恢复。
- 03生成、向量、精排、多模态四路独立模型路由,并支持故障转移。
- 04工具授权分会话、工作区、任务、长期四个范围,高风险操作需确认。
- 05支持 PDF、Word、Markdown 知识库导入,提供混合检索和可选的精排。
- 06工作流以 YAML 声明,支持 cron、事件和手动触发,并支持 MCP 协议。
适用场景
- 在自己的机器上运行私人助手,让对话和笔记不经过第三方云服务。
- 基于检索,通过对话查询自己的 PDF、Word 或 Markdown 文档。
- 用定时任务、工作流和浏览器自动化处理重复性工作。
- 通过飞书、钉钉、企微或 QQ 机器人收发消息并自动回复。
标签
常见问题
- ZhiWei 是什么?
- 本地优先的自托管个人 AI Agent,提供分层记忆、工具授权、工作流和多渠道接入。 ZhiWei(知微)是一个用 Java 和 Spring Boot 构建的自托管 AI Agent 系统,前端为 Vue 3 单页应用。所有数据以 SQLite 形式保存在本地 ~/.zhiwei/ 目录下,向量检索使用 sqlite-vec 扩展,无需依赖外部数据库服务。
- ZhiWei 可以免费使用吗?用的什么许可证?
- ZhiWei 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- ZhiWei 还在维护吗?
- 半年内有更新。ZhiWei 最近一次提交是在 2026年8月11日。
- ZhiWei 适合用来做什么?
- 在自己的机器上运行私人助手,让对话和笔记不经过第三方云服务。 基于检索,通过对话查询自己的 PDF、Word 或 Markdown 文档。 用定时任务、工作流和浏览器自动化处理重复性工作。 通过飞书、钉钉、企微或 QQ 机器人收发消息并自动回复。
- 在哪里获取 ZhiWei?
- 源代码和安装说明在 GitHub 上:https://github.com/ntygod/ZhiWei
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
开源个人 AI 助理与 Agent Harness,可规划任务、调用工具与技能,并支持记忆与多渠道接入。
轻量级自托管个人智能体应用,提供 TUI 与 GUI 两种界面,支持本地工作区操作、人工审批、会话持久化与扩展。
开源 AI 私人助理,用于日程规划、写作和个人知识管理,可在 Mac 或自托管环境中运行。
一款运行在 Android 手机上的本地优先个人 AI 代理,支持持久记忆、定时自主任务和自动生成的迷你应用。
可自托管、本地优先的 AI 伙伴运行时,默认越南语角色,支持本地记忆、Telegram/Zalo 渠道与权限控制的工具调用。