---
slug: fmode-skill-fmode-code-agent
displayName: fmode-code-agent
version: 0.1.1
name: fmode-code-agent
description: "数字人开发基础规则：纯 JS 网页版 Bot 智能体开发（浏览器 + Node 双兼容、无构建）。Agent/MCP/Skill 三层分离、LangGraph.js 浏览器无构建配方、浏览器端 MCP（Web Worker）、token 实测、提交后自动部署。触发词:agent、智能体、MCP、Skill、LangGraph、function calling、工具调用、Re-act、Web Worker MCP、Agent 架构、token 实测、自动部署。"
tags: [FmodeAgent, FmodeCode, 开发级, code-agent, 数字人基础规则]
platform: Both
level: 开发级
category: 开发规范
icon: 🤖
license: MPL-2.0
author: Fmode (未来飞马)
homepage: https://github.com/fmodecn/fmode-code-agent
npm: "@fmode/skill-code-agent"
---

# fmode-code-agent — 纯 JS 网页版 Bot 智能体

> **这是方便数字人（FmodeAgent / FmodeCode）进行项目开发的基础规则技能。**
> 它把踩过的坑沉淀成硬性约束，让 AI 在生成代码时不重犯同类错误。

用纯 JS（浏览器 + Node 双兼容、无构建）写网页版 Bot 智能体：Agent 决策 / MCP 协议 / Skill 执行三层分离，
LangGraph.js 浏览器直跑，token/速度**实测**，**提交后自动部署**。

npm 包：`@fmode/skill-code-agent`。完整规则见 `references/RULES-INDEX.md` 与其索引的 `references/rules/`。
姊妹技能：`fmode-code-lit`（Lit 无构建前端），两者可叠加使用。

## 触发

新建网页内跑的智能体（对话 + 工具调用）· 把能力封装成 MCP 工具 / 接入多个 MCP · 用 LangGraph.js 做图编排（浏览器无构建）·
给智能体加 token/速度实测与输入输出比例 · 配自动部署。

## 一句话架构

```
Agent（决策：调不调工具、调哪个，可换框架）
  └─ MCP（协议：JSON-RPC 2.0，浏览器常跑在 Web Worker）
       └─ Skill（实现：纯函数式能力）
```

换 Agent 框架时，**MCP 与 Skill 一行不改** —— 这是分层的验收标准。

## 四条铁律

1. **浏览器 + Node 双兼容**：核心纯 JS；`fs`/`path` 只在分发脚本里用。
2. **不用构建**：不引打包器；依赖走 importmap（浏览器）或 npm（Node）。
3. **凭据不进 Worker / 日志 / 代码**：要凭据的动作在**主线程**执行。
4. **参数以实测为准**：网关会**静默忽略**参数 —— 必须**验证副作用**，不能只看 200。

## 用法

```bash
npm i @fmode/skill-code-agent      # 安装（含本技能目录）

node scripts/scaffold.mjs ./my-agent --project my-agent   # 生成智能体骨架
node scripts/install-rules.mjs .                          # 给已有项目装规则
node scripts/smoke.mjs                                    # 自检（含 MCP 协议功能测试）
```

## 依赖版本（2026-10 实测可用）

```
@langchain/langgraph@1.5.1  @langchain/core@1.2.18
@langchain/langgraph-checkpoint@1.2.0  @langchain/protocol@0.0.19
uuid@11.0.5  zod@4.6.7
```

## 诚实失败

生成前先探测目标目录；已存在文件不覆盖（除非 `--force`）。未实测的能力（多 MCP 并发、HTTP/SSE 传输…）
在规则里明确标注「未验证」，不写成规范。