跳到正文

turtle1999/turtle-ui

61最近提交 2026年8月13日

turtle-ui DSH 插件

Turtle UI 是 DeepSeek Harness 的终端用户界面插件。它作为 DSH profile bundle 分发，安装时自动激活 patch 层。该插件负责终端显示和用户输入，而 DSH 的智能体、模型、工具和持久化功能仍由核心框架负责。

terminal

如何安装 turtle-ui DSH 插件

dsh plugin --profile tui add github:deepseek-harness/turtle-ui   # fails with the allowBuilds key

复制不会执行命令。安装 turtle-ui DSH 插件前请核对仓库和版本。

turtle-ui DSH 插件数据来源

turtle-ui DSH 插件快照日期：2026年8月16日

discovered

turtle-ui DSH 插件能做什么

  • 为 DeepSeek Harness 提供基于终端的用户界面
  • 支持会话管理：通过命令行标志创建、显式命名和恢复会话
  • 作为 DSH profile bundle 安装时自动激活其 patch 层
  • 从 git 安装时通过 `prepare` 脚本在用户机器上构建
  • 与 `@deepseek-ai/dsh-base` 集成，实现持久会话绑定

turtle-ui DSH 插件适合哪些场景

  • 在终端环境中使用 Turtle UI 与 DeepSeek Harness 交互
  • 通过 `--session` 或 `--resume` 参数管理多个隔离的会话
  • 将 TUI 层与核心框架分离，实现更清晰的 profile 管理
  • 在本地使用兄弟 Harness 目录进行 TUI 开发和测试

turtle-ui DSH 插件适合谁

  • 偏好终端界面的 DSH 用户
  • 为 DSH TUI 插件做贡献或测试的开发者

turtle-ui DSH 插件的限制

  • 应用内的 `/resume` 切换和退出消息功能尚未可用
  • 从 git 安装时首次尝试需要手动配置 allow-builds
  • 类型检查需要兄弟 DeepSeek Harness 目录
  • 仅支持终端环境，无图形界面

turtle-ui DSH 插件的仓库 README 摘录

以下文字摘自 turtle-ui DSH 插件的上游仓库 turtle1999/turtle-ui 的 README，版权归原作者，仅作引用。

> The very first UI of dsh in a Friday afternoon This repository contains the former `packages/ui/tui` implementation, its unit and terminal snapshot tests, and a dsh profile bundle patch. The TUI owns terminal presentation and input; DeepSeek Harness owns the agent, model, tools, persistence, and `dsh` launcher. ## Development Keep this repository and DeepSeek Harness as siblings: ```text ~/git/deepseek-harness ~/git/turtle-ui ``` Install and build the sibling Harness, then Turtle UI: ```sh (cd ../deepseek-harness && pnpm install && pnpm run build) pnpm install pnpm run build ``` The peer APIs come from the sibling Harness checkout. The standalone TypeScript and Vitest configurations intentionally resolve those sources through `../deepseek-harness`; Vitest uses the Harness build for the goal host module instead of mixing that source module with transitive built packages. The patched `@earendil-works/pi-tui` is a devDependency bundled into `lib/` at build time, so consumers install no pi-tui and need no `patchedDependencies`. ## Run Turtle UI is a dsh profile bundle: its `package.json` declares `"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }`, so installing it into

阅读完整 README仓库许可: BSD-3-Clause

turtle-ui DSH 插件常见问题

如何从本地目录安装 Turtle UI？

首先确保 Turtle UI 和 DeepSeek Harness 是兄弟目录（例如 ~/git/deepseek-harness 和 ~/git/turtle-ui）。先构建兄弟 Harness：`(cd ../deepseek-harness && pnpm install && pnpm run build)`，然后在 turtle-ui 目录中执行 `pnpm install && pnpm run build`。最后添加到 profile：`dsh plugin --profile tui add file:.`，并使用 `dsh --profile tui` 启动。

如何直接从 GitHub 安装 Turtle UI？

运行 `dsh plugin --profile tui add github:deepseek-harness/turtle-ui`。首次尝试会失败，因为 pnpm 10 及以上版本默认阻止构建脚本。pnpm 会打印一个 `allowBuilds` 密钥；将该密钥复制到 profile 的 `pnpm-workspace.yaml` 文件中（位于 ~/.dsh/profiles/tui/pnpm-workspace.yaml）。然后重新运行同样的 `add` 命令，它将正常构建并激活。

如何创建一个指定 ID 的新会话？

使用 `--session` 参数后跟一个 ID。例如：`dsh --profile tui --session my-session`。这将创建一个显式命名的全新会话。如果不提供 `--session`，每次启动时会自动生成一个随机会话 ID。

如何恢复之前的会话？

使用 `--resume` 参数后跟会话 ID。例如：`dsh --profile tui --resume my-session`。这将恢复持久化的会话。注意应用内的 `/resume` 切换功能尚未可用，因此必须通过命令行进行操作。

从 git 安装时遇到 allowBuilds 错误怎么办？

该插件使用 `prepare` 脚本在安装时编译 lib/ 目录。pnpm 10 及以上版本默认阻止此类脚本。错误信息会包含一个 `allowBuilds` 密钥，你需要将其添加到 profile 的 `pnpm-workspace.yaml` 文件中。添加后重新运行相同的 `dsh plugin add` 命令，构建即可继续。