MujicaUI/docs/components/270-file-change-card.md

270 FileChangeCard 文件变更卡片

用途

预览一个文件的变更：增删行数、首处修改附近的差异行，提供接受、拒绝和打开完整差异的入口。

最小示例

decision := mujica.FilePending
change := mujica.FileChange{Path: "ledger.md", Old: "Guests: 40\n", New: "Guests: 42\n"}
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	if mujica.FileChangeCard(c, &decision, change, mujica.FileChangeCardOptions{}).OpenDiff {
		fmt.Println("open the full diff")
	}
}
ui.Render(view, 400, 300, 1)

签名：func FileChangeCard(c *ui.Context, decision *FileDecision, change FileChange, opts FileChangeCardOptions) FileChangeResult。decision 为 nil、Path 为空或 Preview 为负时 panic。

参数

字段	类型	默认值	含义
Preview	int	8	从首处修改前两行起显示的差异行数。
Disabled	bool	false	禁止决定与打开差异。

状态

• FileChange 字段：Path、Old、New；Old 为空表示新文件，New 为空表示删除。
• 差异由 internal.LineDiff（Myers 行差异）计算，文本不变时只算一次。
• 新增行带“+”、删除行带“−”和行号，颜色只是辅助。
• 决定状态 FilePending、FileAccepted、FileRejected 以图标和文字显示；已决定后显示“撤销”。

事件

• Decided：*decision 被用户改变。
• OpenDiff：请求调用方打开完整差异。

键盘操作

• Tab 依次到“打开差异”“拒绝”“接受”（或“撤销”），Enter / Space 触发。

限制

• 只做行级差异；词级高亮由 Git 组扩展。