前言¶

DeepSeek Harness（DSH）的核心理念是“一切皆插件”，開發者可以通過組合插件快速構建特定場景的智能體。在開發面向越南市場的業務智能體時，通常需要處理三個高頻且容易出錯的任務：將數字轉換爲越南盾金額文字、生成符合標準的 VietQR 轉賬二維碼、以及根據稅號（MST）查詢真實企業信息。直接讓大模型處理這些任務，容易出現格式錯誤或幻覺（尤其是查詢企業信息時）。下面介紹的 mikegabyte/dsh-vn-biz 旨在解決這些問題。

核心功能¶

該插件提供了三個基礎工具，用於處理越南本地業務場景：

1. VNĐ amount to words：將數字轉換爲越南盾金額文字。
2. VietQR quick-link：生成 VietQR 轉賬二維碼鏈接。
3. Tax code lookup：通過稅號（MST）查詢企業信息。

安裝與啓用¶

安裝過程主要涉及代碼克隆、依賴構建和插件註冊。

1、克隆倉庫到本地：

git clone <repo-url> dsh-vn-biz
cd dsh-vn-biz

2、安裝依賴並構建項目：

npm install
npm run build

3、將插件添加到指定的 DSH profile：

dsh plugin --profile <ten-profile> add /path/to/dsh-vn-biz

安裝完成後，必須重啓 dsh web 服務才能識別新插件。

典型用法¶

安裝完成後，Agent 可以通過自然語言調用上述工具：

• 金額轉文字：

    Đổi số tiền 15750000 sang chữ giúp mình

• 生成 VietQR 二維碼：

    Tạo QR chuyển khoản Vietinbank số 113366668888, tên NGUYEN VAN A, 500000đ, nội dung 'thanh toan hoa don thang 8'.

• 查詢企業信息：

    Tra công ty mã số thuế 0100109106 giúp mình

適用場景與注意¶

使用時需注意以下限制：

• 輸入限制：amount_to_words 僅支持非負整數（VNĐ 在實際業務中不使用小數）。
• 網絡依賴：tax_code_lookup 和 vietqr_quicklink 依賴公開的 api.vietqr.io 和 img.vietqr.io 接口，無需 API Key，但無服務等級協議（SLA）保障。
• 權限與合規：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（MIT）。

結尾¶

該插件通過封裝固定算法和直接調用公共數據接口，降低了 Agent 在越南本地業務場景下的幻覺風險，提高了指令執行的準確率。更多細節可參考社區目錄或源碼倉庫。

• 源碼倉庫：https://github.com/mikegabyte/dsh-vn-biz
• 社區目錄：https://www.skillhub.cn/plugins/mikegabyte/dsh-vn-biz