返回目录
其他 待识别

dsh-git

taontech/dsh-git

该仓库暂未提供项目说明。

Stars
0
Forks
0
Issues
0
更新
2 天前

PROJECT TOPICS

项目标签

PROJECT README

README

@taontech/dsh-git —— DeepSeek Harness 的 Git tab 插件

screen

在 DSH 的会话界面(chat / Trajectory 之后)新增一个 Git tab,展示当前 项目路径的 Git 信息:仓库概况、文件修改状态、提交历史、分支与提交图、 贡献日历(最近一年每日提交热力图),以及暂存/提交/推送/拉取/切换分支等 操作;非 Git 目录则显示文件列表并支持一键 git init。此外还内置「快速打开」 栏:在 macOS 上于宿主机终端(Terminal / iTerm)中打开仓库,或启动交互式 代理 app(OpenCode / Claude / Codex / Antigravity)。

git 命令执行全部委托给 gmcgmc/lib/git.jsrunGit),本插件只做解析、组合与展示。

架构(一个包,双面)

@taontech/dsh-git (npm 包)
├── cordis.patch.yml    # bundle patch:插入 server 插件行(id: dsh-git)
├── lib/index.js        # server 插件:注册 webServer 路由 /dsh-git/*(JSON API)
├── lib/git-data.js     # 数据层:gmc 封装 + status/log/branch/init/贡献日历 解析
├── lib/launch.js       # macOS 终端 / iTerm + 代理 app 启动器(移植自 gmc web.js)
└── lib/client.js       # client bundle:注册 conversation.view 的 Git tab
                        #   (含贡献日历 + 快速打开按钮;手写 ModuleLoader 格式)
机制 职责
Server(bundle) dsh.bundle.patch + inject: ["webServer"] /dsh-git/info|status|log|branches|contributions|init|open-terminal|open-agent
Client dsh.client 声明 + ./client 入口 1. ctx.slots.inject("conversation.view") 注册 id: "git" 完整管理标签页
2. ctx.slots.inject("conversation.input.dock") 注册空白会话首页 Hero 概况卡片(分支、热力图、快捷启动、一键跳转完整管理页)

安装(装进某个 profile)

本地开发(link:):

dsh plugin --profile <name> add /path/to/this/package

发布后(registry):

dsh plugin --profile <name> add @taontech/dsh-git
dsh --profile <name> --dump-config   # 确认 dsh-git 行与 bundles 生效

两种方式 pnpm 都会自动安装 gmc 依赖。web profile 的 client-modules 会自动 扫描 dsh.client 声明,把 lib/client.js 注入浏览器 boot graph —— 装完 重启该 profile 的 GUI 即可看到 Git tab。

API(同源 JSON,浏览器直接 fetch)

端点 说明
GET /dsh-git/info?cwd= 仓库概况:root / branch / remote / ahead-behind / lastCommit / isDirty
GET /dsh-git/status?cwd= 文件 + 修改标记(porcelain);非 repo 时返回 fs 文件列表
GET /dsh-git/log?cwd= 提交历史(hash / 作者 / 日期 / subject)
GET /dsh-git/branches?cwd= 分支列表 + git log --graph ASCII 提交图
GET /dsh-git/contributions?cwd= 贡献日历:最近一年每日提交次数(date -> count
POST /dsh-git/init {cwd} git init(非 repo 目录的初始化按钮)
POST /dsh-git/open-terminal {cwd} 在宿主机 Terminal / iTerm 中打开仓库(仅 macOS + 回环地址)
POST /dsh-git/open-agent {cwd, agent} 在终端启动交互式代理(codex / claude / antigravity / opencode,仅 macOS + 回环地址)
POST /dsh-git/stage {cwd, paths} 暂存文件(路径必须来自当前 status,防止任意参数)
POST /dsh-git/unstage {cwd, paths} 取消暂存(只允许已暂存文件)
POST /dsh-git/commit {cwd, message} 提交已暂存内容(消息非空校验)
POST /dsh-git/push {cwd} git push
POST /dsh-git/pull {cwd} git pull
POST /dsh-git/checkout {cwd, branch} git switch(分支必须存在于分支列表)

验证

node test/verify-server.mjs   # 数据层单测(repo / 非 repo / init / git 操作场景,31 项)

常见问题

  • 路径显示为 /private/var/...:macOS 上 /var/private/var 的符号 链接,git 返回真实路径,属正常现象。
  • 看不到 tab:确认装进了 web profile 且重启了 GUI;--dump-config 里应 有 dsh-git 行。

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别
功能分类其他
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: 无有效分类标签。