nina.plugin.aiassistant

NINA人工智能助理

🤖 AI驱动的天文摄影助手 N.I.N.A。 通过MCP设备控制。

特性

• 多提供商AI：GitHub Models（免费）、OpenAI、Anthropic Claude、谷歌Gemini、Ollama（本地）
• MCP设备控制：相机、支架、调焦器、滤光轮、导向器、圆顶的自然语言控制
• 动态模型发现：自动检测每个提供商的最新AI模型
• 图像分析：FITS标头读取、HFR/FWHM监测、恒星检测、质量评估
• 可扩展聊天面板：NINA的成像选项卡中集成了AI聊天
• 可扩展：连接外部MCP服务器，用于天文计算、天气、目录

安装

来自NINA插件管理器（推荐）

1. 打开NINA→ 选项→ 插件
2. 搜索“AI助手”
3. 点击安装
4. 重新启动NINA

手动安装

1. 从下载最新版本 发布
2. 提取到 %localappdata%\NINA\Plugins\3.0.0\AI Assistant\
3. 重新启动NINA

配置

1. 首选 选项→ 插件→ AI助手
2. 选择您的AI提供商
3. 输入您的API密钥（GitHub模型免费层或Ollama不需要）
4. 在可停靠的AI面板中开始聊天

从源头构建

先决条件

• Visual Studio 2022或更高版本
• .NET 8.0 SDK
• 已安装NINA 3.x（仅用于本地测试）

构建

git clone https://github.com/michelebergo/nina.plugin.aiassistant.git
cd nina.plugin.aiassistant
dotnet restore
dotnet build -c Release

构建后事件会将插件复制到您本地的NINA插件文件夹中。

项目结构

nina.plugin.aiassistant/
├── AI/
│   ├── AIService.cs              # Main AI service orchestrator
│   ├── IAIProvider.cs            # Provider interface
│   ├── Models.cs                 # Request/Response models
│   ├── MCP/
│   │   ├── MCPModels.cs          # MCP data structures
│   │   └── NINAAdvancedAPIClient.cs  # NINA API integration
│   └── Providers/
│       ├── AnthropicProvider.cs  # Claude with MCP tools
│       ├── GitHubModelsProvider.cs
│       ├── GoogleProvider.cs
│       ├── OllamaProvider.cs
│       └── OpenAIProvider.cs
├── MCP/
│   └── ExternalMCPClient.cs      # External MCP server support
├── Properties/
│   ├── AssemblyInfo.cs           # Plugin metadata
│   └── Settings.Designer.cs     # User settings
├── Resources/
│   └── Icons.xaml                # UI icons
├── AIAssistantPlugin.cs          # Plugin entry point
├── AIChatVM.cs                   # Chat panel view model
├── AIChatTemplate.xaml           # Chat UI template
├── AIChatView.xaml               # Chat view (dockable panel)
├── Options.xaml                  # Settings UI
├── NINA.Plugin.AIAssistant.csproj
├── NINA.Plugin.AIAssistant.sln
├── manifest.json                 # Plugin manifest
├── icon.png
├── LICENSE.txt
├── CHANGELOG.md
└── README.md

释放

此存储库使用 。要发布新版本，请执行以下操作：

1. 更新版本 Properties/AssemblyInfo.cs
2. 更新 CHANGELOG.md
3. 承诺并推动
4. 标记提交： git tag 2.1.0.0 && git push origin 2.1.0.0
5. GitHub Action将构建、创建发布并提交清单PR

贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支(git push origin feature/AmazingFeature)
5. 打开拉取请求

许可证

此项目根据Mozilla公共许可证2.0获得许可-请参阅 LICENSE.txt 文件以获取详细信息。

致谢

• N.I.N.A。 -令人惊叹的天文摄影软件
• NINA高级API -NINA的API集成
• 天文摄影界