安装到 DSH web profile；开发期也可以使用 link:/path/to/dsh-plugin-git-log

cd ~/.dsh/profiles/web dsh plugin --profile web add "link:/path/to/dsh-plugin-git-log"

在 `~/.dsh/profiles/web/cordis.patch.yml` 加入 loader entry：

```yaml
- insert:
    - id: dsh-git-log
      name: dsh-git-log
      config:
        repoPath: /path/to/your/repo   # 缺省用 host 进程 cwd；也可用环境变量 DSH_GIT_LOG_REPO
        gitPath: git                    # 可选 Git executable 路径；默认从 PATH 使用 git
        discoverRepositories: true      # 默认开启；运行时扫描新增/删除的 nested 与 bare repositories
        repositoryDiscoveryDepth: 2     # 0–8
        repositoryExcludes:             # Git 风格 * / ** / ? 路径规则
          - "**/node_modules/**"
          - "**/.worktrees/**"
        repoPaths:                      # 可选的额外仓库白名单
          - /path/to/another/repo
        currentLineBlame:
          enabled: true                 # 默认开启
        initialPageSize: 200            # 20–2000
        pageSize: 500                   # 20–5000
        maxCachedCommits: 5000          # 200–50000
        maxDiffFileBytes: 5242880       # 1024–104857600，默认 5 MB

保存后热加载（若 watcher 未生效则重启一次 dsh web），刷新页面并打开任意会话，点击会话页头中 对话 / 轨迹 右侧的 Git Log 标签。

注意：修改 package.json 的 name/exports 后，host 对包元数据有按名负缓存，需换名或重启 host 才会重新识别。

开发

pnpm install
pnpm run build     # 产出 lib/index.js + lib/client.js + lib/syntax-worker.js
pnpm test
pnpm run test:browser  # 自建临时 Git/DSH fixture，验证当前构建产物

Client Plugin 只有在 DSH checkout 同时运行 pnpm run dev:web 重建 Bundle 时才能由 HMR 自动替换；其他 Web Shell / Host 改动需重新构建相应产物，并刷新现有 DSH GUI 或重载 Plugin Entry。

上游对齐状态

已验证能力、DSH 原生替代方案和最终独立审计结果记录在 docs/upstream-parity.md。当前审计未发现实质性上游对齐阻塞项。