Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Changelog

## 0.10.0 — 2026-10-26

- Add a bilingual plugin marketplace with searchable capabilities, requirements, pinned source versions and actual release downloads.
- Generate a DSH format-1 Git index using the official validator; keep executable bundles separate from Bot configuration exports and desktop-host-only packages.
- List the independent UseChat adapter and existing desktop capture and SuperTerminal packages. Installation, permissions and real-device verification remain distinct.
- Preserve all existing Bot templates, published manifest versions, handbook and reference pages.

## 0.9.3 — 2026-10-25

- Link marketplace scenarios and handbook task cards directly to their matching practice packs; search results now land on the individual scenario card.
Expand Down
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ Use **Copy for Agent** in the market or an individual Bot detail, then paste the

## Run locally

Node.js **22 or newer**. No runtime package dependencies.
Node.js **22 or newer**. The static site has no browser runtime dependencies; its build uses the locked official DSH index validator.

```sh
git clone https://github.com/Harzva/awesome-bot.git
Expand Down Expand Up @@ -125,3 +125,7 @@ Format and import checks are not certifications that every role has completed re
[Awesome DSH Plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) and [DSH Market](https://github.com/dsh-market/dsh-market) inform project organization and discovery. Roles, workflows, skills, plugins and execution runtimes remain distinct. See the [reference benchmark](docs/reference-benchmark.md), [source notes](SOURCE.md) and [App integration contract](INTEGRATION.md).

Original content and code use [MIT](LICENSE). Upstream names and references retain their owners' rights; see [third-party notices](THIRD_PARTY_NOTICES.md). This is an independent project, unaffiliated with xAI or DeepSeek.

## Plugins

[Browse plugins](https://harzva.github.io/awesome-bot/plugins.html?lang=en) alongside Bot templates. DSH bundles use a separate [format-1 Git index](https://harzva.github.io/awesome-bot/dsh/index.json); OpenBot desktop plugins retain their own desktop installation contract. Plugin versions pin a Git commit and release archive checksum. Downloads do not install, enable, or grant permissions. See [the plugin guide](docs/plugins.md).
6 changes: 5 additions & 1 deletion README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@

## 本地开发

需要 Node.js 22 或更新版本,无运行时 npm 依赖。
需要 Node.js 22 或更新版本。静态网页没有浏览器运行时依赖;构建使用锁定版本的 DSH 官方索引校验器。

```sh
git clone https://github.com/Harzva/awesome-bot.git
Expand Down Expand Up @@ -92,3 +92,7 @@ PR 运行独立构建、格式与来源覆盖检查、导出和公开产物审
项目借鉴 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 的目录、贡献与维护机制,保留自己的 Bot 语义和安装格式。见[参考检查表](docs/reference-benchmark.md)。本项目不生成虚假评分、热度或下载数。

原创内容采用 [MIT](LICENSE)。上游名称和引用归原权利人;详见[来源说明](SOURCE.md)与[第三方声明](THIRD_PARTY_NOTICES.md)。本项目独立于 xAI 和 DeepSeek。

## 插件市场

[浏览插件](https://harzva.github.io/awesome-bot/plugins.html),为已有 Bot 增加能力。DSH 工具包提供独立的 [format-1 Git 索引](https://harzva.github.io/awesome-bot/dsh/index.json);OpenBot 桌面插件沿用自己的桌面安装流程。每个版本固定 Git 提交和下载包摘要,下载不等于安装、启用或授权。见[插件说明](docs/plugins.md)。
210 changes: 210 additions & 0 deletions data/plugins.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,210 @@
{
"schema": "awesome.bot.plugins/1",
"updatedAt": "2026-10-26",
"entries": [
{
"id": "wechat-usechat",
"name": {
"zh": "微信 · UseChat",
"en": "WeChat · UseChat"
},
"summary": {
"zh": "通过本机 UseChat 为 Bot 提供微信环境检查、指定对话读取与经批准的文字发送。",
"en": "Use local UseChat to diagnose WeChat setup, read selected visible chats and submit approved text."
},
"packageName": "@harzva/dsh-wechat-usechat",
"version": "0.1.0",
"repository": "https://github.com/Harzva/dsh-wechat-usechat",
"revision": "4e546e1ddbb2e170fc6dce35aa1fceb67a074a3f",
"license": "MIT",
"platforms": [
"macOS"
],
"format": "dsh-bundle",
"downloadUrl": "https://github.com/Harzva/dsh-wechat-usechat/releases/download/v0.1.0/harzva-dsh-wechat-usechat-0.1.0.tgz",
"sha256": "e211069893163cc06609f9df3caad6d8ff59ee3dae77a5060226bb2294eea1cf",
"docsUrl": "https://github.com/Harzva/dsh-wechat-usechat/blob/4e546e1ddbb2e170fc6dce35aa1fceb67a074a3f/README.md",
"dsh": {
"engine": "0.2.1-rc.2",
"publishTimestamp": 1793000496
},
"capabilities": {
"zh": [
"环境诊断 usechat_doctor",
"读取允许对话 usechat_read",
"逐次批准后发送文字 usechat_send_text"
],
"en": [
"Setup diagnosis: usechat_doctor",
"Allowed visible chat reading: usechat_read",
"Individually approved text sends: usechat_send_text"
]
},
"requirements": {
"zh": [
"macOS、已登录的微信和独立安装的 UseChat Helper",
"Node.js 22.19+、DSH 0.2.1-rc.2",
"宿主配置允许对话、视觉模型和共享窗口操作锁;系统授予屏幕录制与辅助功能权限",
"发送需宿主显式开启,并接入真实逐次审批服务"
],
"en": [
"macOS, signed-in WeChat and separately installed UseChat Helper",
"Node.js 22.19+, DSH 0.2.1-rc.2",
"Host-selected chats, vision provider and shared UI lease; OS screen recording and accessibility permissions",
"Sending requires an explicit host write flag and a real per-call approval service"
]
},
"limitations": {
"zh": [
"仅支持可见对话与文字发送;不承诺完整历史或视频号控制",
"远程视觉模型可能接收当前窗口截图和 OCR",
"发送默认关闭;不确定结果禁止自动重发",
"已验证 DSH 安装、工具注册与审批拦截,尚未操作真实微信消息"
],
"en": [
"Visible chats and text only; no full-history or video-channel control claim",
"A remote vision provider may receive window screenshots and OCR",
"Sending starts disabled; uncertain outcomes cannot automatically retry",
"DSH installation, tool registration and approval denial verified; real WeChat messages not exercised"
]
},
"openbot": {
"status": "git-adapter-required",
"note": {
"zh": "普通 DSH 可按固定 Git 提交安装;OpenBot 在线安装需要宿主 Git 来源适配更新。",
"en": "Standalone DSH can install the pinned Git commit; OpenBot online installation needs the host Git-source adapter update."
}
}
},
{
"repository": "https://github.com/Harzva/dsh-desktop-capture",
"revision": "1592e6c8d637d92975f5505ece96b3e21f2eaa1c",
"license": "MIT",
"platforms": [
"macOS"
],
"format": "openbot-desktop",
"dsh": null,
"docsUrl": "https://github.com/Harzva/dsh-desktop-capture/blob/1592e6c8d637d92975f5505ece96b3e21f2eaa1c/README.md",
"openbot": {
"status": "desktop-host",
"note": {
"zh": "通过 OpenBot 桌面插件管理器安装、启用;普通 DSH 不能单独运行。",
"en": "Install and enable with the OpenBot desktop plugin manager; not a standalone DSH tool bundle."
}
},
"id": "desktop-capture",
"name": {
"zh": "截图与录制",
"en": "Screen capture & recording"
},
"summary": {
"zh": "让 Bot 查看界面,录制应用或桌面,制作带配音的演示素材。",
"en": "Let a Bot observe a screen, record an app or desktop, and create narrated demo material."
},
"version": "0.3.1",
"packageName": "@openbot/dsh-desktop-capture",
"sha256": "40aa35bc0d7d3f633d76917c707e3a3d5aa57498fff88e42d88223f724c5fc86",
"downloadUrl": "https://github.com/Harzva/dsh-desktop-capture/releases/download/v0.3.1/openbot-dsh-desktop-capture-0.3.1.tgz",
"capabilities": {
"zh": [
"应用与桌面截图",
"画面录制",
"演示与配音工具"
],
"en": [
"App and desktop screenshots",
"Screen recording",
"Demo and narration tools"
]
},
"requirements": {
"zh": [
"Apple Silicon Mac,macOS 15 或更新",
"OpenBot Desktop Host API 1",
"按任务授予屏幕录制、麦克风或摄像头权限"
],
"en": [
"Apple Silicon Mac, macOS 15 or newer",
"OpenBot Desktop Host API 1",
"Screen recording, microphone or camera permission for the selected task"
]
},
"limitations": {
"zh": [
"网站下载不会自动安装或启用",
"摄像头采集不代表已支持画中画成片"
],
"en": [
"A website download does not install or enable the plugin",
"Camera capture does not establish camera-overlay video support"
]
}
},
{
"repository": "https://github.com/Harzva/dsh-desktop-capture",
"revision": "1592e6c8d637d92975f5505ece96b3e21f2eaa1c",
"license": "MIT",
"platforms": [
"macOS"
],
"format": "openbot-desktop",
"dsh": null,
"docsUrl": "https://github.com/Harzva/dsh-desktop-capture/blob/1592e6c8d637d92975f5505ece96b3e21f2eaa1c/README.md",
"openbot": {
"status": "desktop-host",
"note": {
"zh": "通过 OpenBot 桌面插件管理器安装、启用;普通 DSH 不能单独运行。",
"en": "Install and enable with the OpenBot desktop plugin manager; not a standalone DSH tool bundle."
}
},
"id": "superterminal",
"name": {
"zh": "超级终端",
"en": "SuperTerminal"
},
"summary": {
"zh": "为 Bot 提供终端会话、输出读取与受控命令输入。",
"en": "Give a Bot terminal sessions, output reading and controlled command input."
},
"version": "0.2.1",
"packageName": "@openbot/dsh-superterminal",
"sha256": "0359c51c9da46e56beb06ef4df7efe371757abf983f33f95ad2515f4a667b55e",
"downloadUrl": "https://github.com/Harzva/dsh-desktop-capture/releases/download/v0.3.1/openbot-dsh-superterminal-0.2.1.tgz",
"capabilities": {
"zh": [
"打开与关闭终端",
"读取输出和命令记录",
"受控输入与终端设置"
],
"en": [
"Open and close terminals",
"Read output and command history",
"Controlled input and terminal settings"
]
},
"requirements": {
"zh": [
"Apple Silicon 或 Intel Mac",
"OpenBot Desktop Host API 1",
"所选 Bot 具有相应终端权限"
],
"en": [
"Apple Silicon or Intel Mac",
"OpenBot Desktop Host API 1",
"Terminal permissions for the selected Bot"
]
},
"limitations": {
"zh": [
"安装不授予命令执行权限",
"需要桌面宿主,不作为独立 DSH 工具包安装"
],
"en": [
"Installation grants no command execution permission",
"Requires the desktop host; not a standalone DSH tool bundle"
]
}
}
]
}
40 changes: 40 additions & 0 deletions docs/plugins.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# 插件市场 / Plugin marketplace

Awesome Bot 同时收录 Bot 模板和可执行插件。Bot 模板是角色配置;插件为已存在的 Bot 提供工具。两类资产共用网站导航,但保留各自的安装格式和权限边界。

Awesome Bot lists both Bot templates and executable plugins. A template describes a role; a plugin adds tools to an existing Bot. They share discovery, not installation or permission semantics.

## 使用 / Use

1. 打开 [插件市场](https://harzva.github.io/awesome-bot/plugins.html),检查系统要求、版本、权限和限制。
2. DSH 插件选择“安装说明”,复制固定提交的 Git 安装地址,按该版本 README 在自己的 DSH 环境安装。支持自定义市场的客户端可以添加 `https://harzva.github.io/awesome-bot/dsh/index.json`。
3. OpenBot 桌面插件使用桌面插件管理器和对应发布目录,不能仅因含有 DSH 清单就当成独立 DSH 工具运行。
4. 配置宿主提供的连接、允许操作的对象和权限后再启用。网站不会接入账号、操作聊天或静默安装本机 Helper。

Open the plugin page, inspect requirements and expand the installation details. DSH bundles use a commit-pinned Git source; compatible clients can add the format-1 index above. Desktop plugins use the OpenBot desktop manager. Downloading a file does not enable tools or connect an account.

## DSH 格式 / DSH format

`dsh/index.json` 是官方 format 1 索引,使用 `@deepseek-ai/dsh-plugin-market-index` 0.2.1-rc.2 校验并生成安装参数。每条 DSH 记录包含包名、精确版本、GitHub HTTPS 仓库、40 位提交 SHA 和 DSH 引擎要求。它不把 Bot 的 `fleet.json` 冒充插件,也不要求插件发布到 npm。

The DSH index is validated with the official format-1 parser. Each version points to a public GitHub repository and a complete immutable commit ID. Plugin publication does not require npm; dependencies declared by a plugin may still be downloaded by the DSH package manager from their registries.

`plugins/catalogue.json` 是网站展示索引,另外包含平台、许可、下载包 SHA-256、权限说明和宿主兼容性。它不是 DSH 官方格式,也不是安装授权。Git SHA 和下载摘要用于追溯版本与核对字节,不代表发布者签名或真实任务验收。

The website catalogue includes desktop-host-only packages that are deliberately omitted from the DSH index. Hashes provide version and byte provenance, not publisher authentication or a real-account success claim.

## 微信插件 / WeChat plugin

独立仓库:[Harzva/dsh-wechat-usechat](https://github.com/Harzva/dsh-wechat-usechat)。适配器复用 UseChat,提供环境诊断、指定对话可见内容读取和受控文字发送。宿主必须提供配置与允许对话;发送默认关闭。原生 Helper 单独安装,屏幕和辅助功能权限由系统授权。使用远程视觉模型时,可见截图与 OCR 可能发送给所配置的模型。

The adapter reuses UseChat for setup diagnostics, visible-chat reading and controlled text submission. The host selects configuration and allowed chats. Writes start disabled. The native Helper and OS permissions require explicit setup. A remote vision provider may receive screenshots and OCR. This release does not claim full-history access, video-channel control or real WeChat message acceptance.

OpenBot 1.0.3 的 Agent 插件安装器原先仅支持 npm 源;Git 源需要对应的宿主适配更新。市场显示“需要 Git 安装适配”时,不应把网站下载当作已在当前 App 安装。普通 DSH 客户端可以按固定 Git 地址安装,仍需配置 Helper 与权限。

OpenBot's previously delivered Agent plugin installer accepted npm sources only. Git sources need the corresponding host adapter. A listing marked as requiring that adapter is not a claim that the currently installed App can complete that path. Standalone DSH supports the pinned Git installation route.

## 发布者 / Publishers

在 `data/plugins.json` 维护双语条目,保留上游作者与许可。先发布不可变 Git 提交及实际下载包,计算摘要,再更新索引。运行 `npm ci --ignore-scripts`、`npm run check`、`npm test`、`npm run build:site` 和 `npm run audit:public`。不要上传用户配置、聊天、模型凭据、运行锁或安装回执;已发布版本的包字节不能改写。

Maintain bilingual entries, retain upstream notices, publish immutable artifacts first, then update the catalogue. Run the repository checks before publication. Keep credentials, conversations and local installation state out of public artifacts. Never rewrite an existing released version.
Loading