# 狸Sir工具箱

**Repository Path**: aikotsuki/Rhythm_Toolbox

## Basic Information

- **Project Name**: 狸Sir工具箱
- **Description**: 《二重螺旋》游戏角色与武器图鉴管理应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-15
- **Last Updated**: 2026-02-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 狸Sir工具箱 | Rhythm Toolbox

<div align="center">

**狸Sir工具箱，最好的二重螺旋游戏工具箱**

*Rhythm Toolbox is the best Duet Night Abyss game toolbox*

![Version](https://img.shields.io/badge/version-0.5.0-blue.svg)
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)
![License](https://img.shields.io/badge/license-Private-red.svg)

</div>

---

## 📖 简介 | Introduction

狸Sir工具箱是一款专为《二重螺旋》(Duet Night Abyss) 玩家打造的桌面游戏工具箱，提供沉浸式的角色、武器图鉴查阅、收藏管理和编辑功能。

*Rhythm Toolbox is a desktop game toolbox designed for Duet Night Abyss players, providing an immersive character and weapon encyclopedia browsing, collection management, and editing features.*

### ✨ 核心特性 | Key Features

| 中文 | English |
|------|---------|
| ACGN 二次元风格 | ACGN Style |
| 快速响应 | Fast Response |
| 完整图鉴 | Complete Encyclopedia |
| 收藏管理 | Collection Management |
| 毛玻璃效果 | Glassmorphism |
| 流畅动画 | Smooth Animations |
| 桌面应用 | Desktop Application |

---

## 🛠️ 技术栈 | Tech Stack

| 类别 | Category | 技术 | Technology |
|------|----------|------|------------|
| 框架 | Framework | Electron 29 + React 18 + TypeScript + Vite 5 |
| UI | UI | Tailwind CSS 3 + Framer Motion + Lucide React |
| 状态管理 | State | Zustand |
| 路由 | Router | React Router DOM (HashRouter) |
| 打包 | Package | electron-builder |

---

## 📦 安装 | Installation

### 下载安装程序 | Download Installer

1. 访问 [Releases](../../releases) 页面 / Visit [Releases](../../releases) page
2. 下载最新的 `Rhythm Toolbox Setup x.x.x.exe` / Download the latest installer
3. 运行安装程序并按照提示完成安装 / Run the installer and follow the prompts

### 系统要求 | System Requirements

| 项目 | Requirement |
|------|-------------|
| 操作系统 / OS | Windows 10/11 (64位/64-bit) |
| 内存 / Memory | 至少 4GB RAM / At least 4GB RAM |
| 存储 / Storage | 至少 500MB 可用空间 / At least 500MB free space |

---

## 🚀 快速开始 | Quick Start

```bash
# 克隆项目 / Clone the repository
git clone https://gitee.com/aikotsuki/Rhythm_Toolbox.git
cd Rhythm_Toolbox

# 安装依赖 / Install dependencies
npm install

# 启动开发服务器 / Start development server
npm run dev

# 类型检查 / Type check
npm run check

# 构建应用 / Build application
npm run build

# 打包 Windows 安装程序 / Package Windows installer
npm run package
```

### 其他命令 | Other Commands

```bash
npm run lint          # 代码检查 / Code linting
npm run preview       # 预览构建产物 / Preview build
npm run build:electron # 构建 Electron 主进程 / Build Electron main process
npm run gen:icon      # 生成应用图标 / Generate app icon
```

---

## 📂 项目结构 | Project Structure

```
Rhythm_Toolbox/
├── apps/
│   ├── electron/                  # Electron 主进程 / Electron main process
│   │   ├── main.ts
│   │   └── preload.ts
│   └── renderer/                  # React 渲染进程 / React renderer
│       ├── src/
│       │   ├── components/       # React 组件 / React components
│       │   ├── data/             # 静态数据 / Static data
│       │   ├── lib/              # 工具函数 / Utilities
│       │   ├── pages/            # 页面组件 / Page components
│       │   ├── store/            # Zustand 状态管理 / State management
│       │   ├── types/            # TypeScript 类型 / Type definitions
│       │   ├── App.tsx           # 应用根组件 / Root component
│       │   └── main.tsx          # React 入口 / React entry
│       └── public/               # 静态资源 / Static assets
│           └── assets/           # 图片资源 / Image resources
├── config/                       # 配置文件 / Configuration files
├── docs/                        # 项目文档 / Project documentation
├── scripts/                     # 构建脚本 / Build scripts
├── build/                      # 构建资源 / Build resources
└── output/                     # 构建产物 / Build output
    ├── dist/                    # Web 应用 / Web app
    ├── dist-electron/           # Electron 主进程 / Electron main
    └── release/                 # 打包产物 / Packaged releases
```

---

## 🎨 设计规范 | Design System

### 主题色板 | Theme Colors (浅色模式)

| 颜色 | Color | 色值 | Hex | 用途 | Usage |
|------|-------|------|-----|------|-------|
| 主色 | Primary | 粉色 | `#EE7093` | 主要交互元素、高亮、强调 | Main interactive elements |
| 辅色 | Secondary | 蓝色 | `#2D52B7` | 次要强调、成功状态 | Secondary emphasis |
| 强调色 | Accent | 淡紫色 | `#C5B4E5` | 边框、次要元素 | Borders, secondary elements |
| 背景色 | Background | 浅粉色 | `#FDF0F4` | 页面主背景 | Page background |
| 白色 | White | 白色 | `#FFFFFF` | 卡片、弹窗背景 | Card, modal background |

### UI 特性 | UI Features

- 12px 圆角设计 / 12px border radius
- 毛玻璃效果 / Glassmorphism effect
- 流畅动画过渡 / Smooth animation transitions
- 5种核心色彩系统 / 5-color core system

---

## 📄 功能模块 | Features

| 模块 | Module | 状态 | Status | 说明 | Description |
|------|--------|------|--------|------|-------------|
| 初始化向导 | Setup Wizard | ✅ | Done | 首次运行配置 | Initial setup |
| 首页 | Home | ✅ | Done | 数据统计、快速导航 | Stats, quick navigation |
| 角色图鉴 | Characters | ✅ | Done | 列表、筛选、收藏 | List, filter, favorite |
| 角色详情 | Character Detail | ✅ | Done | 属性、技能、档案、语音 | Attributes, skills, archive, voice |
| 角色编辑器 | Character Editor | ✅ | Done | 新建/编辑角色 | Create/Edit character |
| 武器库 | Weapons | ✅ | Done | 列表、详情 | List, details |
| 武器编辑器 | Weapons Editor | ✅ | Done | 新建/编辑武器 | Create/Edit weapon |
| 收藏管理 | Collection | ✅ | Done | 进度、导出 | Progress, export |
| 设置 | Settings | ✅ | Done | 主题、数据管理 | Theme, data management |

---

## 📖 文档 | Documentation

| 文档 | Document | 说明 | Description |
|------|----------|------|-------------|
| `docs/PROJECT_STRUCTURE.md` | 项目结构 | Project structure |
| `docs/BRAND_DESIGN.md` | 品牌设计 | Brand design |
| `docs/TEST_DOCUMENTATION.md` | 测试文档 | Test documentation |
| `docs/GLOSSARY.md` | 术语表 | Glossary |
| `docs/AGENTS.md` | 开发指南 | Development guide |

---

## 🤝 贡献 | Contribution

本项目为私有项目，暂不接受外部贡献。

*This is a private project and does not accept external contributions.*

---

## 📝 许可证 | License

本项目版权归作者所有。

*This project is proprietary and all rights are reserved.*

---

## 📧 作者 | Author

**作者 / Author**: 哔哩哔哩AikoTsuki
**版权 / Copyright**: © 2026 哔哩哔哩AikoTsuki

---

## 🔗 相关链接 | Links

---

## 📌 版本信息 | Version Information

| 项目 | 版本 |
|------|------|
| **应用** | 0.7.0 |
| **Electron** | 29.0.1 |
| **React** | 18.2.0 |
| **Node.js** | 建议 20.x 或更高 |
| **操作系统** | Windows 10/11 |

### 最新更新 (v0.7.0)

- 视觉升级：角色图鉴页面降低粉色覆盖率，增加中性文字色阶
- 筛选栏改为白色浮层 + 大圆角 + 柔和阴影
- 角色卡片更大圆角、柔和阴影、悬停效果
- 布局优化：Sidebar 与 Header 材质统一，主背景中性化
- 全局搜索框边框可见性增强

详细更新日志请查看 [CHANGELOG.md](./CHANGELOG.md)

---

- [Gitee 仓库 / Repository](https://gitee.com/aikotsuki/Rhythm_Toolbox)

---

<div align="center">

**Made with ❤️ for Duet Night Abyss Players**

</div>