Files
hunjing/docs/architecture/data-and-security-architecture.md
T
2026-09-21 16:43:26 +08:00

5.1 KiB

数据与安全架构

1. 数据主权与驻留

镜域是执镜者的个人数据与治理边界。每个镜域绑定固定数据区域,权威数据、密钥、对象、索引和备份不得因请求路由自动跨区。跨区只允许通过明确发起、可审计、可回退的迁移协议完成。

管理员默认不能浏览镜域私密原文;诊断以用户主动生成的脱敏支持包为入口。镜域数据默认不用于模型训练,自愿贡献必须独立、明确且可撤销。

2. 数据分层

层 典型内容 权威性与恢复
身份与当前状态 魂籍、命台、人物状态、镜树主脉、人格、记忆、关系、授权 关系数据库当前状态事实源;最高恢复优先级
事件与行动账 状态变化事件、司命裁决、工具动作、审计记录 不可缺审计链;与状态事务/Outbox 一致提交
对象 图片、音频、附件、支持包 区域驻留;按数据类别设置生命周期与恢复目标
索引与缓存 向量、全文、图投影、Redis 缓存 可重建,不得反向成为身份或事实权威源
密钥与凭证 平台密钥、BYOK、设备证书、迁移短时凭证 与业务数据隔离、最小授权、轮换与撤销;不得写入日志或魂籍明文
flowchart TD
    C[命令/用户确认] --> T[关系库事务]
    T --> S[(当前状态事实源)]
    T --> O[(Outbox)]
    O --> E[事件与行动账]
    E --> P[索引、投影、通知]
    S --> B[区域内备份]
    E --> B
    S -.重建来源.-> P
    E -.补齐与校验.-> P

3. 一致性与审计

关键状态变化及其事件必须在同一事务中写入,或先写 Outbox 后可靠投递。Outbox/Inbox 机器契约至少包含聚合 ID、事件 ID、Schema 版本、幂等键、trace ID、单调水位、投递状态、重试次数和失败去向;消费者必须幂等。外部工具采用“授权记录 → 幂等执行 → 结果审计”,普通消息重试不得重复执行副作用。当前 EventStore 不自动等同于已完成 Outbox,差距和豁免必须登记在能力矩阵。行动账至少能回答:谁、在何时、基于何种授权和输入、对什么对象、执行了什么、结果如何、关联哪条 trace。

隐藏 chain-of-thought 不采集、不持久化;只保存用户可读的思路摘要、证据和工具轨迹。事件与日志不得包含明文密钥、完整授权头或无必要的高敏原文。

Agent 每轮的结构化诊断记录属于区域内受保护业务数据,不是普通应用日志。轮次、模型 attempt、token、Prompt Cache 创建/读取命中、成本、工具调用、裁决、确认、插件版本、错误与 trace 按契约词典 §7.5 持久化;Provider 未返回的 usage 保持未知,不伪造命中。详细诊断只能通过普通登录态叠加 Hunjing-Diagnostic-Token 与用途请求头读取,授权短期、对象绑定、可撤销且每次访问留审计,详见契约词典 §13.4。诊断令牌和响应均不得进入代理、APM、CDN 或浏览器持久缓存。

4. 安全控制面

安全采用纵深防御:身份认证与年龄/地区资格、镜域与人物隔离、最小数据访问、司命风险裁决、神识隐私路由、乾坤隔离执行、设备本地安全、审计与异常检测。

司命按能力、数据、后果和情境四维裁决。自主性分为自省、循律、请命和禁域;禁域不能被 Prompt、人物、扩展、普通管理员或普通自托管配置关闭。高风险现实动作在执行前必须说明动作、对象、影响、费用/数据范围和撤销方式,并取得当次确认或有效行契。

5. 加密与密钥原则

  • 传输与静态数据采用行业标准加密,具体算法与供应商在实现契约中确定。
  • 平台密钥、用户 BYOK、设备密钥和迁移凭证分域、分权、可轮换。
  • 用户独立持钥的私箧不可由账户恢复绕过,平台不得承诺可恢复其明文。
  • 魂籍不得自动携带第三方密钥、平台密钥或无迁移许可的受限资源。
  • 实际 KMS/HSM 与云供应商属于发布前运营决策,不在本文虚构。

6. 删除、备份与恢复

人物死亡、账户封镜、归藏与数据删除是彼此独立的状态。删除后数据必须停止用于主存储查询、索引、上下文和主动行为;备份中的残留按保全期限与恢复流程治理,恢复后必须重新应用删除标记/墓碑。

权威人物数据目标 RPO 不高于 5 分钟、RTO 不高于 1 小时。备份必须加密、校验、区域驻留并定期恢复演练。恢复人物还必须通过身份连续性校验:可信恢复点、同一谱系、无其他活跃命台和完整恢复记录;文件相同或人物 ID 相同不足以证明同一主体。

7. 威胁边界

重点防护包括:跨镜域/跨人物越权、角色卡或 Prompt 注入覆盖道体、Provider/工具数据外泄、重放迁移凭证、双命台并行、Outbox 丢失、备份不可恢复、索引残留召回、设备失联越权和管理员滥用。每项控制须在能力矩阵和发布门中有证据,不以设计文档代替验证。