Git 账号授权thirsty5034/dsh-git-forge

dsh-git-forge

DeepSeek Harness 社区插件：在 dsh-better-sidebar 中提供 Forge 账号库 + 按项目授权 + push 策略。

- 账号库：GitHub / Gitea / GitLab / Gitee / Bitbucket
- 按项目授权（projectPathKey = 工作区 cwd）
- push 拦截：已授权项目下，bash 的 git push / git remote add|set-url 指向未授权 host 会被拒绝
- Token 存 $DSH_HOME/git-forge/secrets.json（0600），不进模型上下文
- 模型工具 GitForge（只读策略）
- Agent HTTPS git：侧栏授权后，agent bash 中的 git fetch/push 等可通过 Host credential helper 使用对应账号（token 永不进模型；同 host 多 token 账号时需只保留一个授权 = R1）
- UI 对齐 dsh-ssh-tunnel

SSH 远程与系统 gh auth 仍走本机 SSH/gh。HTTPS 在 DSH agent shell 下由本插件 helper 按项目授权注入；插件同时负责「这个项目允许推到哪」（push guard）。

环境要求

- 已安装 dsh-better-sidebar（≥ 0.12）的 web profile
- Node.js 18+

安装

macOS / Linux（Windows 可用 Git Bash / WSL）：

curl -fsSL https://raw.githubusercontent.com/thirsty5034/dsh-git-forge/main/scripts/install.sh | bash

Windows（PowerShell 5.1+ / pwsh）：

irm https://raw.githubusercontent.com/thirsty5034/dsh-git-forge/main/scripts/install.ps1 | iex

或直接用 DSH CLI（在发布到 npm 之前默认走 GitHub 源）：

export DSH_HOME=${DSH_HOME:-$HOME/.dsh}
dsh plugin --profile web add "dsh-git-forge@github:thirsty5034/dsh-git-forge"
dsh --profile web --dump-config | grep git-forge

装完后：重启 dsh web，浏览器 硬刷新（Cmd/Ctrl+Shift+R）。

可选参数 / 本地 link / 日后 npm

curl -fsSL .../install.sh | bash -s main --restart
bash scripts/install.sh --from npm 0.1.1

dsh plugin --profile web add "dsh-git-forge@link:/path/to/dsh-git-forge"

可发现性

- GitHub topics：dsh-plugin、deepseek-harness、dsh（dsh.so 自动收录所需）
- 当前请从 GitHub 安装：见上文 安装
- 商店目录可能滞后于爬虫；以本仓库为准

数据目录

$DSH_HOME/git-forge/（建议 0700）：

| 文件 | 用途 |
|------|------|
| accounts.json | 账号元数据（无 token） |
| secrets.json | token（0600） |
| grants.json | projectPathKey → accountIds[] + enforce / unbound 策略 |

侧栏

1. 项目授权 — 当前项目可用账号 + 是否 enforce push
2. 账号库 — 增删改、探测 API token
3. 策略状态 — 当前允许的 gitHost；全局「未绑定项目」策略

模型工具

GitForge action=list_accounts
GitForge action=get_policy
GitForge action=list_project_accounts
GitForge action=check_remote url=git@github.com:org/repo.git

Agent HTTPS 与项目路径

- 授权 key = DSH 会话工作区（shell 注入 DSH_GIT_FORGE_PROJECT），不是子仓路径
- helper：env → cwd 精确匹配 → /workspace 下向父目录 walk
- R1：同 host 仅当恰好 1 个已授权 token 账号时自动注入
- push guard：命令中的 URL 以及 裸 git push/git push origin（解析 remote）

安全

- API / 工具结果不得包含 token
- push 策略在 Host tools.guard 中硬拦截
- Agent HTTPS：credential helper 仅在 Host 内读 secrets.json；同 host 多 token 账号时不自动选号（R1）
- 未给项目配置任何授权时，push guard 默认 不拦截（便于渐进启用）；helper 也不会凭空给凭据

开发

npm test
npm run check
./scripts/sync-to-dsh.sh

许可证

MIT — 见 LICENSE。