@dpskk2/dsh-chatsync

第一次使用

1. 先准备好这几样东西

先确认你能正常打开 DSH 的网页界面。如果还没装 DSH，请先完成DSH 官方安装步骤，能打开网页后再回来继续。安装过程中如果需要 Node.js，可从官网下载，建议使用 24。

需要什么	你需要做什么
GitHub 账号	用来存放同步数据。没有账号就先注册；记住这个账号，其他电脑也要用
Git	帮插件传输和保存文件。下载 Git，选择你的系统并完成安装
GitHub CLI	帮这台电脑登录 GitHub。下载 GitHub CLI，选择你的系统并完成安装

Git 和 GitHub CLI 是两个不同的工具，都要安装。GitHub CLI 没有需要你单独打开的登录窗口，下一步会在终端里用 gh 命令调用它。

2. 打开终端，装上插件

工具安装完成后，打开一个新的终端窗口：

• Windows： 打开开始菜单，搜索「PowerShell」并打开，不需要选「以管理员身份运行」。
• macOS： 打开「终端」应用。
• Linux： 打开系统自带的终端。

下面的命令都粘贴到这个窗口里，不是 DSH 的聊天输入框，也不是浏览器地址栏。每次复制代码框里的整行，粘贴后按一次 Enter（回车），等它执行结束再继续；不用输入代码框外面的标题。

先安装同步插件：

dsh plugin --profile web add @dpskk2/dsh-chatsync

等终端显示安装结果、重新出现可输入命令的提示符。若出现错误，先看下方常见问题，不要接着往下做。

3. 让这台电脑登录你的账号

仍在刚才的终端里，复制这一整行并按 Enter。它会发起浏览器登录，命令已经替你选好了 GitHub.com 和 HTTPS：

gh auth login --hostname github.com --git-protocol https --web

接下来按提示完成登录：

1. 如果终端问是否让 Git 使用此账号（Authenticate Git ...），选择 Yes，按 Enter。
2. 终端会显示一次性验证码；记下它，按提示按 Enter 打开浏览器。没有自动打开时，打开终端给出的网址。
3. 在浏览器登录你准备好的 GitHub 账号，按页面要求输入终端里的验证码，确认授权 GitHub CLI。这个验证码不是你的模型 API 密钥。
4. 浏览器提示授权完成后，回到终端，等它显示登录完成并重新出现输入提示符。

然后单独运行下面这一行，检查登录是否成功。这条命令只检查状态，不会重新登录：

gh auth status

输出中应能看到 Logged in to github.com account 和你的用户名。确认是你想用的账号，再继续。仅仅在浏览器里登录了 GitHub，并不代表这个步骤已经完成。

4. 回到 DSH，完成第一次同步

关闭并重新启动 DSH，再刷新网页。只刷新网页不等于重启 DSH；如果你原来用终端启动它，就回到那个启动窗口停止进程，再按原来的方式启动。

打开 设置 → 同步：

1. 先选同步范围。 找到「同步偏好」。默认会上传工作区内的项目文件；如果你只想同步聊天、附件和设置，关闭「同步工作区文件」并点「保存偏好」。工作区就是你在 DSH 中打开的项目文件夹。
2. 第一次用，连接设置先不用填。 保持默认的自动建仓选项，点「立即同步」（侧栏「⟳ 同步」也可以）。插件会尝试在你的账号下创建或复用名为 dsh-sync 的私有仓库。仓库可以理解为存放同步数据的云端空间，不需要你先手动创建。
3. 检查结果。 设置页应出现仓库地址；等待同步结束，确认没有失败提示，也没有工作区同步失败。第一次传输耗时取决于文件数量和网络。

看到「本地快照」还不算完成：它表示只存在这台电脑上，没有上传。 如果上传失败，在同步页展开错误详情，按排障说明处理后再试。

已有指定仓库的用户，可以在「连接同步仓库」填写地址与分支；不确定这些是什么，先使用上面的默认流程即可。已有仓库的连接方法