diff --git a/README.md b/README.md index 2d5f2601..cb89c11f 100644 --- a/README.md +++ b/README.md @@ -148,7 +148,7 @@ mebular print-config --client opencode # MCP config Install the plugin from npm into DSH's web profile:
dsh plugin --profile web add @mebular/dsh-plugin@0.3.4
The App and the DSH Plugin are two equal entries to one local Mebular runtime: the plugin defaults to attach and connects to an existing App/CLI/service without starting or downloading anything. If no runtime exists, the panel explicitly offers a pinned shared-runtime install. The sidebar panel embeds the same Console through ?embed=dsh (loopback only), and the official MCP client reaches the same graph. The plugin is an independent adapter with its code isolated in packages/dsh-plugin; it is published by its own npm job, while its version follows the unified release train. For plugin development, install from packages/dsh-plugin instead.
-Listed on awesome-dsh-plugin under memory.
+Listed under memory on awesome-dsh-plugin and dshmarketplace.dev; every other directory is tracked in community listings.
DSH plugin guide → · Integration notes →

diff --git a/README_CN.md b/README_CN.md index 0364f6bc..e933eac7 100644 --- a/README_CN.md +++ b/README_CN.md @@ -148,7 +148,7 @@ mebular print-config --client opencode # MCP 配置 从 npm 把插件装入 DSH 的 web profile:
dsh plugin --profile web add @mebular/dsh-plugin@0.3.4
App 与 DSH Plugin 是同一套本机 Mebular runtime 的两个等权入口:插件默认 attach,已有 App/CLI/service 时直接连接,不会启动或下载任何东西。完全没有 runtime 时,面板会先询问,再按需安装固定版本共享 runtime。侧边栏面板通过 ?embed=dsh(仅 loopback)嵌入同一套 Console,官方 MCP client 连接同一张图。插件是独立适配器,代码隔离在 packages/dsh-plugin;它由独立 npm job 发布,版本随统一 release train;开发时仍可从 packages/dsh-plugin 本地安装。
-已收录于 awesome-dsh-plugin 的 memory 分类。
+已收录于 awesome-dsh-plugin 与 dshmarketplace.dev 的 memory 分类;其余目录见社区收录审计。
DSH 插件指南 → · 集成说明 →

diff --git a/docs/README.md b/docs/README.md index 2c319dd5..38cf66a4 100644 --- a/docs/README.md +++ b/docs/README.md @@ -23,6 +23,10 @@ main [`README.md`](../README.md); this index only describes document structure. - [Hermes](integrations/HERMES.md) · [Hermes 集成](integrations/HERMES_CN.md) - [OpenChamber / OpenCode](integrations/OPENCHAMBER.md) · [OpenChamber / OpenCode 集成](integrations/OPENCHAMBER_CN.md) +## Community + +- [Community listings and directory audit](community/LISTINGS.md) · [社区目录与收录审计](community/LISTINGS_CN.md) — where Mebular is listed, what each surface currently shows, and what is blocked on an external maintainer + ## Architecture - [ARCHITECT.md](architecture/ARCHITECT.md) — runtime layers, trust/sync model, code map diff --git a/docs/community/LISTINGS.md b/docs/community/LISTINGS.md new file mode 100644 index 00000000..5b65db7c --- /dev/null +++ b/docs/community/LISTINGS.md @@ -0,0 +1,92 @@ +# Community listings and directory audit + +Where Mebular (and its DSH plugin) is listed outside npm, GitHub Releases and the +product site, what each surface shows today, and who owns the next move. + +- **Audit date**: 2026-11-13 +- **Current release**: v0.3.4 (`@mebular/*` npm packages, incl. `@mebular/dsh-plugin`) +- **Canonical DSH entry source**: [`docs/dsh/awesome-dsh-plugin-entry.yml`](../dsh/awesome-dsh-plugin-entry.yml) +- **Scope**: community/listing surfaces only. Version numbers, manifests, the changelog, + release/publish workflows, tags and release notes are owned by the release train and are + not edited from this document. + +## Approved DSH long description + +The listing copy of record is the 🌌 version approved in +[awesome-dsh-plugin#11519](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11519): + +```yaml +description: + en: "🌌 Mebular · shared memory and task collaboration for agents. Through a DSH-native plugin, it provides complete cross-device, cross-agent memory sharing and task-graph capabilities — so physical devices are no longer the boundary of your agents. Secure, controllable, and decentralized!" + zh: '🌌 Mebular 忆云 · 智能体共享记忆与任务协作。通过 DSH 原生插件接入,提供完整的跨设备、跨 Agent 记忆共享与任务图功能,让物理设备不再是你智能体的边界,安全、可控、去中心化!' +``` + +Current upstream `main` carries that text plus one appended sentence describing the runtime +prerequisite (`attaches to an existing Mebular app or CLI runtime; when none exists, …`). +That sentence is added back by the maintainers' batch calibration commits, so it is treated as +an accepted addition, not as drift to revert. + +## Status table + +| Surface | What it shows now (2026-11-13) | Action taken | PR / link | State | +|---|---|---|---|---| +| awesome-dsh-plugin entry file (`data/plugins/Windsander__Mebular--packages-dsh-plugin.yml`) | 🌌 copy + one runtime-prerequisite sentence; `category: memory`; `url` → `tree/main/packages/dsh-plugin`; icon resolves (HTTP 200) | Verified only. #9167 (initial), #11519 (🌌 copy) and #12556 (restore 🌌 copy) are all merged; no duplicate PR opened | [entry](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/data/plugins/Windsander__Mebular--packages-dsh-plugin.yml) · [#9167](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9167) · [#11519](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11519) · [#12556](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/12556) | Up to date | +| awesome-dsh-plugin detail page EN/ZH | Copy is the approved 🌌 text, but the install snippet still reads `@mebular/dsh-plugin@0.3.2` | None possible from here: the page renders a cached README snapshot and is rebuilt by the upstream nightly `build-site` workflow from this repo's README, which already says 0.3.4 | [EN](https://awesome-dsh-plugin.com/p/Windsander/Mebular--packages-dsh-plugin/) · [ZH](https://awesome-dsh-plugin.com/zh/p/Windsander/Mebular--packages-dsh-plugin/) | Waiting on upstream rebuild | +| dshmarketplace.dev | Listed: 1 result for `mebular`, category `memory`, install check **passed** on DSH `0.2.2-rc.1` (2026-11-13), npm install command unpinned, star count cached at 16 | Verified only; the catalogue syncs itself from the community registry and the `dsh-plugin` GitHub topic | [search](https://dshmarketplace.dev/plugins?q=mebular) · [API record](https://dshmarketplace.dev/api/v1/plugins?q=mebular) | Up to date (auto-synced) | +| dshmarket.com | Listed in the browse index (10,581 plugins) with the same registry data | Verified only; the site is a front end over the awesome-dsh-plugin registry | [browse](https://dshmarket.com/browse/) | Up to date (auto-derived) | +| dsh-plugin.org | Not listed. Pages exist only per repository (`/plugins//`), and submission requires an npm package, the `dsh-plugin` topic and a reviewed GitHub issue | Submission drafted, not filed — needs a signed-in GitHub session, which this maintenance session does not have | [submit](https://dsh-plugin.org/submit) · [issue template](https://github.com/dshplugin/dsh-plugin-hub/issues/new) | Blocked (credentials) | +| dshplugin.app | Not listed. The registry fetches a repository root and classifies the artifact; the submit form is protected by an interactive challenge | Submission drafted, not filed — interactive form plus challenge, and a monorepo root would be indexed as the whole product rather than the plugin | [submit](https://dshplugin.app/submit) | Blocked (interactive form) | +| dsharness.io | Not listed. Its catalogue crawls the `dsh-plugin` GitHub topic daily and still reports "No plugins match your search" for `mebular`; site data stamped 2026-11-06 | Verified only; the repo already carries the `dsh-plugin` topic, so this is a crawl/eligibility gap on their side | [search](https://dsharness.io/en/plugins?q=mebular) | Blocked (external crawler) | +| dshpub | Domain does not resolve: `dshpub.com`, `dshpub.dev`, `dshpub.io`, `dshpub.net` all NXDOMAIN | Recorded; nothing to update | — | Not applicable | +| GitHub repository About | Description, homepage (`https://mebular.cyberfederal.io/`) and topics (`agent-context`, `agent-memory`, `ai-memory`, `deepseek-harness`, `dsh-plugin`, `knowledge-graph`, `mcp`, `multi-agents`, `task-graph`) all current | Verified only; no change needed | [repo](https://github.com/Windsander/Mebular) | Up to date | +| README / README_CN community entry | v0.3.4 install command present; listing line named awesome-dsh-plugin only | Expanded to name the verified directories and link this audit | [`README.md`](../../README.md) · [`README_CN.md`](../../README_CN.md) | Updated in this change | +| npm (`@mebular/*`) | `latest` = `0.3.4` for all 8 packages, including `@mebular/dsh-plugin` | Read-only check; publishing is out of scope here | [npm](https://www.npmjs.com/package/@mebular/dsh-plugin) | Up to date | + +## Submission drafts (not filed) + +Ready-to-paste material for the two directories that accept submissions. Both must be filed +from a signed-in maintainer session; neither is an announcement, and nothing here should be +posted as a comment or social update. + +### dsh-plugin.org — issue body + +```markdown +### Repository +https://github.com/Windsander/Mebular/tree/main/packages/dsh-plugin + +### One-line value +Shared memory and task graph for every agent on every device, delivered as a DSH-native plugin. + +### Category +Memory & Context + +### Install command +dsh plugin --profile web add @mebular/dsh-plugin@0.3.4 + +### Compatibility +DSH >=0.2.1-rc.2 <0.3.0; Node.js >=22.19; macOS, Windows and Linux (loopback panel only). + +### License +MIT + +### Screenshots / demo +https://raw.githubusercontent.com/Windsander/Mebular/main/packages/dsh-plugin/assets/dsh-panel.jpg + +### Notes +Monorepo sub-package: the plugin lives in packages/dsh-plugin and is published on npm as +@mebular/dsh-plugin. The GitHub repository root is the Mebular product, not the plugin alone. +``` + +### dshplugin.app — form values + +- **GitHub repository URL**: `https://github.com/Windsander/Mebular` +- **Notes**: `DSH plugin is the npm package @mebular/dsh-plugin in packages/dsh-plugin of this monorepo. Install: dsh plugin --profile web add @mebular/dsh-plugin@0.3.4. Category: memory. MIT.` + +## Rules for this surface + +1. One upstream entry per directory. Check for an existing PR or listing before opening another. +2. Copy changes go through the registry entry, never through a directory's own database. +3. Directory pages that cache README snapshots refresh on their own schedule; do not open a PR + just to force a rebuild. +4. Announcements, marketplace comments and social posts are drafted here first and published + only with explicit approval. diff --git a/docs/community/LISTINGS_CN.md b/docs/community/LISTINGS_CN.md new file mode 100644 index 00000000..db408326 --- /dev/null +++ b/docs/community/LISTINGS_CN.md @@ -0,0 +1,88 @@ +# 社区目录与收录审计 + +Mebular(含其 DSH 插件)在 npm、GitHub Release 与产品站点之外的露出位置、当前实际内容, +以及下一步由谁处理。 + +- **审计日期**:2026-11-13 +- **当前版本**:v0.3.4(`@mebular/*` 全部 npm 包,含 `@mebular/dsh-plugin`) +- **DSH 条目权威源**:[`docs/dsh/awesome-dsh-plugin-entry.yml`](../dsh/awesome-dsh-plugin-entry.yml) +- **范围**:仅社区/目录露出面。版本号、manifest、CHANGELOG、发布工作流、tag 与 release notes + 归发布流程所有,不在本文档修改范围内。 + +## 已确认的 DSH 长描述 + +条目文案以 +[awesome-dsh-plugin#11519](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11519) +确认的 🌌 版为准: + +```yaml +description: + en: "🌌 Mebular · shared memory and task collaboration for agents. Through a DSH-native plugin, it provides complete cross-device, cross-agent memory sharing and task-graph capabilities — so physical devices are no longer the boundary of your agents. Secure, controllable, and decentralized!" + zh: '🌌 Mebular 忆云 · 智能体共享记忆与任务协作。通过 DSH 原生插件接入,提供完整的跨设备、跨 Agent 记忆共享与任务图功能,让物理设备不再是你智能体的边界,安全、可控、去中心化!' +``` + +上游 `main` 目前是上述文本再加一句运行时前置说明(`attaches to an existing Mebular app or +CLI runtime; when none exists, …`)。该句由维护者的批量校准提交反复补回,因此按“已接受的 +补充”处理,不作为需要回滚的偏差。 + +## 状态表 + +| 露出面 | 当前内容(2026-11-13) | 本次动作 | PR / 链接 | 状态 | +|---|---|---|---|---| +| awesome-dsh-plugin 条目(`data/plugins/Windsander__Mebular--packages-dsh-plugin.yml`) | 🌌 文案 + 一句运行时前置说明;`category: memory`;`url` → `tree/main/packages/dsh-plugin`;icon 可访问(HTTP 200) | 仅核对。#9167(首次收录)、#11519(🌌 文案)、#12556(恢复 🌌 文案)均已合并;未开重复 PR | [条目](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/data/plugins/Windsander__Mebular--packages-dsh-plugin.yml) · [#9167](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9167) · [#11519](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11519) · [#12556](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/12556) | 与上游一致 | +| awesome-dsh-plugin 详情页(EN/ZH) | 文案已是 🌌 版,但安装片段仍为 `@mebular/dsh-plugin@0.3.2` | 本地无法直接改:该页渲染缓存 README,由上游夜间 `build-site` 从本仓库 README 重建(本仓库已是 0.3.4) | [EN](https://awesome-dsh-plugin.com/p/Windsander/Mebular--packages-dsh-plugin/) · [ZH](https://awesome-dsh-plugin.com/zh/p/Windsander/Mebular--packages-dsh-plugin/) | 等待上游重建 | +| dshmarketplace.dev | 已收录:搜索 `mebular` 命中 1 条,分类 `memory`,安装检查 **通过**(DSH `0.2.2-rc.1`,2026-11-13),npm 安装命令不带版本,star 数为缓存值 16 | 仅核对;该站从社区 registry 与 `dsh-plugin` GitHub topic 自动同步 | [搜索](https://dshmarketplace.dev/plugins?q=mebular) · [API 记录](https://dshmarketplace.dev/api/v1/plugins?q=mebular) | 已同步 | +| dshmarket.com | 已进入 browse 索引(10,581 个插件),数据同 registry | 仅核对;该站是 awesome-dsh-plugin registry 的前端 | [browse](https://dshmarket.com/browse/) | 已同步(自动派生) | +| dsh-plugin.org | 未收录。页面只按仓库维度(`/plugins//`)生成,提交需要 npm 包、`dsh-plugin` topic,并走 GitHub issue 审核 | 已准备提交草稿,未投递 —— 需要已登录的 GitHub 会话,本维护会话没有 | [提交页](https://dsh-plugin.org/submit) · [issue 模板](https://github.com/dshplugin/dsh-plugin-hub/issues/new) | 阻塞(缺少凭据) | +| dshplugin.app | 未收录。registry 抓取仓库根目录再分类,提交表单带交互式人机校验 | 已准备草稿,未投递 —— 表单需人工交互,且 monorepo 根目录会被索引成整个产品而非插件 | [提交页](https://dshplugin.app/submit) | 阻塞(交互式表单) | +| dsharness.io | 未收录。其目录每天爬 `dsh-plugin` topic,但对 `mebular` 返回“No plugins match”;站点数据时间戳 2026-11-06 | 仅核对;仓库已带 `dsh-plugin` topic,属对方抓取/准入侧问题 | [搜索](https://dsharness.io/en/plugins?q=mebular) | 阻塞(外部抓取) | +| dshpub | 域名不解析:`dshpub.com`、`dshpub.dev`、`dshpub.io`、`dshpub.net` 均 NXDOMAIN | 记录;无可更新对象 | — | 不适用 | +| GitHub 仓库 About | 描述、主页(`https://mebular.cyberfederal.io/`)、topics(`agent-context`、`agent-memory`、`ai-memory`、`deepseek-harness`、`dsh-plugin`、`knowledge-graph`、`mcp`、`multi-agents`、`task-graph`)均为当前值 | 仅核对,无需改动 | [仓库](https://github.com/Windsander/Mebular) | 已是最新 | +| README / README_CN 社区入口 | 安装命令已是 0.3.4;收录说明此前只提到 awesome-dsh-plugin | 补上已验证的目录链接,并指向本文档 | [`README.md`](../../README.md) · [`README_CN.md`](../../README_CN.md) | 本次更新 | +| npm(`@mebular/*`) | 8 个包的 `latest` 均为 `0.3.4`,含 `@mebular/dsh-plugin` | 只读核对;发布不属于本次范围 | [npm](https://www.npmjs.com/package/@mebular/dsh-plugin) | 已是最新 | + +## 提交草稿(尚未投递) + +两个接受提交的目录的现成材料。都必须由已登录的维护者投递;这些不是公告,也不应被当作评论 +或社交媒体内容发布。 + +### dsh-plugin.org — issue 正文 + +```markdown +### Repository +https://github.com/Windsander/Mebular/tree/main/packages/dsh-plugin + +### One-line value +Shared memory and task graph for every agent on every device, delivered as a DSH-native plugin. + +### Category +Memory & Context + +### Install command +dsh plugin --profile web add @mebular/dsh-plugin@0.3.4 + +### Compatibility +DSH >=0.2.1-rc.2 <0.3.0; Node.js >=22.19; macOS, Windows and Linux (loopback panel only). + +### License +MIT + +### Screenshots / demo +https://raw.githubusercontent.com/Windsander/Mebular/main/packages/dsh-plugin/assets/dsh-panel.jpg + +### Notes +Monorepo sub-package: the plugin lives in packages/dsh-plugin and is published on npm as +@mebular/dsh-plugin. The GitHub repository root is the Mebular product, not the plugin alone. +``` + +### dshplugin.app — 表单取值 + +- **GitHub repository URL**:`https://github.com/Windsander/Mebular` +- **Notes**:`DSH plugin is the npm package @mebular/dsh-plugin in packages/dsh-plugin of this monorepo. Install: dsh plugin --profile web add @mebular/dsh-plugin@0.3.4. Category: memory. MIT.` + +## 这个面的规则 + +1. 每个目录只保留一个上游条目;开新 PR 前先确认是否已有 PR 或收录。 +2. 文案改动走 registry 条目,不直接改各目录自己的数据库。 +3. 缓存 README 快照的目录页按其自身节奏重建,不为了刷新而开 PR。 +4. 公告、marketplace 评论与对外发帖先在本文档起草,获得明确同意后再发布。 diff --git a/docs/dsh/awesome-dsh-plugin-entry.yml b/docs/dsh/awesome-dsh-plugin-entry.yml index 23dac42c..67304911 100644 --- a/docs/dsh/awesome-dsh-plugin-entry.yml +++ b/docs/dsh/awesome-dsh-plugin-entry.yml @@ -6,11 +6,19 @@ # 说明: 这是 monorepo 子包条目,url 指向 packages/dsh-plugin;name 使用 # owner/repo#subname。 # -# 2026-11-03 文案校准(对齐 0.3 工具面与主项目口径):上游 PR 已提交: -# https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11519 -# 合并后把本文件同步为目标仓库状态并记录合并时间。 +# 2026-11-03 文案校准(对齐 0.3 工具面与主项目口径): +# https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11519(已合并, +# 🌌 长描述自此为条目文案基准)。 # -# 安装: dsh plugin --profile web add @mebular/dsh-plugin@0.3.0 +# 2026-11-06 描述恢复:批量校准提交在 #11519 合并后覆盖了文案,已通过 +# https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/12556 恢复(已合并)。 +# 上游 main 现为 🌌 文案 + 一句运行时前置说明(attaches to an existing Mebular app or +# CLI runtime…),由 #12556 合并后的批量提交补回;按维护者校准流程接受,不再单独提 PR。 +# +# 详情页安装片段(0.3.2)属上游 README 快照缓存,由 nightly build-site 从本仓库 +# README 重建;本仓库 README 已为 0.3.4。逐面状态见 docs/community/LISTINGS.md。 +# +# 安装: dsh plugin --profile web add @mebular/dsh-plugin@0.3.4 # 兼容: DSH >=0.2.1-rc.2 <0.3.0, Node.js >=22.19 url: https://github.com/Windsander/Mebular/tree/main/packages/dsh-plugin