Documentation
¶
Overview ¶
Package confirm 放确认项(ConfirmItem)的纯函数:引用解析、选项指纹、决策卡转换、投递给智能体的文案。 不依赖存储层,便于表驱动测试;存储与 REST / MCP 在 store、api、mcp 包里。
Index ¶
- func ExportDecisionRows(views []DecisionView) []docs.DecisionExportRow
- func ExportDecisionRowsFromItems(parsed []docs.ParsedDecision, byKey map[string]*model.ConfirmItem) []docs.DecisionExportRow
- func ExportHash(docHash string, rows []docs.DecisionExportRow) string
- func FormatAnswerLine(item *model.ConfirmItem, optionIDs []string, note, custom string) string
- func FormatDismissLine(item *model.ConfirmItem, reason string) string
- func FormatMainAnswerLine(item *model.ConfirmItem, optionIDs []string, note, custom string) string
- func FormatRoutedAskLine(branchWF, branchTitle string, item *model.ConfirmItem, escalateMinutes int, ...) string
- func FromDecisionCard(card docs.DecisionCard) ([]model.ConfirmOption, string, bool, bool, string)
- func OptionsFingerprint(opts []model.ConfirmOption) string
- func ParseRef(ref string) (seq int, id uint, ok bool)
- func RecommendedOptionIDs(opts []model.ConfirmOption, multi bool) []string
- type DecisionView
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 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 确认项对齐。