Merge remote-tracking branch 'origin/feature/electron-client-0.6' into feature/electron-client-0.6

Author: soddygo

.github/workflows/release-electron.yml

@@ -68,7 +68,7 @@ jobs:
             echo "Release $TAG already exists"
           else
             gh release create "$TAG" \
-              --title "Nuwax Agent (Electron) ${{ steps.version.outputs.version }}" \
+              --title "NuwaxBot (Electron) ${{ steps.version.outputs.version }}" \
               --notes-file release_notes.txt \
               --repo "$GITHUB_REPOSITORY"
             echo "Created release $TAG"

crates/agent-electron-client/AGENTS.md

@@ -214,11 +214,11 @@ Each engine runs in an isolated environment:
 ```typescript
 {
   // App-internal dependencies injected
-  PATH: '~/.nuwax-agent/node_modules/.bin:~/.nuwax-agent/bin:$PATH',
-  NODE_PATH: '~/.nuwax-agent/node_modules',
+  PATH: '~/.nuwaxbot/node_modules/.bin:~/.nuwaxbot/bin:$PATH',
+  NODE_PATH: '~/.nuwaxbot/node_modules',
 
   // Isolated home
-  HOME: '/tmp/nuwax-agent-run-xxx',
+  HOME: '/tmp/nuwaxbot-run-xxx',
   XDG_CONFIG_HOME: '/tmp/.../.config',
   CLAUDE_CONFIG_DIR: '/tmp/.../.claude',
   NUWAXCODE_CONFIG_DIR: '/tmp/.../.nuwaxcode',
@@ -299,34 +299,34 @@ permissionManager.approveRequest(requestId, alwaysAllow);
 | **nuwax-file-server** | npm-local | File service |
 | **claude-code-acp-ts** | npm-local | Claude Code ACP implementation |
 | **nuwaxcode** | npm-local | Nuwaxcode ACP implementation |
-| **nuwax-mcp-stdio-proxy** | npm ^1.0.0 + npm-local | MCP 聚合代理；应用依赖自带，也可在 ~/.nuwax-agent/node_modules 安装覆盖 |
+| **nuwax-mcp-stdio-proxy** | npm ^1.0.0 + npm-local | MCP 聚合代理；应用依赖自带，也可在 ~/.nuwaxbot/node_modules 安装覆盖 |
 
 > **Note**: Node.js is NOT a required dependency — Electron bundles its own Node runtime.
 
 ### Installation Locations
 
 ```
-~/.nuwax-agent/
+~/.nuwaxbot/
 ├── engines/           # Agent engines
 ├── workspaces/       # Session workspaces
 ├── node_modules/    # Local npm packages
 │   ├── .bin/        # Executable symlinks (injected into PATH)
 │   └── mcp-servers  # MCP servers (isolated)
 ├── bin/              # App binaries
 ├── logs/             # Application logs
-└── nuwax-agent.db   # SQLite database
+└── nuwaxbot.db   # SQLite database
 ```
 
-> **Important**: All data is stored under `~/.nuwax-agent/`. The Electron `app.getPath('userData')` path is NOT used.
+> **Important**: All data is stored under `~/.nuwaxbot/`. The Electron `app.getPath('userData')` path is NOT used.
 
 ### Environment Injection
 
 All child processes (engines, file server, lanproxy, agent runner) receive injected environment variables:
 
 ```typescript
 {
-  PATH: '~/.nuwax-agent/node_modules/.bin:~/.nuwax-agent/bin:resources/uv/bin:$PATH',
-  NODE_PATH: '~/.nuwax-agent/node_modules',
+  PATH: '~/.nuwaxbot/node_modules/.bin:~/.nuwaxbot/bin:resources/uv/bin:$PATH',
+  NODE_PATH: '~/.nuwaxbot/node_modules',
 }
 ```
 

crates/agent-electron-client/CHANGELOG.md

@@ -267,13 +267,13 @@ Renderer Process (React)
 
 #### Directory Structure
 ```
-~/.nuwax-agent/
+~/.nuwaxbot/
 ├── engines/           # Agent engines (claude-code, nuwaxcode)
 ├── workspaces/       # Session workspaces
 ├── node_modules/    # Local npm packages
 │   └── mcp-servers # MCP servers (isolated)
 ├── logs/            # Application logs
-└── nuwax-agent.db   # SQLite database
+└── nuwaxbot.db   # SQLite database
 ```
 
 ---

crates/agent-electron-client/docs/architecture/ISOLATION.md

@@ -70,7 +70,7 @@ status: design
 ## 目录结构设计
 
 ```
-~/.nuwax-agent/
+~/.nuwaxbot/
 ├── core/                      # 应用核心区（只读）
 │   ├── engines/               # 引擎二进制（应用管理）
 │   └── config/                # 应用配置（用户通过 UI 修改）
@@ -99,8 +99,8 @@ status: design
 // 应用核心：严格隔离
 const coreEnv = {
   PATH: [
-    '~/.nuwax-agent/core/engines',
-    '~/.nuwax-agent/core/bin',
+    '~/.nuwaxbot/core/engines',
+    '~/.nuwaxbot/core/bin',
   ].join(':'),
   // 最小化环境变量
 };
@@ -113,8 +113,8 @@ const coreEnv = {
 const agentEnv = {
   // 核心工具（来自应用）
   PATH: [
-    '~/.nuwax-agent/core/engines',
-    '~/.nuwax-agent/core/bin',
+    '~/.nuwaxbot/core/engines',
+    '~/.nuwaxbot/core/bin',
   ],
 
   // Agent 工作区（Agent 可添加）
@@ -174,7 +174,7 @@ interface AgentCapabilities {
 await capabilities.installNpmPackage('jq');  // 安装到工作区
 
 // 结果
-~/.nuwax-agent/workspace/{session-id}/node_modules/.bin/jq
+~/.nuwaxbot/workspace/{session-id}/node_modules/.bin/jq
 // ✅ Agent 可以使用
 // ✅ 不污染用户环境
 // ✅ 会话结束可清理
@@ -190,7 +190,7 @@ await capabilities.installNpmPackage('jq');  // 安装到工作区
 await capabilities.installNpmPackage('@nuwax/nuwaxcode@latest');
 
 // 结果
-~/.nuwax-agent/workspace/{session-id}/node_modules/.bin/nuwaxcode
+~/.nuwaxbot/workspace/{session-id}/node_modules/.bin/nuwaxcode
 // ✅ Agent 使用新版本
 // ✅ 应用核心引擎不受影响
 // ✅ 可以回滚
@@ -209,7 +209,7 @@ if (!await capabilities.hasCommand('cargo')) {
 }
 
 // 结果
-~/.nuwax-agent/workspace/{session-id}/tools/bin/cargo
+~/.nuwaxbot/workspace/{session-id}/tools/bin/cargo
 // ✅ Agent 可以编译项目
 // ✅ 不影响用户系统
 ```

crates/agent-electron-client/docs/architecture/OVERVIEW.md

@@ -221,7 +221,7 @@ interface EvolutionControl {
 ## 数据目录结构
 
 ```
-~/.nuwax-agent/
+~/.nuwaxbot/
 ├── soul/                          # Agent 自我认知
 │   ├── soul.md                    # 主灵魂文件
 │   ├── principles.md              # 学习到的原则

crates/agent-electron-client/docs/architecture/REF-OPENCLAW.md

@@ -810,7 +810,7 @@ export type ProgramContext = {
   // 版本信息
   version: string;
 
-  // 路径信息（必须与项目约束一致：~/.nuwax-agent）
+  // 路径信息（必须与项目约束一致：~/.nuwaxbot）
   paths: {
     homeDir: string;
     appDataDir: string;
@@ -842,7 +842,7 @@ function resolveAppPaths() {
   return {
     homeDir,
     appDataDir,
-    dbPath: path.join(appDataDir, 'nuwax-agent.db'),
+    dbPath: path.join(appDataDir, 'nuwaxbot.db'),
     logsDir: path.join(appDataDir, 'logs'),
   };
 }
@@ -1209,7 +1209,7 @@ CREATE TABLE IF NOT EXISTS workflow_runs (
 | 优先级 | 改进项 | 难度 | 预期价值 | 涉及文件 |
 |--------|--------|------|----------|----------|
 | 🔴 P0 | 统一 IPC 注册系统（稳定代理 + 一次加载） | 中 | 高 | `src/main/ipc/*` |
-| 🔴 P0 | 程序上下文模式（路径约束对齐 `~/.nuwax-agent`） | 中 | 高 | `src/main/context.ts` |
+| 🔴 P0 | 程序上下文模式（路径约束对齐 `~/.nuwaxbot`） | 中 | 高 | `src/main/context.ts` |
 | 🔴 P0 | 运行时环境双模式（strict/compat） | 中 | 高 | `src/main/services/system/*` |
 | 🟡 P1 | 统一事件总线 | 中 | 高 | `src/services/common/event-bus.ts` |
 | 🟡 P1 | Lobster Runtime 集成（run/resume） | 中 | 高 | `src/main/services/workflow/*` |
@@ -1222,7 +1222,7 @@ CREATE TABLE IF NOT EXISTS workflow_runs (
 
 1. **创建程序上下文**
    - 新建 `src/main/context.ts`
-   - 路径统一到 `app.getPath('home') + '/.nuwax-agent'`
+   - 路径统一到 `app.getPath('home') + '/.nuwaxbot'`
    - 重构 `main.ts` 使用上下文
    - 提取服务初始化逻辑
 
@@ -1264,7 +1264,7 @@ CREATE TABLE IF NOT EXISTS workflow_runs (
 ### 5.3 兼容性考虑
 
 - 保持现有 IPC API 不变（使用适配器模式）
-- 保持数据目录约束不变：所有持久化数据继续落在 `~/.nuwax-agent/`
+- 保持数据目录约束不变：所有持久化数据继续落在 `~/.nuwaxbot/`
 - 默认使用 `strict`，仅在显式配置下切换到 `compat`
 - 分阶段迁移，不破坏现有功能
 - 添加废弃警告，逐步过渡

crates/agent-electron-client/docs/architecture/RUNTIME-ENV-PROFILES.md

@@ -35,7 +35,7 @@ status: design
 
 ### 3.1 strict（默认）
 
-- 路径：应用内优先（`~/.nuwax-agent/node_modules/.bin`, `~/.nuwax-agent/bin`）
+- 路径：应用内优先（`~/.nuwaxbot/node_modules/.bin`, `~/.nuwaxbot/bin`）
 - 配置：隔离 `HOME/XDG/CLAUDE_CONFIG_DIR/NUWAXCODE_CONFIG_DIR`
 - npm/uv：使用应用内缓存、镜像和目录
 - 不透传用户级敏感变量
@@ -126,7 +126,7 @@ export function buildRuntimeEnv(options: BuildRuntimeEnvOptions): Record<string,
 
 兼容性遗留需处理：
 
-- `src/main/services/packages/packageManager.ts` 仍使用 `userData` 路径，应统一到 `~/.nuwax-agent`
+- `src/main/services/packages/packageManager.ts` 仍使用 `userData` 路径，应统一到 `~/.nuwaxbot`
 
 ---
 

crates/agent-electron-client/docs/architecture/STORAGE.md

@@ -26,7 +26,7 @@ status: design
 ## 目录结构
 
 ```
-~/.nuwax-agent/
+~/.nuwaxbot/
 ├── soul/                          # Agent 自我认知
 │   ├── soul.md                    # 主灵魂文件
 │   ├── principles.md              # 学习到的原则
@@ -645,7 +645,7 @@ class MarkdownMemoryReader implements MemoryReader {
 向量可以存储在以下位置：
 
 ```
-~/.nuwax-agent/
+~/.nuwaxbot/
 ├── memory/
 │   ├── index.json              # 原有索引
 │   └── embeddings.json         # 新增：向量索引（可选）

crates/agent-electron-client/docs/operations/LOGGING.md

@@ -1,6 +1,6 @@
 # 日志设计说明
 
-主进程日志目录：`~/.nuwax-agent/logs/`（开发与正式共用该路径，行为由是否打包区分）。
+主进程日志目录：`~/.nuwaxbot/logs/`（开发与正式共用该路径，行为由是否打包区分）。
 
 ## 问题与目标
 

crates/agent-electron-client/docs/operations/STARTUP-CHECKLIST.md

@@ -31,7 +31,7 @@
 **方式二：从 SQLite 读取（应用未运行时）**
 
 ```bash
-DB="$HOME/.nuwax-agent/nuwax-agent.db"
+DB="$HOME/.nuwaxbot/nuwaxbot.db"
 
 # step1_config 内含 agentPort、fileServerPort（JSON）
 sqlite3 "$DB" "SELECT value FROM settings WHERE key='step1_config';"
@@ -73,7 +73,7 @@ lsof -i :$LANPROXY_LOCAL_PORT
 **一键检查（推荐，与应用内聚合逻辑一致）：**
 
 ```bash
-# 从 ~/.nuwax-agent/nuwax-agent.db 读配置并检查占用（需系统有 sqlite3）
+# 从 ~/.nuwaxbot/nuwaxbot.db 读配置并检查占用（需系统有 sqlite3）
 npm run check-ports
 # 开发模式含 Vite 端口
 npm run check-ports:dev
@@ -82,7 +82,7 @@ npm run check-ports:dev
 **或手动从 SQLite 读取后检查（需已安装 sqlite3）：**
 
 ```bash
-DB="$HOME/.nuwax-agent/nuwax-agent.db"
+DB="$HOME/.nuwaxbot/nuwaxbot.db"
 get_port() { sqlite3 "$DB" "SELECT value FROM settings WHERE key='$1';" 2>/dev/null; }
 step1=$(get_port 'step1_config')
 agent_port=$(echo "$step1" | sed -n 's/.*"agentPort":\([0-9]*\).*/\1/p'); agent_port=${agent_port:-60001}
@@ -212,4 +212,4 @@ npm run dev
 
 ---
 
-*文档依据 `~/.nuwax-agent/logs/latest.log` 常见错误整理，最后更新：2026-02-27*
+*文档依据 `~/.nuwaxbot/logs/latest.log` 常见错误整理，最后更新：2026-02-27*