SuperAPI AI 工具集

zhigui-second-brain-mcp-skill

智能体与模型

查看项目

更新于 10-16 07:27

技能介绍

知归(ZhiGui)是一套个人智能系统,将 JSON 文件驱动的知识图谱与 MCP(Model Context Protocol)工具结合,提供 40+ 个 MCP 工具,用于管理目标、日程、笔记、决策、杂事与提醒,并具备自动关系追踪、长期记忆和智能规划辅助。

主要能力:关系图谱,每个实体(目标、日程、笔记、决策)通过外键互相关联;分层索引,轻量启动先加载标题,按需加载完整内容;自动链接,AI 根据上下文建议相关笔记、目标与决策;长期记忆,用生命周期状态跟踪实体新鲜度(Active → Stale → Archive Candidate);晨间简报与晚间反思,AI 生成并冻结到具体日期的每日总结;引用完整性,删除前预览影响并清理失效引用。

安装前提:Node.js ≥ 17,以及支持 MCP 的 AI 工具(如 Claude Desktop、Cursor、Trae 等)。步骤:克隆仓库并进入目录,执行 cd skill && npm install;在 AI 工具的 MCP 配置中加入 zhigui 服务,command 为 node,args 指向 skill/engine/server.js 的绝对路径(Windows 也用正斜杠);随后对 AI 说“Show me today's schedule”,若调用 zhigui_get_assistant_bootstrap 并返回数据即配置成功。可选加载演示数据:node scripts/seed-demo-data-en.js 或 node scripts/seed-demo-data.js;可选启动桌面面板:在项目根目录执行 npm install 与 npm start,或使用 start.bat、./start.sh。

核心工具涵盖:启动与上下文加载(zhigui_get_assistant_bootstrap、zhigui_get_schedules_by_date、zhigui_get_goal_detail、zhigui_get_note_detail);创建实体(zhigui_create_schedule、zhigui_create_goal、zhigui_create_note、zhigui_create_decision);更新实体(zhigui_update_schedule、zhigui_update_goal、zhigui_update_note);删除实体(zhigui_delete_schedule、zhigui_delete_goal、zhigui_delete_note,需先预览影响再 confirmed:true);简报与反思(zhigui_generate_briefing、zhigui_generate_reflection);长期记忆与清理(zhigui_get_stale_entities、zhigui_archive_entity)。

数据默认存放于 skill/.zhigui/ 下的 goals.json、schedules.json、notes.json、decisions.json、topics.json、briefings.json、reflections.json 及 archive/ 目录。可通过编辑 skill/SKILL.md 定制助手人格、自动链接规则、反思提示、简报格式与优先级评分;也可用环境变量 ZHIGUI_DATA_DIR 覆盖数据目录、ZHIGUI_DASHBOARD_PORT 修改面板端口(默认 7788)。

适用场景包括每日规划流程、目标驱动的笔记创建、完成任务并生成后续任务、决策记录等。限制与注意事项:需 Node.js ≥ 17 与支持 MCP 的 AI 工具;MCP 配置路径必须为绝对路径;删除前须先预览影响;自动链接依赖相同 topicId 与标签重叠;简报与反思需先加载 bootstrap 并传入 completedScheduleIds 才能具体。更多细节见 GitHub 仓库与用户手册。