confirm

package
v2.0.0 Latest Latest
Warning

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

Go to latest
Published: Oct 22, 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 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