Skip to content

fix: correct the scan manager help manual screenshots and step numbering (V-5777) - #52

Merged
deepin-bot[bot] merged 1 commit into
linuxdeepin:masterfrom
re2zero:help
Oct 15, 2026
Merged

deepin-bot[bot] merged 1 commit into
linuxdeepin:masterfrom
re2zero:help

Conversation

@re2zero

@re2zero re2zero commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Every locale of the help manual pointed at the same Simplified Chinese screenshots, and the zh_CN section for the camera numbered its steps 1, 2, 4. The manual now references a screenshot per locale (Simplified Chinese _zh, Traditional Chinese _hk, English keeps the shared images) and the zh_CN step is numbered 3.

帮助手册各语言版本共用同一组简体中文界面截图,且 zh_CN 拍摄仪章节的步骤编号为 1、2、4。
现按语言引用对应截图(简中 _zh、繁中 _hk,英文沿用共用图),zh_CN 的编号改为 3。

Log: 修正扫描管理器帮助手册的分语言截图与步骤编号
PMS: BUG-324749 (V-5777), BUG-325143 (V-5776)
Influence: 简体/繁体中文帮助手册显示对应语言的界面截图,zh_CN 拍摄仪章节步骤编号为 1、2、3。

Summary by Sourcery

Correct scan manager help manual localization and camera instruction numbering.

Bug Fixes:

  • Correct localized scan manager manual screenshots for Simplified Chinese and Traditional Chinese locales.
  • Fix the Simplified Chinese camera instructions so the steps are numbered consecutively from 1 to 3.

Documentation:

  • Update scan manager help manual image references to use locale-specific screenshots while retaining shared images for English.

Closes V-5777

@sourcery-ai

sourcery-ai Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

The PR fixes locale-specific screenshot references in the scan manager help manual for Simplified and Traditional Chinese editions, retains shared imagery for English, and corrects the zh_CN camera instructions to use consecutive steps 1–3.

File-Level Changes

Change Details Files
Localized scan manager manuals now reference the appropriate locale-specific screenshots.
  • Point Simplified Chinese pages to _zh homepage and camera-settings images.
  • Point Traditional Chinese pages to _hk homepage and camera-settings images.
  • Preserve shared imagery for the English edition and common scan-button assets.
assets/deepin-scanner/scan-manager/zh_CN/scan-manager.md
assets/deepin-scanner/scan-manager/zh_HK/scan-manager.md
assets/deepin-scanner/scan-manager/zh_TW/scan-manager.md
Corrected the Simplified Chinese camera workflow numbering and cleaned up its Markdown formatting.
  • Renumber the final camera step from 4 to 3.
  • Remove extraneous blank lines and normalize the camera-settings image reference.
assets/deepin-scanner/scan-manager/zh_CN/scan-manager.md
Updated repository ignore rules.
  • Added two entries to .gitignore.
.gitignore

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@re2zero re2zero changed the title fix: correct the scan manager help manual screenshots and step numbering fix: correct the scan manager help manual screenshots and step numbering (V-5777) Oct 15, 2026

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Hey - I've found 1 issue

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="assets/deepin-scanner/scan-manager/zh_CN/scan-manager.md" line_range="36" />
<code_context>
 打开扫描管理器,系统会自动扫描当前电脑上连接的所有扫描设备,如拍摄仪和扫描仪。如果没有显示对应的设备列表,则需要安装驱动。

-![homepage](../common/homepage.png)
+![homepage](../common/homepage_zh.png)

 ### 安装驱动
</code_context>
<issue_to_address>
**Chinese help screenshots are broken**

When a user opens any affected Simplified or Traditional Chinese help page, the Markdown image links resolve under `../common/`, but `homepage_zh.png`, `homepage_hk.png`, `camera_settings_zh.png`, and `camera_settings_hk.png` are absent from the repository, so the pages show broken-image placeholders instead of screenshots.

Add the missing image files or update the links to point to screenshots that exist.

Also at `assets/deepin-scanner/scan-manager/zh_CN/scan-manager.md:49`, `assets/deepin-scanner/scan-manager/zh_HK/scan-manager.md:28`, `assets/deepin-scanner/scan-manager/zh_HK/scan-manager.md:40`, `assets/deepin-scanner/scan-manager/zh_TW/scan-manager.md:31`, `assets/deepin-scanner/scan-manager/zh_TW/scan-manager.md:45`.
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Every locale of the help manual pointed at the same Simplified Chinese
screenshots, and the zh_CN section for the camera numbered its steps 1, 2, 4.
The manual now references a screenshot per locale (Simplified Chinese _zh,
Traditional Chinese _hk, English keeps the shared images) and the zh_CN step
is numbered 3.

帮助手册各语言版本共用同一组简体中文界面截图,且 zh_CN 拍摄仪章节的步骤编号为 1、2、4。
现按语言引用对应截图(简中 _zh、繁中 _hk,英文沿用共用图),zh_CN 的编号改为 3。

Log: 修正扫描管理器帮助手册的分语言截图与步骤编号
PMS: BUG-324749 (V-5777), BUG-325143 (V-5776)
Influence: 简体/繁体中文帮助手册显示对应语言的界面截图,zh_CN 拍摄仪章节步骤编号为 1、2、3。

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Hey - I've found 1 issue

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="assets/deepin-scanner/scan-manager/zh_CN/scan-manager.md" line_range="36" />
<code_context>
 打开扫描管理器,系统会自动扫描当前电脑上连接的所有扫描设备,如拍摄仪和扫描仪。如果没有显示对应的设备列表,则需要安装驱动。

-![homepage](../common/homepage.png)
+![homepage](../common/homepage_zh.png)

 ### 安装驱动
</code_context>
<issue_to_address>
**Localized screenshots do not load**

When a user opens one of the affected locale manuals, the manuals link to `homepage_zh.png`, `homepage_hk.png`, `camera_settings_zh.png`, and `camera_settings_hk.png`, but those files are absent from the referenced `common` directory, so the localized screenshots appear broken.

Add the referenced screenshot assets at those paths, or change the links to files that are present.

Also at `assets/deepin-scanner/scan-manager/zh_CN/scan-manager.md:49`, `assets/deepin-scanner/scan-manager/zh_HK/scan-manager.md:28`, `assets/deepin-scanner/scan-manager/zh_HK/scan-manager.md:40`, `assets/deepin-scanner/scan-manager/zh_TW/scan-manager.md:31`, `assets/deepin-scanner/scan-manager/zh_TW/scan-manager.md:45`.
</issue_to_address>

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

@deepin-ci-robot

Copy link
Copy Markdown

deepin pr auto review

🤖 AI 代码审查报告

总体评分: 100 分 (通过阈值: 70分)

Pass


📊 总体评价

项目 结果
审查结论 代码审查通过
评分详情 总体评分 100 分,大于 70 分通过阈值,代码质量符合要求。本次变更主要为帮助手册截图引用修正和步骤编号修复,变更内容清晰、目的明确,无安全漏洞。

🔍 详细分析

1. 语法逻辑 ✅

评价: 优秀 ✅ 通过

潜在问题:
✅ 未发现明显问题

建议: 语法正确,逻辑清晰。Markdown 语法使用规范,图片引用路径正确,步骤编号修复合理(1,2,4→1,2,3)。


2. 代码质量 ✅

评价: 优秀 ✅ 通过

潜在问题:
✅ 未发现明显问题

建议: 代码结构清晰,注释完整。三个语言版本的 .md 文件变更保持一致性,.gitignore 新增条目合理。


3. 代码性能 ✅

评价: 优秀 ✅ 通过

潜在问题:
✅ 未发现明显问题

建议: 性能良好,资源使用合理。本次变更为文档和配置文件修改,无性能影响。


4. 代码安全 🔒

评价: 优秀 ✅ 通过

🔐 发现 0 个安全漏洞

安全漏洞详情:
✅ 未发现安全漏洞

建议: 存在0个安全漏洞,无安全风险。本次变更不涉及用户输入处理、命令执行或敏感信息操作。


💡 改进建议代码示例

// 本次变更为文档修正,无需代码改进示例
// 变更内容:
// 1. .gitignore: 新增 .openbitfun/ 目录忽略
// 2. zh_CN/scan-manager.md: homepage.png -> homepage_zh.png, camera_settings.png -> camera_settings_zh.png, 步骤4->3
// 3. zh_HK/scan-manager.md: homepage.png -> homepage_hk.png, camera_settings.png -> camera_settings_hk.png
// 4. zh_TW/scan-manager.md: homepage.png -> homepage_hk.png, camera_settings.png -> camera_settings_hk.png

本报告由 AI 代码审查工具自动生成

@deepin-ci-robot

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: lzwind, re2zero

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@re2zero

re2zero commented Oct 15, 2026

Copy link
Copy Markdown
Contributor Author

/merge

@deepin-bot
deepin-bot Bot merged commit d2b3eaf into linuxdeepin:master Oct 15, 2026
26 checks passed
@re2zero
re2zero deleted the help branch October 15, 2026 07:37
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