第 28 卷

> 预测会错，但"现在入场的成本最低"这一点，大概率不会错。

---

**附录 A**：[术语表与命令速查](./appendix-glossary.md)

第 12 章：已知不足与边界——诚实版

> 本章目标：不吹不黑，列出 dsh 当前的**已知不足**与**使用边界**。写这本白皮书时 dsh 仍处于 `0.1.0-rc.6`（预发布阶段），这些不足是"此刻的事实"，不是"永远的宿命"——它们会随版本

迭代变化。

> > 本章所有"已知问题"均来自本机实测 + 官方仓库 deepseek-ai/deepseek-harness 讨论区（截

至 2026-08-14）的公开反馈。

TL;DR（本章核心，30 秒版）

1. **rc 阶段是最大的不确定性**：API/配置随时可能破坏性变更，投入前先锁版本线
2. **插件生态早期**：官方包 60+ 但覆盖有限，第三方插件少，交互形态（TUI）缺失
3. **跨平台短板**：Windows 上除路径/编码 bug（UTF-16、0x00）外，还有端口保

留、局域网访问、沙箱稳定性、WSL 工作区、子进程终止等家族问题（速查表见 [12.4] (#124-跨平台已知问题速查表)）

1. **性能边界未充分验证**：高并发、大型代码库场景缺少公开压测数据
2. **官方策略风险**：开源承诺 vs 商业化转向，是选型时必须考虑的黑天鹅

<!-- [fix] 结构核验：补齐本章导航（第 12 章为新增章节，原缺失，与第 3-11 章结构保持一致） -->

<details><summary>本章导航</summary>

• [12.1 rc 阶段的不稳定性](#121-rc-阶段的不稳定性)
• [12.2 插件生态早期](#122-插件生态早期)
• [12.3 跨平台短板](#123-跨平台短板)
• [12.4 跨平台已知问题速查表](#124-跨平台已知问题速查表)
• [12.5 性能边界未充分验证](#125-性能边界未充分验证)
• [12.6 与成熟 Agent 的差距](#126-与成熟-agent-的差距)
• [12.7 官方策略风险](#127-官方策略风险)
• [12.8 白皮书自身的局限](#128-白皮书自身的局限)

</details>

---

12.1 rc 阶段的不稳定性

破坏性变更随时发生

dsh 从 rc.1 到 rc.6 已经历过至少一次**依赖断裂**：早期版本 `@deepseek-ai/*` 包的版本线不一致会导致插件装不上（404/ERR_MODULE_NOT_FOUND）。rc.6 收敛了很多，但**

没有任何承诺**说 rc.7/正式版不会再来一次。

**对你的实际影响**：

• 写教程/插件，可能每两周就要跟着改一遍
• 锁版本线（`^0.1.0-rc.6`）是基本操作，但 rc 线升级是"向上兼容"还是"推翻重来"，取决

于官方心情 > [!WARNING]

> 生产环境请谨慎评估。白皮书写作时官方仍在快速迭代，**今日的写法明天可能就废弃**。

已知的 rc 坑（本机/社区复现）

坑表现状态

link 开发依赖断裂@deepseek-ai/ 本地已定位（扁平兜底目录机 link 时报制），需锁依赖线规避

ERRMODULENOTFOUN D，npm 安装却正常

Windows 路径 0x00含中文/特殊字符路径社区反馈中（#151/ workspace 创建失败#396）

（ENOENT）

fs-sandbox 竞态post-check 路径检查与社区反馈中（#159）

workspace-write 存在时序竞态

TUI 缺失官方 examples 无交互终建议中（#392）

端 UI（社区自建有，未纳入）

12.2 插件生态早期

**现状**：官方包 60+，但生态整体处于"零日"状态。

• **第三方插件少**：讨论区插件帖在爆发，但质量参差，多数是"第一个插件"练手作
• **交互形态缺失**：headless/JSON-RPC/Web 形态齐全，**TUI 等终端交互形态无官方

示例**（社区 deepseek-harness-tui 已证明可行，未纳入官方）

• **文档滞后于代码**：官方文档以架构为主，上手路径/避坑记录依赖社区自产（这正是

本白皮书存在的理由）

• **版本线混乱**：npm 上同包多版本线并存，装错线就是 404

**判断**：生态玩法现在入场是早期红利（竞争少、官方扶持意愿强），但**不要指望"照着官方文档就能跑"**——踩坑是常态。

12.3 跨平台短板

dsh 在 macOS/Linux 上表现成熟，但 Windows 支持有明显的**第二公民感**：