Perofamily Wiki

控制面板 (Dashboard) ​

控制面板提供了一个可视化的界面来监控系统的运行状态，允许用户深入查看后台信息，以及进行各项配置。

核心功能详解 ​

1. 总览 (Overview) ​

这是进入 Dashboard 后的默认页面，作为系统的“仪表盘”，它聚合了最关键的信息：

  • 核心数据统计：直观展示当前的 核心记忆 (Memories)、近期对话 (Logs) 以及 待办任务 (Tasks) 数量。点击卡片可直接跳转至对应页面。
  • 状态监控 (Status Monitor)：
    • Active AI：显示当前活跃的人格（AI），支持点击切换不同人格。切换后，Dashboard 的所有数据将自动过滤为该 AI 的视图。
    • Pet State：实时可视化的展示 AI 的心理状态，包括 心情 (Mood)、氛围 (Vibe) 和 想法 (Mind)。
    • NIT 协议状态：显示 Next-gen Interaction Tools (NIT) 的激活状态，包括已加载的插件数量和已连接的 MCP 服务器数量。
  • 快捷功能开关：
    • 轻量聊天模式 (Lightweight Mode)：禁用复杂工具，仅保留基础对话 and 记忆功能。
    • 主动视觉感应 (AuraVision)：开启后，AI 将主动感知屏幕内容，预激活记忆（测试功能）。
    • 智能陪伴模式 (Companion Mode)：允许 AI 实时分析屏幕内容，并在合适的时机主动发起互动（需先开启轻量模式）。

2. 对话日志 (Logs) ​

这是一个强大的调试与回溯工具，不仅仅是简单的聊天记录：

  • 多维度筛选：支持按 角色 (AI)、来源 (Desktop/Mobile)、会话类型 (Text/Voice)、日期 以及 排序方式 进行精确查找。
  • 智能元数据标注：
    • 🎭 情感 (Sentiment)：自动标注每条消息的情感倾向（如 😊 开心、😠 生气、🤔 思考）。
    • ⭐ 重要度 (Importance)：对于高价值的对话，会自动标记星号。
    • 🧠 记忆提取 (Memory)：如果某条对话触发了记忆生成，会显示大脑图标。
    • ⚠️ 状态指示：显示后台 Scorer（评分员）的分析状态，如正在分析、分析失败等。
  • 深度调试 (Debug View)：点击单条日志的 调试 按钮可进入开发者模式，查看 AI 的思维过程：
    • 🟢 Thinking Chain：思维链，展示 AI 的逻辑推理过程。
    • 🟠 Inner Monologue：内心独白，展示 AI 的潜在意图和自我对话。
    • 💻 NIT Calls：工具调用，查看 AI 实际调用的函数代码。
  • 高级操作：
    • 编辑 (Edit)：你可以手动修改某条日志的内容，用于修正 AI 的错误记忆。
    • 重试 (Retry)：如果后台分析失败，可以手动触发重试。

3. 核心记忆 (Memories) ​

记忆是 AI 个性化的基石。在此页面，你可以像管理文件一样管理 AI 的大脑：

  • 双视图模式：
    • 列表视图：瀑布流式展示，清晰呈现每一条记忆的内容、类型和标签。
    • 图谱视图 (Graph)：ECharts 绘制的知识图谱，可视化记忆节点之间的关联。节点颜色代表情感，大小代表重要度。
  • 记忆类型分类：
    • 🧩 事件 (Event)：发生的具体事情。
    • 🧠 事实 (Fact)：关于世界或用户的客观事实。
    • 🤝 誓言 (Promise)：AI 对用户的承诺。
    • 💖 偏好 (Preference)：用户的喜好记录。
    • 📝 工作日志 (Work Log)：AI 的自我反思或工作记录。
  • 维护工具箱：
    • 清理孤立连线：修复图谱中的无效连接。
    • 孤立扫描：发现并处理没有任何关联的“孤岛记忆”。
    • 梦境联想 (Dream)：手动触发 AI 的整理机制，让它在后台“做梦”以强化记忆关联。

4. 待办任务 (Tasks) ​

展示 AI 自动生成的任务列表，帮助 AI 维持长期目标：

  • 任务状态：分为 Pending (待处理), In Progress (进行中), Completed (已完成)。
  • 优先级：High/Medium/Low，决定 AI 处理任务的顺序。

5. 用户设定 (User Settings) ​

定义 AI 眼中的“你”，这对 AI 的共情能力至关重要：

  • 主人的名字 (Owner Name)：AI 对你的称呼。
  • 主人的 QQ 号 (Owner QQ)：用于 NapCat 插件，使 AI 能通过 QQ 主动联系你。
  • 主人的人设 (Owner Persona)：详细描述你的性格、职业、喜好。例如：“我是一名计算机系学生，喜欢熬夜写代码，性格比较内向。” AI 会根据这个人设调整沟通策略。

6. 模型配置 (Model Config) ​

系统的核心大脑配置，支持高度自定义的多模型协作：

  • 角色分工：
    • 主模型 (Main)：负责日常对话 and 主要交互。
    • 秘书模型 (Secretary/Scorer)：在后台负责分析对话情感、提取记忆。建议使用更廉价但逻辑性强的模型。
    • 反思模型 (Reflection)：用于定期自我反思和总结。
  • 多服务商支持：内置支持 OpenAI, Gemini, Claude, DeepSeek, SiliconFlow, Moonshot 等主流服务商。
  • 详细参数：
    • Temperature：控制回复的随机性（0-2）。
    • Max Tokens：控制回复的最大长度。
    • 模态开关：单独配置模型是否启用 视觉 (Vision)、语音 (Voice) 或 视频 (Video) 能力。
  • 配置继承：可选择“全局继承”使用统一的 API Key，或“独立配置”为特定模型指定单独的 Key 和 Base URL。

7. MCP 配置 (MCP Config) ​

管理 Model Context Protocol (MCP) 服务器，无限扩展 AI 的能力：

  • Stdio 类型：运行本地命令行工具（如 Python 脚本、Node.js 服务）。支持配置环境变量 (Env) 和启动参数 (Args)。
  • SSE 类型：连接远程的 MCP 服务器 URL。
  • 一键启停：可以随时启用或禁用某个 MCP 服务，无需重启系统。

8. 系统工具 (System Tools) ​

  • NapCat 终端：专门用于管理 NapCat (QQ 机器人框架) 的连接与调试，查看 QQ 消息收发日志。
  • 系统终端：内置的命令行工具，允许直接查看 AI 后端的运行日志 (stdout)，适合开发者进行深层 Debug。
  • 危险区域 (Danger Zone)：
    • 系统重置：清除所有 记忆、日志、状态 和 用户设定，将 AI 恢复到“失忆”的出厂状态。但会保留 API Key 等基础配置。
    • 数据导出：将核心记忆和日志导出为 JSON 文件备份。

使用教程 ​

场景一：初次使用 ​

  1. 进入 用户设定 (User Settings) 页面。
  2. 填写你的名字 and QQ 号。
  3. 在 Owner Persona 中详细写下你的设定。比如：“我是一个喜欢二次元的程序员，最近工作压力很大，希望你能多鼓励我。”

场景二：配置LLM模型 ​

  1. 进入 模型配置 (Model Config) 页面。
  2. 点击右上角“添加模型”。
  3. 选择服务商（例如 DeepSeek），输入 API Key。
  4. 勾选 流式传输 (Stream) 以获得更快的响应速度。
  5. 保存后，在卡片上点击 主模型 按钮，将其设为当前的主力对话模型。

场景三：查看 AI 在想什么 ​

  1. 当你觉得 AI 的某句回复很奇怪。
  2. 进入 对话日志 (Logs) 页面。
  3. 找到那条回复，点击 调试 (Debug) 图标。
  4. 查看 Inner Monologue。你可能会看到它想：“主人今天似乎心情不好，我应该多和他互动一下。” —— 这样你就知道它为什么这么回复了。

场景四：整理记忆 ​

  1. 进入 核心记忆 (Memories) 页面。
  2. 切换到 图谱视图 (Graph)。
  3. 点击 梦境联想 (Dream) 按钮。
  4. 观察图谱的变化，AI 会自动建立新的连线，将孤立的记忆点连接起来，形成更完善的知识网络。