ffffffcn/dsh-intent-translator:把口語草稿重寫成結構化專業提示詞的 DSH 插件

前言

寫提示詞時常見的毛病不是不會寫長,而是詞不達意:腦子裏是「幫我搞個能自動回評論的東西」,落到提示詞裏卻不知道該用「分類」還是「審覈」,更別提「目標 / 背景 / 約束 / 驗收」這些骨架。直接把口語草稿丟給模型,得到的往往是另一段口語。

DeepSeek Harness(DSH)的插件 ffffffcn/dsh-intent-translator 就是處理這一步的。它不替你完成任務,只在發送之前把你的草稿重寫成結構化、術語準確的提示詞,並告訴你「你的說法」對應的專業說法是什麼。下面介紹它的能力邊界、安裝方式和用法。

這是什麼

一句話定位:DSH 插件,把一段口語化草稿重寫爲按「目標 / 背景 / 具體要求 / 約束 / 交付物 / 驗收」組織的專業提示詞,同時給出原話與專業術語的對照。

  • 維護者:FFFFFFcn
  • 路徑:Host 半註冊同源路由 /intent-translator/api,調用你已配置好的模型路由做一次輔助模型調用;Client 半在輸入框工具行左側加一個「譯」按鈕,用原生 <dialog> 展示結果。
  • 插件聲明瞭 dsh.bundle 與 dsh.client,無運行時依賴、無安裝腳本、無構建產物,從源碼可直接安裝。
  • 分類:模型推理;許可:MIT。

核心功能

README 裏寫得很明確,插件不替你完成任務,只重寫表達,能力集中在四處:

  1. 整段翻譯:把草稿重寫成一條可直接發送的提示詞,按「目標 / 背景 / 具體要求 / 約束 / 交付物 / 驗收」組織;缺失的關鍵信息會寫成「待確認」,而不是替你編。
  2. 術語對照:從原文裏挑出 2–5 處,給出「原話 → 專業說法」+ 一句解釋爲什麼更準確。
  3. 假設列表:模型爲了補全提示詞所做的關鍵理解列在底部,方便你發現並糾正跑偏的地方。
  4. 只查術語模式:輸入一段模糊描述,直接返回 3–6 個專業說法(含領域、解釋和例句),不改寫整段提示詞。適合先搞清楚「這件事專業上怎麼說」。

術語來源不是外部詞典,而是模型按插件內置的改寫規範生成;README 明確寫了「不確定時寧可不給,避免生造術語」。

安裝與啓用

README 給出的安裝方式是二選一,不提供 dsh plugin add 形式的命令:

# 方式一:插件市場(如 dsh-market)搜索本倉庫,或用市場生成的安裝命令從 GitHub 安裝

# 方式二:本地開發時以 bundle 形式安裝
plugin_manager({ action: "install_bundle", target: "<本倉庫路徑>" })

裝好後刷新頁面,輸入框工具行左側會出現「譯」按鈕。卸載用 remove_bundle。本倉庫可直接從源碼安裝,無需構建步驟。

典型用法

README 的四步操作:

  1. 在輸入框裏寫下現在的想法,不用組織語言,也不用管專業不專業。
  2. 點輸入框工具行左側的「譯」按鈕。
  3. 選「整段需求」,點「翻譯成專業提示詞」。
  4. 看結果:頂部大塊是專業提示詞,中間是術語對照,底部是假設。

結果區域的操作:右上角圖標可複製;點「替換輸入框」會把結果寫回草稿,不點就不會改動任何內容。

對話框裏沒想好怎麼寫時,插件會給幾個示例,點一下就能填入。

「只查術語」模式

在對話框裏切換到「只查術語」,輸入一段模糊描述,直接得到 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 的「安全與邊界」一節:

  1. 權限與數據外發:插件以當前 dsh 進程權限運行,你提交的原文會發送給當前模型路由的提供方,和正常對話一樣。安裝前建議先讀一遍源碼(倉庫裏 index.js、core.js、client.js 都在,無構建產物,可以直接看)並確認 MIT 許可。
  2. 不落盤:插件自身不落盤,服務端日誌只記錄失敗代碼,不記錄原文或模型輸出。
  3. 不自動發送:不會自動發送消息,不會靜默改寫草稿;只有點「替換輸入框」才改動草稿。
  4. 會消耗 token:每次翻譯調用一次當前模型,產生少量 token 消耗,費用計入你現有的模型路由。
  5. 失敗兜底:模型沒有按 JSON 結構返回時,對話框直接展示原文並標註「模型沒有按結構返回,以下是原文」;請求超時、模型不可用、頁面會話失效都有對應提示。
  6. 請求邊界:路由只接受 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 / 幻方無官方從屬關係。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜