Skip to content

chore(deps): 更新 psy/psysh 依赖并配置手动更新检查#1073

Merged
huangdijia merged 3 commits into
friendsofhyperf:mainfrom
tw2066:thinker
Jun 25, 2026
Merged

chore(deps): 更新 psy/psysh 依赖并配置手动更新检查#1073
huangdijia merged 3 commits into
friendsofhyperf:mainfrom
tw2066:thinker

Conversation

@tw2066

@tw2066 tw2066 commented Jun 25, 2026

Copy link
Copy Markdown
Contributor
  • 将 psy/psysh 依赖版本从 "^0.11.0 || ^0.12.0" 更新为 "^0.12.0"
  • 添加 ManualUpdaterChecker 命名空间导入
  • 配置 tinker 命令禁用手动更新检查功能

Summary by CodeRabbit

  • Bug Fixes
    • 关闭交互式工具的手动更新检查,减少启动时的无关提示与干扰。
  • Chores
    • 收紧 psy/psysh 的依赖版本约束,仅保留更新的兼容范围。
  • Documentation
    • 更新多份 zh-HK / zh-TW 文档的用词、本地化与段落排版,并补强部分说明(含示例与表述一致性),提升阅读体验。

- 将 psy/psysh 依赖版本从 "^0.11.0 || ^0.12.0" 更新为 "^0.12.0"
- 添加 ManualUpdaterChecker 命名空间导入
- 配置 tinker 命令禁用手动更新检查功能
@coderabbitai

coderabbitai Bot commented Jun 25, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 1558c75d-7de9-468e-a0dd-dfa3414d4700

📥 Commits

Reviewing files that changed from the base of the PR and between 75df2b7 and 59aca01.

📒 Files selected for processing (1)
  • src/tinker/src/Command/TinkerCommand.php

Walkthrough

本次修改收窄了 tinkerpsy/psysh 依赖版本,并在 TinkerCommand 中关闭了 Psy 的手动更新检查。大量中文文档同时调整了章节标题、段落措辞、表格条目和示例说明,主要集中在 zh-HK 与 zh-TW 的本地化统一。

Changes

Tinker Psysh 更新

Layer / File(s) Summary
依赖约束与命令配置
src/tinker/composer.json, src/tinker/src/Command/TinkerCommand.php
psy/psysh 版本约束收窄到 ^0.12.0TinkerCommand 导入 ManualUpdaterChecker 并将手动更新检查设为 NEVER

文档本地化调整

Layer / File(s) Summary
zh-HK 运行时与基础组件
docs/zh-hk/components/amqp-job.md, docs/zh-hk/components/cache.md, docs/zh-hk/components/co-phpunit.md, docs/zh-hk/components/command-benchmark.md, docs/zh-hk/components/command-signals.md, docs/zh-hk/components/command-validation.md, docs/zh-hk/components/compoships.md, docs/zh-hk/components/confd.md, docs/zh-hk/components/config-consul.md, docs/zh-hk/components/console-spinner.md, docs/zh-hk/components/elasticsearch.md, docs/zh-hk/components/encryption.md, docs/zh-hk/components/exception-event.md, docs/zh-hk/components/facade.md, docs/zh-hk/components/fast-paginate.md, docs/zh-hk/components/grpc-validation.md, docs/zh-hk/components/helpers.md, docs/zh-hk/components/http-client.md, docs/zh-hk/components/ide-helper.md, docs/zh-hk/components/ipc-broadcaster.md, docs/zh-hk/components/lock.md, docs/zh-hk/components/macros.md, docs/zh-hk/components/mail.md, docs/zh-hk/components/model-factory.md, docs/zh-hk/components/model-hashids.md, docs/zh-hk/components/model-morph-addon.md, docs/zh-hk/components/model-observer.md, docs/zh-hk/components/model-scope.md, docs/zh-hk/components/mysql-grammar-addon.md, docs/zh-hk/components/notification-easysms.md, docs/zh-hk/components/notification-mail.md, docs/zh-hk/components/oauth2-server.md, docs/zh-hk/components/openai-client.md, docs/zh-hk/components/recaptcha.md, docs/zh-hk/components/sentry.md, docs/zh-hk/components/support.md, docs/zh-hk/components/validated-dto.md
这些组件文档的简介、配置、行为说明、API 片段与示例说明被统一改写为新的 zh-HK 用语。
zh-HK 索引与导览文档
docs/zh-hk/components/index.md, docs/zh-hk/faq/about.md, docs/zh-hk/faq/how-to-use.md, docs/zh-hk/faq/index.md, docs/zh-hk/guide/index.md, docs/zh-hk/guide/introduce/about.md
组件索引、FAQ 与导览页面的标题、段落和步骤说明被统一调整为新的 zh-HK 用语。
zh-TW 运行时与基础组件
docs/zh-tw/components/amqp-job.md, docs/zh-tw/components/cache.md, docs/zh-tw/components/co-phpunit.md, docs/zh-tw/components/command-benchmark.md, docs/zh-tw/components/command-signals.md, docs/zh-tw/components/command-validation.md, docs/zh-tw/components/compoships.md, docs/zh-tw/components/confd.md, docs/zh-tw/components/config-consul.md, docs/zh-tw/components/console-spinner.md, docs/zh-tw/components/elasticsearch.md, docs/zh-tw/components/encryption.md, docs/zh-tw/components/exception-event.md, docs/zh-tw/components/facade.md, docs/zh-tw/components/fast-paginate.md, docs/zh-tw/components/grpc-validation.md, docs/zh-tw/components/helpers.md, docs/zh-tw/components/http-client.md, docs/zh-tw/components/ide-helper.md, docs/zh-tw/components/ipc-broadcaster.md, docs/zh-tw/components/lock.md, docs/zh-tw/components/macros.md, docs/zh-tw/components/mail.md, docs/zh-tw/components/model-factory.md, docs/zh-tw/components/model-hashids.md, docs/zh-tw/components/model-morph-addon.md, docs/zh-tw/components/model-observer.md, docs/zh-tw/components/model-scope.md, docs/zh-tw/components/mysql-grammar-addon.md, docs/zh-tw/components/notification-easysms.md, docs/zh-tw/components/notification-mail.md, docs/zh-tw/components/oauth2-server.md, docs/zh-tw/components/openai-client.md, docs/zh-tw/components/recaptcha.md, docs/zh-tw/components/sentry.md, docs/zh-tw/components/support.md, docs/zh-tw/components/validated-dto.md
这些组件文档的标题、说明、参数表和行为描述被改写为新的繁体台湾用语。
zh-TW 索引与导览文档
docs/zh-tw/components/index.md, docs/zh-tw/faq/about.md, docs/zh-tw/faq/how-to-use.md, docs/zh-tw/faq/index.md, docs/zh-tw/guide/index.md, docs/zh-tw/guide/introduce/about.md
组件索引、FAQ 与入门导览页面的标题、段落和步骤说明被统一调整为新的繁体台湾用语。

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • huangdijia

Poem

我是一只小兔跳呀跳,
文档字句换新调。
Psysh 版本收得紧,
更新检查轻轻消。
月光照着组件林,
兔耳一抖,真妙! 🐰

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed 标题准确概括了依赖约束收窄和 Tinker 手动更新检查禁用这两项主要变更。
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 PHPStan (2.2.2)

PHPStan was skipped because the config uses disallowed bootstrapFiles, bootstrapFile, or includes directives.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@tw2066

tw2066 commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author

#1072

@huangdijia huangdijia changed the base branch from main to 3.1 June 25, 2026 03:12
@huangdijia huangdijia changed the base branch from 3.1 to main June 25, 2026 03:13
@huangdijia

Copy link
Copy Markdown
Contributor

留个联系方式?

@coderabbitai coderabbitai 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.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/zh-hk/components/model-factory.md`:
- Around line 92-100: The return-value description for the factory helper is
inconsistent: it says the helper returns Hyperf\Database\Model\FactoryBuilder,
but later mentions factory() may return null when the container is unavailable.
Update the wording in the model-factory docs so the main return type explicitly
includes null, or fold the null case into the first sentence, and keep the rest
of the behavior notes aligned with factory(), make(), create(), and raw().

In `@docs/zh-hk/components/model-observer.md`:
- Around line 66-71: The two example comments in the observer docs use
simplified Chinese wording, which is inconsistent with the zh-HK page. Update
the comment text around the User observer examples so both the `creating` and
`created` annotations use traditional Chinese characters, keeping the phrasing
aligned with the rest of the localized documentation.

In `@docs/zh-hk/components/mysql-grammar-addon.md`:
- Around line 41-46: The example in the MySQL grammar addon docs mixes
Simplified and Traditional Chinese; update the `@property` comment text in the
zh-HK sample to use Traditional Chinese consistently. Fix the `user_id`
description in the markdown snippet so it matches the rest of the document’s
locale, and keep the same style throughout the example.

In `@docs/zh-tw/guide/index.md`:
- Around line 26-27: The phrase in the guide text contains a typo: “大多陣列件”
should be corrected to “大多數元件” in the documentation content. Update the wording
in the affected paragraph so the surrounding explanation about Hyperf component
discovery and config publishing remains unchanged, and verify the text in the
translated guide reads naturally with the corrected term.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 9c0a281c-8381-424c-8a4f-19b404d06e92

📥 Commits

Reviewing files that changed from the base of the PR and between 80f8360 and 75df2b7.

📒 Files selected for processing (86)
  • docs/zh-hk/components/amqp-job.md
  • docs/zh-hk/components/cache.md
  • docs/zh-hk/components/co-phpunit.md
  • docs/zh-hk/components/command-benchmark.md
  • docs/zh-hk/components/command-signals.md
  • docs/zh-hk/components/command-validation.md
  • docs/zh-hk/components/compoships.md
  • docs/zh-hk/components/confd.md
  • docs/zh-hk/components/config-consul.md
  • docs/zh-hk/components/console-spinner.md
  • docs/zh-hk/components/elasticsearch.md
  • docs/zh-hk/components/encryption.md
  • docs/zh-hk/components/exception-event.md
  • docs/zh-hk/components/facade.md
  • docs/zh-hk/components/fast-paginate.md
  • docs/zh-hk/components/grpc-validation.md
  • docs/zh-hk/components/helpers.md
  • docs/zh-hk/components/http-client.md
  • docs/zh-hk/components/ide-helper.md
  • docs/zh-hk/components/index.md
  • docs/zh-hk/components/ipc-broadcaster.md
  • docs/zh-hk/components/lock.md
  • docs/zh-hk/components/macros.md
  • docs/zh-hk/components/mail.md
  • docs/zh-hk/components/model-factory.md
  • docs/zh-hk/components/model-hashids.md
  • docs/zh-hk/components/model-morph-addon.md
  • docs/zh-hk/components/model-observer.md
  • docs/zh-hk/components/model-scope.md
  • docs/zh-hk/components/mysql-grammar-addon.md
  • docs/zh-hk/components/notification-easysms.md
  • docs/zh-hk/components/notification-mail.md
  • docs/zh-hk/components/oauth2-server.md
  • docs/zh-hk/components/openai-client.md
  • docs/zh-hk/components/recaptcha.md
  • docs/zh-hk/components/sentry.md
  • docs/zh-hk/components/support.md
  • docs/zh-hk/components/validated-dto.md
  • docs/zh-hk/faq/about.md
  • docs/zh-hk/faq/how-to-use.md
  • docs/zh-hk/faq/index.md
  • docs/zh-hk/guide/index.md
  • docs/zh-hk/guide/introduce/about.md
  • docs/zh-tw/components/amqp-job.md
  • docs/zh-tw/components/cache.md
  • docs/zh-tw/components/co-phpunit.md
  • docs/zh-tw/components/command-benchmark.md
  • docs/zh-tw/components/command-signals.md
  • docs/zh-tw/components/command-validation.md
  • docs/zh-tw/components/compoships.md
  • docs/zh-tw/components/confd.md
  • docs/zh-tw/components/config-consul.md
  • docs/zh-tw/components/console-spinner.md
  • docs/zh-tw/components/elasticsearch.md
  • docs/zh-tw/components/encryption.md
  • docs/zh-tw/components/exception-event.md
  • docs/zh-tw/components/facade.md
  • docs/zh-tw/components/fast-paginate.md
  • docs/zh-tw/components/grpc-validation.md
  • docs/zh-tw/components/helpers.md
  • docs/zh-tw/components/http-client.md
  • docs/zh-tw/components/ide-helper.md
  • docs/zh-tw/components/index.md
  • docs/zh-tw/components/ipc-broadcaster.md
  • docs/zh-tw/components/lock.md
  • docs/zh-tw/components/macros.md
  • docs/zh-tw/components/mail.md
  • docs/zh-tw/components/model-factory.md
  • docs/zh-tw/components/model-hashids.md
  • docs/zh-tw/components/model-morph-addon.md
  • docs/zh-tw/components/model-observer.md
  • docs/zh-tw/components/model-scope.md
  • docs/zh-tw/components/mysql-grammar-addon.md
  • docs/zh-tw/components/notification-easysms.md
  • docs/zh-tw/components/notification-mail.md
  • docs/zh-tw/components/oauth2-server.md
  • docs/zh-tw/components/openai-client.md
  • docs/zh-tw/components/recaptcha.md
  • docs/zh-tw/components/sentry.md
  • docs/zh-tw/components/support.md
  • docs/zh-tw/components/validated-dto.md
  • docs/zh-tw/faq/about.md
  • docs/zh-tw/faq/how-to-use.md
  • docs/zh-tw/faq/index.md
  • docs/zh-tw/guide/index.md
  • docs/zh-tw/guide/introduce/about.md
✅ Files skipped from review due to trivial changes (55)
  • docs/zh-hk/components/notification-mail.md
  • docs/zh-tw/components/validated-dto.md
  • docs/zh-hk/components/validated-dto.md
  • docs/zh-tw/faq/how-to-use.md
  • docs/zh-tw/components/notification-mail.md
  • docs/zh-tw/components/mail.md
  • docs/zh-hk/components/recaptcha.md
  • docs/zh-tw/components/helpers.md
  • docs/zh-tw/faq/index.md
  • docs/zh-hk/faq/how-to-use.md
  • docs/zh-hk/components/helpers.md
  • docs/zh-hk/components/model-morph-addon.md
  • docs/zh-tw/components/model-hashids.md
  • docs/zh-tw/components/facade.md
  • docs/zh-hk/components/command-benchmark.md
  • docs/zh-hk/components/ide-helper.md
  • docs/zh-tw/components/model-scope.md
  • docs/zh-hk/components/model-hashids.md
  • docs/zh-hk/components/command-signals.md
  • docs/zh-tw/components/model-morph-addon.md
  • docs/zh-hk/components/notification-easysms.md
  • docs/zh-tw/components/oauth2-server.md
  • docs/zh-tw/components/notification-easysms.md
  • docs/zh-hk/components/encryption.md
  • docs/zh-hk/components/openai-client.md
  • docs/zh-hk/components/elasticsearch.md
  • docs/zh-hk/components/model-scope.md
  • docs/zh-hk/components/index.md
  • docs/zh-tw/components/command-validation.md
  • docs/zh-tw/components/model-factory.md
  • docs/zh-hk/components/confd.md
  • docs/zh-tw/components/ipc-broadcaster.md
  • docs/zh-hk/components/lock.md
  • docs/zh-tw/components/encryption.md
  • docs/zh-hk/components/mail.md
  • docs/zh-tw/components/command-signals.md
  • docs/zh-hk/components/cache.md
  • docs/zh-tw/components/grpc-validation.md
  • docs/zh-hk/components/compoships.md
  • docs/zh-tw/components/confd.md
  • docs/zh-hk/components/sentry.md
  • docs/zh-hk/components/grpc-validation.md
  • docs/zh-tw/components/command-benchmark.md
  • docs/zh-hk/components/amqp-job.md
  • docs/zh-tw/components/cache.md
  • docs/zh-tw/components/index.md
  • docs/zh-hk/components/ipc-broadcaster.md
  • docs/zh-tw/components/lock.md
  • docs/zh-tw/components/elasticsearch.md
  • docs/zh-tw/components/compoships.md
  • docs/zh-hk/components/http-client.md
  • docs/zh-hk/components/oauth2-server.md
  • docs/zh-tw/components/model-observer.md
  • docs/zh-tw/components/sentry.md
  • docs/zh-tw/components/http-client.md

Comment on lines +92 to +100
輔助函數返回 `Hyperf\Database\Model\FactoryBuilder`。常用的終止方法包括:

- `make()`:建構模型但不持久化
- `create()`:建構並持久化模型
- `raw()`:傳回產生的屬性陣列
- `make()`:構建模型但不持久化
- `create()`:構建並持久化模型
- `raw()`:返回生成的屬性數組

未指定數量時,這些方法傳回單個結果;指定數量時,傳回模型集合或原始屬性陣列清單
傳給這些方法的屬性陣列會覆蓋產生的值。如果應用程式容器不可用
`factory()` 傳回 `null`。
未指定數量時,這些方法返回單個結果;指定數量時,返回模型集合或原始屬性數組列表
傳給這些方法的屬性數組會覆蓋生成的值。如果應用容器不可用
`factory()` 返回 `null`。

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

统一返回值说明。

这里先写成只返回 Hyperf\Database\Model\FactoryBuilder,但后面又说容器不可用时会返回 null,前后不一致。建议改成 FactoryBuilder|null,或把 null 的例外直接并入首句。

♻️ 建议修正
-辅助函数返回 `Hyperf\Database\Model\FactoryBuilder`。常用的终止方法包括:
+辅助函数通常返回 `Hyperf\Database\Model\FactoryBuilder`;如果应用容器不可用,则返回 `null`。常用的终止方法包括:
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
輔助函數返回 `Hyperf\Database\Model\FactoryBuilder`。常用的終止方法包括:
- `make()`:建構模型但不持久化。
- `create()`:建構並持久化模型。
- `raw()`:傳回產生的屬性陣列。
- `make()`:構建模型但不持久化。
- `create()`:構建並持久化模型。
- `raw()`:返回生成的屬性數組。
未指定數量時,這些方法傳回單個結果;指定數量時,傳回模型集合或原始屬性陣列清單。
傳給這些方法的屬性陣列會覆蓋產生的值。如果應用程式容器不可用,
`factory()` 傳回 `null`
未指定數量時,這些方法返回單個結果;指定數量時,返回模型集合或原始屬性數組列表。
傳給這些方法的屬性數組會覆蓋生成的值。如果應用容器不可用,
`factory()` 返回 `null`
輔助函數通常返回 `Hyperf\Database\Model\FactoryBuilder`;如果應用容器不可用,則返回
`null`。常用的終止方法包括:
- `make()`:構建模型但不持久化。
- `create()`:構建並持久化模型。
- `raw()`:返回生成的屬性數組。
未指定數量時,這些方法返回單個結果;指定數量時,返回模型集合或原始屬性數組列表。
傳給這些方法的屬性數組會覆蓋生成的值。如果應用容器不可用,
`factory()` 返回 `null`
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/zh-hk/components/model-factory.md` around lines 92 - 100, The
return-value description for the factory helper is inconsistent: it says the
helper returns Hyperf\Database\Model\FactoryBuilder, but later mentions
factory() may return null when the container is unavailable. Update the wording
in the model-factory docs so the main return type explicitly includes null, or
fold the null case into the first sentence, and keep the rest of the behavior
notes aligned with factory(), make(), create(), and raw().

Comment on lines +66 to +71
// 創建用户前執行
}

public function created(User $model): void
{
// 建立用戶後執行
// 創建用户後執行

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

统一这两个示例注释的字形。

用户 是简体写法,和整页的 zh-HK 文案不一致;这里是直接展示给读者的示例,建议改成繁体用字。

🛠️ 建议修改
-        // 创建用户前执行。
+        // 創建用戶前執行。
@@
-        // 创建用户后执行。
+        // 創建用戶後執行。
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
// 創建用户前執行。
}
public function created(User $model): void
{
// 建立用戶後執行。
// 創建用户後執行。
// 創建用戶前執行。
}
public function created(User $model): void
{
// 創建用戶後執行。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/zh-hk/components/model-observer.md` around lines 66 - 71, The two
example comments in the observer docs use simplified Chinese wording, which is
inconsistent with the zh-HK page. Update the comment text around the User
observer examples so both the `creating` and `created` annotations use
traditional Chinese characters, keeping the phrasing aligned with the rest of
the localized documentation.

Comment on lines +41 to +46
安裝該組件之後,可以保留原始註釋:

```php
/**
* @property int $user_id 用户id
* @property string $event_name 事件名称
* @property string $event_name 事件名稱

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

把示例里的简体字改回繁体。

用户id 是简体写法,和这份 zh-HK 文档不一致;建议统一成繁体,避免示例看起来像混用了两个地区的文本。

🛠️ 建议修改
- * `@property` int $user_id 用户id
+ * `@property` int $user_id 用戶 ID
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
安裝該組件之後,可以保留原始註釋:
```php
/**
* @property int $user_id 用户id
* @property string $event_name 事件名称
* @property string $event_name 事件名稱
安裝該組件之後,可以保留原始註釋:
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/zh-hk/components/mysql-grammar-addon.md` around lines 41 - 46, The
example in the MySQL grammar addon docs mixes Simplified and Traditional
Chinese; update the `@property` comment text in the zh-HK sample to use
Traditional Chinese consistently. Fix the `user_id` description in the markdown
snippet so it matches the rest of the document’s locale, and keep the same style
throughout the example.

Comment thread docs/zh-tw/guide/index.md
Comment on lines +26 to +27
將 `cache` 替換為[元件目錄](../components/index.md)中的包名。大多陣列件會透過 Hyperf
元件發現機制自動註冊;如果元件提供配置檔案,請按對應元件頁面的說明發布配置

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

修正这里的笔误。

大多陣列件 不是有效说法,应该是 大多數元件。这会直接影响入门页的可读性。

🛠️ 建议修改
-將 `cache` 替換為[元件目錄](../components/index.md)中的包名。大多陣列件會透過 Hyperf
+將 `cache` 替換為[元件目錄](../components/index.md)中的包名。大多數元件會透過 Hyperf
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
`cache` 替換為[元件目錄](../components/index.md)中的包名。大多陣列件會透過 Hyperf
元件發現機制自動註冊;如果元件提供配置檔案,請按對應元件頁面的說明發布配置。
`cache` 替換為[元件目錄](../components/index.md)中的包名。大多數元件會透過 Hyperf
元件發現機制自動註冊;如果元件提供配置檔案,請按對應元件頁面的說明發布配置。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/zh-tw/guide/index.md` around lines 26 - 27, The phrase in the guide text
contains a typo: “大多陣列件” should be corrected to “大多數元件” in the documentation
content. Update the wording in the affected paragraph so the surrounding
explanation about Hyperf component discovery and config publishing remains
unchanged, and verify the text in the translated guide reads naturally with the
corrected term.

@tw2066

tw2066 commented Jun 25, 2026

Copy link
Copy Markdown
Contributor Author
image

@huangdijia huangdijia merged commit 450c99b into friendsofhyperf:main Jun 25, 2026
37 of 38 checks passed
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.

2 participants