# dsh-plugin-git-tree-viz 中文文档

规范地址：https://npmcn.com/package/dsh-plugin-git-tree-viz/

版本：0\.1\.2
npm 元数据更新时间：2026-11-03T11:41:22.525Z
中文译文更新时间：2026-11-03T14:54:00.252Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/dsh-plugin-git-tree-viz
原文对照：https://npmcn.com/package/dsh-plugin-git-tree-viz/?lang=original
项目主页：https://github.com/YzK0741/dsh-plugin-git-tree-viz#readme
源码仓库：https://github.com/YzK0741/dsh-plugin-git-tree-viz

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：185 kB，19 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.9\.0
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.5 \|\| ^4\.0\.6-alpha\.1
- 首次发布：2026-11-03T11:37:13.561Z
- 最新版本发布：2026-11-03T11:41:22.340Z
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

用于DeepSeek Harness的本机Git历史资源管理器：图形、差异、排序、导出和安全的本地标签。

## 安装

```sh
npm install dsh-plugin-git-tree-viz
```

也可以使用：`pnpm add dsh-plugin-git-tree-viz`、`yarn add dsh-plugin-git-tree-viz`、`bun add dsh-plugin-git-tree-viz`

## README

# Git Tree for DeepSeek Harness

用于DeepSeek Harness的本机Git历史资源管理器。麻省理工学院的许可。没有Python，额外的服务器，iframe或独立端口。

## 特性

-   交互式SVG分支图和提交细节，具有父/子导航和文件差异。
-   中文/英文用户界面遵循线束语言；浅色/深色呈现遵循主题。
-   对话选项卡旁边的聊天，轨迹和上下文，自动遵循该对话的工作区和存储库。手动存储库路径仍然可用。
-   键入过滤器，搜索，时间/行更改/文件计数排序在两个方向；非时间排序忽略了图边。
-   将任何提交的版本导出为文件快照或独立的Git存储库（可选地在新分支上）。
-   默认为只读。显式警告确认启用本地标签和一键回滚所有未更改的应用程序创建的标签。标签必须手动推送。
-   插件拥有的观察者、订阅和RPC处理程序在卸载时被删除。视图永远不会改变Harness URL、全局文档标题或样式表。

## 兼容性

第一个版本的目标是DeepSeek Harness **0.2.2-alpha.2** 原生客户端/连接api和Node.js **24.9 +**． 线束api是预稳定的；假定以前发布的组件版本不兼容。需要最新的系统Git。包的 `engines.dsh` 强制支持的范围。

## 安装

安装到你实际使用的配置文件中：

```sh
dsh plugin --profile web add dsh-plugin-git-tree-viz
```

对于本地包，构建并打包，然后安装生成的tarball：

```sh
npm ci --ignore-scripts --legacy-peer-deps
npm run check
npm pack --ignore-scripts
dsh plugin --profile web add /absolute/path/dsh-plugin-git-tree-viz-0.1.2.tgz
```

打开对话并选择 **Git历史** 以及聊天、轨迹和上下文。它的存储库自动跟踪会话的工作空间，包括Git子目录中的工作空间。更改会话或工作空间将重置图和写访问。如果需要，手动输入另一个存储库路径。视图将图形交互保存在自己的ShadowRoot中，并使用现有的认证连接载体进行所有Git操作。

该包包括其构建的 `lib/` 工件;安装发布或Git签出不需要安装/准备脚本。开发依赖关系不是运行时依赖关系。

## 安全性和语义

只有经过身份验证的所有者Peer才能调用插件通道。源代码写入需要在UI警告之后发出特定于存储库和对等体的功能。在存储库更改、重新挂载和主机生成更改时，视图返回到只读状态。只读源文件仍然可以导出到其他目录。

标签和应用程序所有权引用是自动创建的。 **撤销应用程序标签** 只删除该应用程序在当前存储库中创建的未更改的标签，包括早期的插件会话。手动标签和随后移动的标签被保留。所有权存在于 `refs/git-tree-viz/tags/*`，它被排除在可见的历史之外。这些都是本地操作；远程标签需要手动推送。

导出需要在源存储库之外有一个不存在的或空的目标，并且有一个现有的父目录。输出构建在同级暂存目录中，只有在成功时才移动到相应位置。快照读取提交的对象字节，包括 `export-ignore` 文件，并排除脏/未跟踪的文件。Git副本不会通过硬链接或替代品借用对象，也不会执行签出钩子。子模块为空；LFS指针文件保留，不需要下载对象。拒绝外部快照符号链接；Windows可以将内部链接表示为目标文本。

被接受的突变在宿主解体前就稳定下来了；普通读取是可以取消的。中断或失败的导出仅删除其自己的暂存目录，而不覆盖非空目标。

## 发展

```sh
npm ci --ignore-scripts --legacy-peer-deps
npm run check
```

测试使用临时的真实Git存储库和DOM环境；不需要模型API密钥。 `src/engine.ts` 拥有Node操作； `src/index.ts` 经过认证的Cordis通道； `src/client/` 原生导航/生命周期，以及 `src/ui/` 派生的维护接口 [git-tree-viz](https://github.com/YzK0741/git-tree-viz)． 构建将该接口编译为一个作用域函数；它不会在运行时计算源字符串。

中的部署设置 `cordis.patch.yml`： `gitTimeoutMs` (120000), `maxOutputBytes` (134217728)和 `maxPatchCharacters` (200000)。无效设置在激活时失败。

## 已知的限制

-   仅支持本地存储库操作；没有GitHub API或自动推送。
-   在布局前读取整个历史元数据；只绘制附近的图行。
-   不会显示源工作树的更改，也不会执行子模块/LFS下载。
-   对于每个受支持的API版本，必须检查本地客户端兼容性。

## 许可证

[麻省理工学院](https://npmcn.com/package/dsh-plugin-git-tree-viz/LICENSE) ©2026 YzK0741。SVG接口来自同一作者的mit许可 [独立Git树](https://github.com/YzK0741/git-tree-viz)。

## 常见问题

### dsh-plugin-git-tree-viz 是什么？

用于DeepSeek Harness的本机Git历史资源管理器：图形、差异、排序、导出和安全的本地标签。

### 如何安装 dsh-plugin-git-tree-viz？

在项目目录运行 npm install dsh-plugin-git-tree-viz，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.5 \|\| ^4\.0\.6-alpha\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### dsh-plugin-git-tree-viz 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### dsh-plugin-git-tree-viz 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### dsh-plugin-git-tree-viz 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.9\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### dsh-plugin-git-tree-viz 可以商用吗？

dsh-plugin-git-tree-viz 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### dsh-plugin-git-tree-viz 还在维护吗？

最新版本 0\.1\.2 发布于 2026/11/03（今天）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/11/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。