CyberCode

免费驱动 GPT-5.5、Claude Opus 4.8、GLM-5.2 的全能 AI Agent 平台

一个自包含的物理级 AI Agent — 直接调用前沿大模型，自带 9 个系统级工具，能读写文件、执行代码、抓取网页、生成图片与视频。

这是什么

CyberCode 是一个跑在你本地浏览器里的 AI Agent。它不是套壳聊天框，而是一个有手有脚的执行者——能真正操作文件系统、运行脚本、访问网络、生成多媒体内容。

最关键的是：接入即免费使用 GPT-5.5、Claude Opus 4.8、GLM-5.2、Gemini 3.1 Pro、DeepSeek V4 等前沿模型，还能免费生成 gpt-image-2 图片和 Nanobanana 视频。所有模型通过统一网关代理，错误日志经过脱敏处理，前端用户看不到任何上游基础设施信息。

_{CyberCode Web 界面 — Codex-dark 风格，左侧模型选择器，右侧技能面板}

核心能力一览

为什么用 CyberCode

市面上大多数 AI 客户端要么是纯聊天框（没有执行能力），要么是笨重的框架（依赖一堆 Node 模块和浏览器内核）。CyberCode 走了一条不同的路：

把 Agent 做薄，把模型做厚。 核心只有约 1300 行 Python，但通过统一的 OpenAI 兼容接口接入了三十多个前沿模型。你写一段需求，它自己决定调用哪个工具、读哪个文件、跑哪段代码——整个过程流式输出，你看着它干活。

_{架构：Agent Core 居中调度，LLM Client 流式通信，9 工具各司其职}

内置 32+ 前沿模型

所有模型通过统一网关代理，切换模型只需一次 API 调用。以下是部分模型清单：

对话与推理模型

多媒体生成模型

_{图片生成与视频创作 — 左侧 AI 生图，右侧 HyperFrames 时间轴}

9 个原子工具

Agent 的工作方式不是"聊天"，而是调用工具完成任务。CyberCode 内置 9 个物理级工具，覆盖系统操作的方方面面：

此外还有两个记忆工具：update_working_checkpoint（短期笔记）和 start_long_term_update（长期经验沉淀），让 Agent 在长任务中不迷路、在重复任务中更聪明。

HyperFrames 视频引擎

CyberCode 内置 HyperFrames 技能集——一个用 HTML 渲染视频的框架。你描述想要什么视频，Agent 自动写 HTML 组合（带 data-* 时间属性），然后用 GSAP / Lottie / Three.js 做动画，最后 ffmpeg 合成带音频的 MP4。

用户："做一个 10 秒的猫咪科普短视频，要有旁白"
  ↓
Agent 决策路径：
  1. 调 gpt-image-2 生成 3 张场景图
  2. 调 edge-tts 合成中文旁白 MP3
  3. 写 HyperFrames HTML 组合（GSAP 时间轴 + 淡入淡出）
  4. ffmpeg 合成 H.264 1920x1080 + AAC 音轨
  5. 自检：视频时长、分辨率、音频存在性 → 100/100
  ↓
输出：cat_video_final.mp4

HyperFrames 包含 7 个领域技能，按需加载：

快速开始

方式一：npm 一键安装（推荐）

npm install -g cybercode-cli

安装完成后，在终端输入：

cybercode web

终端会显示本地服务地址，浏览器打开即可看到 CyberCode 界面。无需任何配置——模型密钥、网关地址、默认参数全部自动就绪，开箱即用。

方式二：克隆仓库安装

git clone https://github.com/ciouskeila-hue/cybercode-cli.git
cd cybercode-cli
python python/cybercodewebui.py

同样无需手动配置，启动后浏览器访问 http://localhost:18600 即可。

开始使用

打开浏览器后，你会看到一个登录界面。注册或登录 CyberCode 账号即可进入主界面——所有模型（GPT-5.5、Claude Opus 4.8、GLM-5.2 等 32+ 前沿模型）立即可用，图片和视频生成功能也已就绪。

登录后，默认选中 free/glm-5.2（零成本模型），你可以随时在左侧模型选择器中切换到其他模型。直接在输入框输入你的需求，Agent 会自动调用工具完成任务。

零配置理念：CyberCode 在启动时自动完成所有底层配置——模型路由、密钥管理、安全令牌生成全部在后台完成。你作为用户，只需要登录账号，剩下的交给系统。

API 接口

CyberCode 暴露一套简洁的 HTTP API，可以集成到其他系统：

所有 /api/* 端点均需 Token 认证（首次启动自动生成 .auth_token 文件）。

安全设计

CyberCode 在安全上做了多层防护，确保 Agent 的"物理级权限"不被滥用：

• Token 认证 — 所有 API 端点强制 Bearer Token 校验，首次启动生成随机 48 位 hex token
• 路径沙箱 — _get_abs_path 限制在 ROOT_DIR / TEMP_DIR 内，阻断 .. 穿越
• 视频路径白名单 — /api/video/ 仅允许 .mp4 / .webm / .mp3，禁止 ..
• SSRF 阻断 — web_scan 屏蔽私有 IP、回环地址、云元数据端点（169.254.169.254）
• SSL 强制校验 — 全链路 verify=True，绝不关闭证书验证
• 错误脱敏 — sanitize_error() 隐藏上游 URL、API key、IP、内部服务名、traceback
• 密钥掩码 — /api/llm/get 返回的密钥自动掩码（如 sk-5b8***0b8d）
• Admin Token 环境变量 — 管理员令牌从环境变量读取，不硬编码
• 无 traceback 返回 — 错误响应只含消息，不含堆栈

技术栈与开源致谢

CyberCode 的 Agent 核心架构（agent loop 结构、9 工具设计、记忆分层理念、系统 prompt 哲学）源自 GenericAgent 项目，由 lsdefine 以 MIT 许可证开源：

• GenericAgent — github.com/lsdefine/GenericAgent © 2025 lsdefine

在此之上，CyberCode 做了以下扩展：

• 重写 LLM Client，支持 OpenAI 兼容流式 + 函数调用
• 实现统一网关代理层（模型路由 + 会话令牌 + 错误脱敏）
• 集成 HyperFrames 视频引擎（HTML → ffmpeg 管线）
• 集成 edge-tts 语音合成（自动安装逻辑内置于系统 prompt）
• 构建 Codex-dark 风格 Web UI（i18n 中英双语）
• 加入完整安全层（Token / 沙箱 / SSRF / 脱敏）
• 零配置自动部署（npm 安装后直接 cybercode web 启动）

依赖

项目结构

cybercode/
├── agent_core.py            # Agent 核心：LLM Client + 9 工具 + agent loop
├── cybercodewebui.py        # Web 服务：HTTP API + SSE 流式 + 代理层
├── cybercodewebui.html      # 前端：Codex-dark UI + i18n + 实时聊天
├── mykey.json               # 模型配置（自动生成，不入库）
├── custom_system_prompt.txt # 自定义系统 prompt（热重载）
├── .auth_token              # 自动生成的安全令牌（不入库）
├── skills/                  # 14 个技能文档
│   ├── hyperframes.md       # 视频引擎入口
│   ├── hyperframes-core.md  # HTML 组合契约
│   ├── hyperframes-animation.md
│   ├── hyperframes-creative.md
│   ├── hyperframes-media.md
│   ├── hyperframes-cli.md
│   ├── hyperframes-registry.md
│   ├── image-gen.md         # 图片生成 API
│   ├── edge-tts-tts.md      # 语音合成
│   ├── general-video.md     # 通用视频路由
│   ├── motion-graphics.md
│   ├── product-launch-video.md
│   ├── website-to-video.md
│   └── faceless-explainer.md
├── memory/                  # 三级记忆系统
│   ├── global_mem.txt       # L2 稳定事实
│   └── global_mem_insight.txt # L1 洞察索引
├── temp/                    # 工作目录（gitignore）
├── docs/
│   └── images/              # README 演示图片
└── .gitignore

使用示例

示例 1：让 Agent 写脚本并执行

用户：帮我写一个 Python 脚本，统计当前目录下所有 .py 文件的行数，并按行数排序输出

Agent：
  → tool_file_write: 写 count_lines.py
  → tool_code_run: python count_lines.py
  → 返回结果：agent_core.py 1452 行，cybercodewebui.py 1180 行...
  → tool_file_patch: 发现 bug，修正排序逻辑
  → tool_code_run: 重跑，结果正确
  → 总结：共 3 个 Python 文件，总行数 2632

示例 2：生成图片并理解内容

用户：生成一张赛博朋克风格的猫咪图，然后告诉我图里有什么

Agent：
  → tool_generate_image: prompt="cyberpunk cat, neon lights, digital art"
  → 等待异步任务完成，图片保存到 temp/
  → tool_view_image: 分析生成的图片
  → 返回：一只橘色猫咪，戴着霓虹护目镜，背景是紫色和青色的城市灯光...

示例 3：抓取网页并提取信息

用户：帮我看看 python.org 首页有什么新闻

Agent：
  → tool_web_scan: url="https://python.org", text_only=true
  → 提取正文，过滤导航和页脚
  → 返回：Python 3.13 发布、PEP 7xx 新提案、PyCon 2026 日期公布...

示例 4：生成带旁白的视频

用户：做一个 10 秒的猫咪科普短视频，要有中文旁白

Agent（视频模式，自动注入 HyperFrames 前导）：
  → 生成 3 张场景图（gpt-image-2）
  → 合成中文旁白 MP3（edge-tts）
  → 编写 HTML 组合（GSAP 时间轴 + 淡入淡出 + data-start 音频同步）
  → ffmpeg 合成 H.264 1920x1080 + AAC
  → 自检：时长 10s ✓ 分辨率 1080p ✓ 音频存在 ✓
  → 输出：cat_video_final.mp4

配置项

CyberCode 采用零配置设计，启动时自动完成所有配置。以下环境变量供高级用户调整：

环境变量

自动配置机制

CyberCode 在首次启动时自动完成以下工作，用户无需干预：

• 连接模型网关，获取可用模型列表
• 生成会话安全令牌（.auth_token）
• 选择默认模型（free/glm-5.2，零成本）
• 初始化记忆系统和工作目录

用户只需登录 CyberCode 账号，系统自动处理其余一切。

常见问题

Q：真的免费吗？

是的。CyberCode 默认使用 free/glm-5.2 模型，完全免费。登录 CyberCode 账号后，GPT-5.5、Claude Opus 4.8 等前沿模型也可直接使用，具体额度取决于平台政策。

Q：需要翻墙吗？

不需要。模型网关在国内可直连，开箱即用。

Q：支持函数调用吗？

支持。free/glm-5.2、deepseek-v4-flash、glm-5.2 等模型支持 OpenAI tools 规范的 function calling，流式与非流式均可。gpt-5.4 等部分模型不支持 FC，此时 Agent 回退到 XML 工具调用解析。

Q：视频生成需要什么依赖？

需要 ffmpeg（系统 PATH 中可用）和 edge-tts（pip install edge-tts）。系统 prompt 内置了 edge-tts 自动安装逻辑，首次使用视频模式时 Agent 会自动检测并安装。

Q：数据会上传吗？

不会。CyberCode 跑在你本地，所有文件操作、代码执行、记忆存储都在本地磁盘。只有 LLM 推理请求会发送到模型网关，且错误日志经过脱敏，不暴露你的文件路径或敏感数据。

开发

本地调试

# 克隆仓库后直接运行
python python/cybercodewebui.py --port 18600 --host 0.0.0.0

# 自定义 LLM 启动序号
python python/cybercodewebui.py --llm_no 4

自定义系统 Prompt

编辑 custom_system_prompt.txt，内容会热重载到每次对话的系统 prompt 开头。适合注入项目特定的约束或领域知识。

自定义技能

在 skills/ 目录下新建 .md 文件，Agent 会在 /api/skills 中列出并按需加载。

许可证

MIT License — 详见 LICENSE 文件。

CyberCode 的 Agent 核心架构源自 GenericAgent（© 2025 lsdefine, MIT），在此致谢。