foliko 2.0.11 → 2.0.13

package/.claude/settings.local.json

@@ -239,7 +239,9 @@
       "Bash(npm start *)",
       "Bash(xxd)",
       "Bash(python fix_ext2.py)",
-      "Bash(npx vitest *)"
+      "Bash(npx vitest *)",
+      "Bash(ls node_modules | wc -l && ls -d node_modules/@* 2>/dev/null | head -5)",
+      "Bash(node -e \"console.log\\(require.resolve\\('croner'\\)\\)\")"
     ]
   }
 }

package/.editorconfig

@@ -1,56 +1,56 @@
-# EditorConfig is awesome: https://EditorConfig.org
-
-# top-most EditorConfig file
-root = true
-
-# 代码文件
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-# JavaScript / Node.js
-[*.{js,jsx,mjs,cjs}]
-indent_style = space
-indent_size = 2
-
-# TypeScript
-[*.{ts,tsx}]
-indent_style = space
-indent_size = 2
-
-# JSON
-[*.json]
-indent_style = space
-indent_size = 2
-
-# YAML
-[*.{yaml,yml}]
-indent_style = space
-indent_size = 2
-
-# Markdown
-[*.md]
-trim_trailing_whitespace = false
-indent_style = space
-indent_size = 2
-
-# Shell
-[*.sh]
-indent_style = space
-indent_size = 2
-
-# PowerShell
-[*.ps1]
-indent_style = space
-indent_size = 4
-
-# Dockerfile
-[Dockerfile]
-indent_style = space
-indent_size = 4
-
-# Makefile
-[Makefile]
-indent_style = tab
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# 代码文件
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# JavaScript / Node.js
+[*.{js,jsx,mjs,cjs}]
+indent_style = space
+indent_size = 2
+
+# TypeScript
+[*.{ts,tsx}]
+indent_style = space
+indent_size = 2
+
+# JSON
+[*.json]
+indent_style = space
+indent_size = 2
+
+# YAML
+[*.{yaml,yml}]
+indent_style = space
+indent_size = 2
+
+# Markdown
+[*.md]
+trim_trailing_whitespace = false
+indent_style = space
+indent_size = 2
+
+# Shell
+[*.sh]
+indent_style = space
+indent_size = 2
+
+# PowerShell
+[*.ps1]
+indent_style = space
+indent_size = 4
+
+# Dockerfile
+[Dockerfile]
+indent_style = space
+indent_size = 4
+
+# Makefile
+[Makefile]
+indent_style = tab

package/.lintstagedrc

@@ -1,7 +1,7 @@
-{
-  "*.{js,jsx,ts,tsx}": ["prettier --write", "git add"],
-  "*.{json,yaml,yml}": ["prettier --write", "git add"],
-  "*.{md,mdx}": ["prettier --write", "git add"],
-  "*.{css,scss,less}": ["prettier --write", "git add"],
-  "*.{html,svg}": ["prettier --write", "git add"]
-}
+{
+  "*.{js,jsx,ts,tsx}": ["prettier --write", "git add"],
+  "*.{json,yaml,yml}": ["prettier --write", "git add"],
+  "*.{md,mdx}": ["prettier --write", "git add"],
+  "*.{css,scss,less}": ["prettier --write", "git add"],
+  "*.{html,svg}": ["prettier --write", "git add"]
+}

package/.prettierignore

@@ -1,29 +1,29 @@
-# 依赖
-node_modules/
-pnpm-lock.yaml
-yarn.lock
-package-lock.json
-
-# 构建输出
-dist/
-build/
-out/
-
-# 插件目录（第三方代码）
-plugins/
-
-# 测试报告
-reports/
-test_report.md
-
-# 配置文件（不需要格式化）
-.env
-.env.example
-
-# 静态资源
-images/
-audio/
-public/
-
-# 锁文件
-*.lock
+# 依赖
+node_modules/
+pnpm-lock.yaml
+yarn.lock
+package-lock.json
+
+# 构建输出
+dist/
+build/
+out/
+
+# 插件目录（第三方代码）
+plugins/
+
+# 测试报告
+reports/
+test_report.md
+
+# 配置文件（不需要格式化）
+.env
+.env.example
+
+# 静态资源
+images/
+audio/
+public/
+
+# 锁文件
+*.lock

package/.prettierrc

@@ -1,11 +1,11 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "es5",
-  "printWidth": 100,
-  "bracketSpacing": true,
-  "arrowParens": "always",
-  "endOfLine": "lf",
-  "plugins": []
-}
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "plugins": []
+}

package/CLAUDE.md

@@ -147,7 +147,7 @@ Provider selection via `config.provider` and AI settings in `.foliko/ai.json`.
 5. **Per-Session Message Storage**: `AgentChatHandler` uses `_sessionMessageStores` Map for Per-Session 消息隔离
 6. **Unified Extension Call**: 扩展工具（普通扩展 / `mcp:<server>` / `skill:<name>`）通过 `ext_skill` + `ext_call` 统一调度
    - `ext_skill({ plugin })` 查询参数 → `ext_call({ plugin, tool, args })` 调用
-   - 普通扩展/MCP/Python：`args` 是结构化对象；Skill 命令：`args: { command: "..." }` 命令行字符串
+   - 扩展调用：`args` 是结构化对象，参数名对应工具定义的字段（camelCase）
 
 ### Built-in Plugins
 

package/Dockerfile

@@ -1,63 +1,63 @@
-# ========== Foliko - 插件化 Agent 框架 ==========
-# 基于 Node.js 20 LTS
-
-FROM node:25-slim
-
-# 安装无头浏览器（Chromium）和构建工具
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    build-essential \
-    python3 \
-    python3-pip \
-    curl \
-    git \
-    wget \
-    gnupg \
-    # Chromium 及依赖
-    chromium \
-    chromium-sandbox \
-    libnss3 \
-    libatk1.0-0 \
-    libatk-bridge2.0-0 \
-    libcups2 \
-    libdrm2 \
-    libxkbcommon0 \
-    libxcomposite1 \
-    libxdamage1 \
-    libxfixes3 \
-    libxrandr2 \
-    libgbm1 \
-    libasound2 \
-    libpango-1.0-0 \
-    libpangocairo-1.0-0 \
-    libgtk-3-0 \
-    fonts-liberation \
-    xdg-utils \
-    && rm -rf /var/lib/apt/lists/* \
-    && ln -sf /usr/bin/python3 /usr/bin/python \
-    && ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
-
-# 设置 Chromium 环境变量（无头模式运行）
-ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
-ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
-ENV CHROME_BIN=/usr/bin/chromium
-
-# 安装 uv（快速的 Python 包管理器）
-RUN curl -LsSf https://astral.sh/uv/install.sh | sh
-ENV PATH="/root/.local/bin:$PATH"
-
-# 设置工作目录
-WORKDIR /app
-
-# 全局安装 foliko CLI
-# RUN npm install -g foliko
-
-# 暴露端口
-# 3000: Web 服务端口
-EXPOSE 3000
-
-# 环境变量（可以在 docker-compose 或运行时覆盖）
-ENV NODE_ENV=production
-
-
-# 默认命令：运行聊天界面
-# CMD ["foliko", "chat"]
+# ========== Foliko - 插件化 Agent 框架 ==========
+# 基于 Node.js 20 LTS
+
+FROM node:25-slim
+
+# 安装无头浏览器（Chromium）和构建工具
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    python3 \
+    python3-pip \
+    curl \
+    git \
+    wget \
+    gnupg \
+    # Chromium 及依赖
+    chromium \
+    chromium-sandbox \
+    libnss3 \
+    libatk1.0-0 \
+    libatk-bridge2.0-0 \
+    libcups2 \
+    libdrm2 \
+    libxkbcommon0 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxfixes3 \
+    libxrandr2 \
+    libgbm1 \
+    libasound2 \
+    libpango-1.0-0 \
+    libpangocairo-1.0-0 \
+    libgtk-3-0 \
+    fonts-liberation \
+    xdg-utils \
+    && rm -rf /var/lib/apt/lists/* \
+    && ln -sf /usr/bin/python3 /usr/bin/python \
+    && ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
+
+# 设置 Chromium 环境变量（无头模式运行）
+ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
+ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
+ENV CHROME_BIN=/usr/bin/chromium
+
+# 安装 uv（快速的 Python 包管理器）
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:$PATH"
+
+# 设置工作目录
+WORKDIR /app
+
+# 全局安装 foliko CLI
+# RUN npm install -g foliko
+
+# 暴露端口
+# 3000: Web 服务端口
+EXPOSE 3000
+
+# 环境变量（可以在 docker-compose 或运行时覆盖）
+ENV NODE_ENV=production
+
+
+# 默认命令：运行聊天界面
+# CMD ["foliko", "chat"]

package/README.md

@@ -391,9 +391,9 @@ allowed-tools: tool1,tool2
 > **统一扩展调用模式**：
 > - 普通扩展：`ext_call({ plugin: "<name>", tool: "<tool>", args: {...} })`
 > - MCP 服务器：`ext_call({ plugin: "mcp:<servername>", tool: "<tool>", args: {...} })`
-> - Skill 命令：`ext_call({ plugin: "skill:<skillname>", tool: "<command>", args: { command: "..." } })`
+> - Skill 命令：`ext_call({ plugin: "skill:<skillname>", tool: "<command>", args: { name: "...", lang: "..." } })`
 > - 调用前先 `ext_skill({ plugin: "<name>" })` 查看参数结构
-> - 普通扩展/MCP/Python：`args` 是结构化对象；Skill 命令：`args: { command: "..." }`
+> - 扩展调用：`args` 是结构化对象，参数名对应工具定义的字段（camelCase）
 
 ### 子 Agent 管理工具
 

package/docs/extensions.md

@@ -45,8 +45,7 @@ ext_call({
 
 | 扩展类型 | args 格式 |
 |---|---|
-| 普通扩展 / MCP / Python | `args: {...}` 结构化对象 |
-| Skill 命令 | `args: { command: "..." }` 命令行字符串 |
+| 普通扩展 / MCP / Python / Skill | `args: {...}` 结构化对象，参数名对应工具定义的字段（camelCase） |
 
 ## 3. MCP 服务器自动注册
 
@@ -118,11 +117,11 @@ module.exports = {
 ext_call({
   plugin: 'skill:my-skill',
   tool: 'greet',
-  args: { command: "-n Claude -l en -s" }
+  args: { name: "Claude", lang: "en", shout: true }
 })
 ```
 
-**args 传 `command` 字符串**，commander.js 解析后 handler 收到 `{ name: 'Claude', lang: 'en', shout: true }`。
+**args 直接传结构化对象**，handler 收到 `{ name: 'Claude', lang: 'en', shout: true }`。
 
 ## 5. Plugin 基类：`this.skill` accessor
 

package/docs/migration.md

@@ -84,15 +84,15 @@ Skill 命令通过 `skill:<name>` 命名空间调用：
 ext_call({
   plugin: "skill:my-skill",  // skill:<name>
   tool: "cmd",               // 命令名（不是 <skill>:<cmd>）
-  args: { command: "-n x -v" }
+  args: { name: "x", verbose: true }
 })
 ```
 
 **要点**：
 - 每个 skill 是独立扩展 `skill:<name>`
 - 命令是该扩展下的 tool
-- `args: { command: "..." }` 传命令行字符串
-- Commander.js 解析后传给 handler
+- `args` 直接传结构化对象，参数名对应 `options` 中定义的字段（camelCase）
+- 不再需要命令行字符串解析
 
 #### 3. ext_skill 返回内容
 

package/docs/usage.md

@@ -198,17 +198,17 @@ module.exports = {
 // 1. 查询参数
 ext_skill({ plugin: "skill:<skillname>" })
 
-// 2. 调用（传命令行字符串）
+// 2. 调用（传结构化参数）
 ext_call({
   plugin: "skill:<skillname>",
   tool: "greet",
-  args: { command: "-n Claude -l en --shout" },
+  args: { name: "Claude", lang: "en", shout: true },
 })
 ```
 
 #### 参数传递
 
-Skill 命令参数通过 `args: { command: "..." }` 传递命令行字符串，由 Commander.js 解析后传给 handler：
+Skill 命令参数直接通过 `args` 对象传递，无需解析命令行字符串：
 
 | flags | 解析后 args 字段 |
 |---|---|