Chuyển đến nội dung chính
dsh marketplace

dsh-orca

Đã xác minh

dsh-orca · v0.2.0 · MIT

Orca — a self-owned in-process TUI front door for DeepSeek Harness, mounted as a Cordis plugin. Zero kernel changes.

Cài đặt

dsh plugin add dsh-orca

Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.

Mã nguồn

Thẻ

Tác giả

Readme

Orca 🐋

Orca 是一个运行在 DeepSeek Harness 内核内的终端前端（TUI），以 Cordis 插件形式挂载。零内核改动，卸载无残留。

orca / dsh-orca   # 均等价于 dsh --profile orca

特性

  • 流式渲染：真实增量上屏，历史自动沉淀进终端 scrollback
  • Markdown 渲染 + 轻量代码高亮
  • 工具调用卡片：运行状态、结果、diff 高亮
  • 审批面板：逐次确认 / yolo 自动放行
  • /model 三段式切换 provider / model / 思考强度，并持久化默认
  • /preset 切换 Agent 预设
  • 图片输入：/img、Ctrl+V / Alt+V 粘贴图片，输入框内联 [image #N]，支持删除
  • @ 文件补全
  • 待办列表：/todo
  • Agent 提问：支持官方 ctx.userQuestions，picker 单选/多选/自定义回答
  • Plan 模式：/plan 只规划不执行
  • 自更新：orca update / /update
  • 页脚 Nerd Font 分支图标：/nerdfont
  • 全屏备用屏模式、滚动缓冲、会话恢复、回退、压缩等

环境要求

  • Node.js ^22.19 || >=24
  • DeepSeek Harness CLI（@deepseek-ai/dsh）
  • pnpm（开发时）

安装

1. 安装 dsh

npm install -g @deepseek-ai/dsh

2. 安装 Orca

npm install -g dsh-orca

3. 挂载到 profile

dsh plugin --profile orca add dsh-orca

如果希望 agent 能主动提问，还需要挂载官方提问工具：

dsh plugin --profile orca add @deepseek-ai/dsh-tool-ask-user

使用

orca
# 或
dsh-orca

CLI 命令

命令 说明
orca / dsh-orca 启动 Orca TUI
orca --help / -h 显示帮助
orca --version / -v 显示版本号
orca update 检查并更新 dsh-orca
orca --profile <name> 指定 dsh profile（默认 orca）
orca --fullscreen 以全屏备用屏模式启动
orca --resume <id> 恢复指定会话
orca --debug 开启诊断日志
orca --nerd-font 开启 Nerd Font 分支图标

TUI 命令

在输入框输入 / 可打开命令菜单，常用命令：

命令 说明
/help 显示帮助
/model 切换 provider / model / 思考强度
/preset 切换 Agent 预设
/new 开新会话
/resume 浏览并恢复历史会话
/title 查看/设置会话标题
/compact [hint] 压缩上下文
/usage 查看 token 用量
`/yolo [on off]`
/permission 查看审批策略
/img <路径> 附加本地图片
/todo 查看/编辑待办（list/add/done/undo/del/clear）
/ask <问题> 向 agent 提问，本轮只回答不执行工具
`/plan [on off]`
`/nerdfont [on off]`
/update 检查并更新 dsh-orca

快捷键

快捷键 说明
Enter 发送
Ctrl+V / Alt+V 粘贴剪贴板图片
@路径 文件补全
↑ / ↓ 历史召回 / 返回
Shift+Tab 切换 yolo
Ctrl+O 展开/折叠思考过程
Esc 打断 / 取消
Ctrl+C 打断 / 双击退出
Ctrl+A/E/K/U/W readline 编辑

环境变量

变量 说明
ORCA_PROFILE dsh profile 名，默认 orca
ORCA_RESUME_SESSION 启动时恢复指定会话
ORCA_PROVIDER / ORCA_MODEL 覆盖模型路由
ORCA_FULLSCREEN 1 时使用全屏备用屏模式
ORCA_NERD_FONT 1 时启用 Nerd Font 分支图标
ORCA_DEBUG 1 时输出诊断日志到 stderr
ORCA_LOG 记录 stdout 字节流到指定文件
ORCA_LAST_SESSION_FILE 覆盖 last-session 标记文件路径
ORCA_SETTINGS_FILE 覆盖本地设置文件路径

开发

pnpm install
pnpm build        # tsc → lib/
pnpm test         # 生命周期 + 渲染回归测试
pnpm dev          # 假内核冒烟测试

本地挂载：

dsh plugin --profile orca add <本仓库路径>
dsh --profile orca

项目结构

src/
  app.ts              # 装配：TTY、agent、channel、renderer、keyboard
  adapter/channel.ts  # session/event → 转录行投影
  kernel/types.ts     # 内核接缝类型镜像
  tui/                # 渲染、输入、主题、picker、markdown 等
  update.ts           # 自更新逻辑
bin/
  orca.js             # CLI 启动器
cordis.patch.yml      # Cordis 插件挂载配置

License

MIT