Roo Logger

Roo Activity Logger是一個MCP服務器，用於自動記錄Roo Code（Cline）的活動，包括命令執行、代碼生成等，並將日誌保存為JSON文件以便後續搜索和分析。

開發者工具知識管理與記憶 #活動日誌 #自動記錄 #JSON存儲 #開發工具本地 .TypeScript

評分 : 2.5分

下載量 : 26

更新時間 : 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.