前言¶

在开发 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