# shell-desktop

**Repository Path**: stupid1t/shell-desktop

## Basic Information

- **Project Name**: shell-desktop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 脚本管理器

一个 Windows 桌面程序，用于统一管理和执行各类脚本（Python、Node.js、Java、bat/cmd 等）。

一眼看清所有脚本的运行状态，一键启动/停止，保留完整运行历史和日志。

## 功能

- **脚本管理** — 添加、编辑、删除脚本，支持任意可在命令行运行的脚本类型
- **标签分组** — 给脚本打标签（如"爬虫"、"工具"、"工作"），按标签筛选
- **一键执行** — 点击运行按钮启动脚本，支持同时运行多个
- **状态监控** — 实时显示脚本状态：空闲 / 运行中 / 成功 / 失败
- **实时日志** — 脚本运行时像终端一样滚动显示输出
- **历史记录** — 每次运行的时间、状态、日志都保存在本地，随时回查
- **深色/浅色主题** — 一键切换

## 截图

（待补充）

## 技术栈

| 层级 | 技术 |
|------|------|
| 框架 | Tauri v2 |
| 前端 | React 18 + TypeScript + TailwindCSS |
| 后端 | Rust |
| 数据库 | SQLite（本地存储） |
| 打包体积 | ~5-10MB |

## 环境要求（开发）

- [Node.js](https://nodejs.org/) 18+
- [Rust](https://rustup.rs/) 1.70+
- [Visual Studio Build Tools](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/)（勾选"使用 C++ 的桌面开发"）

## 快速开始

```bash
# 克隆项目
git clone git@gitee.com:stupid1t/shell-desktop.git
cd shell-desktop

# 安装前端依赖
npm install

# 启动开发模式（会自动编译 Rust 后端并打开窗口）
npm run tauri dev
```

首次编译 Rust 依赖需要几分钟，之后就很快了。

## 打包

```bash
npm run tauri build
```

打包产物在 `src-tauri/target/release/bundle/` 目录下，包含 `.msi` 安装包和 `.exe` 可执行文件。

打包后的程序可以在任意 Windows 10/11 电脑上运行，不需要安装 Python、Node.js、Rust 等运行时。

## 使用说明

1. **添加脚本** — 点右上角"添加脚本"，填写名称、脚本文件路径、执行命令
   - 例如：名称 `数据抓取`，路径 `C:\scripts\crawler.py`，命令 `python crawler.py`
   - 工作目录可选，指定脚本在哪个文件夹下执行

2. **运行脚本** — 在脚本卡片上点"运行"按钮

3. **查看日志** — 点击脚本卡片，底部展开日志面板，实时显示输出

4. **停止脚本** — 运行中的脚本会显示"停止"按钮，点击强制终止

5. **查看历史** — 日志面板切换到"历史记录"标签页，查看过往运行结果

## 项目结构

```
shell-desktop/
├── src/                    # 前端代码（React）
│   ├── components/         # UI 组件
│   ├── hooks/              # 数据逻辑
│   ├── api.ts              # Tauri 命令调用
│   └── types.ts            # 类型定义
├── src-tauri/              # 后端代码（Rust）
│   ├── src/
│   │   ├── lib.rs          # 应用入口
│   │   ├── db.rs           # 数据库初始化
│   │   ├── models.rs       # 数据模型
│   │   ├── executor.rs     # 进程管理器
│   │   └── commands/       # Tauri 命令
│   └── tauri.conf.json     # Tauri 配置
└── docs/                   # 设计文档和实现计划
```

## 数据存储

数据保存在本地 SQLite 数据库中，位置：

```
%LOCALAPPDATA%\shell_desktop\data.db
```

不联网，不上传，数据完全在你自己电脑上。

## License

MIT