zen-gitsync 2.12.7 → 2.12.9

package/README.md

@@ -21,6 +21,7 @@ A Git automation platform with interactive commits, scheduled sync, custom comma
   - [Project Startup](#project-startup)
   - [Built-in Code Editor](#built-in-code-editor)
   - [Source Map](#source-map-ai-codebase-visualization)
+  - [Workbench](#workbench-task-driven-claude-execution)
   - [Settings](#settings)
 - [CLI Commands](#cli-commands)
 
@@ -50,7 +51,10 @@ npm install -g zen-gitsync
 - **Project startup** — Auto-run commands or workflows when a project opens
 - **Built-in code editor** — Monaco-based file editor with Markdown preview
 - **Source map** — AI-generated interactive codebase dependency graph
+- **Workbench** — task-driven Claude execution with prompt presets, subtask splitting, isolated bypass-permissions windows, live stdout streaming, AI-generated presets, and sub-task file attachments
+- **Reset to remote** — One-click `git reset --hard origin/<branch>` from the Git panel (auto-refreshes branch info first to avoid wrong-target resets)
 - **AI commit message** — Generate commit message from staged diff automatically
+- **Selection-scoped diff** — AI commit message and quick commit/push use only the diff of currently selected files when the Git view is the active tab
 - **Commit templates** — Save type/scope/description/message templates
 - **Theme & language** — Light/dark theme and Chinese/English UI
 
@@ -65,7 +69,7 @@ $ g ui
 
 ![ui](https://raw.githubusercontent.com/xz333221/zen-gitsync/main/public/images/zen-gitsync-ui-git.png)
 
-The GUI runs as a local web server and opens in your default browser. It attaches to the current Git repository automatically. The activity bar on the left switches between three views: **Git**, **Editor**, and **Source Map**.
+The GUI runs as a local web server and opens in your default browser. It attaches to the current Git repository automatically. The activity bar on the left switches between four views: **Git**, **Editor**, **Source Map**, and **Workbench**.
 
 ---
 
@@ -83,6 +87,7 @@ The GUI runs as a local web server and opens in your default browser. It attache
 | Push | Push to remote with live progress modal |
 | Quick commit+push | One-click stage → commit → push |
 | Pull / Fetch | Pull from or fetch the upstream branch |
+| Reset to remote | One-click `git reset --hard origin/<branch>`; auto-refreshes branch info first to avoid stale-branch targets; hidden when working tree is clean and no unpushed commits |
 | Merge | Merge another branch; detects and surfaces in-progress merge state |
 | Diff viewer | Monaco-based side-by-side diff for any changed file |
 | Commit log | Browse commit history with author, date, branch tags, and changed files |
@@ -232,6 +237,29 @@ Configure the model endpoint, API key, and model name in **Settings → AI**.
 
 ---
 
+### Workbench (Task-Driven Claude Execution)
+
+A dedicated view (fourth icon in the activity bar) for batch-running Claude against your repo. Define a task, split it into ordered subtasks, attach a reusable prompt preset, then click **Run task** — each subtask launches in its own terminal window with `claude --permission-mode bypassPermissions`, so context never piles up.
+
+| Feature | Description |
+|---|---|
+| Task list | Create, edit, delete tasks; each shows its subtask count |
+| Subtask breakdown | Add / edit / remove subtasks per task, with per-subtask status |
+| Subtask attachments | Attach up to 9 files per subtask (image / PDF / text / Markdown / CSV / JSON / log, ≤ 5 MB each); their absolute paths are appended to the prompt so Claude reads them directly |
+| Prompt presets | Reusable prompt templates with `{{task.title}}` / `{{task.desc}}` / `{{sub.title}}` / `{{sub.desc}}` / `{{repo.path}}` / `{{branch}}` variable interpolation |
+| AI prompt generation | "New / Edit preset" dialog has an **AI Generate** button — the server reads the current project tree (depth 2) + README + manifests (package.json / pyproject.toml / go.mod / Cargo.toml / …) and asks the configured LLM to draft a project-aware preset (name + body) |
+| Per-subtask override | Override the preset's content for a specific subtask in its description field |
+| Sequential execution | Runs subtasks in declared order; the next one starts only after the previous process exits |
+| Pipe-mode launcher | Spawns `claude -p "<prompt>" --output-format text --permission-mode bypassPermissions --dangerously-skip-permissions` with stdout/stderr piped to the server — no external terminal window is opened, so output streams directly into the UI |
+| Isolated windows | Every subtask runs as its own detached process with fresh context, so memory and conversation state never accumulate across subtasks |
+| Live log | Each running subtask has an expandable "执行日志 / Execution log" panel that auto-scrolls and shows accumulated `stdout` + `stderr` (capped at 256 KB server-side, last 64 KB rendered client-side) |
+| Live status | Subtask status (todo / pending / running / done / error) and PID stream in real time over SSE |
+| Cross-view indicator | While any Workbench subtask is running, a pulsing dot appears on the Workbench icon in the Activity Bar so you can see job state from the Git or Editor view |
+
+Prompt presets and tasks are persisted to `~/.zen-gitsync/prompts.json` and `~/.zen-gitsync/tasks.json` (cross-project, shared across repos).
+
+---
+
 ### Settings
 
 | Setting | Description |
@@ -371,6 +399,7 @@ $ g --check-lock=config.json
   - [项目启动](#项目启动)
   - [内置代码编辑器](#内置代码编辑器)
   - [源码地图](#源码地图ai-代码库可视化)
+  - [工作台](#工作台任务驱动的-claude-执行)
   - [设置](#设置)
 - [命令行](#命令行)
 
@@ -400,7 +429,10 @@ npm install -g zen-gitsync
 - **项目启动** — 打开项目时自动运行命令或工作流
 - **内置代码编辑器** — 基于 Monaco 的文件编辑器，支持 Markdown 预览
 - **源码地图** — AI 生成的交互式代码库依赖关系图
+- **工作台** — 任务驱动的 Claude 执行视图：提示词预置、子任务拆分、独立 bypass-permissions 进程、stdout 实时回传、AI 自动生成预置提示词、子任务附件
+- **重置到远程** — 在 Git 面板一键执行 `git reset --hard origin/<branch>`（点击前会先自动刷新分支信息，避免重置到陈旧分支）
 - **AI 生成提交信息** — 基于 staged diff 自动生成提交消息
+- **选择模式差异** — 当 Git 视图为当前激活标签时，AI 生成提交信息与一键提交/推送仅作用于当前勾选文件的 diff
 - **提交模板** — 保存类型/范围/描述/完整提交信息模板
 - **主题与语言** — 支持明/暗主题，中英文界面切换
 
@@ -415,7 +447,7 @@ $ g ui
 
 ![ui](https://raw.githubusercontent.com/xz333221/zen-gitsync/main/public/images/zen-gitsync-ui-git.png)
 
-GUI 以本地 Web 服务器形式运行，自动在浏览器中打开，并附加到当前 Git 仓库。左侧 Activity Bar 可在三个视图之间切换：**Git**、**编辑器**、**源码地图**。
+GUI 以本地 Web 服务器形式运行，自动在浏览器中打开，并附加到当前 Git 仓库。左侧 Activity Bar 可在四个视图之间切换：**Git**、**编辑器**、**源码地图**、**工作台**。
 
 ---
 
@@ -433,6 +465,7 @@ GUI 以本地 Web 服务器形式运行，自动在浏览器中打开，并附
 | 推送 | 推送到远程，实时显示进度弹窗 |
 | 快速提交+推送 | 一键完成暂存 → 提交 → 推送 |
 | 拉取 / Fetch | 从上游拉取或仅获取远程信息 |
+| 重置到远程 | 一键执行 `git reset --hard origin/<branch>`；点击前会先刷新分支信息，避免重置到陈旧分支；当工作区干净且无未推送提交时按钮自动隐藏 |
 | 合并 | 合并其他分支，自动检测并引导处理合并中间状态 |
 | Diff 查看器 | 基于 Monaco 编辑器的并排文件差异视图 |
 | 提交日志 | 浏览历史提交（作者、时间、分支标签、变更文件） |
@@ -582,6 +615,29 @@ Activity Bar 第三个视图，调用 AI 模型将项目代码库生成可交互
 
 ---
 
+### 工作台（任务驱动的 Claude 执行）
+
+Activity Bar 第四个视图，用于在当前仓库上批量调度 Claude：定义任务、拆成有序子任务、绑定可复用的提示词预置，点 **执行任务** 后按顺序依次执行。
+
+| 功能 | 说明 |
+|---|---|
+| 任务列表 | 新建、编辑、删除任务；每条任务显示子任务数量 |
+| 子任务拆分 | 增删改子任务，实时显示每个子任务的执行状态 |
+| 子任务附件 | 每个子任务最多挂 9 个附件（图片 / PDF / 文本 / Markdown / CSV / JSON / log，单个 ≤ 5 MB）；执行时绝对路径会自动追加到 prompt 末尾，Claude 直接按路径读取 |
+| 提示词预置 | 可复用提示词模板，支持 `{{task.title}}` / `{{task.desc}}` / `{{sub.title}}` / `{{sub.desc}}` / `{{repo.path}}` / `{{branch}}` 变量插值 |
+| AI 生成预置 | 「新建 / 编辑预置」对话框内置 **AI 生成项目架构说明** 按钮 + **编辑指令** 按钮：服务端递归识别当前项目里的所有子项目（含 `.git` 或 9 种 manifest 之一的目录），为每个子项目独立读取关键文件（manifest 20 KB / README 8 KB / 2 层目录树），并发调 LLM 产出各子项目架构说明，多子项目场景再合并成一份整体说明；用户可点「编辑指令」自定义生成策略（持久化到 `~/.zen-gitsync/ai-instruction.json`）；`max_tokens=4000`，单次请求最多 20 分钟 |
+| 子任务覆盖 | 在子任务描述框可独立覆盖预置提示词的内容 |
+| 顺序执行 | 按声明顺序依次执行子任务；上一个进程退出后才启动下一个 |
+| 管道模式启动 | 直接以 `claude -p "<prompt>" --output-format text --permission-mode bypassPermissions --dangerously-skip-permissions` 拉起进程，stdout / stderr 通过管道回传服务端，不再弹外部终端窗口 |
+| 独立上下文 | 每个子任务都是独立的 detached 进程，上下文与状态不会跨子任务累积 |
+| 实时日志 | 正在执行的子任务可展开「执行日志」面板，自动滚到底，展示累积的 stdout / stderr（服务端缓存 256 KB，客户端渲染最近 64 KB） |
+| 实时状态 | 子任务状态（todo / pending / running / done / error）和 PID 通过 SSE 实时推送 |
+| 跨视图指示 | 任意子任务运行中时，Activity Bar 上的工作台图标会显示脉动小圆点；切换到 Git 或编辑器视图也能看到运行状态 |
+
+提示词预置与任务数据持久化到 `~/.zen-gitsync/prompts.json` 和 `~/.zen-gitsync/tasks.json`（跨项目共享）。子任务附件落盘在 `~/.zen-gitsync/workbench-images/<subId>/`。
+
+---
+
 ### 设置
 
 | 设置项 | 说明 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-gitsync",
-  "version": "2.12.7",
+  "version": "2.12.9",
   "description": "Auto commit, scheduled sync, and visual GUI for Git. Run `g` in any repo for one-key commit & push, AI commit messages, scheduled background sync, and a drag-and-drop workflow builder.",
   "main": "index.js",
   "type": "module",

package/scripts/README_COLOR_CONVERTER.md

@@ -1,196 +1,196 @@
-# 颜色值转换工具使用说明
-
-## 功能说明
-
-该脚本将项目中硬编码的十六进制颜色值转换为标准的 CSS 变量引用。
-
-## 颜色映射规则
-
-基于项目中的 `src/ui/client/src/styles/variables.scss` 定义：
-
-### 主色调
-- `#409eff` → `var(--color-primary)`
-- `#5a67d8`, `#66b1ff` → `var(--color-primary-light)`
-- `#337ecc` → `var(--color-primary-dark)`
-
-### 成功色
-- `#67c23a` → `var(--color-success)`
-- `#10b981` → `var(--color-success-light)`
-
-### 警告色
-- `#e6a23c` → `var(--color-warning)`
-- `#f59e0b` → `var(--color-warning-light)`
-
-### 危险色
-- `#f56c6c` → `var(--color-danger)`
-- `#ef4444` → `var(--color-danger-light)`
-- `#dc2626` → `var(--color-danger-dark)`
-
-### 信息色
-- `#909399` → `var(--color-info)`
-- `#8b5cf6` → `var(--color-info-light)`
-
-### 文字颜色
-- `#303133` → `var(--text-primary)`
-- `#606266` → `var(--text-secondary)`
-- `#909399` → `var(--text-tertiary)`
-- `#c0c4cc`, `#a8abb2` → `var(--text-placeholder)`
-
-### Git 状态颜色
-- `#10b981` → `var(--git-status-added)`
-- `#f59e0b` → `var(--git-status-modified)`
-- `#ef4444` → `var(--git-status-deleted)`
-- `#8b5cf6` → `var(--git-status-untracked)`
-
-## 使用方法
-
-### 预览模式（推荐先运行）
-
-```bash
-# 预览将要进行的更改，不修改文件
-node scripts/convert-colors-to-vars.cjs --dry-run
-```
-
-### 实际应用
-
-```bash
-# 应用更改到文件
-node scripts/convert-colors-to-vars.cjs
-```
-
-## 转换示例
-
-**转换前：**
-```vue
-<style>
-.button {
-  background: #409eff;
-  color: #ffffff;
-  border: 1px solid #66b1ff;
-}
-
-.success-button {
-  background: #67c23a;
-}
-
-.text {
-  color: #303133;
-}
-</style>
-```
-
-**转换后：**
-```vue
-<style>
-.button {
-  background: var(--color-primary);
-  color: var(--color-white);
-  border: 1px solid var(--color-primary-light);
-}
-
-.success-button {
-  background: var(--color-success);
-}
-
-.text {
-  color: var(--text-primary);
-}
-</style>
-```
-
-## 支持的文件类型
-
-- `.vue` - Vue 单文件组件
-- `.scss` - Sass 样式文件
-- `.css` - 纯 CSS 文件
-
-## 跳过的文件
-
-脚本会自动跳过以下文件（这些文件定义了变量本身）：
-- `variables.scss`
-- `dark-theme.scss`
-
-同时自动跳过以下目录：
-- `node_modules`
-- `.git`
-- `dist`
-
-## 输出报告
-
-执行完成后会显示详细的统计报告：
-
-```
-📊 转换统计报告
-============================================================
-总文件数: 150
-修改文件数: 42
-总替换次数: 289
-
-📋 替换详情:
-  #409eff => var(--color-primary): 78 次
-  #67c23a => var(--color-success): 45 次
-  #f56c6c => var(--color-danger): 32 次
-  ...
-
-⚠️  未映射的颜色（需要手动检查）:
-  #f8faff
-  #eef4ff
-  ...
-```
-
-## 注意事项
-
-1. **备份建议**：运行脚本前建议先使用 `--dry-run` 参数预览更改
-2. **Git 提交**：建议在运行前提交当前代码，方便回滚
-3. **未映射颜色**：脚本会列出未映射的颜色，需要手动检查这些颜色是否需要添加到映射表
-4. **特殊颜色**：某些渐变色或特殊效果的颜色可能需要保留原值
-5. **rgba 颜色**：当前脚本仅处理十六进制颜色值，rgba 格式需要手动处理
-
-## 优势
-
-使用 CSS 变量替代硬编码颜色的好处：
-
-1. **统一管理**：所有颜色在 `variables.scss` 中统一定义
-2. **主题切换**：轻松实现深色主题等样式变体
-3. **易于维护**：修改变量值即可全局更新
-4. **语义化**：变量名更具可读性（如 `--color-success` vs `#67c23a`）
-5. **一致性**：确保整个项目使用统一的配色方案
-
-## 扩展映射表
-
-如果发现新的颜色值需要映射，编辑脚本中的 `COLOR_MAP` 对象：
-
-```javascript
-const COLOR_MAP = {
-  // 添加新的映射
-  '#your-color': 'var(--your-variable)',
-  // ...
-};
-```
-
-## 回滚方法
-
-如果需要回滚更改：
-
-```bash
-# 如果还未提交
-git checkout -- src/
-
-# 如果已提交
-git revert <commit-hash>
-```
-
-## 与其他脚本配合
-
-该脚本可以与其他样式标准化脚本配合使用：
-
-```bash
-# 1. 转换间距值
-node scripts/convert-spacing-to-vars.cjs
-
-# 2. 转换圆角和阴影
-node scripts/convert-to-standard-vars.js
-
-# 3. 转换颜色值
-node scripts/convert-colors-to-vars.cjs
-```
+# 颜色值转换工具使用说明
+
+## 功能说明
+
+该脚本将项目中硬编码的十六进制颜色值转换为标准的 CSS 变量引用。
+
+## 颜色映射规则
+
+基于项目中的 `src/ui/client/src/styles/variables.scss` 定义：
+
+### 主色调
+- `#409eff` → `var(--color-primary)`
+- `#5a67d8`, `#66b1ff` → `var(--color-primary-light)`
+- `#337ecc` → `var(--color-primary-dark)`
+
+### 成功色
+- `#67c23a` → `var(--color-success)`
+- `#10b981` → `var(--color-success-light)`
+
+### 警告色
+- `#e6a23c` → `var(--color-warning)`
+- `#f59e0b` → `var(--color-warning-light)`
+
+### 危险色
+- `#f56c6c` → `var(--color-danger)`
+- `#ef4444` → `var(--color-danger-light)`
+- `#dc2626` → `var(--color-danger-dark)`
+
+### 信息色
+- `#909399` → `var(--color-info)`
+- `#8b5cf6` → `var(--color-info-light)`
+
+### 文字颜色
+- `#303133` → `var(--text-primary)`
+- `#606266` → `var(--text-secondary)`
+- `#909399` → `var(--text-tertiary)`
+- `#c0c4cc`, `#a8abb2` → `var(--text-placeholder)`
+
+### Git 状态颜色
+- `#10b981` → `var(--git-status-added)`
+- `#f59e0b` → `var(--git-status-modified)`
+- `#ef4444` → `var(--git-status-deleted)`
+- `#8b5cf6` → `var(--git-status-untracked)`
+
+## 使用方法
+
+### 预览模式（推荐先运行）
+
+```bash
+# 预览将要进行的更改，不修改文件
+node scripts/convert-colors-to-vars.cjs --dry-run
+```
+
+### 实际应用
+
+```bash
+# 应用更改到文件
+node scripts/convert-colors-to-vars.cjs
+```
+
+## 转换示例
+
+**转换前：**
+```vue
+<style>
+.button {
+  background: #409eff;
+  color: #ffffff;
+  border: 1px solid #66b1ff;
+}
+
+.success-button {
+  background: #67c23a;
+}
+
+.text {
+  color: #303133;
+}
+</style>
+```
+
+**转换后：**
+```vue
+<style>
+.button {
+  background: var(--color-primary);
+  color: var(--color-white);
+  border: 1px solid var(--color-primary-light);
+}
+
+.success-button {
+  background: var(--color-success);
+}
+
+.text {
+  color: var(--text-primary);
+}
+</style>
+```
+
+## 支持的文件类型
+
+- `.vue` - Vue 单文件组件
+- `.scss` - Sass 样式文件
+- `.css` - 纯 CSS 文件
+
+## 跳过的文件
+
+脚本会自动跳过以下文件（这些文件定义了变量本身）：
+- `variables.scss`
+- `dark-theme.scss`
+
+同时自动跳过以下目录：
+- `node_modules`
+- `.git`
+- `dist`
+
+## 输出报告
+
+执行完成后会显示详细的统计报告：
+
+```
+📊 转换统计报告
+============================================================
+总文件数: 150
+修改文件数: 42
+总替换次数: 289
+
+📋 替换详情:
+  #409eff => var(--color-primary): 78 次
+  #67c23a => var(--color-success): 45 次
+  #f56c6c => var(--color-danger): 32 次
+  ...
+
+⚠️  未映射的颜色（需要手动检查）:
+  #f8faff
+  #eef4ff
+  ...
+```
+
+## 注意事项
+
+1. **备份建议**：运行脚本前建议先使用 `--dry-run` 参数预览更改
+2. **Git 提交**：建议在运行前提交当前代码，方便回滚
+3. **未映射颜色**：脚本会列出未映射的颜色，需要手动检查这些颜色是否需要添加到映射表
+4. **特殊颜色**：某些渐变色或特殊效果的颜色可能需要保留原值
+5. **rgba 颜色**：当前脚本仅处理十六进制颜色值，rgba 格式需要手动处理
+
+## 优势
+
+使用 CSS 变量替代硬编码颜色的好处：
+
+1. **统一管理**：所有颜色在 `variables.scss` 中统一定义
+2. **主题切换**：轻松实现深色主题等样式变体
+3. **易于维护**：修改变量值即可全局更新
+4. **语义化**：变量名更具可读性（如 `--color-success` vs `#67c23a`）
+5. **一致性**：确保整个项目使用统一的配色方案
+
+## 扩展映射表
+
+如果发现新的颜色值需要映射，编辑脚本中的 `COLOR_MAP` 对象：
+
+```javascript
+const COLOR_MAP = {
+  // 添加新的映射
+  '#your-color': 'var(--your-variable)',
+  // ...
+};
+```
+
+## 回滚方法
+
+如果需要回滚更改：
+
+```bash
+# 如果还未提交
+git checkout -- src/
+
+# 如果已提交
+git revert <commit-hash>
+```
+
+## 与其他脚本配合
+
+该脚本可以与其他样式标准化脚本配合使用：
+
+```bash
+# 1. 转换间距值
+node scripts/convert-spacing-to-vars.cjs
+
+# 2. 转换圆角和阴影
+node scripts/convert-to-standard-vars.js
+
+# 3. 转换颜色值
+node scripts/convert-colors-to-vars.cjs
+```