Documentation
¶
Overview ¶
Package presets 提供 Agent Preset(代理预设)接缝。
对齐上游:packages/core/agent-preset
设计要点:
- AgentPreset 描述一组独立的 tools/prompt 组合;不同 preset 挂载到不同 Agent 实例后, 每个 Agent 拥有独立的工具集与系统提示词;
- 注册中心按 standingKey 组织:同一 key 的 preset 组合叠加(composeFrom), recompose 重建组合、select 按 key 选取。
Package presets 提供 Agent Preset 与 Permission Presets 组合旋钮。
对齐上游:packages/interaction/permission-presets
本文件对应任务 M28:Permission Presets 组合旋钮。
设计要点:
- PermissionPreset 是 {sandboxMode, approvalPolicy} 的组合元组;
- 内置 4 个预设:safe / danger / review / custom(custom 为派生/自定义基线, 其 sandbox 与 approval 由用户 override 派生,其余取基线);
- 提供 presetName → approvalPinkPolicy 的映射注入函数,供 approval.Service 使用, 从而避免 approval ↔ presets 的循环导入;
- 派生状态(DerivedState)暴露给 UI/SDK 读,反映预设 + 用户 override 后的最终形态。
Index ¶
Constants ¶
const ( PresetSafe = "safe" PresetDanger = "danger" PresetReview = "review" PresetCustom = "custom" )
Preset 命名常量。
Variables ¶
This section is empty.
Functions ¶
func ApprovalMapper ¶
ApprovalMapper 返回 preset 名 → 审批策略的映射函数(供 approval.Service 注入)。 未知预设回落 custom 的审批策略(ask-dangerous)。
func SandboxMapper ¶
func SandboxMapper() func(string) (sandbox.SandboxMode, bool)
SandboxMapper 返回 preset 名 → 沙箱模式的映射函数。
Types ¶
type AgentPreset ¶
type AgentPreset struct {
// Key 常驻键。
Key StandingKey
// Tools 工具名集合(该 preset 可用的工具白名单)。
Tools []string
// Prompt 系统提示词片段。
Prompt string
}
AgentPreset 是一个代理预设组合。
func ComposeFrom ¶
func ComposeFrom(key StandingKey, bases ...*AgentPreset) *AgentPreset
ComposeFrom 基于多个基础 preset 组合出一个新 preset(工具并集 + prompt 拼接)。
type DerivedState ¶
type DerivedState struct {
// ActivePreset 当前生效的预设名。
ActivePreset string `json:"activePreset"`
// SandboxMode 派生后的沙箱模式(含自定义 override)。
SandboxMode sandbox.SandboxMode `json:"sandboxMode"`
// ApprovalPolicy 派生后的审批策略。
ApprovalPolicy approval.Policy `json:"approvalPolicy"`
// IsCustom true 表示正使用自定义(非内置)派生状态。
IsCustom bool `json:"isCustom"`
}
DerivedState 是暴露给 UI/SDK 的派生权限状态(预设 + override 之后)。
func Derive ¶
func Derive(presetName string, sandboxOverride *sandbox.SandboxMode, approvalOverride *approval.Policy) DerivedState
Derive 基于指定预设 + 可选 override 派生最终状态。
- sandboxOverride / approvalOverride 非 nil 时覆盖对应字段(custom 派生);
- 返回 IsCustom 提示 UI/SDK 是否为自定义形态。
type PermissionPreset ¶
type PermissionPreset struct {
// Name 预设名。
Name string `json:"name"`
// SandboxMode 预设对应的沙箱模式。
SandboxMode sandbox.SandboxMode `json:"sandboxMode"`
// ApprovalPolicy 预设对应的审批策略。
ApprovalPolicy approval.Policy `json:"approvalPolicy"`
}
PermissionPreset 是权限预设的组合元组。
func Resolve ¶
func Resolve(name string) (PermissionPreset, bool)
Resolve 按预设名解析组合元组;未知预设返回 ok=false(调用方回落 custom)。
type PresetRegistry ¶
type PresetRegistry struct {
// contains filtered or unexported fields
}
PresetRegistry 是 Agent Preset 注册中心(基于 scope 分层,host 默认 + 覆盖)。
func (*PresetRegistry) Mount ¶
func (r *PresetRegistry) Mount(p *AgentPreset)
Mount 挂载一个 preset(到 host 层;同名覆盖,其余保留)。
func (*PresetRegistry) Recompose ¶
func (r *PresetRegistry) Recompose(p *AgentPreset)
Recompose 重建注册中心中某 key 的组合(用新 preset 覆盖)。
func (*PresetRegistry) Select ¶
func (r *PresetRegistry) Select(key StandingKey) (*AgentPreset, bool)
Select 按 key 选取 preset(nearest-scope-wins)。
type StandingKey ¶
type StandingKey string
StandingKey 是 preset 的常驻键(如 "code" / "research" / "default")。
func StandingKeyFor ¶
func StandingKeyFor(key StandingKey) StandingKey
StandingKeyFor 返回某 Agent 当前应使用的 standing key(简化:直接返回传入 key)。