TypeScript · 项目报告

letstri/druk

该仓库暂未提供 GitHub 项目描述。

已完成 打开 GitHub
L
347星标
17Fork
4Issue
未知许可证

分析结果

项目分析

Druk 是一个运行在终端里的轻量级代码编辑器,提供文件树、标签页、项目/文件搜索、Git 状态标记、Git 操作、Markdown 预览、30 多种语言语法高亮,以及键盘和鼠标操作支持。它以单个自包含可执行文件发布,不要求预装 Node.js 或 Bun,适合希望在 SSH、服务器、容器或纯终端环境中进行快速编辑的开发者。

适用领域 终端开发工具 / 代码编辑器 / CLI 工具 / 远程开发 / Git 工作流 / 文本编辑 / Markdown 编辑
配置难度 低到中等。基础使用接近 VS Code 的快捷键和文件树交互,上手较容易;但如果要高效使用 Git 面板、Vim 模式、终端快捷键兼容配置和远程剪贴板能力,需要一定终端经验。
商业价值 对于需要频繁远程登录服务器、容器或云主机的团队,Druk 可以降低终端环境下代码查看和小规模修改的门槛,相比 vim/nano 更直观,也比完整远程 IDE 更轻量。它适合用于运维修复、线上排障、轻量代码审查、配置文件修改和远程项目快速编辑。但由于许可证不明、社区规模较小、IDE 高级能力有限,更适合作为辅助工具或团队推荐工具,而不是核心开发平台的唯一选择。
01

技术亮点

  • 单文件自包含可执行程序,部署简单,不依赖 Node.js 或 Bun 运行时
  • 终端内提供接近现代编辑器的体验,包括文件树、标签页、状态栏、命令面板和模糊文件搜索
  • 支持鼠标操作,可点击标签、文件树、编辑区并拖拽调整侧边栏宽度
  • 内置 Git 集成,可显示行级改动、文件状态、分支 ahead/behind 信息,并支持 commit、push、stash、分支操作等
  • 支持 Markdown 渲染视图,可在源码和预览之间切换
  • 支持 30 多种语言语法高亮,适合多语言项目查看和编辑
  • 支持项目级会话恢复,包括打开的标签、活动文件和展开的目录
  • 支持系统剪贴板,并在 SSH 场景下通过 OSC52 支持复制粘贴
  • 提供 Vim 模式,兼顾传统键盘流用户
  • 快捷键设计接近 VS Code,例如 Ctrl+P 打开文件、F1 命令面板、Ctrl+F 查找
02

目标用户

  • 经常在 Linux/macOS/Windows 终端中工作的开发者
  • 需要通过 SSH 在服务器上直接编辑代码的后端、运维、SRE、DevOps 工程师
  • 喜欢 VS Code 风格快捷键但希望在终端内工作的用户
  • 需要比 nano/vim 更直观、比完整 IDE 更轻量的编辑器用户
  • 需要在容器、远程机器、CI 调试环境中快速查看和修改项目文件的开发者
  • 对 Vim 有一定偏好但又希望使用现代 UI 功能的用户
03

配置要求

  • 支持平台:macOS arm64/x64、Linux arm64/x64、Windows x64
  • 官方脚本安装会将二进制文件放入 ~/.druk/bin,并尝试加入 PATH
  • npm/bun 包本质上是下载同一个二进制文件的启动器,安装时需要能够访问 GitHub 或配置镜像
  • 如果网络无法访问 GitHub,可设置 DRUK_DOWNLOAD_BASE 指向镜像地址
  • 配置文件路径为 ~/.config/druk/config.json
  • 可配置主题、透明背景、tabSize、Vim 模式、侧边栏宽度、保存时去尾随空格、失焦自动保存、是否显示 dotfiles、是否尊重 .gitignore、diff 展示方式等
  • 不需要预装 Node.js 或 Bun 来运行已下载的二进制版本
  • 某些终端对 Ctrl+Shift、Ctrl+/ 等组合键支持有限,但项目提供了替代快捷键或兼容说明
04

适用场景

  • 在服务器或远程 SSH 环境中快速打开项目并修改代码
  • 在终端内浏览项目文件树、打开多个标签页、进行模糊文件搜索
  • 对项目进行全文搜索、文件内查找和替换
  • 查看 Git 修改标记、阅读 diff、提交 commit、push、切换分支
  • 编辑 Markdown 文件并在终端内查看渲染效果
  • 在没有图形界面的环境中完成日常小规模代码编辑
  • 临时使用 npx druk 或 bunx druk 打开项目,无需全局安装
05

部署与配置

  • 方式一:使用官方安装脚本:curl -fsSL https://druk.letstri.dev/install | bash
  • 方式二:使用 npm 全局安装:npm install -g druk
  • 方式三:使用 bun 全局安装:bun add -g druk
  • 方式四:直接从 GitHub Releases 下载对应平台二进制文件
  • 安装后运行 druk 打开当前目录,或运行 druk ./my-app 打开指定目录
  • 打开单个文件可使用 druk src/main.ts,也可以用 druk src/main.ts:42 跳转到指定行
  • 后续升级可运行 druk update
06

风险与注意事项

  • 项目星标约 347,fork 约 17,社区规模相对较小,生态和长期维护稳定性需要观察
  • README 未显示明确开源许可证,商业或公司内部使用前应确认 license 情况
  • 作为终端编辑器,功能深度预计无法完全替代 VS Code、JetBrains IDE 等完整 IDE
  • 可能缺少 LSP、智能补全、调试器、插件系统、重构工具等高级开发能力
  • 终端快捷键兼容性受不同终端模拟器限制,部分组合键可能无法发送或行为不同
  • npm/bun 安装方式需要下载二进制文件,国内网络环境可能需要镜像配置
  • Windows 支持仅列出 x64,其他架构或终端环境可能存在兼容性问题
  • 若用于大型 monorepo 或超大文件,性能表现需要实际测试

历史记录

热榜历史快照

2026-07-31 第16名 新收录 · github_search