[分享] 做了个开源终端 TUI 工具: dsh-tui (DeepSeek Harness)

查看 21|回复 0
作者:tomowang   
最近在尝试 DeepSeek 官方的 agent harness ( dsh ),官方自带的是 web-app 和 headless 两种前端,平时用终端用的比较多,正好学习写了个 TUI —— dsh-tui 。
  • 项目地址: https://github.com/tomowang/dsh-tui
  • npm: https://www.npmjs.com/package/@tomowang/dsh-tui

    快速安装:
    dsh plugin --profile tui add @tomowang/dsh-tui
    dsh --profile tui
    dsh --profile tui --resume            # reopen a persisted session
    dsh --profile tui --agent-preset       # start a fresh session on a given preset
    dsh --profile tui --dump-config                  # inspect the composed plugin tree
    是什么
    dsh-tui 是一个 out-of-tree 的 dsh bundle ,同时也是一个 Cordis 插件。原理上和官方 dsh-web-app / dsh-headless 一样,都是叠在 @deepseek-ai/dsh-base 之上,模型适配、工具调用、会话持久化、沙箱和审批策略这些全部留在 dsh-base 里没动,dsh-tui 只负责终端侧的输入和渲染,算是给 dsh 换了个「壳」。
    功能
  • 状态栏:session id 、当前模型/provider 、agent 预设、运行状态(带 spinner )、排队消息数
  • 统计行:turn/step 数、LLM/工具耗时、TTFT 、解码速度、cache 命中率、计费 token 、context 占用
  • /model:终端里直接切模型,或增删改自定义 LLM provider (不用去改配置文件)
  • /presets:浏览/切换 agent 预设,配合启动参数 --agent-preset
  • /trajectory、/context、/plugins:分别是事件台账、context 占用可视化、插件树状态,排查问题挺好用
  • Shift+Tab 循环切换权限预设(只读/工作区可写/完全放开/自定义)
  • --resume  精确还原历史:因为渲染只读持久化的事件日志,不维护额外的内存状态,回放和实时走的是同一套逻辑
  • readline 风格的行编辑、跨进程持久化的输入历史(上下箭头翻)

    技术栈
    TypeScript + Ink ( React 渲染终端 UI )+ Cordis ( dsh 底层的插件框架),MIT 协议。
    预览
  • 您需要登录后才可以回帖 登录 | 立即注册

    返回顶部