企业官网建设流程全解析

从 rc 退回 alpha 不是倒退，而是一次深度重构

9 月 4 日，DeepSeek Harness 发布了v0.1.3-alpha.1版本。继上月底连续三个 alpha 版本后，团队再次以 alpha 的姿态交出答卷。

有细心的用户发现，版本号从 rc 退回了 alpha——但这并不是功能的倒退，恰恰相反，本次更新是一次深度架构升级，涉及 Session 持久化 API 的破坏性变更和 Session format 的 v2 升级。这意味着，团队在为更稳定的未来打下坚实的基础。

让我们一起来看看这个版本带来了哪些值得关注的变化。

📁 通用文件上传：Web 端的一次重大飞跃

任意类型文件，一个预览区搞定

本次更新最直观的变化，是Web 端支持上传任意类型的通用文件。文件与图片可以在同一预览区混排，不再需要为不同类型文件切换不同的上传入口。

后台上传：进度可查、随时取消、切换会话继续显示

上传过程支持进度展示和取消操作，即使你切换了会话，上传中的文件仍会继续显示，不会因为界面切换而中断或丢失状态。

模型可按需读取已上传文件

文件上传后，模型可以通过已保存的路径，使用现有的文件工具按需读取文件内容。这意味着开发者可以灵活控制模型对文件的访问时机，而不是让所有文件一股脑地塞进上下文。

这一系列改进，让 DeepSeek Harness 的 Web 端从“只能传图”进化到了“通用文件管理”，离真正的 Agent 工作台又近了一步。

🌐 网络代理支持：企业级部署的关键拼图

v0.1.3-alpha.1 新增了对HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 与 NO_PROXY环境变量的全面支持。

这意味着：

• 所有出站网络请求都会自动遵循启动环境中的代理配置
• 企业用户可以在防火墙内部顺畅使用 DeepSeek Harness
• 开发者在受限网络环境下也能正常调用模型和工具

对于将 DeepSeek Harness 部署在企业内部的团队来说，这是一个迟来但至关重要的能力。

🐍 Python SDK：补齐 macOS 最后一块拼图

继上一个版本为 Windows x64 发布 runtime wheel 之后，本次更新为Python SDK 新增了 macOS x64 runtime wheel。

这意味着Intel 架构的 Mac用户现在也可以安装并运行随包 runtime，不再受限于 Apple Silicon。至此，Python SDK 在Windows、macOS（Intel + Apple Silicon）、Linux三大平台的主要架构上均已完整覆盖。

🖼️ 图片渲染：工具卡直接看图，不再展示原始附件

read_image的顶层与 PTC 嵌套工具调用，现在会在Web 工具卡中直接渲染图片，不再展示原始的附件对象。

这是一个看似微小但体验提升明显的改动：你在调试 Agent 的图片读取行为时，一眼就能看到图片内容，而不是面对一串晦涩的附件 ID 或路径字符串。

🔌 模型探测：更灵活的自定义模型接入

模型探测功能新增了对自定义模型提供商models对象和Anthropic 原生模型列表的支持。

同时，系统支持回填模型名称、上下文窗口及最大输出 token等信息。这意味着：

• 接入自定义模型时，不再需要手动补齐所有元数据
• 系统可以自动探测并补全缺失的模型配置
• 第三方模型提供商的接入流程更加顺畅

🐛 关键问题修复

暂停即终止，避免模型空转

在 Web 中手动暂停目标会立即终止当前模型轮次，避免运行中的模型继续执行或在同一轮恢复目标。这解决了之前“点了暂停但模型还在跑”的尴尬问题。

流式工具调用续传修复

修复了 DeepSeek 流式工具调用的续传分片用空值覆盖调用 ID 或名称的问题，避免工具以空名称失败并写入无法重新打开的会话记录。

Python SDK 命令重写修复

修复了 Python SDK 单文件 runtime 将 Bash 中以node开头的命令错误重写为dshruntime的问题。

会话搜索结果跳转修复

修复了从会话搜索结果进入会话后仍停留在搜索界面的问题；现在目标会话会在所属 Workspace 中展开并滚动到可见位置。

Windows 盘符根目录 Workspace 修复

修复了 Windows 盘符根目录 Workspace 的路径分隔符、标题与绝对路径校验，确保盘符根目录可以正常使用。

Session 缓存读取修复

修复了 Session 缓存读取问题。

✨ 体验优化

Skill 选择器支持模糊搜索

Skill 选择器现在支持模糊搜索，同时优化了聊天气泡中的 Skill 和命令引用展示。找 Skill 不再需要精确拼写，输入关键词即可快速定位。

链接样式统一，辨识度提升

统一了会话内可点击链接的颜色、hover/focus 样式和分类图标，优化了 Markdown 链接、文件引用、网页来源、产物链接与 Workflow 成员链接的辨识度。

Windows 子进程不再弹窗

Windows 上的本地非终端子进程不再弹出控制台窗口。后台任务静默运行，界面更加干净。

Agent Team 消息语义统一

Agent Team 的send_message统一采用steer 语义，并在跨 Agent 和冷恢复投递中保留发送者归属与顺序。

⚠️ 破坏性变更与升级提醒

Session persistence API 重构

这是一个破坏性变更。Session persistence API 改为由生命周期持有的 SessionHandle；agentLoop.create()改为异步，并新增了session 锁，同一 session 至多被一个进程持有。

这意味着如果你有自定义脚本或插件直接调用了旧的 Session API，升级后需要进行适配。

Session format 升级至 v2

Session format 升级至v2。旧 v0/v1 日志会通过不可变的相邻 generation 迁移到当前格式，Assistant 流按attempt 聚合进持久化 settlement，同时 Web 保持实时增量显示。升级后旧会话数据会自动迁移，无需手动操作。

⚠️ 已知性能缺陷

团队在发布说明中明确标注了一个已知的性能回退：可能影响部分历史 session 加载的响应速度。这个问题将在下一个版本中修复。如果你的工作流重度依赖大历史会话的快速加载，建议评估升级影响后再决定是否更新。

📝 写在最后

v0.1.3-alpha.1 是一次深度架构升级。通用文件上传让 Web 端脱胎换骨，代理网络支持补上了企业部署的关键拼图，Python SDK 完成了全平台覆盖，而 Session 层的重构则为未来的稳定性和并发能力奠定了基础。

从 rc 退回 alpha，不是倒退，而是一次蓄力。

正如 DeepSeek Harness 团队在项目初始就明确声明的：这是一个开发者预览版，会有兼容性破坏性变更。v0.1.3-alpha.1 正是这种迭代哲学的体现——该重构时就重构，该破坏时就破坏，只为让最终的产品更加可靠。

升级命令：npm i -g @deepseek-ai/dsh@next
GitHub 仓库：github.com/deepseek-ai/deepseek-harness
特别提醒：升级前请备份重要会话数据，并关注 Session API 的破坏性变更