FAQ

FAQ · 常见问题

它和直接用 dsh CLI 有什么区别？

dsh 是引擎，agentLauncher 是它的图形化管理器：帮你隔离、组织、一键启动多个 Agent 实例，并管理各自的插件与密钥。对话本身仍在 dsh 自己的网页里发生。

为什么启动器里没有聊天界面？

这是刻意的设计。启动器只做管理，不做交互 UI —— 交互发生在 dsh 的网页。内置聊天会与 dsh web 重复，也违背「不做 UI」的初衷。日志则降级为一个只读日志页用于排障。

启动 web 实例后浏览器没自动打开？

启动器执行 dsh --profile web --no-open --port 0，并从 stdout 抓 http://127.0.0.1:<port> 再调用系统 opener 打开。若没打开：

1. 确认该 profile 的 bundles 含 @deepseek-ai/dsh-web-app（否则会被当作 headless）。
2. 看只读日志页里 dsh 是否真的打印了 URL。
3. 手动复制日志里的 URL 到浏览器。

报 ERR_MODULE_NOT_FOUND？

通常是某个插件的版本比本机 dsh 新，依赖了缺失的 @deepseek-ai/dsh-environment。用 dsh plugin --profile <p> remove <plugin> 移除该插件即可恢复（可再 add 回来）。

我在磁盘上手动建了实例，为什么启动器里看不到？

实例列表在窗口挂载时读取一次。重载一次窗口即可看到新实例。

会话历史 / 记忆存在哪？会丢吗？

存在该实例的 workspace/ 里。因为启动器给每个实例一个稳定路径 instances/<id>/workspace，历史跨次启动继承，不会丢。删除实例目录才会清除。

密钥安全吗？

• 每实例的 .env 只在启动子进程时注入，永不回流到前端。
• 全局 ~/.dsh/.credentials.yaml 保持 0600。
• 请勿把 .env / 凭据提交进 git。

支持 Windows / macOS 吗？

基于 Tauri 2，理论跨平台。目前主要在 Linux 上开发验证；其它平台需自行 pnpm tauri build 并测试。

headless / 批处理什么时候能用？

运行形态已从 profile 派生、通道已设计，但无人值守批处理路径暂缓（见 README 路线图）。