DSH｜Blue｜为 DeepSeek Harness 打造的交互式终端 UI——一棵可热替换的 Cordis 插件树

[GeekCmore]

Important

非官方项目,由社区成员独立开发和维护。 Unofficial project — independently developed and maintained by a community member, not reviewed or endorsed by DeepSeek.

项目地址 / Links

• 仓库:https://github.com/dsh-blue/blue (MIT,开源)
• 文档(中文优先):https://dsh-blue.dev/ · English
• npm:@dsh-blue/blue · 一体化启动器 @dsh-blue/blue-cli

演示 / Demo

完整视频(20s):https://dsh-blue.dev/blue-demo.mp4 · 或在仓库内直接播放:website/public/blue-demo.mp4

项目介绍 / What is Blue

Blue 是 DeepSeek Harness(dsh)的交互式终端界面(TUI):把流式会话、工具卡片、审批问卷、状态栏和底部面板装进一个纯终端渲染器,以树外 Cordis 插件 bundle 的形式挂载在 dsh-base 之上。

Blue is an interactive terminal UI for DeepSeek Harness — streaming sessions, tool cards, approvals, status bar and dock panes in one pure-terminal renderer, mounted as an out-of-tree Cordis plugin bundle.

开箱可用的能力:

• 流式会话与工具卡片——回复实时流出;diff / 终端 / 搜索 / 读文件 / 网页等各类工具调用都有结构化呈现
• 底部 dock 面板——activity、queue、todo、btw、agents 五块面板随时翻看
• 输入编辑器增强——多行编辑、附件、终端里直接粘贴图片
• 六套主题(/theme 热切换,输入草稿不丢)+ 中英双语(/settings 热切换,按系统语言自动选择)
• 会话遗言——退出时最后一行给出会话 id 与一行恢复命令,三击整行选中,下次直接续上
• 应用内安全升级——/update 自带预检、快照、装机冒烟与失败自动回滚

与 DSH 的集成方式 / Integration

Blue 就是一个标准的 dsh 插件 bundle:dsh plugin add 装进独立 profile,不改动宿主;Agent/Session 对象从不进入渲染层,Blue 不维护第二份 Agent 状态。两条安装路径任选:

# 推荐:一体化 blue 启动器(内含校准过的 dsh 运行时)
npm i -g @dsh-blue/blue-cli@rc
export DEEPSEEK_API_KEY=sk-...
blue

# 或者:已有 dsh 的用户直装插件
npm i -g @deepseek-ai/dsh
dsh plugin --profile blue add @dsh-blue/blue@rc
dsh --profile blue

国内网络建议顺手配好镜像:pnpm config set registry https://registry.npmmirror.com。目前是预览版(@rc 通道),配置好 key 开箱默认连 DeepSeek 官方 API。

设计哲学 / Why it looks like this

TUI 不是一个包,而是一棵 Cordis 插件树。 每个渲染组件、交互 provider、命令和状态条目都是独立的 Fiber 插件——可热替换、可省略;插件卸载即整体回滚,依赖它的插件会自动重载。Blue 自己的每一项增强都通过下游插件可用的同一批「缝」注册:删掉全部增强行,bundle 照常启动照常工作。想给 Blue 写插件、换掉某个组件,和内置功能是同等地位。

Every render component, provider, command and status entry is its own hot-swappable Cordis plugin; Blue's own enhancements register through the same seams downstream plugins use.

反馈 / Feedback

预览阶段,欢迎拍砖:安装体验、键位习惯、面板设计,或者你想挂载的第一个插件。issue 和 discussion 都可以。

Sorting note per category guidelines:项目排序完全依据社区 Upvote,Upvote 不代表 DeepSeek 官方审核或推荐。