← 返回列表
需源码安装
在终端里热插拔渲染与交互插件,直接显示 Markdown 与图表
暂不能直接安装(需源码编译或环境不满足):缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。 · 最近上游提交 2026/9/2 · 已提供中文文档
蓝色:TUI 不是一个包,而是一棵 Cordis 插件树——一个面向 DeepSeek Harness 的现代终端 UI,支持热插拔的渲染、交互和命令插件。
综合分
41.5
GitHub 分
41.5
用户评分
—
★ Stars
18
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dsh-blue/blue缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装,改用 GitHub 源安装
🟢实装验证通过· 2026/9/8
由 dsh-plugin-verify(GitHub Actions)在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/3(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✗npm 包@dsh-blue/blue-root(未发布到 npm,仅可源码安装)
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装
验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 16:26:00
依赖的 DSH / Cordis 模块
@deepseek-ai/dsh-llm-mock-server用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
Blue
CI
Node
pnpm
License: MIT
Docs
Chat
Blue 是 DeepSeek Harness
(dsh)的交互式终端界面。它是叠加在 dsh-base 上的树外 Cordis
bundle,针对 Harness 0.1.2-alpha.3 构建。Blue 0.2.0-alpha.1
刻意与 dsh Web 使用同一种插件模型:插件是普通 Cordis sibling,直接消费
dsh 原生服务。
Blue 可以直接在终端显示 Markdown 表格、assistant 消息中的闭合 Mermaid fence,
以及 renderer-neutral 的 line、point、bar、sparkline 与 heatmap 节点;超宽或不支持
的内容会安全回退为源码或文本。
插件模型
插件通过 inject 声明服务,然后直接从 Cordis context 使用:
- ctx.commands、ctx.sessionProjections、ctx.tools 以及其他有文档的
dsh 服务直接复用,不经过 Blue 适配。
- ctx.bluePanes、ctx.blueStatus、ctx.blueOverlays 与
ctx.blueEditorExtensions 是仅有的 Blue 专属 UI 贡献服务。
- Agent-scoped 原生服务需要当前对象时,通过
ctx.blueCurrentAgent.current() 获取这个 Blue frontend 当前选择的精确
Agent。
- 每次注册都属于调用方的 Cordis Fiber;插件卸载会移除命令和 UI 贡献。
Blue 不再有专用插件 manifest、能力协商、适配 facade、私有插件域或独立的
插件作者 CLI。Blue 官方功能与外部插件注册到完全相同的服务。
插件始终只返回普通的 renderer-neutral 节点。Blue 会自动窗口化大型 list
节点,并延迟隐藏的响应式分支;插件无需管理 viewport range、overscan、renderer
cache 或 scroll controller。数据库与网络取数仍由插件负责。
import type { Context } from '@deepseek-ai/cordis'
import type {} from '@deepseek-ai/dsh-commands'
import type {} from '@dsh-blue/blue-api'
import { ui } from '@dsh-blue/blue-ui'
export const name = '@acme/build-health'
export const inject = ['commands', 'bluePanes']
export function apply(ctx: Context): void {
ctx.commands.register({
name: 'health',
description: 'Show build health',
handler: () => ({ kind: 'success', text: 'healthy' }),
})
ctx.bluePanes.register({
id: 'acme.build-health',
placement: 'right',
narrow: 'bottom',
render: () => ui.text('healthy'),
})
}
用法
前置条件为 Node ^22.19 || >=24 与 pnpm 11。
npm i -g @deepseek-ai/dsh
dsh plugin --profile blue add @dsh-blue/blue@alpha
dsh --profile blue
也可以安装包含已测试 dsh runtime 的独立启动器:
npm i -g @dsh-blue/blue-cli@alpha
blue
首次运行前设置 DEEPSEEK_API_KEY。/help 会列出当前有效的命令和键位。
架构
flowchart TB
ROOT["一个 dsh 进程 · 一张 Cordis service graph"]
DSH["dsh 原生服务commands · sessionProjections · tools · agents"]
PLUGIN["普通 Cordis 插件Blue 官方行与外部 sibling"]
AGENT["blueCurrentAgent当前选择的精确 Agent"]
UI["Blue 直接 UI 服务bluePanes · blueStatusblueOverlays · blueEditorExtensions"]
CORE["blue-core renderer唯一 pi-tui 与原始终端 owner"]
TERM["终端"]
ROOT --> DSH
ROOT --> PLUGIN
DSH --> PLUGIN
AGENT --> PLUGIN
PLUGIN --> UI
UI --> CORE
CORE --> TERM
只有 packages/core 可以导入 pi-tui 或处理原始终端行为。API/UI 包定义
renderer-neutral 节点和直接 registry;app 选择当前 Agent 并协调启动;
transcript 与 interaction 消费 dsh 原生服务并发布 UI 贡献。
进一步阅读:架构、服务 seam、
开发手册。
社区
欢迎加入 Blue 官方飞书群——反馈、排障、功能讨论与版本动态的第一线。入群链接 7 天过期,请从置顶的群组 issue 最新评论获取当前链接;bug 仍请通过 issue 提交追踪。
许可证
MIT。扫码进群