DeepSeek Harness v0.1.7-alpha.1
DeepSeek Harness v0.1.7-alpha.1：Session V4、Messages API 与 Preset
- 作者
- DeepSeekAgent.io 编辑部
- 发布
- 更新
DeepSeek 于 2026 年 9 月 22 日发布 dsh-v0.1.7-alpha.1。这是一次覆盖会话存储、模型协议、插件配置和 Agent Preset 的大版本预览：Session 升级到 V4，官方 DeepSeek 适配器只保留 Messages API，Agent Preset 转入插件 Bundle，Profile 设置也改由插件配置管理。
普通用户能直接看到会话归档、后台任务、文件 Diff、Office 预览和更完整的设置页面；维护插件、私有模型接入或团队 Profile 的用户，则需要认真处理迁移项。
发布与 npm 渠道
| 检查项 | 2026-09-23 状态 |
|---|---|
| GitHub Release | v0.1.7-alpha.1，Pre-release |
| npm 完整版本 | 0.1.7-alpha.1 已发布 |
npm alpha | 已推进到 0.1.7-alpha.2 |
npm latest | 0.1.5-rc.2 |
npm next | 0.1.5-rc.3 |
复现 alpha.1 时固定完整版本：
npx @deepseek-ai/[email protected] web
直接运行不带版本的 npx @deepseek-ai/dsh 仍会取得 latest，不会自动进入 0.1.7 alpha 系列。
会话管理从列表升级为工作台
侧边栏 Session 现在支持固定、归档、筛选、撤销和恢复。归档一个仍在运行的 Session 时，DSH 会先列出受影响的 Turn、Sub-agent、后台任务和 Reminder，再由用户确认停止并归档。
长任务可以转入后台继续运行，并在界面中显示实时输出。第一次启动还会自动建立默认工作区和空白 Session，减少从安装到首次发送任务之间的配置步骤。
对日常使用最有价值的变化包括：
- 长对话加载与 Turn 导航更顺畅；
- 文件预览可以刷新、在本机打开或定位到文件；
- Diff 支持并排检查；
- 进程按组折叠，后台命令保持可见；
- Work Details、Performance & Usage、Developer Tools 进入独立设置区域；
- Excel 预览覆盖 XLSX、XLS、CSV 和 TSV，PDF、Office 与图片预览支持缩放。
这些改动让 Session 不再只是一条聊天记录，而是任务、进程、文件和用量的统一入口。
Session V4：先迁移，再验证恢复链路
alpha.1 引入 Session Log V4，并提供批量迁移工具。V3 保留部分兼容能力，但长期运行的 Profile 不应只依赖自动兼容。
升级前应备份 Session 与 Profile，然后至少验证四条链路：
- 打开历史长会话，确认消息、附件和工具调用仍可读取；
- 继续一个旧 Session，完成一轮模型调用与文件写入；
- 重启 DSH，检查后台任务、归档状态和会话标题；
- 导出或复制关键 Session，确认 V4 日志能被团队现有工具读取。
仅存在于自定义事件中的附件，不再自动读取和导出。依赖这条行为的插件需要显式处理附件，否则迁移后可能只剩事件元数据。
官方 DeepSeek 适配器只保留 Messages API
官方 DeepSeek Adapter 在这一版移除了 Chat Completions 路径和 protocol 配置，只通过 Messages API 工作。旧配置如果仍带有 protocol，需要删除该字段，并把 Endpoint 指向兼容 Messages API 的服务。
升级后不要只看“Provider 已连接”。应新建 Session，连续检查：
- 普通文本回复；
- Tool Call 与 Tool Result 往返；
- 图片或文件内容块；
- 长上下文与主动压缩；
- 中断后继续会话。
alpha.1 同时为主动压缩预留输出和上下文空间，减少压缩发生得太晚、模型没有余量完成当前 Turn 的情况。
Agent Preset 转入插件 Bundle
Agent Preset 改由插件 Bundle 声明和安装。过去放在独立目录中的 Preset 需要迁移，不能继续假设 DSH 会扫描旧目录并自动加载。
这一变化把 Agent 的组成方式统一到插件系统：Bundle 可以携带多个补丁文件、图标、本地化标题与描述，并支持实时更新字段。Creator 模式的说明也改为按需加载，减少未使用内容占用上下文。
团队迁移时应检查：
| 原有内容 | 新位置或动作 |
|---|---|
| 独立 Preset 目录 | 转成插件 Bundle 声明 |
全局 settings.yaml | 首次导入后写入当前 Profile 的插件配置 |
| 单个补丁文件假设 | 适配 Bundle 的多补丁文件 |
| 写死的英文名称 | 补充本地化标题、描述和图标 |
| 自定义插件源 | 在 official、npmmirror 或 custom source 中明确配置 |
--dump-config-schema 可以导出当前配置 Schema，适合在升级前后比较字段变化。
Agent Team、任务板与内置模式
Agent Team 工具现在使用成员名称，任务板改为只读；成员通过工具更新任务状态。内置 Agent 模式补充了用途说明、使用指南和示例任务，选择模式时更容易理解它能做什么。
插件或自动化如果直接写任务板 UI 状态，需要改为调用对应工具。团队流程还应核对成员名是否稳定，避免继续把显示顺序或临时 ID 当成身份。
Windows 删除边界修复
alpha.1 修复了 Windows 沙箱删除操作可能逃逸已授权目录、跨工作区删除文件的问题。这是明确的安全边界修复，Windows 用户和提供共享工作区的团队应优先升级并重新验证删除权限。
回归测试至少包括：
- 删除工作区内的测试文件；
- 尝试访问相邻工作区；
- 使用相对路径、绝对路径和包含空格的路径；
- 拒绝权限后确认没有残留删除动作。
远程、插件与传输层变化
双向远程流支持二进制传输，读取接口向 readBytes 迁移。插件还可以声明本地化元数据和多补丁 Bundle。Web 环境默认关闭 Browser 工具，Electron 默认开启；依赖浏览器能力的 Profile 不应再假设两个运行环境拥有相同默认值。
其他修复覆盖反向代理子路径、旧 Sub-agent 通知 Session、插件安装后的连接状态、Markdown 本地图片、Files API、Playwright 插件阻止新建 Agent，以及大体积流式 Tool 参数阻塞进程等问题。
升级检查清单
| 使用场景 | 必查项目 |
|---|---|
| 普通用户 | Session 归档、后台任务、文件 Diff、历史会话恢复 |
| DeepSeek API | 删除 protocol，验证 Messages API Endpoint |
| Profile 维护 | settings.yaml 导入结果、插件配置、Browser 默认状态 |
| Agent 开发 | Preset 转 Bundle、本地化元数据、多补丁文件 |
| Session 工具 | V4 日志、附件事件、批量迁移和导出 |
| 远程插件 | 二进制流、readBytes、断线恢复 |
| Windows | 删除操作的工作区边界 |
alpha.1 的改动面明显大于普通补丁。需要稳定工作的主环境可以继续固定 rc 版本；要验证 Session V4、Messages API 或插件化 Preset，则应在 Profile 副本中固定 0.1.7-alpha.1 完成迁移测试。
相关阅读
- DeepSeek Harness v0.1.7-alpha.2 更新
- DeepSeek Harness v0.1.6-alpha.2 更新
- DeepSeek Harness 插件管理机制
- DeepSeek Harness 安全指南
常见问题
v0.1.7-alpha.1 是 npm 默认版吗？
不是。它已发布到 npm，但默认 latest 仍是 0.1.5-rc.2。复现本版必须写完整版本号。
旧 DeepSeek Provider 配置可以直接沿用吗？
需要检查。官方适配器已经移除 protocol 和 Chat Completions 路径，旧配置应改为 Messages API 兼容 Endpoint。
旧 Preset 目录会继续自动加载吗？
新架构要求 Agent Preset 由插件 Bundle 声明和安装。旧目录 Preset 应按 Bundle 结构迁移。