本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

oh-my-dsh

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @agi-fans/oh-my-dsh

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 持久化对话： 支持恢复会话、回退到指定用户轮次、重试、压缩，并将完整对话导出为 Markdown。
• 四项真实会话控制： 选择 Harness Agent preset（Standard、PTC、Minimal 或 Cordis）、Workflow（Default 或 Plan）、工具展示（Native、Code 或 Both）和 Access（Read only、Workspace write 或 Full access）。
• 丰富的终端输入： 使用 @ 提及项目文件和其他会话，粘贴剪贴板图片，复用持久输入历史，通过外部编辑器处理多行 Prompt，并取回排队中的后续消息。
• 清晰的工具活动： 跟踪流式工具调用和子智能体的实时进展，在空 composer 中按 ↓ 再按 Enter（或直接按 Alt+A）进入键盘驱动的 Agent Hub 并选择子智能体，从其对话里直接跟进可续写任务，查看独立的 Input 和 Output 分区，展开长输出，并让工具插件继续拥有领域展示语义。
• 实时运行上下文： 无需离开 Composer，即可查看 Agent、Workflow、Tools、Access、模型、推理强度、工作区、Git 状态、上下文压力、Token、TTFT、吞吐率、缓存、耗时、轮次和步骤。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

omdsh 和官方 DSH CLI 有什么区别？

omdsh 是基于同一套已发布的 DeepSeek Harness 运行时构建的社区 TUI 编辑，专注于终端交互；能力来源仍是 Harness 服务（会话、工具、权限、模型），omdsh 只负责组合和呈现。

如何配置 DeepSeek API Key？

启动 omdsh 后运行 /login 命令，根据提示输入并保存 Key；也可以设置环境变量 DEEPSEEK_API_KEY，或写入 $DSH_HOME/settings.yaml。

会话保存在哪里，如何恢复？

会话文件落在 $OMDSH_HOME/sessions（默认 ~/.dsh/sessions）；启动时加 --resume 即可回到该会话，对话历史可继续追加、压缩或导出。

插件如何安装与卸载？

使用 omdsh plugin add <package> 与 omdsh plugin remove <package> 即可，这两个命令底层调用 pnpm；其它 pnpm 动词也可经 omdsh plugin <args> 转发到 Profile 目录。

是否需要 pnpm 才能用插件功能？

需要。omdsh 的 Profile 目录是一个 pnpm 项目，添加/移除插件必须通过 pnpm；如果 PATH 中找不到 pnpm 会直接报错并提示安装。

是否支持 Windows？

支持。在 Windows 上 omdsh plugin 会通过 shell 调用 pnpm；终端输入、TUI 渲染走 Node + TTY，跨平台表现一致，但必须在真实终端中运行。

是否可以不接 DeepSeek 模型？

可以。配置文件里同时挂载了 pi-ai 多 provider 通道与官方 DeepSeek 通道；/login 也支持切换到 OpenAI、Anthropic 或自定义 provider。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8（运行时依赖）
• Node: ^22.19 || >=24

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则