# @fish-under-sea/dsh-git-sync 中文文档

规范地址：https://npmcn.com/package/%40fish-under-sea/dsh-git-sync/

版本：2\.0\.2
npm 元数据更新时间：2026-11-12T17:40:11.936Z
中文译文更新时间：2026-11-14T20:59:31.478Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fish-under-sea/dsh-git-sync
原文对照：https://npmcn.com/package/%40fish-under-sea/dsh-git-sync/?lang=original
项目主页：https://github.com/Fish-under-sea/dsh-fish#readme
源码仓库：https://github.com/Fish-under-sea/dsh-fish

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

- 包体积（解压后）：310 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.9
- 运行依赖：0 个
- 首次发布：2026-09-30T05:00:24.466Z
- 最新版本发布：2026-11-12T17:40:11.718Z
- 近 30 天下载量：2285（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

DeepSeek Harness 一键 GitHub 同步：把插件清单、插件启用状态、插件配置、本地设置、Skills、Skill 的 refs/脚本、看板/用量账本、设置导航顺序偏好、壁纸引擎整机配置快照（$DSH\_HOME/FISH.json）、免费模型插件配置与用量账本采集进你自己的私有 git 仓库并推送，换机可一键还原；采集前自动 fetch 远端并合并，密钥永不搬运。0.2.5 起不再同步 agent 预设 / 桌宠存档 / 工作区映射，0.2.6 起不再同步归档台账，0.2.7 起纳入 sk

## 安装

```sh
npm install @fish-under-sea/dsh-git-sync
```

也可以使用：`pnpm add @fish-under-sea/dsh-git-sync`、`yarn add @fish-under-sea/dsh-git-sync`、`bun add @fish-under-sea/dsh-git-sync`

## README

# @fish-under-sea/dsh-git-sync

**2.0.2 · Git 同步**

把选定配置同步进私有 Git 仓库并换机还原。

[English](https://npmcn.com/package/%40fish-under-sea/dsh-git-sync/README.en.md)

## 功能

将选定的 DSH 配置同步到私有 Git 仓库，支持预览、提交、拉取和换机还原。凭据导出与普通同步分开：只把 `$DSH_HOME/.credentials.yaml` 复制到用户指定目录；留空时使用桌面，并在其中创建 `DSH凭据导出` 文件夹。导出目录仅包含该凭据文件，不生成 README。

## 安装

```sh
dsh plugin --profile <profile> add @fish-under-sea/dsh-git-sync@2.0.2
```

也可安装聚合包 `@fish-under-sea/dsh-fish@2.0.2`。聚合与独立安装不要重复展开相同插件行；安装完成后重启 DSH。桌面环境无 CLI 时使用插件管理器。

## 配置与边界

配置目录为 `$DSH_HOME/dsh-git-sync/`。同步不是完整备份；密钥、令牌、会话记录和 SSH 密码不能当作普通配置提交。导出只复制 `$DSH_HOME/.credentials.yaml` 到用户自选目录；未指定时使用桌面（桌面不可用时退回用户目录）。导出不会连接网络、写入 Git 或生成 README，也不会把凭据内容写进日志。不要把导出文件上传到云盘或聊天软件；覆盖前请先备份。

Node 要求: `>=24.9`. DSH 支持范围以本包声明为准；聚合包不覆盖宿主兼容性检查。

## 维护与来源

2.0.2 统一发布版本，不表示已合并上游所有最新提交。历史说明保留在 Git 历史中；聚合变更见 [聚合变更记录](https://github.com/Fish-under-sea/dsh-fish/blob/main/CHANGELOG.md).

Fish 原生插件。 许可证: MIT.

## 常见问题

### @fish-under-sea/dsh-git-sync 是什么？

DeepSeek Harness 一键 GitHub 同步：把插件清单、插件启用状态、插件配置、本地设置、Skills、Skill 的 refs/脚本、看板/用量账本、设置导航顺序偏好、壁纸引擎整机配置快照（$DSH\_HOME/FISH\.json）、免费模型插件配置与用量账本采集进你自己的私有 git 仓库并推送，换机可一键还原；采集前自动 fetch 远端并合并，密钥永不搬运。0\.2\.5 起不再同步 agent 预设 / 桌宠存档 / 工作区映射，0\.2\.6 起不再同步归档台账，0\.2\.7 起纳入 sk

### 如何安装 @fish-under-sea/dsh-git-sync？

在项目目录运行 npm install @fish-under-sea/dsh-git-sync，或使用 pnpm add / yarn add / bun add。

### @fish-under-sea/dsh-git-sync 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fish-under-sea\_\_dsh-git-sync 是否存在。

### @fish-under-sea/dsh-git-sync 支持 ESM 还是 CommonJS？

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

### @fish-under-sea/dsh-git-sync 需要什么版本的 Node\.js？

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

### @fish-under-sea/dsh-git-sync 可以商用吗？

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

### @fish-under-sea/dsh-git-sync 的下载量有多少？

根据 npm 官方下载统计，@fish-under-sea/dsh-git-sync 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,285 次，日均约 76 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fish-under-sea/dsh-git-sync 还在维护吗？

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