99Agent 文档

主题

版本更新日志 ​

未发布 ​

🐛 修复 ​

  • 修复文件清理时可能只标记删除、未移除实际存储内容的问题。
  • 修复微信支付主动查单无法识别成功支付的问题，并严格核对订单、商户、金额与币种。
  • 修复 Python 虚拟环境和工作区技能程序无法直接执行的问题。
  • 修复生产 gVisor 沙箱无法连接出网代理的问题；不同对话的代理互相独立，新建或回收对话不会中断其他对话联网。
  • 修复严格文件权限环境下构建的代理镜像无法以普通用户启动的问题；支持为代理选择可达的公网 DNS，恢复 gVisor 中的域名访问。

⚠️ 升级须知 ​

  • 每个联网会话额外预留 128 MiB 代理内存；更新采用新沙箱资源布局，先结束旧会话并核对清理旧资源。gVisor 必须通过工作区字节与文件数量硬上限验收，具体版本补丁与步骤见仓库 sandbox/README.md。

0.1.0 测试版（2026-09-26） ​

99Agent 的首个开源测试版。它是 99AI 的新一代重写版本，数据库、配置与部署方式都与旧版 99AI 不兼容。

✨ 新增 ​

  • 多用户 Agent 对话：账号注册登录与会话管理；模型网关内置 OpenAI Chat Completions 兼容接口，OpenAI Responses、Anthropic、Gemini、OpenCode Go 由各自的模型协议包接入；回复流式输出，工具调用过程实时可见。
  • 每个对话一个临时隔离沙箱（Docker + gVisor）：模型只拿到 read / write / edit / bash / ls 五个原语工具，经受控代理访问公开网络（可配置为无网）；out/ 里的新文件自动回收为消息里的文件产物。
  • 能力扩展：沙箱内的技能（skills/）、MCP 服务器（后台「AI 能力 → MCP 服务」管理）、垂直业务清单导入。
  • 管理后台：平台设置（站点、文件存储等）、AI 能力（模型、MCP 服务）、用户运营、登录接入。
  • 可裁剪的扩展包：商业（积分、套餐、订单与支付）、内容安全、微信（登录、公众号与 Bot 通道）、邮箱 / 手机 / GitHub 登录、S3 / OSS / COS 存储、用户端富媒体渲染。删掉任意一个包，内核照常构建和运行，见内核与扩展包。
  • 用户端：中英文界面（数字、日期按界面语言书写）；明暗主题首帧不闪；键盘与读屏可用（弹窗、设置、搜索、登录表单的焦点与播报）；公式、代码高亮、代码编辑器、支付等较重的功能用到时才加载；断线后回复自动接上，重新生成、排队补充要求与多页签草稿都按服务端结果对账。

⚠️ 升级须知 ​

  • 测试版：1.0 之前接口、配置项与数据库结构都可能调整，暂不提供数据迁移。用于生产前请先在独立环境验证，并备份数据库与上传文件。
  • 旧版 99AI 的数据库不能直接升级到 99Agent，请按安装部署全新部署：对空库执行 node dist/main db:init，正常启动不会自动改表。
  • 访问端浏览器：Chrome / Edge 111+、Firefox 114+、Safari 16.4+（iOS 16.4+），Mermaid 图表另需 Safari 17.4+；在微信里打开请使用较新的微信版本。
  • 用户沙箱需要宿主机安装 Docker，生产环境另需 gVisor，安装步骤见仓库里的 sandbox/README.md。