fotric-claw 0.1.0 → 0.1.2

package/README.md

@@ -9,13 +9,23 @@ FotricCalw 是一个轻量级、透明的 AI Agent 系统，支持命令行安
 
 ## 安装方式
 
-### 方式一：从 npm 安装（待开发）
+### 方式一：从 npm 安装
 
 ```bash
 npm install -g fotric-claw
 ```
 
-> 注：此方式暂不可用，请使用源码安装。
+安装后直接使用：
+
+```bash
+# 配置 API
+fotric-claw config
+
+# 启动服务
+fotric-claw start
+```
+
+> npm 安装的版本已预编译，无需构建步骤。
 
 ### 方式二：从源码安装
 
@@ -57,27 +67,20 @@ node bin/fotric-claw.js config
 
 #### 步骤 4：启动服务
 
-**方式一：使用命令行工具（推荐）**
+**开发模式：**
 
-(由于方式一的命令行工具暂未开发，此处仅展示手动启动的方式)
-```bash
-fotric-claw start
-```
-使用该方案,等效于上述命令
 ```bash
 node bin/fotric-claw.js start
 ```
 
-该命令将自动启动后端和前端服务。
-
-**方式二：手动启动**
+**生产模式：**
 
 ```bash
-# 启动后端服务
-npm run backend
+# 构建
+node bin/fotric-claw.js build
 
-# 在新终端窗口启动前端服务
-npm run frontend
+# 启动
+node bin/fotric-claw.js start:prod
 ```
 
 #### 步骤 5：访问应用
@@ -94,26 +97,19 @@ FotricCalw 提供了交互式命令行配置工具，方便用户设置 LLM API
 fotric-claw help
 ```
 
-输出：
+**npm 安装用户可用命令：**
 ```
-FotricCalw CLI
-
-Usage:
-  fotric-claw <command> [options]
-
 Commands:
-  start       Start backend and frontend services (dev mode)
-  start:prod  Start backend and frontend services (production mode)
-  build       Build backend and frontend for production
+  start       Start backend and frontend services
   config      Configure LLM API settings
   help        Show this help message
+```
 
-Examples:
-  fotric-claw start
-  fotric-claw start:prod
-  fotric-claw build
-  fotric-claw config
-  fotric-claw help
+**源码安装用户额外可用命令：**
+```
+Commands:
+  start       Start backend and frontend services (dev mode)
+  build       Build backend and frontend for production
 ```
 
 ### 配置 LLM API
@@ -183,7 +179,7 @@ FOTRIC_REPL_TIMEOUT=15000
 
 ## 启动服务
 
-### 开发模式
+### 开发模式（仅源码安装）
 
 ```bash
 # 启动后端服务
@@ -195,28 +191,20 @@ npm run frontend
 
 ### 生产模式
 
-**方式一：使用命令行工具（推荐）**
+**npm 安装用户：**
 
 ```bash
-# 构建项目
-fotric-claw build
-
-# 启动生产服务
-fotric-claw start:prod
+fotric-claw start
 ```
 
-**方式二：手动操作**
+**源码安装用户：**
 
 ```bash
 # 构建项目
-npm run build:backend
-npm run build:frontend
-
-# 启动后端
-cd backend && npm run start:prod
+node bin/fotric-claw.js build
 
-# 启动前端
-cd frontend && npm run start
+# 启动生产服务
+node bin/fotric-claw.js start:prod
 ```
 
 ## 访问服务

package/bin/fotric-claw.js

@@ -8,6 +8,12 @@ const { spawn } = require('child_process');
 const ENV_FILE = path.resolve(__dirname, '../backend/.env');
 const PROJECT_ROOT = path.resolve(__dirname, '..');
 
+function isNpmInstalled() {
+  const backendSrc = path.resolve(PROJECT_ROOT, 'backend/src');
+  const frontendSrc = path.resolve(PROJECT_ROOT, 'frontend/src');
+  return !fs.existsSync(backendSrc) || !fs.existsSync(frontendSrc);
+}
+
 const rl = readline.createInterface({
   input: process.stdin,
   output: process.stdout
@@ -114,30 +120,41 @@ async function configCommand() {
 }
 
 async function showHelp() {
+  const isNpm = isNpmInstalled();
+  
   console.log(`
 FotricCalw CLI
 
 Usage:
   fotric-claw <command> [options]
 
-Commands:
+Commands:${isNpm ? `
+  start       Start backend and frontend services
+  config      Configure LLM API settings
+  help        Show this help message` : `
   start       Start backend and frontend services (dev mode)
   start:prod  Start backend and frontend services (production mode)
   build       Build backend and frontend for production
   config      Configure LLM API settings
-  help        Show this help message
+  help        Show this help message`}
 
-Examples:
+Examples:${isNpm ? `
+  fotric-claw start
+  fotric-claw config` : `
   fotric-claw start
   fotric-claw start:prod
   fotric-claw build
-  fotric-claw config
-  fotric-claw help
+  fotric-claw config`}
 `);
   rl.close();
 }
 
 function startCommand() {
+  if (isNpmInstalled()) {
+    startProdCommand();
+    return;
+  }
+  
   console.log('\n🚀 Starting FotricCalw (Development Mode)...\n');
   
   const isWindows = process.platform === 'win32';
@@ -176,6 +193,21 @@ function startProdCommand() {
   const isWindows = process.platform === 'win32';
   const shell = isWindows ? true : false;
   
+  const backendDist = path.resolve(PROJECT_ROOT, 'backend/dist');
+  const frontendStandalone = path.resolve(PROJECT_ROOT, 'frontend/.next/standalone');
+  
+  if (!fs.existsSync(backendDist)) {
+    console.error('❌ Backend not built. Please run "fotric-claw build" first.\n');
+    rl.close();
+    return;
+  }
+  
+  if (!fs.existsSync(frontendStandalone)) {
+    console.error('❌ Frontend not built. Please run "fotric-claw build" first.\n');
+    rl.close();
+    return;
+  }
+  
   const backend = spawn('node', ['dist/main'], {
     cwd: path.resolve(PROJECT_ROOT, 'backend'),
     shell,
@@ -183,8 +215,8 @@ function startProdCommand() {
   });
   
   setTimeout(() => {
-    const frontend = spawn('npm', ['run', 'start'], {
-      cwd: path.resolve(PROJECT_ROOT, 'frontend'),
+    const frontend = spawn('node', ['server.js'], {
+      cwd: path.resolve(PROJECT_ROOT, 'frontend/.next/standalone'),
       shell,
       stdio: 'inherit'
     });
@@ -204,6 +236,13 @@ function startProdCommand() {
 }
 
 function buildCommand() {
+  if (isNpmInstalled()) {
+    console.log('\n⚠️  Build command not available in npm installation.');
+    console.log('   The package is already pre-built.\n');
+    rl.close();
+    return;
+  }
+  
   console.log('\n📦 Building FotricCalw for production...\n');
   
   const isWindows = process.platform === 'win32';
@@ -236,6 +275,19 @@ function buildCommand() {
         console.error('❌ Frontend build failed');
         process.exit(frontendCode);
       }
+      
+      const staticSrc = path.resolve(PROJECT_ROOT, 'frontend/.next/static');
+      const staticDest = path.resolve(PROJECT_ROOT, 'frontend/.next/standalone/.next/static');
+      if (fs.existsSync(staticSrc) && !fs.existsSync(staticDest)) {
+        fs.cpSync(staticSrc, staticDest, { recursive: true });
+      }
+      
+      const publicSrc = path.resolve(PROJECT_ROOT, 'frontend/public');
+      const publicDest = path.resolve(PROJECT_ROOT, 'frontend/.next/standalone/public');
+      if (fs.existsSync(publicSrc) && !fs.existsSync(publicDest)) {
+        fs.cpSync(publicSrc, publicDest, { recursive: true });
+      }
+      
       console.log('\n✅ Frontend build complete');
       console.log('\n🎉 Build complete! Run "fotric-claw start:prod" to start in production mode.\n');
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fotric-claw",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "FotricCalw - A lightweight, transparent AI Agent system",
   "author": "FOTRIC",
   "license": "MIT",
@@ -9,18 +9,24 @@
   },
   "files": [
     "bin/",
-    "backend/",
-    "frontend/",
+    "backend/dist/",
+    "backend/package.json",
+    "backend/.env.example",
+    "frontend/.next/standalone/",
+    "frontend/.next/static/",
+    "frontend/public/",
     "knowledge/",
     "storage/",
-    "scripts/",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
-    "backend": "cd backend && npm run start:dev",
-    "frontend": "cd frontend && npm run dev",
+    "build": "npm run build:backend && npm run build:frontend",
     "build:backend": "cd backend && npm run build",
     "build:frontend": "cd frontend && npm run build",
+    "prepublishOnly": "npm run build",
+    "backend": "cd backend && npm run start:dev",
+    "frontend": "cd frontend && npm run dev",
     "install:all": "cd backend && npm install && cd ../frontend && npm install"
   },
   "keywords": [

package/backend/nest-cli.json

@@ -1,8 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/nest-cli",
-  "collection": "@nestjs/schematics",
-  "sourceRoot": "src",
-  "compilerOptions": {
-    "deleteOutDir": true
-  }
-}