# 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-29

## 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`）写成配置，右键「+」选用  
- 终端默认落在项目根目录；换项目时已有终端不会被关掉  

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

### 面板布局：经典底栏或侧栏多列

标题栏提供**面板布局**菜单（快捷键可循环），默认是**经典布局**（终端在底部）。也可切到侧栏旁工作区：

| 布局 | 说明 |
|------|------|
| 经典布局（终端在底部） | 编辑器为主，终端可拖高度 |
| 终端+编辑器 | 侧栏旁单终端 \| 编辑器，默认可拖成约 1:1 |
| 双终端+编辑器 | 终端 A \| 终端 B \| 编辑器，默认约 1:1:1；中间与右侧分隔都可拖（约 10%–90%） |

双终端两侧各自有标签栏，标签过多时用下拉查看全部。侧栏布局下可在顶栏布局按钮左侧开关双终端或隐藏编辑器；打开文件 / 源代码管理 / 设置时会显示编辑器列，但不会关掉双终端。

### 与 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` 忽略的内容；可用 `files.exclude` 或 `explorer.excludeGitIgnore` 按需隐藏。磁盘变更会自动刷新已展开目录，工具栏刷新同样会重扫展开子树。

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

编辑器内置不依赖完整 LSP 的轻量代码导航：按住 `Ctrl` 时标记可跳转符号，`Ctrl+单击` 解析并跳到定义，落点稳定后自动执行一次查找用法；`Shift+F12` 也可独立在可拖动的半透明浮层中按调用者或文件分组查找调用、读取、写入和导入位置，`Ctrl+T` 按名称搜索工作区符号。Tree-sitter 增量索引会识别常见作用域、遮蔽和项目内模块关系，包括 TS/JS 路径别名与 re-export、Python 包转发、Java import、Rust `use`、Go module/import；无法精确判定的结果会明确标为近似。

它适合日常读代码、跨文件跟调用和快速定位；和 IDEA 相比，不做编译器级类型分析、安全重命名 / 重构或调试，复杂语言语义仍建议回到 IDEA 等完整 IDE。Python、TypeScript/JavaScript、Java、Rust、Go 拆成五个独立语言组件；Windows 安装包可逐项勾选，未安装的语言只会关闭该语言的语义导航，不影响普通文本编辑。

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

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

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

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

### 搜索与定制

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

## 日常使用：和 IDEA / VS Code / Zed 的差异

| 日常场景 | QingCode | IDEA | VS Code | Zed |
|--|--|--|--|--|
| 最适合做什么 | 同时管多个项目、服务和终端现场 | 深度开发、重构、调试 | 按扩展拼装的通用开发 | 轻快编辑与 LSP 开发 |
| 切项目后 | 标题栏常驻，编辑与终端现场保留 | 以项目 / 窗口为中心 | 以工作区为中心 | 以工作区为中心 |
| 代码导航 | Tree-sitter：定义、引用、符号；有近似结果提示 | 编译器级语义、重构与调试 | 主要随语言服务器和扩展而定 | 主要随语言服务器而定 |
| 扩展与 AI | 无市场、不内置模型；终端 + CLI 对接外部助手 | 插件生态与 AI 插件 | 扩展生态最广 | 内置 AI 倾向、生态较小 |

常见搭配：先在 QingCode 一键启动 API、前端和 Worker，切项目时保留现场；需要类型推断、重构或断点调试时，再用 IDEA / VS Code / Zed 打开同一仓库。QingCode **刻意不做**完整 IntelliSense、调试器和插件市场。

## 典型用法

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-setup.exe`（推荐）或便携 `.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)