---
title: "DSH 0.1.5-alpha.2 更新：文件预览、模型设置恢复与升级判断"
seo_title: "DSH 0.1.5-alpha.2 更新：文件预览、模型设置恢复与升级判断"
description: "说明 DSH alpha.2 的文件预览与交付、模型配置恢复、面板 API 和 minimal 工具变化，区分默认安装基线、隔离验收与回退边界。"
canonical: https://52dsh.com/tutorials/deepseek-harness-0-1-5-alpha-2/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["已记录实际运行版本和 Profile","在独立数据副本中评估预发布能力"]
difficulty: intermediate
estimated_action_time: null
next_steps: null
published_at: 2026-09-10
updated_at: 2026-09-10
verified_on: 2026-09-10
maintenance_status: community
verification_level: source_reviewed
risk_level: high
dsh_version: 0.1.5-alpha.2
plugin_id: null
tutorial_kind: null
related_plugin_url: null
---

# DSH 0.1.5-alpha.2 更新：文件预览、模型设置恢复与升级判断

说明 DSH alpha.2 的文件预览与交付、模型配置恢复、面板 API 和 minimal 工具变化，区分默认安装基线、隔离验收与回退边界。

需要文件预览、文件交付或本版修复的用户，可以在独立数据副本中评估 DSH `0.1.5-alpha.2`。当前任务正常，或依赖社区 UI 插件与重要旧会话时，先完成兼容和数据验收，不因版本号更新就覆盖唯一环境。

2026-09-10 核对：本版仍为预发布，精确 npm 包已发布；`alpha` 指向本版，`latest`、`next` 仍为 `0.1.2-rc.1`。**本站默认安装基线保持 rc.1。** 本页为固定来源审阅，未运行新版安装、模型调用、真实会话迁移或插件兼容测试。

## 版本与升级选择

| 项目 | 已确认状态 |
|---|---|
| GitHub Tag | dsh-v0.1.5-alpha.2，预发布 |
| 固定提交 | `b2e3b2a0125854567a4a5fcba75782e42fe84901` |
| npm 精确包 / alpha | 已发布 / 0.1.5-alpha.2 |
| 默认 latest / next | 均为 0.1.2-rc.1 |
| 核验范围 | Tag、commit、包存在状态；包存在不代表所有插件兼容 |

依据：[官方发行页](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.2)、[npm 通道](https://registry.npmjs.org/-/package/@deepseek-ai%2Fdsh/dist-tags)、[精确包](https://registry.npmjs.org/@deepseek-ai%2Fdsh/0.1.5-alpha.2)。旧版行为仍见 [alpha.1 专题](/tutorials/deepseek-harness-0-1-5-alpha-1/)。

## 最值得体验：预览和交付文件

右侧 Sidebar 可预览 Markdown、代码、HTML、PDF 与图片。模型可以通过 `present` 声明已经生成且可访问的最终文件；卡片提供侧栏预览和 Host 原生打开、定位入口。

**交付声明不是文件快照。** 固定实现记录路径及说明，不保存文件内容；编辑源文件会影响后续打开，删除或移动会导致失败。远程浏览器的“默认应用”动作发生在 Host，不能据此认为文件下载到了手机或另一台电脑。操作步骤与限制见[文件预览与交付指南](/tutorials/dsh-file-preview-delivery/)。

## 哪些故障有明确版本说明

| 任务 | alpha.2 的官方变化 | 用户下一步 |
|---|---|---|
| 模型目录变化后设置入口消失 | 保留诊断与修复入口 | 修复或删除错误模型配置，见[Provider 指南](/tutorials/deepseek-harness-model-provider/) |
| 自定义 Provider 地址无效 | 在发现或创建前校验和规范化 Base URL | 先解决地址错误，认证失败仍另查 |
| npm 安装触发 fs-ext 编译 | 发行说明列明修复 | 区分安装包与源码运行，见[启动排障](/errors/web-ui-start-failed/) |
| MCP 工具发现持续等待 | 拒绝重复分页游标，保留上一组可用工具 | 查错误与服务端分页，见[MCP 指南](/plugins/dsh-mcp-guide/) |

这些是发行说明与固定文档的结论，不是本站运行结果。模型配置恢复仍有 Schema 与 Profile 约束边界，fs-ext 修复也不能推广为所有系统和架构均无原生依赖问题。

## 插件作者和重度用户先看面板接口

全局面板通过 `sidebar.panellist` 与 `main` 注册；原 `conversation` Slot 迁移为 `main` 的 `conversation` key。依赖旧 Slot 或侧栏注册接口的插件需要重新核对挂载、导航和实际功能，alpha.1 下的验收不自动覆盖 alpha.2。

本批没有升级插件目录或解除暂缓状态。按[插件 Profile 指南](/plugins/dsh-plugin-profile-guide/)记录依赖、Bundle、Profile，优先在副本中检验设置入口、文件打开和会话切换；报错中第一个插件名不一定是根因。

## minimal 和实验性 Agent Teams

Web `minimal` 与 Python `sdk-minimal` 默认仅提供持久 shell，`str_replace_editor` 改为显式启用。工具少不等于只读，shell 仍能修改文件；完整 SDK 与 Headless 不应套用这套默认工具说明。见[Headless 指南](/tutorials/dsh-headless-guide/)。

官方发布了 `@deepseek-ai/dsh-experimental-agent-team-profile` 与 `@deepseek-ai/dsh-experimental-agent-team-web-profile` 等实验层，需要显式添加，随附 Web Profile 不默认启用。它们与本站已有的[社区 Agent Teams](/plugins/nanmicoder-dsh-agent-teams/)是不同维护对象；包发布不代表社区插件原有兼容问题解除。本页不提供未经本批验收的安装推荐。

## 昨日的迁移失败和搜索 401 修复了吗

截至本次复核，尚无足够证据将 #6010、#5979 涉及的会话问题标为已解决。已对比的 V2 关系校验文件与 alpha.1 相同，但单个文件相同也不能证明整个迁移链未变。[会话打不开排障](/errors/dsh-session-open-failed/)的备份、分流和停止条件仍应保留。

搜索配置 `index.ts` 与 alpha.1 相同。Base URL 校验改进不等于搜索认证修复，聊天与搜索仍应分别验证，见[搜索 401 排查](/errors/dsh-missing-credential-401/)。社区回复、补丁建议和用户测试不能替代固定修复版本与本站复现。

## 升级前后怎样验收

1. 记录实际启动版本、安装方式、Profile、插件版本和数据根，停止任务并保存完整独立副本。
2. 按[更新与回退指南](/tutorials/dsh-update-uninstall/)选择精确目标，在可丢弃副本中检查程序、客户端模块、插件功能和重要历史正文。
3. 若评估文件能力，使用无敏感信息的示例文件，分别核对侧栏预览与 Host 打开，不重跑历史工具来验收。
4. 遇到迁移错误、来源不明的插件故障或只有唯一数据副本时停止写操作，保留脱敏错误。
5. 回退使用匹配的旧程序与旧数据副本。Session 仍为 V3，旧程序不能降级读取，新写入对话不能承诺自动合并回旧副本。

## 原始来源

- https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-alpha.2
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-sidebar/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-sidebar-documentpreview/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/client/ui-deliverables/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/fs/tool-present/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/llm/llm-pi-ai/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/bundle/sdk-minimal/README.zh.md
- https://github.com/deepseek-ai/deepseek-harness/blob/b2e3b2a0125854567a4a5fcba75782e42fe84901/packages/experimental/agent-team-web-profile/README.zh.md