猫和老鼠手游百科

专为《猫和老鼠手游》玩家打造的数据查询网站。

📱 功能简介

• 角色查询: 查看角色属性、技能、推荐加点和知识卡等
• 知识卡/道具/衍生物/特技/状态查询: 查看其准确的具体效果
• 文章分享: 浏览其他爱好者的记录、思考和发现
• 筛选与搜索: 快速找到目标条目

🌟 亮点

• 数值精确、机制详细
• 描述详略可自由切换
• 极为直观的技能加点

🚀 快速访问

• 在线网站: tjwiki.com
• 开发预览: dev.tjwiki.com

💬 社区交流

• QQ交流群: 615882730 (了解项目进展、提供建议、贡献内容、技术交流)

项目计划

• 统一用词 - 技能描述中的“硬直/眩晕”等（定义待统一）
• 画廊 - 各种猫鼠二创（缺素材）
• 地图NPC - 斯派克、女主人等
• 地图 - 展示地图及点位信息（缺素材）

❤️ 支持本项目

如果你喜欢本项目，欢迎通过 Patreon 赞助。

特别感谢所有赞助者！

🛠️ 技术栈

• 框架: Next.js 15 (App Router)
• 语言: TypeScript
• 样式: Tailwind CSS 4
• 状态管理: Valtio & SWR
• 测试: Jest & React Testing Library
• 部署: Vercel
• 代码规范: ESLint & Prettier
• 认证与数据: Supabase (Auth、Postgres、RPC)

💻 本地开发

环境要求

• Node.js: >=20.0.0
• npm: >=10.0.0
• .env.local: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, NEXT_PUBLIC_SUPABASE_AUTH_USER_EMAIL_DOMAIN,NEXT_PUBLIC_ENABLE_VERCEL_ANALYTICS（设为 0 强制禁用或 1 强制启用Vercel Analytics；默认仅在 Vercel 生产环境启用）、APP_PUBLIC_HOST（用于跨子域 Cookie，与生产域名保持一致）。

开发步骤

1. 克隆仓库:

   git clone https://github.com/asHOH/Tom-and-jerry-chase-wiki.git
   cd Tom-and-jerry-chase-wiki

2. 安装依赖:

   npm install

3. 启动开发服务器:

   npm run dev

   之后，在浏览器中打开 http://localhost:3000 即可。

主要 npm 命令

# 开发
npm run dev             # 启动开发服务器
npm run build           # 构建生产版本
npm run start           # 启动生产服务器

# 代码质量
npm run lint            # 运行 ESLint
npm run lint:fix        # 修复 ESLint 问题
npm run format          # 格式化代码 (Prettier + ESLint)
npm run type-check      # TypeScript 类型检查

# 测试
npm test                # 运行测试
npm run test:watch      # 监视模式
npm run test:coverage   # 生成覆盖率报告
npm run test:ci         # CI 优化测试

# 工具
npm run clean           # 清理构建产物
npm run analyze         # 包分析

☁️ 非 Vercel 部署指南

1. 环境变量

   • 需要在构建阶段注入 COMMIT_SHA（或 DEPLOY_COMMIT_SHA）以保证 /api/version 返回准确版本信息。
   • 使用 DEPLOYMENT_ENVIRONMENT（可选值 development/preview/production）标记运行环境；如不设置将回退为 NODE_ENV。
   • 将 APP_PUBLIC_HOST 设置为生产域名（例如 wiki.example.com）以确保深色模式 Cookie 覆盖所有子域。
   • 默认不加载 Vercel Analytics/Speed Insights。可将 NEXT_PUBLIC_ENABLE_VERCEL_ANALYTICS 设为 1 以继续使用（需确保 CSP/CORS 放行相应域名）。

2. 安全头与缓存策略

   • next.config.mjs 已在运行时发送核心安全头（CSP、HSTS 等），请在目标平台（如 Netlify、Cloudflare、Nginx）继续配置静态资源头信息，保持与 vercel.json 一致的缓存策略。

如果你在特定平台部署成功，欢迎分享经验。

🤝 一起完善这个项目吧

方法一 - 加入QQ交流群

方法二 - 直接贡献代码

1. Fork 本仓库。
2. 基于 develop 分支创建新的feature分支，并进行开发:

   git checkout develop
   git checkout -b feature/your-feature-name

3. 提交 Pull Request 到 develop 分支。提交前，建议运行本地检查以确保代码质量：
   • Windows (PowerShell): .\test-github-workflows.ps1
   • macOS/Linux: ./test-github-workflows.bash

📁 项目结构

.
├── .github/            # GitHub Actions 工作流与模板
├── .husky/             # Git 钩子配置
├── public/             # 静态资源 (图片, PWA manifest)
├── src/
│   ├── app/            # Next.js App Router 页面与 API 路由
│   ├── components/     # React 组件
│   │   ├── ui/         # 基础 UI 组件
│   │   └── displays/   # 复杂展示组件
│   ├── constants/      # 全局常量
│   ├── context/        # React Context 提供者
│   ├── data/           # 核心数据与类型定义
│   ├── lib/            # 工具函数与业务逻辑
│   └── supabase/       # Supabase 客户端（browser/server/admin）
├── scripts/            # 工具脚本
├── README.md           # 项目说明
└── package.json        # 项目依赖与脚本

📄 版权与许可

• 代码: GPL-3.0 许可。二次开发须以相同的许可证开源。
• 数据和文档内容: CC BY 4.0 许可。使用时请署名原作者 asHOH 并链接到本仓库。

注意: 《猫和老鼠手游》素材的版权见免责声明。

⚠️ 免责声明

本网站为非盈利粉丝项目，仅供学习交流。

🔒 隐私承诺： 永不收集任何用户数据。

💰 免费承诺： 所有功能永久免费。

猫和老鼠（Tom and Jerry）角色版权归华纳兄弟娱乐公司（Warner Bros. Entertainment Inc.）所有。游戏素材版权归网易猫和老鼠手游所有。

若版权方提出要求，我们将立即调整。

特别鸣谢:

• 追风汤姆、隔壁老米LM、音乐家杰瑞、梦回_淦德蒸蚌、是莫莫喵、如梦 提供测试数据
• 隔壁老米LM、凡叔哇 分享图片素材
• 海阔天空、音乐家杰瑞 进行项目开发
• 海阔天空、追风汤姆、隔壁老米LM、音乐家杰瑞、雨狼嗷嗷、爱你不慎走安详、虚拟未来、人畜有害的白菜、SYSTEM_CPYTHON、夜空乄浩瀚、追风汤姆Official、-无尽炽羽-、北雀、一个气球君、樱鹜ying、你小睿大帝、大水将军、冰美式、饮泉思源、睡亿夏、港鸽、若梦、生煎包勇闯猫鼠、祈风盼陌上花开、_1322_、dream、想  笑、人偶、青城落梦、长河落日、豆浆、迷者很无聊、HZZHD、小郑、瘦宅、乐善好施陈阿姨、秋雨绵绵、无敌猫虎大王wy、如梦if、丷小天丷、sunny 撰写角色文案

---

再次感谢所有为项目作出贡献的玩家和开发者！ 🎮