confirm

package
v2.2.0 Latest Latest
Warning

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

Go to latest
Published: Nov 4, 2026 License: Apache-2.0 Imports: 11 Imported by: 0

Documentation

Overview

Package confirm 放确认项(ConfirmItem)的纯函数:引用解析、选项指纹、决策卡转换、投递给智能体的文案。 不依赖存储层,便于表驱动测试;存储与 REST / MCP 在 store、api、mcp 包里。

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ExportDecisionRows

func ExportDecisionRows(views []DecisionView) []docs.DecisionExportRow

ExportDecisionRows 从对齐后的决策视图生成导出表行;围栏校验没过的不进表。

func ExportDecisionRowsFromItems

func ExportDecisionRowsFromItems(parsed []docs.ParsedDecision, byKey map[string]*model.ConfirmItem) []docs.DecisionExportRow

ExportDecisionRowsFromItems 在只有解析结果与确认项映射时生成导出行。

func ExportHash

func ExportHash(docHash string, rows []docs.DecisionExportRow) string

ExportHash 是导出清单里用来做「已知哈希」差量比较的哈希。 文档里的决策结果会随作答而变,但文档正文的哈希不变;如果只用正文哈希,智能体带着旧哈希来要差量时, 就会漏掉「决策刚被作答」的文档。所以有决策行的文档,把决策结果并进哈希。

func FormatAnswerLine

func FormatAnswerLine(item *model.ConfirmItem, optionIDs []string, note, custom string) string

FormatAnswerLine 生成投递到收件箱的单条答复文案。 智能体可能在很久之后才读到,所以不能只写「Q12 选 a」:带上标题与所选项的文案,读到就能行动。

用户写了自定义答复(#183,预设选项都不合适时的出路)时,它永远是最后一段(可能多行,原样保留), 前面依次是所选项(单选时没有)、备注。计划确认(kind=plan)上的自定义答复不等于批准,文案里直接写明, 免得智能体把它当成放行:它是修改意见,批准之前仍只做只读的准备。

func FormatDismissLine

func FormatDismissLine(item *model.ConfirmItem, reason string) string

FormatDismissLine 生成「用户放弃这个确认项」的收件箱文案。

func FormatMainAnswerLine added in v2.1.0

func FormatMainAnswerLine(item *model.ConfirmItem, optionIDs []string, note, custom string) string

FormatMainAnswerLine 生成「主会话代为定夺」的答复文案(#236 P2):在 FormatAnswerLine 前面写明这不是用户本人的答复, 分支里的智能体读到时能分清是谁拍的板(涉及它自己的底线规则时,要不要再向用户本人确认由它判断)。

func FormatRoutedAskLine added in v2.1.0

func FormatRoutedAskLine(branchWF, branchTitle string, item *model.ConfirmItem, escalateMinutes int, l2Guard bool) string

FormatRoutedAskLine 生成「分支里的请示路由给主会话」时写进主会话收件箱的一段话(#236 P2)。 主会话也可能很久之后才读到,所以把定夺需要的东西一次写全:编号、标题、风险档、说明、带 id 的选项,以及怎么答 / 怎么转交 / 多久会自动升级。 l2Guard 为真且请示是 L2 时,写明「平台兜底:只能转交」,免得主会话白答一次被拒绝。

func FromDecisionCard

func FromDecisionCard(card docs.DecisionCard) ([]model.ConfirmOption, string, bool, bool, string)

FromDecisionCard 把文档决策卡转成确认项字段:选项、默认选项、是否多选、是否允许备注、风险等级。 决策卡没写 default 时,用带推荐标记的第一个选项兜底,这样「采用推荐」与默认值不会各说各话。

func OptionsFingerprint

func OptionsFingerprint(opts []model.ConfirmOption) string

OptionsFingerprint 对选项列表做稳定哈希,用于检测文档决策卡的选项是否变化。 按选项 id 排序后再哈希:只是调换了选项顺序不算「选项变了」;增删选项、改文案、改推荐标记都算。

func ParseRef

func ParseRef(ref string) (seq int, id uint, ok bool)

ParseRef 解析 Q12 / q12 / 12 / 数据库 id。

func RecommendedOptionIDs

func RecommendedOptionIDs(opts []model.ConfirmOption, multi bool) []string

RecommendedOptionIDs 返回带推荐标记的选项 id:单选取第一个,多选取全部;没有推荐时返回 nil。

Types

type DecisionView

type DecisionView struct {
	Card       docs.DecisionCard    `json:"card"`
	StartLine  int                  `json:"start_line"`
	EndLine    int                  `json:"end_line"`
	Errors     []string             `json:"errors,omitempty"`
	Status     string               `json:"status"`
	StatusNote string               `json:"status_note,omitempty"`
	ConfirmRef string               `json:"confirm_ref,omitempty"`
	Answer     *model.ConfirmAnswer `json:"answer,omitempty"`
	AnsweredAt *time.Time           `json:"answered_at,omitempty"`
}

DecisionView 是文档决策卡与确认项对齐后的展示字段。

func EnrichDecisions

func EnrichDecisions(parsed []docs.ParsedDecision, byKey map[string]*model.ConfirmItem) []DecisionView

EnrichDecisions 把 ParseDecisions 的结果与文档 decision 确认项对齐。

Jump to

Keyboard shortcuts

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