AskaEth
eb1828ee7a
- 只翻注释/文档字符串：剥离注释后代码行逐字节不变（机械校验只剩允许的行尾注释形态） - 裁决编号与 design 节号（02.4.3 / 11.4.2 / design/05 §9 等）逐字保留 - 复核：go build 绿；orchestration 及其子包（audit/comm）测试绿；gofmt 干净
20 lines
1.2 KiB
Go
20 lines
1.2 KiB
Go
// Package audit 提供 Cyrene 编排设计所规定的子代理审计原语
|
||
// （DevDocs/design/05-子代理.md §3 与 §6），以及
|
||
// DevDocs/design/11-安全与权限.md §4 与 §8 里的安全/审计要求。
|
||
//
|
||
// 它有两半：
|
||
//
|
||
// - ContextAuditor 给主 agent 只读、可追溯地访问某个子代理的上下文
|
||
// （一个 []model.Message），使其能审计并定位子代理做过什么：整段上下文、
|
||
// 尾部窗口，或带上下行的关键词命中。它是作用于编排层交给它的消息列表之上的
|
||
// 纯值类型；不持有存储，也不持有策略。
|
||
//
|
||
// - Approver 记录对子代理敏感操作的「主代理代审授权」。它写入结构化审计日志
|
||
// （谁 / 什么 / 何时 / 结果），并产出前端短句「「xxx 想要干什么，
|
||
// 我审查后批准了」」。某项操作是否真的敏感、是否获准由上层策略决定；本包只
|
||
// 记录、叙述并返回结果模型 —— 绝不判断权限。
|
||
//
|
||
// 本包是叶子：只依赖标准库、internal/runtime/model 与 internal/logger，绝不导入 agent
|
||
// 循环或其他运行时包，因此能安放在 runtime/orchestration 内而不形成导入环。
|
||
package audit
|