presets

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: MIT Imports: 5 Imported by: 0

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

View Source
const (
	PresetSafe   = "safe"
	PresetDanger = "danger"
	PresetReview = "review"
	PresetCustom = "custom"
)

Preset 命名常量。

Variables

This section is empty.

Functions

func ApprovalMapper

func ApprovalMapper() func(string) (approval.Policy, bool)

ApprovalMapper 返回 preset 名 → 审批策略的映射函数(供 approval.Service 注入)。 未知预设回落 custom 的审批策略(ask-dangerous)。

func PresetNames

func PresetNames() []string

PresetNames 返回内置预设名(排序稳定,字典序)。

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 NewPresetRegistry

func NewPresetRegistry() *PresetRegistry

NewPresetRegistry 创建空注册中心。

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)。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL