前言¶

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