czagent 图标 czagent

开源 · Windows / macOS / Linux · 数据全本地

把多模态大模型,
变成你桌面上的智能体

czagent 把 DeepSeek、硅基流动、通义千问等大模型接入一个干净的桌面工作台:读写文件、执行命令、联网搜索的每一步都以工具卡片实时可见;还能写原生 Node.js 脚本,把整套能力编排成你自己的流水线。

21内置工具
8多模态能力
3平台安装包
100%数据存本地

它不只是一个聊天窗口

czagent 的每一步操作都是可见、可控、可编排的。以下是它区别于普通客户端的核心设计。

对话会话

多会话并行,流式输出,过程看得见

  • 流式输出与思考模式:关闭 / 思考 / 深度思考三档可切,思考过程内联实时展示
  • 附件理解:拖入 PDF、Word、Excel、图片直接提问,自动解析为文本
  • 上下文压缩:长会话自动生成摘要,token 用量逐轮可见,支持手动压缩
  • 多会话并发:多个会话同时运行互不阻塞,超出的自动排队接力
  • 会话管理:自动生成标题、草稿保留、虚拟滚动加载长历史
一次长会话的自动压缩
// 上下文接近上限时,czagent 自动压缩:
保留最近 25% 的窗口原文
更早的历史 → 流式生成结构化摘要
摘要原地折叠,点击可展开查看
token 用量在右栏逐轮刷新

21 个内置工具 + 权限系统

能干活,更知道什么不能干

  • 文件与代码:read / grep / glob / write / edit / patch,改文件精确到字符串替换
  • 终端:bash 工具走真实 PTY,Windows 自动切换 PowerShell,超时参数可传
  • 联网:自研网页搜索(必应 / 百度 / 360 / 搜狗)+ 网页抓取,无需第三方搜索 API
  • 路径边界:工作目录内直接放行,目录外写入必须弹卡确认
  • 工具矩阵:每个工具单独控制加载与否、允许 / 询问 / 拒绝
  • doom-loop 防护:同一操作连续重复自动要求确认,防止烧 token 死循环

模型为中心的多 Provider 接入

一家 Key 一条配置,能力自由绑定

  • 开箱即接:DeepSeek、SiliconFlow 硅基流动、Agnes、智谱 BigModel、通义 Qwen、OpenRouter 各有专属接入实现
  • OpenAI 兼容:任何兼容服务填地址和 Key 即用
  • 统一网关:流式、重试、用量统计、错误语义在各引擎间一致
  • 能力绑定:对话之外的 8 类多模态能力各自绑定默认模型,互不干扰
能力绑定模型(示例)
对话 / 图像理解deepseek-chat
向量嵌入 / 重排序bge-m3 · siliconflow
图像生成 / 编辑agnes-image
视频生成agnes-video-2.5
语音合成 / 识别moss-tts · asr

Plan / Build 与自定义 Agent

先想清楚,再动手

  • Plan 模式:只读调研、产出分步计划,经你确认后才切到 Build 执行
  • Build 模式:全工具自主执行,todo 清单实时推进
  • 自定义 Agent:界面化配置系统提示词、可用工具、MCP、技能、步数上限
  • 子代理派发:隔离上下文执行独立子任务,工具卡片实时回流主会话
项目根目录的 AGENTS.md
# 项目指令(自动拼入每个 Agent)
- 构建命令:pnpm build
- 提交信息用中文,不加注释
- 测试失败必须先修复再继续

原生 Node.js 脚本编排

这是 czagent 最不一样的地方

  • 入口即代码:工作目录放一个 czagent.ts,点「▶ 运行」,改完即生效
  • 完整 Node 环境:esbuild 打包 TS 与 npm 依赖进真实子进程,fs、网络随便用
  • ctx API:ctx.tools 直调全部工具、ctx.agent.run 委派子代理、ctx.log 输出进度
  • 全程可视:每次工具调用都是消息流里的卡片,跑错了能定位到具体一步
  • 并发与超时:占独立并发槽,可设单次运行超时,随时可停
czagent.ts
export default async function main(ctx) {
  ctx.log('批量整理录音…');

  const files = await ctx.tools.glob({ pattern: 'audio/*.mp3' });
  for (const f of files.split('\n')) {
    const text = await ctx.tools.asr({ file: f });
    await ctx.tools.write({
      file: f.replace('.mp3', '.md'),
      content: text
    });
  }
  return { done: files.length };
}

技能 Skills 与 MCP

把经验沉淀成可复用的能力

  • 技能目录:全局 ~/.czagent/skills 或项目 .czagent/skills,放一个 SKILL.md 就生效
  • 按需加载:智能体根据任务自动判断加载哪个技能,用完释放
  • MCP 接入:本地 stdio 或远程 HTTP 服务均可,工具与内置工具同权受控
  • 逐条开关:MCP 服务器与技能都能在 Agent 配置里逐条启用排除
.czagent/skills/report/SKILL.md
---
name: report
description: 提到「周报」时用该技能生成周报
---

# 使用说明
1. read 读取 docs/log/ 下本周的日志
2. 按里程碑分组,突出完成与风险
3. 输出为 Markdown 表格

全链路多模态

图像、视频、语音、向量,一条流水线打通

  • 生成类:文生图、图生图与多图合成、文生视频、图生视频
  • 语音类:TTS 八种预置音色、ASR 音频转写
  • 语义类:向量嵌入、重排序,可用来做知识库检索
  • 未适配明确报错:Provider 缺哪类能力直接说明,不静默失败
文生图image-generate
图生图image-edit
文生视频video-generate
图生视频video-from-frame
语音合成tts
语音识别asr
向量嵌入embed
重排序rerank

界面一览

三栏工作台:左侧会话,中间消息流与工具卡片,右侧任务清单与运行日志。点击截图可放大查看。

主界面 · 会话与消息流
czagent 主界面:三栏布局,左侧会话列表,中间消息流,右侧任务清单
主界面多会话列表、流式消息流、思考过程内联显示
工具卡片与权限确认
工具调用卡片与权限确认弹窗
工具与权限工具卡片状态流转,敏感操作弹卡三选一
模型管理
模型管理设置页:对话模型与多模态能力绑定
模型管理对话模型与 8 类多模态能力分开配置
Agent 配置
自定义 Agent 配置页:提示词、工具、MCP、技能逐条开关
Agent 配置工具、MCP、技能逐条开关,可视化编辑
脚本编排
脚本会话运行 czagent.ts,工具卡片实时滚动
脚本编排czagent.ts 点 ▶ 即运行,日志与卡片实时滚动
多模态生成
多模态生成:图片视频音频内联渲染在消息流中
多模态生成的图片、视频、音频内联在消息流里

下载与安装

安装包随版本发布在 GitHub Releases,全部平台免登录使用。

平台安装包说明
Windows Setup .exe(NSIS)
.exe(portable)
便携版免安装单文件;首次运行 SmartScreen 提示「仍要运行」即可
macOS .dmg 未签名公证,首次打开需在系统设置中放行
Linux .AppImage · .deb AppImage 加执行权限直接运行;deb 用 dpkg -i 安装

前往 GitHub Releases 下载

从源码运行(开发者)
# 要求 Node.js ≥ 20.15、pnpm ≥ 9
git clone https://github.com/wudics/czagent
cd czagent
pnpm install
pnpm dev        # 启动桌面应用

模型 Key 不随软件分发:安装后到「设置 → 模型」添加你自己的 DeepSeek 等平台 Key,见快速入门

常见问题

我的对话数据存在哪里?

全部保存在你自己电脑上的 SQLite 数据库里(用户目录的 czagent 数据目录),不上传任何服务器。备份整个数据目录即可迁移。

czagent 支持哪些大模型?

内置 DeepSeek、SiliconFlow 硅基流动、Agnes、智谱 BigModel、通义千问 Qwen、OpenRouter 的专属接入,以及任意 OpenAI 兼容服务。向量、重排、图像、视频、语音等 8 类多模态能力分开配置、自由绑定默认模型。

czagent 收费吗?

软件本身免费开源。模型调用需要你在各平台申请 API Key、按平台计费,czagent 不经手也不加价。

工具的权限是怎么控制的?

每个工具可单独设置允许、询问或拒绝;工作目录内读写直接放行,目录外写入与危险命令必须弹卡确认;21 个内置工具在工具矩阵里逐个管理。

脚本会话是沙箱吗?

不是。脚本运行在真实的 Node.js 子进程中,信任级别等同于 npm run 你自己的项目脚本,文件与网络均可用,所以请只运行你自己编写的脚本;其中工具调用仍然全部经过权限系统。

支持英文界面吗?

支持。设置中可随时切换中文 / English,即时生效。

交流与反馈

问题反馈、功能建议、使用交流,欢迎添加微信(备注「czagent」),也可以直接到 GitHub 提 Issue。

qq176367820

微信号:qq176367820 · 添加时请备注 czagent

GitHub Issues 反馈 →

czagent 作者微信二维码
微信扫码添加