文档中心

产品使用与集成的官方文档

版本演进

DFCode 版本记录,更新至 v3.3.19,包含企业登录恢复、消息撤回、后台输出与安装改进

版本概览

1.x 加入多 AI 协作、Skill 和长期记忆;2.x 增加企业模型分发、自动权限和目标模式;3.x 主要更新长任务执行、上下文管理、权限策略和终端界面。

当前稳定版本为 v3.3.19。npm 的 latest 和 stable 均指向 3.3.19,beta 保持 3.3.17-beta.2。3.3 系列日期采用发布记录的 UTC 日期。

v3.3.19(2026-09-08)

正式渠道发布 v3.3.19,npm 主包及平台包均已提供。具体改动以该版本发布说明为准。

v3.3.18(2026-09-08)

本版改进企业登录恢复、长会话中的消息撤回与历史回退、工具输出反馈和首次启动体验。主 npm 包及 11 个平台包均已发布。

企业登录与凭据刷新

  • 临时网络故障、HTTP 429 和可恢复的上游错误不再直接清除登录凭据。凭据失效或账号被禁用时,仍按相应状态处理。
  • 并发请求共享凭据刷新,失败后遵守 Retry-After 并加入随机延迟,减少集中重试。刷新超时覆盖响应正文读取。
  • 身份验证已成功、模型配置或授权尚未就绪时,保留有效登录状态,等待后续恢复。

消息撤回、历史回退与终端界面

  • 减少长会话撤回与回退时的历史读取,批量处理快照,并合并同一操作的重复请求。
  • 异步结果返回时检查会话和输入状态,避免覆盖后续输入或影响已经切换的会话;改进再次中断、目标失效和输入框焦点恢复。
  • MaaS 今日额度的显示单位由 USD 改为“积分”,数值和计算方式不变。

工具输出与后台等待

  • 输出超出缓冲区容量时,工具结果、保存文件和完成通知都会标明内容不完整,部分内容文件不再被称为完整日志。
  • bash_output 区分没有新输出、未读输出中没有匹配项和匹配到空行。过滤时说明丢弃的内容未参与匹配;每次读取都会推进游标。
  • 阻塞等待超时后仍返回期间到达的输出,并分别显示等待结果与进程状态。等待超时不会终止后台进程。
  • bash_output.timeout 默认 30 秒,参数接受 1–2147483647 毫秒的整数。立即读取应省略 block 或使用 block: false,不再接受 timeout: 0。
  • 有独立工作时继续执行;依赖后台结果时允许有时限的等待;明确要求不等待时依靠完成通知。常驻服务通过就绪或健康检查确认启动。

调查与任务连续性

  • Explore 的探索深度由问题和必要证据决定,取消以工具调用数量作为完成标准。
  • 调查结果区分已验证事实、推断和证据缺口;只能解释部分现象时,保留尚未解决的问题。
  • 用户追加要求、询问状态或提出异议时,保留未完成任务,并以具体证据回应。

安装与首次启动

  • npm launcher 与 postinstall 共用平台、libc 和 CPU 变体选择;安装时核对平台包版本并实际执行 --version,Windows 同样进行验证。
  • 全新用户目录中的空配置和 Markdown skills 不再触发不必要的插件 SDK 安装。只有声明依赖或存在本地插件、工具时才准备相关依赖。
  • 平台包保留完整 builtin skills,不再默认携带外置 source map。

安装与升级步骤见登录部署。已有 beta 用户可使用官方 npm 源的 dfcode@stable 切换到正式版。

v1.0 – v1.3:基础命令与扩展

v1.0.0(2026-01-27)

发布首个可用版本,包含 DFCode 品牌设置、基础命令行和交互界面。

v1.0.1(2026-02-04)

修复不同终端环境下的界面显示和交互问题。

v1.0.2(2026-02-05)

加入项目规则和 Skill 发现机制,支持读取项目约定并用于任务执行。

v1.1.0(2026-02-07)

支持在 VS Code 等开发环境中使用 DFCode。

v1.1.1(2026-02-09)

修复 IDE 接入时的服务启动、端口冲突和连接恢复问题。

v1.2.0(2026-02-12)

加入长会话管理和长期记忆,在长对话中保留项目背景、设计决策和历史信息。

v1.2.1(2026-02-13)

改进项目探索和记忆摘要。

v1.2.2(2026-02-14)

扩展可接入的模型来源,改进外部模型兼容性。

v1.3.0(2026-02-18)

支持插件市场和 Skill 创建,团队可以安装插件或编写 Skill。

v1.3.1(2026-02-20)

改进任务规划、插件市场和报错提示。

v1.3.2(2026-02-25)

改进模型接入稳定性、流式输出和统计显示。

v1.4 – v1.6:协作与 Skill

v1.4.0(2026-02-26)

加入多 AI 协作,支持拆分任务、分头执行并汇总结果。

v1.4.1(2026-02-28)

新增 worker 详情界面和后台任务,支持查看多个 AI 的协作状态。

v1.4.2(2026-03-05)

修复内置插件发布和命名不一致的问题。

v1.5.0(2026-03-06)

改进长期记忆、进度反馈和预览,支持按前端、后端、测试、文档等角色分配 AI 任务。

v1.5.1(2026-03-08)

改进长期记忆的结构化处理,减少长对话中的信息丢失。

v1.6.0(2026-03-14)

Skill 支持复用团队经验、规范和流程。新增文档专用助手和动态角色注册。

v1.6.1(2026-03-15)

改进大任务的协作组织、进度反馈和任务衔接。

v1.7 – v1.9:企业登录与远程功能

v1.7.0(2026-03-18)

扩展模型接入选项,改进 worker 协作界面。

v1.7.1(2026-03-19)

改进多 AI 管理界面、协作提示和对外文档,修复模型接入兼容问题。

v1.8.0(2026-03-22)

加入远程协作、消息桥接和实时事件同步,支持跨环境、跨终端协作。

v1.8.1(2026-03-23)

修复模型未加载时的界面问题。

v1.8.2(2026-03-25)

更新远程协作、会话管理、权限与提问机制、配置兼容和消息卡片。

v1.8.3(2026-03-26)

改进本地界面与远程协作的衔接,支持通过斜杠命令发现和调用 Skill。

v1.9.0(2026-03-27)

新增企业门户和远程部署,支持企业统一接入、管理和部署。

v1.9.1(2026-03-28)

修复企业登录回调和远端轮询问题。

v1.9.2(2026-03-29)

修复前端恢复和企业浏览器会话持久化问题。

v1.9.3(2026-03-30)

新增循环任务,支持重复执行操作;修复界面崩溃和企业登录流程问题。

v1.9.4(2026-04-09)

优化计划与执行流程中的状态隔离和提醒范围,减少多 AI 场景下的相互干扰。

v1.9.5(2026-04-11)

改进企业登录、退出、界面状态切换和终端恢复。

v1.9.6(2026-04-13)

改进企业认证的调试、状态跟踪和轮询容错。

v1.9.7(2026-04-15)

整理 SDK、界面事件类型和企业状态管理,统一登录状态来源。

v2.0 – v2.4:企业配置与稳定性

v2.0.0(2026-04-17)

更新插件、模型接入和评审工作流,改进企业接入稳定性。

v2.0.1(2026-04-17)

调整企业默认配置,改进终端退出和中断后的恢复。

v2.0.4(2026-04-24)

界面高亮只处理最近消息,减少长对话卡顿。接入 DeepSeek 等模型,加入常用技能包,改进多 AI 任务的生命周期管理。

v2.0.5(2026-04-24)

保留兼容模型输出的推理过程。

v2.0.6(2026-04-26)

改进 Windows 终端退出、中断和界面刷新。部分模型渠道支持动态发现新上线的模型。

v2.0.7(2026-04-28)

支持企业模型统一分发。成员登录后自动接入企业 MaaS 模型,模型按类别分组,无需单独申请和配置。

v2.1.0(2026-05-04)

新增自动权限模式:安全操作自动放行,风险操作仍需确认。缓解大段文本粘贴导致的界面冻结。

v2.1.1(2026-05-06)

企业登录支持设备绑定、账号设备数量限制和设备指纹校验。

v2.1.2(2026-05-07)

改进会话切换、权限确认和企业用量统计。

v2.2.0(2026-05-11)

新增侧问,可在主任务执行时提出临时问题。侧问独立运行,不占用主任务上下文。

v2.2.1(2026-05-12)

隔离各个侧问;模型请求失败后自动重试;企业用量按执行步骤上报。

v2.3.0(2026-05-18)

新增目标模式,设定目标后可持续执行,支持无人值守监督。网络错误与鉴权失败使用不同提示。

v2.3.1(2026-05-18)

隔离侧问与主任务的执行痕迹。

v2.3.2 / v2.3.3(2026-05-26 / 2026-05-28)

修复长文本粘贴时的会话稳定性问题。

v2.3.4(2026-05-30)

修复侧问偶发崩溃与个别模型的上下文配置问题。

v2.3.5(2026-06-01)

升级终端渲染引擎;扩大自动权限模式中的安全操作范围,调整权限判断。

v2.3.6(2026-06-02)

自动权限判断默认使用当前会话模型。

v2.4.0(2026-06-06)

改进长会话上下文压缩,修复压缩提示卡住界面的问题,新增长期记忆诊断。

v2.4.1(2026-06-10)

改进企业登录诊断,用量上报改为后台执行。

v2.4.2(2026-06-11)

修复企业登录偶发挂起问题。

v3.x:beta 与稳定渠道

3.x 使用 beta 和稳定两个发布渠道,新增功能先在 beta 渠道验证。

v3.0.0-beta.1(2026-06-12)

修复任务意外停止却没有提示的问题,调整会话恢复与上下文核算,重写长会话渲染流程以减少卡顿,改进 Windows 进程生命周期管理。

v3.0.1-beta.1(2026-06-15)

新增长任务监督器,驱动会话持续执行并校验产出。超长任务增加三层上下文过载保护。

v3.0.0(2026-06-16)

发布 3.0 稳定版,纳入 beta 渠道验证的稳定性修复。

v3.0.2-beta.1(2026-06-18)

更新输入框、标题栏和工具图标,默认使用浅色主题;修复 Windows 终端图标乱码问题。

v3.1.0(2026-06-24)

支持后台运行 Shell 命令,输出异常时自动提醒。新增 GBK 等非 UTF-8 中文文件编码读写、统一设置面板和跨平台登录诊断工具,加入持续集成测试检查。

v3.1.1(2026-06-29)

登录、登出状态实时生效;修复 Windows 登录冻结和设备身份变化的问题;崩溃日志保存到磁盘。

v3.1.1-beta.2(2026-07-02)

新增心跳监测和卡死处理,长时间等待时显示原因。

v3.1.1-beta.3(2026-07-05)

修复无人值守执行挂起、中文密集会话压缩死循环,以及 Windows 终端中断和复制粘贴问题。改进撤销操作的安全检查,增加全局崩溃捕获。

v3.1.2(2026-07-06)

稳定版升级时增加防降级保护,修复 Windows 中文剪贴板乱码,设置面板增加个性化开关,并调整 beta 与稳定双渠道发布流程。

v3.1.3-beta.1(2026-07-11)

beta 渠道新增规格驱动开发模式,支持按阶段处理大型需求,规格文档保存在项目工作区。降低接入外部扩展工具时的多轮对话响应延迟,修复 Windows 稳定性及中文主机名设备的企业登录问题。

v3.2.0(2026-07-16)

规格驱动开发模式(Spec Mode)进入稳定版。大型需求先编写规格文档,再按阶段执行;文档保存在项目的 specs 目录,可随时进入或退出规格工作流。纳入 MCP 多轮对话的性能改进,缩短首字响应等待。

Windows 和 macOS 的交互更新包括:

  • 修复 Windows 单按 Ctrl+C 导致命令行启动器崩溃的问题,由界面处理任务中断、复制、清空草稿和双击退出。子会话中按 Ctrl+C 返回上层会话。
  • 支持长按退格加速删除,长草稿可在持续按住数秒后清空,短草稿保留误触保护。
  • 改进复制粘贴,保留历史切换和草稿中的粘贴内容,调整深色输入条与中断信号处理。
  • 修复企业登出竞态、陈旧模型缓存和凭据加密问题,兼容非 ASCII 与中文主机名设备登录。

界面渲染层拆分大文件、清除无用代码、消除模块循环依赖,并统一字形安全表,配合全局崩溃处理。

v3.3:长任务、权限与终端

3.3 系列更新多 AI 协作、长任务、企业模型、规划与执行衔接、上下文压缩和终端兼容性。

v3.3.0(2026-07-19)

后台子任务完成后自动通知并唤醒主会话,支持任务终止、资源回收与继续执行。改进图片存储和长会话内存使用,扩展桌面客户端接入、Git 操作、技能市场和推理深度设置。

v3.3.2(2026-07-24)

企业模型支持按低、中、高消耗档位选择,可查看当日额度并手动同步用量。模型接入区分输入、输出与总上下文限制,减少配置不匹配导致的请求失败。本版包含此前未独立发布的 v3.3.1 更新。

v3.3.3 / v3.3.4(2026-07-25)

改进主会话与子会话之间的自动权限策略继承和待审批任务处理,减少模式切换后的权限状态不一致。长会话压缩时保留当前目标。

v3.3.5(2026-07-25)

改进工具执行期间的进度信息更新。

v3.3.6(2026-07-26)

企业账号在多设备及新旧客户端之间切换时保留必要凭据,需要重新认证时显示提示。

v3.3.7(2026-07-26)

修复工具进度显示问题。任务结束或失败后保留子会话关联,可回看执行过程并继续处理。

v3.3.8(2026-07-27)

搜索中断或超时后回收进程,改进文件排序与符号链接搜索;权限判断优先执行拒绝规则。

v3.3.9(2026-08-03)

搜索超时后保留已有结果并说明停止原因。统一规划、执行模式与子代理的行为。

v3.3.10-beta.2(2026-08-03)

新增 Trust Mode(信任模式),按用户选择的授权策略持续执行任务。更新文档、演示文稿、表格和 PDF 工作流,改进规划审批与会话状态同步。普通自动权限模式下,需要用户回答的问题会等待答复;信任模式按无人值守策略处理。

v3.3.10 – v3.3.12(2026-08-04 – 2026-08-07)

稳定渠道支持将耗时较长的 Shell 命令转入后台并查看详情,支持任务状态持久化与任务续跑。改进任务提醒,修复等待用户答复时的状态显示。

v3.3.13(2026-08-08)

修复 Windows 安装包入口,增加跨平台安装校验。等待后台命令输出时,可按 Esc 返回会话,后台命令继续运行。

v3.3.14-beta.1 – beta.5(2026-08-10 – 2026-08-14)

改进子任务完成判断,代码审查支持按风险设置审查强度。调整长会话压缩、Esc 中断后继续提问、后台结果唤醒和权限确认的处理。修复历史消息排序异常导致的旧会话持续运行、新消息不可见问题,保留受影响会话的原有上下文。

v3.3.14-beta.6 – beta.13(2026-08-16 – 2026-08-23)

改进终端欢迎页、Markdown 表格、LaTeX 公式和主题显示。调整规划模式与自动审批的配合,支持通过 Esc 撤回排队消息。优化多媒体内存使用、扫描 PDF 的上下文占用和 Windows 启动稳定性。

v3.3.14(2026-08-24)

稳定渠道纳入 v3.3.14 beta 期间的终端显示、规划与执行衔接、长会话和跨平台兼容性改进。

v3.3.15(2026-08-29)

本次发布的平台安装包上传不完整,随后由 v3.3.16 补齐。使用该版本的用户建议升级至 v3.3.16。

v3.3.16(2026-08-31)

修复输入框粘贴乱序和重复问题,连续粘贴按触发顺序插入。大段文本的粘贴占位符在发送时完整还原,继续打字、切换历史和暂存草稿时保留粘贴内容。

企业模型区分配额耗尽与临时限流:配额耗尽时结束请求并提示,临时限流时在重试预算内等待恢复。每轮请求增加重试总预算,避免反复重试导致长时间挂起。本版补齐 macOS、Linux 和 Windows 平台安装包。

v3.3.17-beta.1(2026-09-02)

beta 渠道发布 v3.3.17-beta.1,提供 macOS、Linux 和 Windows 平台安装包;当时稳定渠道为 v3.3.16。该版本尚无独立发布说明。