DSH Marketplace
EN

mirage

strukto-ai/mirage#dsh

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Slack、Gmail、Notion、Postgres)而非宿主磁盘,支持按挂载点设置读/写/执行模式、按命令选择沙箱(进程内 monty、pyodide、quickjs;远程 docker、e2b、daytona),并可在虚拟终端中安装 CLI(git、gh、slack、linear、ntn、gws,或自行注册的程序树)作为命令头词。

3,501259TypeScriptApache-2.0源码

安装

把 mirage 装进 DeepSeek Harness

这个插件放在一个大仓库的子目录里,`dsh plugin add` 够不到它——它转发给 pnpm,而 pnpm 会把 `#` 后面的内容当成分支或 commit。请先 clone 仓库,再用 DSH 插件面板的 repository 源添加,或者请作者发一个 npm 包。

安装前须知

装 mirage 之前,先看这几条

  • 源码在这里: strukto-ai/mirage——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
  • 开源协议:Apache-2.0。
  • 自动识别到:终端执行。授权之前请先读一遍源码。
  • 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。

AI 锐评

是什么 — mirage 虚拟工作空间让 AI 代理通过 bash 工具操作挂载的资源。

谁该装 — 在使用 bash 工具的 AI 代理开发中,需要同时访问多种后端资源(如 S3、Slack)时适合。 如果仅在本地文件系统上运行且不涉及远程服务,则不适用。

注意 — 没发现明显的坑。存在执行 shell 命令的静态检查提示。沙箱未实测。

锐评 — 不值得装,因为未实测沙箱安全性。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。

mirage 是做什么的

Mounted resource blocks flow through permission gates into terminal pipelines and local or remote sandboxes.

mirage 是一个 DeepSeek Harness 插件,用虚拟工作区替换原有的 filesystem 和 bash provider。它把 RAM、S3、Redis、Slack、Gmail、Notion、Postgres 等资源挂载为路径,文件工具和 shell 命令因此直接作用于这些挂载点,而不是宿主机磁盘。每个挂载点可以设置读、写、执行模式;命令则可路由到进程内的 montypyodidequickjs,或远程的 dockere2bdaytona

工作区通过 Workspace({...}) 配置,使用 ws.execute(...) 执行 grepcp、管道和重定向,也能用 ws.snapshot(...) 保存 tarball。虚拟终端还支持把 gitghslacklinearntngws 或自行注册的程序作为命令头词;CLI 配置可携带 Slack token 等访问凭据。

它适合需要跨云服务、消息系统、数据库和文件统一操作界面的 agent。由于 terminal surface 会触达所有已挂载资源,并可能执行脚本或命令,安装前应按这些资源的权限评估风险。若只需要宿主机已有的 filesystem 和 bash,或运行环境不是 macOS/Linux、无法提供 FUSE 所需支持,mirage 不一定合适。

mirage 的文档

配置

工作区使用 Workspace({...}) 创建,把路径映射到资源。例如 "/data": RAMResource()"/s3": S3Resource(S3Config(bucket="my-bucket"))。挂载模式包括 MountMode.EXECMountMode.WRITEruntimes=[...] 可选择运行时;MontyRuntime(captures=["python", "python3"]) 会捕获这些命令名。CLI 使用 ws.register_cli(name, implementation, config) 注册,配置示例包含 token

命令

ws.execute("...") 执行命令,README 示例包含 cpgrepwc、管道和输出重定向。也可执行挂载资源中的 python3 脚本。CLI 提供 mirage workspace createmirage executemirage provisionmirage workspace snapshotmirage workspace load,示例使用 --workspace_id--command--id,快照文件为 .tar。SDK 对应方法是 ws.snapshot("demo.tar")

资源与运行时

README 列出 RAM、Disk、Redis、S3 兼容服务、Gmail、Google Drive、GitHub、Linear、Notion、Trello、Slack、Discord、email、MongoDB、Postgres、LanceDB、Qdrant 和 SSH 等资源。运行时包括进程内的 montypyodidequickjs,以及远程的 dockere2bdaytona

环境要求

Python >=3.11 用于 mirage-ai,Node.js >=20 用于 TypeScript SDK;平台为 macOS 或 Linux。FUSE 挂载需要平台支持。相关 TypeScript 包包括 @struktoai/mirage-node@struktoai/mirage-browser@struktoai/mirage-agents

根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README

同一分类

mirage 的同类插件

oh-dsh

hust-open-atom-club

239

社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。

我们跑过,装得上

GitHub 源码TypeScript今天

AI 锐评

oh-dsh

是什么 — 一套 DSH runtime 提供 Desktop、Web 与 TUI 三种界面。

谁该装 — 开发者在本地开发时使用 DeepSeek Harness 处理 Workspace 代码需要 Git Review 和插件市场能力的人适合安装。 不想使用纯云端模型的用户无需此分发,因为无需本地工作台。

注意 — 从源码安装需要 Node.js 和构建工具。 沙箱测试通过,在全新 profile 中被 harness 注册。 没发现明显的坑。

锐评 — 我会装它,因为它统一了三端界面与插件市场,但前提是需要从源码构建环境。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
详情

forkprobe

Jayden-X-L

67

同一任务并行试跑多个技能,对比结果选出最优。

我们跑过,装得上

GitHub 源码Python4 天前

AI 锐评

forkprobe

是什么 — forkprobe 是一个 AI Skill 选型工具。它把同一任务交给多个 skills 并行试跑,生成本地 HTML report,并让用户选择 winner。

谁该装 — 当你不确定当前任务该用哪个 skill,想先看真实输出再决定时适合安装 forkprobe。不适合简单确定性任务的人不用装,因为答案或工具路径已经很明确,直接执行会更快。

注意 — 从 GitHub 源码安装 forkprobe 需要先手动放行构建脚本。沙箱实测在全新 profile 里安装并被 harness 注册进 profile,未发现明显的坑。

锐评 — 我会安装它,因为它生成 winner 选择后的 continuation handoff 并支持匿名分享选择结果。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码

插件生态基建:浏览器面板管理官方 repository 插件(0 patch)+ make-dsh-plugin 插件开发引导技能。

我们跑过,装得上

GitHub 源码TypeScript今天

AI 锐评

plugin-registry

是什么 — 提供管理 DeepSeek Harness profile 插件安装态的薄浏览器控制台,并给出 make-dsh-plugin skill 指导官方插件开发。

谁该装 — 当你需要开发第三方 DeepSeek Harness 插件或维护 profile 的插件列表时,这个控制台能展示安装态并提供开发规范。 如果你仅需使用官方现成插件,不涉及自定义开发或列表管理,这时无需安装它。

注意 — 实测在全新 profile 中成功安装并被 Harness 注册进 profile。没发现明显的坑,但安装后需先查看插件类型对比和开发指南中的踩坑清单。

锐评 — 我装它,因为它填补了官方插件开发规范的空白,但如果你只运行官方 bundle 插件而非自己写新插件,它的价值有限。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
源码
46

让 dsh 运行时跑在 Multica 上。

我们跑过,装得上

GitHub 源码TypeScript3 天前

AI 锐评

dsh-multica-runtime

是什么 — Multica 与 DeepSeek Harness 之间的私有运行时桥接。

谁该装 — 在 Multica 环境中需要集成 DSH 运行时的开发者适合此插件。 对于仅使用标准 DSH 环境的开发者而言,此桥接无用武之地。

注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 会执行 shell 命令。

锐评 — 我会装它,因为它无需修改 DeepSeek Harness。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码
24

插件健康检查:扫描清单协议/patch 格式/构建陷阱,零依赖只读。

我们跑过,装得上

GitHub 源码TypeScript今天

AI 锐评

dsh-plugin-check

是什么 — 这是一个零依赖只读的 DeepSeek Harness 插件健康检查工具,用于扫描插件仓库并输出清单协议、patch 格式和构建陷阱的合规报告。

谁该装 — 当你在组织内维护多个 DeepSeek Harness 插件仓库,需要定期诊断清单协议、patch 格式和构建陷阱,此工具适合你使用。 如果你仅运行单个插件或插件仓库已通过手动审核,不需要此工具。

注意 — 沙箱实测通过,在全新 profile 里安装后被 harness 注册。静态检查提示会执行 shell 命令,但实际未执行。没发现其他明显问题。

锐评 — 我将装这个插件,因为它能提供自动化合规检查,减少组织内插件集成时的踩坑风险,但前提是按 profile bundle 方式安装。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
1源码

dsh-user-experience

DietCokewithSugar

19

帮你发现项目中可能存在的用户体验问题:自动走查 React/TypeScript 源码,定位问题并给出具体优化建议。

我们跑过,装得上

npm 包TypeScript今天

AI 锐评

dsh-user-experience

是什么 — 扫描 React 、 TypeScript 、 JavaScript 和 Vue 3 代码,模拟用户角色发现 UX 问题并提供具体建议。

谁该装 — 在使用 DeepSeek Harness 开发 React 应用时进行代码审查并需要 UX 模拟能力,此插件适合。 如果项目使用 Svelte 或 Vue 2 框架,则无需安装此插件,因为它不支持这些语言的代码分析。

注意 — 沙箱测试通过,在全新 profile 中安装并注册,未发现明显的坑。支持渲染页面时可获取浏览器证据,但没有浏览器环境时仅依赖静态证据。

锐评 — 我会装它,因为它能在文件编辑后自动运行 walkthrough 并提供可验证的 UX 优化建议。

grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。去看源码
源码