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

快速上手

oh-dsh

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:hust-open-atom-club/oh-dsh

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

— 源: plugins.install

关键要点

• **macOS：**打开 DMG，将 Oh-DSH Desktop 拖入 Applications。
• **Windows：**运行安装包，或解压便携版后启动。
• **Linux：**直接运行 AppImage，或使用 apt 安装 deb。
• 安装、操作与排错
• 架构设计与插件边界

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装 oh-dsh 后还需要单独安装 Node 或 DSH runtime 吗？

不需要。每个发行版都自带固定版本的 Node 与 DSH runtime，解压即可运行，不需要预先安装运行环境或额外依赖。

Desktop、Web、TUI 三端的数据是互通的吗？

互通。三个端默认共用 ~/.ohdsh 目录存放会话、凭据、皮肤、插件缓存和插件状态；设置 OH_DSH_HOME 可以统一更换数据根。

我能把 oh-dsh Web 暴露给局域网里的其他人访问吗？

可以，但必须显式加入 --trusted-host。Web 默认只监听 127.0.0.1；改用 0.0.0.0 而不带 trusted-host 会被拒绝启动。

在 TUI 模式下能安装插件吗？能管理插件吗？

安装事务在三个端都能成功落盘，但只有声明支持 TUI 的插件会在 TUI 实际生效。管理和预览操作通过 /plugins（或 Ctrl+M）进行。

插件申请安装和 Agent 帮我在终端安装插件走的是同一个流程吗？

是的。人类和 Agent 共享同一个事务管理器，包含预览、风险审批、应用、回滚四个阶段；Agent 不能绕过审批直接改动当前 Profile。

我能把旧的 Oh-DSH-Desktop 数据迁移到新版共享目录吗？

第一次启动新版的 Desktop 或 Web 时，会自动从旧的 Oh-DSH-Desktop 应用数据目录或 ~/.oh-dsh-web/dsh 把会话、插件、皮肤偏好复制到 ~/.ohdsh；旧目录不会被改动，可回滚。

同时开两个 oh-dsh 进程会冲突吗？

不会破坏数据，但只有一个进程能写 ~/.ohdsh。其它进程会进入只读模式查看历史，期间不能写入活动会话；写锁释放后会自动恢复可写。

oh-dsh 怎么处理图片识别？

三端共用内置的 @oh-dsh/vision 插件，提供 view_image 工具，对 workspace 内图片、HTTP(S) 图片或 image data URL 做 OCR、看图和界面诊断；默认调用 Zhipu glm-4.6v-flash，可配置为本地的 Ollama/LM Studio 模型。

macOS arm64 和 Windows x64 都支持吗？

支持。发行版覆盖 macOS (arm64/x64)、Linux x64 和 Windows x64；打包脚本 dist:mac、dist:linux、dist:win、dist:web、dist:tui 对应不同形态。

哪里可以查看版本号和发行日志？

所有界面统一显示的版本号来自仓库 tag（见 src/version.ts 的最近 tag 解析）；详细的 macOS、Windows、Linux、Web 打包步骤和签名要求在 docs/usage.md。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+（pinned，上游 DSH 运行时内嵌于发行版）
• Node: >=24（自带 Node runtime，用户无需自行安装）

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则