SiriusNEO/d.sh

Minimal agent harness in one Bash file. One-line quick start. Bootloader agent for bare-metal servers.

Project Overview项目介绍

d.sh is a minimal coding agent for DeepSeek-compatible APIs distributed as a single Bash script. It only requires Bash 4.3 or newer and curl to run, making it lightweight enough for minimal servers without a full dependency stack. You can run it directly with a one-line curl command, save a configured copy for repeated local use, or add an alias to your bashrc to run it from anywhere any time. It acts as a bootloader agent that can bootstrap more capable agents like DeepSeek Harness, Codex, or Claude Code, and aligns with DeepSeek Harness’s sdk-minimal two-tool profile.

When you run d.sh for the first time, it launches an interactive setup that prompts you for your DeepSeek API key, base API URL, and model name. Default values are pre-filled for the base URL and model name, so you only need to enter your API key to get started. After setup, it saves your configuration directly to the script file with permissions set to 600 to protect your API key, so you do not need to re-enter it on future runs. Conversation history is saved to a local session.jsonl file that is automatically resumed on your next run.

d.sh ships with two built-in tools: a persistent Bash shell with a 300-second timeout, and a str_replace_editor for viewing, creating, modifying, and inserting text files. It runs commands with your current user permissions and does not use a sandbox, so you should only run it with prompts you trust. Never commit or share a configured copy of d.sh that includes your API key, and do not add session files containing your full conversation history to version control. It uses the OpenAI-compatible Chat Completions wire protocol that matches DeepSeek’s official API specifications.

这是一个适配DeepSeek兼容API的极简编码代理,整个程序仅为一个Bash脚本文件,只依赖Bash 4.3+和curl两个环境组件。它可以在缺少完整依赖栈的极简服务器上,引导功能更完善的代理(包括DeepSeek Harness、Codex、Claude Code),也可用于简单的环境配置,充当引导代理角色。

它支持三种使用方式,可单次远程运行无需保存、下载配置后本地使用,也可配置别名后随时随地调用。它会在首次运行时引导用户交互配置API密钥、API地址和模型名称,配置信息会自动保存到脚本文件,后续运行无需重复配置,对话历史会自动保存在本地会话文件。

它对齐DeepSeek Harness的sdk-minimal双工具配置,自带持久化Bash shell和文本编辑工具,无沙箱隔离,以你的权限运行命令。API密钥保存在本地脚本,权限设为600,不要提交或分享配置后的脚本,会话文件也不要加入版本控制。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • 18 stars - an early-stage project星标 18,属于早期项目
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
  • Not DSH-native: a multi-platform tool that may require Node / Electron or another runtime first非 DSH 原生,是多平台兼容工具:可能要先装 Node / Electron 等运行时
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:SiriusNEO/d.sh

把 SiriusNEO/d.sh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

d.sh

English | 简体中文

A minimal coding agent for DeepSeek-compatible APIs, all in one Bash file: d.sh. It requires only Bash 4.3+ and curl. On minimal servers without a full dependency stack, it can bootstrap a more capable harness (Codex, Claude Code, DeepSeek Harness) or handle simple environment setup — serving as a bootloader agent.

Quick Start

Option 1: Run once with a one-line command (no script or configuration saved)

DEEPSEEK_API_KEY='your-api-key' bash <(curl -fsSL https://raw.githubusercontent.com/SiriusNEO/d.sh/main/d.sh)

Option 2: Save a configured copy and keep using it

curl -fsSL https://raw.githubusercontent.com/SiriusNEO/d.sh/main/d.sh -o d.sh
bash d.sh

The first command downloads the script as d.sh in the current directory; any existing copy is overwritten. The second runs it and starts an interactive setup for BASE_URL, MODEL_NAME, and DEEPSEEK_API_KEY, then drops you into the interactive prompt. The chosen values are written back into d.sh with mode 600, so later runs only need bash d.sh.

Option 3: Configure once, then start a session-less agent from anywhere

curl -fsSL https://raw.githubusercontent.com/SiriusNEO/d.sh/main/d.sh -o ~/d.sh
cd ~ && bash d.sh   # complete the interactive setup, then /exit
printf "alias d='DSH_SESSION_FILE= bash ~/d.sh'\n" >> ~/.bashrc
source ~/.bashrc

Then use the command d to run the agent ANYWHERE ANYTIME you need.

Configuration

The three connection settings are:

Variable Purpose
DEEPSEEK_API_KEY API key; required
BASE_URL DeepSeek-compatible API endpoint
MODEL_NAME Model sent with each request

BASE_URL defaults to https://api.deepseek.com and MODEL_NAME to deepseek-v4-flash. DEEPSEEK_API_KEY is always required. During interactive setup, press Enter to keep the displayed default; API-key input is hidden. When setup runs from a saved copy, the selected values are written back to d.sh and the file mode is changed to 600.

Other harness settings (DSH_*) are documented in the configuration block at the top of d.sh. Environment variables override values stored in the script and become the defaults shown during interactive setup.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-short-video-studio 下一个 Next dsh-chatgpt-bridge →