# MCP 工具 ↔ chunk 关联
#
# 用途：
#   1. chunk frontmatter 的 related_tools 字段取值受控（lint 校验）
#   2. ingest 期把 related_tools 写入 chunk metadata，retriever 可联动工具
#   3. 让 AI 在调 search_help_docs 时同时知道"还能调哪个工具直接操作"
#
# 工具清单来自 dootask-plugins/mcp/server/src/dootaskMcpServer.ts（29 个 MCP 工具）
# 加 helper/tools.py 中的内置工具（GetSessionImageTool 等）
#
# 注：页面操作（打开任务/页面跳转/操作元素）已从 MCP 迁出，改由主程序常驻
# WebSocket（/ws）派发、doo CLI（doo page）触发，不再是 MCP 工具；图片文字提取
# （OCR）已下线，改由多模态模型直接理解图片。

version: 1
last_updated: 2026-07-19

tools:

  # ===== 用户 =====
  get_users_basic:
    description: 批量获取用户基本信息（昵称/邮箱/头像）
    related_features: [user-account, org-department]
    typical_chunk_types: [concept]

  search_users:
    description: 按关键词搜索用户，支持按项目/对话范围筛选
    related_features: [user-account]
    typical_chunk_types: [howto]

  # ===== 任务 =====
  list_tasks:
    description: 列表获取用户相关任务，支持状态/项目/时间范围筛选
    related_features: [task, dashboard]
    typical_chunk_types: [howto]

  get_task:
    description: 获取任务完整详情
    related_features: [task]
    typical_chunk_types: [concept, howto]

  create_task:
    description: 在指定项目创建新任务
    related_features: [task]
    typical_chunk_types: [howto]

  update_task:
    description: 更新任务属性
    related_features: [task, dashboard]
    typical_chunk_types: [howto]

  complete_task:
    description: 标记任务完成
    related_features: [task, dashboard]
    typical_chunk_types: [howto]

  delete_task:
    description: 删除或恢复任务
    related_features: [task]
    typical_chunk_types: [howto]

  create_sub_task:
    description: 为父任务添加子任务
    related_features: [task]
    typical_chunk_types: [howto]

  get_task_files:
    description: 获取任务附件列表
    related_features: [task, file]
    typical_chunk_types: [howto]

  # ===== 项目 =====
  list_projects:
    description: 列表获取用户可访问项目
    related_features: [project]
    typical_chunk_types: [howto]

  get_project:
    description: 获取项目完整详情
    related_features: [project]
    typical_chunk_types: [concept, howto]

  create_project:
    description: 创建新项目
    related_features: [project]
    typical_chunk_types: [howto]

  update_project:
    description: 更新项目信息
    related_features: [project]
    typical_chunk_types: [howto]

  # ===== 消息 / 对话 =====
  search_dialogs:
    description: 搜索群聊或个人对话
    related_features: [messenger]
    typical_chunk_types: [howto]

  send_message:
    description: 向对话发送消息
    related_features: [messenger]
    typical_chunk_types: [howto]

  send_task_ai_message:
    description: 作为 AI 助手向任务对话发送消息
    related_features: [messenger, task]
    typical_chunk_types: [howto]

  get_message_list:
    description: 获取对话消息历史
    related_features: [messenger]
    typical_chunk_types: [howto]

  # ===== 文件 =====
  list_files:
    description: 列表获取用户文件
    related_features: [file]
    typical_chunk_types: [howto]

  search_files:
    description: 搜索文件
    related_features: [file]
    typical_chunk_types: [howto]

  get_file_detail:
    description: 获取文件详情
    related_features: [file]
    typical_chunk_types: [howto]

  fetch_file_content:
    description: 按文件路径获取文本内容
    related_features: [file]
    typical_chunk_types: [howto]

  # ===== 工作报告 =====
  list_received_reports:
    description: 列表获取收到的工作报告
    related_features: [report]
    typical_chunk_types: [howto]

  get_report_detail:
    description: 获取报告详情
    related_features: [report]
    typical_chunk_types: [howto]

  generate_report_template:
    description: 基于任务完成情况自动生成报告模板
    related_features: [report]
    typical_chunk_types: [howto]

  create_report:
    description: 创建并提交工作报告
    related_features: [report]
    typical_chunk_types: [howto]

  list_my_reports:
    description: 列表获取发送的报告
    related_features: [report]
    typical_chunk_types: [howto]

  mark_reports_read:
    description: 批量标记报告为已读/未读
    related_features: [report]
    typical_chunk_types: [howto]

  # ===== 搜索 =====
  intelligent_search:
    description: 统一搜索（任务/项目/文件/联系人/消息），支持语义搜索
    related_features: []
    typical_chunk_types: [howto, concept]

  # 注：图片文字提取（OCR / 原 extract_image_text）已下线，改由多模态模型直接理解图片，
  # 不再是 MCP 工具。

  # 注：页面操作（原 get_page_context / execute_action / execute_element_action）已从 MCP
  # 迁出，改由主程序常驻 WebSocket（/ws）派发、doo CLI（doo page context|action|element）触发，
  # 不再是 MCP 工具。

  # 注：原 show_guide（driver.js 分步引导）已下线，改为 AI 回复内联深链
  # [显示文字](dootask://link/<id>)，目录见 _meta/page-links.yaml（前端渲染，非 MCP 工具）

  # ===== 内置工具（AI 插件 helper/tools.py）=====
  get_session_image:
    description: 获取用户上传的会话图片（多模态用）
    related_features: [file]
    typical_chunk_types: [howto]

  search_help_docs:
    description: 本知识库自身的检索工具；当用户询问 DooTask 功能用法/概念/操作步骤时调用
    related_features: []
    typical_chunk_types: [howto]