@agentshouse/mdruntime

中文文档
0.1.0-c780569da0b1c发布于 2026/11/08MITTypeScriptES Module近 30 天下载 4.5万

MDApp的无头核心

中文使用文档
文档目录4 节
  1. 安装
  2. 条目
  3. 使用量
  4. 许可证

@agentshouse/mdruntime

MD App的无头核心:输入的Markdown文档的本地房间 查询、搜索、观察、房间草稿和队列保存以同步 通过适应器提供商.

安装

npm install @agentshouse/mdruntime

条目

条目对于
@agentshouse/mdruntime/client主持人客户端: connectMdRuntime(port)
@agentshouse/mdruntime/host为运行时服务的主机 : serveMdRuntime
@agentshouse/mdruntime共享类型
@agentshouse/mdruntime/memory测试 : createMemoryAdapter,一个模拟适应器
@agentshouse/mdruntime/tables主机数据库: Authored store's并打开了文件表, answerRuntime
@agentshouse/mdruntime/react对客户端的反应 : useObserve, (中文(简体) ), useSave· ; useExpected期望商店的读者; useLane,读取一个动作道

使用量

App代码取取客户主机的手; 在House App桥取取:

import { houseBridge } from '@agentshouse/app-bridge';

const runtime = await houseBridge().runtime;
const rooms = await runtime.rooms();
const notes = await runtime.query({ types: ['note'], select: 'all', limit: 20 });

observe('storage-loss') 报告 null,稳定代码 storage-loss 何时 未同步的房间草稿和待修改丢失,或 visit 当主机持有 以访问结束的数据库; 准备状态 persistence 答案为 memory。主机提供用户阵容.

在House中,桥的物体 页面保持为 window.houseBridge 将聊天放在 House服务于页面:安装和捆绑任何内容。 把它装入元素中 填充,其中按元素宽度列出用户的聊天内容,按 CSS 定制 作为聊天按钮,House在工作表中打开它的点:

const chat = await window.houseBridge.chat.mount(element, { conversation });
element.style.setProperty('--chat-accent', '#2a6cf0');
chat.update({ conversation: null, agent });
const button = await window.houseBridge.chat.mountButton({});
button.open({ agent });

App的代理遵循规则,包括本地查询、搜索、房间草稿、保存和 聊天,这是 apps/ 《豪斯指南》的几页 guide/open 打开.

许可证

麻省理工学院

版本与发布记录

@agentshouse/mdruntime 共发布 367 个版本,首次发布于 2026/09/09;过去 12 个月发布了 367 个版本。

版本发布日期距今
0.1.0-c780569da0b1clatest2026/11/08今天
0.1.0-cedd665dffa4c2026/11/07今天
0.1.0-ce2a9e406a5392026/11/07今天
0.1.0-cc6196f4567112026/11/07今天
0.1.0-c7019539316dd2026/11/07今天
0.1.0-c33f874b1f9322026/11/07今天

其他发布通道:alpha → 0.1.0-alpha.13,pushed → 0.1.0-c5a3855a93516。

关于 @agentshouse/mdruntime 的常见问题

@agentshouse/mdruntime 是什么?

MDApp的无头核心

如何安装 @agentshouse/mdruntime?

在项目目录运行 npm install @agentshouse/mdruntime,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agentshouse/mdruntime 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agentshouse/mdruntime 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentshouse/mdruntime 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24.22.1。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@agentshouse/mdruntime 可以商用吗?

@agentshouse/mdruntime 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agentshouse/mdruntime 的下载量有多少?

根据 npm 官方下载统计,@agentshouse/mdruntime 在 2026/10/05 – 2026/11/03 这 30 天内被下载 45,114 次,日均约 1,504 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentshouse/mdruntime 还在维护吗?

最新版本 0.1.0-c780569da0b1c 发布于 2026/11/08(今天);至今共发布 367 个版本,其中过去 12 个月发布了 367 个;首次发布于 2026/09/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。