dsh-web-search-ddg
aooyoo
Zero-token DuckDuckGo search provider for the DeepSeek Harness (DSH) web seam — local headless browser, no API key, no m…
PROJECT TOPICS
PROJECT README

在 DSH 的会话界面(chat / Trajectory 之后)新增一个 Git tab,展示当前
项目路径的 Git 信息:仓库概况、文件修改状态、提交历史、分支与提交图、
贡献日历(最近一年每日提交热力图),以及暂存/提交/推送/拉取/切换分支等
操作;非 Git 目录则显示文件列表并支持一键 git init。此外还内置「快速打开」
栏:在 macOS 上于宿主机终端(Terminal / iTerm)中打开仓库,或启动交互式
代理 app(OpenCode / Claude / Codex / Antigravity)。
git 命令执行全部委托给 gmc
(gmc/lib/git.js 的 runGit),本插件只做解析、组合与展示。
@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 概况卡片(分支、热力图、快捷启动、一键跳转完整管理页) |
本地开发(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。
| 端点 | 说明 |
|---|---|
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 项)
/var 是 /private/var 的符号
链接,git 返回真实路径,属正常现象。--dump-config 里应
有 dsh-git 行。CLASSIFICATION EVIDENCE
系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。