dsh-dify-builder
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 7 GitHub stars
Code Basarisiz
- process.env — Environment variable access in configure-model.mjs
- exec() — Shell command execution in installer/lib/env-file.js
- process.env — Environment variable access in installer/lib/paths.js
- process.env — Environment variable access in installer/lib/process.js
- Hardcoded secret — Potential hardcoded credential in installer/test/dify.test.js
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Build local Dify workflows through real-time conversation in DeepSeek Harness
dsh-dify-builder
在 DeepSeek Harness 中通过对话实时构建本地 Dify 工作流。右侧直接显示 Dify 画布,节点和连线原地更新,不反复刷新页面。
效果演示
左侧通过对话描述需求,右侧 Dify 画布会同步创建和修改节点。点击上方动画可播放完整演示视频(约 1 分 51 秒,默认静音,可在播放器中开启声音)。
安装前检查
1. Node.js 20+
检查:
node --version
npx --version
如果命令不存在,先从 Node.js 官网 安装 LTS 版本,再重新打开终端。版本低于 20 时也需要先升级。
2. DeepSeek Harness
检查:
dsh --version
如果命令不存在,执行:
npm install -g @deepseek-ai/dsh@latest
dsh --version
首次使用可运行 dsh web,浏览器会打开 DSH。进入「设置 → 模型」配置 DeepSeek 模型和 API Key,并先确认 DSH 可以正常对话。安装器会在本机私有凭据中读取该 Key,用于配置 Dify 官方 DeepSeek provider;不会写入仓库或打印到日志。未配置时安装会停止并给出引导。更多信息见 DeepSeek Harness 官方项目。
3. Docker
检查:
docker --version
如果命令不存在,请先安装 Docker Desktop。macOS 上安装后无需提前启动,安装器会自动打开并等待 Docker 就绪;Linux 需要确保 Docker Engine 可以正常运行。
快速安装
无需克隆仓库,直接从 GitHub Release 安装:
npx --yes "https://github.com/newbieYi/dsh-dify-builder/archive/refs/tags/v0.2.2.tar.gz" install
该命令固定使用经过验证的 v0.2.2,只需要 npx,不要求本机安装 Git。项目源码、版本记录和问题反馈位于 newbieYi/dsh-dify-builder。
看到“安装完成”后,重新打开 DSH Web,新建会话并选择「Dify 工作流构建」。不需要手动下载 Dify、编写 Docker 配置、安装 Sidebar 或创建管理员账号。
安装器会在下载 Dify 前检查 DSH CLI 和 Docker。前置条件不满足时会停止并显示对应安装命令,不会执行到一半才提示。
安装器会做什么
安装器自动完成并逐项验收:
- 检查 DSH CLI 和 Docker;macOS 上 Docker 未启动时自动打开 Docker Desktop。
- 下载经过验证的固定版本 Dify。
- 配置 iframe 和 Dify 原生协作通道。
- 启动并检查 Dify 容器,初始化本地管理员。
- 安装 Dify 官方 DeepSeek 模型插件,复用 DSH 的私有 API Key 并自动选择可用模型。
- 安装 DSH runtime、内置 Sidebar、右侧 panel 和 Agent preset。
- 检查插件冲突、默认模型、Dify setup 和实时协作端点;任何一项失败都会明确报错并终止。
首次安装会使用 [email protected],密码随机生成并仅保存在本机私有配置中。重复执行安装命令是安全的,不会重建管理员或更换已有 Dify 密钥。
日常使用
- 在空白新会话中选择「Dify 工作流构建」。
- 如果 Docker 或 Dify 没有运行,插件会自动检查并拉起。
- 在左侧描述要创建或修改的工作流,右侧 Dify 画布会实时更新。
- 空白会话切换到其他模式时,Dify 标签和右侧栏会自动关闭。
遇到问题
运行只读诊断:
npx --yes "https://github.com/newbieYi/dsh-dify-builder/archive/refs/tags/v0.2.2.tar.gz" doctor
诊断会检查 DSH CLI、Docker、三个插件、Sidebar 冲突、Dify 默认模型、setup 和 Socket.IO 协作通道,不会修改配置或重启服务。
常见情况:
| 现象 | 处理方式 |
|---|---|
| 提示找不到 Docker | 先安装 Docker Desktop,再重新执行安装命令 |
| 安装完成但看不到新模式 | 重新启动 DSH Web 后再新建会话 |
| 提示找不到 DeepSeek API Key | 打开 DSH Web,在「设置 → 模型」配置 DeepSeek 后重新安装 |
| 大模型节点不可选 | 重新运行 install,安装器会补齐 Dify DeepSeek provider 和默认模型 |
| 已有 Dify,管理员登录验证失败 | 使用下方高级参数提供现有账号和密码 |
| 安装在管理员初始化后中断 | 直接再次执行安装命令,安装器会恢复默认管理员凭据并继续 |
使用已有账号或指定访问地址:
npx --yes "https://github.com/newbieYi/dsh-dify-builder/archive/refs/tags/v0.2.2.tar.gz" install \
--email [email protected] \
--password 'YourStrongPassword123!' \
--name Owner \
--base-url http://127.0.0.1:8080
默认数据目录:
| 内容 | 默认位置 |
|---|---|
| Dify 源码和数据入口 | ~/.dsh/dify-builder/dify |
| 私有配置 | ~/.dsh/dify-builder/config.json |
| 打包后的 DSH 插件 | ~/.dsh/dify-builder/packages |
| Agent preset | ~/.dsh/.agent-presets/dify-builder |
可用 DSH_HOME 修改 DSH 根目录,用 DSH_DIFY_HOME 单独修改 Dify 部署目录。
仅项目开发者需要使用:
node ./bin/dsh-dify-builder.js install
npm test
普通用户不需要进入 packages/,也不需要单独安装或阅读 Sidebar 子项目。
技术说明
- Dify 固定在经过验证的上游 commit;本项目不修改 Dify 源码。
- 草稿保存使用 Dify 原生 collaboration 模式和 Socket.IO
workflow_update。 - 创建应用后右侧只导航一次,普通节点修改不会刷新 iframe。
dsh-dify-sidebar随安装器发行,安装时会移除冲突的原版 Sidebar。- 私密账号和密码只写入权限为 owner-only 的本地配置,不进入 preset 或公开仓库。
平台与许可
当前完成 macOS 和 Linux 支持;Windows 尚未完成端到端验证。
主项目使用 MIT License。packages/dsh-dify-sidebar 派生自 MIT 许可的 DSH-better-sidebar,原始 LICENSE 已保留,归属信息见 NOTICE。
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi
