前言¶
寫提示詞時常見的毛病不是不會寫長,而是詞不達意:腦子裏是「幫我搞個能自動回評論的東西」,落到提示詞裏卻不知道該用「分類」還是「審覈」,更別提「目標 / 背景 / 約束 / 驗收」這些骨架。直接把口語草稿丟給模型,得到的往往是另一段口語。
DeepSeek Harness(DSH)的插件 ffffffcn/dsh-intent-translator 就是處理這一步的。它不替你完成任務,只在發送之前把你的草稿重寫成結構化、術語準確的提示詞,並告訴你「你的說法」對應的專業說法是什麼。下面介紹它的能力邊界、安裝方式和用法。
這是什麼¶
一句話定位:DSH 插件,把一段口語化草稿重寫爲按「目標 / 背景 / 具體要求 / 約束 / 交付物 / 驗收」組織的專業提示詞,同時給出原話與專業術語的對照。
- 維護者:FFFFFFcn
- 路徑:Host 半註冊同源路由
/intent-translator/api,調用你已配置好的模型路由做一次輔助模型調用;Client 半在輸入框工具行左側加一個「譯」按鈕,用原生<dialog>展示結果。 - 插件聲明瞭
dsh.bundle與dsh.client,無運行時依賴、無安裝腳本、無構建產物,從源碼可直接安裝。 - 分類:模型推理;許可:MIT。
核心功能¶
README 裏寫得很明確,插件不替你完成任務,只重寫表達,能力集中在四處:
- 整段翻譯:把草稿重寫成一條可直接發送的提示詞,按「目標 / 背景 / 具體要求 / 約束 / 交付物 / 驗收」組織;缺失的關鍵信息會寫成「待確認」,而不是替你編。
- 術語對照:從原文裏挑出 2–5 處,給出「原話 → 專業說法」+ 一句解釋爲什麼更準確。
- 假設列表:模型爲了補全提示詞所做的關鍵理解列在底部,方便你發現並糾正跑偏的地方。
- 只查術語模式:輸入一段模糊描述,直接返回 3–6 個專業說法(含領域、解釋和例句),不改寫整段提示詞。適合先搞清楚「這件事專業上怎麼說」。
術語來源不是外部詞典,而是模型按插件內置的改寫規範生成;README 明確寫了「不確定時寧可不給,避免生造術語」。
安裝與啓用¶
README 給出的安裝方式是二選一,不提供 dsh plugin add 形式的命令:
# 方式一:插件市場(如 dsh-market)搜索本倉庫,或用市場生成的安裝命令從 GitHub 安裝
# 方式二:本地開發時以 bundle 形式安裝
plugin_manager({ action: "install_bundle", target: "<本倉庫路徑>" })
裝好後刷新頁面,輸入框工具行左側會出現「譯」按鈕。卸載用 remove_bundle。本倉庫可直接從源碼安裝,無需構建步驟。
典型用法¶
README 的四步操作:
- 在輸入框裏寫下現在的想法,不用組織語言,也不用管專業不專業。
- 點輸入框工具行左側的「譯」按鈕。
- 選「整段需求」,點「翻譯成專業提示詞」。
- 看結果:頂部大塊是專業提示詞,中間是術語對照,底部是假設。
結果區域的操作:右上角圖標可複製;點「替換輸入框」會把結果寫回草稿,不點就不會改動任何內容。
對話框裏沒想好怎麼寫時,插件會給幾個示例,點一下就能填入。
「只查術語」模式¶
在對話框裏切換到「只查術語」,輸入一段模糊描述,直接得到 3–6 個專業說法,不會改寫整段提示詞。這個模式的輸入上限更緊:正文 600 字,整段翻譯是 4000 字。
可選配置¶
不改配置也能用。想指定模型時,在 cordis.patch.yml 的插件行里加 config:
- insert:
- id: intent-translator
name: '@ffffffcn/dsh-intent-translator'
config:
provider: deepseek # 可選;和 model 同時給才生效
model: deepseek-flash # 不指定時用默認模型
maxInputChars: 4000
maxTermsInputChars: 600
timeoutMs: 60000
temperature: 0.4
promptMaxTokens: 2400
termsMaxTokens: 1200
maxConcurrent: 2
provider 與 model 必須成對出現;README 明確寫了只寫一個會被忽略並回退到默認模型。默認模型取「新會話默認模型」,也可以在這裏指定。
適用場景與注意¶
適合的場景:草稿寫得隨性、但希望發給模型的提示詞結構完整且術語準確的場合;以及不確定某個模糊說法該用什麼專業表述、想先查一下的場合。整個交互在輸入框側完成,不需要改命令行。
幾點需要留意的地方,都來自 README 的「安全與邊界」一節:
- 權限與數據外發:插件以當前 dsh 進程權限運行,你提交的原文會發送給當前模型路由的提供方,和正常對話一樣。安裝前建議先讀一遍源碼(倉庫裏
index.js、core.js、client.js都在,無構建產物,可以直接看)並確認 MIT 許可。 - 不落盤:插件自身不落盤,服務端日誌只記錄失敗代碼,不記錄原文或模型輸出。
- 不自動發送:不會自動發送消息,不會靜默改寫草稿;只有點「替換輸入框」才改動草稿。
- 會消耗 token:每次翻譯調用一次當前模型,產生少量 token 消耗,費用計入你現有的模型路由。
- 失敗兜底:模型沒有按 JSON 結構返回時,對話框直接展示原文並標註「模型沒有按結構返回,以下是原文」;請求超時、模型不可用、頁面會話失效都有對應提示。
- 請求邊界:路由只接受
POST,並調用ctx.connection.requestRejection做 Host/Origin 校驗和瀏覽器認證,未通過認證的請求返回 401/403;請求體上限 64 KiB,正文上限 4000 字(只查術語 600 字),同時最多 2 個翻譯在跑。
小結¶
這個插件的價值很窄:它不生成內容、不做任務規劃,只把「你寫的」翻譯成「模型更容易正確執行的表達」,再順手告訴你專業上該怎麼說。如果手寫提示詞時經常卡在術語和結構上,又不想每次翻文檔,值得裝上試一輪。
- 目錄頁:https://www.skillhub.cn/plugins/FFFFFFcn/dsh-intent-translator
- 倉庫:https://github.com/FFFFFFcn/dsh-intent-translator
社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。