Skip to content

refactor(offline): centralize native tool setup - #3096

Merged
jyxjjj merged 2 commits into
OpenListTeam:mainfrom
nostalume:refactor/offline-tool-setup
Sep 21, 2026
Merged

jyxjjj merged 2 commits into
OpenListTeam:mainfrom
nostalume:refactor/offline-tool-setup

Conversation

@nostalume

@nostalume nostalume commented Sep 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary / 摘要

  • Centralize offline-download storage-to-native-tool selection in internal/offline_download/tool.

  • Let the HTTP handler delegate save-path assignment, tool lookup, and tool initialization to the tool package instead of importing every concrete tool driver.

  • Preserve the existing endpoint schema, validation, task status, tool names, and storage compatibility while removing duplicated dispatch code.

  • Add behavior-focused tests for supported storage mappings, unsupported storage errors, and handler request validation.

  • This PR has breaking changes.
    / 此 PR 包含破坏性变更。

  • This PR changes public API, config, storage format, or migration behavior.
    / 此 PR 修改了公开 API、配置、存储格式或迁移行为。

  • This PR requires corresponding changes in related repositories.
    / 此 PR 需要关联仓库同步修改。

Related repository PRs / 关联仓库 PR:

  • OpenList-Frontend: None
  • OpenList-Docs: None

Testing / 测试

  • Windows: go test ./internal/offline_download/tool ./server/handles -count=1

  • Windows: go vet ./internal/offline_download/tool ./server/handles

  • Linux/WSL (earlier verification of the same commit): go test -race ./internal/offline_download/tool ./server/handles -count=3

  • Final diff: git diff --check FETCH_HEAD...HEAD

  • go test ./...

  • Manual test / 手动测试:

Checklist / 检查清单

  • I have read CONTRIBUTING.
    / 我已阅读 CONTRIBUTING。
  • I confirm this contribution follows the repository license, contribution policy, and code of conduct.
    / 我确认此贡献符合仓库许可证、贡献规范和行为准则。
  • I have formatted the changed code with gofmt, go fmt, or prettier where applicable.
    / 我已按适用情况使用 gofmt、go fmt 或 prettier 格式化变更代码。
  • I have requested review from relevant maintainers or code owners where applicable.
    / 我已在适用情况下请求相关维护者或代码所有者审查。

AI Disclosure / AI 使用声明

  • This PR includes AI-assisted content.
    / 此 PR 包含 AI 辅助内容。

Tools used / 使用工具:

  • ChatGPT
  • Codex
  • GitHub Copilot
  • Claude
  • Gemini
  • Other (please specify) / 其他(请注明):

Usage scope / 使用范围:

  • Code generation / 代码生成

  • Refactoring / 重构

  • Documentation / 文档

  • Tests / 测试

  • Translation / 翻译

  • Review assistance / 审查辅助

  • I have reviewed and validated all AI-assisted content included in this PR.
    / 我已审核并验证此 PR 中的所有 AI 辅助内容。

  • I have ensured that all AI-assisted commits include Co-Authored-By attribution.
    / 我已确保所有 AI 辅助提交都包含 Co-Authored-By 归属信息。

  • I can reproduce all AI-assisted content included in this PR without any AI tools.
    / 我可以在没有任何 AI 工具的情况下重现此 PR 中包含的所有 AI 辅助内容。

- Keep storage-to-tool identity in the offline tool package.
- Share settings persistence, tool initialization, and storage admission across handlers.
- Preserve endpoint payloads and unsupported-storage diagnostics with focused tests.

Co-authored-by: Codex <267193182+codex@users.noreply.github.com>
@nostalume
nostalume marked this pull request as ready for review September 19, 2026 11:38

@pikachuren pikachuren left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🙏 感谢 @nostalume 提交!
🤖 AI 自动审核声明:本评审报告由 AI 自动生成,当前使用 Claude Opus 5 模型进行分析。
⚠️ AI 分析结果仅供参考,可能存在误判或遗漏。如您发现任何问题或有不同意见,欢迎随时提出讨论和纠正。
⚠️ 重要提醒:即使 AI 评审认为代码质量良好且建议合并,最终是否合并仍需由项目维护者进行人工判定。项目维护者会综合考虑代码质量、项目规划、技术方向、团队资源等多方面因素做出是否合并的决策。

🎯 结论

✅ Approve — 代码质量良好,建议合并

📖 概要

refactor(offline): centralize native tool setup

📊 评审结果

改动合理,无重大问题发现。代码逻辑清晰,符合项目规范。

🎯 结论:✅ Approve — 建议合并

@jyxjjj
jyxjjj merged commit 3a31b43 into OpenListTeam:main Sep 21, 2026
12 of 21 checks passed
@nostalume
nostalume deleted the refactor/offline-tool-setup branch September 21, 2026 09:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants