convez.ai
MCP ServerAutomaçãoIntermediário
mikaku9944

DayRecord - Memória de Trabalho para Agents IA

mikaku9944/dayrecord

Contexto de trabalho para IA agents sem captura de tela

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server em Rust que captura contexto de trabalho sem screenshots, via leitura de UI (Windows UIA/macOS AX/Linux AT-SPI) e timeline de janelas. Fornece resumos de atividades e exporta dados para agentes como Claude, Cursor e nanobots via CLI, MCP ou arquivo.

Instalação

$npx convez-ai mikaku9944/dayrecord

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 4 meses
Versão
v0.1.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Fornecer histórico de atividades a agents do Claude Desktop ou Cursor
  • Gerar resumos diários de trabalho por demanda com DeepSeek
  • Integrar contexto do usuário em fluxos de automação de agents

Veredito

Ferramenta sólida e bem-arquitetada para conectar atividades locais do usuário a agents IA. Abordagem sem screenshots é prática, mas o setup inicial é moderadamente técnico; principal força está na integração MCP nativa e suporte multiplataforma.

README

A tradução para o português deste README ainda está na fila.

DayRecord

CI Release npm @dayrecord/mcp License: MIT

看得懂你在干什么,却从不截一张图。

非技术用户:把本仓库网址发给 Codex / Claude Code / Cursor,让 AI 执行 AGENTS.md 里的一键安装命令即可(Windows 会装 CLI + GUI + MCP 配置 + 开机自启)。

跨平台个人工作记忆助手:读取界面可见文本(无截图)、键盘输入与窗口时间轴,生成工作复盘,并通过 CLI / MCP / 文件导出 为 Hermes、nanobot、OpenClaw(小龙虾)等 Agent 提供用户上下文。

主打能力

能力说明
无截图读上下文Windows UIA / macOS AX / Linux AT-SPI(可选)
按需 AI仅生成复盘或抽取事实时调用 DeepSeek
Agent 接入dayrecord context · dayrecord mcp · dayrecord export
六边形架构core / adapters / runtime / cli / app

架构

Crate职责
dayrecord-core领域逻辑、ContextBundle、connect 导出、paths
dayrecord-adaptersSQLite、DeepSeek、平台采集、keyring
dayrecord-runtimeOrchestrator 编排
dayrecord-cliCLI + MCP server(单二进制)
dayrecord-appTauri 2 GUI + 托盘
frontend/TypeScript UI

安装

预编译(开箱即用,推荐)

从 GitHub Releases 下载:

平台产物
Windowsdayrecord-*.zip(CLI)+ .msi(GUI)
macOS (ARM)dayrecord-*-aarch64-apple-darwin.tar.gz
Linux x64dayrecord-*-x86_64-unknown-linux-gnu.tar.gz

详细步骤见 预编译安装说明。

从源码构建

CLI:

git clone https://github.com/mikaku9944/dayrecord.git
cd dayrecord
cargo install --path crates/dayrecord-cli

桌面 GUI(Windows 优先):

git clone https://github.com/mikaku9944/dayrecord.git
cd dayrecord
cd frontend && npm install && cd ..
scripts\run.cmd

热更新开发:scripts\dev.cmd

快速使用(Agent)

# JSON 用户画像 + 事实
dayrecord context --scope user --format json

# 近 7 日复盘
dayrecord context --scope recent:7 --format md

# MCP(给 nanobot 等;需先启动 GUI 或 dayrecord daemon 才能触发 AI/控制录制)
dayrecord mcp

# 文件导出
dayrecord export --target hermes
dayrecord export --target openclaw
dayrecord export --target nanobot

数据目录:dayrecord data-dir

MCP 快速接入

适用于 Cursor、Claude Desktop、Codex、nanobot 等。配置好后重载 MCP 即可使用;只读工具直接读本地 dayrecord.db;控制类工具在已同意采集(consent=true)时会按需自动拉起后台 dayrecord daemon(可用设置 mcp_autostart_daemon=false 关闭)。

1. Cursor 一键(推荐,已发布 npm)

只需 Node.js 18+,无需 clone 仓库或先跑安装脚本。npx 会拉取 @dayrecord/mcp,首次运行自动下载 GitHub Release 原生 CLI。

Windows:

{
  "mcpServers": {
    "dayrecord": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@dayrecord/mcp"]
    }
  }
}

macOS / Linux: "command": "npx", "args": ["-y", "@dayrecord/mcp"]

详见 packages/mcp/README.md。

2. 原生二进制安装(可选)

Windows(install.ps1 → %LOCALAPPDATA%\Programs\dayrecord\dayrecord.exe):

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install.ps1 -WriteConfig

macOS / Linux(~/.local/bin/dayrecord):

chmod +x scripts/install.sh
./scripts/install.sh --write-config

从源码构建到稳定路径(开发者,cargo install → ...\dayrecord\bin\):

powershell -File scripts\install-local.ps1 -WriteConfig

scripts\run.cmd 只启动 GUI(dayrecord-app),不会更新 CLI/MCP 二进制。MCP 由 IDE 按 mcp.json 独立拉起。

mcp.json 示例(原生路径,无 npm):

{
  "mcpServers": {
    "dayrecord": {
      "command": "C:\\Users\\YOU\\AppData\\Local\\Programs\\dayrecord\\bin\\dayrecord.exe",
      "args": ["mcp"]
    }
  }
}

(install.ps1 装到上级目录时把路径中的 bin\\ 去掉即可。)或使用 MCP 专用入口:

{
  "mcpServers": {
    "dayrecord": {
      "command": "C:\\Users\\YOU\\AppData\\Local\\Programs\\dayrecord\\bin\\dayrecord-mcp.exe",
      "args": []
    }
  }
}

3. 启用并验证

  1. 在 MCP 设置中开启 dayrecord(改配置后建议关 → 开)。
  2. 首次使用控制类工具前:dayrecord consent --accept true(或在 GUI 中同意采集)。
  3. 正常应看到 10 个 tools 与 3 个 resources。
  4. 验证:
dayrecord --version
dayrecord mcp --version
dayrecord doctor mcp

doctor mcp 检查二进制漂移、tools/list、控制类 isError、以及 daemon 自启 + IPC(在 consent 允许时)。

Codex(~/.codex/config.toml)

[mcp_servers.dayrecord]
command = 'C:\\Users\\YOU\\AppData\\Local\\Programs\\dayrecord\\bin\\dayrecord.exe'
args = ["mcp"]

或使用 npx:command = "npx", args = ["-y", "@dayrecord/mcp"]

4. 工具一览

类型工具需要采集服务?
只读get_user_profile · query_user_facts · get_recent_summary · get_today_context · what_working_on_now · get_recording_status否(读 DB;状态查询不触发自启)
触发 / 控制generate_today_summary · consolidate_memory · pause_recording · resume_recording是(MCP 可自动拉起 daemon,需 consent=true)

触发类在 consent 未同意或 mcp_autostart_daemon=false 时返回 isError: true 及结构化 hint。

Resources: dayrecord://user/profile · dayrecord://facts/active · dayrecord://context/today · dayrecord://memory/{YYYY-MM-DD}

API Key 在 GUI 设置中配置(keyring);未配置时触发类走 Mock LLM(仅适合开发)。

更多细节:nanobot 接入 · Agent 上下文说明 · 预编译安装 · Scoop/winget 清单

平台支持

平台窗口可见文本键盘密钥
Windows完整UIAWH_KEYBOARD_LLkeyring
macOS完整AX(feature)CGEventTap(feature)keyring
Linux完整AT-SPI(feature)仅 X11(feature);Wayland 不支持keyring

Agent 接入文档

开发

cargo test -p dayrecord-core -p dayrecord-adapters -p dayrecord-runtime -p dayrecord-cli --lib
cd frontend && npm test

文档

许可证

MIT — 见 LICENSE

Ver o original no GitHub

Bom para

Relacionados