🔮 灯影助手 (Shadow Seer)

项目全是ai studio写的，包括这条 README.md 。

---

🌟 核心功能

• 🧠 智能逻辑穷举：自动分析所有玩家的查验信息，排除矛盾项，给出所有合法的【真预言家 + 灯影预言家】组合。
• 🖱️ 交互式录入：独创“点选查验”模式。点击放大镜开启查验，直接点击目标玩家发放金水或查杀，告别繁琐的下拉选框。
• 🐺 狼坑视角切换：支持“标准视角”与“找狼视角”。一键切换，优先展示公共狼坑，快速定位潜在狼人。
• 🎨 极致视觉体验：
  • 支持深色/浅色模式随心切换。
  • 集成 View Transitions API，享受如丝般顺滑的转场动画。
  • 响应式布局，完美适配 PC 与移动端。
• 💾 本地持久化：自动保存当前进度，刷新页面或意外关闭后逻辑依然存在。

---

🎲 游戏板子配置 (12人娱乐场)

本工具基于灯影预言家版型：

• 狼人阵营：3名普通狼人 + 1名狼王
• 好人阵营：4名神职阵营（预言家、骑士、女巫、猎人）+ 4名平民阵营（平民*3、灯影预言家）
• 灯影预言家：平民阵营，与预言家卡牌相同，查验到好人显示为“查杀”，查验到狼人显示为“金水”。

---

🚀 快速开始

运行环境

确保你已安装 Node.js。

安装步骤

1. 克隆项目：

   git clone https://github.com/syhy0612/shadow-seer.git

2. 进入目录并安装依赖：

   cd shadow-seer-helper
   npm install

3. 启动开发服务器：

   npm run dev

---

📖 使用指南

1. 录入查验信息：点击号码卡片上的 🔍图标 进入“查验模式”，然后在其他号码卡片上点击 √ 发金水，或 × 发查杀。
2. 标记已知身份：点击号码卡片上的 👤图标 可选择标记身份。可以给自己的身份、明好人或听保的号码标记为好人，同理可手动标记狼人。
3. 查看逻辑推理：系统会根据设定规则自动穷举并筛选出所有合理的逻辑组合。手机端需点击右上方的 ⚡推理 按钮打开结果面板。

---

🛠️ 技术栈

• Frontend: React 19 (Hooks, Context, useMemo)
• Styling: Tailwind CSS (Dark Mode support)
• Icons: Lucide React
• Animation: View Transitions API & Tailwind Animate
• Tooling: Vite, TypeScript

---

📝 许可证

本项目采用 MIT License 许可。