master

yangchangjie12138[doc] 补齐文档导航并修复图片显示与断链

6c1d0df3Add on 16 days agoHistory

Files	Last commit	Last update
assets	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago
community	[doc] 补齐文档导航并修复图片显示与断链 Co-authored-by: st0rm60rn<lizijin1@huawei.com> # message auto-generated for no-merge-commit merge: !680 merge master into master [doc] 补齐文档导航并修复图片显示与断链 Created-by: st0rm60rn Commit-by: st0rm60rn Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue https://gitcode.com/Ascend/memcache/issues/388 # 问题/功能描述 # 修改方案描述 预期效果https://ascend-memcache-test.readthedocs.io/zh-cn/latest/community/ # 是否涉及UT/ST - [ ] 是 - [x] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!680	16 days ago
developer_guide	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago
getting_started	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago
source	[doc]新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档 Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !531 merge develop into develop [doc]新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档 Created-by: whytao Commit-by: whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue fixed: [#275](https://atomgit.com/Ascend/memcache/issues/275) # 问题/功能描述 # 修改方案描述 新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档。 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [ ] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [ ] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!531	2 months ago
user_guide	[doc] 补齐文档导航并修复图片显示与断链 Co-authored-by: st0rm60rn<lizijin1@huawei.com> # message auto-generated for no-merge-commit merge: !680 merge master into master [doc] 补齐文档导航并修复图片显示与断链 Created-by: st0rm60rn Commit-by: st0rm60rn Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue https://gitcode.com/Ascend/memcache/issues/388 # 问题/功能描述 # 修改方案描述 预期效果https://ascend-memcache-test.readthedocs.io/zh-cn/latest/community/ # 是否涉及UT/ST - [ ] 是 - [x] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!680	16 days ago
.nav.yaml	[doc] 补齐文档导航并修复图片显示与断链 Co-authored-by: st0rm60rn<lizijin1@huawei.com> # message auto-generated for no-merge-commit merge: !680 merge master into master [doc] 补齐文档导航并修复图片显示与断链 Created-by: st0rm60rn Commit-by: st0rm60rn Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue https://gitcode.com/Ascend/memcache/issues/388 # 问题/功能描述 # 修改方案描述 预期效果https://ascend-memcache-test.readthedocs.io/zh-cn/latest/community/ # 是否涉及UT/ST - [ ] 是 - [x] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!680	16 days ago
SECURITYNOTE.md	[fix] 敏感信息配置会隐藏打印 Co-authored-by: ZixiQu<quzixi@huawei.com> # message auto-generated for no-merge-commit merge: !592 merge sensitive_data into master [fix] 敏感信息配置会隐藏打印 Created-by: huawei_zixiqu Commit-by: ZixiQu Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [X] issue # 问题/功能描述 详见关联issue # 修改方案描述 configuration添加sensitive data region，拉起打印配置时会隐藏打印  # 是否涉及UT/ST - [X] 是 - [ ] 否（说明理由） # 开发自检 - [X] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [X] 规范：已关联issue或里程碑 - [X] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [X] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [X] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [X] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [X] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!592	1 month ago
c_cpp_naming.md	[doc]新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档 Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !531 merge develop into develop [doc]新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档 Created-by: whytao Commit-by: whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue fixed: [#275](https://atomgit.com/Ascend/memcache/issues/275) # 问题/功能描述 # 修改方案描述 新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档。 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [ ] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [ ] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!531	2 months ago
compatibility.md	[docs] 更新文档，引导用户最佳配置，并增加代码概览 Co-authored-by: ZixiQu<quzixi@huawei.com> # message auto-generated for no-merge-commit merge: !589 merge update_docs into master [docs] 更新文档，引导用户最佳配置，并增加代码概览 Created-by: huawei_zixiqu Commit-by: ZixiQu Merged-by: yrewzjsx Description: # 合入来源 - [X] 需求 - [ ] 问题单 - [ ] issue # 问题/功能描述 更新README # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [X] 否（说明理由）: 更新README # 开发自检 - [X] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [X] 规范：已关联issue或里程碑 - [X] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [X] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [X] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [X] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!589	1 month ago
devcontainer_quickstart.md	[doc]新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档 Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !531 merge develop into develop [doc]新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档 Created-by: whytao Commit-by: whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue fixed: [#275](https://atomgit.com/Ascend/memcache/issues/275) # 问题/功能描述 # 修改方案描述 新增版本说明书；将资料移至 docs/zh 目录下，并同步更新受影响文档。 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [ ] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [ ] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!531	2 months ago
index.md	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago
install_run.md	[doc] 补齐文档导航并修复图片显示与断链 Co-authored-by: st0rm60rn<lizijin1@huawei.com> # message auto-generated for no-merge-commit merge: !680 merge master into master [doc] 补齐文档导航并修复图片显示与断链 Created-by: st0rm60rn Commit-by: st0rm60rn Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue https://gitcode.com/Ascend/memcache/issues/388 # 问题/功能描述 # 修改方案描述 预期效果https://ascend-memcache-test.readthedocs.io/zh-cn/latest/community/ # 是否涉及UT/ST - [ ] 是 - [x] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!680	16 days ago
install_whl.md	[doc] 补齐文档导航并修复图片显示与断链 Co-authored-by: st0rm60rn<lizijin1@huawei.com> # message auto-generated for no-merge-commit merge: !680 merge master into master [doc] 补齐文档导航并修复图片显示与断链 Created-by: st0rm60rn Commit-by: st0rm60rn Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue https://gitcode.com/Ascend/memcache/issues/388 # 问题/功能描述 # 修改方案描述 预期效果https://ascend-memcache-test.readthedocs.io/zh-cn/latest/community/ # 是否涉及UT/ST - [ ] 是 - [x] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!680	16 days ago
memcache_c++_api.md	fix: distinguish SSD hits from GVA allocation failures Co-authored-by: yyang728<2533623867@qq.com> # message auto-generated for no-merge-commit merge: !651 merge master_fix_gva0 into master fix: distinguish SSD hits from GVA allocation failures Created-by: yyang728 Commit-by: yyang728 Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [x] 问题单 DTS2026101342919 - [x] issue # 问题/功能描述 在 vLLM layerwise 场景下，MemCache 启用 SSD，某些已写入的 key 被淘汰出 DRAM，仅保留 SSD 副本。 上层再次对这些 key 调用 batch_alloc 时，Client 持续报错： RegisterFromBatchAlloc: unexpected! register gva interval, gva:0, size:1330688 BatchMalloc: Register batch alloc gva info failed for key ..., ret:-1 重复申请可能由并发写入或存在性检查与申请之间的状态变化触发，因此不能仅靠上层提前查询规避。 ## 原因 1. Meta 发现 key 已存在，返回已有 SSD blob，并将申请结果返回为成功。 2. SSD blob 的 GVA 为 0，它不代表可写内存地址。 3. Client 直接取 blobs[0].gva_，未检查介质类型便登记本地区间。 4. 第一个 key 的 [0, size) 被错误登记；后续 key 再登记相同区间时发生冲突，返回 MMC_ERROR，产生上述日志。 # 修改方案描述 保持现有 batch_alloc 接口签名，调整返回值约定，并由 MemCache 和 vLLM 同步适配： | 返回值 | 含义 | 上层处理 | |---|---|---| | 0 | 申请失败 | 按失败逻辑处理，不写入 | | UINT64_MAX | 命中可读 SSD 数据，没有可写内存 GVA | 跳过写入 | | 正常 GVA | 可用的内存地址 | 执行写入及写完成通知 | ### 一、MemCache 修改 1. **调整重复申请路径的租约处理。** Meta 返回已有 blob 时，跳过 SSD blob 的写租约登记，保留 DRAM/HBM blob 原有的租约处理逻辑。 2. **按介质类型选择返回地址。** Client 不再直接使用 blobs[0]，而是查找 DRAM/HBM blob，避免 [SSD, DRAM] 顺序导致取到 SSD 的 GVA 0。只有可读 SSD 副本时，返回 UINT64_MAX，不登记本地区间。 3. **拦截无效区间登记。** RegisterFromBatchAlloc 拒绝 GVA 为 0、UINT64_MAX、size 为 0 或介质为 SSD 的描述符，防止登记无效或重叠区间。 4. **统一失败返回及文档。** 每个 key 的默认返回 GVA 为 0；申请或登记失败时保留该值。同步更新 C、C++ 和 Python API 文档。 ### 二、vLLM 侧适配逻辑 1. **适配两个特殊返回值。** 完整块、partial 块及 DSpark 保存路径识别 0 和 UINT64_MAX：申请失败沿用失败处理，SSD 命中跳过保存。 # 自验情况 1、新增边界值0、UINT64_MAX的gva的UT用例，均通过； 2、端到端跑测后vllm和memcache都没有gva 0报错 # 是否涉及UT/ST - [x] 是 - [ ] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!651	25 days ago
memcache_c_api.md	fix: distinguish SSD hits from GVA allocation failures Co-authored-by: yyang728<2533623867@qq.com> # message auto-generated for no-merge-commit merge: !651 merge master_fix_gva0 into master fix: distinguish SSD hits from GVA allocation failures Created-by: yyang728 Commit-by: yyang728 Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [x] 问题单 DTS2026101342919 - [x] issue # 问题/功能描述 在 vLLM layerwise 场景下，MemCache 启用 SSD，某些已写入的 key 被淘汰出 DRAM，仅保留 SSD 副本。 上层再次对这些 key 调用 batch_alloc 时，Client 持续报错： RegisterFromBatchAlloc: unexpected! register gva interval, gva:0, size:1330688 BatchMalloc: Register batch alloc gva info failed for key ..., ret:-1 重复申请可能由并发写入或存在性检查与申请之间的状态变化触发，因此不能仅靠上层提前查询规避。 ## 原因 1. Meta 发现 key 已存在，返回已有 SSD blob，并将申请结果返回为成功。 2. SSD blob 的 GVA 为 0，它不代表可写内存地址。 3. Client 直接取 blobs[0].gva_，未检查介质类型便登记本地区间。 4. 第一个 key 的 [0, size) 被错误登记；后续 key 再登记相同区间时发生冲突，返回 MMC_ERROR，产生上述日志。 # 修改方案描述 保持现有 batch_alloc 接口签名，调整返回值约定，并由 MemCache 和 vLLM 同步适配： | 返回值 | 含义 | 上层处理 | |---|---|---| | 0 | 申请失败 | 按失败逻辑处理，不写入 | | UINT64_MAX | 命中可读 SSD 数据，没有可写内存 GVA | 跳过写入 | | 正常 GVA | 可用的内存地址 | 执行写入及写完成通知 | ### 一、MemCache 修改 1. **调整重复申请路径的租约处理。** Meta 返回已有 blob 时，跳过 SSD blob 的写租约登记，保留 DRAM/HBM blob 原有的租约处理逻辑。 2. **按介质类型选择返回地址。** Client 不再直接使用 blobs[0]，而是查找 DRAM/HBM blob，避免 [SSD, DRAM] 顺序导致取到 SSD 的 GVA 0。只有可读 SSD 副本时，返回 UINT64_MAX，不登记本地区间。 3. **拦截无效区间登记。** RegisterFromBatchAlloc 拒绝 GVA 为 0、UINT64_MAX、size 为 0 或介质为 SSD 的描述符，防止登记无效或重叠区间。 4. **统一失败返回及文档。** 每个 key 的默认返回 GVA 为 0；申请或登记失败时保留该值。同步更新 C、C++ 和 Python API 文档。 ### 二、vLLM 侧适配逻辑 1. **适配两个特殊返回值。** 完整块、partial 块及 DSpark 保存路径识别 0 和 UINT64_MAX：申请失败沿用失败处理，SSD 命中跳过保存。 # 自验情况 1、新增边界值0、UINT64_MAX的gva的UT用例，均通过； 2、端到端跑测后vllm和memcache都没有gva 0报错 # 是否涉及UT/ST - [x] 是 - [ ] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!651	25 days ago
memcache_config.md	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago
memcache_python_api.md	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago
memcache_restful_api.md	feat: /metrics/summary 容量字段改为人类可读 Co-authored-by: Zixi Qu<quzixi@huawei.com> # message auto-generated for no-merge-commit merge: !674 merge optimize_metrics_summary into master feat: /metrics/summary 容量字段改为人类可读 Created-by: huawei_zixiqu Commit-by: Zixi Qu Merged-by: yangchangjie12138 Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 /metrics/summary 的容量字段 hbm_used / dram_used / ssd_used 直接输出字节整数，例如： text dram_used=28179398656/4509715660800 数字过长，排障时需要手工换算，可读性差。 关联 issue：#380 [Usage]: curl /metrics/summary 考虑自动换算单位 # 修改方案描述 - mmc_functions.h 新增 FormatBytesHuman()：按 1024 进制输出 B/KiB/MiB/GiB/TiB/PiB/EiB；数值 < 10 保留 1 位小数、>= 10 取整（对齐 free -h 的有效位风格）；处理 1023.5 以上的进位，避免出现 1024.0KiB。 - mmc_rest_api_facade.cpp 的 BuildUsedText() 改为调用该函数；并在 used/total 后追加使用率百分比（used/total*100，保留 2 位小数，total 为 0 时不输出）。/metrics/summary 输出变为： text hbm_used=360KiB/5.0GiB (0.01%) dram_used=0B/5.0GiB (0.00%) ssd_used=0B/0B dram_used=26GiB/4.1TiB (0.62%) - /metrics（Prometheus）保持精确字节输出不变；docs/zh/memcache_restful_api.md 同步容量字段格式，并注明需要精确字节时使用 /metrics。 - 新增 6 个 FormatBytesHuman UT（B/KiB/MiB/GiB/TiB/PiB/EiB、小数位规则、进位边界、UINT64_MAX、线上样例）；更新 MetricsContract 用例的期望串。 # 是否涉及UT/ST - [x] 是 - [ ] 否（说明理由） # 开发自检 - [x] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [x] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [x] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [x] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [x] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!674	18 days ago
mkdocs	[doc]构建wiki文档 Co-authored-by: st0rm60rn<lizijin1@huawei.com> Co-authored-by: whytao<weitao46@h-partners.com> # message auto-generated for no-merge-commit merge: !657 merge master into master [doc]构建wiki文档 Created-by: whytao Commit-by: st0rm60rn;whytao Merged-by: yrewzjsx Description: # 合入来源 - [ ] 需求 - [ ] 问题单 - [x] issue # 问题/功能描述 实际效果https://memcache-rtd.readthedocs.io/zh-cn/latest/ # 修改方案描述 # 是否涉及UT/ST - [ ] 是 - [ ] 否（说明理由） # 开发自检 - [ ] 规范：未超过1k；超过1k已完成备案；反合入需要标题注明【反合】 - [x] 规范：已关联issue或里程碑 - [ ] 规范：不需要UT/ST且已说明理由；需要且已包含UT/ST - [ ] 安全：涉及对外接口/参数/环境变量改动，并同步修改资料 - [ ] 安全：未引入三方开源软件；引入三方开源软件并经过安全评审 - [ ] 安全：未新增对外接口/参数；新增对外接口/参数有校验 - [x] 规范：未涉及资料改动；涉及资料改动并已完成修改 See merge request: Ascend/memcache!657	17 days ago