ToMemorie — Memory of Memorie 番茄钟

Hana Plugin ID: memory-of-memorie-pomodoro

Author: Halo & Hanako

Synchronize Memory of Memorie with your AI Agent's workflow. When the Agent starts working, the game's Pomodoro timer starts and the character plays the work animation. When the Agent finishes, the timer stops and the character rests.

Prerequisites

1. Memory of Memorie installed
2. Memory of Memorie Codex Bridge v0.3.0+ game plugin (BepInEx) installed
3. Game running with HTTP API active (default http://127.0.0.1:29461/)
4. Wallpaper.Enabled set to false in the game's config.json

Features

All platforms communicate through the same Codex Bridge HTTP API.

• Hana Agent: Install this plugin for EventBus auto-sync and Skill-based fallback. No manual interaction needed.
• Codex / Claude Code / OpenCode: Use Codex Bridge's built-in hooks to call the API directly.

Tool	Description
start-pomodoro	Start the Pomodoro timer. Optional minutes parameter.
stop-pomodoro	Stop the Pomodoro timer.
pomodoro-status	Read the current timer state.

Configuration

All settings are adjustable through the Hana plugin settings UI.

• gameApiUrl: Game API base URL (default http://127.0.0.1:29461/)
• workMinutes: Default work duration in minutes (default 25)
• enableAutoStart: Enable EventBus auto-start (default true)
• enableAutoStop: Enable EventBus auto-stop (default true)

How It Works

Agent starts working
    |
    +-- EventBus detects activity --> POST /v1/commands {id:"pomodoro.ui-start"}
    |
    +-- Skill fallback --> Agent calls start-pomodoro tool
    |
    v
Character plays work animation + Pomodoro countdown

    ... (Agent processing request) ...

Agent finishes working
    |
    +-- EventBus detects idle --> POST /v1/commands {id:"pomodoro.ui-stop"}
    |
    +-- Skill fallback --> Agent calls stop-pomodoro tool
    |
    v
Character stops + Pomodoro settlement

The dual-track mechanism ensures the timer works correctly even if EventBus auto-detection is unavailable.

Game Plugin Installation

# 1. Download the latest Release
# https://github.com/Halo0sama/ToMemorie/releases/latest

# 2. Extract the codex-bridge-fix folder and copy MemoryOfMemorieCodexBridge.dll to:
#    BepInEx/plugins/MemoryOfMemorieCodexBridge/

# 3. Launch the game once (generates BepInEx interop files)

# 4. Verify: Invoke-RestMethod http://127.0.0.1:29461/health

License

GPL-3.0-or-later

Portions of this project are adapted from Memory of Memorie Codex Bridge: https://github.com/Chizer77/Memory-of-Memorie-Codex-Bridge

Developed with the assistance of DeepSeek V4.

---

Memory of Memorie 番茄钟

Hana 插件 ID: memory-of-memorie-pomodoro

作者: Halo & Hanako

将 Memory of Memorie 游戏与 AI Agent 的工作节奏自动同步。Agent 开始处理请求时，游戏番茄钟启动、人物开始工作动画；Agent 完成工作时，番茄钟停止、人物随之休息。

前置条件

1. 已安装 Memory of Memorie
2. 已安装 Memory of Memorie Codex Bridge v0.3.0+ 游戏插件（BepInEx）
3. 游戏运行中，HTTP API 已启动（默认 http://127.0.0.1:29461/）
4. 游戏 config.json 中 Wallpaper.Enabled 设为 false

功能

全平台通过统一的 Codex Bridge HTTP API 通信。

• Hana Agent：安装本插件，通过 EventBus 自动同步工作状态 + Skill 指令兜底，无需手动操作。
• Codex / Claude Code / OpenCode：使用 Codex Bridge 自带的 hooks 直接调用 API，无需本插件。

工具	描述
start-pomodoro	启动番茄钟，可选 minutes 参数
stop-pomodoro	停止番茄钟
pomodoro-status	查看番茄钟当前状态

配置

通过 Hana 插件设置界面修改。

• gameApiUrl: 游戏 API 地址（默认 http://127.0.0.1:29461/）
• workMinutes: 默认工作时长（默认 25 分钟）
• enableAutoStart: 自动启动开关（默认 true）
• enableAutoStop: 自动停止开关（默认 true）

工作原理

Agent 开始工作
    |
    +-- EventBus 检测到活动 --> POST /v1/commands {id:"pomodoro.ui-start"}
    |
    +-- Skill 指令兜底 --> Agent 调用 start-pomodoro 工具
    |
    v
游戏人物开始工作动画 + 番茄钟倒计时

    ...（Agent 处理请求中）...

Agent 完成工作
    |
    +-- EventBus 检测到空闲 --> POST /v1/commands {id:"pomodoro.ui-stop"}
    |
    +-- Skill 指令兜底 --> Agent 调用 stop-pomodoro 工具
    |
    v
游戏人物停止工作 + 番茄钟结算

双轨机制确保即使 EventBus 自动检测失效，Skill 指令也能保证番茄钟正常工作。

安装游戏插件

# 1. 下载最新 Release
# https://github.com/Halo0sama/ToMemorie/releases/latest

# 2. 解压 codex-bridge-fix 文件夹，将 MemoryOfMemorieCodexBridge.dll 覆盖到：
#    BepInEx/plugins/MemoryOfMemorieCodexBridge/

# 3. 启动游戏一次（生成 BepInEx interop 文件）

# 4. 验证: Invoke-RestMethod http://127.0.0.1:29461/health

许可

GPL-3.0-or-later

本项目部分代码移植自 Memory of Memorie Codex Bridge：https://github.com/Chizer77/Memory-of-Memorie-Codex-Bridge

在 DeepSeek V4 的协助下完成开发。