# QingCode

**Repository Path**: FrancizTest_admin/qing-code

## Basic Information

- **Project Name**: QingCode
- **Description**: QingCode 是一款轻量原生的 Windows 桌面代码编辑器，面向需要同时维护多个本地项目的开发者。支持项目快速切换、文件浏览与管理、多标签编辑、内容搜索、多终端会话与运行配置，界面简洁、资源占用低，开箱即可使用
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QingCode

[English](./README.en.md)

**QingCode** 是 AI 开发时代下的**代码项目管理搭子**：把多项目切换、服务启动、终端现场和轻量编辑放进同一个 Windows 窗口。  
不是再做一个 VS Code / Zed，而是补上「同时盯多个项目、一键拉起前后端与工具链」这件事。

## 界面预览

### 资源管理器与编辑器

![资源管理器与代码编辑](./docs/screenshots/zh-01-explorer-editor.jpg)

### 全局搜索

![文件内容搜索](./docs/screenshots/zh-02-search.jpg)

### 源代码管理

![变更 / 历史、差异与提交](./docs/screenshots/zh-03-source-control.jpg)

### 运行配置

![运行配置与 .qingcode/run.json](./docs/screenshots/zh-04-run-config.jpg)

### 设置

![主题与字体等设置](./docs/screenshots/zh-05-settings.jpg)

### 项目管理

![添加、隐藏与管理本地项目](./docs/screenshots/zh-06-manage-projects.jpg)

## 为什么做 QingCode

写代码越来越常和 AI 结对（Cursor、Claude、OpenCode 等），真正拖慢节奏的往往不是「缺一个更重的 IDE」，而是：

- 本地同时挂着好几个仓库 / 业务目录，来回切窗口丢现场  
- 每个项目要起的服务一长串（API、前端、Worker、代理……）命令记不住、终端乱成一团  
- AI 助手、脚本和本机进程各自为政，项目管理仍靠自己拼凑  

QingCode 把重心放在**项目管理与运行现场**：多项目常驻、终端跟项目走、用运行配置一键拉起服务；编辑、搜索、看 Git 差异够用即可，复杂智能交给你已有的 AI 工具。

## 核心能力

### 多项目随手切换

把常用目录钉在标题栏，单击切换。每个项目自带文件树与终端；切走不会清掉未保存缓冲和终端现场。项目多了会自动收纳，也可保存为命名多项目工作区。

### 运行配置：管好项目里的服务启动

这是 QingCode 的核心工作流之一。为每个项目配置一组「运行配置」（保存在 `.qingcode/run.json`）：

- 一个配置可包含多个任务（命令 / 脚本 / ps1 / bat / sh）  
- 一键启动时，**每个任务开一个终端**，适合同时拉起 API、前端、Worker 等  
- 支持工作目录与环境变量；可停止整组配置  
- 陌生项目默认受限，信任后才能编辑、跑脚本和使用终端  

日常用法：打开项目 → 运行配置里点启动 → 服务进各自终端 → 再去改代码或把终端交给 AI CLI。

### 终端配置：默认环境与 AI / 工具入口

除了运行配置，还可管理**终端配置文件**（名称 + 启动命令）：

- 默认用 PowerShell，或一键进入自定义环境  
- 把常用 AI / 开发 CLI（如 `opencode`）写成配置，右键「+」选用  
- 终端默认落在项目根目录；换项目时已有终端不会被关掉  

运行配置管「项目服务怎么起」，终端配置管「这个壳默认跑什么」——两者一起，把本机多项目现场收拢到一处。

### 与 AI 协作：外挂助手，不内置模型

QingCode **不内置**聊天模型或 Agent，刻意把智能留给你已有的 Cursor / Claude / OpenCode 等工具，自己专注多项目与运行现场：

- **终端里跑 AI CLI**：用终端配置一键进入 `opencode` 等；运行配置拉起的服务终端也可直接交给助手操作  
- **复制给对话用**：资源管理器 / 编辑器可复制路径、相对路径或「文件引用」（含行号），方便贴进 AI 对话  
- **QingCode CLI + Skill**：设置 → **AI** →「复制 Skill 文本」，把可安装的 Skill 说明拷到剪贴板，按你 Agent 的方式自行安装（例如存成 `SKILL.md`）。Agent 可通过 `QingCode.exe` 子命令列/加项目、读写运行配置、在 GUI 已启动时切换项目、启停运行配置、授权信任、打开文件等（JSON 输出）。QingCode **不会**自动注册或适配任何 Agent  

典型配合：QingCode 管项目与服务 → AI 在终端或外部 IDE 里改代码 → 需要时用 CLI / 引用把现场接回 QingCode。

### 干净的文件树与轻量编辑

资源管理器只展示当前项目。可在树里新建、重命名、删除；复制路径、相对路径、文件引用，或「复制文件到剪贴板」粘到资源管理器 / 支持文件粘贴的应用；也可在指定目录打开终端或搜索。默认仍显示被 `.gitignore` 忽略的条目（可用 `explorer.excludeGitIgnore` 隐藏）。磁盘变更会自动刷新已展开目录，工具栏刷新同样会重扫展开子树。

多文件标签编辑，常见语言按需高亮；自动识别 UTF-8 / BOM / GB18030 兼容编码；外部改动可分类处理，避免悄悄覆盖。大文件会降级或只读预览。重启后恢复各项目的编辑与终端会话（打开项目时不再自动新建空终端）。

### 源代码管理：整页工作台

活动栏进入源代码管理后，主编辑区整页展示（再点一次回到资源管理器）：

- **变更**：区分已暂存 / 未暂存；支持单个或全部暂存与取消暂存、丢弃更改（二次确认）、提交已暂存内容，以及拉取 / 推送（使用已配置 upstream）  
- **历史**：浏览提交记录，查看变更文件与逐文件差异  
- 右侧内嵌 Diff；中文、空格、重命名路径按原始路径读取；拉取后若有冲突会提示，冲突解决仍在编辑器中完成  

复杂的分支整理、rebase、冲突合并器等仍可在你熟悉的 Git / AI 工具里完成。

### 搜索与定制

按范围搜文件名或文件内容；内容搜索默认收起替换区，需要时再展开。深色 / 浅色 / 森林 / 跟随系统；界面与代码字体可调；界面语言支持简体中文与 English。全局 `default-settings.json` 与项目 `.qingcode/project-settings.json` 为 **JSON5**，模板注释标明不得删除注释（详见 [帮助文档 · 设置](./帮助文档.md#设置)）。

## 和 VS Code / Zed 的关系

| | QingCode | VS Code | Zed |
|--|--|--|--|
| 定位 | 多项目运行与管理搭子 | 扩展生态平台编辑器 | 原生高性能编辑器 |
| 多项目切换 | 标题栏常驻，切走保留现场 | 偏单工作区 | 一般 |
| 服务 / 任务启动 | **运行配置多任务 → 多终端** | 任务 / launch 很强 | 有，形态不同 |
| LSP / 调试 / 扩展市场 | 不做重 IDE | 完整 | 强 LSP，生态更小 |
| AI | 不内置模型；终端配置 + CLI Skill 外挂助手 | 扩展或内置 | 内置向 |

QingCode **刻意不做**完整 IntelliSense、调试器和插件市场；你继续用 VS Code / Zed / Cursor 写深逻辑，用 QingCode 管「今天要开哪些项目、哪些服务、哪些终端」。

## 典型用法

1. 添加几个本地项目目录，钉在标题栏  
2. 为常用项目写好运行配置（例如 `dev` = API + Web）  
3. 需要时一键启动服务，终端按任务分开  
4. 用终端配置进入 AI CLI，或从设置复制 CLI Skill 给 Agent  
5. 在标题栏切到下一个项目——编辑与终端状态仍在  

## 适合谁

- 同时维护多个本地仓库，又要经常起停服务的人  
- 已经在用 AI 编程工具，需要一个更稳的本机项目 / 进程搭子  
- 不想为「切项目 + 起服务」再开一整套重型 IDE 的人  

## 获取应用

从 [GitHub Releases](https://github.com/Fracizz/QingCode/releases) 或 [Gitee Releases](https://gitee.com/FrancizTest_admin/qing-code/releases) 下载（打 `v*` 标签后由 CI 构建）：

| 平台 | 架构 | 推荐文件 |
|------|------|----------|
| Windows | x64 | `QingCode_*-windows-x64.exe` 或 `QingCode_*.exe` |
| Windows | ARM64 | `QingCode_*-windows-arm64.exe` |
| macOS | Apple Silicon (arm64) | `QingCode_*-macos-arm64.dmg` 或 `.zip` |

- Windows：便携 exe 或 NSIS 安装包（`*-setup.exe`）；需 [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/)（较新系统通常已预装）。安装包会先尝试自动下载安装；失败时可点「是」跳转引导程序下载，或「否」打开产品页  
- macOS：未签名时首次请右键 → 打开；需要 Apple Developer 签名/公证后再分发可跳过该步骤  

本地打包（Windows x64 本机）：

```bash
pnpm install
pnpm package                  # 本机 x64：NSIS 安装包（release/QingCode-setup.exe）
# pnpm package:exe            # 便携版单文件 exe
# pnpm package:fast           # 跳过前端/图标，仅重编 Rust
```

产物在 `release/`：`QingCode.exe`（便携）、`QingCode-setup.exe`（安装包）。ARM64 / macOS 等多架构发布走 GitHub Actions（`.github/workflows/release.yml`）。

## 从源码运行

环境：Node.js 22+、pnpm 10+、Rust stable；Windows 需 WebView2，macOS 需 Xcode CLT。

```bash
pnpm install
pnpm tauri:dev    # 完整桌面应用
```

更多约定见 [AGENTS.md](./AGENTS.md)；设置与语言说明见 [帮助文档.md](./帮助文档.md)。

## 技术栈

Tauri 2 · React 19 · TypeScript · Vite · CodeMirror 6 · xterm.js · Zustand · Tailwind CSS · Rust

## 许可证

[MIT](./LICENSE)