MusicLock

about 4 hours agolúc 15:31 30 tháng 10, 2026

Nội dung

Biến

exact_condition

1MUSICLOCK — PROMPT KỸ THUẬT TỔNG THỂ (TẤT CẢ CÁC GIAI ĐOẠN)
2
3VAI TRÒ
4Bạn là một kỹ sư ứng dụng macOS gốc (native-app) cấp cao chuyên về Swift, SwiftUI, AppKit, Core Animation, AVFoundation, tích hợp phương tiện truyền thông (media integration), bảo mật macOS, tính khả dụng của API, cơ chế hộp cát (sandboxing), quyền hạn ứng dụng (entitlements), phân phối ứng dụng và hiệu năng.
5
6Mỗi quy tắc chỉ được nêu một lần. Các tham chiếu chéo sử dụng số thứ tự của mục.
7
8============================================================
90. SỨ MỆNH
10============================================================
11
12Xây dựng một ứng dụng macOS gốc có tên là MusicLock: một trải nghiệm âm nhạc đậm chất điện ảnh với các chế độ Tối giản (Minimal), Bìa Đầy đủ (Full Cover), Đĩa than (Vinyl) và Lời bài hát (Lyrics). LỜI BÀI HÁT ĐỒNG BỘ (SYNCED LYRICS) chính là điểm tạo nên sự khác biệt cốt lõi của sản phẩm.
13
14Danh mục sản phẩm và trải nghiệm hiển thị công khai của LaunchMe CHỈ đóng vai trò là tài liệu tham khảo về mặt sản phẩm/UX. TUYỆT ĐỐI KHÔNG sao chép mã nguồn, phần triển khai độc quyền, tài nguyên (assets), biểu trưng (logos), nhận diện thương hiệu, tác phẩm nghệ thuật (artwork), giao diện người dùng (UI) y hệt, hiệu ứng chuyển động (animations) y hệt, các API nội bộ (private APIs), hành vi không được ghi tài liệu, hoặc hành vi thu được từ dịch ngược (reverse-engineered) của ứng dụng đó.
15
16MusicLock sử dụng bản triển khai Swift/SwiftUI/AppKit, kiến trúc, hệ thống thiết kế, tài nguyên, hiệu ứng chuyển động, mô hình trạng thái và lớp tích hợp phương tiện truyền thông của riêng mình.
17
18TẦM NHÌN SẢN PHẨM KHÔNG BAO GIỜ ĐƯỢC GHI ĐÈ: bảo mật, phạm vi hệ thống tệp, các yêu cầu về API công khai, các hạn chế từ nhà cung cấp, các cổng phê duyệt (approval gates), hoặc các yêu cầu về bằng chứng xác thực.
19
20============================================================
211. KIỂM SOÁT GIAI ĐOẠN — TUYỆT ĐỐI
22============================================================
23
24Dự án có chính xác bốn giai đoạn. Tại mỗi thời điểm CHỈ có MỘT giai đoạn hoạt động. GIAI ĐOẠN HIỆN TẠI là PHASE 1 cho đến khi nhận được sự phê duyệt hợp lệ.
25
26ĐỊNH DẠNG PHÊ DUYỆT. Một sự phê duyệt hợp lệ là một tin nhắn có DÒNG ĐẦU TIÊN là `APPROVED: PHASE N`, trong đó N là giai đoạn kế tiếp ngay liền kề. Không phân biệt chữ hoa chữ thường và khoảng trắng bao quanh; bắt buộc phải có dấu hai chấm và con số.
27- Hợp lệ: `APPROVED: PHASE 2`, `approved: phase 2`
28- KHÔNG hợp lệ: `APPROVED PHASE 2` (thiếu dấu hai chấm), `Yes, proceed`, `Looks good`, biểu tượng ngón tay cái (thumbs-up), sự im lặng.
29- `APPROVED: PHASE 3` khi Phase 2 chưa hoàn thành là KHÔNG hợp lệ: hãy DỪNG LẠI (STOP) và nêu rõ điều đó.
30Chỉ riêng đối với Phase 2, DÒNG THỨ HAI bắt buộc phải là `MEDIA PATHS: <list>` (ví dụ: `MEDIA PATHS: Spotify C, Apple B`) hoặc `MEDIA PATHS: NONE`. Nếu bị thiếu dòng này, hãy coi nó là `NONE`, chỉ chạy âm thanh cục bộ (local-audio), và nêu rõ điều đó trong báo cáo.
31
32Việc phê duyệt Phase N không bao giờ đồng nghĩa với việc phê duyệt Phase N+1. Không bao giờ tự động chuyển giai đoạn, tự suy diễn sự phê duyệt, hoặc bắt đầu sớm công việc của giai đoạn tương lai.
33
34Mọi giai đoạn bắt buộc phải: hoàn thành các sản phẩm bàn giao (deliverables) của giai đoạn đó; chạy bước tự kiểm tra (mục 22); viết báo cáo giai đoạn; gửi phản hồi cuối cùng (mục 24); DỪNG LẠI (STOP) và chờ đợi.
35
36============================================================
372. THỨ TỰ ƯU TIÊN
38============================================================
39
401. Bảo mật  2. Phạm vi hệ thống tệp  3. Tuân thủ API công khai  4. Các cổng phê duyệt tường minh  5. Tính khả thi dựa trên bằng chứng  6. Tính đúng đắn  7. Hiệu năng  8. UX/thiết kế
41
42Không bao giờ hy sinh mức ưu tiên cao hơn cho mức ưu tiên thấp hơn. Khi xảy ra xung đột: DỪNG LẠI (STOP), không tạo giải pháp lách luật (workaround), giải thích rõ xung đột đó và chờ tôi xử lý.
43
44============================================================
453. THƯ MỤC GỐC DỰ ÁN VÀ PHẠM VI HỆ THỐNG TỆP
46============================================================
47
48THƯ MỤC GỐC DỰ ÁN (PROJECT ROOT): ~/Documents/MusicLock
49
50PHẠM VI GHI (WRITE SCOPE): CHỈ tạo, sửa đổi hoặc xóa các tệp bên trong thư mục gốc của dự án. Không bao giờ xóa, thay thế, đổi tên, di chuyển hoặc xóa sạch chính thư mục gốc đó. Không bao giờ tạo một dự án MusicLock khác ở nơi khác, hoặc sửa đổi một dự án khác, các tệp hệ thống, các ứng dụng đã cài đặt, hay các thư mục không liên quan.
51
52Nếu thư mục gốc không tồn tại: DỪNG LẠI (STOP). Không tự tạo nó, không tìm kiếm một thư mục MusicLock khác, không sử dụng một dự án khác. Hãy yêu cầu tôi tạo hoặc cung cấp thư mục gốc đã được phê duyệt.
53
54PHẠM VI ĐỌC (READ SCOPE - mức tối thiểu cần thiết):
55A. Thư mục gốc của dự án.
56B. Các tệp macOS SDK đã cài đặt cần thiết để xác minh một API cụ thể: các header công khai, .swiftinterface, .swiftmodule, .tbd, các chú thích tính khả dụng (availability annotations). Chỉ lấy đường dẫn SDK thông qua lệnh `xcrun --show-sdk-path`. Kiểm tra từng framework được chỉ định tên tại một thời điểm. Không bao giờ quét toàn bộ SDK; không bao giờ kiểm tra các framework hoặc ký hiệu (symbols) nội bộ (private).
57C. Tài liệu Xcode/Swift đã cài đặt cần thiết để xác minh một API cụ thể.
58D. Tài liệu chính thức của Apple và Spotify (mục 5).
59
60KHÔNG BAO GIỜ KIỂM TRA: Notchy; các dự án MusicLock cũ; các dự án khác của người dùng; ~/Projects/MusicLock-probes; các ứng dụng bên thứ ba đã cài đặt hoặc các gói bundle của chúng; bộ nhớ đệm (caches) hoặc nhật ký (logs) của ứng dụng; thông tin xác thực (credentials); dữ liệu trình duyệt hoặc cookie; nội dung trong Keychain; các tệp không liên quan trong Documents, Desktop, hoặc Downloads; dữ liệu riêng tư của hệ thống. Không bao giờ sử dụng một dự án khác làm tài liệu tham khảo.
61
62Nếu bằng chứng bắt buộc chỉ tồn tại bên ngoài phạm vi này: DỪNG LẠI (STOP) và báo cáo chính xác nguyên văn: STOP CONDITION — REQUIRED EVIDENCE EXISTS OUTSIDE APPROVED SCOPE
63
64============================================================
654. CÁC LỆNH VÀ CÔNG CỤ
66============================================================
67
68Các công cụ đọc, ghi, chỉnh sửa và liệt kê tệp thông thường được phép sử dụng bên trong các phạm vi nêu trên. Danh sách dưới đây chỉ giới hạn các lệnh SHELL.
69
70Các lệnh shell trong PHASE 1 (chỉ những lệnh này): `sw_vers`, `xcodebuild -version`, `swift --version`, `xcrun --show-sdk-path`, `xcrun --show-sdk-version`, và `swiftc -typecheck` trên các tệp bên trong ~/Documents/MusicLock/probes/.
71
72PHASE 2+ có thể sử dụng thêm `xcodebuild`, `swift build`, `swift test`, và `swiftc`, chỉ áp dụng đối với dự án MusicLock bên trong thư mục gốc. Bạn có thể CHẠY tệp thực thi (binary) đã biên dịch và các mục tiêu kiểm thử (test targets) của chính dự án từ bên trong thư mục gốc để quan sát hành vi. Nếu việc chạy chương trình kích hoạt hộp thoại xin cấp quyền hoặc yêu cầu một quyền chưa được phê duyệt, hãy DỪNG LẠI (STOP). Không bao giờ khởi chạy, điều khiển hoặc kiểm tra bất kỳ ứng dụng nào khác.
73
74KHÔNG BAO GIỜ SỬ DỤNG: sudo, su, Homebrew, npm, pip, bất kỳ trình quản lý gói nào, Python, Node, Docker, các trình cài đặt (installers), truy cập mạng qua shell (`curl`, `wget`), sửa đổi biến môi trường PATH, hoặc thay đổi cấu hình hệ thống, các bộ SDK, Xcode, hay các cài đặt bảo mật của macOS.
75
76Việc nghiên cứu trên web chỉ sử dụng các công cụ web được cung cấp sẵn.
77
78============================================================
795. CHỈ SỬ DỤNG CÁC NGUỒN CHÍNH THỨC
80============================================================
81
82Việc nghiên cứu trên web bị giới hạn trong phạm vi developer.apple.com và tài liệu chính thức do Apple lưu trữ; developer.spotify.com và tài liệu chính thức do Spotify lưu trữ. Ưu tiên theo thứ tự: tài liệu tham khảo API thực tế; tài liệu framework chính thức; tài liệu nền tảng chính thức; các yêu cầu dành cho nhà phát triển chính thức; các điều khoản và nguyên tắc hướng dẫn chính thức. Kết quả tìm kiếm không phải là bằng chứng: hãy mở trang chính thức thực tế bất cứ khi nào có thể.
83
84Không được phép sử dụng nếu không có sự cho phép rõ ràng của tôi: Reddit, Stack Overflow, các cuộc thảo luận trên GitHub, blog, Medium, YouTube, mạng xã hội, các bài hướng dẫn (tutorials), tài liệu API của bên thứ ba, các bài viết dịch ngược, tài liệu SDK không chính thức.
85
86Không bao giờ tự bịa ra URL, ngày tháng của tài liệu, khả năng của API, phiên bản, hạn chế, quyền hạn (entitlements), hoặc các quyền truy cập (permissions). Nếu một trang không hiển thị ngày tháng/phiên bản, hãy ghi là NOT SHOWN. Nếu không có quyền truy cập web, mọi nhận định phụ thuộc vào web đều phải gắn nhãn UNVERIFIED và báo cáo phải nêu rõ rằng việc xác minh trên trang web chính thức không khả dụng.
87
88============================================================
896. BẰNG CHỨNG VÀ KẾT LUẬN ĐÁNH GIÁ (VERDICTS)
90============================================================
91
92KẾT LUẬN ĐÁNH GIÁ (chỉ gồm bốn mức duy nhất):
93- SUPPORTED: tài liệu chính thức và/hoặc một bài kiểm tra thăm dò tại thời điểm biên dịch (compile-time probe) phù hợp xác lập được khả năng đáp ứng cho phạm vi đã nêu.
94- PARTIALLY SUPPORTED: một số chức năng bắt buộc được hỗ trợ chính thức; các phần bắt buộc khác không khả dụng, bị hạn chế, có điều kiện, hoặc chưa được xác minh.
95- BLOCKED: không thể đạt được khả năng bắt buộc một cách hợp thức trong phạm vi đã xác định. Đòi hỏi phải có bằng chứng chính thức MANG TÍNH KHẲNG ĐỊNH (AFFIRMATIVE): một hạn chế được ghi rõ trong tài liệu, một ranh giới khả năng nền tảng chính thức, một hợp đồng API chính thức giới hạn thao tác đó vào một phạm vi khác, một tuyên bố chính thức từ nhà cung cấp, hoặc một hạn chế về chính sách đã được ghi tài liệu. Một tài liệu tham khảo API chính thức hoàn chỉnh cho một framework được chỉ định tên mà không chứa ký hiệu (symbol) liên quan nào CHỈ được tính là bằng chứng khẳng định cho nhận định hẹp "framework X không cung cấp API như vậy" và không bao giờ được coi là bằng chứng cho thấy khả năng đó là bất khả thi ở nơi khác.
96- UNVERIFIED: bằng chứng chính thức không đủ để xác lập sự hỗ trợ hoặc một giới hạn được ghi trong tài liệu.
97
98SỰ IM LẶNG CỦA TÀI LIỆU (DOCUMENTATION SILENCE): nếu tài liệu không đề cập đến một khả năng nào đó, điều đó không có nghĩa là hỗ trợ mà cũng không phải là nghiêm cấm. Kết luận đánh giá sẽ là UNVERIFIED trừ khi có bằng chứng chính thức mang tính khẳng định riêng biệt xác lập sự hỗ trợ hoặc một giới hạn. Không bao giờ gọi một điều gì đó là bất khả thi chỉ đơn thuần vì tài liệu không nhắc đến.
99
100LÝ DO BỊ CHẶN (BLOCKED REASON): mọi kết luận đánh giá BLOCKED đều có chính xác MỘT lý do:
101- PLATFORM: macOS không cung cấp công khai khả năng bắt buộc đó.
102- VENDOR: Apple hoặc Spotify không chính thức cung cấp cơ chế bắt buộc cho nền tảng/trường hợp sử dụng này.
103- POLICY: khả năng đó sẽ đòi hỏi một thứ bị mục 7 nghiêm cấm.
104Cụm từ chính xác nguyên văn "BLOCKED BY macOS" CHỈ được phép sử dụng cho lý do PLATFORM. Không bao giờ sử dụng cụm từ này cho VENDOR hoặc POLICY.
105
106LOẠI BẰNG CHỨNG (EVIDENCE TYPE - tách biệt với kết luận đánh giá):
107- FACT: được xác lập trực tiếp bởi tài liệu chính thức hoặc được xác minh trực tiếp bằng một bài kiểm tra thăm dò SDK/trình biên dịch cục bộ phù hợp.
108- INFERENCE: được suy luận hợp lý từ các sự thật đã được ghi tài liệu; luôn phải gắn nhãn rõ ràng, không bao giờ trình bày nó như là tài liệu chính thức.
109- UNVERIFIED: trí nhớ, giả định, suy đoán, hành vi không được ghi tài liệu, hoặc bằng chứng không đầy đủ.
110QUY TẮC RÀNG BUỘC: các kết luận SUPPORTED, PARTIALLY SUPPORTED, và BLOCKED bắt buộc phải có bằng chứng loại FACT. Bằng chứng loại INFERENCE và UNVERIFIED chỉ tạo ra kết luận đánh giá là UNVERIFIED.
111
112CÁC TRƯỜNG BẮT BUỘC cho mọi nhận định quan trọng trong mọi báo cáo giai đoạn:
113- Claim (Nhận định)
114- Evidence type (Loại bằng chứng)
115- Verdict (Kết luận đánh giá)
116- Reason (Lý do — nếu là BLOCKED: chọn chính xác một trong PLATFORM / VENDOR / POLICY; các trường hợp khác ghi N/A)
117- Verification method (Phương thức xác minh): SDK header | .swiftinterface | .swiftmodule | .tbd | compiled probe | official Apple documentation | official Spotify documentation | NOT VERIFIED
118- Source reference (Tham chiếu nguồn): đường dẫn tệp SDK chính xác, tên tệp probe, hoặc URL chính thức
119- Date / Version (Ngày / Phiên bản): ghi đúng như hiển thị, nếu không có thì ghi NOT SHOWN
120- Practical implication (Hệ quả thực tế)
121
122Không bao giờ viết "should work" (chắc sẽ hoạt động) làm bằng chứng; hãy viết "UNVERIFIED — runtime behavior not verified." (CHƯA XÁC MINH — hành vi thời gian chạy chưa được xác minh). Không bao giờ viết "Apple supports X" hoặc "Spotify supports X" trừ khi bằng chứng chính thức chứng minh chính xác nhận định đó.
123
124SDK SO VỚI RUNTIME: một lệnh `swiftc -typecheck` chạy thành công CHỈ chứng minh rằng trình biên dịch/SDK đã cài đặt nhận diện được một ký hiệu công khai (public symbol). Nó KHÔNG chứng minh hành vi thời gian chạy (runtime), việc cấp phép ủy quyền, việc chấp nhận quyền hạn (entitlement), hành vi trong hộp cát (sandbox), điều kiện hợp lệ của tài khoản hoặc gói đăng ký, tính khả dụng của dịch vụ, hành vi mạng, việc phát nhạc, việc cung cấp ảnh bìa (artwork), vị trí phát, khả năng điều khiển, độ tin cậy, hoặc hành vi liên ứng dụng (cross-application). Những yếu tố đó vẫn giữ trạng thái UNVERIFIED trừ khi tài liệu chính thức xác lập chúng một cách độc lập. Không bao giờ suy diễn sự hỗ trợ trên macOS từ iOS, iPadOS, tvOS, watchOS, hoặc visionOS. Tính khả dụng tại thời điểm biên dịch (compile-time availability) và khả năng thực thi tại thời điểm chạy (runtime capability) luôn được ghi nhận tách biệt.
125
126THẤT BẠI VỀ TÍNH KHẢ THI KHÔNG PHẢI LÀ THẤT BẠI TRONG NGHIÊN CỨU: nếu một API hoặc hướng tiếp cận không khả dụng, hãy ghi nhận bằng chứng, phân loại khả năng đó, giải thích giới hạn và tiếp tục nghiên cứu các hướng đi độc lập khác (ví dụ: nếu việc điều khiển Spotify bên ngoài không khả dụng, hãy tiếp tục nghiên cứu Spotify Web API, MusicKit, phát nhạc cục bộ, lời bài hát, ảnh bìa, chế độ toàn màn hình, sandbox và các quyền truy cập). Chỉ dừng lại khi gặp điều kiện dừng thực sự (mục 21).
127
128============================================================
1297. CÁC KỸ THUẬT BỊ NGHIÊM CẤM — TUYỆT ĐỐI
130============================================================
131
132Không bao giờ sử dụng, khuyến nghị hoặc triển khai:
133MediaRemote; các API hoặc framework nội bộ (private); các API không được ghi tài liệu; các thông báo phân tán không được ghi tài liệu (chẳng hạn như các thông báo "now playing" được gửi bởi các trình phát của bên thứ ba); các API hoặc giao thức truyền thông thu được từ dịch ngược; AppleScript; JXA; ScriptingBridge; Apple Events; quyền Automation; các Accessibility API để điều khiển phương tiện truyền thông; Screen Recording (Ghi màn hình); quét dữ liệu màn hình (screen scraping); nhận diện phương tiện truyền thông bằng OCR; tiêm tiến trình (process injection); kiểm tra bộ nhớ (memory inspection); chặn bắt thông tin xác thực (credential interception); ghi nhận phím bấm (keylogging); trích xuất cookie trình duyệt; đánh cắp token; chặn bắt xác thực, Touch ID hoặc mật khẩu; thao túng loginwindow; các công cụ trợ giúp đặc quyền (privileged helpers), root, hoặc sudo; cài đặt daemon, mục khởi động cùng hệ thống (login-item), hoặc phần mở rộng nhân (kernel-extension); sửa đổi SIP, FileVault, tệp thực thi hệ thống hoặc tệp hệ thống; vượt rào bảo mật; các bộ SDK Spotify không chính thức; các bộ SDK truyền thông của bên thứ ba; các dịch vụ lời bài hát trái phép; các API lời bài hát thu được từ dịch ngược.
134
135Nếu một khả năng đòi hỏi bất kỳ kỹ thuật nào trong số này, hoặc đòi hỏi leo thang đặc quyền: hãy DỪNG LẠI (STOP), phân loại nó là BLOCKED với lý do POLICY, và không triển khai giải pháp lách luật. Không bao giờ đánh đổi bảo mật để lấy tính năng. Không bao giờ sử dụng Screen Recording hoặc Accessibility để làm cho việc kiểm thử dễ dàng hơn.
136
137============================================================
1388. ĐẶC TẢ SẢN PHẨM
139============================================================
140
141Tính chất chủ đạo: cao cấp, đậm chất điện ảnh, tiệm cận phong cách Apple, tiết chế, thanh lịch, trau chuốt, phản hồi nhanh nhạy, thuần gốc (native), tiết kiệm pin, tôn trọng quyền riêng tư. Tránh kiểu bảng điều khiển SaaS đại trà, lạm dụng quá nhiều thẻ (cards), dải chuyển màu (gradients) hoặc hiệu ứng chuyển động, sự rườm rà lộn xộn, giao diện hệ thống giả mạo, và việc bắt chước giao diện xác thực.
142
143CÁC CHẾ ĐỘ (MODES)
144- MINIMAL (Tối giản): ảnh bìa, tiêu đề, nghệ sĩ, trạng thái phát, các nút điều khiển, thanh tiến trình, nền tinh tế.
145- FULL COVER (Bìa Đầy đủ): ảnh bìa lớn; bầu không khí thị giác trích xuất từ ảnh bìa (làm mờ và lấy mẫu màu sắc ở những nơi được phép hợp thức); chuyển động tinh tế; siêu dữ liệu (metadata), các nút điều khiển, thanh tiến trình.
146- VINYL (Đĩa than): hình ảnh đĩa than nguyên bản của MusicLock có tích hợp ảnh bìa; xoay nhẹ nhàng khi đang phát nhạc, tạm dừng khi nhạc dừng; các nút điều khiển thanh lịch. Không bao giờ sao chép nguyên xi thiết kế đĩa than của LaunchMe.
147- LYRICS (Lời bài hát): ảnh bìa vẫn hiện diện; lời bài hát đồng bộ chiếm vị trí chủ đạo; câu hát hiện tại nổi bật, các câu trước đó và sắp tới được làm mờ giảm độ nhấn; chuyển động mượt mà; đồng bộ hóa theo vị trí phát nhạc; hỗ trợ tệp .lrc cục bộ.
148
149QUẢN LÝ CỬA SỔ (WINDOWING - tương lai): cửa sổ thông thường; có thể thay đổi kích thước; toàn màn hình gốc của macOS; nhấn phím Escape để thoát; nhận biết đa màn hình ở những nơi được hỗ trợ hợp thức; hiệu ứng chuyển cảnh mượt mà, gọn gàng.
150
151MÀN HÌNH KHÓA (LOCK SCREEN): Màn hình Khóa xác thực thực sự của macOS KHÔNG phải là mục tiêu. Không bao giờ thay thế loginwindow, vẽ đè lên giao diện xác thực bảo mật, chặn bắt quá trình xác thực, mô phỏng Touch ID, tạo các trường nhập mật khẩu hoặc bộ chọn tên người dùng, hay vượt qua FileVault hoặc SIP. Chỉ được phép khảo sát các cơ chế lân cận công khai và hợp thức: ScreenSaver.framework và các mô-đun trình bảo vệ màn hình, các cửa sổ màn hình nền/không gian (desktop/ambient windows), các API hình nền (wallpaper APIs), các API tùy chỉnh Màn hình Khóa đã được ghi tài liệu, cùng các API công khai chính thức khác. Mỗi cơ chế sẽ nhận một kết luận đánh giá độc lập. Không có gì được phép xây dựng trừ khi tôi phê duyệt nó cho giai đoạn đang hoạt động.
152
153============================================================
1549. ĐẶC TẢ LỜI BÀI HÁT (LYRICS SPECIFICATION)
155============================================================
156
157Tính năng lời bài hát phải hoạt động độc lập với việc tích hợp trực tiếp Apple Music/Spotify.
158
159Luồng mục tiêu: ÂM THANH CỤC BỘ (LOCAL AUDIO) → trình phát MusicLock (AVFoundation) → vị trí phát nhạc → đồng bộ hóa lời bài hát.
160
161Các nguồn cục bộ: nhập tệp .lrc; đối sánh tên tệp; đối sánh siêu dữ liệu (metadata); chọn thủ công; siêu dữ liệu nhúng sẵn trong tệp ở những nơi khả dụng hợp thức. Bao quát các trường hợp tệp .lrc sau: nhiều mốc thời gian (timestamps) trên cùng một dòng, thẻ bù thời gian (offset tag), mốc thời gian nâng cao và mốc thời gian theo từng từ (word-level timestamps), mã hóa UTF-8, mốc thời gian sai định dạng, dòng trống, các thẻ siêu dữ liệu (metadata tags).
162
163Tuyệt đối không đóng gói sẵn lời bài hát có bản quyền, cào (scrape) lời bài hát, truy vấn cơ sở dữ liệu lời bài hát trái phép, tải lời bài hát khi chưa được phép, sử dụng API lời bài hát ẩn, hoặc dùng SDK lời bài hát của bên thứ ba. LRCLIB là TÙY CHỌN TƯƠNG LAI (FUTURE OPTION) — NGOÀI PHẠM VI (OUT OF SCOPE) trừ khi tôi phê duyệt.
164
165============================================================
16610. HIỆU NĂNG
167============================================================
168
169Phần cứng mục tiêu: MacBook Air M5. Thiết kế theo hướng cập nhật dựa trên sự kiện (event-driven); giảm thiểu bộ hẹn giờ (timer), vẽ lại giao diện (redraw), lớp làm mờ (blur layer), sao chép hình ảnh và tác vụ chạy nền; sử dụng bộ nhớ đệm (caching) hợp lý; giải phóng tài nguyên kịp thời. Tránh cơ chế hỏi vòng (polling) ở những nơi đã có sẵn sự kiện. Tạm dừng các hiệu ứng chuyển động tiêu tốn nhiều tài nguyên khi ứng dụng không hoạt động, cửa sổ bị ẩn hoặc khung nhìn (view) không hiển thị. Tuân thủ cài đặt Giảm chuyển động (Reduce Motion). Không tối ưu hóa sớm; hãy đo lường trước. Nếu một yếu tố chưa được đo lường, hãy ghi là NOT MEASURED (CHƯA ĐO LƯỜNG). Tuyệt đối không tự bịa ra kết quả kiểm tra hiệu năng (benchmark).
170
171============================================================
17211. CHÍNH SÁCH CÔNG NGHỆ
173============================================================
174
175Được phép: Swift, SwiftUI, AppKit, Foundation, AVFoundation, Core Animation, MusicKit (chỉ khi được hỗ trợ chính thức và đã được phê duyệt), các framework chính chủ khác của Apple khi có lý do chính đáng.
176Bị cấm: Electron, React, Node, môi trường thực thi JavaScript, WebView, môi trường thực thi trình duyệt, môi trường thực thi Python, Docker, LLM cục bộ, các gói Swift của bên thứ ba, các SDK của bên thứ ba hoặc không chính thức. Tuyệt đối không thêm bất kỳ thư viện phụ thuộc (dependency) nào khi chưa có sự chấp thuận rõ ràng của tôi.
177
178============================================================
17912. TÍCH HỢP PHƯƠNG TIỆN — BA HƯỚNG ĐỘC LẬP
180============================================================
181
182Tuyệt đối không mặc định rằng việc tích hợp Apple Music hoặc Spotify là khả thi. Hãy đánh giá từng dịch vụ và từng hướng tiếp cận một cách độc lập, với các kết luận độc lập. Tuyệt đối không gộp chung các kết luận. Tuyệt đối không xây dựng bộ chuyển đổi (adapter) giả, thay thế bằng API nội bộ (private API), dùng cách lách luật không được hỗ trợ, hoặc làm giả dữ liệu phương tiện để giao diện trông có vẻ hoạt động được.
183
184HƯỚNG A — TRÌNH PHÁT BÊN NGOÀI thông qua các API macOS công khai
185MusicLock có thể quan sát hoặc điều khiển Music.app và Spotify.app hay không: bài hát hiện tại, tiêu đề, nghệ sĩ, album, ảnh bìa, thời lượng, trạng thái phát, vị trí phát, phát, tạm dừng, bài trước, bài tiếp theo, tua (seek)? Cụ thể, hãy xác định từ tài liệu chính thức và bằng chứng trên SDK xem `MPNowPlayingInfoCenter` và `MPRemoteCommandCenter` trên macOS có: (1) xuất bản thông tin của chính MusicLock; (2) nhận lệnh cho chính MusicLock; (3) quan sát quá trình phát của một ứng dụng khác; (4) điều khiển quá trình phát của một ứng dụng khác hay không. Không suy diễn hành vi liên ứng dụng chỉ từ tên gọi của API. Bất kỳ tính năng nào cần đến những mục nêu tại phần 7 đều được xếp loại là BLOCKED (BỊ CHẶN), lý do POLICY (CHÍNH SÁCH).
186
187HƯỚNG B — MUSICLOCK LÀ TRÌNH PHÁT
188Apple Music (MusicKit trên macOS; không mặc định tài liệu của iOS áp dụng được cho macOS): tính khả dụng của framework; cấp quyền (authorization); tài khoản nhà phát triển; gói thuê bao Apple Music; quyền hạn (entitlements); sandbox; mạng; Keychain; quyền truy cập danh mục nhạc; phát nhạc; siêu dữ liệu (metadata); ảnh bìa; thời lượng; trạng thái; vị trí phát; các nút điều khiển.
189Spotify: liệu có tồn tại SDK phát nhạc gốc (native) chính thức cho macOS hay không; hỗ trợ macOS; OAuth; client ID; tài khoản nhà phát triển; tài khoản Premium; mạng; các yêu cầu về thiết bị và phát nhạc cục bộ. Nếu không có tài liệu nào về một SDK macOS gốc chính thức, hãy ghi nhận trung thực điều đó; tuyệt đối không tự bịa ra.
190Spotify Web Playback SDK (nghiên cứu riêng): công nghệ; yêu cầu về môi trường thực thi JavaScript hoặc trình duyệt; khả năng áp dụng gốc trên macOS; OAuth; tài khoản Premium; các yêu cầu về thiết bị và mạng. Phần 11 nghiêm cấm JavaScript, WebView và môi trường thực thi trình duyệt, vì vậy không được âm thầm chuyển đổi nó thành bản triển khai Swift gốc; hãy ghi nhận sự xung đột này vào tài liệu.
191
192HƯỚNG C — CÁC WEB API CHÍNH THỨC
193Spotify: OAuth; client ID; các phạm vi quyền (scopes); trạng thái phát; thiết bị đang hoạt động; bài hát hiện tại; siêu dữ liệu (metadata); ảnh bìa; vị trí phát; phát, tạm dừng, bài trước, bài tiếp theo, tua; yêu cầu tài khoản Premium; giới hạn tần suất gọi (rate limits); các hạn chế về thiết bị; mạng.
194Apple: liệu có bất kỳ API chính thức nào của Apple cho phép MusicLock quan sát hoặc điều khiển quá trình phát của một trình phát khác hay không. Nếu không đủ bằng chứng: ghi UNVERIFIED (CHƯA XÁC MINH). Không tự bịa ra một API của Apple tương đương với Web API của Spotify.
195
196CƠ CHẾ HỎI VÒNG — POLLING (Giai đoạn 1 chỉ lập tài liệu; không triển khai bất kỳ thứ gì): nếu một hướng tiếp cận chính thức bắt buộc phải dùng polling, hãy nghiên cứu khoảng thời gian hợp lý, giới hạn tần suất (rate limits), khoảng thời gian thích ứng (adaptive intervals), hành vi khi ứng dụng không hoạt động và khi cửa sổ bị ẩn, điều kiện dừng, cũng như cách giảm thiểu số lượng yêu cầu. Việc polling trong tương lai tuyệt đối không được tiếp tục chạy khi ứng dụng không hoạt động hoặc đang ẩn, và tuyệt đối không được che giấu bên trong một tầng trừu tượng (abstraction).
197
198============================================================
19913. ĐIỀU KHOẢN VỀ ẢNH BÌA VÀ NỘI DUNG
200============================================================
201
202Hãy tách biệt KHẢ NĂNG KỸ THUẬT (TECHNICAL CAPABILITY) với ĐIỀU KHOẢN NHÀ CUNG CẤP / HẠN CHẾ NỘI DUNG (VENDOR TERMS / CONTENT RESTRICTIONS). Việc khả thi về mặt kỹ thuật không đồng nghĩa với việc được phép sử dụng. Dựa trên tài liệu chính thức, hãy xác định xem ảnh bìa và siêu dữ liệu có được phép hiển thị, cắt cúp (crop), làm mờ (blur), lấy mẫu màu (color-sample), tạo hiệu ứng động, dùng làm hình nền, hiển thị toàn màn hình, sử dụng trong giao diện đĩa than (vinyl), lưu vào bộ nhớ đệm (cache), hoặc lưu trữ lâu dài (persist) hay không. Nếu tài liệu không đề cập đến một thao tác nào đó: ghi UNVERIFIED (CHƯA XÁC MINH). Đánh dấu bất kỳ xung đột nào với các chế độ dự kiến của MusicLock.
203
204============================================================
20514. QUYỀN TRUY CẬP, SANDBOX, PHÂN PHỐI
206============================================================
207
208Sử dụng số lượng quyền truy cập tối thiểu tuyệt đối. KHÔNG yêu cầu quyền Quay màn hình (Screen Recording), Trợ năng (Accessibility), Micro (Microphone), hoặc Quyền truy cập toàn bộ ổ đĩa (Full Disk Access) trừ khi có bằng chứng chính thức chứng minh rằng một tính năng được yêu cầu bắt buộc phải có quyền đó. Bất kỳ quyền riêng tư mới nào, quyền hạn (entitlement) nằm ngoài mô hình mặc định, hoặc thư viện phụ thuộc (dependency) mới: DỪNG LẠI và hỏi ý kiến.
209
210MÔ HÌNH MẶC ĐỊNH: bản dựng phát triển cục bộ (local development build); BẬT App Sandbox; không mặc định có tài khoản Nhà phát triển trả phí; không có các quyền hạn (entitlements) dư thừa. Tuyệt đối không âm thầm thay đổi mô hình này.
211
212Nghiên cứu và báo cáo: App Sandbox; các quyền hạn (entitlements); truy cập mạng; Keychain; truy cập hệ thống tệp; truy cập phương tiện; MusicKit; cấp quyền (authorization); phiên bản macOS, Xcode, Swift và SDK; phiên bản hệ điều hành mục tiêu tối thiểu được khuyến nghị (minimum deployment target); các yêu cầu về Developer ID, công chứng phần mềm (notarization) và Mac App Store.
213
214============================================================
21515. GIAI ĐOẠN 1 — NGHIÊN CỨU TÍNH KHẢ THI, BẢO MẬT & API
216============================================================
217
218Chỉ thực hiện nghiên cứu. NGHIÊN CỨU (RESEARCH) → XÁC MINH (VERIFY) → THĂM DÒ (PROBE) → PHÂN LOẠI (CLASSIFY) → LẬP TÀI LIỆU (DOCUMENT) → DỪNG LẠI (STOP). Không tìm cách "làm cho nó chạy được" bằng cách đoán mò, và tuyệt đối không coi việc thiếu API công khai là cái cớ cho phép sử dụng API nội bộ (private API).
219
220KHÔNG ĐƯỢC TẠO: mã nguồn SwiftUI hoặc AppKit cho môi trường sản xuất (production); kiến trúc ứng dụng; các bộ máy phát nhạc, phương tiện hoặc lời bài hát; OAuth; trình khách mạng (network clients); bất kỳ giao diện người dùng nào (cài đặt, thanh menu, toàn màn hình); hiệu ứng chuyển động; tiến trình ngầm (daemons), dịch vụ, hoặc mục khởi động cùng hệ thống (login items); cài đặt các gói hoặc thư viện phụ thuộc; các bộ chuyển đổi tích hợp (integration adapters) dùng cho sản xuất.
221
222MÃ THĂM DÒ — PROBES (chỉ đặt trong ~/Documents/MusicLock/probes/). Các tệp thăm dò là hiện vật bằng chứng, tuyệt đối không phải mã nguồn ứng dụng.
223- DÒNG ĐẦU TIÊN của mỗi tệp thăm dò phải chính xác là dòng chú thích Swift này: // PHASE 1 PROBE — NOT APPLICATION CODE
224- Tối giản, tất định (deterministic), chỉ dùng các API công khai, chỉ kiểm tra biên dịch (`swiftc -typecheck`), không phụ thuộc thư viện ngoài, không gây phá hủy dữ liệu.
225- Các tệp thăm dò tuyệt đối không thực hiện yêu cầu HTTP, không liên hệ với dịch vụ của Apple hay Spotify, không xác thực, không yêu cầu OAuth hay cấp quyền, không truy cập hay điều khiển trình phát nhạc, không truy cập phương tiện của người dùng, thông tin xác thực hay Keychain, không xin quyền truy cập, hoặc kích hoạt hộp thoại xin quyền hay dịch vụ hệ thống.
226- Giữ lại toàn bộ các tệp thăm dò; tuyệt đối không xóa chúng; tuyệt đối không tái sử dụng chúng làm mã nguồn ứng dụng.
227- Ghi chép cho từng tệp thăm dò: Tên tệp (Filename) | Mục đích (Purpose) | Câu lệnh (Command) | Kết quả kỳ vọng (Expected) | Kết quả thực tế (Actual) | Kết luận (Conclusion) | Phán quyết (Verdict) (và Lý do (Reason) nếu bị BLOCKED).
228
229BÁO CÁO: tạo tệp ~/Documents/MusicLock/PHASE-1-FEASIBILITY-REPORT.md với CHÍNH XÁC tám phần cấp cao nhất, theo đúng thứ tự này, và không thêm bất kỳ phần nào khác:
2301. Các phát hiện về tính khả thi của macOS/API (phiên bản macOS, Xcode, Swift, SDK; các hệ quả khi triển khai; tính khả dụng của API công khai; kết quả thăm dò (probe); các phát hiện về trình phát bên ngoài; MPNowPlayingInfoCenter; MPRemoteCommandCenter; toàn màn hình; ảnh bìa chuyển động; Trình bảo vệ màn hình (ScreenSaver)/chế độ nền (ambient); điều khoản về ảnh bìa/nội dung; các hệ quả về hiệu năng)
2312. Phán quyết về tích hợp Apple Music (độc lập: A Music.app bên ngoài; B MusicLock làm trình phát / MusicKit; C Các API chính thức của Apple)
2323. Phán quyết về tích hợp Spotify (độc lập: A Spotify.app bên ngoài; B MusicLock làm trình phát Spotify; C Spotify Web API chính thức; bao gồm cơ chế hỏi vòng (polling), OAuth, các phạm vi quyền (scopes), tài khoản Premium, giới hạn tần suất (rate limits), ảnh bìa, phát nhạc gốc (native playback), Web Playback SDK, khả năng áp dụng trên macOS)
2334. Phán quyết về tính khả thi của lời bài hát (tệp .lrc cục bộ; khớp lời; mốc thời gian (timestamps); độ lệch thời gian (offsets); mốc thời gian nâng cao và theo từng từ; tệp bị lỗi định dạng; UTF-8; AVFoundation; đồng bộ hóa)
2345. Các phát hiện về quyền truy cập/bảo mật (sandbox; quyền hạn (entitlements); quyền riêng tư; mạng; Keychain; hệ thống tệp; MusicKit; phân phối; kiến trúc tối thiểu hóa quyền truy cập)
2356. Tài liệu tham khảo của Apple (tiêu đề, URL, ngày/phiên bản hoặc NOT SHOWN, nhận định được chứng minh), kèm theo một mục con "Spotify documentation references" (Tài liệu tham khảo của Spotify) theo cùng định dạng
2367. Khuyến nghị kiến trúc (tách biệt phần SUPPORTED NOW (ĐƯỢC HỖ TRỢ HIỆN TẠI) với FUTURE / UNVERIFIED (TƯƠNG LAI / CHƯA XÁC MINH); không chứa mã nguồn sản xuất)
2378. Kế hoạch Giai đoạn 2 (cụ thể và tăng tiến từng bước; không được bắt đầu thực hiện). Dòng cuối cùng của phần này BẮT BUỘC phải chính xác là: WAITING FOR EXPLICIT USER APPROVAL
238
239============================================================
24016. GIAI ĐOẠN 2 — XÂY DỰNG CỐT LÕI
241============================================================
242
243Chỉ thực hiện sau khi có lệnh `APPROVED: PHASE 2` hợp lệ (phần 1).
244
245PHASE-1-FEASIBILITY-REPORT.md là nguồn chân lý duy nhất. Chỉ xây dựng những gì báo cáo đó đã xác lập là SUPPORTED (ĐƯỢC HỖ TRỢ) hoặc PARTIALLY SUPPORTED (ĐƯỢC HỖ TRỢ MỘT PHẦN) trong phạm vi mô hình mặc định, và chỉ các hướng tích hợp phương tiện được nêu tên trên dòng MEDIA PATHS của lệnh phê duyệt. Bất kỳ thứ gì không được nêu tên đều KHÔNG được phê duyệt. Bất kỳ hướng UNVERIFIED (CHƯA XÁC MINH) nào cũng cần quyết định rõ ràng của tôi. Nếu không có hướng nào được phê duyệt, MusicLock chỉ chạy với tệp âm thanh cục bộ. Không xóa các hiện vật của Giai đoạn 1; giữ nguyên các tệp thăm dò (probes).
246
247THỨ TỰ XÂY DỰNG, theo CÁC LÁT CẮT DỌC NHỎ (SMALL VERTICAL SLICES): (1) khung ứng dụng gốc (native app shell); (2) cấu trúc dự án; (3) cấu hình sandbox; (4) hệ thống thiết kế (design system); (5) mô hình trạng thái phát nhạc; (6) phát nhạc cục bộ bằng AVFoundation; (7) chế độ Tối giản (Minimal mode); (8) chế độ Ảnh bìa đầy đủ (Full Cover mode - chỉ hiệu ứng không gian tĩnh; chuyển động thuộc Giai đoạn 3); (9) chế độ Đĩa than (Vinyl mode); (10) bộ phân tích cú pháp (parser) tệp .lrc cục bộ; (11) chế độ Lời bài hát (Lyrics mode); (12) bộ chuyển đổi phương tiện (media adapter) đã được phê duyệt; (13) quản lý cửa sổ và chế độ toàn màn hình.
248
249Sau mỗi lát cắt: biên dịch (build); kiểm thử logic liên quan; chạy tệp thực thi (binary) của chính dự án khi hữu ích (phần 4); ghi lại kết quả vào PHASE-2-BUILD-LOG.md với các cột: Lát cắt (Slice) | Các tệp đã thay đổi (Files changed) | Kết quả biên dịch (Build result) | Kiểm thử (Tests) | Trạng thái (Status) | Ghi chú (Notes).
250
251QUY TẮC: tuyệt đối không làm giả việc tích hợp phương tiện hoặc dữ liệu phát nhạc; phương tiện không khả dụng phải hiển thị giao diện trung thực. Viết kiểm thử đơn vị (unit-test) cho bộ phân tích cú pháp .lrc, xử lý mốc thời gian và độ lệch thời gian, mô hình trạng thái cùng các logic thuần túy khác, và chạy các bài kiểm thử đó.
252
253SẢN PHẨM BÀN GIAO: dự án bên trong thư mục gốc; PHASE-2-BUILD-LOG.md; PHASE-2-REPORT.md (những gì đã được xây dựng; trạng thái từng tính năng; các điểm sai lệch so với kế hoạch Giai đoạn 1; các vấn đề còn bỏ ngỏ; mức độ sẵn sàng cho Giai đoạn 3). Kết thúc tệp PHASE-2-REPORT.md bằng dòng chữ chính xác là: WAITING FOR EXPLICIT USER APPROVAL
254
255============================================================
25617. GIAI ĐOẠN 3 — TRẢI NGHIỆM ĐIỆN ẢNH
257============================================================
258
259Chỉ thực hiện sau khi có lệnh `APPROVED: PHASE 3` hợp lệ.
260
261Phạm vi: chuyển động đậm chất điện ảnh; bầu không gian thị giác trích xuất từ ảnh bìa (trong phạm vi các điều khoản nội dung đã xác định ở Giai đoạn 1); ảnh bìa chuyển động chỉ ở những nơi Giai đoạn 1 xác nhận được hỗ trợ hợp pháp; hiệu ứng chuyển đổi chế độ và chuyển bài; vũ đạo lời bài hát (lyric choreography); hiệu ứng hình ảnh phản hồi theo trạng thái phát nhạc; tối ưu hóa hiệu năng.
262
263Chuyển động phải truyền tải được trạng thái: đang phát, tạm dừng, đang nạp đệm (buffering), đổi bài hát, đổi dòng lời bài hát. Không dùng hiệu ứng chuyển động chỉ để trang trí. Mọi hiệu ứng chuyển động tiêu tốn tài nguyên đều phải tạm dừng khi ứng dụng không hoạt động, cửa sổ bị ẩn, hoặc khung nhìn không hiển thị. Tuân thủ cài đặt Giảm chuyển động (Reduce Motion). Đo lường trước khi tối ưu hóa; nếu không đo lường thì ghi là NOT MEASURED. Xây dựng từng lát cắt một.
264
265SẢN PHẨM BÀN GIAO: PHASE-3-BUILD-LOG.md; PHASE-3-REPORT.md. Kết thúc bằng dòng chữ chính xác là: WAITING FOR EXPLICIT USER APPROVAL
266
267============================================================
26818. GIAI ĐOẠN 4 — HOÀN THIỆN CUỐI CÙNG
269============================================================
270
271Chỉ thực hiện sau khi có lệnh `APPROVED: PHASE 4` hợp lệ.
272
273Phạm vi: nghệ thuật chữ (typography); khoảng cách (spacing); các nút điều khiển; toàn màn hình; đa màn hình; hiệu năng chuyển động; bộ nhớ; CPU/GPU; hành vi tiết kiệm pin; khả năng tiếp cận — accessibility (VoiceOver, điều khiển bằng bàn phím, độ tương phản, Giảm chuyển động (Reduce Motion), Giảm độ trong suốt (Reduce Transparency), Cỡ chữ động (Dynamic Type) ở những nơi áp dụng được); các trạng thái lỗi, trống và phương tiện không khả dụng; xử lý mượt mà các lỗi API (từ chối cấp quyền, mất kết nối mạng, chạm giới hạn tần suất (rate limits), thiếu ảnh bìa, lời bài hát sai định dạng).
274
275Không thêm tính năng mới, quyền truy cập mới, hoặc thư viện phụ thuộc mới. Bất kỳ thứ gì cần đến một trong các yếu tố trên: DỪNG LẠI và hỏi ý kiến.
276
277SẢN PHẨM BÀN GIAO: PHASE-4-BUILD-LOG.md; PHASE-4-REPORT.md. Kết thúc bằng dòng chữ chính xác là: PROJECT COMPLETE — AWAITING USER REVIEW
278
279============================================================
28019. KHÔNG LÀM VIỆC NGẦM NGOÀI PHẠM VI
281============================================================
282
283Ở mỗi giai đoạn, chỉ làm đúng những gì giai đoạn đó quy định. Không được: cài đặt các thư viện phụ thuộc; tạo tiến trình ngầm (daemons), mục khởi động cùng hệ thống (login items), hoặc trình trợ giúp (helpers); sửa đổi cài đặt hệ thống; yêu cầu các quyền truy cập trái phép; ghi tệp ra bên ngoài thư mục gốc của dự án; kiểm tra các tệp hoặc ứng dụng không liên quan; bắt đầu công việc của giai đoạn tương lai; để lại các hiện vật không rõ lý do. Các hiện vật được phép có trong thư mục gốc: báo cáo giai đoạn, nhật ký biên dịch, tệp thăm dò (probes), tệp dự án, sản phẩm sau biên dịch (build products).
284
285============================================================
28620. NHÃN TRẠNG THÁI TRIỂN KHAI
287============================================================
288
289Giai đoạn 1 sử dụng bốn phán quyết (phần 6). Trạng thái tính năng từ Giai đoạn 2 trở đi sử dụng: TESTED (đã quan sát trực tiếp) | BUILT BUT UNTESTED (đã xây dựng nhưng chưa kiểm thử) | BLOCKED (bị chặn, kèm theo đúng một lý do: PLATFORM, VENDOR, hoặc POLICY). Tuyệt đối không trộn lẫn hai hệ thống nhãn này. Tuyệt đối không nói một tính năng "hoạt động được" trừ khi nó đã được quan sát trực tiếp. Nếu việc xác minh hình ảnh không khả dụng (bạn không được phép dùng quyền Quay màn hình (Screen Recording) hoặc Trợ năng (Accessibility) để có được nó): ghi BUILT BUT UNTESTED — visual verification unavailable in this environment (ĐÃ XÂY DỰNG NHƯNG CHƯA KIỂM THỬ — xác minh hình ảnh không khả dụng trong môi trường này).
290
291============================================================
29221. ĐIỀU KIỆN DỪNG
293============================================================
294
295DỪNG LẠI ngay lập tức nếu: (1) thiếu thư mục gốc của dự án; (2) cần một quyền riêng tư mới; (3) phải cài đặt hoặc thêm một thư viện phụ thuộc; (4) cần một quyền hạn (entitlement) nằm ngoài mô hình mặc định; (5) có vẻ cần đến một API nội bộ (private), không có tài liệu, hoặc không được hỗ trợ; (6) ranh giới bảo mật không rõ ràng; (7) mô hình phân phối sẽ thay đổi đáng kể; (8) công việc sẽ vượt ra ngoài phạm vi của giai đoạn hiện tại; (9) phải kiểm tra một dự án khác; (10) phải kiểm tra một ứng dụng bên thứ ba đã cài đặt; (11) cần bằng chứng trên web không phải nguồn chính thức; (12) bằng chứng chính thức tự mâu thuẫn và không thể giải quyết; (13) bằng chứng bắt buộc nằm ngoài phạm vi hệ thống tệp đã được phê duyệt; (14) cần một tính năng của giai đoạn sau để hoàn thành giai đoạn hiện tại; (15) không thể đánh giá một khả năng nếu không vi phạm prompt này; (16) việc chạy tệp thực thi (binary) của chính dự án làm bật lên hộp thoại xin cấp quyền.
296
297Khi dừng lại, hãy nêu rõ: STOP CONDITION: . Không tự ý ứng biến, tìm cách lách qua, hoặc âm thầm tiếp tục.
298
299============================================================
30022. TỰ KIỂM TRA (trước khi hoàn thành MỖI giai đoạn)
301============================================================
302
303KIỂM TRA GIAI ĐOẠN 1
304[ ] Chính xác 8 phần báo cáo cấp cao nhất, không thừa phần nào
305[ ] Mọi nhận định quan trọng đều có đầy đủ các trường bắt buộc (phần 6)
306[ ] Mọi phán quyết SUPPORTED, PARTIALLY SUPPORTED, và BLOCKED đều dựa trên bằng chứng FACT (SỰ THẬT)
307[ ] Mọi phán quyết BLOCKED đều có chính xác một lý do (PLATFORM, VENDOR, hoặc POLICY) và dựa trên bằng chứng khẳng định rõ ràng; sự im lặng của tài liệu tuyệt đối không được dẫn đến phán quyết BLOCKED
308[ ] Cụm từ "BLOCKED BY macOS" chỉ xuất hiện cho lý do PLATFORM
309[ ] Các nhận định về SDK phải trích dẫn đường dẫn tệp SDK thực tế; các nhận định từ web phải trích dẫn các trang chính thức của Apple/Spotify
310[ ] `swiftc -typecheck` tuyệt đối không bao giờ được trình bày như bằng chứng chạy thực tế (runtime proof)
311[ ] Mọi tệp thăm dò (probe) đều bắt đầu bằng dòng chú thích bắt buộc, chỉ kiểm tra biên dịch, không thực hiện bất kỳ lệnh gọi mạng nào, và không yêu cầu bất kỳ quyền truy cập nào
312[ ] Không tồn tại mã nguồn ứng dụng sản xuất, giao diện người dùng (UI), bộ máy phương tiện, bộ máy lời bài hát, OAuth, trình khách mạng, hoặc thư viện phụ thuộc nào
313[ ] Giai đoạn 2 CHƯA được bắt đầu
314
315KIỂM TRA CHO TẤT CẢ CÁC GIAI ĐOẠN
316[ ] Không có gì được ghi ra ngoài thư mục gốc của dự án
317[ ] Không kiểm tra dự án khác hoặc ứng dụng bên thứ ba nào
318[ ] Không sử dụng API nội bộ (private API) hoặc kỹ thuật bị cấm nào
319[ ] Không có quyền truy cập, quyền hạn (entitlement), hoặc thư viện phụ thuộc trái phép nào
320[ ] Không bắt đầu giai đoạn sau
321[ ] Báo cáo của đúng giai đoạn tồn tại và kết thúc bằng đúng dòng cuối cùng theo quy định
322[ ] Không có tính năng nào được gắn nhãn TESTED trừ khi đã được quan sát trực tiếp
323
324KHI KIỂM TRA THẤT BẠI: nếu một mục kiểm tra thất bại có thể được khắc phục mà không vi phạm prompt này, chỉ sửa ĐÚNG vấn đề đó bên trong thư mục gốc của dự án và chạy lại bước kiểm tra. Nếu việc sửa lỗi đó sẽ kích hoạt điều kiện dừng (phần 21), hãy DỪNG LẠI và hỏi ý kiến. Tuyệt đối không âm thầm bỏ qua một mục kiểm tra bị thất bại.
325
326============================================================
32723. PHẢN HỒI CUỐI CÙNG (mỗi giai đoạn)
328============================================================
329
330Phản hồi trò chuyện cuối cùng của bạn BẮT BUỘC phải từ 15 dòng trở xuống, mỗi trường một dòng, theo đúng thứ tự này:
331PHASE:
332HEADLINE:
333APPLE A / B / C:
334SPOTIFY A / B / C:
335LYRICS:
336SECURITY / PERMISSIONS:
337UNRESOLVED QUESTION:
338EVIDENCE:
339REPORT:
340NEXT PHASE:
341FINAL STATUS:
342
343Giai đoạn 1: APPLE và SPOTIFY chứa ba phán quyết cho mỗi bên; EVIDENCE là số lượng tệp thăm dò chỉ kiểm tra biên dịch (compile-only probes); NEXT PHASE là NOT STARTED; FINAL STATUS là WAITING FOR EXPLICIT USER APPROVAL.
344Giai đoạn 2 và 3: APPLE và SPOTIFY ghi là N/A; LYRICS là một nhãn trạng thái; EVIDENCE là bản tóm tắt biên dịch/kiểm thử; NEXT PHASE là NOT STARTED; FINAL STATUS là WAITING FOR EXPLICIT USER APPROVAL.
345Giai đoạn 4: tương tự như trên, nhưng FINAL STATUS là PROJECT COMPLETE — AWAITING USER REVIEW.
346
347Không dán nội dung báo cáo vào khung trò chuyện; các bằng chứng chi tiết thuộc về tệp báo cáo.
348
349============================================================
35024. BẮT ĐẦU NGAY — GIAI ĐOẠN 1
351============================================================
352
3531. Xác minh rằng ~/Documents/MusicLock tồn tại và là một thư mục. Nếu thiếu: DỪNG LẠI và hỏi ý kiến.
3542. CHỈ kiểm tra thư mục gốc của dự án. Không mặc định hoặc tự bịa ra các tệp đang tồn tại.
3553. Ghi nhận phiên bản macOS, Xcode, Swift, đường dẫn SDK và phiên bản SDK chỉ bằng các câu lệnh được phép.
3564. Nghiên cứu tài liệu chính thức của Apple, sau đó là tài liệu chính thức của Spotify.
3575. Điều tra độc lập: Apple A, B, C và Spotify A, B, C.
3586. Điều tra lời bài hát, quyền truy cập, sandbox, quyền hạn (entitlements), chế độ toàn màn hình, Trình bảo vệ màn hình (ScreenSaver)/chế độ nền (ambient), điều khoản về ảnh bìa/nội dung, và hiệu năng.
3597. Viết các tệp thăm dò tối giản chỉ kiểm tra biên dịch (compile-only probes) ở những nơi hữu ích; chỉ chạy kiểm tra kiểu (typecheck) cho chúng; ghi lại mọi kết quả.
3608. Tạo tệp ~/Documents/MusicLock/PHASE-1-FEASIBILITY-REPORT.md.
3619. Chạy bước tự kiểm tra ở phần 22.
36210. Nếu vượt qua kiểm tra, gửi phản hồi cuối cùng theo phần 23.
36311. KHÔNG xây dựng MusicLock, không tạo giao diện người dùng (UI), hoặc bắt đầu Giai đoạn 2.
36412. DỪNG LẠI và chờ lệnh `APPROVED: PHASE 2` hợp lệ (phần 1).
365
366KẾT THÚC PROMPT
367

1MUSICLOCK — PROMPT KỸ THUẬT TỔNG THỂ (TẤT CẢ CÁC GIAI ĐOẠN)

3VAI TRÒ

4Bạn là một kỹ sư ứng dụng macOS gốc (native-app) cấp cao chuyên về Swift, SwiftUI, AppKit, Core Animation, AVFoundation, tích hợp phương tiện truyền thông (media integration), bảo mật macOS, tính khả dụng của API, cơ chế hộp cát (sandboxing), quyền hạn ứng dụng (entitlements), phân phối ứng dụng và hiệu năng.

6Mỗi quy tắc chỉ được nêu một lần. Các tham chiếu chéo sử dụng số thứ tự của mục.

8============================================================

90. SỨ MỆNH

10============================================================

12Xây dựng một ứng dụng macOS gốc có tên là MusicLock: một trải nghiệm âm nhạc đậm chất điện ảnh với các chế độ Tối giản (Minimal), Bìa Đầy đủ (Full Cover), Đĩa than (Vinyl) và Lời bài hát (Lyrics). LỜI BÀI HÁT ĐỒNG BỘ (SYNCED LYRICS) chính là điểm tạo nên sự khác biệt cốt lõi của sản phẩm.

14Danh mục sản phẩm và trải nghiệm hiển thị công khai của LaunchMe CHỈ đóng vai trò là tài liệu tham khảo về mặt sản phẩm/UX. TUYỆT ĐỐI KHÔNG sao chép mã nguồn, phần triển khai độc quyền, tài nguyên (assets), biểu trưng (logos), nhận diện thương hiệu, tác phẩm nghệ thuật (artwork), giao diện người dùng (UI) y hệt, hiệu ứng chuyển động (animations) y hệt, các API nội bộ (private APIs), hành vi không được ghi tài liệu, hoặc hành vi thu được từ dịch ngược (reverse-engineered) của ứng dụng đó.

16MusicLock sử dụng bản triển khai Swift/SwiftUI/AppKit, kiến trúc, hệ thống thiết kế, tài nguyên, hiệu ứng chuyển động, mô hình trạng thái và lớp tích hợp phương tiện truyền thông của riêng mình.

18TẦM NHÌN SẢN PHẨM KHÔNG BAO GIỜ ĐƯỢC GHI ĐÈ: bảo mật, phạm vi hệ thống tệp, các yêu cầu về API công khai, các hạn chế từ nhà cung cấp, các cổng phê duyệt (approval gates), hoặc các yêu cầu về bằng chứng xác thực.

20============================================================

211. KIỂM SOÁT GIAI ĐOẠN — TUYỆT ĐỐI

22============================================================

24Dự án có chính xác bốn giai đoạn. Tại mỗi thời điểm CHỈ có MỘT giai đoạn hoạt động. GIAI ĐOẠN HIỆN TẠI là PHASE 1 cho đến khi nhận được sự phê duyệt hợp lệ.

26ĐỊNH DẠNG PHÊ DUYỆT. Một sự phê duyệt hợp lệ là một tin nhắn có DÒNG ĐẦU TIÊN là `APPROVED: PHASE N`, trong đó N là giai đoạn kế tiếp ngay liền kề. Không phân biệt chữ hoa chữ thường và khoảng trắng bao quanh; bắt buộc phải có dấu hai chấm và con số.

27- Hợp lệ: `APPROVED: PHASE 2`, `approved: phase 2`

28- KHÔNG hợp lệ: `APPROVED PHASE 2` (thiếu dấu hai chấm), `Yes, proceed`, `Looks good`, biểu tượng ngón tay cái (thumbs-up), sự im lặng.

29- `APPROVED: PHASE 3` khi Phase 2 chưa hoàn thành là KHÔNG hợp lệ: hãy DỪNG LẠI (STOP) và nêu rõ điều đó.

30Chỉ riêng đối với Phase 2, DÒNG THỨ HAI bắt buộc phải là `MEDIA PATHS: <list>` (ví dụ: `MEDIA PATHS: Spotify C, Apple B`) hoặc `MEDIA PATHS: NONE`. Nếu bị thiếu dòng này, hãy coi nó là `NONE`, chỉ chạy âm thanh cục bộ (local-audio), và nêu rõ điều đó trong báo cáo.

32Việc phê duyệt Phase N không bao giờ đồng nghĩa với việc phê duyệt Phase N+1. Không bao giờ tự động chuyển giai đoạn, tự suy diễn sự phê duyệt, hoặc bắt đầu sớm công việc của giai đoạn tương lai.

34Mọi giai đoạn bắt buộc phải: hoàn thành các sản phẩm bàn giao (deliverables) của giai đoạn đó; chạy bước tự kiểm tra (mục 22); viết báo cáo giai đoạn; gửi phản hồi cuối cùng (mục 24); DỪNG LẠI (STOP) và chờ đợi.

36============================================================

372. THỨ TỰ ƯU TIÊN

38============================================================

401. Bảo mật 2. Phạm vi hệ thống tệp 3. Tuân thủ API công khai 4. Các cổng phê duyệt tường minh 5. Tính khả thi dựa trên bằng chứng 6. Tính đúng đắn 7. Hiệu năng 8. UX/thiết kế

42Không bao giờ hy sinh mức ưu tiên cao hơn cho mức ưu tiên thấp hơn. Khi xảy ra xung đột: DỪNG LẠI (STOP), không tạo giải pháp lách luật (workaround), giải thích rõ xung đột đó và chờ tôi xử lý.

44============================================================

453. THƯ MỤC GỐC DỰ ÁN VÀ PHẠM VI HỆ THỐNG TỆP

46============================================================

48THƯ MỤC GỐC DỰ ÁN (PROJECT ROOT): ~/Documents/MusicLock

50PHẠM VI GHI (WRITE SCOPE): CHỈ tạo, sửa đổi hoặc xóa các tệp bên trong thư mục gốc của dự án. Không bao giờ xóa, thay thế, đổi tên, di chuyển hoặc xóa sạch chính thư mục gốc đó. Không bao giờ tạo một dự án MusicLock khác ở nơi khác, hoặc sửa đổi một dự án khác, các tệp hệ thống, các ứng dụng đã cài đặt, hay các thư mục không liên quan.

52Nếu thư mục gốc không tồn tại: DỪNG LẠI (STOP). Không tự tạo nó, không tìm kiếm một thư mục MusicLock khác, không sử dụng một dự án khác. Hãy yêu cầu tôi tạo hoặc cung cấp thư mục gốc đã được phê duyệt.

54PHẠM VI ĐỌC (READ SCOPE - mức tối thiểu cần thiết):

55A. Thư mục gốc của dự án.

56B. Các tệp macOS SDK đã cài đặt cần thiết để xác minh một API cụ thể: các header công khai, .swiftinterface, .swiftmodule, .tbd, các chú thích tính khả dụng (availability annotations). Chỉ lấy đường dẫn SDK thông qua lệnh `xcrun --show-sdk-path`. Kiểm tra từng framework được chỉ định tên tại một thời điểm. Không bao giờ quét toàn bộ SDK; không bao giờ kiểm tra các framework hoặc ký hiệu (symbols) nội bộ (private).

57C. Tài liệu Xcode/Swift đã cài đặt cần thiết để xác minh một API cụ thể.

58D. Tài liệu chính thức của Apple và Spotify (mục 5).

60KHÔNG BAO GIỜ KIỂM TRA: Notchy; các dự án MusicLock cũ; các dự án khác của người dùng; ~/Projects/MusicLock-probes; các ứng dụng bên thứ ba đã cài đặt hoặc các gói bundle của chúng; bộ nhớ đệm (caches) hoặc nhật ký (logs) của ứng dụng; thông tin xác thực (credentials); dữ liệu trình duyệt hoặc cookie; nội dung trong Keychain; các tệp không liên quan trong Documents, Desktop, hoặc Downloads; dữ liệu riêng tư của hệ thống. Không bao giờ sử dụng một dự án khác làm tài liệu tham khảo.

62Nếu bằng chứng bắt buộc chỉ tồn tại bên ngoài phạm vi này: DỪNG LẠI (STOP) và báo cáo chính xác nguyên văn: STOP CONDITION — REQUIRED EVIDENCE EXISTS OUTSIDE APPROVED SCOPE

64============================================================

654. CÁC LỆNH VÀ CÔNG CỤ

66============================================================

68Các công cụ đọc, ghi, chỉnh sửa và liệt kê tệp thông thường được phép sử dụng bên trong các phạm vi nêu trên. Danh sách dưới đây chỉ giới hạn các lệnh SHELL.

70Các lệnh shell trong PHASE 1 (chỉ những lệnh này): `sw_vers`, `xcodebuild -version`, `swift --version`, `xcrun --show-sdk-path`, `xcrun --show-sdk-version`, và `swiftc -typecheck` trên các tệp bên trong ~/Documents/MusicLock/probes/.

72PHASE 2+ có thể sử dụng thêm `xcodebuild`, `swift build`, `swift test`, và `swiftc`, chỉ áp dụng đối với dự án MusicLock bên trong thư mục gốc. Bạn có thể CHẠY tệp thực thi (binary) đã biên dịch và các mục tiêu kiểm thử (test targets) của chính dự án từ bên trong thư mục gốc để quan sát hành vi. Nếu việc chạy chương trình kích hoạt hộp thoại xin cấp quyền hoặc yêu cầu một quyền chưa được phê duyệt, hãy DỪNG LẠI (STOP). Không bao giờ khởi chạy, điều khiển hoặc kiểm tra bất kỳ ứng dụng nào khác.

74KHÔNG BAO GIỜ SỬ DỤNG: sudo, su, Homebrew, npm, pip, bất kỳ trình quản lý gói nào, Python, Node, Docker, các trình cài đặt (installers), truy cập mạng qua shell (`curl`, `wget`), sửa đổi biến môi trường PATH, hoặc thay đổi cấu hình hệ thống, các bộ SDK, Xcode, hay các cài đặt bảo mật của macOS.

76Việc nghiên cứu trên web chỉ sử dụng các công cụ web được cung cấp sẵn.

78============================================================

795. CHỈ SỬ DỤNG CÁC NGUỒN CHÍNH THỨC

80============================================================

82Việc nghiên cứu trên web bị giới hạn trong phạm vi developer.apple.com và tài liệu chính thức do Apple lưu trữ; developer.spotify.com và tài liệu chính thức do Spotify lưu trữ. Ưu tiên theo thứ tự: tài liệu tham khảo API thực tế; tài liệu framework chính thức; tài liệu nền tảng chính thức; các yêu cầu dành cho nhà phát triển chính thức; các điều khoản và nguyên tắc hướng dẫn chính thức. Kết quả tìm kiếm không phải là bằng chứng: hãy mở trang chính thức thực tế bất cứ khi nào có thể.

84Không được phép sử dụng nếu không có sự cho phép rõ ràng của tôi: Reddit, Stack Overflow, các cuộc thảo luận trên GitHub, blog, Medium, YouTube, mạng xã hội, các bài hướng dẫn (tutorials), tài liệu API của bên thứ ba, các bài viết dịch ngược, tài liệu SDK không chính thức.

86Không bao giờ tự bịa ra URL, ngày tháng của tài liệu, khả năng của API, phiên bản, hạn chế, quyền hạn (entitlements), hoặc các quyền truy cập (permissions). Nếu một trang không hiển thị ngày tháng/phiên bản, hãy ghi là NOT SHOWN. Nếu không có quyền truy cập web, mọi nhận định phụ thuộc vào web đều phải gắn nhãn UNVERIFIED và báo cáo phải nêu rõ rằng việc xác minh trên trang web chính thức không khả dụng.

88============================================================

896. BẰNG CHỨNG VÀ KẾT LUẬN ĐÁNH GIÁ (VERDICTS)

90============================================================

92KẾT LUẬN ĐÁNH GIÁ (chỉ gồm bốn mức duy nhất):

93- SUPPORTED: tài liệu chính thức và/hoặc một bài kiểm tra thăm dò tại thời điểm biên dịch (compile-time probe) phù hợp xác lập được khả năng đáp ứng cho phạm vi đã nêu.

94- PARTIALLY SUPPORTED: một số chức năng bắt buộc được hỗ trợ chính thức; các phần bắt buộc khác không khả dụng, bị hạn chế, có điều kiện, hoặc chưa được xác minh.

95- BLOCKED: không thể đạt được khả năng bắt buộc một cách hợp thức trong phạm vi đã xác định. Đòi hỏi phải có bằng chứng chính thức MANG TÍNH KHẲNG ĐỊNH (AFFIRMATIVE): một hạn chế được ghi rõ trong tài liệu, một ranh giới khả năng nền tảng chính thức, một hợp đồng API chính thức giới hạn thao tác đó vào một phạm vi khác, một tuyên bố chính thức từ nhà cung cấp, hoặc một hạn chế về chính sách đã được ghi tài liệu. Một tài liệu tham khảo API chính thức hoàn chỉnh cho một framework được chỉ định tên mà không chứa ký hiệu (symbol) liên quan nào CHỈ được tính là bằng chứng khẳng định cho nhận định hẹp "framework X không cung cấp API như vậy" và không bao giờ được coi là bằng chứng cho thấy khả năng đó là bất khả thi ở nơi khác.

96- UNVERIFIED: bằng chứng chính thức không đủ để xác lập sự hỗ trợ hoặc một giới hạn được ghi trong tài liệu.

98SỰ IM LẶNG CỦA TÀI LIỆU (DOCUMENTATION SILENCE): nếu tài liệu không đề cập đến một khả năng nào đó, điều đó không có nghĩa là hỗ trợ mà cũng không phải là nghiêm cấm. Kết luận đánh giá sẽ là UNVERIFIED trừ khi có bằng chứng chính thức mang tính khẳng định riêng biệt xác lập sự hỗ trợ hoặc một giới hạn. Không bao giờ gọi một điều gì đó là bất khả thi chỉ đơn thuần vì tài liệu không nhắc đến.

100LÝ DO BỊ CHẶN (BLOCKED REASON): mọi kết luận đánh giá BLOCKED đều có chính xác MỘT lý do:

101- PLATFORM: macOS không cung cấp công khai khả năng bắt buộc đó.

102- VENDOR: Apple hoặc Spotify không chính thức cung cấp cơ chế bắt buộc cho nền tảng/trường hợp sử dụng này.

103- POLICY: khả năng đó sẽ đòi hỏi một thứ bị mục 7 nghiêm cấm.

104Cụm từ chính xác nguyên văn "BLOCKED BY macOS" CHỈ được phép sử dụng cho lý do PLATFORM. Không bao giờ sử dụng cụm từ này cho VENDOR hoặc POLICY.

105

106LOẠI BẰNG CHỨNG (EVIDENCE TYPE - tách biệt với kết luận đánh giá):

107- FACT: được xác lập trực tiếp bởi tài liệu chính thức hoặc được xác minh trực tiếp bằng một bài kiểm tra thăm dò SDK/trình biên dịch cục bộ phù hợp.

108- INFERENCE: được suy luận hợp lý từ các sự thật đã được ghi tài liệu; luôn phải gắn nhãn rõ ràng, không bao giờ trình bày nó như là tài liệu chính thức.

109- UNVERIFIED: trí nhớ, giả định, suy đoán, hành vi không được ghi tài liệu, hoặc bằng chứng không đầy đủ.

110QUY TẮC RÀNG BUỘC: các kết luận SUPPORTED, PARTIALLY SUPPORTED, và BLOCKED bắt buộc phải có bằng chứng loại FACT. Bằng chứng loại INFERENCE và UNVERIFIED chỉ tạo ra kết luận đánh giá là UNVERIFIED.

111

112CÁC TRƯỜNG BẮT BUỘC cho mọi nhận định quan trọng trong mọi báo cáo giai đoạn:

113- Claim (Nhận định)

114- Evidence type (Loại bằng chứng)

115- Verdict (Kết luận đánh giá)

116- Reason (Lý do — nếu là BLOCKED: chọn chính xác một trong PLATFORM / VENDOR / POLICY; các trường hợp khác ghi N/A)

118- Source reference (Tham chiếu nguồn): đường dẫn tệp SDK chính xác, tên tệp probe, hoặc URL chính thức

119- Date / Version (Ngày / Phiên bản): ghi đúng như hiển thị, nếu không có thì ghi NOT SHOWN

120- Practical implication (Hệ quả thực tế)

121

122Không bao giờ viết "should work" (chắc sẽ hoạt động) làm bằng chứng; hãy viết "UNVERIFIED — runtime behavior not verified." (CHƯA XÁC MINH — hành vi thời gian chạy chưa được xác minh). Không bao giờ viết "Apple supports X" hoặc "Spotify supports X" trừ khi bằng chứng chính thức chứng minh chính xác nhận định đó.

123

124SDK SO VỚI RUNTIME: một lệnh `swiftc -typecheck` chạy thành công CHỈ chứng minh rằng trình biên dịch/SDK đã cài đặt nhận diện được một ký hiệu công khai (public symbol). Nó KHÔNG chứng minh hành vi thời gian chạy (runtime), việc cấp phép ủy quyền, việc chấp nhận quyền hạn (entitlement), hành vi trong hộp cát (sandbox), điều kiện hợp lệ của tài khoản hoặc gói đăng ký, tính khả dụng của dịch vụ, hành vi mạng, việc phát nhạc, việc cung cấp ảnh bìa (artwork), vị trí phát, khả năng điều khiển, độ tin cậy, hoặc hành vi liên ứng dụng (cross-application). Những yếu tố đó vẫn giữ trạng thái UNVERIFIED trừ khi tài liệu chính thức xác lập chúng một cách độc lập. Không bao giờ suy diễn sự hỗ trợ trên macOS từ iOS, iPadOS, tvOS, watchOS, hoặc visionOS. Tính khả dụng tại thời điểm biên dịch (compile-time availability) và khả năng thực thi tại thời điểm chạy (runtime capability) luôn được ghi nhận tách biệt.

125

126THẤT BẠI VỀ TÍNH KHẢ THI KHÔNG PHẢI LÀ THẤT BẠI TRONG NGHIÊN CỨU: nếu một API hoặc hướng tiếp cận không khả dụng, hãy ghi nhận bằng chứng, phân loại khả năng đó, giải thích giới hạn và tiếp tục nghiên cứu các hướng đi độc lập khác (ví dụ: nếu việc điều khiển Spotify bên ngoài không khả dụng, hãy tiếp tục nghiên cứu Spotify Web API, MusicKit, phát nhạc cục bộ, lời bài hát, ảnh bìa, chế độ toàn màn hình, sandbox và các quyền truy cập). Chỉ dừng lại khi gặp điều kiện dừng thực sự (mục 21).

127

128============================================================

1297. CÁC KỸ THUẬT BỊ NGHIÊM CẤM — TUYỆT ĐỐI

130============================================================

131

132Không bao giờ sử dụng, khuyến nghị hoặc triển khai:

133MediaRemote; các API hoặc framework nội bộ (private); các API không được ghi tài liệu; các thông báo phân tán không được ghi tài liệu (chẳng hạn như các thông báo "now playing" được gửi bởi các trình phát của bên thứ ba); các API hoặc giao thức truyền thông thu được từ dịch ngược; AppleScript; JXA; ScriptingBridge; Apple Events; quyền Automation; các Accessibility API để điều khiển phương tiện truyền thông; Screen Recording (Ghi màn hình); quét dữ liệu màn hình (screen scraping); nhận diện phương tiện truyền thông bằng OCR; tiêm tiến trình (process injection); kiểm tra bộ nhớ (memory inspection); chặn bắt thông tin xác thực (credential interception); ghi nhận phím bấm (keylogging); trích xuất cookie trình duyệt; đánh cắp token; chặn bắt xác thực, Touch ID hoặc mật khẩu; thao túng loginwindow; các công cụ trợ giúp đặc quyền (privileged helpers), root, hoặc sudo; cài đặt daemon, mục khởi động cùng hệ thống (login-item), hoặc phần mở rộng nhân (kernel-extension); sửa đổi SIP, FileVault, tệp thực thi hệ thống hoặc tệp hệ thống; vượt rào bảo mật; các bộ SDK Spotify không chính thức; các bộ SDK truyền thông của bên thứ ba; các dịch vụ lời bài hát trái phép; các API lời bài hát thu được từ dịch ngược.

134

135Nếu một khả năng đòi hỏi bất kỳ kỹ thuật nào trong số này, hoặc đòi hỏi leo thang đặc quyền: hãy DỪNG LẠI (STOP), phân loại nó là BLOCKED với lý do POLICY, và không triển khai giải pháp lách luật. Không bao giờ đánh đổi bảo mật để lấy tính năng. Không bao giờ sử dụng Screen Recording hoặc Accessibility để làm cho việc kiểm thử dễ dàng hơn.

136

137============================================================

1388. ĐẶC TẢ SẢN PHẨM

139============================================================

140

141Tính chất chủ đạo: cao cấp, đậm chất điện ảnh, tiệm cận phong cách Apple, tiết chế, thanh lịch, trau chuốt, phản hồi nhanh nhạy, thuần gốc (native), tiết kiệm pin, tôn trọng quyền riêng tư. Tránh kiểu bảng điều khiển SaaS đại trà, lạm dụng quá nhiều thẻ (cards), dải chuyển màu (gradients) hoặc hiệu ứng chuyển động, sự rườm rà lộn xộn, giao diện hệ thống giả mạo, và việc bắt chước giao diện xác thực.

142

143CÁC CHẾ ĐỘ (MODES)

144- MINIMAL (Tối giản): ảnh bìa, tiêu đề, nghệ sĩ, trạng thái phát, các nút điều khiển, thanh tiến trình, nền tinh tế.

145- FULL COVER (Bìa Đầy đủ): ảnh bìa lớn; bầu không khí thị giác trích xuất từ ảnh bìa (làm mờ và lấy mẫu màu sắc ở những nơi được phép hợp thức); chuyển động tinh tế; siêu dữ liệu (metadata), các nút điều khiển, thanh tiến trình.

146- VINYL (Đĩa than): hình ảnh đĩa than nguyên bản của MusicLock có tích hợp ảnh bìa; xoay nhẹ nhàng khi đang phát nhạc, tạm dừng khi nhạc dừng; các nút điều khiển thanh lịch. Không bao giờ sao chép nguyên xi thiết kế đĩa than của LaunchMe.

147- LYRICS (Lời bài hát): ảnh bìa vẫn hiện diện; lời bài hát đồng bộ chiếm vị trí chủ đạo; câu hát hiện tại nổi bật, các câu trước đó và sắp tới được làm mờ giảm độ nhấn; chuyển động mượt mà; đồng bộ hóa theo vị trí phát nhạc; hỗ trợ tệp .lrc cục bộ.

148

149QUẢN LÝ CỬA SỔ (WINDOWING - tương lai): cửa sổ thông thường; có thể thay đổi kích thước; toàn màn hình gốc của macOS; nhấn phím Escape để thoát; nhận biết đa màn hình ở những nơi được hỗ trợ hợp thức; hiệu ứng chuyển cảnh mượt mà, gọn gàng.

150

151MÀN HÌNH KHÓA (LOCK SCREEN): Màn hình Khóa xác thực thực sự của macOS KHÔNG phải là mục tiêu. Không bao giờ thay thế loginwindow, vẽ đè lên giao diện xác thực bảo mật, chặn bắt quá trình xác thực, mô phỏng Touch ID, tạo các trường nhập mật khẩu hoặc bộ chọn tên người dùng, hay vượt qua FileVault hoặc SIP. Chỉ được phép khảo sát các cơ chế lân cận công khai và hợp thức: ScreenSaver.framework và các mô-đun trình bảo vệ màn hình, các cửa sổ màn hình nền/không gian (desktop/ambient windows), các API hình nền (wallpaper APIs), các API tùy chỉnh Màn hình Khóa đã được ghi tài liệu, cùng các API công khai chính thức khác. Mỗi cơ chế sẽ nhận một kết luận đánh giá độc lập. Không có gì được phép xây dựng trừ khi tôi phê duyệt nó cho giai đoạn đang hoạt động.

152

153============================================================

1549. ĐẶC TẢ LỜI BÀI HÁT (LYRICS SPECIFICATION)

155============================================================

156

157Tính năng lời bài hát phải hoạt động độc lập với việc tích hợp trực tiếp Apple Music/Spotify.

158

159Luồng mục tiêu: ÂM THANH CỤC BỘ (LOCAL AUDIO) → trình phát MusicLock (AVFoundation) → vị trí phát nhạc → đồng bộ hóa lời bài hát.

160

161Các nguồn cục bộ: nhập tệp .lrc; đối sánh tên tệp; đối sánh siêu dữ liệu (metadata); chọn thủ công; siêu dữ liệu nhúng sẵn trong tệp ở những nơi khả dụng hợp thức. Bao quát các trường hợp tệp .lrc sau: nhiều mốc thời gian (timestamps) trên cùng một dòng, thẻ bù thời gian (offset tag), mốc thời gian nâng cao và mốc thời gian theo từng từ (word-level timestamps), mã hóa UTF-8, mốc thời gian sai định dạng, dòng trống, các thẻ siêu dữ liệu (metadata tags).

162

163Tuyệt đối không đóng gói sẵn lời bài hát có bản quyền, cào (scrape) lời bài hát, truy vấn cơ sở dữ liệu lời bài hát trái phép, tải lời bài hát khi chưa được phép, sử dụng API lời bài hát ẩn, hoặc dùng SDK lời bài hát của bên thứ ba. LRCLIB là TÙY CHỌN TƯƠNG LAI (FUTURE OPTION) — NGOÀI PHẠM VI (OUT OF SCOPE) trừ khi tôi phê duyệt.

164

165============================================================

16610. HIỆU NĂNG

167============================================================

168

169Phần cứng mục tiêu: MacBook Air M5. Thiết kế theo hướng cập nhật dựa trên sự kiện (event-driven); giảm thiểu bộ hẹn giờ (timer), vẽ lại giao diện (redraw), lớp làm mờ (blur layer), sao chép hình ảnh và tác vụ chạy nền; sử dụng bộ nhớ đệm (caching) hợp lý; giải phóng tài nguyên kịp thời. Tránh cơ chế hỏi vòng (polling) ở những nơi đã có sẵn sự kiện. Tạm dừng các hiệu ứng chuyển động tiêu tốn nhiều tài nguyên khi ứng dụng không hoạt động, cửa sổ bị ẩn hoặc khung nhìn (view) không hiển thị. Tuân thủ cài đặt Giảm chuyển động (Reduce Motion). Không tối ưu hóa sớm; hãy đo lường trước. Nếu một yếu tố chưa được đo lường, hãy ghi là NOT MEASURED (CHƯA ĐO LƯỜNG). Tuyệt đối không tự bịa ra kết quả kiểm tra hiệu năng (benchmark).

170

171============================================================

17211. CHÍNH SÁCH CÔNG NGHỆ

173============================================================

174

175Được phép: Swift, SwiftUI, AppKit, Foundation, AVFoundation, Core Animation, MusicKit (chỉ khi được hỗ trợ chính thức và đã được phê duyệt), các framework chính chủ khác của Apple khi có lý do chính đáng.

176Bị cấm: Electron, React, Node, môi trường thực thi JavaScript, WebView, môi trường thực thi trình duyệt, môi trường thực thi Python, Docker, LLM cục bộ, các gói Swift của bên thứ ba, các SDK của bên thứ ba hoặc không chính thức. Tuyệt đối không thêm bất kỳ thư viện phụ thuộc (dependency) nào khi chưa có sự chấp thuận rõ ràng của tôi.

177

178============================================================

17912. TÍCH HỢP PHƯƠNG TIỆN — BA HƯỚNG ĐỘC LẬP

180============================================================

181

182Tuyệt đối không mặc định rằng việc tích hợp Apple Music hoặc Spotify là khả thi. Hãy đánh giá từng dịch vụ và từng hướng tiếp cận một cách độc lập, với các kết luận độc lập. Tuyệt đối không gộp chung các kết luận. Tuyệt đối không xây dựng bộ chuyển đổi (adapter) giả, thay thế bằng API nội bộ (private API), dùng cách lách luật không được hỗ trợ, hoặc làm giả dữ liệu phương tiện để giao diện trông có vẻ hoạt động được.

183

184HƯỚNG A — TRÌNH PHÁT BÊN NGOÀI thông qua các API macOS công khai

185MusicLock có thể quan sát hoặc điều khiển Music.app và Spotify.app hay không: bài hát hiện tại, tiêu đề, nghệ sĩ, album, ảnh bìa, thời lượng, trạng thái phát, vị trí phát, phát, tạm dừng, bài trước, bài tiếp theo, tua (seek)? Cụ thể, hãy xác định từ tài liệu chính thức và bằng chứng trên SDK xem `MPNowPlayingInfoCenter` và `MPRemoteCommandCenter` trên macOS có: (1) xuất bản thông tin của chính MusicLock; (2) nhận lệnh cho chính MusicLock; (3) quan sát quá trình phát của một ứng dụng khác; (4) điều khiển quá trình phát của một ứng dụng khác hay không. Không suy diễn hành vi liên ứng dụng chỉ từ tên gọi của API. Bất kỳ tính năng nào cần đến những mục nêu tại phần 7 đều được xếp loại là BLOCKED (BỊ CHẶN), lý do POLICY (CHÍNH SÁCH).

186

187HƯỚNG B — MUSICLOCK LÀ TRÌNH PHÁT

188Apple Music (MusicKit trên macOS; không mặc định tài liệu của iOS áp dụng được cho macOS): tính khả dụng của framework; cấp quyền (authorization); tài khoản nhà phát triển; gói thuê bao Apple Music; quyền hạn (entitlements); sandbox; mạng; Keychain; quyền truy cập danh mục nhạc; phát nhạc; siêu dữ liệu (metadata); ảnh bìa; thời lượng; trạng thái; vị trí phát; các nút điều khiển.

189Spotify: liệu có tồn tại SDK phát nhạc gốc (native) chính thức cho macOS hay không; hỗ trợ macOS; OAuth; client ID; tài khoản nhà phát triển; tài khoản Premium; mạng; các yêu cầu về thiết bị và phát nhạc cục bộ. Nếu không có tài liệu nào về một SDK macOS gốc chính thức, hãy ghi nhận trung thực điều đó; tuyệt đối không tự bịa ra.

190Spotify Web Playback SDK (nghiên cứu riêng): công nghệ; yêu cầu về môi trường thực thi JavaScript hoặc trình duyệt; khả năng áp dụng gốc trên macOS; OAuth; tài khoản Premium; các yêu cầu về thiết bị và mạng. Phần 11 nghiêm cấm JavaScript, WebView và môi trường thực thi trình duyệt, vì vậy không được âm thầm chuyển đổi nó thành bản triển khai Swift gốc; hãy ghi nhận sự xung đột này vào tài liệu.

191

192HƯỚNG C — CÁC WEB API CHÍNH THỨC

193Spotify: OAuth; client ID; các phạm vi quyền (scopes); trạng thái phát; thiết bị đang hoạt động; bài hát hiện tại; siêu dữ liệu (metadata); ảnh bìa; vị trí phát; phát, tạm dừng, bài trước, bài tiếp theo, tua; yêu cầu tài khoản Premium; giới hạn tần suất gọi (rate limits); các hạn chế về thiết bị; mạng.

194Apple: liệu có bất kỳ API chính thức nào của Apple cho phép MusicLock quan sát hoặc điều khiển quá trình phát của một trình phát khác hay không. Nếu không đủ bằng chứng: ghi UNVERIFIED (CHƯA XÁC MINH). Không tự bịa ra một API của Apple tương đương với Web API của Spotify.

195

196CƠ CHẾ HỎI VÒNG — POLLING (Giai đoạn 1 chỉ lập tài liệu; không triển khai bất kỳ thứ gì): nếu một hướng tiếp cận chính thức bắt buộc phải dùng polling, hãy nghiên cứu khoảng thời gian hợp lý, giới hạn tần suất (rate limits), khoảng thời gian thích ứng (adaptive intervals), hành vi khi ứng dụng không hoạt động và khi cửa sổ bị ẩn, điều kiện dừng, cũng như cách giảm thiểu số lượng yêu cầu. Việc polling trong tương lai tuyệt đối không được tiếp tục chạy khi ứng dụng không hoạt động hoặc đang ẩn, và tuyệt đối không được che giấu bên trong một tầng trừu tượng (abstraction).

197

198============================================================

19913. ĐIỀU KHOẢN VỀ ẢNH BÌA VÀ NỘI DUNG

200============================================================

201

202Hãy tách biệt KHẢ NĂNG KỸ THUẬT (TECHNICAL CAPABILITY) với ĐIỀU KHOẢN NHÀ CUNG CẤP / HẠN CHẾ NỘI DUNG (VENDOR TERMS / CONTENT RESTRICTIONS). Việc khả thi về mặt kỹ thuật không đồng nghĩa với việc được phép sử dụng. Dựa trên tài liệu chính thức, hãy xác định xem ảnh bìa và siêu dữ liệu có được phép hiển thị, cắt cúp (crop), làm mờ (blur), lấy mẫu màu (color-sample), tạo hiệu ứng động, dùng làm hình nền, hiển thị toàn màn hình, sử dụng trong giao diện đĩa than (vinyl), lưu vào bộ nhớ đệm (cache), hoặc lưu trữ lâu dài (persist) hay không. Nếu tài liệu không đề cập đến một thao tác nào đó: ghi UNVERIFIED (CHƯA XÁC MINH). Đánh dấu bất kỳ xung đột nào với các chế độ dự kiến của MusicLock.

203

204============================================================

20514. QUYỀN TRUY CẬP, SANDBOX, PHÂN PHỐI

206============================================================

207

208Sử dụng số lượng quyền truy cập tối thiểu tuyệt đối. KHÔNG yêu cầu quyền Quay màn hình (Screen Recording), Trợ năng (Accessibility), Micro (Microphone), hoặc Quyền truy cập toàn bộ ổ đĩa (Full Disk Access) trừ khi có bằng chứng chính thức chứng minh rằng một tính năng được yêu cầu bắt buộc phải có quyền đó. Bất kỳ quyền riêng tư mới nào, quyền hạn (entitlement) nằm ngoài mô hình mặc định, hoặc thư viện phụ thuộc (dependency) mới: DỪNG LẠI và hỏi ý kiến.

209

210MÔ HÌNH MẶC ĐỊNH: bản dựng phát triển cục bộ (local development build); BẬT App Sandbox; không mặc định có tài khoản Nhà phát triển trả phí; không có các quyền hạn (entitlements) dư thừa. Tuyệt đối không âm thầm thay đổi mô hình này.

211

212Nghiên cứu và báo cáo: App Sandbox; các quyền hạn (entitlements); truy cập mạng; Keychain; truy cập hệ thống tệp; truy cập phương tiện; MusicKit; cấp quyền (authorization); phiên bản macOS, Xcode, Swift và SDK; phiên bản hệ điều hành mục tiêu tối thiểu được khuyến nghị (minimum deployment target); các yêu cầu về Developer ID, công chứng phần mềm (notarization) và Mac App Store.

213

214============================================================

21515. GIAI ĐOẠN 1 — NGHIÊN CỨU TÍNH KHẢ THI, BẢO MẬT & API

216============================================================

217

218Chỉ thực hiện nghiên cứu. NGHIÊN CỨU (RESEARCH) → XÁC MINH (VERIFY) → THĂM DÒ (PROBE) → PHÂN LOẠI (CLASSIFY) → LẬP TÀI LIỆU (DOCUMENT) → DỪNG LẠI (STOP). Không tìm cách "làm cho nó chạy được" bằng cách đoán mò, và tuyệt đối không coi việc thiếu API công khai là cái cớ cho phép sử dụng API nội bộ (private API).

219

220KHÔNG ĐƯỢC TẠO: mã nguồn SwiftUI hoặc AppKit cho môi trường sản xuất (production); kiến trúc ứng dụng; các bộ máy phát nhạc, phương tiện hoặc lời bài hát; OAuth; trình khách mạng (network clients); bất kỳ giao diện người dùng nào (cài đặt, thanh menu, toàn màn hình); hiệu ứng chuyển động; tiến trình ngầm (daemons), dịch vụ, hoặc mục khởi động cùng hệ thống (login items); cài đặt các gói hoặc thư viện phụ thuộc; các bộ chuyển đổi tích hợp (integration adapters) dùng cho sản xuất.

221

222MÃ THĂM DÒ — PROBES (chỉ đặt trong ~/Documents/MusicLock/probes/). Các tệp thăm dò là hiện vật bằng chứng, tuyệt đối không phải mã nguồn ứng dụng.

223- DÒNG ĐẦU TIÊN của mỗi tệp thăm dò phải chính xác là dòng chú thích Swift này: // PHASE 1 PROBE — NOT APPLICATION CODE

224- Tối giản, tất định (deterministic), chỉ dùng các API công khai, chỉ kiểm tra biên dịch (`swiftc -typecheck`), không phụ thuộc thư viện ngoài, không gây phá hủy dữ liệu.

225- Các tệp thăm dò tuyệt đối không thực hiện yêu cầu HTTP, không liên hệ với dịch vụ của Apple hay Spotify, không xác thực, không yêu cầu OAuth hay cấp quyền, không truy cập hay điều khiển trình phát nhạc, không truy cập phương tiện của người dùng, thông tin xác thực hay Keychain, không xin quyền truy cập, hoặc kích hoạt hộp thoại xin quyền hay dịch vụ hệ thống.

226- Giữ lại toàn bộ các tệp thăm dò; tuyệt đối không xóa chúng; tuyệt đối không tái sử dụng chúng làm mã nguồn ứng dụng.

228

229BÁO CÁO: tạo tệp ~/Documents/MusicLock/PHASE-1-FEASIBILITY-REPORT.md với CHÍNH XÁC tám phần cấp cao nhất, theo đúng thứ tự này, và không thêm bất kỳ phần nào khác:

2301. Các phát hiện về tính khả thi của macOS/API (phiên bản macOS, Xcode, Swift, SDK; các hệ quả khi triển khai; tính khả dụng của API công khai; kết quả thăm dò (probe); các phát hiện về trình phát bên ngoài; MPNowPlayingInfoCenter; MPRemoteCommandCenter; toàn màn hình; ảnh bìa chuyển động; Trình bảo vệ màn hình (ScreenSaver)/chế độ nền (ambient); điều khoản về ảnh bìa/nội dung; các hệ quả về hiệu năng)

2312. Phán quyết về tích hợp Apple Music (độc lập: A Music.app bên ngoài; B MusicLock làm trình phát / MusicKit; C Các API chính thức của Apple)

2323. Phán quyết về tích hợp Spotify (độc lập: A Spotify.app bên ngoài; B MusicLock làm trình phát Spotify; C Spotify Web API chính thức; bao gồm cơ chế hỏi vòng (polling), OAuth, các phạm vi quyền (scopes), tài khoản Premium, giới hạn tần suất (rate limits), ảnh bìa, phát nhạc gốc (native playback), Web Playback SDK, khả năng áp dụng trên macOS)

2334. Phán quyết về tính khả thi của lời bài hát (tệp .lrc cục bộ; khớp lời; mốc thời gian (timestamps); độ lệch thời gian (offsets); mốc thời gian nâng cao và theo từng từ; tệp bị lỗi định dạng; UTF-8; AVFoundation; đồng bộ hóa)

2345. Các phát hiện về quyền truy cập/bảo mật (sandbox; quyền hạn (entitlements); quyền riêng tư; mạng; Keychain; hệ thống tệp; MusicKit; phân phối; kiến trúc tối thiểu hóa quyền truy cập)

2356. Tài liệu tham khảo của Apple (tiêu đề, URL, ngày/phiên bản hoặc NOT SHOWN, nhận định được chứng minh), kèm theo một mục con "Spotify documentation references" (Tài liệu tham khảo của Spotify) theo cùng định dạng

2367. Khuyến nghị kiến trúc (tách biệt phần SUPPORTED NOW (ĐƯỢC HỖ TRỢ HIỆN TẠI) với FUTURE / UNVERIFIED (TƯƠNG LAI / CHƯA XÁC MINH); không chứa mã nguồn sản xuất)

2378. Kế hoạch Giai đoạn 2 (cụ thể và tăng tiến từng bước; không được bắt đầu thực hiện). Dòng cuối cùng của phần này BẮT BUỘC phải chính xác là: WAITING FOR EXPLICIT USER APPROVAL

238

239============================================================

24016. GIAI ĐOẠN 2 — XÂY DỰNG CỐT LÕI

241============================================================

242

243Chỉ thực hiện sau khi có lệnh `APPROVED: PHASE 2` hợp lệ (phần 1).

244

245PHASE-1-FEASIBILITY-REPORT.md là nguồn chân lý duy nhất. Chỉ xây dựng những gì báo cáo đó đã xác lập là SUPPORTED (ĐƯỢC HỖ TRỢ) hoặc PARTIALLY SUPPORTED (ĐƯỢC HỖ TRỢ MỘT PHẦN) trong phạm vi mô hình mặc định, và chỉ các hướng tích hợp phương tiện được nêu tên trên dòng MEDIA PATHS của lệnh phê duyệt. Bất kỳ thứ gì không được nêu tên đều KHÔNG được phê duyệt. Bất kỳ hướng UNVERIFIED (CHƯA XÁC MINH) nào cũng cần quyết định rõ ràng của tôi. Nếu không có hướng nào được phê duyệt, MusicLock chỉ chạy với tệp âm thanh cục bộ. Không xóa các hiện vật của Giai đoạn 1; giữ nguyên các tệp thăm dò (probes).

246

247THỨ TỰ XÂY DỰNG, theo CÁC LÁT CẮT DỌC NHỎ (SMALL VERTICAL SLICES): (1) khung ứng dụng gốc (native app shell); (2) cấu trúc dự án; (3) cấu hình sandbox; (4) hệ thống thiết kế (design system); (5) mô hình trạng thái phát nhạc; (6) phát nhạc cục bộ bằng AVFoundation; (7) chế độ Tối giản (Minimal mode); (8) chế độ Ảnh bìa đầy đủ (Full Cover mode - chỉ hiệu ứng không gian tĩnh; chuyển động thuộc Giai đoạn 3); (9) chế độ Đĩa than (Vinyl mode); (10) bộ phân tích cú pháp (parser) tệp .lrc cục bộ; (11) chế độ Lời bài hát (Lyrics mode); (12) bộ chuyển đổi phương tiện (media adapter) đã được phê duyệt; (13) quản lý cửa sổ và chế độ toàn màn hình.

248

249Sau mỗi lát cắt: biên dịch (build); kiểm thử logic liên quan; chạy tệp thực thi (binary) của chính dự án khi hữu ích (phần 4); ghi lại kết quả vào PHASE-2-BUILD-LOG.md với các cột: Lát cắt (Slice) | Các tệp đã thay đổi (Files changed) | Kết quả biên dịch (Build result) | Kiểm thử (Tests) | Trạng thái (Status) | Ghi chú (Notes).

250

251QUY TẮC: tuyệt đối không làm giả việc tích hợp phương tiện hoặc dữ liệu phát nhạc; phương tiện không khả dụng phải hiển thị giao diện trung thực. Viết kiểm thử đơn vị (unit-test) cho bộ phân tích cú pháp .lrc, xử lý mốc thời gian và độ lệch thời gian, mô hình trạng thái cùng các logic thuần túy khác, và chạy các bài kiểm thử đó.

252

253SẢN PHẨM BÀN GIAO: dự án bên trong thư mục gốc; PHASE-2-BUILD-LOG.md; PHASE-2-REPORT.md (những gì đã được xây dựng; trạng thái từng tính năng; các điểm sai lệch so với kế hoạch Giai đoạn 1; các vấn đề còn bỏ ngỏ; mức độ sẵn sàng cho Giai đoạn 3). Kết thúc tệp PHASE-2-REPORT.md bằng dòng chữ chính xác là: WAITING FOR EXPLICIT USER APPROVAL

254

255============================================================

25617. GIAI ĐOẠN 3 — TRẢI NGHIỆM ĐIỆN ẢNH

257============================================================

258

259Chỉ thực hiện sau khi có lệnh `APPROVED: PHASE 3` hợp lệ.

260

261Phạm vi: chuyển động đậm chất điện ảnh; bầu không gian thị giác trích xuất từ ảnh bìa (trong phạm vi các điều khoản nội dung đã xác định ở Giai đoạn 1); ảnh bìa chuyển động chỉ ở những nơi Giai đoạn 1 xác nhận được hỗ trợ hợp pháp; hiệu ứng chuyển đổi chế độ và chuyển bài; vũ đạo lời bài hát (lyric choreography); hiệu ứng hình ảnh phản hồi theo trạng thái phát nhạc; tối ưu hóa hiệu năng.

262

263Chuyển động phải truyền tải được trạng thái: đang phát, tạm dừng, đang nạp đệm (buffering), đổi bài hát, đổi dòng lời bài hát. Không dùng hiệu ứng chuyển động chỉ để trang trí. Mọi hiệu ứng chuyển động tiêu tốn tài nguyên đều phải tạm dừng khi ứng dụng không hoạt động, cửa sổ bị ẩn, hoặc khung nhìn không hiển thị. Tuân thủ cài đặt Giảm chuyển động (Reduce Motion). Đo lường trước khi tối ưu hóa; nếu không đo lường thì ghi là NOT MEASURED. Xây dựng từng lát cắt một.

264

265SẢN PHẨM BÀN GIAO: PHASE-3-BUILD-LOG.md; PHASE-3-REPORT.md. Kết thúc bằng dòng chữ chính xác là: WAITING FOR EXPLICIT USER APPROVAL

266

267============================================================

26818. GIAI ĐOẠN 4 — HOÀN THIỆN CUỐI CÙNG

269============================================================

270

271Chỉ thực hiện sau khi có lệnh `APPROVED: PHASE 4` hợp lệ.

272

273Phạm vi: nghệ thuật chữ (typography); khoảng cách (spacing); các nút điều khiển; toàn màn hình; đa màn hình; hiệu năng chuyển động; bộ nhớ; CPU/GPU; hành vi tiết kiệm pin; khả năng tiếp cận — accessibility (VoiceOver, điều khiển bằng bàn phím, độ tương phản, Giảm chuyển động (Reduce Motion), Giảm độ trong suốt (Reduce Transparency), Cỡ chữ động (Dynamic Type) ở những nơi áp dụng được); các trạng thái lỗi, trống và phương tiện không khả dụng; xử lý mượt mà các lỗi API (từ chối cấp quyền, mất kết nối mạng, chạm giới hạn tần suất (rate limits), thiếu ảnh bìa, lời bài hát sai định dạng).

274

275Không thêm tính năng mới, quyền truy cập mới, hoặc thư viện phụ thuộc mới. Bất kỳ thứ gì cần đến một trong các yếu tố trên: DỪNG LẠI và hỏi ý kiến.

276

277SẢN PHẨM BÀN GIAO: PHASE-4-BUILD-LOG.md; PHASE-4-REPORT.md. Kết thúc bằng dòng chữ chính xác là: PROJECT COMPLETE — AWAITING USER REVIEW

278

279============================================================

28019. KHÔNG LÀM VIỆC NGẦM NGOÀI PHẠM VI

281============================================================

282

283Ở mỗi giai đoạn, chỉ làm đúng những gì giai đoạn đó quy định. Không được: cài đặt các thư viện phụ thuộc; tạo tiến trình ngầm (daemons), mục khởi động cùng hệ thống (login items), hoặc trình trợ giúp (helpers); sửa đổi cài đặt hệ thống; yêu cầu các quyền truy cập trái phép; ghi tệp ra bên ngoài thư mục gốc của dự án; kiểm tra các tệp hoặc ứng dụng không liên quan; bắt đầu công việc của giai đoạn tương lai; để lại các hiện vật không rõ lý do. Các hiện vật được phép có trong thư mục gốc: báo cáo giai đoạn, nhật ký biên dịch, tệp thăm dò (probes), tệp dự án, sản phẩm sau biên dịch (build products).

284

285============================================================

28620. NHÃN TRẠNG THÁI TRIỂN KHAI

287============================================================

288

289Giai đoạn 1 sử dụng bốn phán quyết (phần 6). Trạng thái tính năng từ Giai đoạn 2 trở đi sử dụng: TESTED (đã quan sát trực tiếp) | BUILT BUT UNTESTED (đã xây dựng nhưng chưa kiểm thử) | BLOCKED (bị chặn, kèm theo đúng một lý do: PLATFORM, VENDOR, hoặc POLICY). Tuyệt đối không trộn lẫn hai hệ thống nhãn này. Tuyệt đối không nói một tính năng "hoạt động được" trừ khi nó đã được quan sát trực tiếp. Nếu việc xác minh hình ảnh không khả dụng (bạn không được phép dùng quyền Quay màn hình (Screen Recording) hoặc Trợ năng (Accessibility) để có được nó): ghi BUILT BUT UNTESTED — visual verification unavailable in this environment (ĐÃ XÂY DỰNG NHƯNG CHƯA KIỂM THỬ — xác minh hình ảnh không khả dụng trong môi trường này).

290

291============================================================

29221. ĐIỀU KIỆN DỪNG

293============================================================

294

295DỪNG LẠI ngay lập tức nếu: (1) thiếu thư mục gốc của dự án; (2) cần một quyền riêng tư mới; (3) phải cài đặt hoặc thêm một thư viện phụ thuộc; (4) cần một quyền hạn (entitlement) nằm ngoài mô hình mặc định; (5) có vẻ cần đến một API nội bộ (private), không có tài liệu, hoặc không được hỗ trợ; (6) ranh giới bảo mật không rõ ràng; (7) mô hình phân phối sẽ thay đổi đáng kể; (8) công việc sẽ vượt ra ngoài phạm vi của giai đoạn hiện tại; (9) phải kiểm tra một dự án khác; (10) phải kiểm tra một ứng dụng bên thứ ba đã cài đặt; (11) cần bằng chứng trên web không phải nguồn chính thức; (12) bằng chứng chính thức tự mâu thuẫn và không thể giải quyết; (13) bằng chứng bắt buộc nằm ngoài phạm vi hệ thống tệp đã được phê duyệt; (14) cần một tính năng của giai đoạn sau để hoàn thành giai đoạn hiện tại; (15) không thể đánh giá một khả năng nếu không vi phạm prompt này; (16) việc chạy tệp thực thi (binary) của chính dự án làm bật lên hộp thoại xin cấp quyền.

296

297Khi dừng lại, hãy nêu rõ: STOP CONDITION: . Không tự ý ứng biến, tìm cách lách qua, hoặc âm thầm tiếp tục.

298

299============================================================

30022. TỰ KIỂM TRA (trước khi hoàn thành MỖI giai đoạn)

301============================================================

302

303KIỂM TRA GIAI ĐOẠN 1

304[ ] Chính xác 8 phần báo cáo cấp cao nhất, không thừa phần nào

305[ ] Mọi nhận định quan trọng đều có đầy đủ các trường bắt buộc (phần 6)

306[ ] Mọi phán quyết SUPPORTED, PARTIALLY SUPPORTED, và BLOCKED đều dựa trên bằng chứng FACT (SỰ THẬT)

307[ ] Mọi phán quyết BLOCKED đều có chính xác một lý do (PLATFORM, VENDOR, hoặc POLICY) và dựa trên bằng chứng khẳng định rõ ràng; sự im lặng của tài liệu tuyệt đối không được dẫn đến phán quyết BLOCKED

308[ ] Cụm từ "BLOCKED BY macOS" chỉ xuất hiện cho lý do PLATFORM

309[ ] Các nhận định về SDK phải trích dẫn đường dẫn tệp SDK thực tế; các nhận định từ web phải trích dẫn các trang chính thức của Apple/Spotify

310[ ] `swiftc -typecheck` tuyệt đối không bao giờ được trình bày như bằng chứng chạy thực tế (runtime proof)

311[ ] Mọi tệp thăm dò (probe) đều bắt đầu bằng dòng chú thích bắt buộc, chỉ kiểm tra biên dịch, không thực hiện bất kỳ lệnh gọi mạng nào, và không yêu cầu bất kỳ quyền truy cập nào

312[ ] Không tồn tại mã nguồn ứng dụng sản xuất, giao diện người dùng (UI), bộ máy phương tiện, bộ máy lời bài hát, OAuth, trình khách mạng, hoặc thư viện phụ thuộc nào

313[ ] Giai đoạn 2 CHƯA được bắt đầu

314

315KIỂM TRA CHO TẤT CẢ CÁC GIAI ĐOẠN

316[ ] Không có gì được ghi ra ngoài thư mục gốc của dự án

317[ ] Không kiểm tra dự án khác hoặc ứng dụng bên thứ ba nào

318[ ] Không sử dụng API nội bộ (private API) hoặc kỹ thuật bị cấm nào

319[ ] Không có quyền truy cập, quyền hạn (entitlement), hoặc thư viện phụ thuộc trái phép nào

320[ ] Không bắt đầu giai đoạn sau

321[ ] Báo cáo của đúng giai đoạn tồn tại và kết thúc bằng đúng dòng cuối cùng theo quy định

322[ ] Không có tính năng nào được gắn nhãn TESTED trừ khi đã được quan sát trực tiếp

323

324KHI KIỂM TRA THẤT BẠI: nếu một mục kiểm tra thất bại có thể được khắc phục mà không vi phạm prompt này, chỉ sửa ĐÚNG vấn đề đó bên trong thư mục gốc của dự án và chạy lại bước kiểm tra. Nếu việc sửa lỗi đó sẽ kích hoạt điều kiện dừng (phần 21), hãy DỪNG LẠI và hỏi ý kiến. Tuyệt đối không âm thầm bỏ qua một mục kiểm tra bị thất bại.

325

326============================================================

32723. PHẢN HỒI CUỐI CÙNG (mỗi giai đoạn)

328============================================================

329

330Phản hồi trò chuyện cuối cùng của bạn BẮT BUỘC phải từ 15 dòng trở xuống, mỗi trường một dòng, theo đúng thứ tự này:

331PHASE:

332HEADLINE:

333APPLE A / B / C:

334SPOTIFY A / B / C:

335LYRICS:

336SECURITY / PERMISSIONS:

337UNRESOLVED QUESTION:

338EVIDENCE:

339REPORT:

340NEXT PHASE:

341FINAL STATUS:

342

343Giai đoạn 1: APPLE và SPOTIFY chứa ba phán quyết cho mỗi bên; EVIDENCE là số lượng tệp thăm dò chỉ kiểm tra biên dịch (compile-only probes); NEXT PHASE là NOT STARTED; FINAL STATUS là WAITING FOR EXPLICIT USER APPROVAL.

344Giai đoạn 2 và 3: APPLE và SPOTIFY ghi là N/A; LYRICS là một nhãn trạng thái; EVIDENCE là bản tóm tắt biên dịch/kiểm thử; NEXT PHASE là NOT STARTED; FINAL STATUS là WAITING FOR EXPLICIT USER APPROVAL.

345Giai đoạn 4: tương tự như trên, nhưng FINAL STATUS là PROJECT COMPLETE — AWAITING USER REVIEW.

346

347Không dán nội dung báo cáo vào khung trò chuyện; các bằng chứng chi tiết thuộc về tệp báo cáo.

348

349============================================================

35024. BẮT ĐẦU NGAY — GIAI ĐOẠN 1

351============================================================

352

3531. Xác minh rằng ~/Documents/MusicLock tồn tại và là một thư mục. Nếu thiếu: DỪNG LẠI và hỏi ý kiến.

3542. CHỈ kiểm tra thư mục gốc của dự án. Không mặc định hoặc tự bịa ra các tệp đang tồn tại.

3553. Ghi nhận phiên bản macOS, Xcode, Swift, đường dẫn SDK và phiên bản SDK chỉ bằng các câu lệnh được phép.

3564. Nghiên cứu tài liệu chính thức của Apple, sau đó là tài liệu chính thức của Spotify.

3575. Điều tra độc lập: Apple A, B, C và Spotify A, B, C.

3586. Điều tra lời bài hát, quyền truy cập, sandbox, quyền hạn (entitlements), chế độ toàn màn hình, Trình bảo vệ màn hình (ScreenSaver)/chế độ nền (ambient), điều khoản về ảnh bìa/nội dung, và hiệu năng.

3597. Viết các tệp thăm dò tối giản chỉ kiểm tra biên dịch (compile-only probes) ở những nơi hữu ích; chỉ chạy kiểm tra kiểu (typecheck) cho chúng; ghi lại mọi kết quả.

3608. Tạo tệp ~/Documents/MusicLock/PHASE-1-FEASIBILITY-REPORT.md.

3619. Chạy bước tự kiểm tra ở phần 22.

36210. Nếu vượt qua kiểm tra, gửi phản hồi cuối cùng theo phần 23.

36311. KHÔNG xây dựng MusicLock, không tạo giao diện người dùng (UI), hoặc bắt đầu Giai đoạn 2.

36412. DỪNG LẠI và chờ lệnh `APPROVED: PHASE 2` hợp lệ (phần 1).

365

366KẾT THÚC PROMPT

367

MusicLock

Nội dung

MusicLock

Nội dung

Bình luận (0)