Closed
[Documentation|文档反馈]: 顶层核心入口 @asc.jit 及 asc.runtime 模块未包含在 docs/python-api/ 参考手册与 Sphinx 索引中 #55
XePWangAdd on Sep 12Closed at Sep 30
Sep 12 Assign wuzhenqing as responsible person
kong0808
Sep 12 Comments:
Sep 12 Comments:
您好!感谢关注和问题反馈。
我们将在docs/python-api/index.md补齐runtime/jit.md、runtime/compiler.md等缺失的内容;在docs/index.rst补齐python-api/rst/runtime/jit、python-api/rst/runtime/compiler等缺失内容,完整修复后进行合入。


Sep 12 Associated pull request
Sep 28 Associated pull request
Sep 30 Close issue
Thanks for sending an issue! Please fill in the following template to help quickly solve your problem.
Document Link / 文档链接 (Mandatory / 必填)
Issues Section / 问题文档片段 (Mandatory / 必填)
docs/python-api/index.md索引目录(第 9-16 行):# Python API * [asc.language.adv](language/adv.md) * [asc.language.basic](language/basic.md) * [asc.language.core](language/core.md) * [asc.language.fwk](language/fwk.md) * [asc.lib.host](lib/host.md)docs/index.rst目录树(第 12-20 行):python/asc/__init__.py(第 9-27 行):from .codegen.function_visitor import CodegenOptions from .runtime.compiler import CompileOptions from .runtime.jit import jit from .runtime.launcher import LaunchOptions from .language import * __all__ = ["CodegenOptions", "CompileOptions", "jit", "LaunchOptions"]Existing Issues / 存在的问题 (Optional / 选填)
根据华为 CANN 官方《Ascend C 算子开发指南》(核函数定义章节),在原生 C++ 中核函数必须通过
extern "C" __global__ __aicore__关键字声明。而在 PyAsc 项目的编程模型中,@asc.jit是将 Python 函数转译为 Ascend C 核函数、并调用毕昇编译器生成执行二进制文件的唯一核心入口修饰器。同时,控制编译器优化级别与同步机制的
CompileOptions(如kernel_type,opt_level,auto_sync,always_compile)以及控制硬件核数分配的LaunchOptions,均在python/asc/__init__.py顶层直接导出。然而在官方 API 手册
docs/python-api/index.md及 Sphinx 根目录docs/index.rst中:adv、basic、core、fwk、host)。asc.runtime与核心装饰器@asc.jit的任何 API 参考条目。用户在查阅官方 API 手册时,能查到算子函数(如
add),却查不到定义算子入口的核心函数@asc.jit的签名与参数说明。改进建议 / Suggested Improvement (Optional / 选填)
docs/python-api/下创建运行时模块文档目录(如docs/python-api/runtime/),为asc.jit、asc.runtime.compiler.CompileOptions、asc.runtime.launcher.LaunchOptions等核心接口编写规范的 API 参数说明。docs/python-api/index.md与docs/index.rst中增加对asc.runtime及asc.jit的导航链接。