# xdeck

**Repository Path**: juuen/xdeck

## Basic Information

- **Project Name**: xdeck
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-18
- **Last Updated**: 2026-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XDeck

专为 CLI 爱好者打造的 AI 编程工作台。融合命令行高效体验与 AI 编辑器的智能能力，打通割裂工作流、告别工具来回切换，打造简洁干净、纯粹顺手的开发环境。

## 特性

- **目录树**：对标 VS Code 视觉，类型图标、缩进参考线；遵循 `.gitignore`，被忽略项灰显。
- **混排标签**：终端（原生 PTY，默认 PowerShell）与文件标签同栏排布；文件支持代码 / Markdown / 纯文本预览，二进制给出提示。
- **双栏布局**：最多两栏，标签可在栏间拖拽迁移；终端 PTY 不重启、文件不重载。
- **就地运行**：根目录右键「启动项目」执行 `package.json` 的 `dev` / `start` 脚本，附只读运行日志，支持停止与重启。
- **Git 着色**：改动 / 未跟踪分色标记，颜色沿父链上推；忽略项保持灰色，不抢占变更色。
- **路径拖放**：从资源管理器把文件 / 文件夹拖进终端，仅插入绝对路径，不自动执行。
- **一键刷新**：外部改动后刷新目录，自动重读、重查 Git、重建监听，保留展开态、选中行与滚动位置。
- **可调节侧边栏**：拖拽左栏分隔线改宽，配置自动记忆。
- **界面风格**：全黑主题，Windows Terminal 字形与 Campbell 配色，无边框窗口 + 自绘拖拽区；终端后端复用 ConPTY。

## 安装

两种渠道，装出的是同一个 XDeck：

| 渠道 | 适合人群 | 安装方式 |
| ---- | ---- | ---- |
| Windows 安装包 | 普通使用者（目标机无需 Node） | 双击 `xdeck Setup <版本>.exe`，当前用户安装，无需管理员权限，装完自动起窗 |
| npm 公开包 | 开发者（需 Node ≥ 24） | `npm i -g xdeck`，然后执行 `xdeck` |

> 终端标签里跑的 thincoder CLI：安装包在**有 Node ≥ 24 且机器上还没有它**时会顺手装上（取最新版，约多等 2 分钟；已装则不动）。**没有 Node、或 Node 版本低于 24 的机器不装也不提示** —— 那种机器上要自己准备它。
> 安装包未做代码签名，Windows SmartScreen 会先拦截：点「更多信息」→「仍要运行」。

## 快速开始

左侧目录树的根来自**上次打开的那个项目** —— 没打开过任何项目时左栏为空（不推任何默认）。

- **打开文件夹**：在目录树空白处右键 →「打开文件夹…」，选一个项目文件夹；左栏只留这一个根，应用记住它，下次启动恢复。
- **打开工作区文件**：在目录树空白处右键 →「打开工作区文件…」，选一份 `.code-workspace`；左栏按它的 `folders` 列根，应用记住它，下次启动恢复。

展开一个目录就会列出它下面的全部子目录与文件，不需要单独添加。

启动方式：双击安装包 / 命令行 `xdeck` / 源码 `npm install && npm start`。启动后左栏为工作区目录树，右栏自动打开终端标签（cwd = 第一个根）。

## 源码运行（贡献者）

项目 Windows 优先，Linux 支持后续迭代。

前置依赖：

- Node ≥ 24
- thincoder CLI 已在 PATH 上，`thincoder --version` 可正常输出
- Windows PowerShell

```powershell
npm install
npm start
```

`npm start` 即 `electron .`。

打包安装包：

```powershell
npm run dist:win
```

产物输出到 `dist/`：`xdeck Setup <版本>.exe`，版本号取自 `package.json`。