card-search

name	card-search
description	用于查询 Weiss Schwarz (WS) 卡牌的详细信息、效果文本、俗语、专有名词、特定概念及相关规则。当用户询问卡牌效果、属性、ID、俗语、专有名词、特定概念或相关规则时调用此技能。

Card Search Skill

概述 (Overview)

本技能提供对 Weiss Schwarz 卡牌数据库和规则书的检索能力。 核心功能是通过 RAG (检索增强生成) 技术，从本地向量数据库中查找卡牌的英文原始数据，并将其翻译为中文反馈给用户。 同时支持对游戏规则的查询辅助。

约束与规则 (Constraints)

• 必须优先使用工具：执行查询时，必须且只能首先调用 skills/card-search/card_search.py 脚本。
• 必须使用 Python 解释器调用脚本：调用 card_search.py 时，必须使用 ./venv/bin/python3（或等价的 python3）作为前缀。禁止直接执行 .py 文件路径，否则会被 shell 误当作脚本解析并报错（如 from: command not found）。
• 禁止直接遍历数据库：在未获得用户明确许可前，严禁直接读取 data/Card_DB 目录下的所有文件或使用 grep 等命令进行全量搜索。这会消耗大量资源并导致性能问题。
• 低置信度处理：如果 card_search.py 返回的结果完全不正确、相关性低或未找到预期结果，必须先向用户报告情况，并询问：“搜索工具未找到准确结果，是否允许我直接对数据库进行全量检索？（这可能需要较长时间）”。只有在用户回复“是”或“确认”后，才允许使用其他手段（如 grep 或遍历文件）进行搜索。
• 禁止自行生成代码：严禁编写新的 Python 脚本来尝试连接数据库或读取文件，必须使用现有的 RAG 工具。
• 强制中文翻译：数据库返回的内容通常是英文的，你必须将所有卡牌效果、特征、名称等信息翻译成流畅的中文游戏术语。

工具定义 (Tools)

card_search.py

用于查询知识库的核心工具。

• 输入参数:

  • query (string): 用户的自然语言查询或关键词。应主要包含卡牌名称、特征、编号或规则关键词，并且在查询中包含"检索"前缀。
  • category (string, optional): 查询类别。可选值为 "card" (仅查卡牌), "rule" (仅查规则), "all" (默认，查所有)。

• 输入示例:

  • export PYTHONPATH=$PYTHONPATH:. && ./venv/bin/python3 skills/card-search/card_search.py "检索Armin Level 0" --category card
  • export PYTHONPATH=$PYTHONPATH:. && ./venv/bin/python3 skills/card-search/card_search.py "检索Encore step" --category rule
  • 错误示例（禁止）：export PYTHONPATH=$PYTHONPATH:. && /Volumes/T7/WS_Agent/skills/card-search/card_search.py "检索Takamatsu Tomori" --category card

• 预期输出:

  • 返回一个字符串，包含从英文数据库中检索到的卡牌原始文本信息或规则片段。

执行流程与指令 (Instructions)

1. 意图识别与类别选择 (Intent Recognition & Category Selection)

当用户输入包含以下意图时，必须调用此技能，并根据意图选择正确的 category 参数：

• 查卡牌 (category="card"):

  • 用户询问具体卡牌的效果、数值、属性。
  • 重要: 如果用户输入的查卡角色是中文名，务必先调用 search_web 工具获取该角色的英文名和所属作品，再执行 card_search.py 脚本。
  • 示例: "查一下这张卡的效果", "这张卡是几级的", "搜索名为 [Name] 的卡"

• 查规则 (category="rule"):

  • 用户询问游戏流程、特定关键词，俗语等名称定义、裁定。
  • 示例: "什么是 [Keyword] 效果", "安可步骤怎么处理", "联动是什么意思"

• 混合查询 (category="all"):

  • 用户问题既涉及卡牌又涉及规则，或意图不明确。
  • 示例: "帮我找几张强力的三级联动卡，并解释一下什么是联动"

2. 构建查询 (Query Construction)

• 目标识别: 提取用户提到的卡牌名称、系列或特征。
• 中英文转换:
  • 规则: 数据库仅包含英文数据。
  • 强制执行: 遇到中文角色名或系列名，必须先使用 search_web 搜索该角色的官方英文名及所属系列英文名。
  • 示例: 用户输入 "千早爱音"，你应先搜索 "千早爱音 英文名 Weiss Schwarz"，得知是 "Anon Chihaya" (BanG Dream! It's MyGO!!!!!)。
  • 构建 Query: 使用搜索到的英文名调用 card_search.py (例如: export PYTHONPATH=$PYTHONPATH:. && ./venv/bin/python3 skills/card-search/card_search.py "检索Anon Chihaya" --category card)，在查询中包含"检索"前缀。
• 调用工具: export PYTHONPATH=$PYTHONPATH:. && ./venv/bin/python3 skills/card-search/card_search.py "检索[English Name]" --category card

3. 结果处理与反馈 (Response Generation)

工具返回英文结果后，按以下格式处理：

A. 卡牌信息 (Card Info)

将检索到的英文卡牌信息完整翻译成中文，并按结构化格式输出：

• 卡牌名称: [中文译名] (原文名称)
• 编号: [卡牌编号]
• 基本属性: 颜色、等级、费用、魂、触发、特征（全部中文化）
• 效果文本: (重点) 将卡牌的英文效果文本翻译为准确、流畅的中文游戏术语。
  • 术语对照:
    • Waiting Room -> 休息室/墓地
    • Climax -> 高潮卡
    • Stock -> 库存/费
    • Encore -> 再演
    • Brainstorm -> 集中
• Flavor Text: (可选) 卡面引言的翻译。

B. 规则说明 (Rules)

仅在用户询问规则或卡牌效果涉及复杂机制时补充规则说明。

C. 异常处理

• 未找到: "很抱歉，在数据库中未找到相关卡牌。请确认卡名或提供更多关键词。"
• 多结果: "找到多张相关卡牌，请明确您想查询的是哪一张："（列出选项）