Method validatePath

pkg/middleware/filesystem.go:234–281

validatePath 验证路径安全性 参考: deepagents/filesystem.py:87-129

(path string)

// validatePath 验证路径安全性
// 参考: deepagents/filesystem.py:87-129
func (m *FilesystemMiddleware) validatePath(path string) (string, error) {
	if !m.enablePathValidation {
		return path, nil
	}

	// 1. 检查路径遍历攻击
	if strings.Contains(path, "..") {
		return "", fmt.Errorf("路径遍历不允许(包含 '..'): %s", path)
	}

	if strings.HasPrefix(path, "~") {
		return "", fmt.Errorf("路径遍历不允许(以 '~' 开头): %s", path)
	}

	// 2. 规范化路径
	normalized := filepath.Clean(path)
	// 转换为 Unix 风格路径(统一使用 /)
	normalized = filepath.ToSlash(normalized)

	// 3. 确保路径以 / 开头
	if !strings.HasPrefix(normalized, "/") {
		normalized = "/" + normalized
	}

	// 4. 检查允许的前缀
	if len(m.allowedPathPrefixes) > 0 {
		allowed := false
		for _, prefix := range m.allowedPathPrefixes {
			// 规范化前缀(去掉尾部斜杠)
			normalizedPrefix := filepath.Clean(prefix)
			normalizedPrefix = filepath.ToSlash(normalizedPrefix)
			if !strings.HasPrefix(normalizedPrefix, "/") {
				normalizedPrefix = "/" + normalizedPrefix
			}

			// 检查前缀匹配(normalized == prefix 或 normalized 在 prefix 下)
			if normalized == normalizedPrefix || strings.HasPrefix(normalized, normalizedPrefix+"/") {
				allowed = true
				break
			}
		}
		if !allowed {
			return "", fmt.Errorf("路径必须以以下前缀之一开头 %v: %s", m.allowedPathPrefixes, normalized)
		}
	}

	return normalized, nil
}