Xử lý hàng loạt
Tổng quan
Dùng hành động thư mục trên thanh bên hoặc menu tương ứng trong trình duyệt tệp. Có thêm liên kết, trích khái niệm, sinh theo tiêu đề, dịch, trích nguyên văn, sửa Mermaid và công thức. Không có nghiên cứu thư mục tổng quát; sinh theo tiêu đề có thể bật nghiên cứu riêng.
Một lần chạy không phải giao dịch chung cho cả thư mục. Kết quả ghi thành công vẫn còn nếu tệp khác lỗi hoặc tác vụ bị hủy.
Cách hoạt động
Mô hình thực thi
- Chọn tác vụ và thư mục. Xác nhận chỉ chứa những tệp bạn muốn xử lý.
- Tác vụ thu tệp đủ điều kiện theo phần mở rộng và quy tắc chọn, loại đầu ra riêng của tác vụ khi có.
- Nó dùng nhà cung cấp/mô hình của tác vụ và báo tiến độ, lỗi, đích.
- Sau hoàn thành hoặc hủy, xem báo cáo và tệp trước khi thử lại.
Mặc định có thư mục con đối với thêm liên kết, trích khái niệm, sinh theo tiêu đề, trích nguyên văn, sửa Mermaid và công thức. Dịch thư mục mặc định chỉ gồm tệp con trực tiếp. Hồ sơ chọn nâng cao có thể thay đổi phạm vi và lọc khi bật cả chế độ nhà phát triển lẫn chọn tệp nâng cao. Kiểm tra hồ sơ thực tế; không giả định mọi tác vụ đều duyệt đệ quy như nhau.
Ghi đè
| Tác vụ | Kiểm tra trước khi chạy lại |
|---|---|
| Thêm liên kết | Mặc định tạo đầu ra riêng; kiểm tra hậu tố, thư mục và tùy chọn chuyển nguồn |
| Trích xuất khái niệm | Ghi chú có sẵn có thể nhận liên kết ngược khi bật; dò trùng là thao tác riêng |
| Sinh theo tiêu đề | Ghi nội dung vào nguồn đủ điều kiện rồi chuyển kết quả thành công sang complete nếu đích chưa có |
| Dịch | Có thể ghi đè bản dịch cùng tên; mặc định dùng _<language>.md |
| Sửa Mermaid / công thức | Sửa chính các ghi chú đã chọn; thử mẫu nhỏ và giữ bản sao lưu |
Không có cài đặt bỏ qua/thêm vào/thay thế chung cho mọi tác vụ. Với sinh theo tiêu đề, đích complete đã tồn tại chặn bước chuyển, không có nghĩa bước sinh trước đó bị bỏ qua. Kết quả phân biệt số tệp đã sinh và đã chuyển.
Kiểm soát đồng thời
Giữ batchConcurrency ở 1 cho đến khi mẫu đại diện thành công. Một số đường xử lý còn cần enableBatchParallelism để lập lịch song song; dịch thư mục dùng trực tiếp cấu hình đồng thời. Tăng đồng thời tăng tải nhà cung cấp, bộ nhớ và máy chủ cục bộ, không bảo đảm nhanh hơn.
Khoảng cách yêu cầu API và độ trễ giữa nhóm có thể giảm đột biến, nhưng không bảo đảm tránh hạn mức yêu cầu/token, giới hạn tài khoản hoặc tải từ ứng dụng dùng chung điểm cuối.
Cấu hình
| Cài đặt | Mặc định | Tác dụng |
|---|---|---|
batchConcurrency | 1 | Mức đồng thời yêu cầu ở đường xử lý áp dụng |
enableBatchParallelism | false | Bật lập lịch song song nơi được hỗ trợ |
batchSize | 50 | Kích thước nhóm ở đường lập lịch theo nhóm |
batchInterDelayMs | 1000 | Độ trễ giữa các nhóm khi áp dụng |
apiCallIntervalMs | 500 | Khoảng cách trong lập lịch yêu cầu đồng thời |
folderTaskIncludeSubfoldersMode | legacy | Giữ phạm vi thư mục con mặc định của từng tác vụ |
enableStableApiCall | false | Chế độ yêu cầu ổn định được bật riêng |
Mô hình theo tác vụ
Hành động thư mục dùng cùng lựa chọn nhà cung cấp/mô hình với tác vụ một tệp tương ứng. Kiểm tra trước khi gửi nội dung riêng tư. Truy xuất cục bộ tùy chọn cho sinh theo tiêu đề hàng loạt dùng một ảnh chụp chỉ mục từ đầu lần chạy, nên chỉnh sửa trong lúc chạy không âm thầm trộn vào kết quả truy xuất sau. Chạy đợt mới để đưa chỉnh sửa vào.
Ví dụ
Tạo trial-titles với hai ghi chú tiêu đề và không có tệp không liên quan. Chạy Tạo hàng loạt từ tiêu đề, xem nội dung, đích trial-titles_complete và số tệp đã sinh/đã chuyển/lỗi. Nếu một tệp lỗi, chẩn đoán riêng trước; chạy lại thư mục nguồn không tự tiếp tục chính xác phần chưa xong.
Hủy và khôi phục
Hủy dừng lập lịch mới và truyền tín hiệu đến yêu cầu được hỗ trợ. Lời gọi hoặc ghi đã được hệ thống ngoài chấp nhận có thể hoàn thành; nhà cung cấp kiểm soát tính phí. Chờ trạng thái ổn định rồi kiểm tra tệp hoàn thành và đường dẫn khôi phục/xung đột. Giữ kết quả khôi phục đến khi đã so với ghi chú hiện tại.
Gợi ý
- Chỉ dùng hồ sơ chọn sau khi xác minh các tệp thực sự khớp.
- Giảm đồng thời và xem hạn mức khi gặp 429.
- Phân biệt hủy, lỗi và hoàn thành.
- Giữ mẫu chưa sửa và bản sao lưu trước tác vụ thay đổi ghi chú.
Tiếp theo
- Quy trình: nối tác vụ với chính sách lỗi rõ ràng.
- Cấu hình: đường dẫn và mặc định.
- Khắc phục sự cố: chẩn đoán tệp bị lỗi.