前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許開發者根據具體工作流擴展功能。在會話開發中，若需集成詩詞查詢功能，通常需要調用外部 API 或在對話中手動輸入指令。這款插件在會話頁頭註冊了「詩詞」標籤頁，提供了一套免 token 的查詢方案，與「對話」和「軌跡」標籤頁並列。
核心定位¶
由 runcat-tommy 維護的聯網工具插件。它通過在會話頁頭新增「詩詞」標籤頁，解決在 DSH 環境中直接檢索中文詩詞的需求，同時不消耗模型配額。
安裝與啓用¶
安裝前需確保已安裝 pnpm。執行以下命令安裝插件：
dsh plugin --profile web add dsh-chinese-poetry
安裝完成後重啓 dsh web，在任意會話的頁頭標籤欄即可看到新增的「詩詞」標籤頁。
核心功能¶
該插件在公共數據源之上做了面向查詢使用的封裝與優化：
- 免 token 的會話頁視圖：在會話頁頭註冊「詩詞」標籤頁，無需任何模型 Key，純前端調用公共接口。
- 健壯的數據層：內置令牌桶限速（搜索 6 次/分、其它 15 次/分）、本地緩存、429 指數退避、連續失敗降級爲緩存 / 離線兜底，避免被限流打掛。
- 朝代糾偏表：公共接口對部分詩人（尤其宋代）的朝代標註有誤，本插件內置常見詩人朝代校正表，展示時自動糾正。
- 離線兜底表：內置約 90 首常備詩詞，斷網或接口不可用時仍能演示；2 字內短查詢走本地精選，3 字以上才檢索全庫。
- 交互功能：支持搜索框輸入詞/句並按作者/朝代/體裁篩選、飛花令（輸入單字隨機換詩）、節日專題（春節/中秋等）、收藏與歷史記錄、簡繁切換。
- 輸出與集成：提供分享卡片圖（生成可下載的 PNG）；AI 解讀功能將提示詞寫入 dsh 會話輸入框，由用戶手動確認發送，複用現有模型配額。
典型用法¶
- 打開一個會話，點擊頁頭「詩詞」標籤進入界面。
- 在搜索框輸入關鍵詞，或使用下拉菜單篩選作者、朝代、體裁。
- 使用「飛花令」輸入單字，點擊切換查看含該字的詩詞。
- 點擊卡片圖生成並下載分享圖片。
- 點擊「AI 解讀」，將解讀提示詞填入輸入框，按回車發送給模型。
注意事項¶
- 版本要求：要求 dsh web 0.1.0-rc.6 或更新版本。
- 數據源：依賴詩泉 (poetry.palemoky.com)，該服務免費、無需註冊、CORS 全開。若查詢較慢，多爲服務端響應所致。
- 配額消耗：AI 解讀功能透傳給 dsh 會話，消耗用戶已有的模型配額。
- 存儲方式：收藏、歷史記錄與緩存純本地存儲，不建立後端服務。
- 依賴環境：安裝前需確保已安裝 pnpm。
