# Cyrene-Plugins

**Repository Path**: playa0/cyrene-plugins

## Basic Information

- **Project Name**: Cyrene-Plugins
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 4
- **Created**: 2026-09-13
- **Last Updated**: 2026-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="./cyrene-image.png" width="160" alt="Cyrene-Plugins" />
</p>

# Cyrene-Plugins

Cyrene 昔涟官方插件收录仓库：开发者通过 Pull Request 提交插件，审核通过后收录进本仓库，供用户下载安装。

> ⚠️ **临时公告（2026-09-13）**：GitHub 账号暂时被封禁，正在申诉。期间本仓库与插件 ZIP 下载均已切换到 [Gitee 镜像](https://gitee.com/playa0/cyrene-plugins) 分发，源码与安装包均可正常获取；GitHub 恢复后同步回去。

- 主程序：[Cyrene-Agent](https://gitee.com/playa0/cyrene-agent)
- SDK：[@playa0v0/cyrene-plugin-sdk](https://www.npmjs.com/package/@playa0v0/cyrene-plugin-sdk)
- 开发指南：[docs/plugins/plugin-dev-guide.md](https://gitee.com/playa0/cyrene-agent/blob/master/docs/plugins/plugin-dev-guide.md)

---

## 已收录插件

| 插件 | 版本 | 简介 | 直接下载 | 开发者 | 原仓库 |
| --- | --- | --- | --- | --- | --- |
| [weather-tool](./plugins/weather-tool) | 0.1.0 | 查询城市天气：优先使用用户配置的 OpenWeather 密钥，未配置时自动降级到免密钥的 Open-Meteo | —（示例，不分发） | Cyrene 示例 | — |
| [long-term-memory](./plugins/long-term-memory) | 0.1.0 | 监听轮次结束事件，自动摘要对话并存档，把长期记忆注入下一轮上下文 | —（示例，不分发） | Cyrene 示例 | — |
| [scheduled-automation](./plugins/scheduled-automation) | 0.1.0 | 通过对话创建、管理自己的定时任务（创建后需在宿主界面确认启用） | —（示例，不分发） | Cyrene 示例 | — |
| [local-asr-contract](./plugins/local-asr-contract) | 0.1.0 | 本地语音识别契约示例：演示语音输入租约的获取、提交与释放 | —（示例，不分发） | Cyrene 示例 | — |
| [system-status](./plugins/system-status) | 0.1.0 | 查询本机系统状态：CPU、内存、磁盘、电池与开机时长，附带可视化状态面板 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/system-status-0.1.0.zip) | Playa | — |
| [subscription-oauth](./plugins/subscription-oauth) | 1.2.11 | 用订阅账号登录 ChatGPT / Claude / Grok，经本地代理使用订阅模型；支持工具调用、多账号、模型目录、用量显示及 ChatGPT / Grok 订阅生图 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/subscription-oauth-1.2.11.zip) | 1971687396 | — |
| [indextts-tts](./plugins/indextts-tts) | 1.1.2 | 在本机启动 IndexTTS 2.x 语音合成服务，供 Cyrene 的 GPT-SoVITS 通道直接调用 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/indextts-tts-1.1.2.zip) | Downfallofthedownfall | — |
| [ripples-of-aion](./plugins/ripples-of-aion) | 0.6.0 | 结构化记忆层：自动沉淀对话事实，混合检索 + LLM 精排、实体属性时间轴、autoDream 整合与五页可视化面板 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/ripples-of-aion-0.6.0.zip) | modusensus | [Ripples-of-Aion](https://github.com/modusensus/Ripples-of-Aion) |
| [chat-export](./plugins/chat-export) | 1.0.0 | 把本地聊天存档导出为人可读的 HTML / Markdown：聊天气泡界面、双方头像、思考过程与工具调用折叠展示 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/chat-export-1.0.0.zip) | Playa | — |
| [minecraft-bot](./plugins/minecraft-bot) | 0.10.0-beta.1（Beta） | 把 Agent 接入 Minecraft：机器人连接服务器，游戏聊天直接对话，支持移动/跟随/攻击/农耕/交易/自主任务与本能反射 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/minecraft-bot-0.10.0-beta.1.zip) | Cyrene | — |
| [bili-music](./plugins/bili-music) | 0.3.2 | B 站听歌：视频分 P 当音源，搜索/下载转 M4A 用内置隐藏播放器出声，支持播放队列与扫码登录（凭据只存本机），匿名可用 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/bili-music-0.3.2.zip) | boring9720 | — |
| [astral-relay](./plugins/astral-relay) | 0.5.0 | BYOS 中转站：用自己的订阅额度驱动 Cyrene，按各厂商条款分类放行——通义千问 / 腾讯 Coding Plan 仅限 Code 交互会话（由插件自行判定，不需要改动宿主），MiniMax 全模式，xAI Grok 为实验性 OAuth 接入 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/astral-relay-0.5.0.zip) | Unknownuserfrommars | [astral-relay](https://github.com/Unknownuserfrommars/astral-relay) |
| [local-asr](./plugins/local-asr) | 0.4.9 | 本地语音识别：麦克风语音转文字自动进输入框，通话开始自动接管（纯 SDK 接口实现）；零环境小白可用（无引擎时面板一键下载轻量 CPU 引擎，SHA-256 校验，断点续传） | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/local-asr-0.4.9.zip) | boring9720 | [boring9720/cyrene-local-asr](https://github.com/boring9720/cyrene-local-asr) |
| [mijia-control](./plugins/mijia-control) | 0.3.0 | 米家智能家居控制：扫码连接米家账号，按房间分组展示设备；基于公开 MIoT-Spec 自动生成功能控件（开关/滑块/下拉/动作按钮），对话与面板两种方式操控，淡粉液态玻璃面板带底部抽屉上滑减速动画 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/mijia-control-0.3.0.zip) | 抽卡保底真君 | [ahwhshen/cyrene-plugin-mijia-control](https://github.com/ahwhshen/cyrene-plugin-mijia-control) |
| [cyrene-browser](./plugins/cyrene-browser) | 0.3.0 | 使用 Cyrene 自带 Chromium 的可见浏览器，让用户与 Agent 操作同一个网页 | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/cyrene-browser-0.3.0.zip) | 1971687396 | — |
| [xiaomi-health](./plugins/xiaomi-health) | 0.5.3 | 扫码连接小米运动健康（CN 区），定时同步步数 / 睡眠 / 心率；对话、定时播报、发动态时均能感知健康数据，可配播报频率 / 风格与早安问候，支持将健康写入长期记忆（L2） | [ZIP](https://gitee.com/playa0/cyrene-plugins/raw/main/zips/xiaomi-health-0.5.3.zip) | 抽卡保底真君 | [xiaomi-health-plugin](https://github.com/ahwhshen/xiaomi-health-plugin) |

---

## 用户：如何安装插件

1. 在上方表格点击插件对应的 **ZIP** 链接直接下载（安装包托管在本仓库 `zips/` 目录，经 Gitee 分发）
2. 在 Cyrene 中打开 **设置 → 插件 → 导入 ZIP**，选择下载的压缩包
3. 安装完成后在插件列表中**手动启用**

说明：

- 安装包由维护者从审核过的 `plugins/` 源码统一打包，随 `zips/` 目录入库分发，与源码目录一一对应
- 想查看插件源码：进入对应 `plugins/<插件id>/` 目录
- 官方示例插件仅作开发参考，不通过市场分发，无下载链接
- 用户插件首次安装后默认停用，启用后才会生效
- 插件更新：重新导入新版 ZIP 即可，插件数据（存储、密钥）不会丢失

---

## 开发者：如何提交插件

简述流程（详见 [CONTRIBUTING.md](./CONTRIBUTING.md)）：

1. 用 `npm install @playa0v0/cyrene-plugin-sdk` 开发与测试插件
2. 把**可直接安装的产物**（`manifest.json` + 编译后的入口文件）放进 `plugins/<你的插件id>/` 目录
3. 在 `registry.json` 中登记插件信息，并在 README「已收录插件」表格末尾添加一行（详见 [CONTRIBUTING.md](./CONTRIBUTING.md)）
4. 提交 Pull Request，等待安全审核（审核标准见 [review-checklist.md](./review-checklist.md)）

注意：**提交者不需要也不应该上传 ZIP**。ZIP 由维护者在你合并后统一打包，保证用户下载的内容与审核过的源码一致。

---

## 维护者：下载量与 Gitee 同步

`.github/workflows/aggregate-downloads.yml` 每天统计 GitHub Release 附件下载量，更新 `registry.json` 后将当前 `main` 同步到 Gitee，避免客户端主源与 GitHub 索引不一致。

首次启用前，需要在 GitHub 仓库的 **Settings → Secrets and variables → Actions** 新建仓库 Secret：

- `GITEE_TOKEN`：Gitee 账号 `playa0` 的私人令牌，需要具备向 `playa0/cyrene-plugins` 推送代码的权限。

工作流即使当天下载量没有变化，也会执行 Gitee 同步，因此镜像短暂落后时可在下一次定时任务或手动运行 `workflow_dispatch` 后自动追平。同步使用普通 fast-forward push，不会强制覆盖 Gitee 上的独立提交；若两边历史发生分叉，工作流会失败并提示维护者人工处理。

---

## 安全说明

- 本仓库所有插件经过人工安全审核后才收录，但**审核不构成担保**，请只安装你信任的插件
- 插件与 Cyrene 运行在同一进程，拥有完整 Node.js 权限（可读写文件、联网、启动子进程）
- 所有用户插件首次安装后默认停用；定时任务、密钥写入等敏感操作需你在宿主界面二次确认

---

## 目录结构

```text
Cyrene-Plugins/
├── plugins/              # 已收录插件源码（每个子目录一个插件，可在线阅读）
│   └── <插件id>/
│       ├── manifest.json # 插件清单
│       ├── index.cjs     # 编译后的入口
│       └── README.md     # 插件说明
├── scripts/
│   ├── publish-plugins.ps1     # 发布脚本（维护者工具：合并 PR 后打包并发布 GitHub Release）
│   └── aggregate-downloads.mjs # 下载量聚合脚本（GitHub Action 每日自动运行）
├── registry.json         # 收录索引（插件元数据登记处）
├── CONTRIBUTING.md       # 提交规范（面向插件开发者）
└── review-checklist.md   # 审核清单（面向维护者，也可供提交者自查）
```