Roo Logger

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

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

评分 : 2.5分

下载量 : 8.5K

更新时间 : 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 提供了三个主要功能模块，分别为列出保存的日志文件、搜索日志以及获取日志文件列表。下面将详细介绍这些功能模块的使用方法。

✨ 主要特性

提供 get_log_files 命令，可列出保存的日志文件，还能指定最大搜索深度。
提供 search_logs 命令，支持通过多种过滤器搜索保存的日志。
详细的参数设置，满足不同场景下的日志管理需求。

📦 安装指南

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

💻 使用示例

日志文件列表

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

参数说明

属性	详情
模型类型	无
训练数据	无
`logsDir`	日志目录（绝对路径），必填，字符串类型
`limit`	最大文件数，默认为10，可选，数字类型
`offset`	跳过的文件数，默认为0，可选，数字类型
`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"

参数说明

属性	详情
`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.