跳到主内容

hello 使用指南

omdsh 官方提供的最小插件模板,注册一条 /hello 斜杠命令用于验证插件挂载和命令行注入流程。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

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

快速上手

oh-my-dsh

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:agi-fans/oh-my-dsh#path:examples/hello

复制以上命令在 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)

常见问题

这个插件能做什么?

唯一的可见行为是注册一条 /hello 斜杠命令,调用后输出一行确认通知。它不是生产力插件,而是一份可直接拷贝改写的最小 bundle 模板。

安装后需要重启吗?

需要。bundle 是在 Profile 启动时挂载的,README 明确说明运行 /hello 前必须重启 omdsh。

它会出现在 /help 里吗?

会。命令通过宿主 dsh-commands 注册,重启后会出现在 /help 列表中。

依赖装在哪里?

依赖 @deepseek-ai/cordis 和 @deepseek-ai/dsh-commands 都是 peerDependencies,由宿主 Profile 的 node_modules 提供,本 bundle 不打包。

怎么卸载?

运行 omdsh plugin remove @agi-fans/omdsh-plugin-hello,重启后即生效。

能用作自己插件的起点吗?

可以。README 建议直接复制 examples/hello 目录来开始新 bundle,再按 docs/tutorials/write-a-plugin 文档继续开发。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.8+
  • Node: 未声明
  • Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源:通用规则