🚀 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.
项目联系人
如有任何问题或建议，请联系：
- 邮箱：[你的邮箱]
- GitHub：[你的GitHub链接]
感谢使用Roo Activity！