在线体验 · 最快上手 · 桌面端接入 · 能力参考 · 更新日志 · 架构文档 · 参与共建
Dimina（星河小程序）是滴滴开源的跨端小程序框架。它将 WXML、WXSS 与 JavaScript / TypeScript 源码编译为统一资源包，再交由 Android、iOS、Harmony、Web 和桌面容器加载。已有小程序可以接入移动 App，也可以在桌面客户端中以独立窗口打开，继续使用熟悉的小程序语法。
下图是仓库内同一套“官方组件展示”示例在 Android、iOS 和 Harmony 上的实际运行效果。想直接上手，也可以打开 Web 端的在线演示。
| Android | iOS | Harmony |
|---|---|---|
Dimina 不止提供 Web 预览。它包含小程序编译器、逻辑与视图运行时、标准组件、原生能力桥接，以及移动、Web 和桌面容器。已有小程序可以整体嵌入移动 App，也能由 Electron、Tauri、Qt、.NET 客户端打开独立小程序窗口。
- 资源包可离线：小程序包由宿主提供并保存在本地，减少运行时网络依赖。
- 逻辑与视图分开运行：业务逻辑运行在独立 JS 引擎或 Worker 中，视图交给 WebView / Browser 渲染。
- 原生能力有统一入口：标准 API 与扩展 Bridge 负责连接宿主能力，平台逻辑不必散落在业务页面里。
- 页面语义由运行时承接：运行时处理页面预热、路由、生命周期、组件和跨线程消息。
DMCC 将小程序源码转换为逻辑、视图、样式和配置资源。进入容器后，消息通道会连接逻辑层、视图层与原生能力，让同一套小程序语义在不同平台上保持一致。
| 平台 | 逻辑引擎 | 视图容器 |
|---|---|---|
| Android | QuickJS | Android WebView |
| iOS | JavaScriptCore | WKWebView |
| Harmony | QuickJS | Harmony WebView |
| Web | Web Worker | Browser |
| 桌面（macOS / Windows / Linux） | Web Worker | 系统 WebView（WKWebView / WebView2 / WebKitGTK） |
想先看看 Dimina 的运行效果，可以直接打开在线演示。要在本地跑起仓库自带的 Web 示例，请准备 Node.js 22.22.3+ 与 pnpm 12.2.0+：
git clone https://github.com/didi/dimina.git
cd dimina/fe
pnpm install
pnpm compile
pnpm dev其中，pnpm compile 负责构建 examples/miniprogram/ 下的小程序，pnpm dev 会启动 Web 容器与代理服务。更多构建、打包和调试命令见前端工作区说明。
准备把资源包接入原生应用时，可以从对应平台的接入文档开始：
桌面端面向 macOS、Windows 和 Linux，复用同一份 Dimina 编译产物。可以单独运行桌面示例，也可以通过独立窗口 SDK接入已有 Electron、Tauri、Qt、.NET 客户端。
先按 SDK 文档构建运行时与调用库，再由宿主管理窗口。下面以 Electron 主进程 / Node.js 为例，三个路径参数均使用绝对路径：
import { Dimina } from '@dimina/desktop-sdk'
const dimina = await Dimina.start({ runtimePath, packagesDir, dataDir })
await dimina.openApp({ appId: 'your-app-id' })
// 客户端退出时调用 await dimina.dispose() 回收运行时桌面端内置 HTTP 请求与上传下载、TCP/UDP、存储、文件选择、剪贴板、扫码和 BLE，沿用移动 SDK 的 wx API 入口。系统依赖与具体能力范围见桌面原生 API 说明。当前提供独立窗口模式，暂不支持嵌入宿主窗口或面板。
Dimina 正在持续对齐小程序标准与微信小程序的主要能力，目前尚未覆盖全部 API、组件和特性。正式接入前，请先确认当前能力范围与平台差异。
| 想了解什么 | 文档入口 |
|---|---|
| 已支持的组件、API 与平台差异 | 能力参考指南 |
| 编译流程、双线程模型与整体架构 | 技术文档 |
| DMCC 安装、命令与编译产物 | 编译器使用说明 |
| Electron / Tauri / Qt / .NET 的独立小程序窗口 | 桌面 SDK 接入 |
| 小程序包更新与动态下发职责 | 更新机制说明 |
| 共享资源如何流向各端示例工程 | 共享资源说明 |
Dimina 的架构参考了小程序标准化白皮书设计，也在真实的跨端差异里一点点补齐能力。月溅星河，长路慢慢。若你也在意兼容语义、跨端运行时、组件体验与原生能力，欢迎留下一个问题，或补上一行代码，和我们一起把这条路走稳、走远。
来微信交流群聊聊
Dimina 使用 Apache License 2.0 开源。