---
title: "DeepSeek Harness 0.1.3-alpha.1 更新：Session v2 与升级注意事项"
seo_title: "DeepSeek Harness 0.1.3-alpha.1：DSH 会话迁移、文件上传与升级风险"
description: "解读 DeepSeek Harness 0.1.3-alpha.1 的 Session v2、文件上传、代理和模型发现变化，区分 DSH 默认安装通道、预发布获取条件、已知性能问题与升级前检查。"
canonical: https://52dsh.com/tutorials/deepseek-harness-0-1-3-alpha-1/
authors: ["52DSH 编辑部"]
audience: ["评估 DSH 新版的用户","维护 Session 或模型插件的开发者"]
outcomes: ["区分默认安装版与预发布版","确认 Session 迁移和回退边界","按任务进入对应配置与排障页"]
prerequisites: ["记录当前 DSH 版本","保留原始 Session 和 Profile 副本","核对目标版本的分发方式"]
difficulty: intermediate
estimated_action_time: null
next_steps: null
published_at: 2026-09-05
updated_at: 2026-09-05
verified_on: 2026-09-05
maintenance_status: community
verification_level: source_reviewed
risk_level: high
dsh_version: 0.1.3-alpha.1
plugin_id: null
tutorial_kind: null
related_plugin_url: null
---

# DeepSeek Harness 0.1.3-alpha.1 更新：Session v2 与升级注意事项

解读 DeepSeek Harness 0.1.3-alpha.1 的 Session v2、文件上传、代理和模型发现变化，区分 DSH 默认安装通道、预发布获取条件、已知性能问题与升级前检查。

## 先看版本与升级判断

DeepSeek Harness `0.1.3-alpha.1` 是 2026-09-04 发布的预发布版，包含文件上传、代理、模型发现与 Session 持久化变化。**截至 2026-09-05 复核时，npm `latest` 和 `next` 都是 `0.1.2-rc.1`，alpha.1 精确包尚未发布到 npm。** 普通安装应参考[rc.1 入门步骤](/tutorials/deepseek-harness-install-web-ui/)，不能把 GitHub 的最新版本号直接拼成可用的 npx 命令。

本次最需要留意的是 Session format v2、SessionHandle 和异步创建接口，以及官方已知的部分历史会话加载性能回退。重要会话与插件环境应先保留旧程序、配置和数据副本，再决定是否隔离评估。52DSH 阅读了官方发布说明与固定提交，**没有安装或运行该版本，也没有执行真实 Session 迁移**。

| 版本或记录 | 本次核对结果 | 用途 |
|---|---|---|
| npm 默认分发 | `0.1.2-rc.1` | 当前入门命令的版本依据，仍为候选版 |
| GitHub 最新预发布 | `0.1.3-alpha.1` | 新能力与兼容性评估 |
| alpha.1 固定提交 | `d347e703908d0406b7a7ef80e3a0e594d86b2215` | 本文新版事实的审阅基准 |
| rc.1 固定提交 | `a66e4702047846cdaa10c66c9d3df3951f5ea70d` | 默认版 CLI 与入门路径的基准 |
| 已有插件教程 | 保留各自声明的版本 | 全局默认版更新不构成插件新版验证 |

rc.1 承接此前 0.1.2 预发布序列；[alpha.5 的启动与标题修复](/tutorials/deepseek-harness-0-1-2-alpha-5/)仍保留历史解释。本文聚焦从 rc.1 到 alpha.1 的变化，不替代[更新、回退与卸载指南](/tutorials/dsh-update-uninstall/)。

## 文件上传：上传完成不等于模型已读完

官方 Release 增加 Web 通用文件上传，文件与图片可以在同一预览区域展示，并显示后台进度、取消与会话切换后的状态。模型通过保存后的路径及已有文件工具按需读取，不代表所有格式都能自动解析，也不代表文件全部内容已进入模型上下文。

固定上传服务将暂存凭证绑定到具体 Session。其传输层明确不支持失败或取消后的断点续传，重试从头开始；因此“切换会话仍能看到进度”不能写成“网络中断后续传”。首次使用选择不含敏感数据的小文件，确认目标 Session、上传状态、引用文件与最终回答相符。清理时还需核对保存文件和会话记录，取消上传不等于清除全部已存数据。

## Session v2：打开旧日志也可能生成迁移文件

固定格式 catalog 的当前版本是 2，并包含 `v0 → v1 → v2` 的相邻迁移链。JSONL 后端选择数值最高的规范 generation，在受支持的旧格式旁发布新格式文件，保留源文件字节。新格式还调整 Assistant 流的持久化表达，不能用旧事件示例直接推断当前磁盘结构。

尤其需要区分两类操作：

| 操作 | 固定 JSONL 实现的行为 | 实际意义 |
|---|---|---|
| `stat`／`list` | 处理 header，不发布迁移产物 | 列表查询不同于读取完整日志 |
| `open` 的 read 或 write 模式 | 返回句柄前可为旧格式发布当前后继 | 即使只想读取，也应先准备数据副本 |

保留旧 generation 不是自动降级保证。旧程序可能拒绝高版本格式；回退应恢复与旧程序相匹配的完整数据和配置副本。不要手动删除、改名或拼接 generation 来迫使程序读取旧文件。此前移除的 SQLite 权威持久化后端属于另一个历史边界，JSONL v0/v1 迁移不能被宣传成 SQLite 一键转换。

继续阅读 [Session 使用与恢复指南](/tutorials/dsh-session-guide/)，区分恢复、Fork、Compaction 与文件回滚。

## 插件接口：句柄、异步创建与单写者

新版持久化 `create`／`open` 返回 `SessionHandle`，日志读取、追加、flush 和 close 由句柄承担；`agentLoop.create()` 变为异步。JSONL 后端结合进程内所有权和平台锁约束写入者，读句柄也不能作为写句柄使用。

对直接操作 Session 的插件，必须重新核对创建、读取、归档、删除、恢复和关闭时机。没有作者证据或独立审阅时，应保留原适用版本，而不是给它贴上 alpha.1 兼容标签。遇到占用错误，先确认持有进程及正常退出路径，不能靠删除锁文件解除排他保护。

## 代理与模型发现有哪些限制

alpha.1 支持从启动环境读取 `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY` 和 `NO_PROXY`。固定策略接受 HTTP(S) 代理，loopback 默认绕过；SOCKS、PAC 和 CIDR 绕过条目不能按普通 HTTP 代理配置理解。不受支持的值可能被跳过并导致直连，所以设置代理并不等于所有执行路径都不会直连。

模型发现增加自定义服务 `models` 对象与 Anthropic 原生列表的解析。返回的是供用户选择的候选信息，仍须保存并验证实际推理请求；已有 catalog 的路由可以不联网回答，不代表实时刷新整个模型目录。详见[模型、Provider 与代理配置](/tutorials/deepseek-harness-model-provider/)。

## Agent Team 消息与普通子 Agent 分开理解

官方提到的 Agent Team `send_message` 调整涉及实验性团队实现：运行中成员按步骤边界接受 steer，空闲成员可开始后续工作，并在冷恢复投递中保留来源信息。固定包说明也明确其为实验性能力，不能据此声称 npm 默认 Web 已开放所有团队功能。

普通直属父子 Agent 与实验性团队虽然可能使用同名工具，关系边界和投递模型不同。现有 [多 Agent 代码复核案例](/cases/multi-agent-code-review/)分别说明两者；不要外推成任意 Agent 通信或保证即时送达。

## 已知性能问题与评估清单

官方已注明部分历史 Session 加载可能变慢，并计划在后续版本修复。没有官方后续证据之前，不声称已经解决，也不把变慢等同于数据丢失。可参考[Web UI 与会话异常分流](/errors/web-ui-start-failed/)。

评估前记录来源版本、目标版本、Profile、插件清单及可恢复的原始数据；在副本中分别核对列表、标题、旧会话内容、最小文本请求和必要插件。新增文件、格式错误、占用错误、加载时间异常应分别记录。失败时停止测试，保留证据与原环境，不把升级、清理日志和插件全量更新混在一起。

## 获取与下一步

本次查询未发现 alpha.1 精确 npm 包，因此本文不提供其 npm 安装命令。需要源码评估的维护者应从官方固定提交和对应构建文档确认环境与分发方式，本站尚未执行构建或运行验证。

- 第一次使用：按[安装指南](/tutorials/deepseek-harness-install-web-ui/)或[完整入门](/tutorials/dsh-complete-guide/)使用锁定的 rc.1。
- 维护已有环境：先阅读[更新与回退](/tutorials/dsh-update-uninstall/)，保留旧环境的验证记录。
- 只想理解产品与版本：查看[DeepSeek Harness 是什么](/tutorials/what-is-deepseek-harness/)。

版本分发可能继续变化，操作前重新查询官方 Release 和 npm。本文的日期、版本与证据等级描述的是本次固定来源审阅，不是对未来版本的承诺。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.3-alpha.1
- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.2-rc.1
- https://registry.npmjs.org/@deepseek-ai%2Fdsh/latest
- https://registry.npmjs.org/@deepseek-ai%2Fdsh/0.1.2-rc.1
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/session/session-format-catalog/src/generated.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/session/session-persistence-jsonl/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/session/session-persistence/src/handle.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/core/agent-loop/src/index.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/client/file-upload/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/util/http-proxy/src/policy.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/llm/llm-pi-ai/src/discovery.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/d347e703908d0406b7a7ef80e3a0e594d86b2215/packages/experimental/tool-agent-team/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/a66e4702047846cdaa10c66c9d3df3951f5ea70d/apps/cli/reference/README.zh.md