ISkyPro Wiki

简体中文

English

简体中文

English

Appearance

2.0.0 ​

发布日期：2026-07-25

ISkyPro 2.0.0 是基于 .NET 10 重写后的首个正式版本，集中完善了管理界面、跨平台发布、ISky v1 与 ISkyPro v2+ 插件运行时，以及 Plugin SDK v2。

✨ Features ​

  • webui: 新增运行概览、Bot 登录与网关配置、插件管理、日志、设置和关于页面，可在浏览器中完成日常管理。
  • plugins: 插件页分别管理 ISky v1 插件（EPL / x86）与 ISkyPro v2+ 插件，展示运行状态、队列、错误和设置；v2 插件可上传 ZIP 安装，重复插件会先显示已安装与待安装版本信息再确认更新，运行中的插件可自动停止并在更新后恢复。
  • about: 更新下载显示文件名、大小、进度和状态，支持取消；Windows 与 Linux 包都可从 WebUI 进入自动更新流程，并会清理下载产生的临时文件。
  • package: 正式提供 Windows x64、Windows arm64 和 Linux x64 主程序包；Linux 支持主程序、WebUI、QQBot 网关和 ISkyPro v2+ 插件。
  • gateway: 消息接收、插件分发和 QQBot 发送改为独立队列，慢插件或慢请求不会阻塞网关继续接收事件，并可在 WebUI 查看队列指标。
  • webui: 登录后会自动同步网关和插件状态，仪表盘插件数量合并统计 ISky v1 与 ISkyPro v2+；日间与暗黑模式的按钮焦点、页内滚动条和内容滚动体验同步优化。
  • plugins: ISkyPro v2+ 插件页明确区分当前进程、随框架启动和当前 Bot 消息策略，stdio 自动启动偏好可跨框架重启保留；响应式卡片布局可完整访问 ZIP 安装和 HTTP 注册。
  • logs: Bot 消息使用带字符数的单行摘要，点击后可查看详细信息、原始内容和 Payload；进入会话后可按全部、接收或发送方向快速过滤。
  • security: 非 Windows 环境使用本地密钥保护 WebUI Token、Bot Secret 等运行时凭据；正式发布包不会携带本机运行数据、已安装插件、日志或运行时密钥。

🧩 Plugin Development ​

  • sdk: Plugin SDK v2 对 C#、Python、Node.js 和 Go 进入稳定支持，官方 SDK 与样例统一提供有界并发、请求超时、双向调用、事件 ACK、日志和安全关闭。
  • messages: 新增统一的结构化消息 API，可回复当前事件或向群、频道、用户和频道私信主动发送文本与提及；插件无需拼接 QQBot 标签或手工传递回复引用。
  • messages: 结构化消息支持 QQ 群 Markdown，四语言 SDK 提供对应的 Markdown 回复/发送方法；Main 使用 msg_type = 2 和 markdown.content，类型化 @ 仍由框架安全生成。新增公开的 QQBotMarkdownRepeatPlugin 示例，并记录 2026-07-25 普通文本 @ 标签显示为文本、Markdown @ 可正常触发的实测兼容性结论；平台后续行为仍以最新官方文档和客户端为准。
  • runtime: stdio-jsonrpc 插件支持静态发现、启动、停止、重启、崩溃恢复、权限校验、运行时 Token、设置表单、日志和运行指标。
  • packages: C# 插件可通过 dotnet publish 生成可安装 ZIP；Python、Node.js 和 Go 提供可直接打包或编译的样例。HTTP 插件作为独立服务部署，通过 Base URL 注册，无需上传 ZIP。
  • catalog: QQBot API catalog 统一生成四种语言的方法、权限和模型元数据，减少不同 SDK 之间的接口差异。

🛡️ Stability ​

  • sdk: 修复 C# stdio-jsonrpc 连续处理事件、SDK API 回复和 ACK 时可能出现的随机 JSON 解析错误与插件超时。
  • v1-plugin: v1 插件的加载、生命周期、菜单和消息回调固定在单个 STA 线程，降低线程亲和与并发重入造成的兼容问题。
  • v1-plugin: v1 插件执行超时或崩溃时可采集诊断信息、结束对应宿主并按策略重启、限流或禁用；插件页会显示宿主代次、超时、崩溃和诊断状态。
  • v2-plugin: 每个 ISkyPro v2+ 插件使用有界事件队列，并在异常退出后按策略恢复，避免无限堆积任务或持续快速重启。

♻️ Compatibility ​

  • runtime: 2.0.0 使用 .NET 10 和新的 ASP.NET Core 主程序，启动、部署和目录结构与旧版 ISky 不同，升级前请保留 config、data 和插件目录。
  • v1-plugin: ISky v1 插件、isky.exe 和 message.dll 继续由 Windows/x86 隔离宿主提供兼容；Linux 包仅支持 ISkyPro v2+ 插件。
  • sdk: v1 EPL SDK 发布为 SDK-V1-EPL-<version>.zip；v2 SDK 按语言发布为 SDK-V2-<Language>-<version>.zip。
  • sdk: 相比预览版，C# 插件不再实现重复的 Manifest 属性，Node.js SDK 方法返回 Promise，Python、Node.js 和 Go 插件应使用官方 runtime，而不是旧的低级直连 context。
  • sdk: Go SDK 的正式导入路径为 github.com/Zephdyn/ISkyPro.Wiki/sdk/go/iskypro/v2。