Project Release Notes
📢 Summary
This update brings significant functional enhancements, focusing on the high customization capabilities of the Deep Research API, session management optimization, and a comprehensive upgrade of the user interaction experience. By introducing a custom prompt mechanism, developers and advanced users can now deeply customize the AI's generation logic. Additionally, the inclusion of session import/export and global shortcut support significantly improves workflow efficiency.
🚀 New Features
1. Deep Research Prompt Customization (Prompt Overrides)
This is the core feature of this update, giving users full control over AI-generated content.
- Configuration Interface: Introduced
promptOverridesin theConfiginterface, allowing users to override built-in prompt templates. - API Support: The SSE API routes now support parsing prompt override parameters, integrated with strict validation and error-handling mechanisms.
- Full-Chain Integration:
KnowledgeGraph,FinalReport, and theuseDeepResearchhook have all been adapted to support custom prompts. - Dynamic Generation: Enhanced prompt generation functions to support dynamic content construction based on user-defined templates.
- Settings Interface: Added a JSON input area in the settings panel, featuring real-time validation and error feedback for prompt configurations.
2. Session and Data Management
- Topic Management Optimization: Introduced the
maxCollectionTopicssetting, allowing users to customize the maximum number of topics per collection to better organize long-term research.
3. Search and Preferences
- Domain Filters: Added domain filtering options to the search functionality for more precise source screening.
- Report Preferences: Added new report preference options in settings to meet diverse report generation requirements.
4. Interaction Experience Enhancements
- Workflow Progress Bar: Implemented a brand-new Workflow Progress component to display the execution status of research tasks in real-time.
- Global Shortcuts: Implemented "Submit" shortcuts (e.g., Ctrl/Cmd + Enter) across core components to accelerate the operational flow.
- Multi-language Support: Updated localization files with new strings related to prompt customization.
🛠 Technical Optimizations and Refactoring
1. Development Standards and Documentation
- Added
AGENTS.md: Clearly defined the project's coding practices and development guidelines to improve team collaboration efficiency and code quality.
2. Component Refactoring
- Topic Component Refactoring: Optimized form structures and resource handling logic, making topic editing and management more fluid.
- Hydration Optimization: Added
suppressHydrationWarningto thebodyelement to resolve common client-server hydration mismatch warnings in Next.js/React environments.
3. Shortcut Management
- Optimized shortcut management logic in the Header and search result components to ensure interaction consistency.
📦 Impact Scope
- API Endpoints: Added the optional
promptOverridesparameter todeep-researchrelated APIs. - UI Interface: New "Prompt Customization" and "Max Topics" configuration items in the settings page; added import/export buttons to the top navigation bar.
- Configuration: Developers are encouraged to refer to
AGENTS.mdwhen updating their local development environments.
Thanks to @jamesbmour for contributing code to this project! Please provide feedback in the Issues list if you have any questions or suggestions.
项目版本更新说明
📢 版本摘要
本次更新带来了重大的功能增强,核心聚焦于 Deep Research API 的高度自定义能力、会话管理优化以及用户交互体验的全面提升。通过引入自定义提示词机制,开发者和高级用户现在可以深度定制 AI 的生成逻辑;同时,新增的会话导入导出与快捷键支持,显著提升了工作流效率。
🚀 新增特性
1. Deep Research 提示词自定义 (Prompt Overrides)
这是本次更新的核心功能,赋予了用户对 AI 生成内容的完全控制权。
- 配置接口: 在
Config接口中引入promptOverrides,支持用户自定义内置提示词模板。 - API 支持: SSE API 路由现已支持解析提示词覆盖参数,并集成了严格的校验与错误处理机制。
- 全链路集成:
KnowledgeGraph(知识图谱)、FinalReport(最终报告)及useDeepResearch钩子均已适配自定义提示词。 - 动态生成: 增强了提示词生成函数,支持根据用户定义的模板动态构建内容。
- 设置界面: 在设置面板中新增 JSON 输入区域,支持实时校验提示词配置并提供错误反馈。
2. 会话与数据管理
- 主题管理优化: 引入
maxCollectionTopics设置,允许用户自定义集合主题的最大数量,优化长效研究的主题组织。
3. 搜索与偏好设置
- 领域过滤器: 搜索功能新增域名过滤选项,支持更精准的资料来源筛选。
- 报告偏好: 设置中新增报告偏好选项,满足不同场景下的报告生成需求。
4. 交互体验提升
- 工作流进度条: 实现全新的 Workflow Progress 组件,实时展示研究任务的执行状态。
- 全局快捷键: 在多个核心组件中实现了“提交”快捷键(如 Ctrl/Cmd + Enter),加速操作流。
- 多语言支持: 更新本地化文件,新增了与提示词自定义相关的多语言词条。
🛠 技术优化与重构
1. 开发规范与文档
- 新增
AGENTS.md: 明确定义了项目的代码实践与开发指南,旨在提升团队协作效率与代码质量。
2. 组件重构
- Topic 组件重构: 优化了表单结构,提升了资源处理逻辑,使主题编辑与管理更加流畅。
- Hydration 优化: 在
body元素中添加了suppressHydrationWarning,解决了 Next.js/React 环境下常见的客户端-服务端水合不一致警告。
3. 快捷键管理
- 优化了 Header 和搜索结果组件中的快捷键管理逻辑,确保交互的一致性。
📦 影响范围
- API 接口:
deep-research相关 API 新增可选参数promptOverrides。 - UI 界面: 设置页面新增“提示词自定义”与“主题上限”配置项;顶部导航栏新增导入导出按钮。
- 配置文件: 建议开发者参考
AGENTS.md更新本地开发环境。
感谢 @jamesbmour 对本项目的代码贡献 !如有任何问题或建议,请在 Issue 列表中反馈。