@fastcar/cli 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastcar/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "homepage": "https://william_zhong.coding.net/public/fast-car/fastcar-cli/git/files",
   "description": "fastcar-cli 脚手架快速搭建",
   "bin": {

package/skills/fastcar-framework/SKILL.md

@@ -26,36 +26,23 @@ FastCar 是基于 TypeScript 的 Node.js 企业级应用开发框架，灵感来
 import { FastCarApplication } from "@fastcar/core";
 import { Application, Autowired, Component, Service } from "@fastcar/core/annotation";
 
-// 服务层
 @Service
 class UserService {
-  getUsers() {
-    return [{ id: 1, name: "Alice" }];
-  }
+  getUsers() { return [{ id: 1, name: "Alice" }]; }
 }
 
-// 控制器层
 @Controller
 class UserController {
-  @Autowired
-  private userService!: UserService;
-  
-  getUsers() {
-    return this.userService.getUsers();
-  }
+  @Autowired private userService!: UserService;
+  getUsers() { return this.userService.getUsers(); }
 }
 
-// 应用入口
 @Application
 class App {
   app!: FastCarApplication;
-  
-  async start() {
-    console.log("应用启动成功!");
-  }
+  async start() { console.log("应用启动成功!"); }
 }
 
-// 启动
 const app = new App();
 app.start();
 ```
@@ -67,23 +54,11 @@ app.start();
 ```typescript
 import { GET, POST, REQUEST, Body, Param } from "@fastcar/koa/annotation";
 
-@Controller
-@REQUEST("/api/users")
+@Controller @REQUEST("/api/users")
 class UserController {
-  @GET
-  async list() {
-    return { data: [] };
-  }
-  
-  @GET("/:id")
-  async getById(@Param("id") id: string) {
-    return { id };
-  }
-  
-  @POST
-  async create(@Body user: UserDTO) {
-    return { created: true };
-  }
+  @GET async list() { return { data: [] }; }
+  @GET("/:id") async getById(@Param("id") id: string) { return { id }; }
+  @POST async create(@Body user: UserDTO) { return { created: true }; }
 }
 ```
 
@@ -94,22 +69,14 @@ import { Repository, Table, Field, PrimaryKey, SqlSession } from "@fastcar/mysql
 
 @Table("users")
 class User {
-  @PrimaryKey
-  @Field("id")
-  id!: number;
-  
-  @Field("name")
-  name!: string;
+  @PrimaryKey @Field("id") id!: number;
+  @Field("name") name!: string;
 }
 
 @Repository
 class UserRepository {
-  @SqlSession
-  private session!: SqlSession;
-  
-  async findById(id: number) {
-    return this.session.findById(User, id);
-  }
+  @SqlSession private session!: SqlSession;
+  async findById(id: number) { return this.session.findById(User, id); }
 }
 ```
 
@@ -120,13 +87,8 @@ import { RedisClient } from "@fastcar/redis/annotation";
 
 @Service
 class CacheService {
-  @RedisClient
-  private redis!: RedisClient;
-  
-  async get(key: string) {
-    return this.redis.get(key);
-  }
-  
+  @RedisClient private redis!: RedisClient;
+  async get(key: string) { return this.redis.get(key); }
   async set(key: string, value: string, ttl?: number) {
     await this.redis.set(key, value, ttl);
   }
@@ -140,17 +102,8 @@ import { Scheduled, Cron } from "@fastcar/timer/annotation";
 
 @Component
 class TaskService {
-  // 间隔执行（毫秒）
-  @Scheduled(60000)
-  async intervalTask() {
-    console.log("每分钟执行");
-  }
-  
-  // Cron 表达式
-  @Cron("0 0 * * * *")
-  async hourlyTask() {
-    console.log("每小时执行");
-  }
+  @Scheduled(60000) async intervalTask() { console.log("每分钟执行"); }
+  @Cron("0 0 * * * *") async hourlyTask() { console.log("每小时执行"); }
 }
 ```
 
@@ -161,12 +114,9 @@ import { WorkerPool, WorkerTask } from "@fastcar/workerpool/annotation";
 
 @Component
 class ComputeService {
-  @WorkerPool({ minWorkers: 2, maxWorkers: 4 })
-  private pool!: WorkerPool;
-  
+  @WorkerPool({ minWorkers: 2, maxWorkers: 4 }) private pool!: WorkerPool;
   @WorkerTask
   heavyComputation(data: number[]): number {
-    // 在 worker 线程中执行
     return data.reduce((a, b) => a + b, 0);
   }
 }
@@ -174,8 +124,6 @@ class ComputeService {
 
 ## 项目模板速查
 
-FastCar CLI 提供 5 种项目模板，分别适用于不同的业务场景。
-
 ### 模板选择指南
 
 | 模板 | 适用场景 | 核心依赖 | 关键注解 |
@@ -188,64 +136,56 @@ FastCar CLI 提供 5 种项目模板，分别适用于不同的业务场景。
 
 ### 各模板入口示例
 
-#### Web 模板
+**Web 模板**
 ```typescript
 import { FastCarApplication } from "@fastcar/core";
 import { Application } from "@fastcar/core/annotation";
 import { EnableKoa, KoaMiddleware } from "@fastcar/koa/annotation";
 import { ExceptionGlobalHandler, KoaBodyParser } from "@fastcar/koa";
 
-@Application
-@EnableKoa
+@Application @EnableKoa
 @KoaMiddleware(ExceptionGlobalHandler)
 @KoaMiddleware(KoaBodyParser)
-class APP {
-  app!: FastCarApplication;
-}
+class APP { app!: FastCarApplication; }
 export default new APP();
 ```
 
-#### Static 模板
+**Static 模板**
 ```typescript
 import { Application } from "@fastcar/core/annotation";
 import { EnableKoa, KoaMiddleware } from "@fastcar/koa/annotation";
 import { ExceptionGlobalHandler, KoaStatic } from "@fastcar/koa";
 
-@Application
-@EnableKoa
+@Application @EnableKoa
 @KoaMiddleware(ExceptionGlobalHandler)
 @KoaMiddleware(KoaStatic)
-class APP {
-  app!: any;
-}
+class APP { app!: any; }
 export default new APP();
 ```
 
-#### RPC 模板
+**RPC 模板**
 ```typescript
 import { Application } from "@fastcar/core/annotation";
 import { EnableRPC } from "@fastcar/rpc/annotation";
 
-@Application
-@EnableRPC
+@Application @EnableRPC
 class APP {}
 export default new APP();
 ```
 
-#### COS 模板
+**COS 模板**
 ```typescript
 import { Application } from "@fastcar/core/annotation";
 import { EnableKoa, KoaMiddleware } from "@fastcar/koa/annotation";
 import { ExceptionGlobalHandler, KoaBody, KoaBodyParser, KoaCors } from "@fastcar/koa";
 
-@EnableKoa
-@Application
+@Application @EnableKoa
 @KoaMiddleware(ExceptionGlobalHandler, KoaBody, KoaBodyParser, KoaCors)
 class APP {}
 export default new APP();
 ```
 
-#### Microservices 模板
+**Microservices 模板**
 微服务模板采用多服务架构，包含 `app-node.ts`（子进程启动多服务）和 `app-pm2.ts`（PM2 启动入口）。服务模块分为：
 - **center**：服务中心，提供服务注册与发现
 - **connector**：连接器服务，处理客户端连接
@@ -280,15 +220,10 @@ template/
 │   ├── annotation/       # 注解定义
 │   ├── common/           # 公共代码
 │   ├── middleware/       # 中间件
-│   ├── servers/          # 服务目录
-│   │   ├── base/         # 基础服务
-│   │   ├── center/       # 服务中心
-│   │   ├── chat/         # 聊天服务
-│   │   ├── connector/    # 连接器服务
-│   │   └── web/          # Web 服务
+│   ├── servers/          # 服务目录（base/center/chat/connector/web）
 │   ├── types/            # 类型定义
 │   ├── utils/            # 工具函数
-│   ├── app-node.ts       # 单节点入口（子进程启动）
+│   ├── app-node.ts       # 单节点入口
 │   └── app-pm2.ts        # PM2 入口
 ├── resource/
 │   ├── application.yml
@@ -346,17 +281,14 @@ import { Configure, Value } from "@fastcar/core/annotation";
 
 @Configure
 class AppConfig {
-  @Value("server.port")
-  port!: number;
-
-  @Value("mysql.host")
-  dbHost!: string;
+  @Value("server.port") port!: number;
+  @Value("mysql.host") dbHost!: string;
 }
 ```
 
-### 各模板 application.yml 详解
+### 各模板 application.yml 配置
 
-#### Web / Static / COS 通用 Koa 配置
+#### Web / Static / COS 通用配置
 
 ```yaml
 application:
@@ -366,18 +298,16 @@ settings:
   koa:
     server:
       - { port: 8080, host: "0.0.0.0" }
-      # HTTPS 示例：
-      # - { port: 443, host: "0.0.0.0", protocol: https, ssl: { key: "./ssl/server.key", cert: "./ssl/server.pem" } }
-    koaStatic: # 静态资源映射
-      { "public": "public" } # 别名: 路径（相对 resource 目录或绝对路径）
-    koaBodyParser: # 请求体解析
+      # HTTPS: { port: 443, host: "0.0.0.0", protocol: https, ssl: { key: "./ssl/server.key", cert: "./ssl/server.pem" } }
+    koaStatic: { "public": "public" }  # 静态资源映射
+    koaBodyParser:
       enableTypes: ["json", "form", "text"]
       extendTypes: { text: ["text/xml", "application/xml"] }
 ```
 
-- `settings.koa.server`：服务器监听配置数组。支持 `http`（默认）、`http2`、`https`；启用 HTTPS 时需额外指定 `protocol: https` 和 `ssl.key / ssl.cert`。
-- `settings.koa.koaStatic`：静态资源访问映射，格式为 `{ "别名": "路径" }`。
-- `settings.koa.koaBodyParser`：Koa Body 解析器配置，`enableTypes` 控制允许的请求体类型，`extendTypes` 可扩展 XML 等特殊类型。
+- `settings.koa.server`：服务器监听配置数组，支持 `http`/`https`/`http2`
+- `settings.koa.koaStatic`：静态资源访问映射，格式 `{ "别名": "路径" }`
+- `settings.koa.koaBodyParser`：请求体解析配置
 
 #### RPC 模板配置
 
@@ -389,122 +319,53 @@ settings:
   rpc:
     list:
       - id: "server-1"
-        type: "ws"              # 通信协议：ws / http / grpc / mqtt
+        type: "ws"              # 协议：ws / http / grpc / mqtt
         server: { port: 1235 }
-        extra: {}
         serviceType: "base"     # 服务类型分类
-        secure:
-          username: "user"
-          password: "123456"
-```
-
-- `settings.rpc.list`：RPC 服务端点数组。
-  - `id`：节点唯一标识。
-  - `type`：通信协议，常见取值 `ws`、`http`、`grpc`、`mqtt`。
-  - `server`：监听配置，通常只写 `{ port }`。
-  - `extra`：协议扩展参数。
-  - `serviceType`：服务类型，用于服务分组或路由。
-  - `secure`：安全认证信息，包含 `username` 和 `password`。
-
-#### COS 模板特有配置
-
-```yaml
-application:
-  env: "prod"
-
-settings:
-  hotterSysConfig: true # 启用系统配置热更新监听
+        secure: { username: "user", password: "123456" }
 ```
 
-- `settings.hotterSysConfig`：设为 `true` 时，框架会监听配置变更并自动热更新。
+- `settings.rpc.list`：RPC 服务端点数组
+- `type`：通信协议；`serviceType`：服务分组；`secure`：安全认证
 
 #### Microservices 模板配置
 
-主配置通常只声明环境：
-
-```yaml
-application:
-  env: "dev"
-```
-
-详细集群配置放在 `application-dev.yml`：
+主配置声明环境，详细集群配置放在 `application-dev.yml`：
 
 ```yaml
 settings:
-  hotterSysConfig: true # 监听系统配置变更
-
+  hotterSysConfig: true  # 监听配置变更
   microservices:
-    center: # 服务中心
-      token: "nW0tT4bZ6qM7mF7wD2rT2pR9dT7gK3hZ"
+    center:              # 服务中心
+      token: "xxx"
       servers:
         - host: "localhost"
-          clusters: 1 # 实例数，serviceId 和端口号自动递增
+          clusters: 1    # 实例数
           list:
             - type: "ws"
               server: { port: 60000 }
-              timeout: 0 # 0 表示永不超时
+              timeout: 0
               connectionLimit: 1
-              disconnectInterval: 1000 # 断线重连间隔（毫秒）
-              retry:
-                retryCount: 3
-                retryInterval: 3000
-                timeout: 30000
-                maxMsgNum: 10000
-                increase: true
-
-    connector: # 连接器服务
-      token: "x3TGsWC9uloZu235LA07eAiJ61nQ1A5f"
+              retry: { retryCount: 3, retryInterval: 3000 }
+
+    connector:           # 连接器服务
+      token: "xxx"
       servers:
         - host: "localhost"
           clusters: 1
           list:
-            - front: true # 标记为面向客户端的前置节点
+            - front: true   # 面向客户端的前置节点
               type: "ws"
               server: { port: 60100 }
 
-    chat: # 聊天服务
-      token: "go0kbkNM3wQ4e2Vgo0kbkNM3wQ4e2V"
-      servers:
-        - host: "localhost"
-          clusters: 1
-          list:
-            - type: "ws"
-              server: { port: 60200 }
-
-    web: # Web 服务
-      token: "go0kbkNM3wQ4e2Vgo0kbkNM3wQ4e2V"
-      koa:
-        koaBodyParser:
-          enableTypes: ["json", "form", "text"]
-          extendTypes: { text: ["text/xml", "application/xml"] }
-      servers:
-        - host: "localhost"
-          clusters: 1
-          list:
-            - type: "http"
-              server: { port: 8080 }
-            - type: "ws"
-              server: { port: 60300 }
+    chat: { ... }         # 聊天服务
+    web: { ... }          # Web 服务（支持 http/ws 混合）
 ```
 
-- `settings.microservices.<服务名>`：定义各微服务模块的集群配置。
-  - `token`：服务间通信鉴权令牌，防止非法节点接入。
-  - `servers`：服务器集群列表。
-    - `host`：主机地址。
-    - `clusters`：集群实例数量。若大于 1，框架会自动递增 `serviceId` 和端口号生成多个实例。
-    - `list`：该集群对外暴露的协议端点列表。
-      - `type`：协议类型，如 `ws`、`http`。
-      - `server`：端口配置 `{ port }`。
-      - `front: true`：仅 connector 等前置服务需要，表示该节点直接面向客户端。
-      - `timeout`：连接超时时间（毫秒），`0` 表示永不超时。
-      - `connectionLimit`：最大连接数限制。
-      - `disconnectInterval`：断线后重连间隔（毫秒）。
-      - `retry`：消息重试策略。
-        - `retryCount`：最大重试次数。
-        - `retryInterval`：重试间隔。
-        - `timeout`：重试总超时。
-        - `maxMsgNum`：消息队列最大长度。
-        - `increase`：是否递增重试间隔。
+- `settings.microservices.<服务名>`：各微服务模块配置
+- `token`：服务间通信鉴权令牌；`clusters`：集群实例数（自动递增端口号）
+- `front: true`：标记为面向客户端的前置节点
+- `retry`：消息重试策略（retryCount/retryInterval/timeout/maxMsgNum/increase）
 
 ## 生命周期钩子
 
@@ -513,23 +374,9 @@ import { ApplicationStart, ApplicationStop, ApplicationInit } from "@fastcar/cor
 
 @Component
 class LifecycleService {
-  // 应用启动时执行
-  @ApplicationStart
-  async onStart() {
-    console.log("应用启动");
-  }
-  
-  // 应用停止前执行
-  @ApplicationStop
-  async onStop() {
-    console.log("应用停止");
-  }
-  
-  // 初始化（配合 @ApplicationRunner）
-  @ApplicationInit
-  async init() {
-    console.log("初始化完成");
-  }
+  @ApplicationStart async onStart() { console.log("应用启动"); }
+  @ApplicationStop async onStop() { console.log("应用停止"); }
+  @ApplicationInit async init() { console.log("初始化完成"); }
 }
 ```
 
@@ -539,18 +386,14 @@ class LifecycleService {
 import { ValidForm, NotNull, Size, Rule } from "@fastcar/core/annotation";
 
 class UserDTO {
-  @NotNull
-  name!: string;
-  
-  @Size({ minSize: 1, maxSize: 150 })
-  age!: number;
+  @NotNull name!: string;
+  @Size({ minSize: 1, maxSize: 150 }) age!: number;
 }
 
 @Controller
 class UserController {
   @ValidForm
   createUser(@Rule() @NotNull user: UserDTO) {
-    // 参数自动校验
     return this.userService.create(user);
   }
 }
@@ -603,56 +446,36 @@ TypeUtil.isClass(MyClass);       // true
 ```bash
 # Web 项目
 mkdir my-web-app && cd my-web-app
-fastcar-cli init web
-npm install
-npm run debug
+fastcar-cli init web && npm install && npm run debug
 
 # Static 项目
 mkdir my-static-app && cd my-static-app
-fastcar-cli init static
-npm install
-npm run debug
+fastcar-cli init static && npm install && npm run debug
 
 # RPC 项目
 mkdir my-rpc-app && cd my-rpc-app
-fastcar-cli init rpc
-npm install
-npm run debug
+fastcar-cli init rpc && npm install && npm run debug
 
 # COS 项目
 mkdir my-cos-app && cd my-cos-app
-fastcar-cli init cos
-npm install
-npm run debug
+fastcar-cli init cos && npm install && npm run debug
 
 # Microservices 项目
 mkdir my-ms-app && cd my-ms-app
-fastcar-cli init microservices
-npm install
-npm run start-node   # 单节点模式（子进程启动全部服务）
-# 或
-npm run start-pm2    # PM2 模式
+fastcar-cli init microservices && npm install
+npm run start-node   # 单节点模式
+# 或 npm run start-pm2    # PM2 模式
 ```
 
 ### 手动创建项目
 
 ```bash
-# 1. 创建项目
 mkdir my-fastcar-app && cd my-fastcar-app
 npm init -y
-
-# 2. 安装依赖
 npm i @fastcar/core @fastcar/koa @fastcar/server
 npm i -D typescript ts-node @types/node
-
-# 3. 初始化 TypeScript
 npx tsc --init
-
-# 4. 启用装饰器（tsconfig.json）
-# "experimentalDecorators": true
-# "emitDecoratorMetadata": true
-
-# 5. 创建入口文件和配置文件，开始开发
+# 启用装饰器（tsconfig.json）: experimentalDecorators, emitDecoratorMetadata
 ```
 
 ## 参考资源

package/src/skill-targets.js

@@ -9,9 +9,9 @@ const TARGETS = {
     name: 'Kimi Code CLI',
     description: 'Kimi Code extension for VS Code',
     globalPaths: {
-      win32: path.join(os.homedir(), 'AppData/Roaming/Code/User/globalStorage/moonshot-ai.kimi-code/skills'),
-      darwin: path.join(os.homedir(), '.config/agents/skills'),
-      linux: path.join(os.homedir(), '.config/agents/skills')
+      win32: path.join(os.homedir(), '.kimi/skills'),
+      darwin: path.join(os.homedir(), '.kimi/skills'),
+      linux: path.join(os.homedir(), '.kimi/skills')
     },
     localPath: '.agents/skills'
   },

package/src/skill.js

@@ -197,9 +197,11 @@ async function installSkill(skillName, options = {}) {
       console.log(`✅ 成功 ${modeText} 安装 ${skillName}`);
       console.log(`   位置: ${destPath}`);
       console.log();
-      console.log('提示:');
-      console.log('  1. 重启你的 AI agent 以使用 skill');
-      console.log(`  2. 在对话中询问关于 "${skillName}" 的内容`);
+      console.log('⚠️  重要: 请重启你的 AI agent 以加载新安装的 skill！');
+      console.log();
+      console.log('重启后，你可以在对话中:');
+      console.log(`  • 直接询问关于 "${skillName}" 的内容`);
+      console.log(`  • 使用 /skill:${skillName} 强制加载该 skill`);
     } else {
       console.log('❌ 安装验证失败');
     }