ข้ามไปเนื้อหา
Chapters
  1. ยินดีต้อนรับสู่ Omarchy!
  2. เริ่มต้นใช้งาน
  3. มาจาก Mac หรือ Windows
  4. การนำทาง
  5. แถบด้านบน
  6. ธีม
  7. ปุ่มลัด
  8. คลิปบอร์ดและประวัติแบบรวมเป็นหนึ่งเดียว
  9. เตือนความจำ
  10. การแจ้งเตือน
  11. การแยกข้อความและการพูดพิมพ์
  12. ภาพหน้าจอและการบันทึกหน้าจอ
  13. สวิตช์, การไม่ได้ใช้งาน และภาพพักหน้าจอ
  14. Omarchy CLI
  15. เทอร์มินัล
  16. Neovim
  17. AI
  18. เครื่องมือสำหรับนักพัฒนา
  19. เครื่องมือ Shell
  20. ฟังก์ชัน Shell
  21. TUIs
  22. GUIs
  23. เบราว์เซอร์
  24. แอป/บริการเชิงพาณิชย์
  25. เว็บแอป
  26. การเล่นเกม
  27. การกรอก PDF
  28. Windows VM
  29. แพ็กเกจอื่น ๆ
  30. อัปเดต
  31. Dotfiles
  32. ปลั๊กอิน Shell
  33. จอภาพ
  34. แป้นพิมพ์ เมาส์ และแทร็กแพด
  35. เครือข่าย
  36. การพักระบบ
  37. การยืนยันตัวตนด้วยฮาร์ดแวร์
  38. แบบอักษร
  39. พื้นหลัง
  40. พร้อมต์
  41. แบรนดิ้ง
  42. การปรับแต่งทั่วไป
  43. การสร้างธีมของคุณเอง
  44. การรองรับ Mac
  45. การแก้ไขปัญหา
  46. คำถามที่พบบ่อย
  47. สแน็ปช็อตของระบบ
  48. ความปลอดภัย
  49. Omarchy บน...
  50. การติดตั้งแบบ Dual Boot
  51. การติดตั้งแบบไม่มีผู้ดูแล

คู่มือ

ปลั๊กอิน Shell

เดสก์ท็อป Omarchy รันเป็นกระบวนการ Quickshell เดียวที่อยู่ยาวนานชื่อ omarchy-shell และแทบทุกอย่างที่คุณเห็นบนหน้าจอคือปลั๊กอินอยู่ข้างในมัน แถบคือปลั๊กอิน แผงที่เลื่อนลงมาจากมันก็เช่นกัน โอเวอร์เลย์เต็มจออย่างตัวเลือกอีโมจิและตัวจัดการคลิปบอร์ดก็เช่นกัน เมนู Omarchy เอง หน้าจอล็อก กล่องโต้ตอบ polkit และบริการไร้ส่วนหัวที่คอยดูแบตเตอรี่ของคุณและอุ่นหน้าจอตอนกลางคืนก็เช่นกัน

นั่นไม่ใช่แค่รายละเอียดการนำไปใช้ มันหมายความว่าคุณสามารถปิดชิ้นส่วนของเดสก์ท็อป สลับพวกมันออก หรือเขียนของคุณเองโดยไม่แตะต้องซอร์สโค้ดของ Omarchy สักบรรทัด

ปลั๊กอินบุคคลที่หนึ่งมาพร้อม Omarchy และอยู่ใน $OMARCHY_PATH/shell/plugins/ อะไรก็ตามที่คุณเพิ่มเอง - การทดลองของคุณเอง หรืออะไรที่คุณพบบน GitHub - อยู่ใน ~/.config/omarchy/plugins/ ทั้งสองถูกค้นพบในวิธีเดียวกันตอนเริ่ม แต่ปลั๊กอินในตัวได้รับอินเทอร์เฟซ shell ที่เชื่อถือได้ ขณะที่ปลั๊กอินบุคคลที่สามได้รับอินเทอร์เฟซจำกัดที่กำหนดขอบเขตเฉพาะบริการและวงจรชีวิตของตัวเอง โคลนของปลั๊กอินในตัวเก็บเฉพาะการกำหนดค่าเฉพาะแหล่งและการเรียก UI ที่จำเป็นสำหรับพฤติกรรมเดิม

ดูว่าคุณมีอะไร

omarchy plugin list

นั่นพิมพ์ปลั๊กอินทุกตัวที่ค้นพบพร้อม id ของมัน ว่ามันเปิดใช้อยู่ไหม ว่ามันเป็นบุคคลที่หนึ่งหรือบุคคลที่สาม ชนิดของมัน และชื่อที่แสดง เพิ่ม --json ถ้าคุณกำลังป้อนมันให้กับอย่างอื่น

id ของปลั๊กอินมีเนมสเปซ ปลั๊กอินในตัวทั้งหมดเริ่มด้วย omarchy. - omarchy.clock, omarchy.network, omarchy.notifications - และเนมสเปซนั้นถูกสงวนไว้ ดังนั้นปลั๊กอินบุคคลที่สามจึงอ้างมันไม่ได้เลย

เปิดและปิดพวกมัน

omarchy plugin enable omarchy.tailscale
omarchy plugin disable omarchy.weather

หรือใช้เมนู ตั้งค่า > Plugins มี Enable, Disable, Add, Clone และ Remove แต่ละอันพร้อมตัวเลือกที่เสนอเฉพาะปลั๊กอินที่สมเหตุสมผลสำหรับการกระทำนั้นเท่านั้น

สถานะเปิดใช้ถูกเก็บไว้ใน ~/.config/omarchy/shell.json และกฎต่างกันเล็กน้อยสำหรับปลั๊กอินสองชนิด ปลั๊กอินบุคคลที่สามถูกเปิดใช้อย่างแม่นยำเมื่อ id ของมันปรากฏที่ใดที่หนึ่งในไฟล์นั้น - ในฐานะรายการเค้าโครงแถบ ในฐานะรายการใน plugins[] หรือในฐานะ bar.id ปลั๊กอินบุคคลที่หนึ่งที่ไม่ใช่วิดเจ็ตแถบเป็นอีกทางหนึ่ง พวกมันเปิดเป็นค่าเริ่มต้นและปิดเฉพาะโดยถูกแสดงใน disabledPlugins[] เท่านั้น

ปลั๊กอินแถบเต็มรูปแบบไม่มีสถานะปิดเลย มีแถบอยู่เพียงแถบเดียวเสมอ ดังนั้นคุณจึงแทนที่มันโดยเปิดใช้อีกอันหนึ่ง การวางวิดเจ็ตแถบครอบคลุมใน แถบเมนู

เพิ่มปลั๊กอินจาก git

ปลั๊กอินบุคคลที่สามเป็นแค่รีโพ git พร้อม manifest.json ที่รากของมัน

omarchy plugin add https://github.com/acme/omarchy-weather.git --enable

ก่อนมันจะทำอะไร มันบอกคุณอย่างตรงไปตรงมาว่าปลั๊กอินรันเป็นโค้ดตามอำเภอใจ ไม่แซนด์บ็อกซ์ ภายในกระบวนการ shell ที่อยู่ยาวนานของคุณ แสดง URL ให้คุณ และขอให้คุณยืนยัน จงถือเรื่องนั้นให้จริงจัง อินเทอร์เฟซปลั๊กอินบุคคลที่สามไม่ได้เปิดเผยบริการยืนยันตัวตนโดยตรง และแถบแทนที่จะได้เฉพาะความสามารถจำกัดสำหรับ UI ที่ไม่ใช่การยืนยันตัวตนซึ่งกำหนดค่าไว้เท่านั้น ปลั๊กอินภาพยังคงแชร์ฉาก QML ของ shell และเดินวัตถุหลักธรรมดาได้ ขณะที่โค้ดปลั๊กอินทั้งหมดรันพร้อมทุกอย่างที่บัญชีผู้ใช้ของคุณเข้าถึงได้ สถานะการยืนยันตัวตนถูกปกป้องแยกต่างหากโดยเก็บบริการเหล่านั้นนอกกราฟวัตถุโฮสต์ที่เข้าถึงได้ เพิ่มเฉพาะรีโพที่คุณเต็มใจจะรันเท่านั้น และอ่านพวกมันก่อนเปิดใช้

แถบแทนที่สามารถแสดงวิดเจ็ตที่ติดตั้งไว้ได้ แต่วิดเจ็ตบุคคลที่สามที่พึ่งพาบริการอาจมีฟังก์ชันลดลงตรงนั้น เพราะแถบไม่ได้รับอนุญาตให้ขอวัตถุบริการสดของปลั๊กอินอื่น สลับกลับไป omarchy.bar ในตัวถ้าวิดเจ็ตดังกล่าวต้องการบริการคู่หูของมัน

จากนั้นมันโคลนรีโพลงในไดเรกทอรีจัดเตรียม ตรวจสอบ manifest ปฏิเสธการติดตั้งหากปลั๊กอินอื่นอ้าง id นั้นไปแล้ว และย้ายมันเข้าไปใน ~/.config/omarchy/plugins/<id>/ โดยไม่มี --enable มันถามว่าคุณอยากให้มันเปิดตอนนี้หรือไม่ และคุณสามารถปฏิเสธและไปอ่านโค้ดก่อนได้ มันไม่เคยรันอะไรจากปลั๊กอิน ไม่เคยรัน hook ติดตั้ง และไม่เคยขอ sudo - มันโคลนไฟล์ ตรวจสอบ manifest และพลิกบิตผ่าน IPC

การอัปเดตคือการ pull แบบ fast-forward ของ checkout เดียวกันนั้น:

omarchy plugin update acme.weather
omarchy plugin update

โดยไม่มี id มันอัปเดตปลั๊กอินที่จัดการด้วย git ทุกตัวที่คุณมี มันแสดง diff ให้คุณดูก่อนนำไปใช้ ปฏิเสธที่จะอัปเดตหากคุณมีการเปลี่ยนแปลงในเครื่องที่มัน fast-forward ผ่านไม่ได้ และย้อนกลับหากรุ่นใหม่ล้มเหลวในการตรวจสอบ

omarchy plugin remove acme.weather

การลบออกจะปิดใช้ปลั๊กอินก่อน จากนั้นลบมันถ้ามันเป็น git checkout (รีโพยังอยู่ต้นทาง) หรือ unlink มันถ้ามันเป็น symlink โฟลเดอร์ปลั๊กอินทำมือที่ไม่มีรีโพ git จะถูกย้ายไปสำรองประทับเวลาภายในไดเรกทอรีปลั๊กอินแทนที่จะถูกลบออกไปเฉย ๆ

โคลนปลั๊กอินในตัวเพื่อปรับแก้มัน

นี่คือส่วนโปรดของฉัน ถ้าคุณอยากเปลี่ยนวิธีที่วิดเจ็ตในตัวทำงาน อย่าแก้ไขไฟล์ใต้ $OMARCHY_PATH - พวกมันเป็นของแพ็กเกจ และการอัปเดตครั้งต่อไปจะเขียนทับพวกมัน ให้โคลนมันแทน:

omarchy plugin clone omarchy.clock

นั่นคัดลอกทั้งปลั๊กอินเข้าไปใน ~/.config/omarchy/plugins/dhh.clock (ชื่อผู้ใช้ของคุณ ไม่ใช่ของฉัน) เปลี่ยนชื่อเป็น “My Clock” เปิดใช้มัน และสลับ shell จากตัวในตัวไปเป็นสำเนาของคุณ - โดยเก็บตำแหน่งและการตั้งค่าของวิดเจ็ตแถบที่มีอยู่ไว้ เพิ่ม --edit เพื่อเปิดไดเรกทอรีใหม่ใน $EDITOR ของคุณทันที ซึ่งเป็นสิ่งที่ ตั้งค่า > Plugins > Clone Plugin ของเมนูทำให้คุณ

คำนำหน้าชื่อผู้ใช้ทำให้ id ของโคลนคุณเป็นของคุณ ดังนั้นการแชร์มันจึงไม่ชนกับของคนอื่น การเรียกไปยัง id ในตัวดั้งเดิมจะถูกส่งไปโคลนของคุณ ดังนั้นอะไรก็ตามที่อ้างถึง omarchy.clock จึงไม่จำเป็นต้องอัปเดต และถ้าคุณทำมันพัง omarchy plugin remove dhh.clock จะเอาตัวในตัวกลับมา

การบันทึกไฟล์ที่ใดก็ตามใต้ ~/.config/omarchy/plugins/ จะโหลดโค้ดปลั๊กอินซ้ำโดยอัตโนมัติ ดังนั้นคุณจึงปล่อยโปรแกรมแก้ไขเปิดไว้และดูการเปลี่ยนแปลงของคุณลงจอดได้

เขียนของคุณเอง

ปลั๊กอินคือไดเรกทอรีพร้อม manifest.json และ QML บ้าง manifest ประกาศ schemaVersion: 1, id, name, version, kinds หนึ่งชนิดขึ้นไป และวัตถุ entryPoints ที่ชี้ไปยังไฟล์ QML สำหรับแต่ละชนิด:

Kind What it is
bar-widget คอมโพเนนต์ที่แถบที่ใช้งานอยู่หย่อนลงในส่วนหนึ่งได้
panel หน้าต่างลอยคงอยู่หรือถูกเรียกขึ้นมา
overlay โอเวอร์เลย์เต็มจอ
menu พื้นผิวเมนูที่ถูกเรียกขึ้นมา
service ซิงเกิลตันไร้ส่วนหัวที่ไม่มี UI
bar แถบเต็มรูปแบบที่แทนที่แถบในตัว

ปลั๊กอินประกาศได้หลายชนิดพร้อมกัน - ปลั๊กอินสื่อเป็นทั้ง service และ bar-widget วิดเจ็ตแถบได้บล็อก barWidget พิเศษพร้อมชื่อที่แสดง หมวดหมู่ defaultSection ที่เป็นตัวเลือก และ allowMultiple ซึ่งบอกว่ามันสมเหตุสมผลไหมที่จะมีมากกว่าหนึ่งอันบนแถบ วิดเจ็ตส่วนใหญ่ตั้งเป็น false ตัวเว้นวรรคและตัวชี้วัดตั้งเป็น true

ก่อนคุณเผยแพร่อะไร ให้ตรวจสอบมัน:

omarchy plugin validate ./my-plugin

นั่นรันการตรวจสอบเดียวกับที่ shell ทำเมื่อโหลด เวอร์ชันสคีมา ฟิลด์ที่ต้องมี id ที่ไม่ถูกสงวน จุดเริ่มต้นที่เป็นพาธสัมพัทธ์ปลอดภัยและมีอยู่จริง จุดเริ่มต้นสำหรับทุกชนิดที่คุณอ้าง และไม่มี symlink ที่ใดภายในโฟลเดอร์เลย

สำหรับการพัฒนาปลั๊กอิน ให้ดู เอกสารอ้างอิง shell และ แคตตาล็อกปลั๊กอินบุคคลที่หนึ่ง

แชร์ของคุณกับโลก

เมื่อคุณทำอะไรที่คุณชอบขึ้นมาแล้ว ให้วางมันไว้ในรีโพ git สาธารณะ นั่นคือกลไกการเผยแพร่ทั้งหมด - จากนั้นใครก็ตามก็รัน omarchy plugin add กับ URL ของคุณและมีมันรันอยู่ภายในไม่กี่วินาทีได้

เพื่อช่วยให้ผู้คนเจอมันได้จริง ให้แสดงมันที่ plugins.omarchy.org นั่นคือตลาดสำหรับปลั๊กอิน shell ของ Omarchy และมันคือที่แรกที่ควรดูเมื่อคุณสงสัยว่าใครสักคนสร้างวิดเจ็ตที่คุณกำลังจะเขียนไปแล้วหรือยัง เรียกดูมันก่อนคุณเริ่ม!