Prompt Art

221 prompt

Hình ảnh

Prompt Phong Cách Phim Lego (The LEGO Movie)

Tái hiện khung cảnh theo phong cách một phân cảnh trong bộ phim The LEGO Movie.

1{
2  "TASK": "Tái hiện khung cảnh theo phong cách một phân cảnh trong bộ phim The LEGO Movie.",
3  "VISUAL_ID": "Nhiếp ảnh cận cảnh (macro photography) chụp các viên gạch nhựa. Cảm giác hoạt hình tĩnh vật (stop-motion).",
...+5 dòng nữa

Art Nano Banana Movies

P@prompt

Hình ảnh

Mô hình 3D thu nhỏ góc nhìn đẳng cự (Isometric)

Tạo một mô hình 3D thu nhỏ góc nhìn đẳng cự (isometric) từ chính bức ảnh của bạn.

Hãy tạo một mô hình tượng nhỏ (figurine) toàn thân, thu nhỏ, góc nhìn đẳng cự (isometric), chân thực của người này, đang mặc ABC, đang làm XYZ, trên nền trắng, phong cách tối giản, độ phân giải 4K.

Art ChatGPT Nano Banana

B@bahlulhasanli

Một biểu tượng ứng dụng iOS cao cấp dành cho ứng dụng chạy bộ và thể hình, nổi bật với hình tượng người chạy bộ trừu tượng cách điệu đang chuyển động, được tạo thành từ những dải ruy băng chuyển màu uyển chuyển mang sắc cam san hô tràn đầy năng lượng chuyển dần sang màu hồng sẫm (magenta) rực rỡ. Hình tượng gợi lên tốc độ và đà lao về phía trước với các vệt chuyển động kéo theo phía sau. Phông nền là màu xanh hải quân (navy blue) thẫm với hiệu ứng chuyển màu tỏa tròn (radial gradient) sáng hơn một cách tinh tế ở phía sau nhân vật. Năng động, tràn đầy sinh lực, truyền cảm hứng chinh phục. Ánh sáng dịu nhẹ kèm quầng sáng tỏa nhẹ (glow) tinh tế bao quanh nhân vật. Định dạng hình vuông bo góc, kích thước 1024x1024px. hãy tuân thủ các thông số kỹ thuật dưới đây và các mẫu thiết kế biểu tượng ví dụ được đính kèm: Các thông số kỹ thuật này định nghĩa ngôn ngữ thị giác của những biểu tượng ứng dụng hiện đại, cao cấp như thường thấy trên các ứng dụng iOS/macOS hàng đầu. Mục tiêu là tạo ra những biểu tượng mang cảm giác trau chuốt, dễ nhớ và xứng tầm với một sản phẩm chủ lực (flagship). --- ## 1. Khung vẽ & Hình dạng (Canvas & Shape) ### Hình dạng Cơ sở - **Định dạng:** Hình vuông với các góc bo tròn liên tục (hình "squircle" của iOS) - **Bán kính Góc bo:** Khoảng 22-24% chiều rộng biểu tượng (mô phỏng đường cong superellipse của Apple) - **Tỷ lệ Khung hình:** 1:1 - **Độ phân giải Khuyến nghị:** 1024×1024px (thu nhỏ xuống các kích thước bé rất sắc nét) ### Vùng An toàn (Safe Zone) - Giữ các yếu tố chính nằm gọn trong 80% vùng trung tâm của khung vẽ - Cho phép các hiệu ứng tinh tế (quầng sáng, bóng đổ) tiến sát ra viền nhưng không bị cắt cụt (clip) --- ## 2. Xử lý Phông nền (Background Treatments) ### Nền Đơn sắc (Solid Backgrounds) - **Tối/Đen:** Đen thuần khiết (#000000) đến xám than đậm (#1C1C1E) — tạo chiều sâu kịch tính, làm nổi bật các chi tiết bên trên - **Đơn sắc Rực rỡ:** Đổ màu đơn có độ bão hòa cao (xanh dương điện tử #007AFF, cam ấm #FF9500) - **Nền Chuyển màu (Gradient):** Chuyển màu tinh tế từ trên xuống dưới hoặc tỏa tròn từ tâm giúp tăng chiều sâu ### Các Loại Gradient (khi sử dụng) | Loại | Mô tả | Ví dụ | |------|-------------|---------| | Tuyến tính (Linear) | Chuyển màu mềm mại, thường sáng hơn ở phía trên | Gradient bầu trời xanh | | Tỏa tròn (Radial) | Hiệu ứng phát sáng ở tâm, tối dần ra các cạnh | Hiệu ứng đèn rọi (Spotlight) | | Theo góc (Angular) | Chuyển màu quét xoay vòng | Bề mặt ánh xà cừ (Iridescent) | ### Kết cấu Bề mặt (Tinh tế) - Các đường kẻ dọc/ngang mảnh mịn tạo cảm giác kim loại hoặc sợi vải - Hạt nhiễu (noise grain) ở độ mờ 1-3% tạo sự ấm áp tự nhiên - Tránh các kết cấu quá nặng nề làm cạnh tranh sự chú ý với biểu tượng chính --- ## 3. Bảng màu (Color Palette) ### Đặc điểm Bảng màu Chính - **Độ bão hòa Cao:** Màu sắc sống động nhưng không chói gắt kiểu đèn neon - **Tông Tối Giàu Chiều sâu:** Màu đen và xanh hải quân đóng vai trò nổi bật - **Điểm Sáng Chọn lọc:** Các màu nhấn (accent colors) được sử dụng tiết chế để tạo điểm nhấn thị giác mạnh ### Các Họ Màu Khuyến nghị #### Phổ Màu Lạnh (Cool Spectrum) ``` Navy/Deep Blue: #0A1628, #1A2744, #2D4A7C Electric Blue: #007AFF, #5AC8FA, #64D2FF Purple/Violet: #5E5CE6, #BF5AF2, #AF52DE Teal/Cyan: #30D5C8, #5AC8FA, #32ADE6 ``` #### Phổ Màu Ấm (Warm Spectrum) ``` Orange: #FF9500, #FF6B35, #FF3B30 Pink/Coral: #FF6B8A, #FF2D55, #FF375F Peach/Salmon: #FFACA8, #FF8A80, #FFB199 ``` #### Màu Trung tính (Neutrals) ``` True Black: #000000 Soft Black: #1C1C1E, #2C2C2E White: #FFFFFF Off-White: #F5F5F7, #E5E5EA ``` ### Quy tắc Hòa sắc (Color Harmony Rules) - Giới hạn từ 2-3 màu chủ đạo trên mỗi biểu tượng - Sử dụng mối quan hệ màu bổ túc (complementary) hoặc tương đồng (analogous) - Một màu nên chiếm ưu thế chủ đạo (60%), màu phụ (30%), màu nhấn (10%) --- ## 4. Ánh sáng & Chiều sâu (Lighting & Depth) ### Nguồn sáng - **Vị trí:** Phía trên bên trái hoặc chiếu thẳng từ đỉnh xuống (nhất quán ở góc 45°) - **Chất lượng:** Mềm mại, khuếch tán — không có bóng đổ sắc gắt - **Tạo ra:** Những mảng bắt sáng tinh tế ở bề mặt phía trên, bóng đổ dịu ở phía dưới ### Kỹ thuật Tạo Chiều sâu #### Vùng sáng (Highlights) - Dải chuyển màu trắng/sáng dịu trên các cạnh đỉnh của hình khối 3D - Phản xạ gương (Specular reflections) dưới dạng các đốm sáng nhỏ (không lấn át tổng thể) - Ánh sáng viền (Rim lighting) trên các cạnh hướng về phía nguồn sáng #### Bóng đổ (Shadows) - **Bóng đổ ngoài (Drop Shadows):** Mềm, khuếch tán, độ mờ 10-20%, lệch nhẹ theo trục Y - **Bóng đổ trong (Inner Shadows):** Rất tinh tế, tạo hiệu ứng lõm sâu xuống - **Bóng tiếp xúc (Contact Shadows):** Bóng tối hơn, thu hẹp sát ngay bên dưới vật thể #### Phân lớp (Layering) - Các phần tử nên có cảm giác như đang lơ lửng phía trên phông nền - Sử dụng phối cảnh khí quyển (các phần tử ở xa hơi mờ sương hơn một chút) - Các hình khối xếp chồng lên nhau tạo ra sự phân cấp tự nhiên --- ## 5. Ký hiệu & Hệ thống Hình tượng (Symbol & Iconography) ### Các Hướng Tiếp cận Phong cách #### A. Vật thể Không gian Ba chiều / 3D (Dimensional/3D Objects) - Hình khối bo tròn, mềm mại với thể tích rõ ràng - Dải chuyển màu tinh tế gợi lên độ cong bề mặt - Ví dụ: Máy bay giấy, cuốn sách đang mở, các khối cầu #### B. Thiết kế Phẳng có Gợi ý Chiều sâu (Flat with Depth Cues) - Các hình dạng đơn giản hóa kết hợp đổ bóng / bắt sáng có tính toán chiến lược - Hình học gọn gàng với dải chuyển màu nhẹ - Ví dụ: Biểu tượng ngọn lửa, mặt la bàn #### C. Trừu tượng / Hình học (Abstract/Geometric) - Các hình khối bán trong suốt xếp chồng lên nhau - Các hình thái đan cài vào nhau tạo sự thú vị về thị giác - Ví dụ: Các hình thoi chồng lớp, bố cục hình tam giác #### D. Hiệu ứng Kính mờ / Bán trong suốt (Glassmorphic/Translucent) - Hiệu ứng kính mờ (frosted glass) có làm nhòe hậu cảnh - Các hình khối mang cảm giác xuyên thấu - Khúc xạ tinh tế và hiệu ứng loang màu nhẹ ### Đặc tính của Ký hiệu - **Sự đơn giản:** Có thể nhận diện rõ ràng ngay cả ở kích thước nhỏ 16×16px - **Sự cân bằng:** Trọng lượng thị giác đặt ở tâm hoặc tạo thế năng động có chủ đích - **Tính độc đáo:** Tránh cảm giác giống những hình mẫu clip-art đại trà - **Tính ẩn dụ:** Ký hiệu liên hệ rõ ràng tới chức năng của ứng dụng ### Tỷ lệ Kích thước Ký hiệu Khuyến nghị - Ký hiệu chính: chiếm 50-70% khung vẽ biểu tượng - Chừa khoảng thở (breathing room) thoáng đãng xung quanh các cạnh - Căn giữa theo thị giác (optical centering — có thể hơi khác so với tâm toán học thuần túy) --- ## 6. Chất liệu & Đặc tính Bề mặt (Material & Surface Qualities) ### Bề mặt Lì (Matte Surfaces) - Chuyển màu dịu nhẹ không có các điểm lóe sáng sắc cạnh - Có thể điểm xuyết kết cấu hạt rất nhẹ - Màu sắc trông đặc, đằm và vững chãi ### Bề mặt Bóng / Phản chiếu (Glossy/Reflective Surfaces) - Các vùng bắt sáng và phản chiếu rõ nét - Tăng độ tương phản giữa vùng sáng và vùng tối - Gợi liên tưởng đến thủy tinh, nhựa bóng hoặc kim loại đánh bóng ### Bề mặt Kim loại (Metallic Surfaces) - Gradient tuyến tính hoặc tỏa tròn mô phỏng ánh kim - Tông màu lạnh cho bạc/crôm, tông ấm cho vàng/đồng - Các đường vân xước mảnh tùy chọn ### Thủy tinh / Bán trong suốt (Glass/Translucent) - Giảm độ đục (opacity ở mức 60-85%) - Hiệu ứng làm mờ (blur) trên các phần tử nằm phía sau - Ám màu nhẹ kèm theo các cạnh viền sáng - Quầng sáng nội bên trong (inner glow) tinh tế ### Giấy / Vải (Paper/Fabric) - Màu sắc dịu nhẹ, trầm ấm - Kết cấu bề mặt cực kỳ tinh tế - Bóng đổ nhẹ nhàng gợi lên độ mềm dẻo, uốn lượn --- ## 7. Hiệu ứng & Độ hoàn thiện (Effects & Polish) ### Hiệu ứng Phát sáng (Glow Effects) - **Phát sáng ngoài (Outer Glow):** Quầng sáng dịu bao quanh các phần tử sáng, độ mờ 5-15% - **Phát sáng trong (Inner Glow):** Ánh sáng viền tinh tế bên trong, tạo cảm giác có thể tích khối - **Phát sáng màu (Color Glow):** Quầng sáng nhuốm màu trùng với màu của phần tử (tạo bầu không khí) ### Phản chiếu (Reflections) - Bóng phản chiếu mặt sàn tinh tế ngay bên dưới các vật thể đang lơ lửng (rất mờ) - Phản chiếu môi trường trên các bề mặt bóng loáng - Các đốm sáng phản xạ gương gợi mở vị trí nguồn sáng ### Chuyển màu Bên trong Hình khối (Gradients Within Shapes) - Gradient đa điểm dừng (multi-stop) cho các dải chuyển màu phức tạp - Gradient tỏa tròn để tạo vẻ ngoài hình cầu - Gradient lưới (Mesh gradients) cho sự pha trộn màu sắc uyển chuyển, tự nhiên ### Làm mờ & Độ sâu Trường ảnh (Blur & Depth of Field) - Làm mờ hậu cảnh cho các bố cục phân lớp - Làm mờ Gaussian (Gaussian blur) ở mức 5-20px để tạo hiệu ứng chiều sâu không gian - Chỉ sử dụng làm mờ chuyển động (motion blur) nếu muốn gợi tả tốc độ di chuyển --- ## 8. Nguyên tắc Bố cục (Composition Principles) ### Cân bằng Thị giác - **Đặt giữa tâm (Centered):** Ký hiệu nằm ở tâm thị giác (cổ điển, vững vàng) - **Năng động (Dynamic):** Độ lệch nhẹ khỏi tâm tạo ra năng lượng và sự chuyển động - **Bất đối xứng (Asymmetric):** Sự mất cân bằng có chủ đích nhưng có đối trọng thị giác bù lại ### Không gian Âm (Negative Space) - Khoảng trống / khoảng thở rộng rãi - Phông nền là một phần của thiết kế, chứ không chỉ là chỗ trống vô nghĩa - Không gian âm có thể khéo léo tạo thành các hình khối phụ thứ cấp ### Tiêu điểm (Focal Point) - Một khu vực rõ ràng có độ tương phản / độ chi tiết cao nhất - Ánh mắt người xem phải chạm vào phần tử quan trọng nhất đầu tiên - Các phần tử bổ trợ lùi lại phía sau về mặt thị giác ### Tương phản Tỷ lệ (Scale Contrast) - Sự kết hợp giữa các phần tử lớn và nhỏ tạo nên sự thú vị - Ký hiệu chính chiếm ưu thế áp đảo, các chi tiết phụ giữ ở mức tinh tế - Tránh làm rối mắt bằng việc đặt nhiều phần tử có kích thước ngang bằng nhau --- ## 9. Các Biến thể Phong cách (Style Variations) ### Tối giản Nền tối (Minimal Dark) - Phông nền màu đen hoặc rất tối - Một phần tử sáng duy nhất hoặc ký hiệu đơn sắc - Độ tương phản cao, cảm giác ấn tượng giàu kịch tính - Ví dụ: Biểu tượng ngọn lửa, biểu đồ chứng khoán ### Gradient Rực rỡ (Vibrant Gradient) - Phông nền chuyển màu đa sắc - Ký hiệu màu trắng hoặc sáng màu đặt nổi lên trên - Cảm giác tràn đầy năng lượng, hiện đại - Ví dụ: Telegram, ứng dụng Sách (Books) ### Dịu nhẹ & Tươi sáng (Soft & Light) - Phông nền sáng sủa, thoáng đãng (màu trắng, màu phấn pastel) - Các ký hiệu nhiều màu sắc đi kèm bóng đổ mềm mại - Cảm giác thân thiện, dễ gần - Ví dụ: Ứng dụng đo độ cao Altitude, các biểu tượng cử chỉ ### Kính mờ (Glassmorphic) - Các phần tử bán trong suốt, phủ sương mờ - Các hình khối xếp lớp với độ đục trong khác nhau - Cảm giác đương đại, tinh xảo - Ví dụ: Biểu tượng Phím tắt (Shortcuts), các hình khối giao nhau ### Kết xuất 3D (3D Rendered) - Các vật thể 3D chân thực - Hệ thống ánh sáng và chất liệu phức tạp - Cảm giác cao cấp, sống động như có thể chạm vào được - Ví dụ: Khối cầu, máy bay, cuốn sách

Hãy đóng vai một Nghệ sĩ Thiết kế Nhân vật 3D Bậc thầy và Chuyên gia Quang trắc học (Photogrammetry Expert). Nhiệm vụ của bạn là tạo ra một bảng thiết kế nhân vật (character sheet) độ phân giải 8k siêu thực của một người từ hình ảnh tham chiếu được cung cấp để làm hình đại diện kỹ thuật số (digital avatar). Bạn sẽ: - Đảm bảo tính nhất quán của nhân vật bằng cách duy trì chính xác hình học khuôn mặt, kết cấu làn da, chi tiết nang tóc và màu mắt từ hình ảnh tham chiếu. - Bố cục một bản trình bày "phép chiếu trực giao" (orthographic) đa góc nhìn hiển thị người đó trong tư thế chữ T (T-pose) hoặc tư thế chữ A thả lỏng (relaxed A-pose). Các Góc Nhìn Bắt Buộc: 1. Góc nhìn Chính diện Toàn thân (Full-body Front view). 2. Góc nhìn Nghiêng Trái Toàn thân (Full-body Left Profile). 3. Góc nhìn Nghiêng Phải Toàn thân (Full-body Right Profile). 4. Góc nhìn Phía Sau Toàn thân (Full-body Back view). Ánh Sáng & Phong Cách: - Sử dụng ánh sáng studio điện ảnh trung tính (high-key) không đổ bóng cùng phông nền màu trắng để tạo điều kiện thuận lợi cho việc dựng hình 3D. - Áp dụng bộ đổ bóng da (skin shaders) siêu thực, lỗ chân lông nhìn thấy rõ và hiệu ứng vật lý trang phục chân thực. Thông Số Kỹ Thuật: - Chụp bằng ống kính 85mm, khẩu độ f/8, lấy nét sắc sảo trên tất cả các góc nhìn và ở chất lượng ảnh RAW. Ràng Buộc: - Không cách điệu hóa hoặc biến kết quả đầu ra thành hoạt hình. Đó phải là một bản sao kỹ thuật số (digital twin) chính xác của hình ảnh gốc.

# Trình Tạo Widget HTWind - Prompt Hệ Thống Bạn là một kỹ sư trưởng chuyên về widget Windows, kiến trúc sư giao diện người dùng (UI) và nhà thiết kế tương tác. Bạn tạo ra các widget HTML/CSS/JavaScript đạt chuẩn thương mại sẵn sàng phát hành cho **HTWind** với các tiêu chuẩn nghiêm ngặt về độ tin cậy và bảo mật. Người dùng cung cấp một ý tưởng widget. Bạn chuyển đổi ý tưởng đó thành một tệp widget hoàn chỉnh, trau chuốt và bền vững, chạy chính xác bên trong môi trường WebView host của HTWind. ## HTWind Là Gì? HTWind là một nền tảng widget trên màn hình nền Windows, nơi mỗi widget là một tệp HTML/CSS/JavaScript duy nhất được kết xuất trong một WebView nhúng. Nó được thiết kế cho các tiện ích màn hình nền gọn nhẹ, công cụ trực quan và trình trợ giúp hệ thống. Các widget có thể tùy chọn thực thi các câu lệnh PowerShell thông qua một API cầu nối máy chủ (host bridge API) có kiểm soát để cung cấp các tính năng nhận biết trạng thái hệ thống. Khi prompt này được sử dụng bên ngoài kho mã nguồn HTWind, hãy mặc định giả định mô hình runtime này trừ khi người dùng cung cấp một hợp đồng giao tiếp host khác. ## Sứ Mệnh Tạo ra một widget đóng gói trong một tệp `.html` duy nhất đáp ứng các tiêu chí: - có diện mạo thị giác cao cấp và có chủ đích thiết kế rõ ràng, - hoàn chỉnh về mặt tương tác (đầy đủ các trạng thái đang tải/trống/lỗi/thành công), - vững chắc về mặt kỹ thuật dưới các điều kiện hoạt động thực tế trên máy tính để bàn, - tương thích hoàn toàn với cầu nối máy chủ HTWind và hành vi thực thi PowerShell. ## Bối Cảnh Thực Thi (Runtime Context) Của HTWind - Các widget là mã HTML/CSS/JS thuần túy được kết xuất trong một WebView trên máy tính để bàn. - Điểm đầu vào của Host API: - `window.HTWind.invoke("powershell.exec", args)` - Lệnh duy nhất được hỗ trợ là `powershell.exec`. - Các widget thường là những bề mặt hiển thị nhỏ gọn trên màn hình nền và phải duy trì khả năng sử dụng tốt ở các chiều rộng hẹp. - Các widget điển hình luôn bao gồm thông báo trạng thái rõ ràng, các hành động mang tính tất định và cơ chế xử lý lỗi phòng vệ chặt chẽ. ## Các Ràng Buộc Cứng (Bắt Buộc) 1. Xuất ra đúng một tài liệu HTML hoàn chỉnh duy nhất. 2. Không yêu cầu bất kỳ framework nào (không dùng npm, không có bước build, không dùng trình đóng gói bundler). 3. Sử dụng mã nguồn có ngữ nghĩa, dễ đọc và dễ bảo trì. 4. Sử dụng ngôn ngữ trong prompt của người dùng cho phần văn bản hiển thị trên giao diện widget (nhãn, trạng thái, văn bản trợ giúp) trừ khi người dùng yêu cầu rõ một ngôn ngữ khác. 5. Bao gồm các yếu tố khả năng tiếp cận (accessibility) cơ bản: luồng điều hướng bằng bàn phím, hiển thị rõ trạng thái lấy tiêu điểm (focus) và các nhãn có ý nghĩa. 6. Tuyệt đối không nhúng trực tiếp dữ liệu đầu vào chưa qua xử lý của người dùng vào chuỗi kịch bản PowerShell. 7. Coi tình trạng quá thời gian chờ (timeout) hoặc mã thoát khác không (non-zero exit) là thất bại và hiển thị thông báo lỗi thân thiện với người dùng. 8. Bổ sung các hàng rào bảo vệ thực tế cho những hành động có rủi ro cao. 9. Tránh các vòng lặp gây tốn CPU và áp lực vẽ lại giao diện (repaint) không cần thiết. 10. Hoàn thiện bằng mã nguồn sẵn sàng đưa vào sử dụng thực tế (production-ready), không trả về các đoạn mã khung sơ sài. ## Quy Tắc Bàn Giao Một Tệp Duy Nhất (Nghiêm Ngặt) - Đầu ra của widget phải luôn là một tệp `.html` độc lập, tự chứa đầy đủ mọi thành phần. - Không chia tách đầu ra thành nhiều tệp (`.css`, `.js`, partials, templates, assets manifest) trừ khi người dùng yêu cầu rõ kiến trúc đa tệp. - Giữ toàn bộ mã CSS và JavaScript nội tuyến (inline) bên trong cùng một tài liệu HTML đó. - Không đưa ra câu trả lời theo kiểu "tệp A / tệp B" ở chế độ mặc định. - Nếu có sử dụng các URL bên ngoài (ví dụ: phông chữ/biểu tượng), hãy kèm theo các phương án dự phòng mượt mà để widget vẫn hoạt động trọn vẹn như một tệp HTML bàn giao độc lập. ## Chính Sách Thích Ứng Ngôn Ngữ - Quy tắc mặc định: nếu người dùng không chỉ định rõ ngôn ngữ, hãy tạo văn bản hiển thị trên widget bằng cùng ngôn ngữ với prompt của người dùng. - Nếu người dùng yêu cầu một ngôn ngữ cụ thể, hãy tuân theo chỉ dẫn tường minh đó. - Giữ các tên định danh trong mã nguồn và tên các hàm trợ giúp nội bộ bằng tiếng Anh rõ ràng để dễ bảo trì. - Giữ ngữ nghĩa hỗ trợ tiếp cận đồng bộ với ngôn ngữ giao diện (ví dụ: `aria-label`, `title`, văn bản giữ chỗ placeholder). - Không trộn lẫn nhiều ngôn ngữ giao diện trừ khi được yêu cầu. ## Hợp Đồng Phản Hồi Bạn Bắt Buộc Phải Tuân Theo Luôn phản hồi theo đúng cấu trúc sau: 1. `Widget Summary` - 3 đến 6 gạch đầu dòng tóm tắt những gì đã được xây dựng. 2. `Design Rationale` - Một đoạn văn ngắn giải thích các lựa chọn về thị giác và trải nghiệm người dùng (UX). 3. `Implementation` - Một khối mã `html` rào chắn chứa toàn bộ tệp đơn độc lập, đầy đủ từ đầu đến cuối. 4. `PowerShell Notes` - Các gạch đầu dòng ngắn gọn: các câu lệnh sử dụng, quyết định đảm bảo an toàn, hành vi xử lý timeout. 5. `Customization Tips` - Các hướng dẫn chỉnh sửa nhanh: bảng màu, tần suất làm mới, phạm vi dữ liệu, hành vi hoạt động. ## Hợp Đồng Cầu Nối Máy Chủ - Host Bridge (Nghiêm Ngặt) Mẫu gọi lệnh: - `await window.HTWind.invoke("powershell.exec", { script, timeoutMs, maxOutputChars, shell, workingDirectory })` Các thuộc tính phản hồi có thể có (hỗ trợ cả hai kiểu viết hoa/thường): - `TimedOut` / `timedOut` - `ExitCode` / `exitCode` - `Output` / `output` - `Error` / `error` - `OutputTruncated` / `outputTruncated` - `ErrorTruncated` / `errorTruncated` - `Shell` / `shell` - `WorkingDirectory` / `workingDirectory` ## Các Tiện Ích JavaScript Bắt Buộc (Khi Có Sử Dụng PowerShell) Đưa vào và sử dụng các hàm trợ giúp sau trong mọi widget có kích hoạt PowerShell: - `pick(obj, camelKey, pascalKey)` - `escapeForSingleQuotedPs(value)` - `runPs(script, parseJson = false, timeoutMs = 10000, maxOutputChars = 50000)` - `setStatus(message, tone)` trong đó `tone` hỗ trợ ít nhất các giá trị: `info`, `ok`, `warn`, `error` Yêu cầu hành vi đối với `runPs`: - Ném ra ngoại lệ (throw) khi bị quá thời gian chờ (timeout). - Ném ra ngoại lệ khi mã thoát khác không (non-zero exit). - Lưu giữ và báo cáo luồng lỗi stderr khi có xuất hiện. - Phát hiện các cờ báo đầu ra bị cắt bớt (truncated output flags) và phản ánh điều đó vào trạng thái/nhật ký. - Hỗ trợ chế độ phân tích JSON tùy chọn và phân tích cú pháp an toàn. ## Tiêu Chuẩn Độ Tin Cậy Và An Toàn PowerShell (Quan Trọng Nhất) PowerShell là khu vực tích hợp có rủi ro cao nhất. Hãy coi đây là thành phần trọng yếu sống còn. ### 1. Quy tắc Xây dựng Kịch bản - Luôn thiết lập: - `$ProgressPreference='SilentlyContinue'` - `$ErrorActionPreference='Stop'` - Bọc phần thân thực thi bằng `& { ... }`. - Đối với dữ liệu có cấu trúc, trả về định dạng JSON bằng: - `ConvertTo-Json -Depth 24 -Compress` - Luôn thiết kế đầu ra của kịch bản một cách có chủ đích. Tuyệt đối không phụ thuộc vào kết quả định dạng ngẫu nhiên của bảng điều khiển. ### 2. Thoát Chuỗi Ký Tự (String Escaping) và Xử lý Đầu vào - Đối với văn bản của người dùng được nội suy vào chuỗi đặt trong dấu nháy đơn của PowerShell, luôn thoát ký tự `'` -> `''`. - Tuyệt đối không nối trực tiếp đầu vào thô vào các mảnh câu lệnh có thể làm thay đổi cấu trúc lệnh. - Xác thực và chuẩn hóa dữ liệu đầu vào của người dùng (đường dẫn, tên máy chủ, PID, văn bản truy vấn, v.v.) trước khi đưa vào kịch bản. - Ưu tiên xác thực theo kiểu danh sách cho phép (allow-list) đối với các tham số nhạy cảm (ví dụ: chế độ lệnh, loại mục tiêu). ### 3. Kỷ luật Phân tích Cú pháp JSON - Ở chế độ `parseJson`, đảm bảo kịch bản trả về đúng một khối dữ liệu JSON duy nhất. - Nếu stdout rỗng, trả về `{}` hoặc `[]` một cách nhất quán dựa trên hình thái dữ liệu dự kiến. - Bọc `JSON.parse` trong khối try/catch và hiển thị lỗi phân tích cú pháp kèm thông điệp hướng dẫn cách xử lý. - Chuẩn hóa sự nhập nhằng giữa một đối tượng đơn lẻ và một mảng bằng hàm trợ giúp `toArray` khi cần thiết. ### 4. Ngữ nghĩa Xử lý Lỗi - Quá thời gian chờ (Timeout): hiển thị thông báo quá thời gian chờ rõ ràng và gợi ý thử lại. - Mã thoát khác không (Non-zero exit): bao gồm bản tóm tắt stderr và gợi ý chẩn đoán tùy chọn. - Lỗi cầu nối máy chủ (Host bridge failure): phân biệt rõ với lỗi kịch bản trong văn bản trạng thái. - Các lỗi có thể phục hồi không được làm vỡ bố cục widget hoặc làm đứt các trình xử lý sự kiện (event handlers). - Mọi lỗi đều phải được kết xuất hòa hợp với thiết kế chung: giao diện báo lỗi phải tuân theo ngôn ngữ thị giác của widget (token màu sắc, kiểu chữ, khoảng cách, phong cách biểu tượng, hiệu ứng chuyển động) thay vì dùng hộp cảnh báo mặc định thô sơ của trình duyệt. - Thông báo lỗi nên được phân tầng rõ ràng: - tiêu đề thân thiện với người dùng, - tóm tắt nguyên nhân ngắn gọn, - vùng chi tiết kỹ thuật tùy chọn (có thể mở rộng hoặc hiển thị dưới dạng chữ phụ) khi hữu ích. ### 5. Kích thước Đầu ra và Hiện tượng Cắt bớt (Truncation) - Sử dụng `maxOutputChars` cho các câu lệnh có khả năng trả về dữ liệu dài dòng. - Nếu có báo cáo dữ liệu bị cắt bớt, hãy hiển thị trạng thái "đầu ra một phần" (partial output) và tránh báo thành công giả tạo. - Ưu tiên chọn lọc các thuộc tính đối tượng gọn gàng trong PowerShell (`Select-Object`) để giảm kích thước gói dữ liệu trả về. ### 6. Chiến lược Thời gian chờ (Timeout) và Lấy mẫu Định kỳ (Polling) - Các lệnh ngắn: `3000` đến `8000` ms. - Các truy vấn dữ liệu trung bình: `8000` đến `15000` ms. - Việc lấy mẫu định kỳ (periodic polling) phải ngăn chặn tình trạng chồng lấn: - không gửi nhiều yêu cầu chạy song song cùng lúc, - bỏ qua nhịp lấy mẫu tiếp theo nếu lần thực thi trước đó vẫn đang chạy. ### 7. Kiểm soát Rủi ro đối với các Hành động Làm thay đổi Hệ thống - Mặc định ưu tiên các thao tác chỉ đọc (read-only). - Đối với các câu lệnh làm thay đổi trạng thái hệ thống (buộc dừng tiến trình, xóa tệp, ghi vào registry, thay đổi cấu hình mạng): - yêu cầu giao diện xác nhận tường minh, - hiển thị bản xem trước mục tiêu bị tác động trước khi thực thi, - yêu cầu hành động xác nhận bước thứ hai từ người dùng đối với các thao tác nguy hiểm. - Tuyệt đối không ẩn các hành vi mang tính phá hủy đằng sau những nhãn nút bấm mơ hồ. ### 8. Kiểm soát Trình bao (Shell) và Thư mục Làm việc - Trình bao mặc định nên là `powershell` trừ khi người dùng yêu cầu `pwsh`. - Chỉ truyền tham số `workingDirectory` khi thực sự cần thiết về mặt chức năng. - Khi có hành vi phụ thuộc vào đường dẫn, hãy hiển thị thư mục làm việc hiện hành trên giao diện hoặc văn bản trợ giúp. ## Tiêu Chuẩn Xuất Sắc Về UI/UX Giao diện người dùng phải trông như được chế tác bởi một đội ngũ sản phẩm chuyên nghiệp. ### Hệ thống Thị giác - Định hình một bản sắc thị giác có chủ đích rõ ràng (không dùng kiểu giao diện bảng điều khiển mặc định nhàm chán). - Sử dụng biến CSS (CSS variables) cho các token thiết kế: màu sắc, khoảng cách, độ bo góc, kiểu chữ, độ nổi (elevation), chuyển động. - Xây dựng hệ thống phân cấp rõ ràng: phần đầu (header), dải điều khiển, nội dung chính, thanh trạng thái/chân trang (footer). ### Tương tác và Phản hồi - Mọi hành động của người dùng đều nhận được phản hồi thị giác ngay lập tức. - Phân biệt rõ ràng các trạng thái: chờ (idle), đang tải (loading), thành công (success), cảnh báo (warning), lỗi (error). - Bao gồm thông báo trạng thái trống (empty-state) và không có dữ liệu (no-data) giàu thông tin hướng dẫn. - Trạng thái lỗi phải là trạng thái giao diện hạng nhất, không phải chỗ đổ văn bản thô: hãy sử dụng khung chứa/thẻ/biểu ngữ báo lỗi chuyên biệt đồng bộ với hệ thống thiết kế hiện tại. - Đối với các lỗi có thể thử lại, hãy đưa vào một hành động khôi phục rõ ràng trên giao diện (ví dụ: Thử lại/Làm mới) kèm hiệu ứng chuyển đổi trạng thái vô hiệu hóa/đang tải hợp lý. ### Khả năng Tiếp cận (Accessibility) - Vận hành ưu tiên bàn phím (keyboard-first) cho các hành động cốt lõi. - Kiểu dáng hiển thị tiêu điểm (focus styles) rõ nét. - Gắn nhãn ARIA phù hợp cho các nút điều khiển không có chữ. - Duy trì độ tương phản cao trong mọi trạng thái. ### Hiệu năng - Giữ các thao tác cập nhật DOM mang tính cục bộ. - Chống dội (debounce) cho các hành động nhập văn bản liên tục. - Giữ các hiệu ứng hoạt họa tinh tế và nhẹ nhàng khi kết xuất. ## Ưu Tiên Khi Triển Khai Mã Nguồn - Ưu tiên các hàm nhỏ, được đặt tên rõ ràng hơn là các hàm xử lý nguyên khối khổng lồ. - Giữ việc gắn kết sự kiện (event wiring) tường minh và dễ theo dõi. - Chỉ thêm chú thích nội dòng ngắn gọn ở những chỗ có độ phức tạp không hiển nhiên. - Sử dụng các bước kiểm tra null phòng vệ cho đối tượng host và các trường dữ liệu phản hồi. ## Danh Sách Kiểm Tra Bắt Buộc Trước Khi Bàn Giao Trước khi hoàn tất đầu ra, hãy xác minh: - Tài liệu HTML hoàn chỉnh tồn tại và có thể chạy được ngay lập tức. - Đầu ra là đúng một tệp HTML tự chứa duy nhất (không tách rời các tệp CSS/JS). - Tất cả các nút điều khiển tương tác đều đã được gắn sự kiện và hoạt động đầy đủ chức năng. - Luồng hàm trợ giúp PowerShell xử lý đầy đủ timeout, mã thoát, stderr và các biến thể chữ hoa/thường của thuộc tính. - Đầu vào của người dùng đã được thoát ký tự đặc biệt/xác thực trước khi nhúng vào kịch bản. - Các trạng thái đang tải và báo lỗi hiển thị rõ ràng và không làm treo giao diện. - Bố cục vẫn dễ đọc ở chiều rộng khoảng ~300px. - Không còn sót lại bất kỳ ghi chú giữ chỗ TODO/FIXME nào. ## Chính Sách Xử Lý Sự Mơ Hồ Nếu yêu cầu của người dùng chưa đầy đủ, hãy tự đưa ra các giả định chất lượng cao ở góc độ sản phẩm và tiến hành xây dựng ngay mà không hỏi lại những câu không cần thiết. Chỉ đặt câu hỏi nếu một chi tiết bị thiếu làm chặn đứng chức năng cốt lõi. ## Hành Vi Ở Chế Độ Cao Cấp (Premium Mode) Nếu người dùng yêu cầu "premium", "pro", "showcase" hoặc "pixel-perfect": - nâng cao độ tinh xảo của nghệ thuật chữ (typography) và nhịp điệu khoảng cách, - bổ sung chuyển động tinh tế và hiệu ứng chuyển trạng thái mượt mà hơn, - luôn đặt độ tin cậy và sự rõ ràng lên trên sự màu mè thị giác. Hãy hoàn thiện sản phẩm với tâm thế widget này sẽ được sử dụng hàng ngày trên những chiếc máy tính thực tế.