键盘优先编码助手 agi-fans/oh-my-dsh

oh-my-dsh

探索未至之境

omdsh 是 DeepSeek Harness 的终端客户端：一个专注、键盘优先的 DeepSeek 编程智能体，构建于其插件架构之上，并受到 oh-my-pi 出色交互体验以及最初的 Pi Agent Harness 的启发。

官方文档 · English · 简体中文

omdsh 终端演示 — 一轮真实的 DeepSeek 账户回合

真实的 Kaku 录屏：一轮 DeepSeek 账户回合——回复落地，运行折叠成 Worked for 2s · Ctrl+O to expand，页脚给出这一回合的上下文、缓存与延迟。点击可看全分辨率录像。

快速开始

运行环境需要 Node.js 22.19 或更高的 22.x 版本，或者 Node.js 24 及更高版本；进行真实模型对话时还需要 DeepSeek 账户或 API Key。

npm install --global @agi-fans/oh-my-dsh
omdsh

进入 omdsh 后运行一次 /login，用 DeepSeek 账户登录或保存 API Key，即可开始对话。如果不想全局安装，可以运行 npx @agi-fans/oh-my-dsh 临时体验。

功能亮点

- DeepSeek Harness 的终端客户端： 原生滚动回看、固定 composer、按显示单元格排版的 TUI，每个流程都有键盘路径；构建于已发布插件运行时之上，而不是分叉。
- 持久化对话： 在 /resume 中搜索、置顶、重命名和恢复会话，并支持回退、重试、压缩，以及将完整对话导出为 Markdown 或独立 HTML。
- DeepSeek 原生鉴权： 在 /login 中通过浏览器登录或保存 API Key；与 DSH 共享的 DeepSeek 账户 grant 会被复用，/logout 可以登出，网页搜索/抓取使用同一份凭据。
- 三项真实会话控制： 选择 Harness Agent preset（Standard、PTC、Minimal 或 Cordis）、Workflow（Default 或 Plan）和 Access（Read only、Workspace write 或 Full access）。每个 Agent preset 自己决定工具暴露方式；PTC 会自动使用生成的 TypeScript SDK。
- 丰富的终端输入： 使用 @ 提及项目文件和其他会话，粘贴剪贴板图片，复用持久输入历史，通过外部编辑器处理多行 Prompt，并取回排队中的后续消息。
- 清晰的回合展示： 运行时跟随思考、回复和工具预览，完成后将过程折叠为耗时摘要，保留完整的最终答复；Ctrl+O 恢复过程视图。两种视图均可滚动，当前请求固定在顶部，按 End 即可回到最新消息。
- 可检查的工作过程： 按 Alt+O 查看当前回合的完整工具输入和结果，用 /trajectory 检查事件详情，查看每个回合改动的文件，并让模型搜索同一工作区的历史会话。Composer 为空时按 ↓ 在名册里选中子智能体，按 Enter 打开它的转录，可续写任务在那里跟进。
- 实时运行上下文： 无需离开 Composer，即可查看 Agent、Workflow、Access、模型、推理强度、工作区、Git 状态、上下文压力、Token、TTFT、吞吐率、缓存、耗时、轮次和步骤；使用 /context 可以在 transcript 中直接查看并保留基于 Projection 的构成明细。
- 为响应速度而设计： 复用已完成的 Transcript 布局、合并滚动更新、只输出发生变化的终端行，并正确处理 CJK 文本和 emoji 的显示宽度。

文档

完整文档发布在官方站点；apps/site/content/ 下的 Markdown 是它的内容源。

从这里开始

- 教程 — 完成第一个任务、提供精确的项目上下文、引导排队工作、恢复长会话、调整工作环境，并编写可安装插件。
- 命令 — 每个斜杠命令的参数与别名。
- 键盘与快捷键 — 编辑、转录、浮层按键与 keybindings.json。

参考

- 会话与历史 — 持久日志、Session Library 与本地数据文件。
- 子智能体与委派 — 三种 transport、打开子会话转录的名册、引导与后台任务。
- 可观测性 — /trajectory、/context、/diff、/tools 与 /mcp。
- 设置 — 外观、动效、通知与可配置的状态栏。
- 权限与 Access — Access preset、沙箱与审批。
- 命令行 — flags、子命令与环境变量。
- 工具 — 模型可用的工具，按能力分组。
- 故障排查 — 退出、颜色、滚动回看与启动失败。

扩展与集成

- Skills 与 MCP — 可复用指令与外部工具。
- 语言服务器 — 配置只读代码智能。
- 用户插件 — 用 omdsh plugin 把 DSH bundle 装进 omdsh Profile。
- 插件内部机制 — ctx.tui 表面与贡献层。

内部实现

- 架构 — 插件边界与运行时数据流。
- 性能 — Benchmark、测试方法与渲染优化。

使用引导表单报告问题或提出功能建议，请提供版本、运行环境、复现步骤与脱敏上下文。

为什么做 oh-my-dsh

DeepSeek Harness 提供了能力完整的 Agent Runtime，也带来了一条很重要的架构原则：一切皆插件。oh-my-dsh 将这套运行时带入安静、键盘驱动的终端体验，同时不创造第二套 Agent Core，也不使用平行抽象将 Harness 隐藏起来。

TUI 始终只是表现层与交互层。会话、工具、权限、模型、Skills、MCP Server、命令和遥测数据来自 Harness Service 与插件；omdsh 负责将它们组合为终端应用，并补充舒适使用这些能力所需的界面行为。/trajectory 会打开键盘驱动的事件账本，提供 Turn/Step 分组、实时跟随、搜索、折叠、耗时、Token 用量以及工具 Payload、Result 和 Schema 检查。/context 与状态栏读取同一套客户端可见 Harness Projection，并明确区分由提供方数据锚定的占用量和启发式 Prompt 构成估算。

项目遵循四项原则：

- 原生融入 Harness： 使用正式发布的 DeepSeek Harness 软件包，并将其作为 Agent 行为、状态与生命周期的事实来源。
- 建立真实插件边界： 为拥有独立生命周期和贡献点的能力建立插件，而不是把每个源文件都变成插件。
- 终端只有一个所有者： 将 raw input、光标状态、viewport 管理和原子化渲染保留在本地 TUI Provider 中。
- 渐进式呈现： 默认界面保持简洁，同时让工具、遥测、设置及会话详情可以按需发现。

refs/ 下的参考项目始终是只读研究材料。运行时代码只依赖已发布软件包和 oh-my-dsh 自身的 workspace 软件包。

架构

DeepSeek Harness 插件与服务 │ ▼ @agi-fans/dsh-tui — 终端能力边界 │ ▼ @agi-fans/oh-my-dsh — 启动与插件组合

TUI 软件包拆分为 Service Definition、本地终端 Provider、会话与交互适配器、工具展示适配桥、命令贡献插件和交互式 Runner。这让终端所有权与 Harness 领域状态相互隔离，也只在能力拥有独立生命周期或所有者时公开插件边界。当前边界与数据流请参阅架构概览。

性能

性能是 TUI 架构本身的一部分：持久化会话按线性时间回放，Harness Projection 避免重复扫描历史，已完成的 Transcript 区块会保留格式化布局，终端写入器则只输出发生变化的行。2026 年 8 月的 Apple M5 Pro 测量记录中，恢复 10,000 轮对话的中位耗时为 2.62 ms，恢复 10,000 次工具调用为 22.71 ms，在 5,000 轮对话界面上渲染缓存帧的平均耗时为每帧 0.35 ms。这些是历史测量值，不代表最新版本的基准结果。

完整方法与限制请参阅可复现的 TUI 性能报告，也可以在本地运行 pnpm benchmark:tui。

配置

运行 /login 可以配置一家提供方。DeepSeek 会打开官方 Key 管理页、验证 Key，并把它存入共享的 Harness 凭据库中的 DEEPSEEK_API_KEY；由环境变量提供、不可覆盖的值保持不变。可以在 /login 中登录 DeepSeek 账户：TUI 通过 loopback 回调接收浏览器授权，也会复用 DSH Web/Desktop 已建立的授权。之后 deepseek-account 路由会与 API Key 路由一同出现在 /model；登出可以在 /logout 或同一个账户入口中完成。当已挂载的提供方注册了 Harness 授权流程时，/login 会列出该流程及其方法，终端只渲染流程要求的通知和提问。同一条命令也可以激活 catalog API Key 提供方，或添加自定义提供方（自己的 id、Base URL、协议和模型 id）。/logout 只删除存储在文件中的凭据；环境变量可用时会回退到环境变量。

模型设置与其他插件配置都持久化到当前 Profile 的 Cordis 补丁 $OMDSH_HOME/profiles/omdsh/cordis.patch.yml 中；更早版本留下的 settings.yaml 会在启动时导入一次，并重命名为 settings.yaml.imported。使用 /model favorite 和 /model unfavorite 维护本地快速切换列表，再用 Ctrl+P/Alt+P 前后切换模型，使用 Ctrl+T 切换推理强度。Skills 与 MCP 的配置方式请参阅 Skills 与 MCP。

升级后，omdsh 可以在启动时只展示一次版本说明。使用 /changelog 查看近期条目，或使用 /changelog full 查看随包发布的完整历史。程序每天至多执行一次带缓存的 npm 版本检查，只提示新版本而不会自动安装；这两项行为都可以在 /settings 中调整。长任务完成和等待人工输入的终端通知也在这里配置，并且默认关闭。每一项设置、可选值与默认值见设置。

以下命令不会启动 TUI 或访问网络，可直接生成 Shell 补全脚本：

omdsh completions bash
omdsh completions zsh
omdsh completions fish

开发

pnpm install
pnpm omdsh "list files" # 从源码运行
pnpm typecheck # 检查 TypeScript
pnpm test # 单元测试与管道模式测试
pnpm build # 构建全部 workspace 软件包
pnpm smoke # 交互式 PTY 冒烟测试
pnpm smoke:happy # 使用模拟 LLM 验证正常流程

refs/deepseek-harness、refs/oh-my-pi 与 refs/pi 中的代码是只读参考项目。开发 omdsh 时不要将它们用作运行时依赖，也不要修改其内容。

变更日志

面向用户的变更与版本发布记录统一维护在 CHANGELOG.md 中。

致谢

oh-my-dsh 的诞生离不开这些项目：

- DeepSeek Harness 提供了运行时基础、插件架构，以及 Agent 能力应当通过组合而非内嵌于单一应用中的设计信念。
- Pi 是最初的开放式 Agent Harness，其终端交互、差分渲染和紧凑的 Coding Agent 工艺，至今仍是这个社区继续建设的基准。
- oh-my-pi 延续了这条脉络，并展示了细致的终端交互、紧凑的信息设计和精心设计的键盘工作流，如何让 Agent 既快速又易于使用。

感谢这些项目及其所有贡献者。omdsh 是一个独立的社区项目：它构建于 DeepSeek Harness 之上，并从 Pi 与 OMP 学习，但不是其中任何一个项目的官方发行版本。

许可证

oh-my-dsh 使用 MIT License 发布。