Alpha v1.1.0

InstructionX Alpha 1.1.0 (Pre-release)

重要变更

• 许可证变更为 AGPL v3 + 双重许可：项目由自定义商业源码许可证转为 GNU AGPL v3（或更高版本），附 §7 附加条款（署名与品牌标识保留、商标不授权）；闭源 SaaS/多租户、嵌入第三方商业产品、第三方服务后端、白标使用、批量捆绑销售五类场景需商业授权。新增 ICLA.md 个人贡献者许可协议，支撑双重授权与软件著作权登记（含中国版权保护中心登记）。
• 版本号升级至 Alpha 1.1.0。

缺陷修复

• 插件升级/降级无响应：修复升级/降级时插件路径匹配失败导致空结果、界面无任何变化的问题。
• macOS 退出崩溃：修复 macOS 退出时残留 DeferredDelete 对话框在静态析构阶段销毁导致的段错误。
• 插件控件崩溃：修复插件缓存控件被销毁后 get_widget 复用失效对象导致的崩溃。

新功能

• macOS Dock 栏图标：运行时通过 AppKit 设置 Dock 栏应用图标（仅 macOS，条件依赖 pyobjc-framework-Cocoa）。

工程与安装

• 启动方式统一：移除 run.bat / run.ps1 启动器，统一为 uv 安装与启动方式（uv run main.py），README/AGENTS/插件开发文档同步更新。

文档与品牌

• README 中英双版整体重写：现代化严肃风格，修正过时描述，补齐 i18n、系统托盘、插件分组等特性说明，扩充插件生态内容（元数据、注入服务、示例插件）。
• 框架文档全面同步：文档与代码一致性审计修复（文档/注释/类型注解对齐当前代码）；框架文档阶段性收尾同步。
• 插件开发文档：插件开发快速指南补充插件仓库独立性、结构指引与不捆绑插件说明；新增英文插件开发指南 Plugin-Development-Guide.md。
• 品牌更新：替换应用 LOGO；双 README 头部结构对齐。

兼容性与升级提示

• 全部修复均为内部实现修正，无公开接口变更，既有插件不受影响。
• 许可证变更不溯及已发布版本：alpha-v1.0.5 及更早快照仍按原商业源码许可证授权，自 Alpha 1.1.0 起适用 AGPL v3 + §7 附加条款与双重许可。

---

▎ ⚠️ 测试版本声明
▎ 当前版本为预发布测试版（Pre-release），仅供开发者和早期体验者使用。核心功能已完成实现，但尚未经过全面生产环境验证。部分内部 API 签名、配置格式及插件接口可能在未来版本中发生破坏性变更（Breaking Changes），请勿将其用于生产环境的关键业务。

---

⚠️ 已知限制与注意事项

1. API 不稳定：IPlugin、IPluginInfo、PluginServices 等核心接口以及 core/llm、core/mcp 模块的 API 签名可能在后续版本中调整，插件开发者需留意变更日志。
2. 配置格式可能变更：config/llm_providers.json、config/mcp_config.json、config/plugin_order.json 等配置文件的结构尚未冻结。
3. LLM Provider 适配待完善：部分 Provider 的流式解析、缓存适配和价格计算为初始实现，可能存在边界 case 处理不足。
4. 文档持续迭代：开发者文档与代码实现正在同步更新，部分章节可能滞后于最新代码。

---

反馈

• Issue 提交：https://github.com/KKPIP-Tech/InstructionX/issues
• QQ 群：224380675（进群令牌：fromOIxD）

---

InstructionX Team
2026-09-05

---