agent-window 1.0.0 → 1.0.2

package/README.md

@@ -5,19 +5,32 @@
 </p>
 
 <p align="center">
-  Simplified interaction, powerful backend capabilities
+  <i>A simple yet powerful interface to interact with AI agents through familiar chat platforms</i>
+</p>
+
+<p align="center">
+  <a href="README.zh-CN.md">中文版</a> | <a href="README.md">English</a>
 </p>
 
 ---
 
-## Features
+## Why AgentWindow?
+
+**AgentWindow = Your Chat App + Powerful AI Backend**
+
+- **Dead Simple Interaction** - Chat naturally in Discord/Slack/Telegram, no new UI to learn
+- **Unified Window** - All AI agent capabilities presented through one familiar interface
+- **Multi-Platform Ready** - Discord today, seamlessly switch to Slack or Telegram tomorrow
+- **Secure Isolation** - Docker sandboxed environment keeps AI operations separate from your system
+- **Permission Control** - Approve sensitive operations via chat buttons, stay in control
+- **Multi-Bot Management** - One codebase, multiple projects, unified management
+
+### Use Cases
 
-- **Simplicity First** - Easy chat-based interaction with AI agents
-- **Multi-Platform Ready** - Discord today, Slack/Telegram coming soon
-- **Docker Sandbox** - Secure isolated execution environment
-- **Permission Control** - Approve operations via chat buttons
-- **Session Management** - Resume conversations, channel binding
-- **Multi-Bot Ready** - Unified management for multiple instances
+- **Code Collaboration** - Have an AI team work directly in your development channels
+- **Document Processing** - Feed documents to AI, get structured outputs
+- **Data Analysis** - Describe requirements, AI processes and returns results
+- **Task Automation** - Trigger scripts and scheduled tasks via chat
 
 ---
 

package/README.zh-CN.md

@@ -0,0 +1,151 @@
+# AgentWindow
+
+<p align="center">
+  <strong>简单而强大的 AI 代理交互窗口</strong>
+</p>
+
+<p align="center">
+  <i>通过熟悉的聊天平台，轻松驾驭后端 AI 能力</i>
+</p>
+
+<p align="center">
+  <a href="README.zh-CN.md">🇨🇳 中文版</a> | <a href="README.md">🇺🇸 English</a>
+</p>
+
+---
+
+## 为什么选择 AgentWindow？
+
+**AgentWindow = 你的聊天软件 + 强大 AI 后端**
+
+- **极简交互** - 在 Discord/Slack/Telegram 中自然对话，无需学习新界面
+- **统一窗口** - 所有 AI 代理能力通过一个"窗口"呈现，像使用同事一样简单
+- **多平台支持** - 今天用 Discord，明天无缝切换到 Slack 或 Telegram
+- **安全隔离** - Docker 沙箱环境，AI 操作与你的系统安全隔离
+- **权限可控** - 通过聊天按钮批准敏感操作，完全掌控 AI 行为
+- **多实例管理** - 一套代码，多个项目，统一管理
+
+### 适用场景
+
+- **代码协作** - 让 AI 团队直接在你的开发频道中工作
+- **文档处理** - 扔给 AI 文档，获得结构化输出
+- **数据分析** - 描述需求，AI 处理后返回结果
+- **自动化任务** - 通过聊天触发脚本和定时任务
+
+---
+
+## 快速开始
+
+```bash
+# 全局安装
+npm install -g agent-window
+
+# 初始化多机器人目录
+agent-window init
+
+# 添加一个机器人实例
+agent-window add-bot myproject
+
+# 启动所有机器人
+pm2 start ~/bots/ecosystem.config.cjs
+```
+
+---
+
+## CLI 命令
+
+```bash
+# 单机器人命令
+agent-window setup              # 交互式设置向导
+agent-window start              # 启动网关
+agent-window stop               # 停止网关
+agent-window restart            # 重启网关
+agent-window status             # 显示状态
+agent-window logs               # 查看日志（实时）
+agent-window update             # 更新到最新版本
+agent-window config             # 显示配置位置
+
+# 多机器人命令
+agent-window init                # 初始化 ~/bots 目录
+agent-window add-bot <name>     # 添加新的机器人实例
+```
+
+---
+
+## 配置
+
+每个机器人实例都有自己的 `config.json`：
+
+```json
+{
+  "BOT_TOKEN": "你的 Discord 机器人令牌",
+  "CLAUDE_CODE_OAUTH_TOKEN": "你的 Claude Code OAuth 令牌",
+  "PROJECT_DIR": "/你的/项目/路径",
+  "ALLOWED_CHANNELS": "频道ID-1,频道ID-2"
+}
+```
+
+### 必填项
+
+| 键 | 说明 |
+|-----|------|
+| `BOT_TOKEN` | Discord 机器人令牌 |
+| `CLAUDE_CODE_OAUTH_TOKEN` | Claude Code OAuth 令牌 |
+| `PROJECT_DIR` | 要工作的项目目录 |
+| `ALLOWED_CHANNELS` | 逗号分隔的频道 ID |
+
+### 可选项
+
+查看 `config/config.example.json` 了解所有选项。
+
+---
+
+## 聊天命令
+
+在 Discord 中，提及机器人：
+
+```
+@bot <消息>               # 发送消息（继续上次会话）
+@bot -n <消息>            # 开始新会话
+@bot -r <会话ID> <消息>   # 恢复指定会话
+@bot /pick                # 选择会话（按钮界面）
+@bot /sessions            # 列出最近的会话
+@bot /status              # 显示机器人状态
+@bot /help                # 显示帮助
+```
+
+---
+
+## 多机器人管理
+
+在一个目录中组织多个机器人实例：
+
+```
+~/bots/
+├── agent-window/          # 共享代码（链接到全局安装）
+├── project1/config.json   # 机器人1 配置
+├── project2/config.json   # 机器人2 配置
+└── ecosystem.config.cjs    # PM2 统一管理
+```
+
+**统一命令：**
+```bash
+pm2 start ~/bots/ecosystem.config.cjs   # 启动所有
+pm2 stop all                             # 停止所有
+pm2 restart all                          # 重启所有
+pm2 logs                                  # 查看所有日志
+```
+
+---
+
+## 更新
+
+```bash
+agent-window update
+```
+
+---
+
+## 许可证
+
+MIT

package/bin/cli.js

@@ -662,6 +662,44 @@ async function addBot() {
   log('  pm2 start ' + ecosystemFile + ' --only bot-' + botName);
 }
 
+// UI - Launch Web Interface
+async function ui() {
+  log('🌐 Starting AgentWindow Web UI...\n', colors.cyan);
+
+  // Check if frontend is built
+  const distPath = join(PROJECT_ROOT, 'web', 'dist');
+  if (!existsSync(distPath)) {
+    logError('Frontend not built. Run: npm run ui:build');
+    process.exit(1);
+  }
+
+  // Parse arguments
+  const args = process.argv.slice(3);
+  let port = 3721;
+  let openBrowser = true;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--port' || args[i] === '-p') {
+      port = parseInt(args[++i]) || 3721;
+    } else if (args[i] === '--no-open') {
+      openBrowser = false;
+    }
+  }
+
+  // Start server
+  try {
+    const { startServer } = await import('../src/api/server.js');
+    await startServer({
+      port,
+      logger: true,
+      open: openBrowser
+    });
+  } catch (e) {
+    logError('Failed to start server: ' + e.message);
+    process.exit(1);
+  }
+}
+
 // Help
 function showHelp() {
   showBanner();
@@ -682,6 +720,9 @@ ${colors.cyan}Multi-Bot Commands:${colors.reset}
   init      Initialize multi-bot management directory
   add-bot   Add a new bot instance
 
+${colors.cyan}Web UI:${colors.reset}
+  ui        Launch web management interface
+
 ${colors.cyan}General:${colors.reset}
   help      Show this help
 
@@ -689,6 +730,7 @@ ${colors.cyan}Examples:${colors.reset}
   agent-bridge setup              ${colors.dim}# First time setup${colors.reset}
   agent-bridge init               ${colors.dim}# Initialize ~/bots directory${colors.reset}
   agent-bridge add-bot myproject  ${colors.dim}# Add a new bot${colors.reset}
+  agent-bridge ui                 ${colors.dim}# Launch web UI${colors.reset}
   pm2 start ~/bots/ecosystem.config.cjs  ${colors.dim}# Start all bots${colors.reset}
 
 ${colors.cyan}Documentation:${colors.reset}
@@ -730,6 +772,9 @@ switch (command) {
   case 'add-bot':
     addBot();
     break;
+  case 'ui':
+    await ui();
+    break;
   case 'help':
   case '--help':
   case '-h':

package/docs/WEB_UI_GUIDE.md

@@ -0,0 +1,249 @@
+# AgentWindow Web UI 用户指南
+
+## 简介
+
+AgentWindow Web UI 是一个基于浏览器的管理界面，用于管理你的 AI Bot 实例。采用 Apple 风格设计，提供简洁优雅的用户体验。
+
+## 快速开始
+
+### 启动 Web UI
+
+```bash
+agent-window ui
+```
+
+服务器将在 `http://127.0.0.1:3721` 启动，浏览器会自动打开。
+
+### 命令选项
+
+| 选项 | 说明 |
+|------|------|
+| `--port, -p <port>` | 指定端口号（默认：3721） |
+| `--no-open` | 不自动打开浏览器 |
+| `--dev` | 开发模式 |
+
+---
+
+## 功能说明
+
+### 1. Dashboard（仪表板）
+
+主页显示所有 Bot 实例的状态概览：
+
+- **统计卡片**：显示总数、运行中、已停止、错误数量
+- **实例卡片**：每个实例显示：
+  - 名称和显示名称
+  - 运行状态（运行中/已停止/错误）
+  - 内存使用量
+  - CPU 使用率
+  - 运行时间
+  - 快捷操作按钮（启动/停止/重启）
+
+### 2. 实例管理
+
+#### 添加实例
+
+1. 点击右上角 **"Add Instance"** 按钮
+2. 填写表单：
+   - **Name**: 实例标识符（小写字母、数字、连字符）
+   - **Display Name**: 显示名称
+   - **Project Path**: Bot 项目路径
+   - **Tags**: 标签（可选，逗号分隔）
+
+3. 点击 **"Add Instance"** 完成
+
+#### 删除实例
+
+1. 进入 **Instances** 页面
+2. 找到要删除的实例
+3. 点击 **"Delete"** 按钮
+4. 确认删除
+
+#### 实例操作
+
+每个实例卡片有三个操作按钮：
+
+| 按钮 | 功能 | 说明 |
+|------|------|------|
+| ▶ | 启动 | 启动已停止的实例 |
+| ⏸ | 停止 | 停止运行中的实例 |
+| 🔄 | 重启 | 重启实例 |
+
+### 3. 实例详情
+
+点击实例卡片上的 **"Details"** 按钮进入详情页面，查看：
+
+- **状态面板**：PID、内存、CPU、重启次数
+- **信息面板**：路径、配置、添加时间、标签
+- **实时日志**：最近的日志输出
+
+### 4. 实时日志
+
+日志查看器功能：
+
+- **Live 开关**：启用/禁用实时日志流
+- **类型过滤**：All / Stdout / Stderr
+- **搜索**：搜索日志内容
+- **导出**：下载日志为文本文件
+- **清空**：清空当前日志显示
+- **全屏**：全屏查看日志
+
+### 5. 设置
+
+设置页面显示：
+
+- 系统信息（平台、Node 版本、版本号）
+- 外观设置（深色模式切换）
+- 关于信息
+
+---
+
+## 支持的 Bot 类型
+
+### 类型 1: 独立 Bot
+
+普通的 Discord/Slack Bot，具有基本结构：
+
+```
+my-bot/
+├── config.json
+├── package.json (含 discord.js)
+└── src/
+    └── bot.js
+```
+
+### 类型 2: BMAD 插件
+
+集成 BMAD 框架的高级 Bot：
+
+```
+my-bmad-bot/
+├── _bmad/              # BMAD 框架
+│   ├── core/           # 核心模块
+│   ├── bmm/            # BMAD 业务模块
+│   └── _config/        # 配置文件
+├── _agent-bridge/      # 插件目录
+│   └── src/
+│       └── bot.js      # Bot 入口
+└── package.json        # 依赖 discord.js
+```
+
+---
+
+## 实例添加示例
+
+### 示例 1: 添加独立 Bot
+
+```bash
+# 假设你有一个简单 Bot 在 ~/bots/my-bot
+agent-window instance add my-bot ~/bots/my-bot
+```
+
+或在 Web UI 中：
+- Name: `my-bot`
+- Display Name: `My Bot`
+- Project Path: `/Users/yourname/bots/my-bot`
+
+### 示例 2: 添加 BMAD Bot
+
+```bash
+# 添加 BMAD 企业 Bot
+agent-window instance add corp-office ~/projects/corp-office --tags prod,bmad
+```
+
+或在 Web UI 中：
+- Name: `corp-office`
+- Display Name: `Corporate Office Bot`
+- Project Path: `/Users/yourname/projects/corp-office`
+- Tags: `prod, bmad`
+
+---
+
+## CLI 命令参考
+
+### 实例管理
+
+```bash
+# 列出所有实例
+agent-window instance list
+
+# 添加实例
+agent-window instance add <name> <project-path> [options]
+
+# 删除实例
+agent-window instance remove <name>
+
+# 查看实例详情
+agent-window instance info <name>
+
+# 实例配置
+agent-window instance config <name> get <key>
+agent-window instance config <name> set <key> <value>
+agent-window instance config <name> list
+agent-window instance config <name> backup
+```
+
+### 实例操作
+
+```bash
+# 启动实例
+agent-window instance start <name>
+
+# 停止实例
+agent-window instance stop <name>
+
+# 重启实例
+agent-window instance restart <name>
+
+# 查看状态
+agent-window instance status <name>
+
+# 查看日志
+agent-window instance logs <name>
+```
+
+---
+
+## 常见问题
+
+### Q: Web UI 无法启动？
+
+A: 检查：
+1. 端口 3721 是否被占用
+2. 前端是否已构建 (`npm run ui:build`)
+3. 依赖是否已安装
+
+### Q: 添加实例失败？
+
+A: 确保项目：
+1. 路径存在且可访问
+2. 包含 `package.json` 和 `src/bot.js`
+3. BMAD 项目需要 `_bmad` 目录
+
+### Q: 实例状态显示 Unknown？
+
+A: 这表示实例未在 PM2 中运行，使用 `start` 按钮启动。
+
+### Q: 日志不显示？
+
+A: 检查：
+1. 实例是否已启动
+2. Live 开关是否已启用
+3. 浏览器控制台是否有错误
+
+---
+
+## 键盘快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Cmd/Ctrl + K` | 聚焦搜索框 |
+| `Esc` | 关闭模态框 |
+| `Cmd/Ctrl + /` | 切换深色模式 |
+
+---
+
+## 技术支持
+
+- 项目地址：https://github.com/Observer-GGboy/AgentWindow
+- 问题反馈：GitHub Issues

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-window",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A window to interact with AI agents through chat interfaces. Simplified interaction, powerful backend capabilities.",
   "type": "module",
   "main": "src/bot.js",
@@ -11,6 +11,9 @@
     "start": "node src/bot.js",
     "dev": "node --watch src/bot.js",
     "setup": "node bin/cli.js setup",
+    "ui": "node bin/cli.js ui",
+    "ui:dev": "cd web && npm run dev",
+    "ui:build": "cd web && npm run build",
     "pm2:start": "pm2 start ecosystem.config.cjs",
     "pm2:stop": "pm2 stop agent-window",
     "pm2:restart": "pm2 restart agent-window",
@@ -36,10 +39,19 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "discord.js": "^14.14.1"
+    "@fastify/static": "^6.0.0",
+    "@fastify/websocket": "^10.0.0",
+    "cli-table3": "^0.6.5",
+    "discord.js": "^14.14.1",
+    "fastify": "^4.25.0",
+    "open": "^10.0.0",
+    "pino-pretty": "^10.0.0"
+  },
+  "overrides": {
+    "undici": "^7.19.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/YOUR_USERNAME/AgentWindow"
+    "url": "https://github.com/Observer-GGboy/AgentWindow"
   }
 }

package/scripts/test-platform.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * Platform Compatibility Test Script
+ *
+ * Tests the platform abstraction layer to ensure cross-platform compatibility.
+ * Run this script on different platforms to verify functionality.
+ */
+
+import {
+  Platform,
+  currentPlatform,
+  isWindows,
+  isWSLAvailable,
+  getShell,
+  paths,
+  docker,
+  pm2
+} from '../src/core/platform/index.js';
+
+console.log('\n=== Platform Compatibility Test ===\n');
+
+// Test 1: Platform Detection
+console.log('1. Platform Detection');
+console.log(`   Current Platform: ${currentPlatform}`);
+console.log(`   Is Windows: ${isWindows()}`);
+console.log(`   Platform Enum: ${Platform.WINDOWS}, ${Platform.LINUX}, ${Platform.MACOS}\n`);
+
+// Test 2: Shell Detection
+console.log('2. Shell Detection');
+const shell = getShell();
+console.log(`   Shell Command: ${shell.command}`);
+console.log(`   Shell Type: ${shell.type}\n`);
+
+// Test 3: Path Utilities
+console.log('3. Path Utilities');
+console.log(`   Home Dir: ${paths.getHomeDir()}`);
+console.log(`   AgentWindow Home: ${paths.getAgentWindowHome()}`);
+console.log(`   Bots Dir: ${paths.getBotsDir()}`);
+console.log(`   Claude Config: ${paths.getClaudeConfigDir()}`);
+console.log(`   Expanded ~: ${paths.expandTilde('~/test')}`);
+console.log(`   Config Dir: ${paths.getConfigDir()}`);
+console.log(`   Data Dir: ${paths.getDataDir()}\n`);
+
+// Test 4: WSL Detection (Windows only)
+if (isWindows()) {
+  console.log('4. WSL Detection (Windows)');
+  isWSLAvailable().then(available => {
+    console.log(`   WSL Available: ${available}\n`);
+  }).catch(() => {
+    console.log('   WSL Detection failed\n');
+  });
+} else {
+  console.log('4. WSL Detection: Skipped (not Windows)\n');
+}
+
+// Test 5: PM2 Availability
+console.log('5. PM2 Availability');
+pm2.isAvailable().then(available => {
+  console.log(`   PM2 Available: ${available}`);
+  if (available) {
+    pm2.version().then(version => {
+      console.log(`   PM2 Version: ${version}`);
+      runDockerTests();
+    }).catch(() => {
+      console.log('   PM2 Version: unknown');
+      runDockerTests();
+    });
+  } else {
+    console.log('   PM2 not installed - skipping PM2 tests');
+    runDockerTests();
+  }
+}).catch(() => {
+  console.log('   PM2 detection failed');
+  runDockerTests();
+});
+
+// Test 6: Docker Availability
+function runDockerTests() {
+  console.log('\n6. Docker Availability');
+  docker.isAvailable().then(available => {
+    console.log(`   Docker Available: ${available}`);
+    if (available) {
+      docker.version().then(version => {
+        console.log(`   Docker Version: ${version.Server?.Version || 'unknown'}`);
+        finishTests();
+      }).catch(() => {
+        console.log('   Docker Version: unknown');
+        finishTests();
+      });
+    } else {
+      console.log('   Docker not installed - skipping Docker tests');
+      finishTests();
+    }
+  }).catch(() => {
+    console.log('   Docker detection failed');
+    finishTests();
+  });
+}
+
+function finishTests() {
+  console.log('\n=== Test Complete ===\n');
+  console.log('Platform abstraction layer is working correctly.');
+  console.log('Next steps:');
+  console.log('  - Test actual PM2 process management');
+  console.log('  - Test Docker container operations');
+  console.log('  - Test on Windows with WSL2');
+  console.log('  - Test on Windows with Docker Desktop');
+  console.log('');
+}

package/src/api/routes/index.js

@@ -0,0 +1,25 @@
+/**
+ * API Routes Registry
+ *
+ * Registers all REST API routes.
+ */
+
+import { registerInstanceRoutes } from './instances.js';
+import { registerOperationRoutes } from './operations.js';
+import { registerSystemRoutes } from './system.js';
+
+/**
+ * Register all API routes
+ */
+export async function registerRoutes(fastify) {
+  // Instance management routes
+  await registerInstanceRoutes(fastify);
+
+  // Operation routes (start/stop/restart)
+  await registerOperationRoutes(fastify);
+
+  // System routes (health, info)
+  await registerSystemRoutes(fastify);
+
+  fastify.log.info('All API routes registered');
+}