前言¶
DSH 的定位是「一切皆插件」，常見插件要麼改工具鏈，要麼接管某類資源。這個插件做的事很輕：在會話裏敲 /qiyao，返回今天是七曜裏的哪一天、這一天的傳統象徵，以及可以拿它做點什麼。它不聯網、不預測、不給吉凶判斷，哪天斷網都一樣。
下面介紹 nanrener/dsh-plugin-qiyao 的定位、功能、安裝方式和設計上的取捨。
這是什麼¶
插件名 nanrener/dsh-plugin-qiyao，源碼在 GitHub，目錄頁在 skillhub.cn，維護者 nanrener。package.json 裏的 name 是 qiyao-calendar，當前版本 1.4.3，MIT 協議，零依賴，不聯網。描述與簡介一致：每天看一眼今天是什麼日子，日、月、火、水、木、金、土，順手給點安排靈感，不算吉凶。目錄分類爲「趣味換裝」。
一句話概括：它把「今天是什麼曜日、這天適合幹什麼」這個日曆小事做成了一條本地命令。
核心功能¶
README 開頭先寫它不做什麼，免得誤會：
- 不算吉凶。七曜在傳統曆法裏只管紀日，管吉凶的是六曜、建除、二十八宿值日那一套；
- 不聯網。日期、文案、輪換全在本地算；
- 不預測。只給出這一天的傳統象徵，今天干什麼自己判斷。
它實際做四件事：
- 輸入
/qiyao，返回當日信息：曜日、對應行星、象徵含義，以及「今日首推」和「也適合」兩段建議； - 支持查指定日期，如
/qiyao 2026-11-10，也認2026/11/10、2026年11月10日； - 頂欄有一個按鈕，點開是同樣的七曜信息浮層；
- 可以在「文檔」文件夾放一個
七曜事項.txt，按曜日排自己的待辦。
頂部按鈕的數據是內聯的，拆成兩處實現：宿主側 index.js 處理命令，client.js 是瀏覽器側的生成物，數據副本由腳本塞進 client.js。
安裝與啓用¶
安裝方式不涉及 dsh plugin add 命令。README 給的是圖形化流程：打開 DSH 插件頁 → 添加插件 → 填倉庫地址：
https://github.com/nanrener/dsh-plugin-qiyao
本地開發也可以直接把倉庫文件夾拖進來。裝完要重啓一次——/qiyao 命令熱生效，但頂欄按鈕屬於客戶端插件，客戶端插件是啓動時打包進頁面的，刷新頁面不會重新掃插件目錄。
典型用法¶
裝好後直接在會話裏用：
/qiyao
輸出形如：
📅 木曜日（♃ 木星）· 11 月 5 日
✨ 木星：擴張、機遇、增長、學習、遠行
✅ 今日首推：把想學的東西開個頭，哪怕只看二十分鐘
📋 也適合：談合作、約人喝咖啡、請教前輩、報名課程、出差、訂機票
查別的日期：
/qiyao 2026-11-10
管自己的事：在「文檔」文件夾建 七曜事項.txt，一行一條：
交週報
回客戶郵件
週三|寫方案初稿
週六|歸檔和備份
不帶前綴的條目天天出現；帶前綴的只在那一曜出現，沒輪到就暫時收着。前綴三種寫法都認：週三、星期三、水曜日。文件不存在時這幾行不顯示，不想用可以當沒這功能。
適用場景與注意¶
適合想用一個輕量本地日曆做日程心情參考、又不想讓插件聯網或讀別的數據的人。需要留意兩點：一是插件以當前 DSH 進程權限運行，行爲等同於你授權的那段代碼，安裝前應檢查源碼和許可證（MIT）；二是頂部按鈕不含你自己加的事項，瀏覽器端讀不到本地文件，完整內容要看 /qiyao。
內容分三層，README 明確要求別混爲一談：
- 曆法史實。日曜＝週日、月曜＝週一……土曜＝週六，這條可查證；七曜記日起源於巴比倫行星時制度，經印度《宿曜經》傳入東亞，日本明治九年（1876）寫進星期名並沿用至今。
- 行星象徵。
theme、boundary兩個字段來自西方占星的行星象徵體系，是象徵系統，不是知識。 - 現代轉譯。
picks（首推池）和fit（適配池）是作者把象徵翻譯成當代生活動作的結果，沒有古籍出典，不要當成出典依據。
README「幾個設計上的取捨」解釋了三處細節：首推池固定 8 條、適配池固定 20 條（20 與 7 互質，配 14 會被 7 整除導致同一星期幾永遠同一條）；頂部按鈕因讀不到宿主數據文件，所以內聯了數據副本，改文案後要跑 node scripts/build-client.mjs 重新生成；整張卡只用一個強調色，七曜傳統色只出現在符號、首推塊左側色條和淺底。另外「踩過的坑」記錄了 ctx.command(...) 是舊寫法，官方用 ctx.commands.register({ name, description, input, handler })；package.json 帶 BOM 會讓 pnpm 報 Invalid JSON；浮層改用原生 popover 屬性纔不會被祖先 overflow: hidden 裁掉。
小結¶
如果你的需求只是「每天看一眼今天是什麼日子」，這個插件夠用，且因爲不聯網、零依賴，裝和卸載都沒有負擔。目錄頁：https://www.skillhub.cn/plugins/nanrener/dsh-plugin-qiyao ，源碼：https://github.com/nanrener/dsh-plugin-qiyao 。
