foliko 1.0.87 → 1.1.1

package/plugins/session-plugin.js

@@ -39,7 +39,11 @@ class SessionPlugin extends Plugin {
       maxHistoryLength: config.maxHistoryLength || 150,  // 放宽到 150，Agent 已有智能压缩
       autoCleanup: config.autoCleanup||false,  // 默认不开启自动清理，避免误删会话
       cleanupInterval: config.cleanupInterval || 5 * 60 * 1000,  // 5分钟
-      persistToStorage: config.persistToStorage !== false  // 默认持久化到 storage
+      persistToStorage: config.persistToStorage !== false,  // 默认持久化到 storage
+      // Session 钩子配置
+      onSessionStart: config.onSessionStart || null,
+      onSessionEnd: config.onSessionEnd || null,
+      onSessionCreated: config.onSessionCreated || null
     }
     // console.log('SessionPlugin config:', this.config)
     this._framework = null
@@ -287,6 +291,15 @@ class SessionPlugin extends Plugin {
 
     this._sessions.set(id, session)
     this._saveToStorage(session)
+
+    // 触发 session:created 事件
+    this._events.emit('session:created', session)
+
+    // 调用 onSessionCreated 钩子
+    if (this.config.onSessionCreated) {
+      this._callHook(this.config.onSessionCreated, session)
+    }
+
     return session
   }
 
@@ -340,6 +353,15 @@ class SessionPlugin extends Plugin {
         log.warn('Invalid message format, skipping:', { sessionId, message });
         return session;
       }
+
+      // 触发 session:started 事件（首次添加消息时）
+      if (session.messages.length === 0) {
+        this._events.emit('session:started', session)
+        if (this.config.onSessionStart) {
+          this._callHook(this.config.onSessionStart, session)
+        }
+      }
+
       session.messages.push(message)
       session.lastActive = new Date()
 
@@ -483,6 +505,40 @@ class SessionPlugin extends Plugin {
     this._events.off(event, listener)
   }
 
+  /**
+   * 调用会话钩子
+   * @param {Function} hook - 钩子函数
+   * @param {Object} session - 会话对象
+   * @private
+   */
+  _callHook(hook, session) {
+    if (typeof hook === 'function') {
+      try {
+        const result = hook(session)
+        if (result && typeof result.catch === 'function') {
+          result.catch(err => log.warn('Session hook error:', err.message))
+        }
+      } catch (err) {
+        log.warn('Session hook error:', err.message)
+      }
+    }
+  }
+
+  /**
+   * 结束会话（触发 session:ended 事件）
+   * 当会话完成处理时调用
+   * @param {string} sessionId - 会话 ID
+   */
+  endSession(sessionId) {
+    const session = this.getSession(sessionId)
+    if (session) {
+      this._events.emit('session:ended', session)
+      if (this.config.onSessionEnd) {
+        this._callHook(this.config.onSessionEnd, session)
+      }
+    }
+  }
+
   /**
    * 启动自动清理定时器
    */

package/plugins/weixin-plugin.js

@@ -6,7 +6,7 @@
  * - forceLogin: 是否强制重新扫码登录
  * - qrcodeTerminal: 是否在终端渲染二维码 (默认 true)
  */
-
+const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../cli/src/utils/ansi');
 const { Plugin } = require('../src/core/plugin-base')
 const { logger } = require('../src/utils/logger')
 const log = logger.child('WeChat')
@@ -372,8 +372,9 @@ class WeixinPlugin extends Plugin {
       return { agent, sessionId: `weixin_${userId}` }
     }
 
-    // 创建新 agent
-    const agent = this._framework.createSessionAgent(`weixin_${userId}`, {
+    // 创建新 agent - 和 CLI 一样使用 createAgent
+    const agent = this._framework.createAgent({
+      name: `weixin_${userId}`,
       systemPrompt: this.systemPrompt,
       sharedPrompt: `工作目录: {{WORK_DIR}}`,
       metadata: { WORK_DIR: process.cwd() }
@@ -466,14 +467,21 @@ class WeixinPlugin extends Plugin {
     await new Promise((resolve) => setTimeout(resolve, 1000))
 
     try {
-      const result = await agent.chat(text, {
-        sessionId: sessionId
-      })
-      const fullResponse = cleanResponse(result.message || '')
+      // 使用 chatStream 保持和 CLI 一致的行为
+      let fullResponse = '';
+      for await (const chunk of agent.chatStream(text, { sessionId })) {
+        if (chunk.type === 'text') {
+          fullResponse += chunk.text;
+        } else if (chunk.type === 'tool-call') {
+          log.info(`[工具调用] ${chunk.toolName}`);
+        } else if (chunk.type === 'error') {
+          log.warn(' Chat stream error:', chunk.error);
+        }
+      }
+      const response = cleanResponse(fullResponse);
 
-      if (fullResponse) {
-        await this._sendMessageBatch(originalMsg, userId, fullResponse, true)
-        // log.info(` 回复成功 (${fullResponse.length} 字符)`)
+      if (response) {
+        await this._sendMessageBatch(originalMsg, userId, response, true)
       }
     } catch (err) {
       log.error(' Media chat error:', err)
@@ -506,21 +514,23 @@ class WeixinPlugin extends Plugin {
     await new Promise((resolve) => setTimeout(resolve, 1000))
 
     try {
-      // 使用非流式响应
-      const result = await agent.chat(text, {
-        sessionId: sessionId
-      })
-      const fullResponse = cleanResponse(result.message || '')
-
-      // 保存助手回复到历史（使用 SessionPlugin）
-      // if (this._sessionPlugin) {
-      //   this._sessionPlugin.addMessage(sessionId, { role: 'assistant', content: fullResponse })
-      // }
+      // 使用 chatStream 保持和 CLI 一致的行为
+      let fullResponse = '';
+      for await (const chunk of agent.chatStream(text, { sessionId })) {
+        if (chunk.type === 'text') {
+          fullResponse += chunk.text;
+        } else if (chunk.type === 'tool-call') {
+          // 发送工具调用提示
+          log.info(`[工具调用] ${chunk.toolName}`);
+        } else if (chunk.type === 'error') {
+          log.warn(' Chat stream error:', chunk.error);
+        }
+      }
+      const response = cleanResponse(fullResponse);
 
       // 发送回复（超过500字自动分批）
-      if (fullResponse) {
-        await this._sendMessageBatch(originalMsg, userId, fullResponse, true)
-        // log.info(` 回复成功 (${fullResponse.length} 字符)`)
+      if (response) {
+        await this._sendMessageBatch(originalMsg, userId, response, true)
       } else {
         await this._sendMessageBatch(originalMsg, userId, '抱歉，我没有收到有效的回复。', true)
       }

package/skills/find-skills/AGENTS.md

@@ -1,162 +1,162 @@
-# AGENTS.md
-
-This file provides guidance to AI coding agents working on the `skills` CLI codebase.
-
-## Project Overview
-
-`skills` is the CLI for the open agent skills ecosystem.
-
-## Commands
-
-| Command                       | Description                                         |
-| ----------------------------- | --------------------------------------------------- |
-| `skills`                      | Show banner with available commands                 |
-| `skills add <pkg>`            | Install skills from git repos, URLs, or local paths |
-| `skills experimental_install` | Restore skills from skills-lock.json                |
-| `skills experimental_sync`    | Sync skills from node_modules into agent dirs       |
-| `skills list`                 | List installed skills (alias: `ls`)                 |
-| `skills check`                | Check for available skill updates                   |
-| `skills update`               | Update all skills to latest versions                |
-| `skills init [name]`          | Create a new SKILL.md template                      |
-
-Aliases: `skills a` works for `add`. `skills i`, `skills install` (no args) restore from `skills-lock.json`. `skills ls` works for `list`. `skills experimental_install` restores from `skills-lock.json`. `skills experimental_sync` crawls `node_modules` for skills.
-
-## Architecture
-
-```
-src/
-├── cli.ts           # Main entry point, command routing, init/check/update
-├── cli.test.ts      # CLI tests
-├── add.ts           # Core add command logic
-├── add.test.ts      # Add command tests
-├── list.ts          # List installed skills command
-├── list.test.ts     # List command tests
-├── agents.ts        # Agent definitions and detection
-├── installer.ts     # Skill installation logic (symlink/copy) + listInstalledSkills
-├── skills.ts        # Skill discovery and parsing
-├── skill-lock.ts    # Global lock file management (~/.agents/.skill-lock.json)
-├── local-lock.ts    # Local lock file management (skills-lock.json, checked in)
-├── sync.ts          # Sync command - crawl node_modules for skills
-├── source-parser.ts # Parse git URLs, GitHub shorthand, local paths
-├── git.ts           # Git clone operations
-├── telemetry.ts     # Anonymous usage tracking
-├── types.ts         # TypeScript types
-├── mintlify.ts      # Mintlify skill fetching (legacy)
-├── providers/       # Remote skill providers (GitHub, HuggingFace, Mintlify)
-│   ├── index.ts
-│   ├── registry.ts
-│   ├── types.ts
-│   ├── huggingface.ts
-│   └── mintlify.ts
-├── init.test.ts     # Init command tests
-└── test-utils.ts    # Test utilities
-
-tests/
-├── sanitize-name.test.ts     # Tests for sanitizeName (path traversal prevention)
-├── skill-matching.test.ts    # Tests for filterSkills (multi-word skill name matching)
-├── source-parser.test.ts     # Tests for URL/path parsing
-├── installer-symlink.test.ts # Tests for symlink installation
-├── list-installed.test.ts    # Tests for listing installed skills
-├── skill-path.test.ts        # Tests for skill path handling
-├── wellknown-provider.test.ts # Tests for well-known provider
-└── dist.test.ts              # Tests for built distribution
-```
-
-## Update Checking System
-
-### How `skills check` and `skills update` Work
-
-1. Read `~/.agents/.skill-lock.json` for installed skills
-2. For each skill, get `skillFolderHash` from lock file
-3. POST to `https://add-skill.vercel.sh/check-updates` with:
-   ```json
-   {
-     "skills": [{ "name": "...", "source": "...", "skillFolderHash": "..." }],
-     "forceRefresh": true
-   }
-   ```
-4. API fetches fresh content from GitHub, computes hash, compares
-5. Returns list of skills with different hashes (updates available)
-
-### Why `forceRefresh: true`?
-
-Both `check` and `update` always send `forceRefresh: true`. This ensures the API fetches fresh content from GitHub rather than using its Redis cache.
-
-**Without forceRefresh:** Users saw phantom "updates available" due to stale cached hashes. The fix was to always fetch fresh.
-
-**Tradeoff:** Slightly slower (GitHub API call per skill), but always accurate.
-
-### Lock File Compatibility
-
-The lock file format is v3. Key field: `skillFolderHash` (GitHub tree SHA for the skill folder).
-
-If reading an older lock file version, it's wiped. Users must reinstall skills to populate the new format.
-
-## Key Integration Points
-
-| Feature                    | Implementation                              |
-| -------------------------- | ------------------------------------------- |
-| `skills add`               | `src/add.ts` - full implementation          |
-| `skills experimental_sync` | `src/sync.ts` - crawl node_modules          |
-| `skills check`             | `POST /check-updates` API                   |
-| `skills update`            | `POST /check-updates` + reinstall per skill |
-
-## Development
-
-```bash
-# Install dependencies
-pnpm install
-
-# Build
-pnpm build
-
-# Test locally
-pnpm dev add vercel-labs/agent-skills --list
-pnpm dev experimental_sync
-pnpm dev check
-pnpm dev update
-pnpm dev init my-skill
-
-# Run all tests
-pnpm test
-
-# Run specific test file(s)
-pnpm test tests/sanitize-name.test.ts
-pnpm test tests/skill-matching.test.ts tests/source-parser.test.ts
-
-# Type check
-pnpm type-check
-
-# Format code
-pnpm format
-```
-
-## Code Style
-
-This project uses Prettier for code formatting. **Always run `pnpm format` before committing changes** to ensure consistent formatting.
-
-```bash
-# Format all files
-pnpm format
-
-# Check formatting without fixing
-pnpm prettier --check .
-```
-
-CI will fail if code is not properly formatted.
-
-## Publishing
-
-```bash
-# 1. Bump version in package.json
-# 2. Build
-pnpm build
-# 3. Publish
-npm publish
-```
-
-## Adding a New Agent
-
-1. Add the agent definition to `src/agents.ts`
-2. Run `pnpm run -C scripts validate-agents.ts` to validate
-3. Run `pnpm run -C scripts sync-agents.ts` to update README.md
+# AGENTS.md
+
+This file provides guidance to AI coding agents working on the `skills` CLI codebase.
+
+## Project Overview
+
+`skills` is the CLI for the open agent skills ecosystem.
+
+## Commands
+
+| Command                       | Description                                         |
+| ----------------------------- | --------------------------------------------------- |
+| `skills`                      | Show banner with available commands                 |
+| `skills add <pkg>`            | Install skills from git repos, URLs, or local paths |
+| `skills experimental_install` | Restore skills from skills-lock.json                |
+| `skills experimental_sync`    | Sync skills from node_modules into agent dirs       |
+| `skills list`                 | List installed skills (alias: `ls`)                 |
+| `skills check`                | Check for available skill updates                   |
+| `skills update`               | Update all skills to latest versions                |
+| `skills init [name]`          | Create a new SKILL.md template                      |
+
+Aliases: `skills a` works for `add`. `skills i`, `skills install` (no args) restore from `skills-lock.json`. `skills ls` works for `list`. `skills experimental_install` restores from `skills-lock.json`. `skills experimental_sync` crawls `node_modules` for skills.
+
+## Architecture
+
+```
+src/
+├── cli.ts           # Main entry point, command routing, init/check/update
+├── cli.test.ts      # CLI tests
+├── add.ts           # Core add command logic
+├── add.test.ts      # Add command tests
+├── list.ts          # List installed skills command
+├── list.test.ts     # List command tests
+├── agents.ts        # Agent definitions and detection
+├── installer.ts     # Skill installation logic (symlink/copy) + listInstalledSkills
+├── skills.ts        # Skill discovery and parsing
+├── skill-lock.ts    # Global lock file management (~/.agents/.skill-lock.json)
+├── local-lock.ts    # Local lock file management (skills-lock.json, checked in)
+├── sync.ts          # Sync command - crawl node_modules for skills
+├── source-parser.ts # Parse git URLs, GitHub shorthand, local paths
+├── git.ts           # Git clone operations
+├── telemetry.ts     # Anonymous usage tracking
+├── types.ts         # TypeScript types
+├── mintlify.ts      # Mintlify skill fetching (legacy)
+├── providers/       # Remote skill providers (GitHub, HuggingFace, Mintlify)
+│   ├── index.ts
+│   ├── registry.ts
+│   ├── types.ts
+│   ├── huggingface.ts
+│   └── mintlify.ts
+├── init.test.ts     # Init command tests
+└── test-utils.ts    # Test utilities
+
+tests/
+├── sanitize-name.test.ts     # Tests for sanitizeName (path traversal prevention)
+├── skill-matching.test.ts    # Tests for filterSkills (multi-word skill name matching)
+├── source-parser.test.ts     # Tests for URL/path parsing
+├── installer-symlink.test.ts # Tests for symlink installation
+├── list-installed.test.ts    # Tests for listing installed skills
+├── skill-path.test.ts        # Tests for skill path handling
+├── wellknown-provider.test.ts # Tests for well-known provider
+└── dist.test.ts              # Tests for built distribution
+```
+
+## Update Checking System
+
+### How `skills check` and `skills update` Work
+
+1. Read `~/.agents/.skill-lock.json` for installed skills
+2. For each skill, get `skillFolderHash` from lock file
+3. POST to `https://add-skill.vercel.sh/check-updates` with:
+   ```json
+   {
+     "skills": [{ "name": "...", "source": "...", "skillFolderHash": "..." }],
+     "forceRefresh": true
+   }
+   ```
+4. API fetches fresh content from GitHub, computes hash, compares
+5. Returns list of skills with different hashes (updates available)
+
+### Why `forceRefresh: true`?
+
+Both `check` and `update` always send `forceRefresh: true`. This ensures the API fetches fresh content from GitHub rather than using its Redis cache.
+
+**Without forceRefresh:** Users saw phantom "updates available" due to stale cached hashes. The fix was to always fetch fresh.
+
+**Tradeoff:** Slightly slower (GitHub API call per skill), but always accurate.
+
+### Lock File Compatibility
+
+The lock file format is v3. Key field: `skillFolderHash` (GitHub tree SHA for the skill folder).
+
+If reading an older lock file version, it's wiped. Users must reinstall skills to populate the new format.
+
+## Key Integration Points
+
+| Feature                    | Implementation                              |
+| -------------------------- | ------------------------------------------- |
+| `skills add`               | `src/add.ts` - full implementation          |
+| `skills experimental_sync` | `src/sync.ts` - crawl node_modules          |
+| `skills check`             | `POST /check-updates` API                   |
+| `skills update`            | `POST /check-updates` + reinstall per skill |
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Test locally
+pnpm dev add vercel-labs/agent-skills --list
+pnpm dev experimental_sync
+pnpm dev check
+pnpm dev update
+pnpm dev init my-skill
+
+# Run all tests
+pnpm test
+
+# Run specific test file(s)
+pnpm test tests/sanitize-name.test.ts
+pnpm test tests/skill-matching.test.ts tests/source-parser.test.ts
+
+# Type check
+pnpm type-check
+
+# Format code
+pnpm format
+```
+
+## Code Style
+
+This project uses Prettier for code formatting. **Always run `pnpm format` before committing changes** to ensure consistent formatting.
+
+```bash
+# Format all files
+pnpm format
+
+# Check formatting without fixing
+pnpm prettier --check .
+```
+
+CI will fail if code is not properly formatted.
+
+## Publishing
+
+```bash
+# 1. Bump version in package.json
+# 2. Build
+pnpm build
+# 3. Publish
+npm publish
+```
+
+## Adding a New Agent
+
+1. Add the agent definition to `src/agents.ts`
+2. Run `pnpm run -C scripts validate-agents.ts` to validate
+3. Run `pnpm run -C scripts sync-agents.ts` to update README.md