foliko 1.0.85 → 1.0.87

package/.agent/plugins/marknative/index.js

@@ -0,0 +1,228 @@
+const { z } = require('zod');
+const path = require('path');
+const fs = require('fs');
+
+module.exports = function (Plugin) {
+  return class MarkNativePlugin extends Plugin {
+    constructor(config = {}) {
+      super();
+      this.name = 'marknative';
+      this.version = '1.0.1';
+      this.description = 'Markdown 转图片插件 - 将 Markdown 转换为 PNG/SVG';
+      this.priority = 10;
+      this.marknative = null;
+      this.checked = false;
+    }
+
+    async _ensureMarkNative() {
+      if (this.checked) return;
+      this.checked = true;
+      
+      this.marknative = await import('marknative');
+    }
+
+    tools = {
+      marknative_render: {
+        description: '将 Markdown 渲染为图片（Base64 编码返回）',
+        inputSchema: z.object({
+          markdown: z.string().describe('Markdown 内容'),
+          format: z.enum(['png', 'svg']).optional().describe('输出格式：png 或 svg，默认 png'),
+          theme: z.string().optional().describe('主题：default, github, solarized, sepia, rose, dark, nord, dracula, ocean, forest'),
+          singlePage: z.boolean().optional().describe('是否渲染为单张图片（默认 false）'),
+          codeTheme: z.string().optional().describe('代码高亮主题（如 github-dark, nord 等）'),
+        }),
+        execute: async (args) => {
+          try {
+            await this._ensureMarkNative();
+            
+            if (!this.marknative) {
+              return {
+                success: false,
+                error: 'marknative 未安装。请运行: cd .agent/plugins/marknative && npm install'
+              };
+            }
+
+            const { renderMarkdown } = this.marknative;
+            
+            const options = {
+              format: args.format || 'png',
+              singlePage: args.singlePage || false
+            };
+            
+            if (args.theme) options.theme = args.theme;
+            if (args.codeTheme) options.codeHighlighting = { theme: args.codeTheme };
+
+            const pages = await renderMarkdown(args.markdown, options);
+            
+            if (pages.length === 0) {
+              return { success: false, error: '渲染失败，无输出' };
+            }
+
+            const page = pages[0];
+            return {
+              success: true,
+              pageCount: pages.length,
+              format: page.format,
+              data: page.format === 'png' ? page.data.toString('base64') : page.data,
+              isBase64: page.format === 'png',
+              message: page.format === 'png' ? 'PNG 图片已生成' : 'SVG 已生成'
+            };
+          } catch (error) {
+            return { success: false, error: error.message };
+          }
+        },
+      },
+
+      marknative_render_to_file: {
+        description: '将 Markdown 渲染为图片并保存到文件',
+        inputSchema: z.object({
+          markdown: z.string().describe('Markdown 内容'),
+          outputPath: z.string().describe('输出文件路径（如 output.png）'),
+          format: z.enum(['png', 'svg']).optional().describe('输出格式，默认根据文件扩展名'),
+          theme: z.string().optional().describe('主题'),
+          codeTheme: z.string().optional().describe('代码高亮主题'),
+        }),
+        execute: async (args) => {
+          try {
+            await this._ensureMarkNative();
+            
+            if (!this.marknative) {
+              return {
+                success: false,
+                error: 'marknative 未安装。请运行: cd .agent/plugins/marknative && npm install'
+              };
+            }
+
+            const { renderMarkdown } = this.marknative;
+            
+            const ext = path.extname(args.outputPath).toLowerCase();
+            const format = args.format || (ext === '.svg' ? 'svg' : 'png');
+
+            const options = { format };
+            if (args.theme) options.theme = args.theme;
+            if (args.codeTheme) options.codeHighlighting = { theme: args.codeTheme };
+
+            const pages = await renderMarkdown(args.markdown, options);
+            
+            const dir = path.dirname(args.outputPath);
+            if (dir && dir !== '.' && !fs.existsSync(dir)) {
+              fs.mkdirSync(dir, { recursive: true });
+            }
+
+            const files = [];
+            for (let i = 0; i < pages.length; i++) {
+              const page = pages[i];
+              const filePath = pages.length === 1 
+                ? args.outputPath 
+                : args.outputPath.replace(/(\.[^.]+)$/, `-${String(i + 1).padStart(2, '0')}$1`);
+              
+              if (page.format === 'png') {
+                fs.writeFileSync(filePath, page.data);
+              } else {
+                fs.writeFileSync(filePath, page.data, 'utf-8');
+              }
+              files.push(filePath);
+            }
+
+            return {
+              success: true,
+              files,
+              pageCount: pages.length,
+              message: `已生成 ${pages.length} 页图片: ${files.join(', ')}`
+            };
+          } catch (error) {
+            return { success: false, error: error.message };
+          }
+        },
+      },
+
+      marknative_preview: {
+        description: '预览 Markdown 渲染效果（返回第一页 Base64）',
+        inputSchema: z.object({
+          markdown: z.string().describe('Markdown 内容'),
+          theme: z.string().optional().describe('主题'),
+          codeTheme: z.string().optional().describe('代码高亮主题'),
+        }),
+        execute: async (args) => {
+          try {
+            await this._ensureMarkNative();
+            
+            if (!this.marknative) {
+              return {
+                success: false,
+                error: 'marknative 未安装。请运行: cd .agent/plugins/marknative && npm install'
+              };
+            }
+
+            const { renderMarkdown } = this.marknative;
+            
+            const options = {
+              format: 'png',
+              singlePage: true
+            };
+            
+            if (args.theme) options.theme = args.theme;
+            if (args.codeTheme) options.codeHighlighting = { theme: args.codeTheme };
+
+            const pages = await renderMarkdown(args.markdown, options);
+            
+            if (pages.length === 0) {
+              return { success: false, error: '预览生成失败' };
+            }
+
+            return {
+              success: true,
+              preview: pages[0].data.toString('base64'),
+              format: 'png'
+            };
+          } catch (error) {
+            return { success: false, error: error.message };
+          }
+        },
+      },
+
+      marknative_get_themes: {
+        description: '获取所有可用的主题列表',
+        inputSchema: z.object({}),
+        execute: async () => {
+          return {
+            success: true,
+            themes: [
+              { name: 'default', description: '默认主题（浅色）' },
+              { name: 'github', description: 'GitHub 风格' },
+              { name: 'solarized', description: 'Solarized 风格' },
+              { name: 'sepia', description: '复古纸张风格' },
+              { name: 'rose', description: '玫瑰粉风格' },
+              { name: 'dark', description: '深色主题' },
+              { name: 'nord', description: 'Nord 风格' },
+              { name: 'dracula', description: 'Dracula 风格' },
+              { name: 'ocean', description: '海洋风格' },
+              { name: 'forest', description: '森林风格' }
+            ],
+            codeThemes: ['github-light', 'github-dark', 'nord', 'dracula', 'solarized-light', 'solarized-dark', 'monokai']
+          };
+        },
+      },
+
+      marknative_status: {
+        description: '检查 marknative 插件状态',
+        inputSchema: z.object({}),
+        execute: async () => {
+          await this._ensureMarkNative();
+          
+          return {
+            success: true,
+            available: this.marknative !== null,
+            message: this.marknative ? 'marknative 已就绪' : 'marknative 未安装，请运行: cd .agent/plugins/marknative && npm install'
+          };
+        },
+      },
+    };
+
+    install(framework) {
+      return this;
+    }
+
+    uninstall(framework) {}
+  };
+};

package/.agent/plugins/marknative/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "marknative-plugin",
+  "version": "1.0.0",
+  "description": "Markdown 转图片插件 - 将 Markdown 转换为 PNG/SVG",
+  "main": "index.js",
+  "keywords": ["markdown", "png", "svg", "image", "render", "foliko", "plugin"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "marknative": "^0.2.0"
+  }
+}

package/.agent/plugins/marknative/update-readme.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+/**
+ * 更新仓库 README 的脚本
+ * 读取所有插件目录，生成插件列表表格
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const REPO_DIR = path.join(__dirname, '..', '..', '..');
+const README_PATH = path.join(REPO_DIR, 'README.md');
+
+// 插件信息
+const plugins = [];
+
+function getPluginInfo(pluginPath) {
+  const indexPath = path.join(pluginPath, 'index.js');
+  const readmePath = path.join(pluginPath, 'README.md');
+  
+  let name = path.basename(pluginPath);
+  let description = '暂无描述';
+  let tools = [];
+  
+  // 读取 README
+  if (fs.existsSync(readmePath)) {
+    const content = fs.readFileSync(readmePath, 'utf-8');
+    const descMatch = content.match(/^#\s+(.+)$/m);
+    if (descMatch) {
+      description = descMatch[1];
+    }
+  }
+  
+  // 读取 index.js 获取工具列表
+  if (fs.existsSync(indexPath)) {
+    const content = fs.readFileSync(indexPath, 'utf-8');
+    const toolMatches = content.match(/^\s{2}(\w+):\s*\{\s*description:/gm);
+    if (toolMatches) {
+      tools = toolMatches.map(m => m.match(/\s{2}(\w+):/)[1]);
+    }
+  }
+  
+  return { name, description, tools };
+}
+
+// 扫描插件目录
+function scanPlugins() {
+  const pluginsDir = path.join(REPO_DIR);
+  
+  if (!fs.existsSync(pluginsDir)) {
+    console.error('Plugins directory not found:', pluginsDir);
+    return;
+  }
+  
+  const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    if (entry.isDirectory() && !entry.name.startsWith('.')) {
+      const pluginPath = path.join(pluginsDir, entry.name);
+      const indexPath = path.join(pluginPath, 'index.js');
+      
+      if (fs.existsSync(indexPath)) {
+        const info = getPluginInfo(pluginPath);
+        plugins.push(info);
+        console.log(`Found plugin: ${info.name}`);
+      }
+    }
+  }
+}
+
+// 生成 README 内容
+function generateReadme() {
+  const pluginTable = plugins.map(p => {
+    const toolList = p.tools.length > 0 
+      ? p.tools.map(t => `| \`${t}\` | - |`).join('\n') 
+      : '| - | - |';
+    
+    return `## ${p.name.charAt(0).toUpperCase() + p.name.slice(1).replace(/-/g, ' ')}\n\n${p.description}\n\n### 工具\n\n| 工具 | 描述 |\n|------|------|\n${toolList}\n`;
+  }).join('\n---\n\n');
+  
+  const pluginListTable = plugins.map(p => {
+    const name = p.name.charAt(0).toUpperCase() + p.name.slice(1).replace(/-/g, ' ');
+    return `| [\`${p.name}\`](#${p.name.toLowerCase()}) | ${p.description} | ✅ 可用 |`;
+  }).join('\n');
+  
+  const pluginToolsTable = plugins.map(p => {
+    return `### ${p.name}\n\n| 工具 | 描述 |\n|------|------|\n${p.tools.map(t => `| \`${t}\` | - |`).join('\n')}\n`;
+  }).join('\n---\n\n');
+  
+  return `# Foliko Plugins
+
+Foliko Agent 框架的插件仓库，为 Foliko 提供扩展功能。
+
+## 插件列表
+
+| 插件 | 描述 | 状态 |
+|------|------|------|
+${pluginListTable}
+
+${pluginToolsTable}
+
+## 安装所有插件
+
+\`\`\`bash
+${plugins.map(p => `folko plugin install ${p.name}`).join('\n')}
+folko reload
+\`\`\`
+
+## 许可证
+
+Apache-2.0
+`;
+}
+
+// 主函数
+function main() {
+  console.log('Scanning plugins...');
+  scanPlugins();
+  
+  console.log(`\nFound ${plugins.length} plugins`);
+  
+  if (plugins.length === 0) {
+    console.log('No plugins found, skipping README update');
+    return;
+  }
+  
+  console.log('\nGenerating README...');
+  const content = generateReadme();
+  
+  fs.writeFileSync(README_PATH, content, 'utf-8');
+  console.log(`README updated: ${README_PATH}`);
+}
+
+main();