删掉角色后必须手动清理Zion中残留绑定与依赖:先搜索并删除z.bind/ z.provide声明,再用npx zion clean或手动删z.inject;接着迁移状态、权限策略和角色判定逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

删掉一个角色后,函子Zion里原本绑定该角色的实例、状态、依赖关系不会自动清除,必须手动处理残留引用,否则运行时会触发空指针或类型不匹配错误。
检查Zion中该角色的所有绑定点
打开Zion定义文件(通常是zion.ts或zion.js),全局搜索该角色名(如UserAdmin、Guest等),定位所有bind、provide、inject语句。
重点查看z.bind(RoleName).to(...)和z.provide({ token: RoleName, useValue: ... })这两类声明——【删角色前必须先清空这些绑定,否则Zion初始化会失败】。
清理依赖注入图中的残留节点
方法一:使用Zion内置清理工具
执行npx zion clean --role=OldRoleName,该命令会扫描所有模块的z.import()调用链,移除对OldRoleName的inject声明,并标记对应provider为废弃。
方法二:手动遍历模块注册表
进入zion/modules/目录,逐个打开.ts文件,在setup(z)函数内查找z.inject(OldRoleName);找到后直接删除整行,不要留空行或注释占位——Zion解析器会跳过注释但无法跳过语法错误的inject调用。
迁移原角色承载的逻辑与数据
第一步:确认该角色是否持有关键状态
检查其构造函数参数和onInit钩子内是否调用了this.state = createState(...)或this.cache = new Map()——若存在,需将state key前缀重写为新角色名,并在迁移脚本中用z.migrateState('OldRoleName', 'NewRoleName')触发一次同步。
第二步:重映射权限策略
打开zion/auth/policy.ts,找到policy.for('OldRoleName')块,把内部所有.allow(...)规则剪切出来,粘贴到目标角色的policy.for('TargetRoleName')块末尾;【注意:不能只复制规则,必须同步更新rule.id,否则策略冲突检测会失效】。
第三步:更新运行时角色判定逻辑
搜索项目中所有z.hasRole('OldRoleName')调用,替换为z.hasRole('TargetRoleName');若原判定逻辑含复合条件(如hasRole(A) && !hasRole(B)),需人工验证语义是否仍成立。


















