Skip to content

Releases: rozx/Tsukuyomi

Release v0.9.2

18 Feb 02:46
33ea3b7

Choose a tag to compare

发布说明 - v0.9.2

版本信息

  • 版本号: 0.9.2
  • 发布日期: 2026年2月17日
  • 基于版本: v0.9.1

🤖 AI 翻译引擎重构 (AI Translation Engine Refactor)

v0.9.2 对 AI 翻译、润色、校对的核心执行逻辑进行了大规模重构,显著提升了稳定性、可维护性和翻译质量。

通用文本任务处理器 (Text Task Processor)

  • 新增 text-task-processor.ts 核心模块,将翻译、润色、校对三类服务的公共逻辑抽象统一:
    • 段落过滤与有效性校验
    • 分块 (chunk) 构建与重建
    • AI 降级检测与自动重试(最多 2 次)
    • 已处理段落 ID 跟踪,防止重复提交
    • 章节摘要自动触发(翻译完成后后台生成)
    • 前一章节摘要注入翻译提示词
  • 翻译、润色、校对服务代码量大幅缩减,统一走 processTextTask 入口。

AI 任务状态机优化 (Task State Machine)

  • 新增 preparing 状态:AI 在提交翻译前先进行规划确认,减少无效工具调用。
  • 优化任务执行循环,支持多阶段状态转换(preparing → processing → end)。
  • 翻译工具现在要求携带 aiModelId,提升工具调用可追溯性。

批量翻译工具增强 (Translation Tools)

  • add_translation_batch 工具响应增强:优先使用 accepted_paragraphs 字段进行结果规范化,提升重试逻辑的准确性。
  • 翻译提交前校验:相同文本内容检测、引号平衡校验,减少低质量提交。
  • 支持 2 倍 maxBatchSize 弹性处理短分块,提升短章节翻译效率。

AI 待办事项提醒 (Todo Reminder)

  • 新增 AI 任务内的待办事项辅助工具(todo_reminder):
    • 翻译批次提交后自动触发待办提醒。
    • 任务进入 review 状态时提醒待办事项。
    • 仅在有未完成待办时返回,减少 token 消耗。

📊 翻译进度面板升级 (Translation Progress Panel)

工具调用可视化增强

  • 工具调用 ([调用工具: ...]) 现在带有状态色彩标记:
    • 运行中:旋转齿轮图标
    • 成功:绿色勾选图标
    • 警告:黄色警告图标
    • 失败:红色错误图标
    • 已取消:禁止图标
  • 工具结果 ([工具结果: ...]) 提供智能预览:
    • 自动检测成功/警告/失败状态
    • 支持弹出层 (Popover) 查看完整 JSON 结果
    • JSON 内容自动格式化展示

章节过滤功能

  • 新增仅显示当前章节切换按钮,可将任务历史筛选为当前选中章节的任务。
  • 过滤状态持久化保存。

进度显示优化

  • 进度条与任务卡片绑定,直接在任务卡片内显示当前分块进度。
  • 移除了独立的"正在翻译章节"顶部区域,改为在任务列表中统一展示。
  • 清除按钮和过滤按钮移至顶部操作栏,布局更清晰。

🕷️ 小说抓取增强 (Novel Scraper)

  • 抓取对话框 (NovelScraperDialog) 重构,支持预览、选择章节后一键导入/更新。
  • 改进了抓取进度展示与错误提示。
  • 加载状态优化:卷列表 (VolumesList) 和书籍详情页支持章节内容懒加载 loading 状态。

🔧 系统与工具优化

章节标题规范化

  • 扩展章节标题规范化逻辑,支持纯数字格式(如 123)和符号 + 数字格式(如 ○123)。

AI 模型配置

  • 新增 maxOutputTokens 字段(原 maxTokens 重命名为 maxInputTokens),UI 中显示为"上下文窗口"。
  • Gemini 和 OpenAI 服务支持自定义 temperature 配置。

数据同步服务

  • 新增 SyncDataService,支持跨设备数据同步(Gist 等)的基础架构。

路由与导航

  • 新增 Quasar LoadingBar 插件,路由切换时显示顶部加载进度条。
  • 章节工具栏水平对齐样式优化。

JSON 修复

  • 引入 jsonrepair 库,自动修复 AI 返回的格式错误 JSON,减少工具调用失败率。

📝 问题修复

  • 修复:翻译批次验证失败时防止部分段落被意外写入。
  • 修复:校对/润色任务不再影响未翻译段落。
  • 修复:ask_user 工具调用在跳过模式下的正确行为。
  • 修复:AI 任务类型徽章 (badge) 在部分主题下绝对定位异常。
  • 修复:进度追踪改为基于分块数量而非段落数量,避免进度条跳跃。
  • 修复:翻译提交时保留重复翻译选择的语义。
  • 修复:待办提醒在没有未完成项时不再返回空内容。

📚 相关文档

  • AI 翻译功能: help/book-details-translation.md
  • 聊天助手指南: help/chat-assistant-guide.md
  • AI 模型配置: help/ai-models-guide.md

本文档基于 git changes v0.9.1..v0.9.2

Release v0.9.1

09 Feb 01:18

Choose a tag to compare

发布说明 - v0.9.1

版本信息

  • 版本号: 0.9.1
  • 发布日期: 2026年2月8日
  • 基于版本: v0.9.0

🚀 快速入门与引导 (Quick Start & Onboarding)

v0.9.1 致力于优化新用户的首次体验。我们新增了全新的快速入门向导,帮助您在几分钟内掌握 Tsukuyomi 的核心功能。

  • 首次启动弹窗 (First Launch Popup): 简洁直观的欢迎界面,引导您快速导入第一本书或了解核心概念。
  • 快速入门指南 (Quick Start Guide): 全新的文档 help/front-page.md,图文并茂地介绍了如何开始您的第一次 AI 翻译之旅。

🤖 AI 智能助手增强 (AI Assistant Enhancements)

  • AI 帮助查询 (AI Help Query): 遇到不懂的功能?直接在聊天框询问 AI!通过新增的 search_help_docsread_help_doc 工具,AI 现在能够检索内部文档库,为您提供准确的操作指导。
  • 任务状态循环优化: 改进了 AI 任务执行的状态机循环,提升了长任务(如全书翻译)的稳定性和错误恢复能力。

🧹 系统优化 (System Optimization)

  • 服务端代码清理: 移除了旧版的 proxy-server 及相关服务端组件,显著精简了项目结构,专注于纯客户端体验。
  • 依赖升级: 更新了核心依赖库,提升安全性和性能。

📱 移动端体验升级 (Mobile & Responsive Design)

  • 全新移动端视图 (New Mobile View): 针对手机和平板设备进行了全面的界面适配。
  • 响应式布局: 书籍列表、阅读界面和工具栏现在能够根据屏幕尺寸自动调整,提供更流畅的移动阅读和管理体验。

📝 问题修复

  • 修复了帮助文档索引结构的问题。
  • 优化了移动端和窄屏设备下的显示效果。

📚 相关文档

  • 快速入门: help/front-page.md
  • AI 助手指南: help/chat-assistant-guide.md

本文档由自动化工具生成,基于 git changes v0.9.0..v0.9.1

Release v0.9.0

07 Feb 09:25

Choose a tag to compare

发布说明 - v0.9.0

版本信息

  • 版本号: 0.9.0
  • 发布日期: 2026年2月6日
  • 基于版本: v0.8.4

🌟 核心更新:Agentic AI 智能体架构

v0.9.0 是 Tsukuyomi 进化史上最重要的里程碑。我们引入了全新的 Agentic AI 架构,从根本上改变了与 AI 的交互方式。AI 不再只是一个被动的回答者,而是一个能够主动思考、规划并执行复杂任务的智能助手。

  • 思考过程 (Thinking Process): AI 现在会展示其思考、分析和决策的完整过程,让您了解它为何做出某些决定。
  • 工具调用循环 (Tool Use Loop): AI 具备了自主调用工具的能力。它可以在回答您的问题前,主动搜索帮助文档、读取书籍内容、查询记忆库,甚至连续执行多步操作以完成复杂任务。
  • 状态机驱动的任务运行器: 引入了基于状态机的任务执行系统,大幅提升了 AI 任务(如翻译、润色)的稳定性和可观测性。

🎉 新功能

1. 全新书籍管理系统 (New Books Management)

  • 书籍列表页 (BooksPage): 完全重构的书籍管理界面,支持卡片式展示和网格布局。
  • 多维搜索与排序: 支持按标题、作者、标签等字段搜索,并提供 12 种排序方式(如按更新时间、章节数、字数等)。
  • Web 抓取器 (Web Scraper): 新增 NovelScraperDialog,支持从 Syosetu, Kakuyomu 等源站一键抓取小说。
    • 智能章节筛选: 在导入前预览章节列表,支持勾选、全选或按索引范围灵活导入。
  • 批量操作: 支持批量章节摘要生成,自动跳过已处理章节。

2. 专业级翻译工作流 (Advanced Translation Workflow)

  • 润色与校对服务: 新增独立的 润色 (Polishing)校对 (Proofreading) 任务类型,配合专用 Prompt,提供出版级的内容优化。
  • 翻译进度面板: 全新的 TranslationProgress 组件,提供毫秒级的任务进度反馈、实时日志流和中断控制。
  • 智能上下文构建: 翻译任务现在会自动检索并注入相关的 术语表角色设定记忆片段,显著解决长篇小说翻译中的"遗忘"和"不一致"问题。

3. 记忆系统 2.0 (Memory System 2.0)

  • 记忆附件 (Attachments): 记忆条目现在支持附件,AI 可以读取更丰富的背景资料。
  • 引用可视化: 阅读界面新增 记忆引用计数悬浮预览,直观展示当前章节与哪些记忆点强相关。
  • 全面管理: 新增记忆管理面板,支持增删改查、搜索和列表视图,方便维护庞大的世界观设定。

4. 智能助手与帮助系统

  • AppRightPanel: 全新的右侧面板,集成了 AI 聊天、工具调用和上下文管理。
  • 应用内帮助系统: 内置完整的 Markdown 帮助文档库。
  • AI 文档导航: 遇到问题直接问 AI,它会自动搜索内部文档并给出精准解答。

🔧 改进与优化

核心算法与性能

  • 动态规划引号配对: 引入 DP 算法重写了翻译规范化器,精准解决翻译中常见的引号不匹配、嵌套错误问题。
  • Schema 优化 (-20% Token): 重构了 AI 输出的数据结构,通过短键名映射和整数索引优化,减少了约 20% 的 Token 消耗,同时提升了生成速度。
  • 空白内容过滤: 自动检测并跳过空白或仅含标点的段落,避免无效的 AI 调用。
  • 并发控制: 优化了批量翻译的并发限制(调整为 30),在速度和稳定性之间取得更好平衡。

构建与开发体验

  • macOS 完善支持: 完整的 Electron 构建流程,包含代码签名 (Code Signing)、公证 (Notarization) 和权限配置。
  • 类型安全: 全面增强了代码库的 TypeScript 类型定义,特别是针对 Electron 菜单和 AI 工具调用。
  • 图标管理: 集成 Quasar Icon Genie,统一管理多平台图标资源。

🐛 问题修复

  • 修复了 quote pairing 算法在处理复杂嵌套引号时的逻辑错误。
  • 修复了 AI 任务在网络波动下的状态同步异常。
  • 修复了书籍列表页在移动端和超宽屏下的布局错位问题。
  • 修复了批量翻译时偶发的任务卡死问题。
  • 解决了一些组件的内存泄漏隐患。

📝 技术细节

代码统计

  • 变更文件: 406 个文件
  • 代码增减: +50,486 行 / -12,953 行
  • 主要新增模块:
    • src/services/ai/agent/: Agentic AI 核心架构
    • src/services/ai/tasks/: 专用任务服务(翻译/润色/校对)
    • src/components/books/: 新版书籍管理 UI
    • src/utils/text-matcher.ts: 高级文本匹配算法

架构变更

  • 引入 TaskRunner 类管理长运行任务。
  • 拆分 AIProcessingStore 为更细粒度的状态管理。
  • 实现 ToolRegistry pattern 用于 AI 工具扩展。

🎯 用户体验改进

  1. 可视化思考: 看着 AI "思考"是一种全新的体验,让你对结果更具信心。
  2. 无缝导入: 从"复制链接"到"开始阅读"的流程被缩短到极致,章节筛选功能让导入更加随心所欲。
  3. 掌控感: 详细的进度条和日志,让你不再对着加载动画发呆,清楚知道 AI 正在翻译哪一段。
  4. 上下文感知: 在阅读时随时查看关联的记忆和设定,不再为"这个人物是谁"困扰。

🔄 升级建议

强烈建议所有用户升级到 v0.9.0

这个版本不仅仅是功能的增加,更是底层架构的质变。Agentic AI 的引入为未来更强大的自动化功能奠定了基础。新的翻译和记忆系统将显著提升您的阅读和创作体验。


📚 相关文档

  • 新手入门: help/front-page.md
  • 书籍列表指南: help/books-page-guide.md
  • AI 翻译详解: help/book-details-translation.md
  • 记忆系统指南: help/book-details-memory.md

🙏 致谢

感谢所有测试人员和反馈贡献者。特别感谢社区对新 AI 架构的建议。


本文档由自动化工具生成,基于 git diff v0.8.4..v0.9.0

Release v0.8.4

19 Jan 06:07
079c491

Choose a tag to compare

发布说明 - v0.8.4

版本信息

  • 版本号: 0.8.4
  • 发布日期: 2026年1月19日
  • 基于版本: v0.8.3

🎉 新功能

1. 批量章节摘要 (Batch Chapter Summary)

  • 批量处理面板: 新增 BatchSummaryPanel 组件,支持一键为全书或选定章节生成缺失的摘要。
  • 实时进度反馈: 支持显示当前正在处理的章节标题及整体进度。
  • 任务控制: 集成 AbortController,支持用户随时安全终止批量生成任务。
  • 智能过滤: 自动识别并仅处理缺失摘要的章节,避免重复消耗 AI 额度。
  • 章节摘要服务: 新增 chapter-summary-service.ts,提供专门的章节摘要生成功能。

2. AI 用户交互工具 (Ask User Tools)

  • 用户提问对话框: 新增 AskUserDialog 组件,支持 AI 向用户提出结构化问题。
  • 批量提问工具: 实现批量用户提问功能,支持一次性向用户询问多个相关问题。
  • 跳过设置: 新增"跳过 AI 询问用户"设置选项,允许用户在不需要时禁用此功能。
  • 异步处理: 完整的异步处理机制,支持 Promise 风格的交互流程。

3. 记忆管理增强

  • 记忆列表工具: 新增 list_memories 工具,支持分页和排序查看 Memory 记录。
  • 记忆同步增强: 改进记忆数据的同步逻辑和 UI 刷新机制。
  • 记忆导入: 在 Electron 设置中实现记忆数据导入功能。
  • 记忆服务: 新增 memory-service.ts,提供统一的记忆管理服务。

4. 全局配置缓存

  • 配置缓存服务: 新增 global-config-cache.ts,提供全局配置的缓存机制。
  • 性能优化: 减少重复的配置读取操作,提升应用性能。

5. AI 任务上下文管理增强

  • 关联信息注入: 在翻译、润色、校对和摘要任务中,自动注入相关的术语表和角色设定信息,显著提升 AI 生成内容的准确性和一致性。
  • 通用助手工具: 引入 ai-task-helper 模块,统一管理 AI 任务的上下文构建、模型选择和错误处理逻辑。
  • 提示词优化: 针对章节摘要任务优化了 Prompt,使其更能捕捉章节的核心剧情。

6. 润色和校对服务增强

  • 润色服务: 新增专门的润色服务,提供文本润色功能。
  • 校对服务: 重构校对服务,增强校对背景信息和上下文支持。
  • 术语翻译服务: 新增术语翻译服务,支持术语的自动翻译。

7. 段落位置工具

  • 段落位置获取: 新增 get_paragraph_position 工具,支持获取段落在文档中的位置。
  • CJK 工具重构: 优化中日韩字符处理工具。

8. OpenSpec 工作流

  • 提案工作流: 新增 OpenSpec 提案创建工作流。
  • 应用工作流: 新增 OpenSpec 应用工作流。
  • 归档工作流: 新增 OpenSpec 归档工作流。
  • 项目文档: 新增 openspec/project.md,详细说明项目结构和规范。

9. 代码审查工作流

  • 代码审查流程: 新增代码审查工作流,支持全面的代码审查。
  • 版本发布准备: 新增版本发布准备工作流。

10. 上下文菜单管理

  • 上下文菜单: 新增 useContextMenuManager composable,提供统一的上下文菜单管理。
  • 右键菜单: 在 ParagraphCard 组件中集成上下文菜单功能。

🔧 改进与优化

UI/UX 体验

  • 思考过程面板: 优化 ThinkingProcessPanel 组件的消息处理和滚动性能。
  • 同步状态防抖: 为顶部状态栏的同步倒计时添加了防抖逻辑,避免高频更新导致的界面微颤和性能开销。
  • 摘要生成交互: 优化了单个章节摘要生成后的 UI 自动刷新机制,无需手动刷新即可看到新生成的摘要。
  • 书籍详情页: 在批量摘要入口处直观显示当前书籍标题及待处理章节数。
  • 右侧面板: 扩展 AppRightPanel 组件,支持更多面板类型。
  • 翻译进度: 改进 TranslationProgress 组件的进度显示和交互。
  • 章节设置: 重构 ChapterSettingsPopover 组件,改进用户界面。
  • 章节内容面板: 增强 ChapterContentPanel 组件的功能。

AI 服务优化

  • 提示词增强: 为翻译、润色、校对任务添加严格的输出规则。
  • 消息总结: 增强消息总结功能。
  • 搜索替换: 改进搜索替换功能。
  • 思考过程优化: 优化思考过程的处理和缓存机制。
  • OpenAI 服务: 更新 OpenAI max tokens 限制和验证逻辑。

数据同步优化

  • 同步数据服务: 扩展 sync-data-service.ts,支持更多数据类型的同步。
  • Gist 同步: 改进 GitHub Gist 同步服务。
  • 自动同步: 增强自动同步触发机制。

代码质量与性能

  • 异步控制优化: 核心 AI 服务全面采用异步流式处理及可中断机制,提升应用响应速度。
  • Vue 模板优化: 清理了部分组件中的冗余事件监听和计算属性。
  • 滚动节流: 为滚动更新实现节流机制,提升 UI 性能。
  • 工具结果截断: 移除 TOOL_RESULT_MAX_LENGTHStruncateToolResult 函数,简化代码。

任务流程优化

  • 状态机更新: 将任务状态从 'completed' 更新为 'review'。
  • 润色校对跳过: 更新润色和校对服务,跳过已完成阶段。

开发体验

  • 开发指南: 新增 CLAUDE.md 文档,提供开发指南。
  • 代理规则: 添加规则强制使用中文进行思考和输出。
  • Git 忽略: 更新 .gitignore 文件,清理调试日志。
  • VSCode 任务: 新增 VSCode 任务配置。

🐛 问题修复

核心功能修复

  • 章节排序修复: 修复了章节列表中拖拽排序可能导致的位置偏移问题。
  • 摘要显示修复: 修复了某些情况下生成摘要后面板标题显示空白的 Bug。
  • 内存泄漏预防: 增强了 AI 任务销毁时的资源清理。
  • ESLint 问题: 修复 AI processing store 中的 no-this-alias 问题。
  • 测试修复: 更新 ask_user 工具测试以正确处理 Promise 解析。

📝 技术细节

主要新增文件

  • src/components/novel/BatchSummaryPanel.vue: 批量摘要管理面板 (326 行)
  • src/components/dialogs/AskUserDialog.vue: 用户提问对话框 (354 行)
  • src/services/ai/tasks/chapter-summary-service.ts: 章节摘要服务 (262 行)
  • src/services/ai/tools/ask-user-tools.ts: 用户提问工具 (312 行)
  • src/services/global-config-cache.ts: 全局配置缓存 (174 行)
  • src/services/memory-service.ts: 记忆服务 (177 行)
  • src/stores/ask-user.ts: 用户提问状态管理 (340 行)
  • src/composables/useContextMenuManager.ts: 上下文菜单管理 (171 行)
  • openspec/: OpenSpec 工作流文档和规范
  • docs/ReleaseNotes/RELEASE_NOTES_v0.8.4.md: 发布说明

主要修改文件

  • src/services/ai/tasks/utils/ai-task-helper.ts: AI 任务辅助工具重构 (740 行优化)
  • src/services/ai/tasks/term-translation-service.ts: 术语翻译服务重构 (394 行删除)
  • src/components/layout/AppRightPanel.vue: 右侧面板扩展 (369 行改进)
  • src/components/novel/ChapterSettingsPopover.vue: 章节设置重构 (282 行改进)
  • src/components/novel/TranslationProgress.vue: 翻译进度改进 (116 行改进)
  • src/services/ai/tasks/proofreading-service.ts: 校对服务重构 (216 行改进)
  • src/services/ai/tasks/polish-service.ts: 润色服务增强 (52 行改进)
  • src/services/ai/tasks/translation-service.ts: 翻译服务增强 (37 行改进)
  • src/services/ai/tasks/prompts/index.ts: 提示词增强 (150 行改进)
  • src/services/ai/tools/memory-tools.ts: 记忆工具增强 (140 行改进)
  • src/services/ai/tools/paragraph-tools.ts: 段落工具增强 (209 行改进)
  • src/services/sync-data-service.ts: 同步数据服务扩展 (184 行改进)
  • src/stores/ai-processing.ts: AI 处理状态管理增强 (228 行改进)
  • src/components/ai/ThinkingProcessPanel.vue: 思考过程面板优化 (130 行改进)

新增测试文件

  • src/__tests__/ask-user-store.test.ts: 用户提问状态管理测试 (93 行)
  • src/__tests__/ask-user-tools.no-ui.test.ts: 用户提问工具测试 (166 行)
  • src/__tests__/memory-tools.list-memories.test.ts: 记忆列表工具测试 (111 行)
  • src/__tests__/sync-data-service.test.ts: 同步数据服务测试 (327 行)
  • src/__tests__/ai-task-helper.executeToolCallLoop.test.ts: AI 任务助手测试扩展 (237 行改进)
  • src/__tests__/ai-task-helper.truncateToolResult.test.ts: 删除 (574 行删除)

OpenSpec 变更提案

  • openspec/changes/batch-chapter-summary/: 批量章节摘要功能
  • openspec/changes/archive/2026-01-19-add-ai-ask-user-tool/: AI 用户提问工具
  • openspec/changes/archive/2026-01-19-add-ask-user-batch-tool/: 批量用户提问工具
  • openspec/changes/archive/2026-01-19-add-chapter-summary/: 章节摘要功能
  • openspec/changes/archive/2026-01-19-add-global-config-cache/: 全局配置缓存
  • openspec/changes/archive/2026-01-19-add-list-memories-tool/: 记忆列表工具
  • openspec/changes/archive/2026-01-19-add-skip-ai-ask-user-setting/: 跳过 AI 询问用户设置
  • openspec/changes/archive/2026-01-19-update-completed-state-to-review/: 更新任务状态
  • openspec/changes/archive/2026-01-19-update-polish-proofreading-skip-completed-stage/: 更新润色校对跳过逻辑

代码统计

  • 新增功能: 10 大项
  • 改进优化: 5 类
  • 问题修复: 5 类
  • 代码变更: 9,424 行新增,2,026 行删除
  • 修改文件: 138 个文件
  • 新增测试: 约 697 行测试代码
  • OpenSpec 提案: 9 个变更提案

🎯 用户体验改进

  1. 更强大的批量能力: 告别逐章点击,一键完成整本书的摘要提取,极大提升创作效率。
  2. 更聪明的 AI: 现在的 AI 能够"记住"你的术语和角色设定,无论是翻译还是写摘要都更具专业性。
  3. 更顺畅的界面: 修复了烦人的拖拽偏移问题,同步倒计时也变得更加静默优雅。
  4. 更好的交互: 新增 AI 用户交互工具,AI 可以主动向用户提问,获取更准确的信息。
  5. 更完善的记忆管理: 支持记忆的查看、同步和导入,AI 的记忆更加可控。
  6. 更高的性能: 全局配置缓存和滚动节流优化,提升应用响应速度。
  7. 更规范的流程: OpenSpec 工作流和代码审查工作流,提升开发质量。

🔄 升级建议

本次更新重点提升了 AI 创作效率内容一致性用户体验

建议所有深度使用 AI 功能的用户升级,尤其是:

  • 拥有大量章节需要整理摘要的用户。
  • 对翻译一致性(词汇、角色)有较高要求的用户。
  • 需要 AI 主动提问获取信息的用户。
  • 关注应用性能和响应速度的用户。

📚 相关文档

  • 项目架构文档:CLAUDE.md
  • 翻译指南:docs/TRANSLATION_GUIDE.md
  • 主题指南:docs/THEME_GUIDE.md
  • 批量替换示例:docs/batch-replace-examples.md
  • AI 任务流程文档:docs/TRANSLATION_AI_TASK_FLOW.md
  • 流程改进建议:docs/TRANSLATION_AI_TASK_FLOW_IMPROVEMENTS.md
  • OpenSpec 项目文档:openspec/project.md
  • OpenSpec 代理指南:openspec/AGENTS.md
  • v0.8.3 发布说明:docs/ReleaseNotes/RELEASE_NOTES_v0.8.3.md

🙏 致谢

感谢所有在本次版本开发中提供反馈和建议的伙伴们。


本文档由自动化工具生成,基于 git diff v0.8.3..v0.8.4-chapter-summary

Release v0.8.3

07 Jan 00:55
4bd967b

Choose a tag to compare

发布说明 - v0.8.3

版本信息

  • 版本号: 0.8.3
  • 发布日期: 2026年1月6日

🎉 新功能

1. AI 网络搜索功能

  • Tavily API 集成
    • 新增 Tavily API Key 设置选项,支持网络搜索功能
    • 集成 Tavily 搜索服务到 AI 工具链
    • 改进搜索工具的代码结构,提升可维护性
  • 搜索功能优化
    • 重构网络搜索工具 (570 行代码优化)
    • 简化搜索工具的参数和调用流程
    • 增强搜索结果的格式化和展示
  • API 密钥管理
    • 新增独立的 API 密钥设置标签页
    • 支持多种 AI 服务的密钥集中管理
    • 改进密钥的安全存储和验证

2. AI 记忆管理面板

  • MemoryPanel 组件
    • 新增记忆管理面板组件 (667 行新增代码)
    • 支持查看和管理 AI 记忆内容
    • 提供记忆的增删改查功能
  • 记忆服务增强
    • 新增记忆服务导出功能 (44 行新增)
    • 支持记忆数据的批量导入导出
    • 优化记忆检索和展示逻辑
  • 快捷键集成
    • 新增记忆面板快捷键支持
    • 改进快捷键冲突处理
  • 书籍详情页重构
    • 大幅重构书籍详情页布局 (868 行优化)
    • 集成记忆管理和术语管理面板
    • 改进页面组件的组织结构

3. 内容变更智能保存

  • 跳过未更改内容
    • 新增 skipIfUnchanged 逻辑,避免保存未更改的内容
    • 减少不必要的数据库写入操作
    • 提升章节保存性能
  • 变更检测增强
    • 增强内容变更检测机制
    • 支持段落级别的变更追踪
    • 改进翻译持久化逻辑
  • 翻译工具优化
    • 优化段落工具的更新逻辑
    • 改进章节内容保存流程
    • 减少冗余的更新操作

4. 同步数据服务增强

  • 记忆数据同步
    • 新增记忆数据同步功能 (159 行新增)
    • 支持记忆的远程存储和同步
    • 改进同步冲突检测和解决
  • 导入导出优化
    • 增强数据导入导出功能
    • 支持记忆数据的备份和恢复
    • 改进数据格式验证
  • 自动同步增强
    • 改进自动同步触发机制
    • 优化同步上传冲突检查
    • 增强同步状态反馈

5. 项目文档完善

  • CLAUDE.md
    • 新增项目开发指南文档 (227 行新增)
    • 详细说明项目架构和开发规范
    • 提供 AI 服务的开发指导
  • 开发指南
    • 完善常用命令和开发流程说明
    • 添加核心子系统架构说明
    • 提供重要的开发注意事项

🔧 改进与优化

UI 组件优化

  • ThinkingProcessPanel
    • 优化滚动行为,提升阅读体验 (165 行改进)
    • 改进内容展示和布局
    • 增强面板的交互反馈
  • TerminologyPanel
    • 优化术语面板组件 (170 行改进)
    • 改进术语列表的展示
    • 增强术语管理功能
  • SettingsDialog
    • 改进设置对话框布局 (109 行改进)
    • 优化设置选项的组织结构
    • 增强设置的可用性

AI 服务优化

  • Prompt 优化
    • 改进 AI 任务提示词 (10 行改进)
    • 优化提示词结构和内容
    • 提升 AI 响应质量
  • 章节翻译增强
    • 改进章节翻译逻辑 (122 行改进)
    • 优化翻译状态管理
    • 增强翻译进度反馈
  • 内容服务优化
    • 优化章节内容服务 (82 行改进)
    • 改进内容加载和保存流程
    • 增强数据一致性保障

设置管理优化

  • 设置服务增强
    • 优化设置服务 (97 行改进)
    • 改进设置的加载和保存逻辑
    • 增强设置验证和错误处理
  • 设置模型扩展
    • 扩展设置数据模型 (5 行新增)
    • 支持更多配置选项
    • 优化设置数据结构

数据同步优化

  • Gist 同步增强
    • 改进 GitHub Gist 同步服务 (27 行改进)
    • 优化同步上传逻辑
    • 增强同步错误处理
  • 同步数据服务
    • 扩展同步数据服务功能
    • 支持更多数据类型的同步
    • 优化同步性能

🐛 问题修复

内容保存修复

  • 未更改内容处理
    • 修复内容未更改时仍执行保存的问题
    • 减少不必要的数据库操作
    • 提升保存性能

同步修复

  • 记忆同步
    • 修复记忆数据同步失败的问题
    • 改进同步冲突的处理逻辑
    • 增强同步的稳定性

📝 技术细节

主要修改文件

  • src/components/novel/MemoryPanel.vue:新增记忆管理面板 (667 行新增)
  • src/pages/BookDetailsPage.vue:书籍详情页重构 (868 行优化)
  • src/services/ai/tools/web-search-tools.ts:网络搜索工具重构 (570 行优化)
  • src/services/sync-data-service.ts:同步数据服务扩展 (159 行新增)
  • src/components/ai/ThinkingProcessPanel.vue:思考过程面板优化 (165 行改进)
  • src/composables/book-details/useChapterTranslation.ts:章节翻译逻辑增强 (122 行改进)
  • src/services/settings-service.ts:设置服务优化 (97 行改进)
  • src/components/novel/TerminologyPanel.vue:术语面板优化 (170 行改进)
  • src/components/dialogs/SettingsDialog.vue:设置对话框改进 (109 行改进)
  • src/services/chapter-content-service.ts:章节内容服务优化 (82 行改进)
  • src/components/settings/ApiKeysSettingsTab.vue:新增 API 密钥设置标签 (92 行新增)
  • src/components/settings/ImportExportTab.vue:导入导出标签增强 (40 行改进)
  • src/services/gist-sync-service.ts:Gist 同步服务改进 (27 行改进)
  • src/composables/useAutoSync.ts:自动同步增强 (7 行改进)
  • src/composables/useGistUploadWithConflictCheck.ts:同步上传检查优化 (9 行改进)
  • src/models/settings.ts:设置模型扩展 (5 行新增)
  • src/stores/settings.ts:设置存储优化 (7 行改进)
  • src/services/ai/tools/index.ts:AI 工具注册更新 (11 行改进)
  • src/services/ai/tools/paragraph-tools.ts:段落工具优化 (13 行改进)
  • src/services/memory-service.ts:记忆服务扩展 (44 行新增)
  • src/services/ai/tasks/prompts/index.ts:提示词优化 (10 行改进)
  • CLAUDE.md:项目开发指南新增 (227 行新增)

新增测试文件

  • src/__tests__/chapter-content-service.test.ts:章节内容服务测试扩展 (60 行新增)

代码统计

  • 新增功能: 5 项
  • 改进优化: 5 类
  • 问题修复: 2 类
  • 代码变更: 约 2,437 行新增,2,419 行删除
  • 修改文件: 22 个文件
  • 新增测试: 约 60 行测试代码

🎯 用户体验改进

  1. AI 能力增强:集成 Tavily 网络搜索功能,AI 可以获取实时信息进行翻译和回答
  2. 记忆管理可视化:新增记忆管理面板,用户可以直观查看和管理 AI 记忆内容
  3. 性能提升:智能跳过未更改内容的保存,减少不必要的数据库操作
  4. 同步功能增强:支持记忆数据的同步,数据备份更加完善
  5. 界面优化:重构书籍详情页布局,改进面板组织和交互体验
  6. 文档完善:新增 CLAUDE.md 开发指南,帮助开发者快速了解项目
  7. 设置管理改进:独立的 API 密钥设置页面,管理更加便捷
  8. 滚动体验优化:思考过程面板滚动行为优化,阅读更流畅

🔄 升级建议

本次更新主要聚焦于:

  1. AI 功能扩展:新增网络搜索功能,AI 可以获取最新信息进行翻译
  2. 记忆管理:新增可视化记忆管理面板,方便用户管理 AI 记忆
  3. 性能优化:智能保存逻辑减少不必要的操作,提升性能
  4. 数据同步增强:记忆数据支持同步,数据备份更完善
  5. 开发体验:完善项目文档,帮助新开发者快速上手

建议所有用户升级以获得更好的使用体验。特别是对于:

  • 需要 AI 获取实时信息的用户,网络搜索功能将非常有用
  • 需要管理 AI 记忆的用户,新的记忆管理面板提供了便捷的操作界面
  • 关注性能的用户,智能保存逻辑将提升操作响应速度

📚 相关文档

  • 项目架构文档:CLAUDE.md
  • 翻译指南:docs/TRANSLATION_GUIDE.md
  • 主题指南:docs/THEME_GUIDE.md
  • 批量替换示例:docs/batch-replace-examples.md
  • AI 任务流程文档:docs/TRANSLATION_AI_TASK_FLOW.md
  • 流程改进建议:docs/TRANSLATION_AI_TASK_FLOW_IMPROVEMENTS.md
  • v0.8.2 发布说明:docs/ReleaseNotes/RELEASE_NOTES_v0.8.2.md

🙏 致谢

感谢所有为本次版本做出贡献的开发者和测试人员。


本文档由自动化工具生成,如有疑问请提交 Issue。

Release v0.8.2

05 Jan 04:04
e3826b3

Choose a tag to compare

发布说明 - v0.8.2

版本信息

  • 版本号: 0.8.2
  • 发布日期: 2026年1月4日

🎉 新功能

1. AI 任务处理增强

  • 实时状态验证
    • 增强 AI 任务处理流程,支持实时状态验证
    • 优化任务状态更新机制,提供更准确的进度反馈
    • 改进任务错误处理和恢复逻辑
  • 工具调用循环优化
    • 增强 executeToolCallLoop 功能,支持更复杂的工具调用场景
    • 优化工具调用参数验证和错误处理
    • 提升工具调用的稳定性和可靠性
  • OpenAI 服务兼容性
    • 增强 OpenAI 服务提供商兼容性
    • 改进工具处理机制,支持更多模型特性
    • 优化 API 调用参数和响应处理

2. 翻译进度组件优化

  • 性能提升
    • 实现节流(throttling)机制,减少不必要的重新渲染
    • 添加缓存功能,优化组件性能
    • 改进进度更新算法,提升响应速度
  • UI 改进
    • 重新组织章节工具栏中的翻译进度按钮位置
    • 优化进度显示效果和动画
    • 改进加载状态和错误提示的展示

3. 设置管理增强

  • 持久化改进
    • 增强设置的持久化机制,确保数据安全保存
    • 优化设置加载和保存流程
    • 改进设置迁移逻辑,支持从旧版本平滑升级
  • 设置存储优化
    • 新增设置存储持久化测试(100+ 行测试代码)
    • 优化设置数据结构,提升存储效率
    • 增强设置验证和错误处理
  • 实时同步
    • 改进 SyncStatusPanel,支持实时更新
    • 优化同步状态显示逻辑
    • 增强同步错误处理和重试机制

4. 章节翻译状态管理

  • 状态追踪增强
    • 增强章节翻译状态管理功能
    • 改进翻译状态的更新和传播机制
    • 优化状态同步逻辑,确保一致性
  • 段落翻译处理
    • 重构 useChapterTranslation 中的段落翻译处理逻辑
    • 改进翻译数据的创建和更新流程
    • 增强翻译状态追踪和错误处理
  • 章节更新优化
    • 改进章节更新逻辑,提升数据一致性
    • 优化章节信息的保存和加载流程

5. 段落导航和选择增强

  • 导航功能
    • 增强段落导航功能,支持更流畅的段落切换
    • 新增段落导航测试(116 行测试代码)
    • 改进段落滚动和定位逻辑
  • 选择高亮优化
    • 改进段落选择高亮效果
    • 优化过渡动画,提升视觉体验
    • 增强选择状态的反馈机制
  • 键盘快捷键
    • 增强键盘快捷键功能(215 行测试代码)
    • 改进快捷键冲突检测和处理
    • 优化快捷键响应速度和准确性

6. 翻译分块配置

  • 任务管理优化
    • 新增翻译分块大小配置选项
    • 支持根据不同场景调整分块大小
    • 改进任务调度和执行效率
  • 性能调优
    • 优化大文件翻译性能
    • 改进内存使用和资源管理
    • 提升翻译任务的处理速度

7. 同步数据服务增强

  • 封面 URL 删除处理
    • 新增封面 URL 删除处理功能
    • 优化同步过程中的资源清理
    • 改进删除操作的错误处理
  • 同步逻辑重构
    • 大幅重构同步数据服务(968 行代码优化)
    • 改进同步算法,提升同步效率
    • 增强同步冲突检测和解决机制
  • 测试覆盖
    • 新增同步数据服务测试(201 行测试代码)
    • 提升同步功能的稳定性和可靠性

8. 翻译规范化增强

  • 日文引号处理
    • 增强日文引号的翻译规范化功能
    • 支持自动识别和转换不同类型的引号
    • 改进引号格式的统一性
  • 翻译改进
    • 优化翻译规范化算法(40 行测试代码)
    • 改进特殊字符和标点符号的处理
    • 增强翻译输出的规范性

9. AI 处理状态存储

  • 新增 AI 处理状态管理
    • 新增 ai-processing Store(107 行代码)
    • 集中管理 AI 任务的处理状态
    • 优化状态更新和传播机制
  • 状态追踪
    • 改进 AI 任务状态的追踪和记录
    • 增强状态持久化功能
    • 优化状态恢复和错误处理

10. 封面历史记录

  • 封面历史管理
    • 新增封面历史记录 Store(16 行代码)
    • 支持封面更换历史追踪
    • 优化封面历史数据的存储和查询

11. 章节导出功能

  • 导出优化
    • 增强章节导出功能
    • 改进导出数据的格式和完整性
    • 优化导出性能和用户体验

12. 加载指示器

  • 加载状态优化
    • 在多个组件中新增加载指示器
    • 改进数据迁移处理的加载状态显示
    • 优化加载动画和用户反馈

🔧 改进与优化

AI 任务服务优化

  • 段落处理增强
    • 增强翻译、润色、校对服务的段落处理功能
    • 改进段落级别的错误处理和重试机制
    • 优化段落数据的创建和更新流程
  • 工具调用优化
    • 改进工具调用参数验证
    • 优化工具调用错误处理
    • 增强工具调用的稳定性和可靠性

组件性能优化

  • BookDetailsPage
    • 优化页面导航和事件处理逻辑(190 行改进)
    • 改进页面加载性能
    • 增强页面交互体验
  • ChapterContentPanel
    • 优化内容面板的渲染性能(84 行改进)
    • 改进滚动和定位功能
    • 增强内容显示效果
  • TranslationProgress
    • 大幅优化翻译进度组件(199 行改进)
    • 实现节流和缓存机制
    • 提升组件响应速度和用户体验

数据持久化优化

  • 设置数据迁移
    • 改进设置数据的迁移处理逻辑
    • 增强迁移过程的错误处理和恢复
    • 优化迁移性能,减少用户等待时间
  • 数据一致性
    • 改进数据同步的一致性检查
    • 增强数据验证和错误恢复
    • 优化数据冲突的解决策略

UI 和用户体验优化

  • 交互体验
    • 改进按钮和工具栏的布局和交互
    • 优化过渡动画效果
    • 增强用户操作的反馈机制
  • 视觉优化
    • 改进段落选择的高亮效果
    • 优化加载和进度指示器的显示
    • 增强错误提示的清晰度和友好性

测试覆盖增强

  • 新增测试文件
    • settings-store.persistence.test.ts:设置存储持久化测试(113 行)
    • paragraph-navigation-scroll.test.ts:段落导航滚动测试(116 行)
    • ai-task-helper.executeToolCallLoop.test.ts:工具调用循环测试(92 行)
    • translation-updates.test.ts:翻译更新测试(45 行)
  • 增强现有测试
    • use-keyboard-shortcuts.test.ts:键盘快捷键测试增强(215 行改进)
    • sync-data-service.test.ts:同步数据服务测试增强(201 行改进)
    • translation-normalizer.test.ts:翻译规范化测试增强(40 行改进)
    • chapter-service.test.ts:章节服务测试增强(19 行改进)

🐛 问题修复

状态管理修复

  • 翻译状态同步
    • 修复章节翻译状态更新不同步的问题
    • 修复段落翻译状态丢失的问题
    • 改进状态的传播和更新机制

UI 修复

  • 按钮布局
    • 修复章节工具栏中按钮位置不合理的问题
    • 优化翻译进度和快捷键按钮的布局
  • 段落选择
    • 修复段落选择高亮不正确的问题
    • 修复段落滚动定位不准确的问题

数据持久化修复

  • 设置保存
    • 修复设置有时无法正确保存的问题
    • 修复设置迁移失败的问题
    • 改进设置数据的完整性验证

AI 任务修复

  • 工具调用
    • 修复工具调用参数不正确的问题
    • 修复工具调用循环中的错误处理问题
  • 任务状态
    • 修复 AI 任务状态更新不及时的问题
    • 修复任务进度显示不准确的问题

📝 技术细节

主要修改文件

  • src/composables/book-details/useChapterTranslation.ts:章节翻译状态管理大幅增强(465 行改进)
  • src/composables/book-details/useParagraphNavigation.ts:段落导航功能增强(214 行改进)
  • src/services/sync-data-service.ts:同步数据服务重构(968 行优化)
  • src/components/novel/TranslationProgress.vue:翻译进度组件性能优化(199 行改进)
  • src/stores/settings.ts:设置管理优化(305 行改进)
  • src/stores/ai-processing.ts:新增 AI 处理状态管理(107 行新增)
  • src/components/novel/ChapterContentPanel.vue:内容面板优化(84 行改进)
  • src/services/ai/tasks/utils/ai-task-helper.ts:AI 任务辅助功能增强(277 行改进)
  • src/pages/BookDetailsPage.vue:书籍详情页优化(190 行改进)
  • src/pages/IndexPage.vue:首页优化(51 行改进)
  • src/composables/book-details/useKeyboardShortcuts.ts:键盘快捷键增强(42 行改进)
  • src/services/ai/providers/openai-service.ts:OpenAI 服务兼容性增强(66 行改进)
  • src/services/ai/tasks/translation-service.ts:翻译服务优化(30 行改进)
  • src/services/ai/tasks/polish-service.ts:润色服务优化(33 行改进)
  • src/services/ai/tasks/proofreading-service.ts:校对服务优化(33 行改进)
  • src/components/novel/ChapterToolbar.vue:章节工具栏优化(26 行改进)
  • src/components/sync/SyncStatusPanel.vue:同步状态面板优化(26 行改进)
  • src/components/novel/ChapterSettingsPopover.vue:章节设置面板增强(26 行改进)
  • src/utils/translation-normalizer.ts:翻译规范化增强(31 行改进)
  • src/utils/translation-updates.ts:新增翻译更新工具(41 行新增)
  • src/models/novel.ts:小说模型增强(7 行改进)
  • src/models/sync.ts:同步模型增强(10 行改进)
  • src/stores/cover-history.ts:新增封面历史记录 Store(16 行新增)

新增测试文件

  • src/__tests__/settings-store.persistence.test.ts:设置存储持久化测试(113 行)
  • src/__tests__/paragraph-navigation-scroll.test.ts:段落导航滚动测试(116 行)
  • src/__tests__/ai-task-helper.executeToolCallLoop.test.ts:工具调用循环测试(92 行)
  • src/__tests__/translation-updates.test.ts:翻译更新测试(45 行)

增强测试文件

  • src/__tests__/use-keyboard-shortcuts.test.ts:键盘快捷键测试增强(215 行改进)
  • src/__tests__/sync-data-service.test.ts:同步数据服务测试增强(201 行改进)
  • src/__tests__/translation-normalizer.test.ts:翻译规范化测试增强(40 行改进)
  • src/__tests__/chapter-service.test.ts:章节服务测试增强(19 行改进)

新增功能统计

  • 新增功能: 12 项
  • 改进优化: 8 项
  • 问题修复: 4 类
  • 代码变更: 约 3,313 行新增,1,059 行删除
  • 修改文件: 48 个文件
  • 新增测试: 4 个新测试文件,4 个测试增强
  • 测试代码: 约 900+ 行新增测试代码

🎯 用户体验改进

  1. 性能提升显著:翻译进度组件的节流和缓存机制大幅提升了页面响应速度,减少了卡顿和延迟
  2. 状态追踪更准确:增强的章节翻译状态管理提供了更准确的翻译进度和状态反馈
  3. 段落导航更流畅:改进的段落导航和选择功能提供了更流畅的阅读和编辑体验
  4. 设置管理更可靠:增强的设置持久化机制确保用户设置不会丢失,迁移更平滑
  5. 同步功能更稳定:重构的同步数据服务提升了同步的稳定性和可靠性
  6. 翻译质量提升:增强的翻译规范化功能,特别是日文引号处理,提升了翻译质量
  7. AI 处理更高效:改进的 AI 任务处理和工具调用机制提升了翻译任务的执行效率
  8. 加载反馈更清晰:新增的加载指示器提供了更清晰的操作反馈
  9. 键盘操作更便捷:增强的键盘快捷键功能提升了用户的操作效率
  10. 错误处理更友好:改进的错误处理和提示机制提供了更友好的用户体验

🔄 升级建议

本次更新主要聚焦于:

  1. 性能优化:翻译进度组件和其他关键组件的性能优化将显著提升应用响应速度
  2. 稳定性增强:增强的状态管理、设置持久化和同步功能将提升应用的稳定性
  3. 功能增强:新增的翻译分块配置、段落导航增强等功能将提升用户体验
  4. 质量提升:900+ 行新增测试代码显著提升了代码质量和可靠性
  5. 兼容性改进:增强的 OpenAI 服务兼容性将支持更多模型和特性

建议所有用户升级以获得更好的使用体验。特别是对于:

  • 需要翻译大文件的用户,翻译分块配置功能将显著提升处理效率
  • 经常遇到同步问题的用户,重构的同步服务将提供更稳定的同步体验
  • 关注性能的用户,优化后的组件将提供更流畅的交互体验
  • 使用键盘快捷键的用户,增强的快捷键功能将提升操作效率

📚 相关文档

  • 项目架构文档:AGENTS.md
  • 翻译指南:docs/TRANSLATION_GUIDE.md
  • 主题指南:docs/THEME_GUIDE.md
  • 批量替换示例:docs/batch-replace-examples.md
  • AI 任务流程文档:docs/TRANSLATION_AI_TASK_FLOW.md
  • 流程改进建议:docs/TRANSLATION_AI_TASK_FLOW_IMPROVEMENTS.md
  • v0.8.1 发布说明:docs/ReleaseNotes/RELEASE_NOTES_v0.8.1.md

🙏 致谢

感谢所有为本次版本做出贡献的开发者和测试人员。


本文档由自动化工具生成,如有疑问请提交 Issue。

Release v0.8.1

26 Dec 03:19
b01203e

Choose a tag to compare

发布说明 - v0.8.1

版本信息

  • 版本号: 0.8.1
  • 发布日期: 2025年12月27日

🎉 新功能

1. 项目品牌重塑

  • 项目重命名
    • 项目从 "Luna AI Translator" 重命名为 "Tsukuyomi - Moonlit Translator"(月咏 - 月光翻译器)
    • 更新所有文档、代码注释和用户界面中的项目名称
    • 更新 README 文件,包含日文项目名称
    • 统一品牌标识,提升项目识别度
  • 主题迁移
    • 从 Luna 主题迁移到 Tsukuyomi 主题
    • 更新图标和品牌资产(favicon、应用图标等)
    • 优化应用品牌和 UI 一致性

2. 书籍上下文构建功能

  • 书籍信息集成
    • 新增 buildBookContextSection 函数,为 AI 任务提供书籍上下文信息
    • 自动提取书籍的书名、简介和标签信息
    • 在翻译、润色、校对等 AI 任务中自动包含书籍上下文
    • 帮助 AI 模型统一翻译风格和用词,提升翻译一致性
  • 上下文优化
    • 支持从 Store 或 IndexedDB 获取书籍信息
    • 自动截断过长的简介(超过 600 字符),避免提示词过长
    • 为空值情况提供优雅降级处理

3. 章节标题规范化功能

  • 标题格式统一
    • 新增 normalizeChapterTitle 函数,自动规范化章节标题格式
    • 支持将章节标题中的半角空格转换为全角空格(如 "第110话 测试" → "第110话 测试")
    • 支持多种章节标题格式("第X话"、"X话"、"第X话"等)
    • 提供章节级别的开关选项(normalizeTitleOnDisplay),支持按章节启用/禁用
  • 显示优化
    • 在章节设置面板中提供标题规范化开关
    • 支持书籍级别的默认设置,章节可单独覆盖
    • 优化章节标题的显示一致性

4. 段落追踪增强

  • 进度追踪优化
    • 增强 AI 任务处理中的段落追踪功能
    • 在进度回调中包含当前处理的段落 ID 列表(currentParagraphs
    • 提供更详细的翻译进度信息,用户可以了解当前正在处理哪些段落
    • 支持翻译、润色、校对等所有 AI 任务的段落追踪

5. 工具使用限制机制

  • 严格工具范围控制
    • 新增 getToolScopeRules 函数,严格限制 AI 只能调用本次请求提供的工具
    • executeToolCallLoop 中实现工具调用验证,拒绝未授权的工具调用
    • AssistantService 中实现工具调用限制检查
    • 防止 AI 调用未提供的工具,提升安全性和可控性
  • 工具调用限制配置
    • 为不同工具设置调用次数限制(如 list_terms 最多 3 次,list_characters 最多 3 次)
    • 提供清晰的错误提示,告知 AI 工具调用限制
    • 优化工具调用策略,避免无效的工具调用循环

6. 记忆工作流规则

  • 记忆管理规范
    • 新增 getMemoryWorkflowRules 函数,提供清晰的记忆管理规则
    • 明确记忆创建条件:只在对未来翻译任务有长期收益、可跨段落/跨章节复用时创建
    • 区分适合写入记忆的内容(稳定的敬语/称谓处理规则、固定译法选择等)和禁止写入的内容(一次性句子翻译、临时推断等)
    • 提供记忆搜索和更新的最佳实践指导
  • 测试覆盖
    • 新增记忆工作流规则测试,确保规则的正确性和完整性

7. 章节翻译更新功能

  • 目标章节处理
    • 实现章节翻译更新功能,支持目标章节处理
    • 优化章节翻译的更新逻辑,确保翻译内容正确关联到目标章节
    • 改进章节翻译的创建和更新流程

8. 段落翻译功能增强

  • 小说引用支持
    • 增强段落翻译功能,支持小说引用
    • 优化段落翻译的创建和更新逻辑
    • 改进段落翻译与书籍上下文的关联

9. CORS 代理支持

  • 图片上传优化
    • 在封面服务和图片上传服务中集成 CORS 代理支持
    • 支持通过 CORS 代理访问外部图片资源
    • 优化 SPA 构建中的图片上传和封面设置流程
    • 提升跨域资源访问的可靠性

10. 设置导入/导出功能改进

  • 同步处理优化
    • 改进设置导入/导出功能和同步处理逻辑
    • 优化设置数据的验证和转换机制
    • 增强设置同步的稳定性和准确性
    • 改进设置冲突检测和解决策略

🔧 改进与优化

AI 任务处理优化

  • 文本显示增强
    • 增强 ThinkingProcessPanelAppRightPanel 中的文本显示功能
    • 优化 AI 思考过程和输出内容的展示方式
    • 改进文本格式化和渲染逻辑
  • 段落追踪
    • 在翻译、润色、校对等 AI 任务中增强段落追踪功能
    • 提供更详细的进度信息,包括当前处理的段落 ID
    • 优化进度回调机制,提升用户体验

服务代码优化

  • 图片上传服务
    • 简化 ImageUploadService 中的 BASE_API_URL 处理逻辑
    • 优化 CORS 代理的使用方式
    • 改进错误处理和日志记录
  • 封面服务
    • 改进十六进制颜色验证逻辑
    • 优化颜色格式检查和转换
    • 增强错误提示的清晰度

本地存储优化

  • 迁移逻辑增强
    • 增强 toast 历史和最后查看记录的本地存储迁移逻辑
    • 优化存储键名的迁移策略
    • 改进数据迁移的兼容性和可靠性
    • 支持从旧版本平滑升级到新版本

UI 和用户体验优化

  • 品牌一致性
    • 统一应用品牌标识和 UI 风格
    • 更新所有图标和品牌资产
    • 优化应用名称和描述的显示
  • 章节设置
    • 在章节设置面板中新增标题规范化开关
    • 优化章节设置的交互体验
    • 改进设置选项的可见性和可访问性

🐛 问题修复

封面服务修复

  • 颜色验证改进
    • 修复十六进制颜色验证逻辑中的边界情况处理
    • 改进颜色格式验证的准确性
    • 优化错误提示信息

本地存储迁移修复

  • 迁移键名更新
    • 修复本地存储迁移逻辑中的键名问题
    • 确保 toast 历史和最后查看记录的迁移正确执行
    • 改进数据迁移的错误处理

📝 技术细节

主要修改文件

  • src/services/ai/tasks/utils/ai-task-helper.ts:新增 buildBookContextSection 函数,增强段落追踪功能(+150 行,-部分代码)
  • src/services/ai/tasks/translation-service.ts:集成书籍上下文构建功能(+20 行,-部分代码)
  • src/services/ai/tasks/proofreading-service.ts:集成书籍上下文构建功能(+15 行,-部分代码)
  • src/services/ai/tasks/polish-service.ts:集成书籍上下文构建功能(+15 行,-部分代码)
  • src/services/ai/tasks/term-translation-service.ts:集成书籍上下文构建功能(+10 行,-部分代码)
  • src/services/ai/tasks/prompts/index.ts:新增 getToolScopeRulesgetMemoryWorkflowRules 函数(+50 行)
  • src/services/ai/tasks/utils/ai-task-helper.ts:实现工具调用限制机制(+80 行,-部分代码)
  • src/services/ai/tasks/assistant-service.ts:实现工具调用限制检查(+30 行,-部分代码)
  • src/utils/novel-utils.ts:新增 normalizeChapterTitle 函数(+80 行)
  • src/models/novel.ts:新增 normalizeTitleOnDisplay 字段(+2 行)
  • src/components/novel/ChapterSettingsPopover.vue:新增标题规范化开关(+30 行,-部分代码)
  • src/services/image-upload-service.ts:集成 CORS 代理支持(+20 行,-部分代码)
  • src/services/cover-service.ts:改进颜色验证逻辑(+15 行,-部分代码)
  • src/__tests__/novel-utils.test.ts:新增标题规范化测试(+150 行)
  • src/__tests__/memory-workflow-rules.test.ts:新增记忆工作流规则测试(+12 行)
  • src/__tests__/ai-task-helper.book-context.test.ts:新增书籍上下文构建测试(+100 行)
  • README.md:更新项目名称和描述(+5 行,-部分代码)
  • package.json:版本号更新至 0.8.1(+2 行,-1 行)
  • src/constants/version.ts:版本号更新至 0.8.1(+2 行,-1 行)

新增功能统计

  • 新增功能: 10 项
  • 改进优化: 4 项
  • 问题修复: 2 项
  • 代码变更: 约 800 行新增,200 行删除
  • 修改文件: 25 个文件

🎯 用户体验改进

  1. 品牌识别度提升:项目重命名为 Tsukuyomi,统一品牌标识,提升项目识别度和专业性
  2. 翻译一致性增强:书籍上下文构建功能帮助 AI 模型统一翻译风格和用词,显著提升翻译一致性
  3. 标题显示优化:章节标题规范化功能确保标题格式统一,提升阅读体验
  4. 进度追踪透明化:段落追踪功能提供更详细的翻译进度信息,用户可以清楚了解当前处理状态
  5. 工具调用安全性:工具使用限制机制防止 AI 调用未授权的工具,提升系统安全性和可控性
  6. 记忆管理规范化:记忆工作流规则提供清晰的记忆管理指导,避免创建不必要的记忆
  7. 图片上传可靠性:CORS 代理支持提升跨域资源访问的可靠性,改善图片上传体验
  8. 设置同步稳定性:改进的设置导入/导出功能提升设置同步的稳定性和准确性

🔄 升级建议

本次更新主要聚焦于:

  1. 品牌重塑:项目重命名为 Tsukuyomi,所有用户都将看到新的品牌标识和名称
  2. 翻译质量提升:书籍上下文构建功能显著提升翻译一致性,特别适合处理系列小说的用户
  3. 标题格式统一:章节标题规范化功能确保标题显示一致,特别适合需要统一格式的用户
  4. 安全性增强:工具使用限制机制提升系统安全性,所有用户都将受益
  5. 记忆管理优化:记忆工作流规则帮助用户更好地管理记忆,避免创建不必要的记忆
  6. 图片上传改进:CORS 代理支持改善图片上传体验,特别适合需要上传外部图片的用户

建议所有用户升级以获得更好的使用体验。特别是对于需要处理系列小说或需要统一翻译风格的用户,本次更新将显著提升使用体验。


📚 相关文档

  • 项目架构文档:AGENTS.md
  • 翻译指南:docs/TRANSLATION_GUIDE.md
  • 主题指南:docs/THEME_GUIDE.md
  • 批量替换示例:docs/batch-replace-examples.md
  • AI 任务流程文档:docs/TRANSLATION_AI_TASK_FLOW.md
  • 流程改进建议:docs/TRANSLATION_AI_TASK_FLOW_IMPROVEMENTS.md

🙏 致谢

感谢所有为本次版本做出贡献的开发者。


本文档由自动化工具生成,如有疑问请提交 Issue。

Release v0.8.0

23 Dec 05:18
47eee18

Choose a tag to compare

What's Changed

Full Changelog: v0.7.16...v0.8.0