@dsh-external/dsh-github-push
一个 DSH 超级模组（toolkit 形态）：一句话上传项目到 GitHub。
只要给出仓库 URL，它会自动处理 README、git init、add/commit、remote、push，一步到位。
解决什么问题
以前上传项目到 GitHub 需要手动：
- 建仓库
git init- 写 README
git add .git commitgit remote addgit push
这个插件把上面全部封装成一个工具：
dev_github_push
核心功能
- ✅ 自动识别/初始化 git 仓库
- ✅ 自动
git add -A 并提交
- ✅ 自动设置/更新 GitHub remote
- ✅ 自动推送到
main 分支
- ✅ 可选通过
gh CLI 自动创建不存在的仓库
- ✅ 自动处理 README：
- 没有 README → 自动生成一份较详细的 README
- README 已有内容 → 只自动补齐缺失的常用章节，不重写
- 可用
readmeMode=keep 跳过，或 readmeMode=rewrite 强制重写
- 如果是 DSH 插件，会自动加入 DSH CLI 安装/卸载命令
- ✅ 自动设置 GitHub About topics：
- 根据项目元数据自动推断 topic（如
dsh、dsh-plugin、deepseek-harness、项目名等）
- 支持通过
topics 参数追加自定义 topic
- 优先用
gh repo edit，没有 gh 时用 GitHub REST API（需要 GITHUB_TOKEN / GH_TOKEN）
- ✅ 安全演练：支持
dryRun，只打印计划，不实际改动任何文件/仓库
工具说明
dev_github_push
| 参数 | 类型 | 必填 | 说明 |
|---|
url | string | 是 | GitHub 仓库 URL |
dir | string | 否 | 要上传的项目目录，默认当前工作目录 |
message | string | 否 | 提交信息，默认 Update project |
branch | string | 否 | 分支，默认 main |
visibility | string | 否 | 新建仓库可见性：public / private，默认 public |
readmeMode | string | 否 | README 处理：auto / keep / rewrite，默认 auto |
topics | string | 否 | 额外 GitHub topics，逗号分隔，例如 dsh,plugin,automation |
dryRun | boolean | 否 | 只打印将要执行的操作，不实际改动 |
skipTopics | boolean | 否 | 跳过自动设置 GitHub About topics |
使用示例
{
"name": "dev_github_push",
"arguments": {
"url": "https://github.com/Funnyvalentine00/my-project",
"dir": "E:/my-project"
}
}
或直接对 AI 说：
“上传 E:/my-project 到 https://github.com/Funnyvalentine00/my-project，private”
测试
npm test
覆盖：URL 规范化、topic 推导、DSH CLI 安装/卸载命令、README 生成。
README 自动生成规则
- 读取项目
package.json 的 name / description / scripts / license
- 扫描项目文件树（自动忽略
node_modules、.git 等）
- 生成或补齐以下章节：
- 项目名 + 简介
- 项目结构
- 安装
- 使用
- License
- 如果是 DSH 插件：DSH 安装 / 卸载（
dsh plugin --profile web add <包名> / dsh plugin --profile web remove <包名>）
Topics 自动推断规则
自动收集以下来源（去重、最多 20 个）：
package.json 的 keywords- 如果是 DSH 插件：
dsh、dsh-plugin、deepseek-harness
- 项目目录名
- 调用时传入的
topics 参数（逗号分隔）
设置方式：
- 优先使用
gh repo edit <repo> --add-topic <topic>
- 如果没有
gh，则使用 GitHub REST API：
PUT /repos/{owner}/{repo}/topics
需要环境变量 GITHUB_TOKEN 或 GH_TOKEN
安装
方式 A：DSH CLI 安装 / 卸载
安装：
dsh plugin --profile web add @dsh-external/dsh-github-push
卸载：
dsh plugin --profile web remove @dsh-external/dsh-github-push
方式 B：直接注入（当前环境）
# 在 DSH 内对 AI 说：
dev_inject_plugin {"dir": "E:/dsh插件/router/dsh-github-push"}
方式 C：从源码构建
DSH_CHECKOUT=<checkout> bash scripts/build.sh
dev_inject_plugin {"dir": "<本目录>"}
依赖
@deepseek-ai/dsh-toolscordisschemastery
注意
- 如果仓库不存在且本机没有
gh CLI，工具会提示你先在 GitHub 手动建仓库。
- 自动生成的 README 是基于项目元数据的模板；需要更“智能”的文案时，可以让 AI 在推送前再人工/LLM 完善。
- 已存在的 README 不会被覆盖，只会补齐缺失章节；除非你显式指定
readmeMode=rewrite。
- 自动设置 topics 需要
gh CLI 已登录，或设置 GITHUB_TOKEN / GH_TOKEN；否则会跳过并提示。
License
MIT
