插件管理

插件管理功能用于查看和安装 WealthSight 的扩展组件。通过插件，您可以接入不同的数据源（实时报价、历史数据、交易记录导入），从而灵活扩展系统的数据获取能力。

名词解释

插件

指实现了 WealthSight 插件接口的动态链接库（.dll），用于扩展系统的数据源功能。插件可以独立开发、分发和安装。

插件元数据

每个插件包含一组元数据，用于在系统中标识自身：

• 插件名称：插件的唯一标识名。
• 插件描述：简要说明插件的功能或来源。
• 优先级：数值越高，在候选列表中的排序越靠前（界面不直接显示）。

插件类型

根据插件实现的接口，可分为三类（一个插件可同时实现多个接口）：

• 报价插件（IQuotePlugin）：提供标的的实时价格。
• 历史数据插件（IHistoryPlugin）：提供标的的历史价格序列。
• 交易导入插件（IImportTradePlugin）：解析券商对账单等文件，批量导入交易记录。

内置插件

系统预装的插件，随 WealthSight 一同发布，不可卸载。例如：

• Currency 插件：用于货币类标的，其价格恒定为 1，不提供历史数据。该插件同时实现了报价和历史数据接口，方便现金持仓的管理。

外部插件

用户通过官方插件市场或本地安装 .zip 插件包 / .dll 单文件安装的插件。新增插件安装后系统会尝试立即加载；更新已安装插件时，为避免替换正在运行的插件文件，系统可能会先保存为待安装更新，并在下次启动时完成替换。

插件市场

插件市场用于发现、安装或更新 WealthSight 官方插件。部分数据服务需要您自行注册账号、配置 Token 或确认使用权限；安装前如出现提示，请先确认自己有权使用对应插件和数据服务。

插件市场不包含所有第三方或社区维护的数据适配器。如需了解社区插件的查找、安装和风险边界，请查看“社区插件”帮助页。

插件市场界面也支持用户自行添加第三方插件源 URL。第三方插件源由第三方或用户社区维护，WealthSight 不提供、不审核、不托管、不保证其中的插件及数据服务。

插件版本

插件程序集的版本号（通常取 Major.Minor.Patch 三位），用于区分不同迭代。

插件文件名

外部插件对应的 .dll 文件名。内置插件该项显示为“内置插件”。

界面说明

插件列表页以表格形式展示所有已安装插件，包含以下列：

页面顶部显示当前已安装插件总数，并提供本地安装和打开插件市场的入口。列表中的插件表示已经被系统识别并安装。

管理操作

查看插件列表

系统启动时会先应用待安装的插件更新，然后扫描 plugins 目录并加载所有有效插件。安装或上传插件后，系统会尝试重新扫描并热加载可立即生效的新增插件；更新已有插件通常需要重启应用后才会完成替换。

使用插件市场

1. 点击“插件市场”按钮，打开市场对话框。
2. 查看插件名称、说明、最新版本、本地版本和状态。
3. 对未安装或可更新的插件点击“安装”或“更新”。
4. 安装成功后，系统会尝试立即加载新增插件；如果是更新已有插件或当前运行环境无法立即加载，界面会提示重启应用后生效。

官方插件源只展示 WealthSight 维护的插件。免费或实验性数据适配器可能由社区或第三方维护，请自行查找、评估来源可信度和使用权限。

如需添加第三方插件源：

1. 点击“添加第三方源”。
2. 填写第三方插件源地址。
3. 阅读风险提示并确认。
4. 在插件源下拉框中选择该源，查看可安装插件。
5. 安装或更新插件前再次确认风险提示。

第三方插件源要求：

• 远程地址支持 http 或 https。
• 第三方源中的插件下载仅支持 .zip 插件包。
• 第三方源插件必须提供 sha256 校验值。

插件市场中的状态含义：

安装本地插件

1. 点击“安装本地插件”按钮，从本地选取一个符合接口规范的 .zip 插件包或 .dll 单文件。
2. 确认插件来源、数据源权限和使用风险后继续安装。安装成功后，系统会尝试热加载新增插件；若热加载成功，插件会立即出现在已安装插件列表中；若是更新已有插件或无法热加载，界面会提示重启应用后生效。

注意：

• 推荐使用 .zip 插件包；也支持直接安装实现 WealthSight 插件接口的 .dll 单文件。
• .zip 插件包中只允许包含根目录下的 .dll 文件。
• 若上传的文件与已有插件同名，将被覆盖。
• 更新已安装插件时，旧版本文件可能正在运行中，系统会将新文件保存为待安装更新，并在下次启动时完成替换。

注意事项

• 安全性与授权：插件可执行任意代码，请仅从可信来源获取。非官方市场提供的本地插件，其功能、数据来源、版权和使用授权由插件提供者和使用者自行确认。
• 兼容性：插件需与当前 WealthSight 版本兼容，接口定义不匹配可能导致加载失败。
• 调试信息：若插件加载异常，可查看应用日志获取详细错误信息。
• 内置插件：Currency 插件为系统必需组件，不可删除或修改。

插件开发

如需开发自定义插件，请参考《插件开发指南》。开发完成后可通过插件管理页面安装 .zip 插件包或生成的 .dll 文件。

相关文档

• 使用插件
• 插件架构介绍
• 社区插件