Git History Viewer

一个免费、本地优先、只读的 Git 历史图谱，适用于浏览器、CLI 和 MCP 客户端。

公开 Alpha 版本。在受管环境中请固定精确版本。

安装

需要 Node.js 22 或更高版本，以及 Git 2.40 或更高版本。

npm install --global @peekaboo-develop/git-history-viewer@alpha

Related MCP server: git-insights-mcp

打开仓库

cd /path/to/repository
git-history-viewer web .

查看器会为该工作副本打开一个仅限回环（loopback）的浏览器会话。它不会克隆、获取、拉取、推送或修改 Git 状态。远程跟踪引用显示的是您现有 Git 工作流上次获取的状态。

对于 MCP 设置，请从仅元数据访问开始：

git-history-viewer mcp --repo /absolute/path/to/repository --content-policy metadata

开发

npm install
npm test
npm run license:check
npm run test:pack
node bin/git-history-viewer.mjs web . --port 0 --no-open
node bin/git-history-viewer.mjs web . --port 0 --no-open --ollama-model qwen3:4b
node bin/git-history-viewer.mjs config path
node bin/git-history-viewer.mjs config validate
node bin/git-history-viewer.mjs profiles list
node bin/git-history-viewer.mjs web . --ai-profile local-fast --ai-profile local-deep
node bin/git-history-viewer.mjs mcp --repo /absolute/path --content-policy metadata
node bin/git-history-viewer.mjs cache status

默认的 MCP 策略不会暴露补丁、作者邮箱或绝对路径。该应用从不获取或修改 Git 状态。

Web 页头包含一个 AI接続 指南，提供经过验证的 Codex、Claude Code 和 Cursor MCP 设置模板。它从不编辑客户端配置，也不会暴露仓库的绝对路径。选中的提交可以生成一个仅包含其 OID 的简短 MCP 提示。

可选的 Web AI 流程默认禁用，除非提供了 --ai-profile 或旧版 --ollama-model 选项。配置文件支持数字回环 Ollama 以及官方的 OpenAI、Anthropic 和 Google API。每个提供商都会预览确切的元数据负载，并且需要在生成前进行第二次点击。当启用多个配置文件时，详情面板会提供模型选择器。远程端点和凭据名称在代码中是固定的：OpenAI 读取 OPENAI_API_KEY，Anthropic 读取 ANTHROPIC_API_KEY，Google 读取 GEMINI_API_KEY。密钥从不接受来自浏览器或配置文件的输入。回环本身并不能证明 Ollama 在何处执行模型。补丁、文件内容、身份信息、绝对路径、引用、远程仓库和提交 ID 均不会被发送。

配置路径因操作系统而异，可通过 config path 命令打印。严格的 JSON 格式不存储任何凭据、任意端点、提示或环境变量名称：

{
  "schemaVersion": "1",
  "defaultProfileId": "local-fast",
  "profiles": [
    {
      "id": "local-fast",
      "label": "Local fast",
      "provider": "ollama",
      "model": "qwen3:4b",
      "ollamaPort": 11434,
      "maxOutputTokens": 1536
    },
    {
      "id": "openai-fast",
      "label": "OpenAI fast",
      "provider": "openai",
      "model": "gpt-5.4-mini",
      "maxOutputTokens": 1536
    },
    {
      "id": "claude-balanced",
      "label": "Claude balanced",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "maxOutputTokens": 1536
    },
    {
      "id": "gemini-fast",
      "label": "Gemini fast",
      "provider": "google",
      "model": "gemini-2.5-flash",
      "maxOutputTokens": 1536
    }
  ]
}

配置更改需要重启。--ai-profile 可重复使用，是该 Web 会话的显式白名单。仅在选择远程配置文件时导出相应的固定密钥。

AI 结果缓存使用操作系统用户缓存目录中有界的分片 JSON 文件。缓存元数据不存储 API 密钥、原始提示、差异、仓库路径或远程 URL；生成的结果仍可能重复敏感的源文本。--no-ai-cache 可绕过读写。cache clear 仅删除已识别的缓存条目文件。

提交详情面板可以从已编译的官方文档注册表中推荐最多两个版本中立的链接，用于强路径标记，如 GitHub Actions 工作流、Docker/Compose 文件、TSConfig、Vite 配置和 Vue SFC。链接显示不执行任何网络访问。另一个按钮可以通过抗 DNS 重绑定、固定 IP 的 HTTPS 传输直接从这些固定的官方 URL 获取有界摘录。目标可以推断检测到的技术，但仓库名称、路径、提交、消息、Cookie、凭据和引用者不会被发送。重定向会被拒绝。当 AI 启用时，另一个独立的预览和确认可以将显示的摘录以及不透明的引用 ID 发送到所选提供商；官方 URL 和标题从不发送给模型，仅由服务器映射回来。版本检测仍然不可用。

请参阅 docs/PRODUCT_SPEC.md、docs/ARCHITECTURE.md、docs/MCP.md、docs/SECURITY.md 和 docs/ROADMAP.md 了解规范性设计和计划的远程环境支持。

发布准备和回滚记录在 docs/RELEASING.md 中。构建工件并不授权发布它。