接口介绍
按完整路径删除一份场景记忆。通过
path 指定目标，系统按指向类型执行删除：目标定位：通过
path 指定要删除的完整路径（必填）。支持文件与目录：
path 既可指向场景记忆文件（如 工作/交付物/2026Q1.md），也可指向目录（以 / 结尾，如 工作/交付物/）；删除目录时按系统约定的递归策略处理。项 | 值 |
HTTP 方法与路径 | POST /v2/scenario/rm |
HTTP 文档 | |
函数签名 | rm_scenario(path) |
说明：
path 由 JSON body 承载，无需 encodeURIComponent。若 path 不存在或不属于当前调用上下文，统一返回业务错误码 404。使用示例
# 删除单个文件result = client.rm_scenario(path="工作/交付物/2026Q1.md")# 递归删除整个目录result = client.rm_scenario(path="工作/交付物/")print(f"实际删除 {result['deleted_count']} 个节点")
说明：
请求参数
参数名 | 类型 | 必填 | 描述说明 |
path | str | 是 | 目标场景记忆的全路径（支持文件或目录）。系统会严格根据路径末尾是否包含斜杠 / 来判定删除行为，请谨慎传入： 单文件删除（末尾不带 /）：例如 "工作/交付物/2026Q1.md"，此时仅删除该指定文件。 目录级递归删除（末尾带 /）：例如 "工作/交付物/"，此时将彻底删除该目录及其下的所有子文件与子文件夹（高危操作，请务必前置二次确认）。 |
返回信息
返回字典包含被删除路径、实际删除节点数与请求追踪 ID：
{"path": "工作/交付物/2026Q1.md","deleted_count": 1,"trace_id": "tr-xxxxxxxx-xxxxxxxx"}
字段 | 类型 | 说明 |
path | str | 被成功执行删除操作的目标路径。 |
deleted_count | int | 整数类型，代表本次操作实际删除的文件总条数。 若执行的是单文件删除（路径不带 /），该值通常为 1。 若执行的是目录级递归删除（路径带 /），该值会显示该目录下被一并清空的所有文件总数（如 12），便于客户端向用户展示“已成功清理 X 个文件”的提示。 |
trace_id | str | 本次请求的全局链路追踪 ID，常用于审计高危删除行为。 |
错误处理
错误码 | 触发场景 | 处理建议 |
404 | path 不存在或不属于当前调用上下文。 | 请校验路径合法性。 |
500 | 服务端错误。 | 记录 trace_id 后重试或上报。 |
