pasAgent

工业级 Pascal 智能体技术体系 —— 让 AI 学会用你的 Pascal 代码

🚀 新手用户看这里！

不想折腾编译和环境配置？直接下载预编译包：

👉 下载预编译包（Pre-built Package）

解压 → 按 MCP_SERVER_DOUBAO_GUIDE.md 操作 → 10 分钟让 AI 调用你的第一个 Pascal 工具。

🎯 一句话定位

让你用 Pascal 写的函数，被 AI 像内置功能一样直接调用。

不需要懂 MCP 协议，不需要写 JSON Schema，不需要搭 HTTP 服务。

🏗️ 工作原理

flowchart LR
    U["你<br/>写 Pascal 函数"] --> P["pascal_agent_service<br/>（信标）"]
    P --> M["mcp_server<br/>（网关）"]
    M -->|MCP 协议| AI["AI 客户端<br/>LM Studio / Claude / 豆包"]
    AI -->|调用工具| M
    M -->|执行| P
    P -.->|返回结果| M
    M -.->|返回结果| AI

    style P fill:#fff4e1
    style M fill:#e1f5ff
    style AI fill:#e1ffe1

核心机制：你写的 Pascal 函数 → 被 mcp_server 翻译 → AI 客户端看到标准工具 → 调用时实际执行你的 Pascal 代码。

🚀 三步上手

flowchart LR
    S1["① 写 Pascal 函数"] --> S2["② 代码生成器<br/>pascal_decl_to_mcp.exe"]
    S2 --> S3["③ 编译 + 启动<br/>AI 就能调用"]

    style S1 fill:#e1f5ff
    style S2 fill:#fff4e1
    style S3 fill:#e1ffe1

完整图文教程：MCP_SERVER_DOUBAO_GUIDE.md

🧩 代码生成器 5 层透明链

flowchart TB
    L0["Layer 0<br/>原始 Pascal 源码"]
    L1["Layer 1<br/>Pascal 声明体"]
    L2["Layer 2<br/>LV0 声明 JSON"]
    L3["Layer 3<br/>LV1 模型 JSON"]
    L4["Layer 4<br/>工具提供者单元"]

    L0 -->|解析| L1
    L1 <-.->|双向| L2
    L2 -->|规范化| L3
    L3 -->|代码生成| L4

    style L2 fill:#e1f5ff
    style L3 fill:#fff4e1
    style L4 fill:#e1ffe1

每一层都可以：独立查看 · 编辑 · 导出 · 喂给 LLM 辅助修正 · 出错时回退重走。

主链路完全确定性——不依赖 LLM 随机性，结果可复现。

📦 组件清单

📁 项目结构

mindmap
  root((src/))
    Pascal 后端
      pascal_agent_service.lpr
      pascal_agent_api.lpr
      lingofuse_helper.pas
      CreateHealthCheck/
    Python 网关
      mcp_server.py
      mcp_proxy.py
      language_middleware.py
      generate_agent_json.py
    代码生成器
      tools/pascal_decl_to_mcp.lpr
    LLM 服务
      llm-service/
    Python 核心绑定
      lingofuse/

你最需要关心的三个文件：

• pascal_agent_api.lpr —— 算术工具示例，你的项目原型
• pascal_agent_service.lpr —— 你要改的服务端源码
• lingofuse_helper.pas —— 写工具时的辅助函数

📚 文档地图

flowchart LR
    subgraph 新手["新手入门"]
        A["MCP_SERVER_DOUBAO_GUIDE<br/>保姆级教程"]
    end

    subgraph 开发["开发者"]
        B["pascal_code_rule<br/>Pascal 声明规范"]
        C["Build_Guide<br/>编译指南"]
        D["Dependency_Installation_Guide<br/>依赖安装"]
    end

    subgraph 部署["部署 & 运维"]
        E["Qwen2.5-7B-Instruct-Q4_K_M<br/>模型下载"]
        F["LingoFuse_LLM_Service_guide<br/>LLM 服务命令行"]
    end

    subgraph 深入["深入了解"]
        G["LingoFuse_MCP_Server_Implementation_Memo<br/>实施备忘"]
        H["LingoFuse_Python_Binding_Migration_Record<br/>迁移与工作总结"]
        I["Local LLM Agent Handbook<br/>智能体原理手册"]
    end

    style A fill:#e1ffe1
    style H fill:#fff4e1

详细链接：

• 🎓 新手教程：MCP_SERVER_DOUBAO_GUIDE.md
• 📐 Pascal 声明规范：pascal_code_rule.md
• 🔨 编译指南：Build_Guide.md
• 📦 依赖安装：Dependency_Installation_Guide.md
• 🤖 模型下载：Qwen2.5-7B-Instruct-Q4_K_M.md
• ⚙️ LLM 服务命令行：LingoFuse_LLM_Service_guide.md
• 🧠 智能体原理手册：Local LLM Agent Handbook CPU First, GPU Optional.md
• 📝 MCP Server 实施备忘：LingoFuse_MCP_Server_Implementation_Memo.md
• 📊 迁移与工作总结报告：LingoFuse_Python_Binding_Migration_Record.md

🔧 运行前准备

pasAgent 所有组件都依赖 LingoFuse 动态库（LingoFuse64.dll / liblingofuse.so）。

flowchart LR
    A["克隆 LingoFuse 仓库"] --> B["将 Binary 目录<br/>加入系统 PATH"]
    B --> C["所有组件<br/>自动找到动态库"]

    style B fill:#fff4e1
    style C fill:#e1ffe1

git clone --recursive https://github.com/PassByYou888/LingoFuse.git
# 然后将 LingoFuse/Binary 目录加入系统 PATH

新手提示：预编译包已内置所需动态库，无需单独安装。

⚠️ 首次运行缺少 DLL？别慌！

如果第一次运行时提示找不到 LingoFuse64.dll / z_ipc_64.dll 等动态库，而你又不想自己编译 LingoFuse：

👉 直接去预编译包发布页找现成的：https://github.com/PassByYou888/LingoFuse-pasAgent/releases/tag/pre_build

那里已经打包好了所有需要的动态库，下载解压即用，省去编译环境折腾。

🌟 关于开放性

pasAgent 是 LingoFuse 的分支项目，两者均为完全开放、非商业性的开源项目。

• ✅ 永久免费：MIT 许可证
• ✅ 无商业捆绑：无收费功能、无付费订阅
• ✅ 社区驱动：决策来自社区贡献者
• ✅ 透明开发：源码全公开，构建可复现

❓ 常见问题

👤 关于作者

老张（QQ: 600585）

看不惯跨语言调用得写一箩筐胶水代码，干脆撸了 LingoFuse；又看不惯 Pascal 老代码接不进 AI 时代，顺手撸了 pasAgent。

欢迎反馈、建议、PR。

📄 许可证

MIT —— 自由使用、修改、分发。

项目始于 2026 年，持续迭代中。有问题提 Issue，急事加 Q。