DeepSeek Harness v0.1.3-alpha.1
DeepSeek Harness v0.1.3-alpha.1：Session v2 与通用文件上传
- 作者
- DeepSeekAgent.io 编辑部
- 发布
- 更新
2026 年 9 月 4 日，DeepSeek Harness 官方发布 dsh-v0.1.3-alpha.1 GitHub Pre-release。它在刚成为 npm 默认版本的 0.1.2-rc.1 之上继续推进通用文件上传、代理环境变量、模型发现、Session v2 和跨 Agent 消息语义。
需要特别区分发布渠道：这一版有官方 Tag、Release Notes 和源码归档，但截至 2026 年 9 月 5 日并未发布为 npm 包。npm 的 latest 与 next 仍是 0.1.2-rc.1，alpha 仍是 0.1.2-alpha.5。
一句话结论
alpha.1 展示了 0.1.3 的下一阶段方向，但不是普通用户可以通过 npm 安装的默认升级。SessionHandle、Session v2 和已知历史会话性能回退，使它更适合源码评估与插件兼容研究，而不是直接替换日常环境。
版本状态
| 检查项 | 状态 |
|---|---|
| GitHub Release | v0.1.3-alpha.1，Pre-release |
| GitHub Tag | dsh-v0.1.3-alpha.1，提交 d347e70 |
| 发布时间 | 2026-09-04 11:34 UTC |
| npm 精确版本 | @deepseek-ai/[email protected] 未发布 |
npm latest / next | 0.1.2-rc.1 |
npm alpha | 0.1.2-alpha.5 |
不要把下面的命令写进安装教程，因为对应 npm 包当前不存在：
# 截至 2026-09-05 无法通过 npm 取得
npx @deepseek-ai/[email protected] web
Web 支持上传任意类型文件
Web 现在允许文件与图片在同一预览区混排。上传可以在后台显示进度、取消，并在切换会话后继续显示；保存完成后，模型可通过已有文件工具按路径读取内容。
这不等于模型原生理解所有文件格式。Harness 负责保存和暴露路径，模型最终能否处理，仍取决于工具组合、文件解析能力和当前工作区权限。
出站请求遵循系统代理环境变量
所有出站请求开始遵循启动环境中的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY。企业网络、本地代理和受限开发环境因此更容易统一配置，但代理也成为新的信任边界：它可能观察请求元数据或转发内容。
测试时应同时验证代理生效、NO_PROXY 排除项以及凭证是否只被发送到预期主机。
模型与图片工具体验
模型探测新增对自定义 Provider models 对象和 Anthropic 原生模型列表的支持，并可回填模型名称、上下文窗口与最大输出 Token。read_image 的顶层和 PTC 嵌套调用也会在 Web 工具卡中直接显示图片。
Python SDK 增加 macOS x64 runtime wheel 的源码发布工作，但 0.1.3 对应包尚未进入 PyPI 或 npm；Intel Mac 用户应以实际包文件为准，不能只根据 Release Notes 执行升级。
SessionHandle 与 Session v2
本版最大的开发者变化是 Session persistence API 改由生命周期持有的 SessionHandle 管理，agentLoop.create() 变为异步，并增加 Session 锁，保证同一个 Session 至多被一个进程持有。
Session 格式升级到 v2。旧 v0/v1 日志会通过相邻 generation 迁移到当前格式，Assistant 流按 attempt 聚合为持久化 settlement，同时 Web 保留实时增量显示。
这改善了并发所有权与恢复语义，但也是明确的破坏性变更。依赖 Session 创建时序、直接读写日志或自行管理锁的插件需要重新编译并做迁移测试。
修复与交互改进
发布说明还包括：
- 手动暂停 Goal 会立即终止当前模型轮次。
- 修复 DeepSeek 流式工具调用续传时丢失调用 ID 或名称的问题。
- 修复 Windows 盘符根目录 Workspace。
- 修复 Session 缓存读取与搜索结果进入会话后仍停留在搜索界面的问题。
- Skill 选择器支持模糊搜索。
- Agent Team 的
send_message统一采用 steer 语义，并保留发送者归属与顺序。
已知性能回退
官方明确说明本版存在一项已知性能回退，可能影响部分历史 Session 的加载响应速度，并计划在后续版本修复。使用大型历史会话评估时，应把加载时间、内存和迁移后的可恢复性纳入测试，而不是只验证新建会话。
适合谁关注
| 场景 | 建议 |
|---|---|
| 普通 npm 用户 | 使用当前默认 0.1.2-rc.1 |
| 插件或 Session 后端作者 | 阅读源码 Tag，验证 SessionHandle 与 v2 格式 |
| 需要通用文件上传 | 等待可安装版本，或只在隔离源码环境评估 |
| 依赖企业代理 | 关注代理变量支持，同时测试凭证与 NO_PROXY 边界 |
| 有大量历史 Session | 等已知性能回退修复后再考虑日常迁移 |
相关阅读
- DeepSeek Harness v0.1.2-rc.1：默认版本升级与迁移重点
- DeepSeek Harness v0.1.2-alpha.5：发布说明与 npm 状态
- DeepSeek Harness Python SDK 教程
- DeepSeek Harness 远程开发方案对比
常见问题
v0.1.3-alpha.1 已经能从 npm 安装吗？
不能。截至 2026 年 9 月 5 日，npm 没有这个精确版本；官方公开的是 GitHub Pre-release、Tag 和源码归档。
Session v2 会删除旧会话吗？
发布说明描述了从 v0/v1 到当前格式的 generation 迁移，而不是删除旧日志。重要数据仍应先备份，并在副本上验证迁移和恢复。
普通用户应该从 rc.1 切换到这一版吗？
不建议把它当作常规升级。它尚未发布到 npm，包含破坏性 Session API 变化，并有官方注明的历史 Session 性能回退。