Function resolve_doc_path

scripts/k.py:1476–1501

把用户传入的路径解析为绝对路径。支持相对项目根的路径，缺 .md 时自动补。 安全约束： - 解析后的路径必须落在 PROJECT_ROOT 内——拒绝绝对路径以及含 ../ 回到 PROJECT_ROOT 之外的相对路径，防止 web 端 ?path= 触发的路径遍历。 - 拒绝 my_thoughts/ 下的目标——人类专属区不可被读路径（outline / blocks / read-section / read-block 等）暴露内容（CLAUDE.md：my_thoughts 只读且不暴露）。 允许

(arg: str)

def resolve_doc_path(arg: str) -> Path:
    """把用户传入的路径解析为绝对路径。支持相对项目根的路径，缺 .md 时自动补。

    安全约束：
      - 解析后的路径必须落在 PROJECT_ROOT 内——拒绝绝对路径以及含 ../
        回到 PROJECT_ROOT 之外的相对路径，防止 web 端 ?path= 触发的路径遍历。
      - 拒绝 my_thoughts/ 下的目标——人类专属区不可被读路径（outline / blocks /
        read-section / read-block 等）暴露内容（CLAUDE.md：my_thoughts 只读且不暴露）。
        允许 wiki/ 与 raw/。
    """
    if Path(arg).is_absolute():
        raise ValueError(f"路径越界（拒绝绝对路径）：{arg}")
    arg = strip_workspace_prefix(arg)
    p = (PROJECT_ROOT / arg).resolve()
    try:
        rel = p.relative_to(PROJECT_ROOT.resolve())
    except ValueError:
        raise ValueError(f"路径越界（必须在 PROJECT_ROOT 内）：{arg}")
    # my_thoughts 人类专属区：不可读不暴露（即便 ../ 绕进来也挡）
    if rel.parts and rel.parts[0] == "my_thoughts":
        raise ValueError(f"human-only 区不可读（my_thoughts 人类专属）：{arg}")
    if not p.exists() and p.suffix == "":
        candidate = p.with_suffix(".md")
        if candidate.exists():
            return candidate
    return p


def load_or_build_outline(md_path: Path) -> dict: