dsh-tianshu-tui

项目详情摘要

dsh-tianshu-tui — DeepSeek Harness coding 终端 中文 | English dsh-tianshu-tui**是官方 [DeepSeek Harness] 上的交互式终端 TUI 面板插件。渲染核心为自研极简 ANSI引擎，轻量渲染使用体验极度流畅。（由作者的[天枢 Tianshu-harness] https://github.com/huiliyi37/Tianshu-harness 演进而来。UI 是纯展示层：所有 agent 状态都来自会话事件流，流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断。在此之上做了工程层的改造，如图像与视觉桥接、代码智能检索、memory记忆与跨会话召回等。 文档 文档 | 说明 | 快速开始 | 安装、启动与常见问题 | 交互手册 | 快捷键与命令全表 | 配置 | 装配选项、环境变量与运行时配置 | 架构 | 分层、数据流与设计决策 | 主题 | 16 个内置主题与自定义 | 插件生态 | 伴生插件与扩展点 | VS Code | 在 VS Code 中使用 | ADAPTER.md | TUI ↔ harness 边界契约 | 贡献指南 | PR 规范与验证矩阵 | 开发说明 | 结构、构建与发布 | 安装 本包不是独立程序。须先有官方 CLI `@deepseek-ai/dsh`（npm `latest`，当前 `0.1.5-rc.1`；需 ≥ `0.1.5-rc.1`，peer 依赖对齐）。只 `npm i` 本包跑不起来。 一键安装（推荐）**：仓库自带跨平台脚本，自动检测 Node/pnpm、经 pnpm 安装官方 CLI + 装配本插件并启动（国内网络默认走 npmmirror 镜像）： 1. 准备环境 Node.js `^22.19 || >=24` `pnpm`（`dsh plugin` 会转发给它；没有时 `corepack enable` 即可——Node 自带 corepack） ⚠ **npm 11 的 OOM 坑**：官方 CLI `@deepseek-ai/dsh` 依赖树较大（60+ 子包），**npm 11（Node 24 自带）安装时会 JavaScript heap out of memory**（卡住数分钟后 OOM，实测复现）。请用 pnpm（下方命令）。若你已经在用 `npx -y @deepseek-ai/dsh` 且卡住/报 heap OOM，切到 pnpm 即可。 不要直接敲 `dsh`。** 若 PATH 上已有旧的 `dsh`（例如 `~/.local/bin/dsh`，`dsh --version` 低于 `0.1.0-rc.8`），会走到本地 staging，出现 `ERR_FS_EISDIR` / `Path is a directory .../@deepseek-ai/dsh`。请始终用下面的 `pnpm dlx` 命令。 2. 把本插件装进 tui profile pnpm 可能提示 peer missing，可忽略：peer 由官方 `dsh` 宿主提供，不必另装。没有 pnpm 也可以 `npx -y pnpm dlx @deepseek-ai/dsh plugin --profile tui add @huiliyi37/dsh-tianshu-tui`。 从 npm 安装后，每次启动会对照 npm `latest`：有新版本就写入 profile，提示重启后生效。也可在 TUI 里敲 `/update` 手动检查（只查不装，给出更新命令）。不想联网检查时设 `DSH_TUI_SKIP_UPDATE=1`。`github:` / `link:` 安装不会改写成 npm 包。 也可以从 Git 装：`pnpm dlx @deepseek-ai/dsh plugin --profile tui add github:huiliyi37/dsh-tianshu-tui`（仓库已包含 `lib/index.js`，不必再打包）。 3. 启动 看到欢迎页品牌 **dsh-tianshu-tui** 即成功。`Ctrl+Q` 或 `/ex