[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent by zhwesky2010 · Pull Request #7853 · PaddlePaddle/docs

zhwesky2010 · 2026-03-10T07:42:40Z

API Compatibility Edit By AI Agent：

torch.bernoulli
torch.combinations
torch.cumulative_trapezoid
torch.trapezoid
torch.frexp
torch.kron
torch.kthvalue
torch.logcumsumexp
torch.mv
torch.Tensor.remainder_
torch.Tensor.squeeze_
torch.Tensor.pow_
torch.Tensor.unsqueeze_
torch.Tensor.floor_divide_
torch.mode
torch.isposinf
torch.isneginf
torch.isreal
torch.Tensor.bernoulli
torch.Tensor.frexp
torch.Tensor.kron
torch.Tensor.kthvalue
torch.Tensor.logcumsumexp
torch.Tensor.mv

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent Paddle#78235

paddle-bot · 2026-03-10T07:42:52Z

感谢你贡献飞桨文档，文档预览构建中，Docs-New 跑完后即可预览，预览链接：http://preview-pr-7853.paddle-docs-preview.paddlepaddle.org.cn/documentation/docs/zh/api/index_cn.html
预览工具的更多说明，请参考：飞桨文档预览工具

github-actions · 2026-03-10T07:43:14Z

📚 本次 PR 文档预览链接（点击展开）

ℹ️ 预览提醒请等待 `Docs-NEW` 流水线运行完成后再点击预览链接，否则可能会看到旧版本内容或遇到链接无法访问的情况。

docs/api/paddle/atan2_cn.rst: 点击预览
docs/api/paddle/bernoulli_cn.rst: 点击预览
docs/api/paddle/combinations_cn.rst: 点击预览
docs/api/paddle/count_nonzero_cn.rst: 点击预览
docs/api/paddle/cumulative_trapezoid_cn.rst: 点击预览
docs/api/paddle/floor_divide__cn.rst: 点击预览
docs/api/paddle/frexp_cn.rst: 点击预览
docs/api/paddle/isneginf_cn.rst: 点击预览
docs/api/paddle/isposinf_cn.rst: 点击预览
docs/api/paddle/isreal_cn.rst: 点击预览
docs/api/paddle/kron_cn.rst: 点击预览
docs/api/paddle/kthvalue_cn.rst: 点击预览
docs/api/paddle/lgamma_cn.rst: 点击预览
docs/api/paddle/logcumsumexp_cn.rst: 点击预览
docs/api/paddle/mode_cn.rst: 点击预览
docs/api/paddle/mv_cn.rst: 点击预览
docs/api/paddle/poisson_cn.rst: 点击预览
docs/api/paddle/pow__cn.rst: 点击预览
docs/api/paddle/squeeze__cn.rst: 点击预览
docs/api/paddle/trapezoid_cn.rst: 点击预览
docs/api/paddle/unsqueeze__cn.rst: 点击预览
docs/dev_guides/coding_agent/README.md: 点击预览
docs/dev_guides/coding_agent/api_compatibility/README.md: 点击预览
docs/dev_guides/coding_agent/api_compatibility/api-change-decider.md: 点击预览
docs/dev_guides/coding_agent/api_compatibility/api-compatibility.md: 点击预览
docs/dev_guides/coding_agent/api_compatibility/python-decorator.md: 点击预览
docs/dev_guides/coding_agent/api_compatibility/pytorch-alignment-validator.md: 点击预览

Copilot

Pull request overview

该 PR 主要对《Paddle API 对齐 PyTorch 项目》的智能体规则文档做了目录/文件重组与内容格式调整，并同步更新了一批 Paddle API 中文文档（主要新增/强调参数别名与 out 关键字参数等对齐信息），以支持 API 兼容性对齐流程的文档化落地。

Changes:

移除旧的 coding_agent_rules/api_compatibility 规则文件，并在 docs/dev_guides/coding_agent/api_compatibility/ 下新增/重写主控与“方案决策”规则文档。
更新多个智能体规则文档的 frontmatter（name/description/tools）与行文规范。
批量更新若干 API 中文文档：补充别名说明、补充 out 参数段落、调整函数签名展示。

Reviewed changes

Copilot reviewed 27 out of 29 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
docs/dev_guides/coding_agent_rules/api_compatibility/0-api-compatibility.mdr	删除旧版“主控智能体”规则文件（迁移/重构到新目录）。
docs/dev_guides/coding_agent_rules/api_compatibility/1-scheme-decision.mdr	删除旧版“方案决策”规则文件（迁移/重构到新目录）。
docs/dev_guides/coding_agent/api_compatibility/pytorch-alignment-validator.md	更新对齐验证智能体的 frontmatter 与文案表述。
docs/dev_guides/coding_agent/api_compatibility/python-decorator.md	更新 Python 装饰器智能体规则的 frontmatter 与文案细节。
docs/dev_guides/coding_agent/api_compatibility/cpp-sink.mdr	更新 C++ 下沉智能体规则的 frontmatter 与文案细节。
docs/dev_guides/coding_agent/api_compatibility/api-docs-updater.mdr	更新 API 文档修改智能体规则的 frontmatter 与文案细节。
docs/dev_guides/coding_agent/api_compatibility/api-compatibility.md	新增主控智能体规则文档（新路径/新文件名）。
docs/dev_guides/coding_agent/api_compatibility/api-change-decider.md	新增 API 改动方案决策智能体规则文档（替代旧 scheme decision）。
docs/dev_guides/coding_agent/api_compatibility/README.md	新增该规则体系说明文档（但当前引用文件名与实际不一致）。
docs/dev_guides/coding_agent/README.md	新增 coding_agent 目录说明（但扩展名描述与实际内容不一致）。
docs/api/paddle/unsqueeze__cn.rst	为 inplace API 补充别名支持 note。
docs/api/paddle/trapezoid_cn.rst	签名增加 `out`（keyword-only）并补充参数说明/别名。
docs/api/paddle/squeeze__cn.rst	为 inplace API 补充别名支持 note。
docs/api/paddle/remainder__cn.rst	为 inplace API 补充别名与参数/返回说明段落。
docs/api/paddle/pow__cn.rst	修正签名排版并补充别名支持 note。
docs/api/paddle/poisson_cn.rst	增加 `input` 别名说明（存在标点混用问题）。
docs/api/paddle/mv_cn.rst	签名增加 `out`（keyword-only）并补充 `input` 别名与 out 说明。
docs/api/paddle/mode_cn.rst	签名增加 `out`（keyword-only）与别名说明（但 keepdim 默认值与 out 描述存在错误）。
docs/api/paddle/logcumsumexp_cn.rst	签名增加 `out`（keyword-only）与别名说明，并补充返回说明。
docs/api/paddle/lgamma_cn.rst	签名增加 `out`（keyword-only）与别名说明，并补充返回说明。
docs/api/paddle/kthvalue_cn.rst	签名增加 `out`（keyword-only）与别名说明。
docs/api/paddle/kron_cn.rst	调整签名为 keyword-only `out`，并补充 `input/other` 别名与 out 段落。
docs/api/paddle/frexp_cn.rst	调整签名（name 默认值、增加 `out`）并补充别名/out 段落。
docs/api/paddle/floor_divide__cn.rst	统一/强化 inplace 描述并补充别名支持 note。
docs/api/paddle/cumulative_trapezoid_cn.rst	签名增加 `out`（keyword-only）并补充 axis 别名与 out 段落。
docs/api/paddle/count_nonzero_cn.rst	参数说明被误改（语义与默认值不一致，属于严重文档错误）。
docs/api/paddle/combinations_cn.rst	增加 `input` 别名说明。
docs/api/paddle/bernoulli_cn.rst	签名增加 `out`（keyword-only）并补充别名/out 段落。
docs/api/paddle/atan2_cn.rst	签名增加 `out`（keyword-only）并补充别名/out 段落。

Copilot · 2026-03-10T07:46:19Z

+   - **axis** (None|int|list|tuple，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int 或者 int 元素的列表。``axis`` 值应该在范围[-D， D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算中位数。默认值为 None。别名 ``dim``。
+   - **keepdim** (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度(减少的维度除外，减少的维度的大小为 1)。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 True。


count_nonzero 文档里 axis 的描述被误写为“计算中位数”，且 keepdim 的默认值写成了 True，与函数签名 keepdim=False 不一致；这会直接误导用户。建议恢复为 count_nonzero 的语义描述（统计非零元素个数），并将 keepdim 默认值与签名保持一致。

Suggested change

- **axis** (None|int|list|tuple，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int 或者 int 元素的列表。``axis`` 值应该在范围[-D， D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算中位数。默认值为 None。别名 ``dim``。

- **keepdim** (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度(减少的维度除外，减少的维度的大小为 1)。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 True。

- **axis** (None|int|list|tuple，可选) - 指定对 ``x`` 进行统计非零元素个数的轴。``axis`` 可以是 int 或者 int 元素的列表。``axis`` 值应该在范围 [-D，D) 内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 None，则对 ``x`` 的全部元素统计非零元素的个数。默认值为 None。别名 ``dim``。

- **keepdim** (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度（减少的维度除外，减少的维度的大小为 1）。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 False。

Copilot · 2026-03-10T07:46:19Z

    - **keepdim** （bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 1。
    - **name** （str，可选） - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

+关键字参数
+:::::::::
+    - **out** (tuple[Tensor, Tensor]，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。
+
 返回
 :::::::::
 tuple（Tensor），返回检索到的众数结果和对应索引信息。结果的数据类型和输入 ``x`` 一致。索引的数据类型是 int64。


mode 文档中 keepdim 参数说明写“默认值为 1”，但函数签名为 keepdim=False；另外 out 类型是 tuple[Tensor, Tensor]，描述里仍用“该 Tensor”指代单个 Tensor。建议将 keepdim 默认值与签名一致，并明确 out 为 (values, indices) 两个 Tensor 的元组。

Suggested change

- **keepdim** （bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 1。

- **name** （str，可选） - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数

:::::::::

- **out** (tuple[Tensor, Tensor]，可选) - 输出 Tensor，若不为 ``None``，计算结果将保存在该 Tensor 中，默认值为 ``None``。

返回

:::::::::

tuple（Tensor），返回检索到的众数结果和对应索引信息。结果的数据类型和输入 ``x`` 一致。索引的数据类型是 int64。

- **keepdim** （bool，可选）- 是否保留指定的轴。如果是 True，维度会与输入 x 一致，对应所指定的轴的 size 为 1。否则，由于对应轴被展开，输出的维度会比输入小 1。默认值为 False。

- **name** （str，可选） - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。

关键字参数

:::::::::

- **out** (tuple[Tensor, Tensor]，可选) - 输出结果元组 ``(values, indices)``，若不为 ``None``，计算得到的众数结果及其对应索引信息将分别保存在该元组中的两个 Tensor 中，默认值为 ``None``。

返回

:::::::::

tuple(Tensor, Tensor)，即 ``(values, indices)``。第一个 Tensor 为检索到的众数结果，数据类型和输入 ``x`` 一致；第二个 Tensor 为对应的索引信息，数据类型为 int64。

Copilot · 2026-03-10T07:46:19Z

 参数
 :::::::::
-    - **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。
+    - **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。别名 ``input``。


此处数据类型列表同时混用了英文逗号和中文顿号（bfloat16, float16, float32、float64），标点不一致。建议统一为中文文档常用格式（例如全部用 、 分隔），提升可读性与一致性。

Suggested change

- **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。别名 ``input``。

- **x** (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16、float16、float32、float64。别名 ``input``。

…frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent

…evelop

sunzhongkai588

LGTM

Copilot AI review requested due to automatic review settings March 10, 2026 07:42

zhwesky2010 requested review from Echo-Nie, jzhang533, mattheliu, ooooo-create and sunzhongkai588 as code owners March 10, 2026 07:42

Copilot started reviewing on behalf of zhwesky2010 March 10, 2026 07:43 View session

zhwesky2010 mentioned this pull request Mar 10, 2026

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent PaddlePaddle/PaConvert#852

Merged

Copilot AI reviewed Mar 10, 2026

View reviewed changes

zhwesky2010 force-pushed the 62 branch 4 times, most recently from b0e2f9f to e16f31d Compare March 10, 2026 14:30

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/…

b8dad74

…frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent

zhwesky2010 force-pushed the 62 branch from e16f31d to b8dad74 Compare March 13, 2026 13:14

Merge branch 'develop' of https://github.com/PaddlePaddle/docs into d…

aa48e94

…evelop

zhwesky2010 force-pushed the 62 branch from 61aa596 to aa48e94 Compare March 16, 2026 06:46

sunzhongkai588 approved these changes Mar 16, 2026

View reviewed changes

sunzhongkai588 merged commit 69ea06b into PaddlePaddle:develop Mar 16, 2026
5 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent#7853

[API Compatibility] pow_/remainder_/bernoulli/combinations/trapezoid/frexp/lgamma/kron/kthvalue/poisson/mode/mv Edit By AI Agent#7853
sunzhongkai588 merged 2 commits into
PaddlePaddle:developfrom
zhwesky2010:62

zhwesky2010 commented Mar 10, 2026 •

edited

Loading

Uh oh!

paddle-bot Bot commented Mar 10, 2026

Uh oh!

github-actions Bot commented Mar 10, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

Copilot AI Mar 10, 2026

Uh oh!

sunzhongkai588 left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		- axis (None\|int\|list\|tuple，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int 或者 int 元素的列表。``axis`` 值应该在范围[-D， D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算中位数。默认值为 None。别名 ``dim``。
		- keepdim (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度(减少的维度除外，减少的维度的大小为 1)。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 True。

	- x (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16, float16, float32、float64。别名 ``input``。
	- x (Tensor) - Tensor 的每个元素，对应泊松分布的 ``lambda`` 参数。数据类型为：bfloat16、float16、float32、float64。别名 ``input``。

Conversation

zhwesky2010 commented Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

paddle-bot Bot commented Mar 10, 2026

Uh oh!

github-actions Bot commented Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

sunzhongkai588 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

zhwesky2010 commented Mar 10, 2026 •

edited

Loading

github-actions Bot commented Mar 10, 2026 •

edited

Loading