# xiaomazha

**Repository Path**: xiaoyanse/xiaomazha

## Basic Information

- **Project Name**: xiaomazha
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: feature/batch0-architecture
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-12
- **Last Updated**: 2026-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center"><img src="build/icon.png" width="112" alt="小马扎剧场"></p>

# 小马扎剧场

搬个马扎，接着看。面向个人使用的短剧浏览、播放与下载工具。

本项目仅用于本地自用，不进行对外分发或商业发布。当前代码仓库：[Gitee](https://gitee.com/xiaoyanse/xiaomazha)。

## 当前功能

- 红果、西饭、河马三来源浏览与搜索；部分来源提供题材、分类和排行榜。
- 在线与本地播放、自动连播、断点续看、下一集预缓存、播放倍速和画面模式。
- 选集下载、下载队列、重试、批量管理、合并导出及缓存清理。
- 观看记录、追剧检查、横竖窗口、窗口置顶、代理和下载目录设置。

来源名称用于区分内容来源，与本软件名称无关。锁定或不可用分集保持原状态。当前自用版未接入软件更新服务。

## 启动与构建

需要 Node.js 22.12+。首次准备依赖后，可使用中文启动脚本或以下命令：

```powershell
npm ci
npm run dev
```

仅构建界面：`npm run build:react`；启动已构建界面：`npm start`。

Windows 目录版：`npm run build:dir`；便携版：`npm run build:portable`。媒体处理需要 `build/ffmpeg/ffmpeg.exe` 与 `ffprobe.exe`。Windows 应用名和快捷方式名均为“小马扎剧场”。Mac 构建入口保留，需在对应 Mac 环境验证。

下载位置在设置中选择。已有观看记录和任务数据保持兼容；指定隔离资料目录时不会读取正常使用资料。

## 本轮范围与验证

当前只完成 P1：桌面入口迁入 `electron/`，搜索嗅探和文件清理独立成模块。P2–P4 暂不实施；同时整理名称、图标、文档和历史。

```powershell
npm run check:p1
npm run build:react
npm run check:p1:smoke
npm run check:p1:dev
```

窗口验证使用本地来源页面和隔离测试资料，覆盖启动、搜索、删除记录和删除文件，不代表远程来源持续可用或所有播放场景均已验收。

[架构与阶段边界](docs/ARCHITECTURE-PLAN.md) · [本地构建说明](docs/BUILDING.md) · [P1 验证记录](docs/P1-VERIFICATION.md) · [后续需求](docs/AUDIT-2026-10-12.md)