# icommands

**Repository Path**: iotxiaohu/icommands

## Basic Information

- **Project Name**: icommands
- **Description**: 一个自定义快捷命令的工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2026-04-28
- **Last Updated**: 2026-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <img src="src/assets/logo.png" alt="icommands Logo" width="96" />

  <h1>icommands</h1>

  <p>把常用文本整理成按钮，在 Windows 中一键输入。</p>

  <p>
    <img src="https://img.shields.io/badge/platform-Windows%2010%20%7C%2011-0078D4?logo=windows" alt="Windows 10/11" />
    <img src="https://img.shields.io/badge/Tauri-2-24C8DB?logo=tauri&logoColor=white" alt="Tauri 2" />
    <img src="https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white" alt="TypeScript 5" />
    <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-green" alt="Apache-2.0 License" /></a>
  </p>

  <p>
    <a href="https://gitee.com/iotxiaohu/icommands/releases">下载</a>
    ·
    <a href="#主要功能">功能</a>
    ·
    <a href="#本地开发">开发</a>
    ·
    <a href="#参与贡献">贡献</a>
  </p>
</div>

---

icommands 是一款面向 Windows 的快捷文本工具。你可以把命令、回复模板、代码片段等重复使用的内容配置成按钮，需要时唤起面板并点击按钮，文本就会输入到之前正在使用的窗口中。

项目基于 [Tauri 2](https://tauri.app/)、[Vite](https://vite.dev/) 和 [TypeScript](https://www.typescriptlang.org/) 构建。

## 界面预览

<p align="center">
  <img src="docs/images/overview.png" alt="icommands 命令面板" width="100%" />
</p>

<p align="center">使用颜色、分组和页面整理常用内容，需要时快速查找并执行。</p>

更多界面截图和可直接导入的演示配置，请查看 [项目文档](docs/README.md)。

## 下载与安装

前往 [Releases](https://gitee.com/iotxiaohu/icommands/releases) 下载最新的 Windows 安装包并运行。

- 支持 Windows 10/11。
- 应用启动时会自动检查更新，也可以在设置页手动检查。
- 当前仅提供 Windows 版本。

## 主要功能

- **一键输入**: 将常用命令、话术或文本片段配置为按钮，并输入到之前活动的窗口。
- **自由编排**: 支持多页面、拖拽布局、批量选择、按钮分组和颜色标记。
- **快速查找**: 搜索当前页面，使用键盘在结果间移动并执行。
- **高效编辑**: 支持撤销、重做、复制、粘贴、全选和批量创建副本。
- **使用记录**: 快速访问最近使用的内容，并可按需开启执行前确认。
- **便捷唤起**: 支持自定义全局快捷键、系统托盘和开机自启动。
- **数据备份**: 支持单页或完整配置的 JSON 导入、导出。
- **个性化体验**: 支持浅色、深色主题以及窗口置顶。
- **应用内更新**: 自动检查新版本，并支持在设置页手动更新。

## 快速上手

1. 打开应用并进入编辑模式。
2. 创建页面和按钮，填写按钮名称与需要输出的文本。
3. 调整按钮的位置、大小、分组和颜色。
4. 返回使用模式，在其他程序中定位光标，然后唤起 icommands。
5. 点击按钮，将内容输入到此前活动的窗口。

> [!TIP]
> 可以在设置页录入全局快捷键。启用“关闭后驻留托盘”后，隐藏窗口时仍可随时唤起应用。

## 快捷键

### 使用模式

| 快捷键 | 作用 |
| --- | --- |
| `Ctrl+K` | 打开快速启动器 |
| `Ctrl+F` 或 `/` | 打开并聚焦当前页面搜索框 |
| `Ctrl+PageUp` / `Ctrl+PageDown` | 切换到上一个/下一个页面 |
| `↑` `↓` `←` `→` | 在搜索结果中移动 |
| `Home` / `End` | 跳到第一个/最后一个搜索结果 |
| `Enter` | 执行当前选中的搜索结果 |
| `Esc` | 关闭当前弹窗或面板 |

### 编辑模式

| 快捷键 | 作用 |
| --- | --- |
| `Ctrl+Z` | 撤销 |
| `Ctrl+Y` 或 `Ctrl+Shift+Z` | 重做 |
| `Ctrl+A` | 选择当前页面的全部按钮 |
| `Ctrl+C` / `Ctrl+V` | 复制/粘贴按钮 |
| `Ctrl+D` | 创建所选按钮的副本 |
| `Delete` | 删除所选按钮 |

## 数据与备份

应用配置默认保存在程序所在目录的 `icommands-config.json` 中。你也可以在设置页导出完整配置，或从 JSON 备份恢复。

建议在调整大量页面或按钮前先导出一份完整配置。

## 本地开发

### 环境要求

- Windows 10/11
- [Node.js](https://nodejs.org/) 18+
- npm 9+
- [Rust](https://www.rust-lang.org/tools/install) stable
- Microsoft C++ Build Tools

Tauri 在 Windows 上所需的系统依赖请参考 [Tauri prerequisites](https://v2.tauri.app/start/prerequisites/)。

### 获取源码

```bash
git clone https://gitee.com/iotxiaohu/icommands.git
cd icommands
npm install
```

### 常用命令

| 命令 | 说明 |
| --- | --- |
| `npm run tauri dev` | 启动桌面应用开发模式 |
| `npm run build` | 执行 TypeScript 检查并构建前端资源 |
| `npm run tauri build` | 构建 Windows 安装包 |
| `npm run test:release` | 运行发布脚本测试 |

桌面安装包通常输出到 `src-tauri/target/release/bundle/`。

### 项目结构

```text
icommands/
├─ src/                 # TypeScript 前端与界面样式
│  ├─ app/              # 应用状态、渲染与画布逻辑
│  ├─ features/         # 配置、快捷键、偏好设置等功能
│  └─ tauri/            # 前端调用 Tauri 命令的封装
├─ src-tauri/           # Rust 后端与 Tauri 配置
│  ├─ src/              # 文本输入、托盘、自启动等原生能力
│  └─ tauri.conf.json   # 应用构建与更新配置
├─ docs/                # 使用文档、界面截图与演示配置
├─ scripts/             # 发布脚本与测试
└─ public/              # 静态资源
```

## 参与贡献

欢迎通过 [Issues](https://gitee.com/iotxiaohu/icommands/issues) 报告问题或提出建议，也欢迎提交 Pull Request。

提交代码前，请确保：

1. 改动聚焦且有清晰的提交说明。
2. `npm run build` 可以通过。
3. 涉及发布流程时，`npm run test:release` 可以通过。
4. 新功能或行为变化已同步更新文档。

## 许可证

本项目基于 [Apache License 2.0](LICENSE) 开源。