deepfish-ai 1.0.21 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepfish-ai",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "This is an AI-driven command-line tool built on Node.js, equipped with AI agent and workflow capabilities. It is compatible with a wide range of AI models, can convert natural language into cross-system terminal and file operation commands, and features high extensibility. It supports complex tasks such as translation, content creation, and format conversion, while allowing custom extensions to be automatically generated via AI.",
   "main": "src/index.js",
   "type": "commonjs",

package/src/AgentRobot/AgentRobotFactory/MainAgentRobot.js

@@ -18,9 +18,12 @@ class MainAgentRobot extends BaseAgentRobot {
   _initFiles(opt) {
     this.workspace = opt.workspace || process.cwd() // 工作空间，目录
     this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
+    this.userspace = path.join(this.basespace, 'user-info') // 用户空间，目录
+    this.userInfoFilePath = path.join(this.userspace, 'user.md')
     this.memorySpace = path.join(this.basespace, 'memory') // 记忆空间，目录
     this.agentRecordFilePath = path.join(this.memorySpace, 'agentRecord.json')
     fs.ensureDirSync(this.memorySpace)
+    fs.ensureDirSync(this.userspace)
     // 查看agentRecord.json文件是否存在，不存在则创建
     if (!fs.pathExistsSync(this.agentRecordFilePath)) {
       fs.writeJsonSync(this.agentRecordFilePath, [], { spaces: 2 })
@@ -68,12 +71,6 @@ class MainAgentRobot extends BaseAgentRobot {
     fs.writeJsonSync(this.agentRecordFilePath, agentRecord, { spaces: 2 })
     this.logger = new Logger(this) // 初始化日志系统
     this.logger.clearAllLogs()
-    this.toolCollection = AttachmentToolScanner.getToolCollection(
-      this.workspace,
-    ) // 加载工具集合
-    this.clawSkillCollection = AttachmentToolScanner.getClawSkillCollection(
-      this.basespace,
-    ) // 加载Claw技能集合
   }
 
   _getDefaultSystemPrompt(opt) {
@@ -82,7 +79,7 @@ class MainAgentRobot extends BaseAgentRobot {
 ${systemPrompt}
 ### 工具调用
 对于复杂的任务，先从可以使用的Skills中查找并使用合适的Skill，如果没有合适的Skill，再使用内置工具函数，使用时请严格按照工具函数的调用方式进行调用。
-${AttachmentToolScanner.getAttachToolPrompt(this.toolCollection, this.clawSkillCollection)}
+${AttachmentToolScanner.getAttachToolPrompt(this.toolManager.toolCollection, this.toolManager.clawSkillCollection)}
     `
   }
 }

package/src/AgentRobot/AgentRobotFactory/SubAgentRobot.js

@@ -1,6 +1,5 @@
 const path = require('path')
 const os = require('os')
-const fs = require('fs-extra')
 const BaseAgentRobot = require('../BaseAgentRobot/index.js')
 const Logger = require('../BaseAgentRobot/Logger.js')
 const {AttachmentToolScanner} = require('../BaseAgentRobot/utils/AttachmentToolScanner.js')
@@ -20,6 +19,8 @@ class SubAgentRobot extends BaseAgentRobot {
     this.attachTools = opt.attachTools || []
     this.workspace = opt.workspace || process.cwd() // 工作空间，目录
     this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
+    this.userspace = path.join(this.basespace, 'user-info') // 用户空间，目录
+    this.userInfoFilePath = path.join(this.userspace, 'user.md')
     this.memorySpace = path.join(this.basespace, 'memory') // 记忆空间，目录
     this.agentRecordFilePath = path.join(this.memorySpace, 'agentRecord.json')
     this.agentSpace = path.join(this.memorySpace, this.root.id) // Agent空间，目录
@@ -28,12 +29,6 @@ class SubAgentRobot extends BaseAgentRobot {
     this.logger = new Logger(this) // 初始化日志系统
     this.agentTree = new AgentTree(this)
     this.agentTree.init()
-    this.toolCollection = AttachmentToolScanner.getToolCollection(
-      this.workspace,
-    ) // 加载工具集合
-    this.clawSkillCollection = AttachmentToolScanner.getClawSkillCollection(
-      this.basespace,
-    ) // 加载Claw技能集合
   }
 
   _getDefaultSystemPrompt(opt) {
@@ -42,7 +37,7 @@ class SubAgentRobot extends BaseAgentRobot {
   ${systemPrompt}
   ### 工具调用
   对于复杂的任务，先从可以使用的Skills中查找并使用合适的Skill，如果没有合适的Skill，再使用内置工具函数，使用时请严格按照工具函数的调用方式进行调用。
-  ${AttachmentToolScanner.getAttachToolPrompt(this.toolCollection, this.clawSkillCollection)}
+  ${AttachmentToolScanner.getAttachToolPrompt(this.toolManager.toolCollection, this.toolManager.clawSkillCollection)}
       `
   }
 }

package/src/AgentRobot/AgentRobotFactory/SubSkillAgentRobot.js

@@ -20,6 +20,8 @@ class SubSkillAgentRobot extends BaseAgentRobot {
     this.attachTools = opt.attachTools || []
     this.workspace = opt.workspace || process.cwd() // 工作空间，目录
     this.basespace = opt.basespace || path.join(os.homedir(), '.deepfish-ai') // 记忆空间，目录
+    this.userspace = path.join(this.basespace, 'user-info') // 用户空间，目录
+    this.userInfoFilePath = path.join(this.userspace, 'user.md')
     this.memorySpace = path.join(this.basespace, 'memory') // 记忆空间，目录
     this.agentRecordFilePath = path.join(this.memorySpace, 'agentRecord.json')
     this.agentSpace = path.join(this.memorySpace, this.root.id) // Agent空间，目录
@@ -29,20 +31,13 @@ class SubSkillAgentRobot extends BaseAgentRobot {
     this.logger = new Logger(this) // 初始化日志系统
     this.agentTree = new AgentTree(this)
     this.agentTree.init()
-
-    this.toolCollection = AttachmentToolScanner.getToolCollection(
-      this.workspace,
-    ) // 加载工具集合
-    this.clawSkillCollection = AttachmentToolScanner.getClawSkillCollection(
-      this.basespace,
-    ) // 加载Claw技能集合
   }
 
   _getDefaultSystemPrompt(opt) {
     const clawSkills = opt.clawSkills || []
     let systemPrompt = super._getDefaultSystemPrompt(opt)
     systemPrompt =
-      systemPrompt + '\n' + AttachmentToolScanner.getClawSkillPrompt(clawSkills, this.toolCollection, this.clawSkillCollection)
+      systemPrompt + '\n' + AttachmentToolScanner.getClawSkillPrompt(clawSkills, this.toolManager.toolCollection, this.toolManager.clawSkillCollection)
     return systemPrompt
   }
 }

package/src/AgentRobot/BaseAgentRobot/Brain.js

@@ -70,10 +70,17 @@ class Brain extends EventEmitterSuper {
     if (maxIterations === -1) {
       maxIterations = Infinity
     }
-    const skillDescriptions = this.agentRobot.getToolDescriptions()
+    const skillDescriptions = this.agentRobot.toolManager.descriptions
     this.emit(BrainEvent.THINK_BEFORE, messages)
     while (maxIterations-- > 0) {
       try {
+        // 更新系统提示词
+        if (messages[0].role === 'system') {
+          messages[0] = {
+            role: 'system',
+            content: this.agentRobot.systemPrompt,
+          }
+        }
         // 压缩上下文
         await this.messageCompresser.compress(messages)
         const { message, content, tool_calls } = await thinkByTool(
@@ -180,13 +187,6 @@ class Brain extends EventEmitterSuper {
   }
 
   _initMessages(messages) {
-    let firstMessage = messages[0]
-    if (firstMessage.role === 'system') {
-      messages[0] = {
-        role: 'system',
-        content: this.agentRobot.systemPrompt,
-      }
-    }
     let lastMessage = messages[messages.length - 1]
     while (
       messages.length > 1 &&

package/src/AgentRobot/BaseAgentRobot/Hand.js

@@ -12,7 +12,7 @@ class Hand extends EventEmitterSuper {
     super()
     this.agentRobot = agentRobot
     this.maxBlockFileSize = agentRobot.opt.maxBlockFileSize || 20 // KB
-    this.tools = agentRobot.getTools()
+    this.tools = agentRobot.toolManager.functions
   }
 
   _parseToolCalls(tool_call) {
@@ -57,7 +57,7 @@ class Hand extends EventEmitterSuper {
   }
 
   _getRequiredParamNames(funcName) {
-    const descriptions = this.agentRobot.getToolDescriptions()
+    const descriptions = this.agentRobot.toolManager.descriptions
     const current = descriptions.find((item) => item?.function?.name === funcName)
     return current?.function?.parameters?.required || []
   }
@@ -89,7 +89,7 @@ class Hand extends EventEmitterSuper {
                 toolContent = {
                   truncated: true,
                   message:
-                    '文件内容过大，请使用executeJSCode工具编写脚本分块读取和处理文件，避免一次性读取整个文件内容到对话中。',
+                    '文件内容过大，请使用executeJSCode工具编写脚本分块读取和处理文件，避免一次性读取整个文件内容到对话中。如果不是本地文件，建议创建或下载成本地文件后再进行分块读取。',
                   preview: toolContent.substring(0, 1000) + '...',
                 }
               } else {

package/src/AgentRobot/BaseAgentRobot/index.js

@@ -1,25 +1,10 @@
 const path = require('path')
 const os = require('os')
-const fs = require('fs-extra')
-const FileTools = require('./tools/FileTools.js')
-const InquirerTools = require('./tools/InquirerTools.js')
-const SystemTools = require('./tools/SystemTools.js')
-const CreateAgentTools = require('./tools/CreateAgentTools.js')
-const lodash = require('lodash')
 const { Brain } = require('./Brain.js')
 const BrainEvent = require('./BrainEvent.js')
 const ScreenPrinter = require('./ScreenPrinter.js')
 const { HandEvent, Hand } = require('./Hand.js')
-const dayjs = require('dayjs')
-const Logger = require('./Logger.js')
-const GenerateTools = require('./tools/GenerateTools.js')
-const TaskTools = require('./tools/TaskTools.js')
-const TestTools = require('./tools/TestTools.js')
-const axios = require('axios')
-const echarts = require('echarts')
-const canvas = require('canvas')
-const cheerio = require('cheerio')
-const puppeteer = require('puppeteer')
+const AIToolManager = require('./utils/AIToolManager.js')
 
 class BaseAgentRobot {
   id = '' // Agentid
@@ -27,8 +12,7 @@ class BaseAgentRobot {
 
   brain = null // 大脑，负责思考、记忆、决策
   hand = null // 手，负责使用工具
-  originalTools = null // 原装工具
-  attachTools = null // 附加工具, Agent后续安装的工具函数
+  
   heart = null // 心脏，负责心跳、连接
   sender = null // 发送器，负责发送消息
   receiver = null // 接收器，负责接收消息
@@ -42,12 +26,14 @@ class BaseAgentRobot {
 
   workspace = null
   basespace = null
+  userspace = null
   memorySpace = null
   agentRecordFilePath = null
   agentSpace = null
   agentTree = null
   memoryFilePath = null
   logDirPath = null
+  toolManager = null
 
   constructor(
     opt = {
@@ -62,6 +48,7 @@ class BaseAgentRobot {
       maxBlockFileSize: 20, // 大文件分块阈值，单位KB；超过该大小的文件需要分块处理
       systemPrompt: '', // 系统提示语
       encoding: 'auto', // 命令行编码格式, 可设置为utf-8、gbk等, 也可以设置成auto或空值自动判断
+      isThinkPrint: true, // 是否打印思考过程
       aiConfig: {
         name: 'deepseek',
         type: 'deepseek',
@@ -81,9 +68,7 @@ class BaseAgentRobot {
     this.name = opt.name || 'AgentRobot'
     this.screenPrinter = new ScreenPrinter() // 屏幕打印机
     this._initFiles(opt) // 初始化文件
-
-    this.originalTools = this._getOriginalTools() // 天赋技能
-    this.attachTools = opt.attachTools || [] // 附加工具, Agent后续安装的工具函数
+    this.toolManager = new AIToolManager(this)
     this.systemPrompt = opt.systemPrompt || this._getDefaultSystemPrompt(opt) // 系统提示语
     this.brain = new Brain(this) // 初始化大脑
     this.hand = new Hand(this) // 初始化手
@@ -95,10 +80,11 @@ class BaseAgentRobot {
 
   _initEvents() {
     const aiConfig = this.opt.aiConfig
+    const isThinkPrint = this.opt.isThinkPrint
     let stopLoading = null
     this.brain.on(BrainEvent.THINK_BEFORE, () => {})
     this.brain.on(BrainEvent.SUB_THINK_BEFORE, (messages) => {
-      if (!aiConfig.stream) {
+      if (!aiConfig.stream || !isThinkPrint) {
         if (stopLoading) {
           stopLoading('I have finished thinking.')
         }
@@ -106,27 +92,27 @@ class BaseAgentRobot {
       }
     })
     this.brain.on(BrainEvent.SUB_THINK_AFTER, (messages) => {
-      if (!aiConfig.stream && stopLoading) {
+      if ((!aiConfig.stream && stopLoading) || !isThinkPrint) {
         stopLoading('I have finished thinking.')
         stopLoading = null
-        const lastMessage = messages[messages.length - 1]
-        this.screenPrinter.logInfo(lastMessage?.content)
+        // const lastMessage = messages[messages.length - 1]
+        // this.screenPrinter.logInfo(lastMessage?.content)
       }
     })
     this.brain.on(BrainEvent.SUB_STREAM_THINK_OUTPUT, (messages, output) => {
-      this.screenPrinter.streamOutput(output, '#47854a')
+      isThinkPrint && this.screenPrinter.streamOutput(output, '#47854a')
     })
     this.brain.on(BrainEvent.SUB_STREAM_CONTENT_OUTPUT, (messages, content) => {
-      this.screenPrinter.streamOutput(content, '#c2a654')
+      isThinkPrint && this.screenPrinter.streamOutput(content, '#c2a654')
     })
     this.brain.on(
       BrainEvent.SUB_STREAM_TOOL_CALLS_OUTPUT,
       (messages, toolCalls) => {
-        this.screenPrinter.streamOutput(toolCalls, '#47854a')
+        isThinkPrint && this.screenPrinter.streamOutput(toolCalls, '#47854a')
       },
     )
     this.brain.on(BrainEvent.SUB_STREAM_END, () => {
-      this.screenPrinter.streamLineBreak()
+      isThinkPrint && this.screenPrinter.streamLineBreak()
     })
     this.brain.on(BrainEvent.SUB_USE_TOOL, async (toolCalls) => {
       await this.hand.useTools(toolCalls)
@@ -189,71 +175,6 @@ class BaseAgentRobot {
     })
   }
 
-  loadAttachTool(toolName) {
-      let tool = this.attachTools.find((t) => t.name === toolName)
-      if (!tool) {
-        tool = this.toolCollection.find((t) => t.name === toolName)
-        this.attachTools.push(tool)
-      }
-  }
-
-  getTools() {
-    const tools = [...this.originalTools, ...this.attachTools]
-    const toolFunctions = {
-      fs,
-      axios,
-      dayjs,
-      lodash,
-      canvas,
-      echarts,
-      cheerio,
-      puppeteer
-    }
-    
-    tools.forEach((tool) => {
-      Object.assign(toolFunctions, tool.functions)
-    })
-    toolFunctions.agentRobot = this
-    toolFunctions.Tools = toolFunctions
-    // 兼容老版本
-    toolFunctions.aiCli = {
-      Tools: toolFunctions,
-    }
-    return toolFunctions
-  }
-
-  getToolDescriptions() {
-    const tools = [...this.originalTools, ...this.attachTools]
-    const toolDescriptions = []
-    tools.forEach((tool) => {
-      const descriptions = tool.descriptions.map((item) => {
-        if (!item.type) {
-          return {
-            type: 'function',
-            function: item,
-          }
-        } else {
-          return item
-        }
-      })
-      toolDescriptions.push(...descriptions)
-    })
-    return toolDescriptions
-  }
-
-  // 获取原装工具
-  _getOriginalTools() {
-    return [
-      FileTools,
-      InquirerTools,
-      SystemTools,
-      CreateAgentTools,
-      GenerateTools,
-      TaskTools,
-      TestTools,
-    ]
-  }
-
   _getDefaultSystemPrompt(opt) {
     const osType = process.platform
     const workspace = this.workspace
@@ -268,7 +189,7 @@ class BaseAgentRobot {
 语言类型: 与用户输入语言一致
 
 ### 工具使用
-执行任务前，应仔细阅读工具描述以及可以使用的Skills的描述内容，选择最合适的工具或技能来完成任务。
+执行任务前，应仔细阅读工具描述以及可以使用的Skills的描述内容，优先使用匹配到的工具或技能，避免自己发挥。
 
 ### 大文本文件处理规则（分步执行）
 处理长文档等大文件（单文件＞${maxBlockFileSize}KB）时，必须按以下步骤分块处理：
@@ -283,6 +204,15 @@ class BaseAgentRobot {
 3. 结果校验：任务完成后，需简单校验结果是否符合用户目标（如文件是否生成、内容是否完整），并向用户反馈校验结果。
 4. 如果执行任务过程中需要安装依赖、软件或工具，必须通过调用用户交互函数与用户交互，等待用户确认后再执行安装，除非用户明确说明执行过程中使用静默模式。
 5. 任务执行过程中，产生的所有临时文件（如分块文件、测试文件等）必须以"tmp_"为前缀命名，如"tmp_block_filename.txt、tmp_test_filename.txt、tmp_bak_filename.txt"，并在任务完成后删除这些临时文件，确保工作目录整洁。
+
+### 用户信息
+#### 用户信息记录规则
+当对话中出现用户信息时，如个人基础信息（如姓名、年龄、职业、兴趣、性格特征）、操作习惯、代码习惯、阅读习惯、常用目录、文档收藏夹目录等，必须使用用户信息读写函数进行记录。
+
+#### 当前用户信息
+----user info start----
+${this.toolManager.functions.readUserInfo()}
+----user info end----
     `
   }
 

package/src/AgentRobot/BaseAgentRobot/lazy-tools/doc-transform.js

@@ -0,0 +1,204 @@
+/**
+ * @Author: Roman 306863030@qq.com
+ * @Description: 文档格式转换工具集（Markdown / HTML / PDF 互转）
+ * 依赖：puppeteer / fs-extra
+ * Word 相关转换（wordToPdf / wordToHtml / wordToMarkdown / markdownToWord / htmlToWord）已集成在 DocxTool 中
+ */
+const path = require('path')
+const fs = require('fs-extra')
+
+// ─── 统一返回结构 ─────────────────────────────────────────────────────────────
+
+function ok(data = null) {
+  return { success: true, data }
+}
+
+function fail(error, data = null) {
+  return { success: false, error: error?.message || String(error), data }
+}
+
+function resolvePath(filePath) {
+  return path.resolve(process.cwd(), filePath)
+}
+
+// ─── 内部辅助 ─────────────────────────────────────────────────────────────────
+
+/**
+ * 使用 puppeteer 将 HTML 字符串渲染为 PDF 文件
+ */
+async function htmlStringToPdf(html, outputPath) {
+  let puppeteer
+  try {
+    puppeteer = require('puppeteer')
+  } catch {
+    throw new Error('puppeteer 未安装，请先执行 npm install puppeteer')
+  }
+  const browser = await puppeteer.launch({ args: ['--no-sandbox', '--disable-setuid-sandbox'] })
+  try {
+    const page = await browser.newPage()
+    await page.setContent(html, { waitUntil: 'networkidle0' })
+    fs.ensureDirSync(path.dirname(outputPath))
+    await page.pdf({ path: outputPath, format: 'A4', printBackground: true })
+  } finally {
+    await browser.close()
+  }
+}
+
+function escapeHtml(str) {
+  return str
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+}
+
+/**
+ * 将 Markdown 文本转换为 HTML 字符串（基础实现，无需额外依赖）
+ */
+function markdownToHtmlString(md) {
+  let html = md
+    // 代码块
+    .replace(/```(\w*)\n([\s\S]*?)```/g, (_, lang, code) =>
+      `<pre><code class="language-${lang}">${escapeHtml(code.trimEnd())}</code></pre>`)
+    // 行内代码
+    .replace(/`([^`]+)`/g, (_, c) => `<code>${escapeHtml(c)}</code>`)
+    // 标题
+    .replace(/^###### (.+)$/gm, '<h6>$1</h6>')
+    .replace(/^##### (.+)$/gm, '<h5>$1</h5>')
+    .replace(/^#### (.+)$/gm, '<h4>$1</h4>')
+    .replace(/^### (.+)$/gm, '<h3>$1</h3>')
+    .replace(/^## (.+)$/gm, '<h2>$1</h2>')
+    .replace(/^# (.+)$/gm, '<h1>$1</h1>')
+    // 水平线
+    .replace(/^[-*_]{3,}$/gm, '<hr>')
+    // 粗斜体
+    .replace(/\*\*\*(.+?)\*\*\*/g, '<strong><em>$1</em></strong>')
+    // 粗体
+    .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
+    .replace(/__(.+?)__/g, '<strong>$1</strong>')
+    // 斜体
+    .replace(/\*(.+?)\*/g, '<em>$1</em>')
+    .replace(/_(.+?)_/g, '<em>$1</em>')
+    // 删除线
+    .replace(/~~(.+?)~~/g, '<del>$1</del>')
+    // 图片
+    .replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '<img alt="$1" src="$2">')
+    // 链接
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>')
+    // 无序列表
+    .replace(/^[ \t]*[-*+] (.+)$/gm, '<li>$1</li>')
+    // 有序列表
+    .replace(/^[ \t]*\d+\. (.+)$/gm, '<li>$1</li>')
+    // 引用
+    .replace(/^> (.+)$/gm, '<blockquote>$1</blockquote>')
+
+  // 将连续 <li> 包裹进 <ul>
+  html = html.replace(/(<li>[\s\S]+?<\/li>)(\n(?!<li>)|$)/g, (_, items) => `<ul>${items}</ul>`)
+
+  // 段落：连续非标签行
+  html = html.replace(/^(?!<[a-z]|$)(.+)$/gm, '<p>$1</p>')
+
+  return `<!DOCTYPE html><html><head><meta charset="utf-8"><style>
+body{font-family:sans-serif;line-height:1.7;max-width:900px;margin:40px auto;padding:0 20px;color:#333}
+h1,h2,h3,h4,h5,h6{margin-top:1.2em}
+pre{background:#f5f5f5;padding:12px;border-radius:4px;overflow:auto}
+code{background:#f0f0f0;padding:2px 4px;border-radius:3px}
+blockquote{border-left:4px solid #ddd;margin:0;padding-left:1em;color:#666}
+table{border-collapse:collapse;width:100%}td,th{border:1px solid #ddd;padding:6px 10px}
+</style></head><body>${html}</body></html>`
+}
+
+// ─── 工具函数 ─────────────────────────────────────────────────────────────────
+
+/**
+ * Markdown 转 PDF
+ */
+async function markdownToPdf(inputPath, outputPath) {
+  try {
+    const fullInput = resolvePath(inputPath)
+    const fullOutput = resolvePath(outputPath)
+    if (!fs.existsSync(fullInput)) {
+      return fail(`File does not exist: ${fullInput}`, { inputPath: fullInput })
+    }
+    const md = fs.readFileSync(fullInput, 'utf8')
+    const html = markdownToHtmlString(md)
+    await htmlStringToPdf(html, fullOutput)
+    return ok({ inputPath: fullInput, outputPath: fullOutput })
+  } catch (error) {
+    return fail(error, { inputPath, outputPath })
+  }
+}
+
+/**
+ * Markdown 转 HTML
+ */
+async function markdownToHtml(inputPath, outputPath) {
+  try {
+    const fullInput = resolvePath(inputPath)
+    const fullOutput = resolvePath(outputPath)
+    if (!fs.existsSync(fullInput)) {
+      return fail(`File does not exist: ${fullInput}`, { inputPath: fullInput })
+    }
+    const md = fs.readFileSync(fullInput, 'utf8')
+    const html = markdownToHtmlString(md)
+    fs.ensureDirSync(path.dirname(fullOutput))
+    fs.writeFileSync(fullOutput, html, 'utf8')
+    return ok({ inputPath: fullInput, outputPath: fullOutput })
+  } catch (error) {
+    return fail(error, { inputPath, outputPath })
+  }
+}
+
+// ─── 工具描述 ─────────────────────────────────────────────────────────────────
+
+const descriptions = [
+  {
+    type: 'function',
+    function: {
+      name: 'markdownToPdf',
+      description:
+        '将 Markdown 文件（.md）转换为 PDF 文件。依赖 puppeteer，转换时应用默认样式。参数：inputPath 为源 .md 路径；outputPath 为输出 .pdf 路径。返回值：对象，包含 success、data（含 inputPath、outputPath）、error。',
+      parameters: {
+        type: 'object',
+        properties: {
+          inputPath: { type: 'string', description: '源 .md 文件路径。' },
+          outputPath: { type: 'string', description: '输出 .pdf 文件路径。' },
+        },
+        required: ['inputPath', 'outputPath'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'markdownToHtml',
+      description:
+        '将 Markdown 文件（.md）转换为 HTML 文件，包含内联样式，可直接在浏览器中打开。参数：inputPath 为源 .md 路径；outputPath 为输出 .html 路径。返回值：对象，包含 success、data（含 inputPath、outputPath）、error。',
+      parameters: {
+        type: 'object',
+        properties: {
+          inputPath: { type: 'string', description: '源 .md 文件路径。' },
+          outputPath: { type: 'string', description: '输出 .html 文件路径。' },
+        },
+        required: ['inputPath', 'outputPath'],
+      },
+    },
+  },
+]
+
+// ─── 导出 ──────────────────────────────────────────────────────────────────────
+
+const functions = {
+  markdownToPdf,
+  markdownToHtml,
+}
+
+const DocTransformTool = {
+  name: 'DocTransformTool',
+  description: '提供 Markdown 与 HTML/PDF 之间的格式互转能力，支持 markdown转pdf、markdown转html。Word 相关转换请使用 DocxTool。',
+  platform: 'all',
+  descriptions,
+  functions,
+  isSystem: true
+}
+
+module.exports = DocTransformTool