Blog · 指南

DeepSeek Harness FAQ

2026 年 8 月 14 日 · dshbase

这些是 DeepSeek Harness 社区里大家真正在问的问题——不是文档里写的那种。每个答案都来自 dsh 0.1.0-rc.6 的真实使用,以及我们在官方讨论区回答这些问题的第一手经验。

1. 权限系统为什么这么「笨」?

最高频的抱怨。dsh 用 git/node 时不会主动问权限——因为它用的是权限预设(permission presets):启动时定好的策略,不是逐工具询问。git 被拦,是因为当前预设把它归到了「审批」或「禁用」档。

解决:在设置里换权限预设,或装 dsh-tool-approval 插件实现真正的手动审批模式。都在插件目录里。

2. 为什么不能直接输入图片/文档?

拖图片进去提示「切换模型」,是因为当前模型没声明视觉模态input 不含 image)。dsh 不会偷偷把图片转成文本。

解决:在 settings.yaml 给模型加 input: [text, image],或用视觉插件——dsh-vision-toolkit(给纯文本模型做识图/OCR/图表解析)、dsh-drop-to-path(拖拽转路径)。

3. 长会话 token 暴涨,怎么降本?

三个真正有效的杠杆:

  • PTC 模式——dsh 的 prompt token cache 模式专门为 DeepSeek 前缀缓存优化,长会话重复前缀成本大降。
  • 早点 compact——手动 /compact,别等自动压缩。
  • 少装插件——每个工具的描述都占 token,按需装。

具体数字见我们的成本与缓存分析

4. 全新安装崩溃「--expose-internals is required」

干净环境下 cordis HMR loader 探测不到 Node 内部模块(macOS arm64 / NixOS / Linux 复现)。临时方案:

node --expose-internals $(which dsh) web

或设 NODE_OPTIONS=--expose-internals。这个和所有实测踩过的安装坑都在排错指南

5. 有 Docker 镜像吗?

官方还没出。但 dsh 是纯 Node.js——Node 18+ 加 npx @deepseek-ai/dsh web 就够了,headless 模式很适合塞进容器/CI。社区还有 oh-dsh 这种 TUI+桌面+Web 一体的发行版。见安装指南

6. 长期记忆怎么办?

记忆生态一周内爆发了,好几个方案都在目录里:

  • dsh-memory——基于无损会话日志的引用记忆
  • dsh-mnemon——运行时 + 可检索归档 + 受监督记忆
  • sage-mem——中文优先全文搜索记忆
  • dsh-sgme——通过 HTTP 的多 agent 共享记忆

7. 会有桌面端吗?

官方没有,但 TUI 和 oh-dsh 发行版覆盖了「类原生」体验。Web UI 是主界面。

还有没覆盖的问题?来官方社区提问。

全部文章 →

🌐 English