前言¶
在 DeepSeek Harness (DSH) 的插件生態中，處理不同編程語言的命名規範轉換是常見需求。dsh-case 插件解決了這一痛點，它通過註冊 case_convert 工具，允許在多種命名風格之間快速轉換。
插件定位¶
該插件由 ZhijiangTang 維護，採用純 ESM 模塊編寫，零依賴，無需構建步驟。它旨在爲 DSH 智能體提供輕量級的文本格式化能力。
安裝與啓用¶
使用官方安裝命令將插件添加到指定配置文件：
dsh plugin --profile <name> add dsh-case
核心功能¶
插件提供的核心工具名爲 case_convert，主要參數包括：
text(string, 必填)：待轉換的文本內容。target(string, 必填)：目標命名風格。source(string, 可選)：源命名風格，默認爲auto，由插件自動檢測。
典型用法¶
該工具支持多種常見的命名風格轉換。以輸入 hello_world 爲例，支持的 target 參數及對應輸出如下：
| target 參數 | 輸出結果 |
|---|---|
camelCase |
helloWorld |
PascalCase |
HelloWorld |
snake_case |
hello_world |
kebab-case |
hello-world |
CONSTANT_CASE |
HELLO_WORLD |
UPPER |
HELLO WORLD |
lower |
hello world |
Title Case |
Hello World |
分詞規則¶
插件對輸入文本的分詞邏輯如下：
- 分隔符切分：按
-、_、空白、.進行切詞。 - 大小寫邊界：在無分隔符片段內，依據大小寫邊界切分：
- 小寫轉大寫（
helloWorld→hello/World） - 連續大寫後接小寫（
HTTPApi→HTTP/Api） - 數字後接「大寫 + 小寫」（
my2Factor→my2/Factor）
- 小寫轉大寫（
- 數字粘合：數字粘合到相鄰單詞，不單獨成詞（例如
version2保持爲version2），開頭的2FA不拆分。 - 空值處理：空輸入或純符號輸入原樣返回，
words字段爲空數組。
返回值¶
工具返回一個規範的 JSON 對象，包含輸入、目標、源風格、輸出結果及分詞後的單詞列表：
{ "input": "...", "target": "camelCase", "source": "snake_case", "output": "...", "words": [...] }
注意事項¶
插件以當前 DSH 進程的權限運行。安裝前請檢查源碼與許可證（MIT）。插件依賴於以下 peerDependencies：@deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-tools ^0.1.0-rc.6、@deepseek-ai/dsh-llm ^0.1.0-rc.6。
結語¶
dsh-case 提供了簡潔、零依賴的命名轉換方案。更多細節可查閱 GitHub 倉庫：https://github.com/ZhijiangTang/dsh-case
