前言¶

在開發 DeepSeek Harness 智能體時，如果需要處理 CAN 總線數據庫（DBC）文件，現有的方案往往需要編寫腳本或手動維護。dbc-skill 提供了一套結構化的命令行能力，讓智能體可以在 Harness 流程中直接創建、校驗、修改、對比和導出 DBC 文件，並將結果以 JSON 返回給模型。

插件定位¶

dbc-skill 是一個 DeepSeek Harness 插件，由維護者 wuwei6666 開發。它通過 npm 包 dsh-plugin-dbc（版本 0.1.0）提供能力，支持 CAN DBC 的增刪改查、校驗、比較以及與 Excel 工作簿的雙向轉換，同時兼容標準 CAN、CAN FD、經典與擴展幀、標準與擴展多路複用等常見場景。

核心能力¶

• CRUD 操作：通過腳本 scripts/dbc_crud.py 提供 node、message、signal 的增刪改查。
• 校驗與彙總：可對 DBC 進行校驗並輸出結構化摘要（–json summary）。
• 比較與歸一化：支持確定性比較節點、消息與信號，結果返回 JSON；保存時會對 DBC 文本進行歸一化處理。
• Excel 轉換：支持 DBC 導出爲 Excel（五工作表）以及從 Excel 導入 DBC，導入前會校驗整個工作簿。
• 多路複用與幀類型：支持標準幀、擴展幀、經典 CAN（1–8 字節）與 CAN FD（1–64 字節），支持標準與擴展多路複用。
• 安全編輯：在-place 保存時會自動創建備份（.bak），也可通過 –no-backup 禁用；推薦使用 –output 寫入新文件。

安裝與啓用¶

安裝前請確保環境滿足要求：

• Python 3.9+
• Node.js 22+
• DeepSeek Harness CLI 版本 >=0.2.1-rc.2 <0.3.0

通過 npm 包進行一次性設置：

npx --yes dsh-plugin-dbc setup

將插件安裝到 Harness 的 web 配置文件中：

npx --yes @deepseek-ai/dsh plugin --profile web add dsh-plugin-dbc

安裝後可通過 npm CLI 使用：

npx --yes dsh-plugin-dbc --json summary ./example.dbc
npx --yes dsh-plugin-dbc --json excel export ./example.dbc ./example.xlsx
npx --yes dsh-plugin-dbc --json excel import ./example.xlsx ./roundtrip.dbc
npx --yes dsh-plugin-dbc --json compare ./example.dbc ./roundtrip.dbc

典型用法¶

初始化一個空數據庫並校驗：

python3 scripts/dbc_crud.py --json init demo.dbc
python3 scripts/dbc_crud.py --json validate demo.dbc

添加節點、消息與信號：

python3 scripts/dbc_crud.py --json node add demo.dbc ECU_A --comment "Body controller"
python3 scripts/dbc_crud.py --json message add demo.dbc 0x123 Status --length 8 --sender ECU_A
python3 scripts/dbc_crud.py --json signal add demo.dbc Status State --start 0 --length 8

查看信號並再次校驗：

python3 scripts/dbc_crud.py --json signal show demo.dbc Status State
python3 scripts/dbc_crud.py --json summary demo.dbc
python3 scripts/dbc_crud.py --json validate demo.dbc

導出爲 Excel 並進行語義一致性檢查：

python3 scripts/dbc_crud.py --json excel export demo.dbc demo.xlsx
python3 scripts/dbc_crud.py --json excel import demo.xlsx roundtrip.dbc
python3 scripts/dbc_crud.py --json compare demo.dbc roundtrip.dbc

適用場景與注意¶

• 適合需要在 Harness 流程中自動生成、維護或對比 DBC 文件的場景。
• 插件通過 Harness 的用戶批准機制運行，當前進程權限下執行，安裝前請檢查源碼與許可證（MIT）。
• 導入 Excel 時僅接受 .xlsx 文件，且拒絕公式單元格；建議先粘貼爲值再導入。
• 歸一化保存會改變 DBC 文本的格式與註釋，不是字節級無損保留。

小結¶

dbc-skill 將 DBC 文件的管理與轉換能力集成到 Harness 生態中，通過結構化的命令行與 JSON 輸出，讓智能體可以安全地完成從創建、編輯到導出的全流程操作。文檔與示例位於 references/ 與 examples/ 目錄，可用於參考與實踐。

參考資料¶

• 插件目錄頁：https://www.skillhub.cn/plugins/wuwei6666/dbc-skill
• GitHub 倉庫：https://github.com/wuwei6666/dbc-skill
• NPM 包：https://www.npmjs.com/package/dsh-plugin-dbc