Method AppendNote

pkg/memory/memory.go:102–141

AppendNote 以追加模式写入一条记忆 file: 目标文件名(相对于 memoryPath) title: 记忆标题,为空时使用当前时间 content: 记忆内容正文

(ctx context.Context, file, title, content string)

// title: 记忆标题,为空时使用当前时间
// content: 记忆内容正文
func (m *Manager) AppendNote(ctx context.Context, file, title, content string) (string, error) {
	if file == "" {
		return "", errors.New("memory.AppendNote: file cannot be empty")
	}
	if strings.TrimSpace(content) == "" {
		return "", errors.New("memory.AppendNote: content cannot be empty")
	}

	path := m.resolvePath(file)

	// 尝试读取现有内容,不存在时视为空
	existing, err := m.backend.Read(ctx, path, 0, 0)
	if err != nil && !strings.Contains(strings.ToLower(err.Error()), "not found") {
		// 兼容不同 Backend 的错误信息,只在确定不是 "not found" 时返回错误
		return "", fmt.Errorf("memory.AppendNote: read existing content failed: %w", err)
	}

	noteTitle := strings.TrimSpace(title)
	if noteTitle == "" {
		noteTitle = time.Now().Format("2006-01-02 15:04:05")
	}

	section := fmt.Sprintf("## %s\n\n%s\n", noteTitle, strings.TrimSpace(content))

	var newContent string
	if strings.TrimSpace(existing) == "" {
		newContent = section
	} else {
		if !strings.HasSuffix(existing, "\n") {
			existing += "\n"
		}
		newContent = existing + "\n" + section
	}

	if _, err := m.backend.Write(ctx, path, newContent); err != nil {
		return "", fmt.Errorf("memory.AppendNote: write content failed: %w", err)
	}

	return path, nil
}

// OverwriteWithNote 使用单个 Note 覆盖整个记忆文件
// 与 AppendNote 不同,该方法会丢弃原有内容,仅保留新的标题与正文