# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## [Unreleased]

### Agent Electron Client

#### Fixed
- **Removed legacy `guiAgent:*` Unix-socket service path** — desktop GUI automation now uses the standard local MCP HTTP service path (`guiServer:*`) only.

---

## [0.2.0] - 2026-02-23

### Agent Electron Client

#### Added
- **多平台打包** — uv/lanproxy 按平台准备，prepare-sdk 解决 file: 依赖符号链接问题，支持在 macOS 上打包 Windows（清理 Electron 缓存可修复 zip 报错）
- **clean:electron-cache** — 清理 Electron/electron-builder 缓存脚本，修复「zip: not a valid zip file」

#### Changed
- **Vite emptyOutDir: false** — 避免 renderer 构建清空 dist 导致主进程入口缺失
- **prepare-uv 下载** — 使用固定文件名避免重定向 URL 过长

---

## [0.1.x]

### Changed

#### Agent 管理统一走 SDK
- **移除旧版 Agent spawn 方案** — 删除 `agentProcess` 变量及 `agent:start/stop/status/send` 4 个 IPC handler（~170 行），所有 Agent 生命周期统一通过 `UnifiedAgentService`（`agentService`）管理
- **`agent:init` 增强** — 自动从 `McpProxyManager.getAgentMcpConfig()` 注入 MCP 配置；返回值新增 `engineType`
- **新增 `agent:serviceStatus` IPC** — 返回 `{ running, engineType }`，替代旧版 `agent:status`
- **`AgentConfig` 扩展** — 新增 `env`（自定义环境变量）和 `mcpServers`（MCP 服务器配置）字段
- **`OpencodeEngine.init()` 支持 MCP** — 通过 `config.mcp.servers` 将 MCP 配置传入 `createOpencode()`
- **`ClaudeCodeEngine.prompt()` 支持自定义 env** — 合并 `config.env` 到 spawn 环境
- **ClientPage / AgentSettings / setup.ts** — 全部迁移到 `agent.init()` / `agent.destroy()` / `agent.serviceStatus()`
- **preload.ts** — 移除 `start/stop/status/send` bridge，新增 `serviceStatus`
- **electron.d.ts** — 移除旧版类型，新增 `serviceStatus` 和 `env/mcpServers` 字段

### Fixed

#### Process Management
- **Separated `agentProcess` from `agentRunnerProcess`** — `agent:start/stop/status/send` previously shared the same `agentRunnerProcess` variable as `agentRunner:*` handlers, meaning starting either service would clobber the other
- **Never-resolving promises in process start** — `lanproxy:start`, `agentRunner:start`, `agent:start` setTimeout callbacks lacked an else branch; if the process exited within the timeout, the IPC promise would hang forever
- **Hard-coded ports in `agentRunner:status`** — Ports 60001/60002 were hard-coded instead of using the actual ports passed to `agentRunner:start`

#### Dependency Installation
- **npm `--save --no-save` flag contradiction** — `installNpmPackage()` passed both `--save` and `--no-save` to npm; `--no-save` won, so packages weren't tracked in `package.json`, and npm 7+ auto-pruned previously-installed packages during subsequent installs. Only the last-installed package survived.
- **`packageLocator.ts` used `process.cwd()` instead of `os.homedir()`** — In Electron main process, `process.cwd()` points to the app bundle directory, not the user's home. This caused `mcp.ts`'s `isInstalledLocally()` to look for packages in the wrong directory.

#### Settings & Storage
- **`settings:set` stored `"null"` string for null values** — When clearing a setting with `null`, the handler inserted `JSON.stringify(null)` = `"null"` into SQLite. Now uses `DELETE` for null/undefined values.
- **`parseInt` without NaN check** — `mcp:getPort` and MCP initialization parsed port strings without validating the result, potentially passing `NaN` to `setPort()`.

#### MCP Service
- **`getMcpProxyBinPath` returned system fallback instead of null** — When `mcp-proxy` wasn't installed locally, the method returned the bare binary name as fallback, causing the `if (!binPath)` guard in `start()` to never trigger. Now returns `null` to surface clear errors.
- **Shallow copy of `DEFAULT_MCP_PROXY_CONFIG`** — The spread operator `{ ...DEFAULT_MCP_PROXY_CONFIG }` only shallow-copied; the nested `mcpServers` object was shared between the default and the instance. Now uses deep copy.

#### UI
- **Login form validation never fired** — `Form.Item` had `rules` but no `name` prop, so Ant Design validation was silently skipped. Replaced with explicit `message.warning()` for each empty field.

### Changed

#### Data Directory Unification
- **Unified data directory** — All data now stored under `~/.qiming-agent/`
  - SQLite database moved from `app.getPath('userData')` to `~/.qiming-agent/qiming-agent.db`
  - Dependencies service (`dependencies.ts`) `getAppDataDir()` now returns `~/.qiming-agent/`
  - Eliminates split between `~/Library/Application Support/...` and `~/.qiming-agent/`

#### Bundled uv
- **uv bundled into Electron** — No longer requires system-wide uv installation
  - uv binary shipped via `extraResources` → `resources/uv/bin/`
  - New `getResourcesPath()` resolves `process.resourcesPath` (packaged) or `resources/` (dev)
  - New `getUvBinPath()` returns platform-specific bundled uv path
  - `checkUvVersion()` prefers bundled uv, falls back to system uv
  - uv dependency type changed from `"system"` to `"bundled"` in `SETUP_REQUIRED_DEPENDENCIES`
  - DependenciesPage shows "已集成" when bundled uv is detected

#### Dependency Environment Injection
- **App-internal dependency paths injected into all child processes**
  - New `getAppEnv()` builds env vars with `~/.qiming-agent/node_modules/.bin`, `~/.qiming-agent/bin`, and `resources/uv/bin` prepended to `PATH`
  - `NODE_PATH` set to `~/.qiming-agent/node_modules`
  - Applied to: file server, agent runner, lanproxy, agent, engine manager spawns
  - `engineManager.ts` `createIsolatedEnvironment()` also injects app-internal paths

#### Node.js Detection Removed
- **Node.js no longer checked as system dependency** — Electron bundles its own Node runtime
  - DependenciesPage shows Electron built-in Node.js version with "已集成 (Electron)" status
  - `systemDepsReady` no longer depends on Node.js check

### Added
- `"bundled"` type added to `LocalDependencyType`
- `getResourcesPath()`, `getUvBinPath()`, `getAppEnv()` exported from `dependencies.ts`
- `_checkUvBin()` helper for checking a specific uv binary path
- `checkUvVersion()` now returns `bundled` flag and `binPath`
- **Agent Runner** added to ClientPage service dashboard (4 services total)
- `resources/uv/bin/uv` — bundled uv binary for macOS (CI/CD provides other platforms)
- `package.json` `build.extraResources` includes `resources/uv`

---

## [0.1.0] - 2026-02-22

### Added

#### Core Architecture
- **Electron Client** - Cross-platform desktop application
- **Multi-Agent Engine Support** - Support for claude-code and qimingcode
- **Session-Based Workspace** - Each conversation has its own workspace

#### Agent Engine Management
- **Engine Manager** (`engineManager.ts`)
  - Local installation of engines
  - Environment variable isolation
  - Configuration isolation
  - HOME/XDG_CONFIG_HOME redirection

- **Shell Environment** (`shellEnv.ts`)
  - Cross-platform support (Windows/macOS/Linux)
  - Shell detection (zsh/bash/PowerShell)
  - Essential tool detection
  - PATH management

- **Workspace Manager** (`workspaceManager.ts`)
  - User-specified workspace directories
  - Workspace validation
  - Configuration persistence

#### Dependency Management
- **Dependencies Service** (`dependencies.ts`)
  - Local npm package management
  - Version detection
  - Required dependencies:
    - uv (Python package manager)
    - qiming-file-server (File service)
    - qimingcode (Agent engine)

#### MCP Management
- **MCP Service** (`mcp.ts`)
  - Local installation (isolated from system)
  - Version detection
  - Package location tracking

#### Services
- **Setup Wizard** - 3-step configuration
- **Login/Logout** - Authentication with SQLite storage
- **File Server** - Local file service
- **Lanproxy** - Intranet penetration
- **Skills Sync** - Remote skills synchronization
- **IM Integration** - Instant messaging
- **Scheduler** - Task scheduling

### Changed

- Removed Zed ACP (rcoder)方案
- Removed claude-code-acp-ts dependency
- Node.js detection (built into Electron, no separate installation needed)
- Updated dependency list to match Electron architecture

### Technical Details

#### Process Architecture
```
Main Process (Electron)
├── Window Management
├── IPC Handlers (40+)
├── SQLite Database
├── CoworkRunner
└── IM Gateways

Renderer Process (React)
├── UI Components
├── State Management
└── Business Logic
```

#### Directory Structure
```
~/.qiming-agent/
├── engines/           # Agent engines (claude-code, qimingcode)
├── workspaces/       # Session workspaces
├── node_modules/    # Local npm packages
└── qiming-agent.db   # SQLite database
```

---

## [Future]

### Planned Features

- [ ] Sandbox execution (Alpine Linux VM)
- [ ] Permission gating
- [ ] Persistent memory
- [ ] Scheduled tasks
- [ ] IM remote control

### Known Issues

- None currently

---

## Version History

| Version | Date | Description |
|---------|------|-------------|
| 0.1.0 | 2026-02-22 | Initial Electron client with multi-engine support |
| 0.1.1 | 2026-02-23 | Bug fixes: process separation, dependency install, settings storage |
| 0.2.0 | 2026-02-23 | Remove legacy Agent spawn, unify to SDK with MCP injection |