AI 编程 — 驱动大模型干活

不是调 API 写 demo,是搭能跑的系统。Multi-Agent 架构踩坑、意图解析、工具编排、SaaS 开发,全部实战记录。

项目概览

以下是我从零搭建的 AI 项目,每个都是能跑的系统,不是 demo。点击项目名进入介绍页和开发日记。

项目定位技术栈状态
FinBuddyAI Agent 金融助手Python + Electron持续迭代
FinBuddy_WebFinBuddy Web 后端FastAPI + Vue开发中
Promo_Web智能营销网站生成器FastAPI + Vue已上线
SkillStoreAI 技能市场Flaskv0.1.0
MarketingVideo营销视频生成TypeScript + React开发中
Basic_Web通用 SaaS 脚手架FastAPI + Vue开发中
Basic_Mini微信小程序脚手架原生小程序 + TypeScript开发中

核心心得

FinBuddy — 从 7 个 Agent 砍到 3 个

Swarm 多智能体 DAG 编排,意图解析双层架构,自适应团队组建。代码量最大、踩坑最多的项目。7 个 Agent 听起来很酷,实际上意图解析链路太长、错误层层放大。砍到 3 个核心 Agent + 工具调用,反而更稳定。

class SwarmEngine:
    """Swarm 编排主引擎"""
    _AGENT_CN_NAMES = {
        "fundamental": "基本面分析师",
        "technical": "技术分析师",
        "risk": "风控专家",
        "synthesizer": "首席策略师",
    }

Multi-Agent 架构踩坑

7 个 Agent 协作听起来很酷,实际上意图解析链路太长、错误层层放大。砍到 3 个核心 Agent + 工具调用,反而更稳定。少即是多。

class ExecutionMode(Enum):
    DIRECT_LLM = "direct_llm"
    TOOL_CALLING = "tool_calling"
    SUBAGENT_ASYNC = "subagent_async"
    EXPERT_INVOKE = "expert_invoke"
    SKILL_INVOKE = "skill_invoke"

驱动 AI 干活的技巧

Prompt Engineering 被吹得很玄,但真正的难点不在 prompt,而在:怎么拆解任务、怎么定义工具接口、怎么处理 LLM 的不确定性。这跟管理一个聪明但粗心的实习生很像。

# LLM 输出不可靠 — 必须用 Pydantic 严格校验
class IntentResult(BaseModel):
    mode: ExecutionMode
    tools: list[str]
    confidence: float = Field(ge=0, le=1)
    # 不要信任任何 LLM 的格式输出

AI SaaS 开发实战

FinBuddy_Web 的 LLM 代理服务、Promo_Web 的 Skill 组合引擎、SkillStore 的自动分类、Basic_Web 的通用脚手架。从零搭建,持续迭代。

# Promo — Skill 四层组合机制
# framework → style → adapter → enhancer
def assemble_prompt(self, product, persona,
                    framework_skill, style_skill,
                    adapter_skill, enhancer_skills):
    variables = {
        "product_name": product.name,
        "selling_points": "、".join(product.selling_points),
    }

Vibe Coding 心得

用 AI 辅助编程的实战心得:什么时候让 AI 写、Cursor 对话坏习惯、AI 代码 review 方法。包括失败案例——不是每次 Vibe Coding 都能成功。

时间线

2026年3月底
开始搭 FinBuddy,第一版一个文件写了 2000 行。能跑,但没法维护。
2026年4月初
拆分 FinBuddy 为引擎/技能/适配器三层架构。引入意图解析器,7 种执行模式路由。
2026年4月中
搭 Promo_Web(智能营销平台)、SkillStore(技能商店)、MarketingVideo(视频生成)和 Basic_Web(SaaS 脚手架)。从 FinBuddy 里抽出了通用基础设施。
2026年4月下旬
搭 FinBuddy_Web,LLM 代理转发 + JWT 认证 + FinCredits 积分服务。FinBuddy 从 7 个 Agent 砍到 3 个,加 Swarm 协作和进化系统。部署到阿里云,2 核 1.7G 跑着有点吃力。
2026年4月底
Basic_Web 升级为完整 SaaS 底座(邮件容灾、RBAC多端权限、定时任务热重载)。Basic_Mini 微信小程序脚手架搭建,与 Basic_Web 前后端对齐。FinClaw 新增市场监控和弹窗系统。