# Researcher Hand - 深度研究和分析能力包
#
# OpenFang Hand 配置示例
# 这个 Hand 提供深度研究、信息收集和分析能力

[hand]
name = "researcher"
version = "1.0.0"
description = "深度研究和分析能力包 - 执行复杂的多步研究任务"
author = "ZCLAW Team"

# Hand 类型: research, automation, data, communication
type = "research"

# 是否需要人工审批才能执行
requires_approval = false

# 默认超时时间（秒）
timeout = 300

# 最大并发执行数
max_concurrent = 3

# 能力标签
tags = ["research", "analysis", "web-search", "information-gathering"]

[hand.config]
# 搜索引擎配置
search_engine = "auto"  # auto, google, bing, duckduckgo
max_search_results = 10
search_timeout = 30

# 研究深度: quick, standard, deep
depth = "standard"

# 是否保存研究历史
save_history = true

# 输出格式: markdown, json, summary
output_format = "markdown"

[hand.triggers]
# 触发器配置
manual = true  # 允许手动触发
schedule = false  # 不允许定时触发
webhook = false  # 不允许 webhook 触发

# 事件触发器
[[hand.triggers.events]]
type = "chat.intent"
pattern = "研究|调查|分析|查找|search|research|investigate"
priority = 5

[hand.permissions]
# 权限要求
requires = [
  "web.search",
  "web.fetch",
  "file.read",
  "file.write"
]

# RBAC 角色要求
roles = ["operator.read", "operator.write"]

# 速率限制
[hand.rate_limit]
max_requests = 20
window_seconds = 3600  # 1 hour

# 审计配置
[hand.audit]
log_inputs = true
log_outputs = true
retention_days = 30

# 示例工作流步骤
[[hand.workflow]]
id = "search"
name = "搜索信息"
description = "使用搜索引擎查找相关信息"

[[hand.workflow]]
id = "extract"
name = "提取内容"
description = "从搜索结果中提取关键内容"

[[hand.workflow]]
id = "analyze"
name = "分析整理"
description = "分析和整理提取的信息"

[[hand.workflow]]
id = "report"
name = "生成报告"
description = "生成结构化的研究报告"