dsh-git-push

dsh plugin --profile web add dsh-git-push

dsh-git-push

DSH 的 git 提交推送与代码审计插件：提交前自动过审计门禁，提交、推送、发包一条命令完成。

功能

功能 · 做什么 · 入口

提交推送 · 审计通过后提交并推送，支持 dry-run / force / 指定 remote · git_commit_push / commit

仓库扫描 · 列出仓库的未提交、未推送、分叉与近期活动 · git_scan / scan

代码审计 · 静态检查 + 质量评分，diff 或全量两种范围 · code_audit / audit / /git-audit

历史提交审计 · 逐提交回放审计并落盘报告 · code_audit --history / audit --history

克隆仓库 · 按 owner/repo 克隆到指定目录 · git_clone / clone

克隆预演 · 只看将拉取什么，不落盘 · git_clone_preview / clone-preview

建远端仓 · 给本地仓库建远端并设置 origin · git_remote_create / remote-create

可见性 · 切换仓库 public / private · git_set_visibility / set-visibility

改名 · 给远程仓库改名（dryRun 默认开，列出旧名出现位置） · git_remote_rename / rename

凭据与账号 · 校验 GitHub token 与 SSH 公钥、生成密钥对 · git_account_check / git_gen_ssh_key

身份改写 · 把历史提交身份统一成登录账号 · git_identity_rewrite / identity-rewrite

发布 · 发布 npm 包（dryRun 默认只体检；凭据由插件托管，无需 npm login） · npm_publish / npm-publish

撤包 · 从 registry 撤版本（默认 dryRun 预检，不可逆） · npm_unpublish / unpublish

豁免标记 · 给文件加/删豁免注释并校验是否真生效 · exempt

I/O 风险扫描 · 扫描读写操作的风险分级 · io_scan / file-io

链接检查 · 检查文档里的 URL 是否有效 · link_check / link-check

拼接产物作用域 · 查分片拼成单文件后同一作用域内的重名（后者静默顶掉前者） · scope_check / scope-check

巨型文件拆分 · 按顶层块拆分单文件并校验导出一致 · module_splitter / module-splitter

git 透传 · 执行任意 git 命令，凭据自动注入 · git_sluice / git

HTTP 接口直调 · 调用本插件的全部 HTTP 接口 · git_api / api

审计结果查询 · 按规则/文件/严重级/规则包聚合审计结果 · GET /api/git-push/audit

环境要求

宿主 · 运行时 · 平台

DSH >=0.1.6-0 <0.3.0-0 · Node >= 18.0.0 · 无限制

用法

侧边栏面板

• 账号信息：GitHub 与 npm 账号状态、凭据与 SSH 公钥
• 审计面板：规则包启停、排序、命中数
• 设置：审计开关、扫描范围、评分权重、自动推送开关

聊天框指令

/git-audit                 # 审计当前仓库（默认 diff 范围）
/git-audit --full          # 全量审计
/link-check                # 检查文档里的链接

AI 工具

git_scan({ root })                                  // root 可空：空=自动识别家目录
code_audit({ repo, scope, includeFindings })         // repo 必填；scope 可空（空=full）；includeFindings 可空（空=精简输出）
git_commit_push({ message, repo, push, dryRun })     // message 必填；repo 可空（空=当前目录）；push 可空（空=推送）；dryRun 可空（空=真提交）
git_clone({ target, dest, branch, history })         // target 必填（owner/repo 或完整 URL）；dest 可空（空=工作区根）；history 可空（空=整树快照）
git_clone_preview({ target, branch })                // target 必填；branch 可空（空=默认分支）
git_api({ path, method, query, body })               // path 可空（空=列出全部接口）；method 可空（空=GET）
git_sluice({ args })                                 // args 必填：与 git 一致的参数串
git_account_check({ token, sshPub })                 // 两者都可空：不传则自动解析本机凭据
git_gen_ssh_key({ email, force })                    // email 必填；force 可空（空=已存在时不覆盖）
git_identity_rewrite({ paths, dryRun, write, push }) // 全可空：dryRun 默认只报告，write 才改写
git_remote_create({ repo, visibility, dryRun })      // repo 必填；visibility 可空（空=private）
git_set_visibility({ repo, visibility })             // 两者必填
npm_publish({ dir, dryRun, confirm, tag, otp })      // dryRun 默认 true（只体检）；真发需 confirm=true 且 dryRun=false
exempt({ action, rule, path, scope, line, reason })  // action 与 rule 必填；path 可数组；scope=header（文件头）或 line
io_scan({ repo, writeOnly })                         // 两者都可空：writeOnly 空=读写都看
link_check({ path })                                 // path 可空：空=整个工作区
scope_check({ files, repo, prefix, allowlist, topLevelMustBeEmpty })  // 全可空：files 空=读项目 dshScopeCheck.files；prefix 空=按项目契约
module_splitter({ command, file, plan, dryRun })     // command 必填（analyze/split/verify）；dryRun 可空

独立 CLI（git-sluice）

git-sluice account-check              # 校验本机 GitHub 凭据
git-sluice scan <目录>                 # 列出该目录下的 git 仓库
git-sluice audit <仓库> --full         # 全量审计（加 --json 拿明细）
git-sluice commit <仓库> -m "msg"      # 提交并推送（自动过审计门禁）
git-sluice scope-check [文件]           # 查拼接产物同帧重名（无参数时读项目 dshScopeCheck.files）
git-sluice help                        # 全部命令

API

38 个端点，统一前缀 /api/git-push/。常用：

端点 · 做什么

GET /api/git-push/status · 插件状态与配置概览

GET /api/git-push/scan · 仓库扫描结果

GET /api/git-push/audit · 审计结果（支持 scope / groupBy / severity / top）

GET /api/git-push/repos · 本地仓库列表

GET /api/git-push/account-status · 账号状态快照

POST /api/git-push/credentials · 写入凭据

GET /api/git-push/tools · 工具清单

# 审计一个仓库（按规则聚合）
curl "http://<本机IP>:<端口>/api/git-push/audit?repo=<仓库绝对路径>&scope=diff&groupBy=rule"

# 列出全部可用接口
curl "http://<本机IP>:<端口>/api/git-push/api"

文档索引

• [docs/SPEC.md](docs/SPEC.md) — 规格唯一入口（工具、接口、设置键、数据文件、规则体系）
• [docs/FILE-TREE.md](docs/FILE-TREE.md) — 目录结构（自动生成）
• [docs/CHANGELOG.md](docs/CHANGELOG.md) — 版本列表（自动生成）
• [docs/FUNCTIONS.md](docs/FUNCTIONS.md) — 函数列表（自动生成）