Struct SessionPermissionCache 

pub struct SessionPermissionCache { /* private fields */ }

会话级权限缓存 — 记录用户 “always” 决策。

设计参考

• Oh-My-Pi: Map<string, "allow_always" | "reject_always">
• OpenCode: approved: Ruleset 累积规则
• katu: Ruleset 子集，只包含 Session 来源的 allow/deny 规则

线程安全

作为纯数据结构，线程安全由持有者负责（如 Arc<RwLock<SessionPermissionCache>>）。

Examples

use katu_core::permission::*;

let mut cache = SessionPermissionCache::new();

// 用户选择 "always allow bash(git *)"
cache.allow_always("bash", "git *");

// 下次检查时命中缓存
assert_eq!(cache.check("bash", "git pull"), Some(PermissionBehavior::Allow));
assert_eq!(cache.check("bash", "rm -rf /"), None); // 不在缓存中

Implementations

impl SessionPermissionCache

pub fn new() -> Self

创建空缓存。

pub fn allow_always( &mut self, permission: impl Into<String>, pattern: impl Into<String>, )

记录 “always allow”。

pub fn deny_always( &mut self, permission: impl Into<String>, pattern: impl Into<String>, )

记录 “always deny”。

pub fn check( &self, permission_key: &str, content: &str, ) -> Option<PermissionBehavior>

检查缓存 — 返回匹配的缓存决策。

使用 last-match-wins 语义。

pub fn len(&self) -> usize

缓存条目数量。

pub fn is_empty(&self) -> bool

是否为空。

pub fn clear(&mut self)

清空缓存。

pub fn to_ruleset(&self) -> Ruleset

转换为可持久化的 Ruleset（Session 来源）。

Trait Implementations

impl Clone for SessionPermissionCache

fn clone(&self) -> SessionPermissionCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SessionPermissionCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SessionPermissionCache

fn default() -> SessionPermissionCache

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionPermissionCache

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionPermissionCache

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.