Skip to content

Duskydream/Perelegans-Assistant

 
 

Repository files navigation

Perelegans Assistant

Perelegans Assistant 是一个面向 Windows 桌面的 AI 陪伴式效率助手。它不只是记录你用了哪些应用,而是把桌面状态、任务记忆、AI 编码客户端状态和每日复盘放在一起看,帮用户在真实工作流里少丢上下文、少被越堆越多的任务拖住,并且更自然地回到下一步。

亮点功能

桌宠陪伴与工作状态感知

  • 悬浮桌宠会根据当前工作状态切换姿态和气泡提示。
  • 支持普通陪伴、专注、恢复陪伴、AI 编码中、等待确认、编码完成验收等状态。
  • 气泡文案强调自然陪伴感,避免机械式打卡和命令口吻。

AI 编码完成验收卡

  • 监控 Codex、Claude Code / Claude Desktop、OpenCode 等 AI 编码客户端。
  • 只有在一轮生成真正结束、文件写入安静下来、没有新的权限确认或继续编码信号时,才弹出验收卡。
  • 验收卡会显示最近变更、风险提示、检查顺序和短暂的 diff / 文件预览。
  • 主窗口和桌宠入口都可以跳转回对应编码客户端,而不是跳回 Perelegans 自己的聊天框。

恢复胶囊

  • 当用户离开后返回,Perelegans 会把离开前的窗口、进程、相关计划、AI 编码状态和可继续做的事整理成一颗”恢复胶囊”。
  • 胶囊提供现场证据、继续步骤和恢复口令,帮助用户不用重新解释上下文就能接回任务。

任务记忆与任务预览

  • 从对话和使用现场中提取任务记忆,区分 open、done、abandoned 等状态。
  • 聊天框提示里提供“任务预览”入口,用户也可以直接问 AI“任务预览”。
  • 任务预览会结合本地记忆、最近应用使用记录和任务相似度,给出可勾选的任务总览与清理建议。
  • 建议不再统一套用“拆成一个小动作”,而是根据上下文判断是继续、验收、合并、搁置还是补材料。

每日总结与任务胶囊 Markdown

  • 每日总结会生成更像真人复盘的陪伴式总结,而不是冷冰冰的系统报告。
  • 可导出任务胶囊 Markdown,以当天要完成的任务为核心,保留:
    • 还开着的任务
    • 已经收好的任务
    • 可以先放过的任务
    • 今天留下的桌面现场感
    • 回来时先做什么
  • 任务胶囊会结合本地记忆权重、更新时间、标签和应用使用证据生成接续建议。

专注模式

  • 支持从主窗口和桌宠入口开启专注模式。
  • 如果没有明确的 open plan,会自动顺着最新生成的 active 任务记忆开始,而不是简单使用最前台窗口名。
  • 专注模式会跟踪当前窗口是否偏离任务,并在需要时给出温和提醒。

记忆星图、鱼骨归因与统计窗口

  • 记忆以星图和鱼骨结构组织,展示任务、标签、计划完成状态和上下文关系。
  • 统计窗口展示应用使用占比、时间线和行为洞察。
  • 深色主题下的 pie chart 调整了透明度、饱和度和边界表现,让统计视图更清透、更有科技感。

本地优先与可控 AI

  • 任务、记忆、统计和桌面上下文都优先保存在本地。
  • AI 生成内容用于辅助总结、提炼和建议,关键任务状态仍可由用户在界面中确认、完成或搁置。
  • 项目已经移除 AI 现场回放和记忆体检窗口,减少噪音,把重点放回任务连续性和陪伴体验。

典型使用场景

  1. 在 Codex / Claude Code / OpenCode 里让 AI 帮你改代码。
  2. Perelegans 桌宠显示 AI 正在编码或等待确认。
  3. 一轮生成真正完成后,桌宠气泡和主窗口出现编码完成验收卡。
  4. 你可以先看 diff / 文件预览,再跳回对应编码客户端验收。
  5. 中途离开回来时,恢复胶囊帮你回到刚才的窗口、计划和下一步。
  6. 到一天结束时,每日总结和任务胶囊 Markdown 帮你把任务线索收好,第二天不用重新找状态。

构建与运行

项目为 WPF 桌面应用,主项目位于 src/Perelegans/Perelegans.csproj

dotnet build src\Perelegans\Perelegans.csproj
dotnet run --project src\Perelegans\Perelegans.csproj

如果本机已经运行 Perelegans,建议使用独立输出目录做验证,避免输出文件被占用:

dotnet build src\Perelegans\Perelegans.csproj -p:UseAppHost=false -p:OutDir=.\.build-verify\out\

技术栈

  • .NET / WPF
  • CommunityToolkit.Mvvm
  • Entity Framework Core / SQLite
  • Windows 桌面前台窗口与进程监控
  • 本地任务记忆、应用使用统计与 AI 上下文生成

项目定位

Perelegans Assistant 不是一个普通番茄钟,也不是只会聊天的桌宠。它更像一个”在场”的桌面伙伴:知道你刚才在哪个任务里、AI 编码工具有没有真的写完、哪些任务正在越堆越多,以及你回来时应该从哪里继续。

核心目标是让 AI 从”回答问题”进一步变成”帮用户在工作里保持连贯”的操作系统级伙伴。

About

A local-based memory agent assistant

Resources

License

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • C# 94.9%
  • HTML 5.1%