GuoMonth/dsh-erp

Adapt ERP · dsh-erp

English · npm · 版本发布 · 更新记录

通过浏览器学习你的 ERP，将知识保存在自己的电脑上。 Adapt ERP 是 DeepSeek Harness（DSH）的插件。配置自己的 ERP、自己登录，然后让 DSH 观察菜单、页面、字段和业务数据，建立有证据的知识，并在后续对话中复用、核验和补充。

插件从没有站点知识的状态开始，不要求特定 ERP 厂商、API 路径或登录令牌格式。实际兼容性取决于网站界面和认证流程；本预览版不承诺已经成功操作所有 ERP。

当前交互规则：确认登录身份后，页面观察与本地知识积累自动进行；每次点击、填写、选择或滚动都单独请求确认，包括查询，因为陌生控件可能自动保存。这是带确认的 AI 学习流程，尚不是无人值守爬取或业务事务引擎。

安装

| 要求 | 当前基线 |
| --- | --- |
| Node.js | >=24.18.0 ，查看库存和相关订单，记录步骤与不确定性。”
- “继续未完成的探索，复核变化的字段，并导出 Markdown 和 JSON。”

第二个例子是模型规划的界面任务，不是内置的商品/订单 API，也不保证完成库存对账。

知识属于用户本机

每个系统在数据根目录下对应 systems//，保存 SQLite、证据、导出和私有浏览器资料。erp_system_status 返回准确范围和位置。保持配置与目录不变，新对话无需登录即可查询已有知识；实时数据需要当前登录，过去的余额或订单仍是历史观察。

npm 发布不包含用户知识、浏览器登录资料、测试站点或验收答案。 安装包只提供学习工具、通用结构和用户指南。SCM/USA 已回到开发测试基准中。分享知识是用户主动导出的独立动作，不属于插件发布。Markdown/JSON 是可读视图，SQLite 保留修订及证据关联。

DSH 使用的观察可能发送给所配置的模型供应商。快照排除密码、隐藏、文件输入、明显凭据字段及 data-erp-private 区域，但脱敏不能保证发现所有敏感内容；表格与普通字段可能包含业务数据。交互工具不接受账号密码管理任务。

控制与限制

- 每次页面交互单独请求 DSH 确认，包括写入按钮和自动保存输入框；拒绝后不发送交互。观察许可不授予操作权限。
- 操作绑定短期快照引用，不接受模型提供的选择器、JavaScript 或请求 URL。目标变化、导航、过期版本和重复引用均拒绝。动作失败可能已经影响网站，应先检查结果再决定下一步。
- 观察许可最多 10 分钟，人工输入/导航会暂停。动作确认包括读取结果并开启新的有时限观察窗口；重启后重新检查登录和授权。
- 每实例一个配置系统、一个浏览器页面。支持应用内 iframe；跨域 iframe、Canvas、封闭 Shadow DOM、多窗口登录及扫码/SSO 可能需要人工处理，尚未广泛验收。原生浏览器对话框由人处理。
- 快照是有界、非事务性采样。不提供多步骤业务事务、自动重试、无人值守写入或多个 ERP 自动选库。

升级与卸载

升级前调用 erp_storage_backup，退出 DSH，重复安装命令后重启。保持相同的数据根目录和配置。

从 alpha.5 升级：系统 ID 与知识保留。移除 erp_scm_* 和 SCM 菜单导入工具，改用通用浏览器学习流程。已有 SCM 记录是历史证据，不是另一套 ERP 的已验证方法；复用步骤前重新观察页面。

从 alpha.4 或更早升级：配置 system 会使用独立存储，旧根目录知识保留但不自动导入。退出 DSH 后临时移除 system，可按原 scope 查询、导出或备份旧库，该模式禁用浏览器连接。详见存储恢复。alpha.1/alpha.2 TGZ 用户需先移除旧无 scope 插件入口，只启用新包。

退出 DSH 后卸载：

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

卸载保留数据。同一库只允许一个进程持有，不支持多个独立 DSH 进程同时共享。

开发与验证

npm ci --ignore-scripts
npx playwright install chromium --no-shell
npm run verify
npm pack

构建先清理 dist，避免已删除适配器残留进发布包。完整测试在本地执行；手动 Release Action 构建、Trusted Publishing 发布并核验 npm/GitHub 字节。

通用流程通过不同合成 ERP 界面、空知识库、真实 Chromium/IPC 和原生 DSH 确认进行测试。确定性的测试决策不等于真实模型兼容性基准；历史 SCM 实测单独保留，不能据此声称新流程已验证所有 ERP。详见学习流程与边界和开发文档。

MIT。依赖保留各自许可，见第三方声明。browser-use 与 browser-harness 是前期参考，目前浏览器运行时使用 Playwright。