guomonth/dsh-erp：在本地构建企业知识图谱

前言¶

DSH（DeepSeek Harness）作为智能体开发平台，面对复杂的 ERP 系统时，往往缺乏对界面菜单、字段和业务流程的上下文认知。手动为每个页面编写规则既繁琐又难以维护。guomonth/dsh-erp 插件通过让 DSH 直接通过浏览器接口观察系统，将获取的知识固化在本地，使智能体能够复用这些经验。

这是什么¶

这是一个 DeepSeek Harness 插件，由 GuoMonth 维护。它的核心作用是“学习你的 ERP”，即通过浏览器交互观察 ERP 的菜单、页面、字段和业务数据，并在本地构建知识图谱，最终将经验导出为可复用的技能。

核心功能¶

浏览器学习：通过浏览器接口学习可访问的菜单、页面、字段和业务数据。
本地构建：将观察到的知识保存在本地，不依赖远程服务器。
技能导出与导入：支持将当前 ERP 的经验导出为原生技能（SKILL.md），并导入到其他用户的配置中。
配置与状态检查：通过 cordis.patch.yml 进行配置，并支持检查 erp_system_status 和 erp_native_status。
多模式支持：支持原生 DSH 浏览器使用，并可选计算机使用。

安装与启用¶

在安装前请确保环境满足要求：
* Node.js: >=24.18.0 <25
* DSH: 0.2.0-rc.2
* 桌面环境: Linux x64，需要图形会话和 Chromium 系统库（Windows/macOS 桌面支持待定）

安装插件¶

使用 npm 执行安装命令：

npm exec --yes --package=pnpm@11.7.0 -- dsh plugin --profile web add @guosheng_047/dsh-erp@latest

如果环境仅安装了 Node.js，可以使用以下命令：

npm exec --yes --package=@deepseek-ai/dsh@0.2.0-rc.2 --package=pnpm@11.7.0 -- dsh plugin --profile web add @guosheng_047/dsh-erp@latest

配置¶

停止 DSH，编辑配置文件 ~/.dsh/profiles/web/cordis.patch.yml（或 $DSH_HOME/profiles/web/cordis.patch.yml）。

在文件中添加或修改 id: erp 配置项。文件中若包含注释和 []，请替换为以下块：

- id: erp
  config:
    system:
      url: "https://erp.example.com/app/#/login"
      name: "My ERP"
      account: "my-work-account"
      # tenant: "my-company"
      # role: "purchasing"

url 是必填项。名称默认为主机名，账号默认为 default。使用不同的账号别名可以隔离知识，但它们不是凭证。

启动 DSH：

dsh --profile web

首次启动时，需要确认预览通知，选择工作区并配置模型。然后请求 erp_system_status 和 erp_native_status，通过原生浏览器工具打开配置的 ERP 并手动登录。

典型用法¶

映射与探索
请求 DSH 先映射可访问的菜单，然后探索页面、字段和业务领域。操作前检查保存的知识，获取当前的观察和批准，并在事后验证结果。
技能导出
将此 ERP 的经验导出为可分享的技能。使用 erp_experience_export 命令，它会创建一个包含 JSON 引用的 SKILL.md 目录。
技能导入
将技能的引用/知识导入到我的配置 ERP 中。使用 erp_experience_import，它会将知识重新绑定到本地范围，并注册原生技能。导入不会复制登录凭据或原始证据。

适用场景与注意¶

适用场景：需要智能体理解特定 ERP 业务流程，且该 ERP 没有公开 API 或难以编写 API 脚本时。
权限与安全：原生浏览器和计算机调用需要单独的 DSH 批准。导入的经验不会授予操作权限，仅包含知识引用。
兼容性：不依赖特定的 ERP 供应商或 API 路径，但兼容性取决于站点界面和身份验证。
注意事项：
- Linux x64 桌面需要图形会话和 Chromium 系统库。
- 用户知识、浏览器登录数据、测试数据不包含在 npm 发布中。
- 不提供无人值守的事务引擎或多 ERP 自动路由。
- 导入不会复制登录凭据或原始证据，仅复制知识/引用。

结尾¶

guomonth/dsh-erp 解决了 DSH 在处理复杂企业系统时的知识缺失问题。它将浏览器交互转化为本地可复用的知识资产，适合需要私有化、本地化知识管理的场景。更多信息请查看 GitHub 或 SkillHub 目录。