foliko 1.0.74 → 1.0.76

package/reports/system-health-report-20260401.md

@@ -0,0 +1,79 @@
+# 系统健康检查报告
+
+**生成时间**: 2026-04-01 02:26:37 (北京时间)
+
+---
+
+## 1. 系统概览
+
+| 项目 | 值 |
+|------|-----|
+| 主机名 | Foliko |
+| 操作系统 | Windows 11 (10.0.26200) |
+| 架构 | x64 |
+| Node.js 版本 | v25.8.1 |
+| 运行时间 | 12 天 4 小时 58 分钟 36 秒 |
+
+---
+
+## 2. CPU 信息
+
+| 项目 | 值 |
+|------|-----|
+| 型号 | 12th Gen Intel(R) Core(TM) i3-1220P |
+| 核心数 | 12 |
+| 当前负载 | 9.63% |
+| 频率 | 1997 MHz |
+
+**状态**: 正常 (负载较低)
+
+---
+
+## 3. 内存信息
+
+| 项目 | 值 |
+|------|-----|
+| 总内存 | 23.75 GB |
+| 已用 | 14.31 GB |
+| 可用 | 9.44 GB |
+| 使用率 | 60.25% |
+
+**状态**: 正常
+
+---
+
+## 4. 网络信息
+
+### 本地网络接口
+| 接口 | IP 地址 | 类型 |
+|------|---------|------|
+| WLAN | 192.168.1.9 | IPv4 |
+| vEthernet (Default Switch) | 172.23.240.1 | IPv4 |
+| Loopback | 127.0.0.1 | IPv4 |
+
+### 公网信息
+| 项目 | 值 |
+|------|-----|
+| 公网 IP | 172.70.46.104 |
+| 位置 | Amsterdam, North Holland, NL |
+| ISP | Cloudflare, Inc. |
+| 时区 | Europe/Amsterdam |
+
+---
+
+## 5. 协同测试总结
+
+本次多 Agent 协同测试成功完成：
+
+| 步骤 | 执行 Agent | 任务 |
+|------|------------|------|
+| 1 | system-assistant | 获取系统完整信息 |
+| 2 | web-assistant | 通过代理获取公网 IP |
+| 3 | code-assistant | 汇总数据生成报告 |
+| 4 | file-assistant | 报告保存到文件 |
+
+**测试结果**: ✅ 所有协同步骤执行成功
+
+---
+
+*此报告由 vb-agent 多子 Agent 协同生成*

package/skills/ambient-agent/SKILL.md

@@ -11,7 +11,9 @@ Ambient Agent 是一个持续后台运行的智能代理，监控事件并主动
 ## 核心概念
 
 ### Goal（目标）
+
 目标是对话式 LLM 派发的任务，包含：
+
 - `title` - 目标标题
 - `description` - 目标描述
 - `priority` - 优先级 1-10
@@ -20,16 +22,19 @@ Ambient Agent 是一个持续后台运行的智能代理，监控事件并主动
 - `state` - 状态：`pending` | `active` | `completed` | `failed`
 
 ### Action（操作）
+
 操作是目标的最小执行单元，有三种类型：
 
-| 类型 | 说明 | 参数 |
-|------|------|------|
-| `tool` | 调用工具 | `name` 工具名, `args` 参数 |
-| `message` | 发送消息 | `content` 消息内容 |
-| `think` | 触发思考 | `topic` 主题, `mode` 模式, `depth` 深度 |
+| 类型      | 说明     | 参数                                    |
+| --------- | -------- | --------------------------------------- |
+| `tool`    | 调用工具 | `name` 工具名, `args` 参数              |
+| `message` | 发送消息 | `content` 消息内容                      |
+| `think`   | 触发思考 | `topic` 主题, `mode` 模式, `depth` 深度 |
 
 ### Event（事件）
+
 目标可以监听框架事件：
+
 - `tool:result` - 工具执行结果
 - `scheduler:reminder` - 定时提醒
 - `agent:message` - 代理消息
@@ -76,7 +81,7 @@ await ambient_goals({ action: 'activate', goalId: 'xxx-xxx' })
 ### ambient_status - 获取状态
 
 ```javascript
-await ambient_status({})
+await ambient_status({});
 // 返回: { running, tickCount, activeGoals, pendingGoals, recentActivities }
 ```
 
@@ -84,11 +89,11 @@ await ambient_status({})
 
 ```javascript
 await ambient_think({
-  goalId: 'xxx-xxx',  // 可选，关联目标
-  mode: 'reflect',     // reflect | brainstorm | plan | analyze
-  topic: '反思主题',    // 可选
-  depth: 2              // 可选，1-5
-})
+  goalId: 'xxx-xxx', // 可选，关联目标
+  mode: 'reflect', // reflect | brainstorm | plan | analyze
+  topic: '反思主题', // 可选
+  depth: 2, // 可选，1-5
+});
 ```
 
 ### ambient_remember - 记忆管理
@@ -98,37 +103,37 @@ await ambient_think({
 await ambient_remember({
   action: 'store',
   key: 'user-preference',
-  content: '用户喜欢在早上收到摘要'
-})
+  content: '用户喜欢在早上收到摘要',
+});
 
 // 检索最近记忆
 await ambient_remember({
   action: 'retrieve',
-  limit: 10
-})
+  limit: 10,
+});
 
 // 搜索记忆
 await ambient_remember({
   action: 'search',
-  query: '邮件'
-})
+  query: '邮件',
+});
 ```
 
 ### ambient_control - 控制循环
 
 ```javascript
 // 暂停
-await ambient_control({ action: 'pause' })
+await ambient_control({ action: 'pause' });
 
 // 恢复
-await ambient_control({ action: 'resume' })
+await ambient_control({ action: 'resume' });
 
 // 调整参数
 await ambient_control({
   action: 'adjust',
-  tickInterval: 10000,    // 新 tick 间隔（毫秒）
-  cooldownPeriod: 5000    // 新冷却时间（毫秒）
-})
+  tickInterval: 10000, // 新 tick 间隔（毫秒）
+  cooldownPeriod: 5000, // 新冷却时间（毫秒）
+});
 ```
 
 ## action 与 step 的关系
@@ -144,6 +149,7 @@ think     → think
 ```
 
 这意味着：
+
 - 变量引用语法一致：`${variableName}`（Ambient Agent 使用 `${}`)
 - sessionId 传递机制一致
 - 错误处理方式一致
@@ -154,12 +160,12 @@ think     → think
 
 ```javascript
 // context.variables 中可用
-context.variables._event      // 触发的事件数据（如果有）
-context.variables._action     // 当前执行的 action 对象
-context.variables.loopIndex   // 循环索引（如果被 loop 执行）
+context.variables._event; // 触发的事件数据（如果有）
+context.variables._action; // 当前执行的 action 对象
+context.variables.loopIndex; // 循环索引（如果被 loop 执行）
 
 // context.input 中可用
-context.input                 // 工作流/目标输入参数
+context.input; // 工作流/目标输入参数
 ```
 
 ## 变量引用语法
@@ -185,6 +191,7 @@ Ambient Agent 使用 `${}` 语法在 action 参数中引用变量：
 ```
 
 **注意**：`email:received` 事件的数据结构：
+
 - `event.from` - 发件人地址
 - `event.subject` - 邮件主题
 - `event.text` - 邮件正文（纯文本）
@@ -201,7 +208,7 @@ actions: [
     id: 'read-email',
     type: 'tool',
     name: 'email_read',
-    args: { limit: 1, unreadOnly: true }
+    args: { limit: 1, unreadOnly: true },
   },
   {
     id: 'process',
@@ -209,15 +216,16 @@ actions: [
     name: 'some_processor',
     args: {
       // 引用 read-email 输出的 emails 数组的第一个元素的 from 字段
-      sender: '${read-email.output.emails[0].from}'
-    }
-  }
-]
+      sender: '${read-email.output.emails[0].from}',
+    },
+  },
+];
 ```
 
 ### 3. 变量解析规则
 
 `${}` 语法支持嵌套属性访问：
+
 - `${event.from}` - 直接字段
 - `${actionId.output.field}` - 嵌套字段
 - `${event.data.xxx}` - data 对象内的字段（兼容性别名）
@@ -233,6 +241,7 @@ actions: [
 ## 示例：创建邮件自动回复目标
 
 **重要**：`email:received` 事件的数据结构：
+
 - `event.from` - 发件人地址
 - `event.subject` - 邮件主题
 - `event.text` - 邮件正文（纯文本）
@@ -255,25 +264,26 @@ await ambient_goals({
         to: '${event.from}',
         subject: '${event.subject}',
         body: '${event.text}',
-        from: ''
-      }
+        from: '',
+      },
     },
     {
       id: 'mark-read',
       type: 'tool',
       name: 'email_mark_read',
       args: {
-        messageId: '${event.messageId}'
-      }
-    }
+        messageId: '${event.messageId}',
+      },
+    },
   ],
   conditions: {
-    events: ['email:received']
-  }
-})
+    events: ['email:received'],
+  },
+});
 ```
 
 **错误示例**（缺少参数）：
+
 ```javascript
 // ❌ 错误 - 没有传递必需参数
 { type: 'tool', name: 'email_auto_reply', args: {} }

package/skills/foliko-dev/AGENTS.md

@@ -24,6 +24,7 @@ User plugins go in `.agent/plugins/` and are **automatically loaded** on bootstr
 ```
 
 **Why folder structure?**
+
 - Supports `package.json` with `main` field for custom entry points
 - Supports `node_modules` for plugin-private dependencies
 - Better organization for complex plugins
@@ -52,50 +53,51 @@ Built-in framework plugins are in `plugins/` directory.
 
 ```javascript
 // .agent/plugins/my-plugin/index.js
-module.exports = function(Plugin) {
+module.exports = function (Plugin) {
   return class MyPlugin extends Plugin {
     constructor(config = {}) {
-      super()
-      this.name = 'my-plugin'
-      this.version = '1.0.0'
-      this.description = '我的插件'
-      this.priority = 10
+      super();
+      this.name = 'my-plugin';
+      this.version = '1.0.0';
+      this.description = '我的插件';
+      this.priority = 10;
     }
 
     install(framework) {
-      const { z } = require('zod')
+      const { z } = require('zod');
       framework.registerTool({
         name: 'my_tool',
         description: '工具描述',
         inputSchema: z.object({
-          param: z.string().describe('参数描述')
+          param: z.string().describe('参数描述'),
         }),
         execute: async (args, framework) => {
-          return { success: true, result: args.param }
-        }
-      })
-      return this
+          return { success: true, result: args.param };
+        },
+      });
+      return this;
     }
 
     uninstall(framework) {
       // cleanup
     }
-  }
-}
+  };
+};
 ```
 
 ### Single-file structure (still supported)
 
 ```javascript
 // .agent/plugins/my-plugin.js
-module.exports = function(Plugin) {
+module.exports = function (Plugin) {
   return class MyPlugin extends Plugin {
     // ... same as above
-  }
-}
+  };
+};
 ```
 
 **Key points:**
+
 - `Plugin` base class passed automatically by system (no require needed)
 - Factory function returns plugin class
 - Use `require('zod')` inside methods
@@ -105,16 +107,16 @@ module.exports = function(Plugin) {
 
 ```javascript
 // plugins/my-plugin.js
-const { Plugin } = require('../src/core/plugin-base')
-const { z } = require('zod')
+const { Plugin } = require('../src/core/plugin-base');
+const { z } = require('zod');
 
 class MyPlugin extends Plugin {
   constructor(config = {}) {
-    super()
-    this.name = 'my-plugin'
-    this.version = '1.0.0'
-    this.description = '我的插件'
-    this.priority = 10
+    super();
+    this.name = 'my-plugin';
+    this.version = '1.0.0';
+    this.description = '我的插件';
+    this.priority = 10;
   }
 
   install(framework) {
@@ -122,37 +124,37 @@ class MyPlugin extends Plugin {
       name: 'my_tool',
       description: '工具描述',
       inputSchema: z.object({
-        param: z.string().describe('参数描述')
+        param: z.string().describe('参数描述'),
       }),
       execute: async (args, framework) => {
-        return { success: true, result: args.param }
-      }
-    })
-    return this
+        return { success: true, result: args.param };
+      },
+    });
+    return this;
   }
 
-  uninstall(framework) { }
+  uninstall(framework) {}
 }
 
-module.exports = { MyPlugin }
+module.exports = { MyPlugin };
 ```
 
 ## Plugin Properties
 
-| Property | Type | Required | Description |
-|----------|------|----------|-------------|
-| `name` | string | ✅ | Unique name |
-| `version` | string | ❌ | Version, default '1.0.0' |
-| `description` | string | ❌ | Description |
-| `priority` | number | ❌ | Load priority, default 10 |
+| Property      | Type   | Required | Description               |
+| ------------- | ------ | -------- | ------------------------- |
+| `name`        | string | ✅       | Unique name               |
+| `version`     | string | ❌       | Version, default '1.0.0'  |
+| `description` | string | ❌       | Description               |
+| `priority`    | number | ❌       | Load priority, default 10 |
 
 ## Lifecycle Methods
 
-| Method | Called When | Required |
-|--------|-------------|----------|
-| `install(framework)` | Plugin installed | ✅ |
-| `start(framework)` | Plugin started | Recommended |
-| `reload(framework)` | Hot reload | Optional |
+| Method                 | Called When        | Required    |
+| ---------------------- | ------------------ | ----------- |
+| `install(framework)`   | Plugin installed   | ✅          |
+| `start(framework)`     | Plugin started     | Recommended |
+| `reload(framework)`    | Hot reload         | Optional    |
 | `uninstall(framework)` | Plugin uninstalled | Recommended |
 
 ## Tool Registration
@@ -180,45 +182,46 @@ install(framework) {
 
 The framework object provides:
 
-| Method | Description |
-|--------|-------------|
-| `framework.registerTool(tool)` | Register tool |
-| `framework.getTools()` | Get all tools |
-| `framework.executeTool(name, args)` | Execute tool |
-| `framework.callTool(name, args)` | Call tool (for installing deps) |
-| `framework.createAgent(config)` | Create Agent |
-| `framework.reloadPlugin(name)` | Reload single plugin |
-| `framework.reloadAllPlugins()` | Reload all plugins |
+| Method                              | Description                     |
+| ----------------------------------- | ------------------------------- |
+| `framework.registerTool(tool)`      | Register tool                   |
+| `framework.getTools()`              | Get all tools                   |
+| `framework.executeTool(name, args)` | Execute tool                    |
+| `framework.callTool(name, args)`    | Call tool (for installing deps) |
+| `framework.createAgent(config)`     | Create Agent                    |
+| `framework.reloadPlugin(name)`      | Reload single plugin            |
+| `framework.reloadAllPlugins()`      | Reload all plugins              |
 
 ## Dependency Management
 
 Use the `install` tool to install npm packages:
 
-| Plugin Type | Install Location | Command |
-|-------------|------------------|---------|
-| **Folder plugin** | `.agent/plugins/plugin-name/node_modules/` | `install({ package: "pkg", path: ".agent/plugins/plugin-name" })` |
-| **Single-file plugin** | `.agent/node_modules/` | `install({ package: "pkg" })` |
+| Plugin Type            | Install Location                           | Command                                                           |
+| ---------------------- | ------------------------------------------ | ----------------------------------------------------------------- |
+| **Folder plugin**      | `.agent/plugins/plugin-name/node_modules/` | `install({ package: "pkg", path: ".agent/plugins/plugin-name" })` |
+| **Single-file plugin** | `.agent/node_modules/`                     | `install({ package: "pkg" })`                                     |
 
 ```javascript
 // Folder plugin - install to plugin directory
 await framework.callTool('install', {
   package: 'axios',
-  path: '.agent/plugins/my-plugin'
-})
+  path: '.agent/plugins/my-plugin',
+});
 
 // Single-file plugin - install to .agent
 await framework.callTool('install', {
-  package: 'zod'
-})
+  package: 'zod',
+});
 
 // Install from package.json
 await framework.callTool('install', {
   file: './my-plugin/package.json',
-  path: '.agent/plugins/my-plugin'
-})
+  path: '.agent/plugins/my-plugin',
+});
 ```
 
 **When encountering `Cannot find module 'xxx'` error:**
+
 1. Identify plugin directory
 2. Call `install` tool with `path` parameter for folder plugins
 3. Reload plugin