Roo Logger

Roo Activity Logger是一个MCP服务器，用于自动记录Roo Code（Cline）的活动，包括命令执行、代码生成等，并将日志保存为JSON文件以便后续搜索和分析。

开发者工具知识管理与记忆 #活动日志 #自动记录 #JSON存储 #开发工具本地 .TypeScript

评分 : 2.5分

下载量 : 23

更新时间 : 2025-04-28

什么是Roo活动记录器？

Roo活动记录器是一个MCP服务器，能够自动记录Roo的开发活动，如命令执行、代码生成、文件操作等。所有日志以JSON格式保存，便于后续搜索和分析。

如何使用Roo活动记录器？

通过在Cline或Roo-Code配置中添加该服务器，启用自动活动记录。记录的日志可以用于任务恢复和上下文重建。

适用场景

适用于需要记录开发过程、追踪任务进展以及恢复中断工作的开发者。

主要功能

多种活动类型记录支持命令执行、代码生成、文件操作、错误记录等多种活动类型的日志记录。

详细的日志信息每条日志包含唯一ID、时间戳、活动类型、摘要、详情、意图和上下文等信息。

灵活的日志存储支持自定义日志保存目录，按日期组织日志文件。

优势与局限性

优势

自动记录开发活动，减少手动记录工作量。

日志格式统一，易于搜索和分析。

支持多种活动类型，覆盖开发全流程。

灵活的日志存储选项，满足不同需求。

局限性

需要在Cline或Roo-Code中进行配置才能启用。

对大规模项目可能产生较多日志文件，需要定期清理。

如何使用

安装Roo活动记录器

通过npx直接运行或本地克隆仓库并配置。

配置Cline或Roo-Code

在配置文件中添加Roo活动记录器的MCP服务器设置。

开始记录活动

确保每次操作都调用log_activity工具，记录活动类型、摘要、意图和上下文。

使用案例

记录命令执行记录一次npm命令的执行过程。

搜索历史日志根据日期范围和类型筛选历史日志。

常见问题

如何在本地安装Roo活动记录器？

日志文件保存在哪里？

如何恢复中断的任务？

🚀 Roo 活动日志

Roo Activity 是一款用于管理活动日志的实用工具。它具备列出保存的日志文件、搜索日志以及获取日志文件列表等核心功能，能有效提升日志管理的效率。

🚀 快速开始

Roo Activity 提供了便捷的命令行工具，可帮助你轻松管理活动日志。下面将详细介绍其主要功能模块及使用方法。

✨ 主要特性

日志文件管理：能够列出指定目录下的日志文件，并支持设置最大搜索深度、文件前缀、扩展名等参数。
日志搜索功能：可通过多种过滤器（如活动类型、日志级别、日期范围等）搜索保存的日志。
灵活的参数配置：在记录日志时，支持设置基本信息（如日志级别、消息）和额外信息（如时间戳、上下文信息、活动 ID）。

📦 安装指南

文档未提及安装步骤，故跳过此章节。

💻 使用示例

基础用法

列出日志文件

get_log_files 命令用于列出保存的日志文件，你可以指定最大搜索深度等参数。

# 基本示例
get_log_files --logsDir "/absolute/path/to/logs"

# 详细示例
get_log_files \
--logsDir "/absolute/path/to/logs" \
--limit 5 \
--offset 2 \
--logFilePrefix "roo-activity-" \
--logFileExtension ".json" \
--maxDepth 3

搜索日志

search_logs 命令用于通过多种过滤器搜索保存的日志。

# 基本示例
search_logs --logsDir "/absolute/path/to/logs"

# 过滤示例：按类型筛选
search_logs \
--logsDir "/absolute/path/to/logs" \
--type "command_execution"

高级用法

在使用 get_log_files 和 search_logs 命令时，你可以根据实际需求组合使用各种参数，以满足不同的搜索和筛选条件。例如，你可以同时指定活动类型、日志级别和日期范围来精确搜索日志。

📚 详细文档

日志文件列表参数说明

参数	是否必填	类型	描述
`logsDir`	是	字符串	日志目录（绝对路径）
`limit`	否	数字	最大文件数，默认为10
`offset`	否	数字	跳过的文件数，默认为0
`logFilePrefix`	否	字符串	日志文件前缀，默认为 `"roo-activity-"`
`logFileExtension`	否	字符串	日志文件扩展名，默认为 `".json"`
`maxDepth`	否	数字	最大搜索深度，默认为3

搜索日志参数说明

参数	是否必填	类型	描述
`logsDir`	是	字符串	日志目录（绝对路径）
`logFilePrefix`	否	字符串	日志文件前缀，默认为 `"roo-activity-"`
`logFileExtension`	否	字符串	日志文件扩展名，默认为 `".json"`
`type`	否	字符串	过滤活动类型（command_execution, code_generation, file_operation, error_encountered, decision_made, conversation）
`level`	否	字符串	过滤日志级别（debug, info, warn, error）
`startDate`	否	字符串	起始日期（格式：YYYY - MM - DD）
`endDate`	否	字符串	结束日期（格式：YYYY - MM - DD）
`searchText`	否	字符串	在摘要或详细信息中搜索文本
`limit`	否	数字	最大返回日志数，默认为50
`offset`	否	数字	跳过的日志数，默认为0
`logPath`	否	字符串数组	包含要搜索的特定日志文件路径

记录日志参数说明

基本信息

参数	是否必填	类型	描述
`level`	是	字符串	日志级别（debug, info, warn, error）
`message`	是	字符串	日志消息

额外信息

参数	是否必填	类型	描述
`timestamp`	否	字符串	时间戳
`context`	否	字典	上下文信息
`activity_id`	否	字符串	活动 ID

📄 许可证

本项目采用 MIT 许可证，具体内容如下：

MIT License

版权所有 (c) [年份] [作者姓名]
作者：[你的名字] <[你的邮箱]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.