foliko 1.0.0

package/plugins/think-plugin.js

@@ -0,0 +1,329 @@
+/**
+ * Think 主动思考插件
+ * 支持 LLM 自我唤醒、自动反思、持续思考
+ */
+
+const { Plugin } = require('../src/core/plugin-base')
+const { z } = require('zod')
+
+class ThinkPlugin extends Plugin {
+  constructor(config = {}) {
+    super()
+    this.name = 'think'
+    this.version = '1.0.0'
+    this.description = '主动思考插件，支持 LLM 自我唤醒和持续思考'
+    this.priority = 5  // 高优先级，早期加载
+
+    this.config = {
+      autoReflect: config.autoReflect === true,  // 默认关闭自动反思
+      reflectDelay: config.reflectDelay || 2000,   // 反思延迟(ms)
+      maxReflectDepth: config.maxReflectDepth || 3,  // 最大反思深度
+      enableContinuous: config.enableContinuous || false  // 是否启用持续思考
+    }
+
+    this._framework = null
+    this._thoughts = []  // 思考记录
+    this._reflectionChain = []  // 反思链
+    this._continuousMode = false
+    this._continuousTimer = null
+    this._pendingReflection = null
+  }
+
+  install(framework) {
+    this._framework = framework
+    return this
+  }
+
+  start(framework) {
+    // 注册思考工具
+    framework.registerTool({
+      name: 'think_now',
+      description: '立即触发 LLM 主动思考（用于反思、自我检视、生成想法）',
+      inputSchema: z.object({
+        topic: z.string().optional().describe('思考主题，不提供则让 LLM 自己决定思考什么'),
+        mode: z.enum(['reflect', 'brainstorm', 'analyze', 'plan']).optional().describe('思考模式'),
+        depth: z.number().optional().describe('思考深度 1-5')
+      }),
+      execute: async (args) => {
+        return await this._triggerThinking(args)
+      }
+    })
+
+    framework.registerTool({
+      name: 'think_continue',
+      description: '让 LLM 持续思考模式（后台自动思考，定期输出结果）',
+      inputSchema: z.object({
+        interval: z.number().optional().describe('思考间隔毫秒，默认 30000 (30秒)'),
+        topic: z.string().optional().describe('思考主题')
+      }),
+      execute: async (args) => {
+        return await this._startContinuousThinking(args)
+      }
+    })
+
+    framework.registerTool({
+      name: 'think_stop',
+      description: '停止持续思考模式',
+      inputSchema: z.object({}),
+      execute: async () => {
+        return this._stopContinuousThinking()
+      }
+    })
+
+    framework.registerTool({
+      name: 'think_get_thoughts',
+      description: '获取思考历史记录',
+      inputSchema: z.object({
+        limit: z.number().optional().describe('返回条数，默认 10')
+      }),
+      execute: async (args) => {
+        const limit = args.limit || 10
+        return {
+          success: true,
+          thoughts: this._thoughts.slice(-limit).reverse(),
+          total: this._thoughts.length
+        }
+      }
+    })
+
+    return this
+  }
+
+  /**
+   * 触发主动思考
+   */
+  async _triggerThinking(args) {
+    const mode = args.mode || 'reflect'
+    const depth = Math.min(args.depth || 2, 5)
+    const topic = args.topic || '刚才的对话还有什么可以改进或补充的地方？'
+
+    try {
+      const agent = this._getActiveAgent()
+      if (!agent) {
+        return { success: false, error: 'No active agent found' }
+      }
+
+      const reflectPrompt = this._buildReflectPrompt(mode, depth, topic)
+      const result = await agent.chat(reflectPrompt)
+
+      const thought = {
+        id: Date.now(),
+        mode,
+        depth,
+        topic,
+        prompt: reflectPrompt,
+        result: typeof result === 'string' ? result : JSON.stringify(result),
+        timestamp: new Date()
+      }
+
+      this._thoughts.push(thought)
+      if (this._thoughts.length > 100) {
+        this._thoughts = this._thoughts.slice(-100)
+      }
+
+      // 触发思考完成事件
+      if (this._framework) {
+        this._framework.emit('think:thought_completed', thought)
+      }
+
+      return {
+        success: true,
+        thought,
+        message: `【主动思考完成】\n模式: ${mode}\n主题: ${topic}\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}`
+      }
+    } catch (err) {
+      return { success: false, error: err.message }
+    }
+  }
+
+  /**
+   * 构建反思提示
+   */
+  _buildReflectPrompt(mode, depth, topic) {
+    const depthDesc = {
+      1: '快速检视',
+      2: '简单反思',
+      3: '深入思考',
+      4: '批判性分析',
+      5: '全面审视'
+    }
+
+    const modePrompts = {
+      reflect: `你刚刚完成了一次对话。请${depthDesc[depth]}：
+
+1. 检查回答是否完整、准确
+2. 是否有遗漏的重要信息
+3. 是否有更好的表达方式
+4. 是否需要补充示例或细节
+
+${topic ? `额外关注: ${topic}` : ''}
+
+请直接输出你的反思结果，不需要重复之前的对话内容。`,
+
+      brainstorm: `请进行头脑风暴，针对以下主题产生更多想法：
+
+${topic || '刚才讨论的内容'}
+
+产生至少 3-5 个新的观点或方向，不必拘泥于之前讨论的内容。`,
+
+      analyze: `请对以下主题进行深度分析：
+
+${topic || '刚才讨论的内容'}
+
+分析要点：
+- 根本原因是什么？
+- 有哪些支持/反对的证据？
+- 可能的发展方向？`,
+
+      plan: `基于目前的讨论，请制定下一步计划：
+
+${topic || '接下来的行动'}
+
+计划要具体、可执行，包含时间线和预期结果。`
+    }
+
+    return modePrompts[mode] || modePrompts.reflect
+  }
+
+  /**
+   * 自动反思（响应完成后）
+   */
+  async _autoReflect(data) {
+    if (!this._framework) return
+
+    try {
+      // 检查是否需要反思（避免短时间重复反思）
+      const lastThought = this._thoughts[this._thoughts.length - 1]
+      if (lastThought && Date.now() - lastThought.timestamp.getTime() < 10000) {
+        return  // 10秒内不重复反思
+      }
+
+      const agent = this._getActiveAgent()
+      if (!agent) return
+
+      // 构建轻量级反思
+      const reflectPrompt = `作为助手，请快速检视刚才的回答是否：
+1. 完整回答了用户的问题
+2. 表达清晰易懂
+3. 有没有遗漏关键信息
+
+如果发现不足，请直接补充。如果没问题，请简短回复"检查完毕，无需补充"。`
+
+      // 静默思考，不打断用户
+      const result = await agent.chat(reflectPrompt)
+
+      const thought = {
+        id: Date.now(),
+        mode: 'auto-reflect',
+        topic: '自动检视',
+        result: typeof result === 'string' ? result : '反思完成',
+        timestamp: new Date(),
+        auto: true
+      }
+
+      this._thoughts.push(thought)
+
+      // 如果反思有重要补充，触发事件通知
+      if (typeof result === 'string' && result.includes('补充') && !result.includes('无需补充')) {
+        this._framework.emit('think:reflection_needs_attention', {
+          thought,
+          originalData: data
+        })
+      }
+    } catch (err) {
+      console.error('[Think] Auto-reflect error:', err.message)
+    }
+  }
+
+  /**
+   * 启动持续思考模式
+   */
+  async _startContinuousThinking(args) {
+    if (this._continuousMode) {
+      return { success: false, error: 'Continuous thinking already running' }
+    }
+
+    const interval = args.interval || 30000
+    const topic = args.topic || '基于最近的对话，还有什么值得深入思考的方向？'
+
+    this._continuousMode = true
+    this._continuousTopic = topic
+
+    const runThink = async () => {
+      if (!this._continuousMode) return
+
+      try {
+        await this._triggerThinking({
+          topic: this._continuousTopic,
+          mode: 'reflect',
+          depth: 2
+        })
+
+        // 触发下一轮
+        if (this._continuousMode) {
+          this._continuousTimer = setTimeout(runThink, interval)
+        }
+      } catch (err) {
+        console.error('[Think] Continuous think error:', err.message)
+      }
+    }
+
+    // 立即执行一次
+    await runThink()
+
+    return {
+      success: true,
+      message: `【持续思考已启动】\n间隔: ${interval}ms\n主题: ${topic}\n\nLLM 将定期自动思考并在有新想法时通知你。`
+    }
+  }
+
+  /**
+   * 停止持续思考模式
+   */
+  _stopContinuousThinking() {
+    this._continuousMode = false
+    if (this._continuousTimer) {
+      clearTimeout(this._continuousTimer)
+      this._continuousTimer = null
+    }
+    return {
+      success: true,
+      message: '持续思考已停止'
+    }
+  }
+
+  /**
+   * 获取当前活跃的 Agent
+   */
+  _getActiveAgent() {
+    if (this._framework._agents && this._framework._agents.length > 0) {
+      for (let i = this._framework._agents.length - 1; i >= 0; i--) {
+        const agent = this._framework._agents[i]
+        if (agent.getStatus() === 'idle') {
+          return agent
+        }
+      }
+    }
+    return null
+  }
+
+  /**
+   * 获取待处理的反思通知
+   */
+  getPendingThoughts() {
+    return this._thoughts.slice(-10).reverse()
+  }
+
+  reload(framework) {
+    this._framework = framework
+  }
+
+  uninstall(framework) {
+    this._stopContinuousThinking()
+    this._thoughts = []
+    this._reflectionChain = []
+    this._framework = null
+  }
+}
+
+module.exports = { ThinkPlugin }

package/plugins/tools-plugin.js

@@ -0,0 +1,114 @@
+/**
+ * 工具插件
+ * 提供内置工具和热重载功能
+ */
+
+const { Plugin } = require('../src/core/plugin-base')
+const { z } = require('zod')
+
+class ToolsPlugin extends Plugin {
+  constructor(config = {}) {
+    super()
+    this.name = 'tools'
+    this.version = '1.0.0'
+    this.description = '内置工具插件，提供热重载和工具管理功能'
+    this.priority = 10
+
+    this._framework = null
+  }
+
+  install(framework) {
+    this._framework = framework
+    this._registerBuiltinTools()
+    return this
+  }
+
+  start(framework) {
+    // 工具已通过 install 注册
+  }
+
+  _registerBuiltinTools() {
+    const framework = this._framework
+
+    // 热重载插件工具
+    framework.registerTool({
+      name: 'reload_plugins',
+      description: '热重载插件。可以重载单个指定插件，或重载所有插件。',
+      inputSchema: z.object({
+        pluginName: z.string().optional().describe('可选：指定要重载的插件名称，不指定则重载所有插件')
+      }),
+      execute: async (args) => {
+        try {
+          if (args.pluginName) {
+            await framework.reloadPlugin(args.pluginName)
+            return {
+              success: true,
+              message: `Plugin '${args.pluginName}' reloaded successfully`
+            }
+          } else {
+            await framework.reloadAllPlugins()
+            return {
+              success: true,
+              message: 'All plugins reloaded successfully'
+            }
+          }
+        } catch (err) {
+          return {
+            success: false,
+            error: err.message
+          }
+        }
+      }
+    })
+
+    // 列出已加载插件工具
+    framework.registerTool({
+      name: 'list_plugins',
+      description: '列出所有已加载的插件',
+      inputSchema: z.object({}),
+      execute: async () => {
+        const plugins = framework.pluginManager.getAll()
+        return {
+          success: true,
+          plugins: plugins.map(p => ({
+            name: p.name,
+            version: p.instance?.version
+          }))
+        }
+      }
+    })
+
+    // 获取工具列表
+    framework.registerTool({
+      name: 'list_tools',
+      description: '列出所有已注册的工具',
+      inputSchema: z.object({}),
+      execute: async () => {
+        const tools = framework.getTools()
+        return {
+          success: true,
+          tools: tools.map(t => ({
+            name: t.name,
+            description: t.description
+          }))
+        }
+      }
+    })
+  }
+
+  reload(framework) {
+    console.log('[ToolsPlugin] Reloading...')
+    this._framework = framework
+    this._registerBuiltinTools()
+  }
+
+  uninstall(framework) {
+    // 注销内置工具
+    framework.toolRegistry.unregister('reload_plugins')
+    framework.toolRegistry.unregister('list_plugins')
+    framework.toolRegistry.unregister('list_tools')
+    this._framework = null
+  }
+}
+
+module.exports = { ToolsPlugin }

package/skills/mcp-usage/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: mcp-usage
+description: How to use MCP (Model Context Protocol) tools. Available tools, calling patterns, and best practices.
+allowed-tools: mcp_call, mcp_list_servers, mcp_tool_schema, mcp_reload, Read, Write, Edit, Glob, Grep, execute_command
+---
+
+# MCP Usage Guide
+
+> How to use MCP tools in this environment.
+
+---
+
+## 1. Available Tools
+
+### mcp_list_servers
+
+列出所有已连接的 MCP 服务器及其工具。
+
+```
+mcp_list_servers()
+```
+
+返回示例：
+```json
+{
+  "success": true,
+  "servers": [
+    { "name": "fetch", "tools": [{ "name": "fetch", "description": "..." }] }
+  ]
+}
+```
+
+### mcp_tool_schema
+
+查询工具的完整参数结构，直接返回可复制的调用示例。
+
+```
+mcp_tool_schema({ server: "服务器名", tool: "工具名" })
+```
+
+返回示例：
+```json
+{
+  "success": true,
+  "result": {
+    "name": "fetch",
+    "description": "Fetches a URL from the internet...",
+    "required": ["url"],
+    "example": "{\"url\": \"https://example.com\"}",
+    "fullExample": "mcp_call({ server: \"fetch\", tool: \"fetch\", args_json: '{\"url\": \"https://...\"}' })"
+  }
+}
+```
+
+### mcp_call
+
+调用 MCP 服务器的工具。
+
+```
+mcp_call({
+  server: "服务器名",
+  tool: "工具名",
+  args_json: '{"参数名": "参数值"}'
+})
+```
+
+**重要**：
+- `args_json` 必须是有效的 JSON 字符串
+- 必填参数不能为空
+- 如果不知道参数结构，先用 `mcp_tool_schema` 查询
+
+### mcp_reload
+
+重新加载 MCP 配置。当 `.agent/mcp_config.json` 修改后使用。
+
+```
+mcp_reload()
+```
+
+---
+
+## 2. Calling Patterns
+
+### 简单参数调用
+
+```javascript
+// 调用 fetch 工具获取网页
+mcp_call({
+  server: "fetch",
+  tool: "fetch",
+  args_json: '{"url": "https://news.baidu.com"}'
+})
+```
+
+### 多个参数调用
+
+```javascript
+// 调用搜索工具
+mcp_call({
+  server: "bing-cn-mcp-server",
+  tool: "bing_search",
+  args_json: '{"query": "关键词", "count": 10}'
+})
+```
+
+### 复杂参数调用
+
+对于复杂参数（嵌套对象、数组等）：
+
+1. 先查询参数结构：
+```
+mcp_tool_schema({ server: "服务器", tool: "工具" })
+```
+
+2. 根据返回的 `example` 或 `fullExample` 构造调用
+
+---
+
+## 3. Error Handling
+
+### 参数为空
+
+如果忘记传参数，会返回错误：
+
+```json
+{
+  "success": false,
+  "error": "参数为空！必须提供: url",
+  "hint": "正确格式: {\"url\": \"具体值\"}"
+}
+```
+
+### 参数格式错误
+
+如果 JSON 格式不正确：
+
+```json
+{
+  "success": false,
+  "error": "args_json 格式错误，不是有效的 JSON"
+}
+```
+
+### 服务器不存在
+
+```json
+{
+  "success": false,
+  "error": "MCP server 'xxx' not found"
+}
+```
+
+---
+
+## 4. Configuration
+
+MCP 服务器配置在 `.agent/mcp_config.json`：
+
+```json
+{
+  "mcpServers": {
+    "服务器名": {
+      "type": "sse",
+      "url": "https://...",
+      "headers": {
+        "Authorization": "Bearer xxx"
+      }
+    }
+  }
+}
+```
+
+添加或修改配置后，调用 `mcp_reload()` 重载。
+
+---
+
+## 5. Best Practices
+
+- [ ] 不知道参数时，先用 `mcp_tool_schema` 查询
+- [ ] `args_json` 必须是有效的 JSON 字符串（用单引号包裹整个 JSON）
+- [ ] 必填参数必须提供
+- [ ] 修改配置后用 `mcp_reload()` 重载
+- [ ] 使用前先 `mcp_list_servers` 查看可用服务器
+
+---
+
+## 6. Quick Reference
+
+| 场景 | 操作 |
+|------|------|
+| 查看可用服务器 | `mcp_list_servers()` |
+| 查询参数结构 | `mcp_tool_schema({ server: "x", tool: "y" })` |
+| 调用工具 | `mcp_call({ server: "x", tool: "y", args_json: '{}' })` |
+| 重载配置 | `mcp_reload()` |
+
+---
+
+> **Tip:** 当工具调用失败时，仔细阅读错误信息，它会告诉你缺少什么参数或格式问题。