source-code-mgmt 1.1.0 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
 # source-code-mgmt — DSH 源代码管理插件
 
-> 版本：**v1.1.0**　|　更新日志见文末「[版本历史](#版本历史)」
+> 版本：**v1.1.1**　|　更新日志见文末「[版本历史](#版本历史)」
 
 > DSH Web GUI 侧边栏插件：把「环境检查 → SSH 配置 → 代码上传推送」整合进左栏底部的「代码管理」按钮，支持 GitHub / Gitee 双平台，一键管理代码仓库。
 
@@ -30,12 +30,12 @@
 - **选择目录 →**：下拉右侧按钮，可手动输入/粘贴目录绝对路径或点击「浏览…」弹出原生文件夹选择器；确认后**持久化加入自定义目录列表**（插件独立存储于 `~/.dsh/storages/source-code-mgmt-dirs.json`，**不写入插件目录**，开源不泄漏个人路径），下次打开无需重新选择；手动添加的目录会以**自定义目录徽标**显示，末端带 **✕** 可一键删除该下拉记录（只删记录，不删实际文件夹）
 - 显示仓库状态：平台来源、分支、远程地址、待提交改动数、领先/落后远程、>100MB 文件
 - **查看详情**：有改动时「改动」行旁出现「查看」按钮 → 点击弹出窗口列出改动/新增/删除/重命名的**文件或文件夹名称**（只列名称不显示内容）；本地与远程存在差异时「同步」行旁出现「查看」按钮 → 点击弹出窗口显示**本地领先/落后的具体提交列表**；无改动或已一致时不显示按钮
-- **动态操作按钮**（git 操作平台无关，GitHub/Gitee 均可）：根据本地与远程的相对状态自动显示——
+- **动态操作按钮**（git 操作平台无关，GitHub/Gitee 均可）：根据本地与远程的相对状态**只显示当前状态对应的唯一动作**——
   - 只有本地有更改 → 只显示「推送更改」（`git add` + `commit` + `push`）
-  - 只有远程有更新 → 只显示「拉取更新」（`git pull --ff-only`）
-  - 本地和远程都有更新 → 显示三按钮：「拉取更新并推送更改」（`git pull --rebase` + `push`）、「强制推送」（`git push --force`，用本地覆盖远程）、「强制拉取」（`git pull --force`，并入远程更新）
+  - 只有远程有更新 → 只显示「拉取更新」（实现复用「强制对齐」逻辑：`git fetch` + `git reset --hard origin/<branch>`；因为本地干净无改动，reset 不会丢任何内容，等同快速前进到远程最新，直接执行不弹确认）
+  - 本地和远程都有更新 → 只显示提示 +「**强制对齐**」：「拉取更新并推送更改 / 强制推送 / 强制拉取」在此场景下容易因未提交改动、分支保护等原因失败且行为难预测，已不在界面展示；直接把本地**完全重置为远程状态**（`git fetch` + `git reset --hard origin/<branch>`，丢弃本地差异）
   - 完全同步 → 显示「✓ 已是最新」
-  - 有远程时额外提供「**强制对齐**」兜底按钮：`git fetch` + `git reset --hard origin/<branch>`，把本地**完全重置为远程状态**（丢弃本地差异），用于解决「本地与远程文件相同却仍显示同步差异」的情况
+  - 「**强制对齐**」（`git fetch` + `git reset --hard origin/<branch>`，把本地完全重置为远程状态）**只在「本地和远程都有更新」状态出现**，作为该状态的唯一操作按钮，用于解决「本地与远程文件相同却仍显示同步差异」的情况
 - **创建 Git**：当所选目录**不是 git 仓库**但远程已存在同名仓库时显示该按钮，仅执行 `git init`（+设默认身份），**不拉取不推送**，由用户自行决定下一步是拉取还是推送
 - **新建仓库并推送**：默认以**文件夹名**为仓库名（只读不可改），可选**私有/公开**；同名仓库已存在时**按钮禁用**并在下方提示「同名仓库已经创建」。若目录还是**全新的（尚无任何提交）**，会先自动 `git add` + 生成一个初始提交再创建，避免推送时报 "no commits found"
   - GitHub：`gh repo create --private|--public --source=. --push`
@@ -51,55 +51,17 @@ DSH 打开时自动预取环境/SSH/工作区/仓库状态，点开面板**直
 
 `pnpm add`（无论是 `link:`、`git+` 还是 npm）只会把插件写进 profile 的 `package.json` 依赖和 `node_modules`，**并不会自动把插件注册进 Cordis loader 树**。要让左栏底部出现「代码管理」按钮，**还必须激活它**（见下方「激活配置（安装后必做）」）+ **完全重启 dsh web**。这也是 dsh-update 等本地插件共用的激活方式。
 
-### 方式一：从本地目录安装（开发/测试）
+### 方式一：从 npm 官方包安装（推荐）
 
-**Windows (PowerShell):**
-
-```powershell
-# 1. 进入你的 DSH profile 目录
-cd ~/.dsh/profiles/web
-
-# 2. 用 link 协议添加插件（指向本地源码绝对路径），会建立符号链接
-pnpm add link:C:/path/to/source-code-mgmt
-
-# 3. 激活插件：在 ~/.dsh/profiles/web/cordis.patch.yml 追加 insert 条目（见下）
-# 4. 完全重启 dsh web（先停旧进程再启动，刷新页面不生效）
-dsh web
-```
-
-**Linux / macOS:**
-
-```bash
-# 1. 进入你的 DSH profile 目录
-cd ~/.dsh/profiles/web
-
-# 2. 链接到插件源码目录（符号链接）
-pnpm add link:/home/yourname/path/to/source-code-mgmt
-
-# 3. 激活插件：在 ~/.dsh/profiles/web/cordis.patch.yml 追加 insert 条目
-# 4. 完全重启 dsh web（先停旧进程再启动）
-dsh web
-```
-
-### 方式二：从 GitHub 安装（分发场景）
-
-**Windows / Linux / macOS 通用:**
+**最省事的方式**——只需一条命令，且不用先进 profile 目录，推荐给普通使用者。
 
+**在任意目录执行：**
 ```bash
-# 1. 进入你的 DSH profile 目录
-cd ~/.dsh/profiles/web
-
-# 2. 从 GitHub 安装插件（实际下载源码到 node_modules）
-pnpm add git+https://github.com/Zhucy123/source-code-mgmt.git
-
-# 3. 激活插件：在 ~/.dsh/profiles/web/cordis.patch.yml 追加 insert 条目（见下）
-# 4. 完全重启 dsh web（先停旧进程再启动）
-dsh web
+# 用 DSH 自带的插件命令（自动定位/初始化 web profile）
+dsh plugin --profile web add source-code-mgmt
 ```
 
-> 方式二装完同样**不会自动激活**，必须做第 3 步的激活；且它是**实际拷贝**到 node_modules，改动源码需重新 `pnpm add` 拉取（不像 `link:` 是符号链接、改源码即生效）。
-
-### 方式三：从 npm 安装（暂未发布）
+或者等价地手动操作：
 
 ```bash
 cd ~/.dsh/profiles/web
@@ -107,7 +69,7 @@ pnpm add source-code-mgmt
 dsh web
 ```
 
-> 方式三安装完成后，同样需要激活（`cordis.patch.yml` 条目）+ 完全重启，按钮才会出现。
+> 说明：`dsh plugin --profile web add <包名>` 本质是「在 web profile 目录里执行 `pnpm add <包名>`」并顺带对账插件层，比手动 `cd` 更省心。但它**同样不会自动把插件激活**（不会替你写 `cordis.patch.yml` 的 insert 条目），所以装完后仍需下面「激活配置」里的步骤 + 完全重启。
 
 ### 激活配置（安装后必做）
 
@@ -139,6 +101,51 @@ dsh web
 > }
 > ```
 
+### 方式二：从本地目录安装（开发/测试）
+
+**Windows (PowerShell):**
+
+```powershell
+# 1. 进入你的 DSH profile 目录
+cd ~/.dsh/profiles/web
+
+# 2. 用 link 协议添加插件（指向本地源码绝对路径），会建立符号链接
+pnpm add link:C:/path/to/source-code-mgmt
+
+# 3. 激活插件：同上（见上方「激活配置」；追加 insert 条目后完全重启）
+dsh web
+```
+
+**Linux / macOS:**
+
+```bash
+# 1. 进入你的 DSH profile 目录
+cd ~/.dsh/profiles/web
+
+# 2. 链接到插件源码目录（符号链接）
+pnpm add link:/home/yourname/path/to/source-code-mgmt
+
+# 3. 激活插件：同上（见上方「激活配置」；追加 insert 条目后完全重启）
+dsh web
+```
+
+### 方式三：从 GitHub 安装（分发场景）
+
+**Windows / Linux / macOS 通用:**
+
+```bash
+# 1. 进入你的 DSH profile 目录
+cd ~/.dsh/profiles/web
+
+# 2. 从 GitHub 安装插件（实际下载源码到 node_modules）
+pnpm add git+https://github.com/Zhucy123/source-code-mgmt.git
+
+# 3. 激活插件：同上（见上方「激活配置」；追加 insert 条目后完全重启）
+dsh web
+```
+
+> 方式三装完同样**不会自动激活**（激活方式同方式一）；且它是**实际拷贝**到 node_modules，改动源码需重新 `pnpm add` 拉取（不像 `link:` 是符号链接、改源码即生效）。
+
 ### 验证安装是否成功
 
 安装 + 激活 + 重启后，可以核对以下几点：
@@ -146,7 +153,7 @@ dsh web
 1. **依赖已写入**：`~/.dsh/profiles/web/package.json` 的 `dependencies` 里应有 `source-code-mgmt`。
 2. **符号链接已建立（`link:` 方式）**：`~/.dsh/profiles/web/node_modules/source-code-mgmt` 指向源码目录（Windows 显示为 Junction）。
 3. **激活条目已添加**：`~/.dsh/profiles/web/cordis.patch.yml` 里有 `source-code-mgmt` 的 insert 条目。
-4. **重启后按钮可见**：左栏底部出现「代码管理」按钮，点开可看到预加载的 ①②③ 面板而非报错。
+4. **重启后按钮可见**：左栏底部出现「代码管理」按钮。
 
 ### 常见排障
 
@@ -219,7 +226,15 @@ pnpm add link:$(pwd)
 
 ## 版本历史
 
-### v1.1.0（当前）
+### v1.1.1（当前）
+本次更新：
+
+- **「拉取更新」改用强制对齐的实现并直接执行**：「本地干净 + 远程有更新」状态的「拉取更新」按钮不再走 `git pull --ff-only`，而是复用「强制对齐」的 `git fetch` + `git reset --hard origin/<branch>` 逻辑——本地干净没有可丢失的改动，reset 等同快速前进到远程最新，且**不弹确认框直接执行**，结果更可靠（可绕过 rebase/merge 常见失败场景）
+- **操作按钮只保留当前状态对应的唯一动作**：只有本地有改动（远程一致）→ 只显示「推送更改」；只有远程有更新（本地干净）→ 只显示「拉取更新」；「强制对齐」仅在「本地和远程都有更新」状态出现（该状态的唯一操作按钮），不再在推送/拉取/已同步状态里当作兜底显示
+- **「本地有改动 + 远程有更新」状态只保留「强制对齐」**：此前该状态显示「拉取更新并推送更改 / 强制推送 / 强制拉取」三按钮，但这些操作容易因未提交改动、分支保护等失败且行为难预测（表现为点了没反应、不显示结果），现改为只显示提示 + 「强制对齐」按钮（`git fetch` + `git reset --hard`，本地完全重置为远程），与用户实际想要的「一键对齐」一致
+- **修复「点了按钮没有任何反馈」**：操作回调先 `setErr` 再刷新仓库状态，随后 `loadRepo` 把错误提示无条件清空，导致失败时结果被立即抹掉、界面像什么都没发生；现在错误/结果会保留显示（切换目录 / 切换平台 / 手动刷新状态仍会清空旧提示），对齐失败等也能看到真实原因
+
+### v1.1.0（历史）
 本次更新：
 
 - **② SSH 新增平台选择**：在「② SSH 密钥与连接」顶部增加下拉选择代码托管平台 **GitHub（默认）** / **Gitee**

package/lib/client.js

@@ -318,7 +318,10 @@ window.__ModuleLoader__.load({
 			provRef.current = prov;
 
 			const loadRepo = useCallback(async (d, keepRepo) => {
-				setErr(null);
+				// 注意：不能在这里无条件清空 err —— 操作回调（推送/拉取/对齐等）会先
+				// setErr/setMsg 再调 loadRepo 刷新状态，此处清空会立刻抹掉刚设置的
+				// 结果/错误提示，造成「点了按钮没有任何反馈」。需要清空 err 的调用方
+				// （切换目录 / 切换平台 / 刷新状态）自行清空。
 				if (!keepRepo) setRepo(null);
 				try {
 					const p = provRef.current || "github";
@@ -409,6 +412,8 @@ window.__ModuleLoader__.load({
 			// 平台切换：gitee 时读取令牌状态；无论切到哪都刷新仓库（跟随平台检测/显示）
 			useEffect(() => {
 				if (prov === "gitee") void loadGiteeTokenStatus();
+				// 切换平台等同切换检测目标，清掉旧的错误提示，避免残留上一个平台的报错。
+				setErr(null);
 				if (dir || cache.defDir) loadRepo(dir || cache.defDir || "", true);
 				// eslint-disable-next-line react-hooks/exhaustive-deps
 			}, [prov]);
@@ -426,11 +431,15 @@ window.__ModuleLoader__.load({
 			}, [dir, loadRepo]);
 
 			const pull = useCallback(async () => {
+				// 「拉取更新」在“本地干净 + 远程有更新”状态出现：本地没有任何改动/提交，
+				// reset --hard 不会丢失任何内容，因此直接复用「强制对齐」的实现
+				// （git fetch + git reset --hard origin/<branch>），且无需弹确认框，
+				// 等同于把本地快速前进到远程最新状态。
 				setBusy(true); setMsg(null); setErr(null); setResult(null);
 				try {
-					const r = await jpost("/pull", { dir: dir || undefined });
+					const r = await jpost("/align", { dir: dir || undefined });
 					setResult(r);
-					if (r.ok) setMsg(r.upToDate ? "已是最新，无需拉取" : "拉取成功，已更新到最新");
+					if (r.ok) setMsg("已拉取远程更新（本地已对齐到远程最新状态）");
 					else setErr(r.error || "拉取失败");
 					void loadRepo(dir, true);
 				} catch (e) { setErr("拉取失败：" + e); }
@@ -719,24 +728,27 @@ window.__ModuleLoader__.load({
 						btns.push(h(Btn, { key: "init", label: "创建 Git", onClick: initGit, tone: "primary", noBg: true, disabled: isBlocked, title: "仅初始化 git 仓库，不拉取不推送，由你决定下一步" }));
 					} else if (hasRemote) {
 						if (localChanges && remoteUpdates) {
-							// 本地和远程都有更新 -> 三按钮：合并推送 / 强制推送 / 强制拉取
-							btns.push(h(Btn, { key: "mp", label: "拉取更新并推送更改", onClick: mergePush, tone: "primary", noBg: true, disabled: isBlocked }));
-							btns.push(h(Btn, { key: "fp", label: "强制推送", onClick: forcePush, disabled: isBlocked, title: "用本地版本覆盖远程（远程非本地更改被丢弃）" }));
-							btns.push(h(Btn, { key: "fpl", label: "强制拉取", onClick: forcePull, disabled: isBlocked, title: "强制并入远程更新" }));
+							// 本地和远程都有更新：原名展示「拉取更新并推送更改 / 强制推送 /
+							// 强制拉取」三按钮，但这三种操作在此场景下容易因未提交改动、
+							// 分支保护等原因失败且行为难预测，故不再展示——该状态唯一的
+							// 操作按钮是「强制对齐」（fetch + reset --hard，本地完全重置为远程）。
+							btns.push(h("span", { key: "both-note", style: { color: T.warn, fontSize: 12 } },
+								"本地有改动且远程有更新，可直接用「强制对齐」将本地重置为远程状态"));
+							if (repo && repo.isGitRepo) {
+								btns.push(h(Btn, { key: "align", label: "强制对齐", onClick: align, disabled: isBlocked, title: "本地完全重置为远程分支（丢弃本地差异），解决“文件相同仍显示同步差异”的情况" }));
+							}
 						} else if (localChanges) {
 							// 只有本地有更改 -> 只显示推送（正常 push）
 							btns.push(h(Btn, { key: "push", label: "推送更改", onClick: push, tone: "primary", noBg: true, disabled: isBlocked || repo?.repoExists === false }));
 						} else if (remoteUpdates) {
-							// 只有远程有更新 -> 只显示拉取（正常 pull）
+							// 只有远程有更新（本地干净）-> 只显示「拉取更新」。
+							// 实现复用「强制对齐」逻辑（fetch + reset --hard）：本地干净
+							// 无改动可丢，reset 等同快速前进到远程最新，直接执行不弹确认。
 							btns.push(h(Btn, { key: "pull", label: "拉取更新", onClick: pull, disabled: isBlocked || repo?.repoExists !== true }));
 						} else {
 							// 完全同步 -> 无按钮，显示已是最新
 							btns.push(h("span", { key: "synced", style: { color: T.success, fontSize: 13 } }, "✓ 已是最新"));
 						}
-						// 有远程时总是提供「强制对齐」作为兜底（本地完全重置为远程状态）
-						if (repo && repo.isGitRepo) {
-							btns.push(h(Btn, { key: "align", label: "强制对齐", onClick: align, disabled: isBlocked, title: "本地完全重置为远程分支（丢弃本地差异），解决“文件相同仍显示同步差异”的情况" }));
-						}
 					}
 					return h("div", { style: { display: "flex", gap: 8, flexWrap: "wrap", alignItems: "center" } },
 						btns,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "source-code-mgmt",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "DSH plugin: source code management in the sidebar footer — env checks (git/gh), SSH ed25519 key setup, GitHub/Gitee dual-platform (SSH config 443 + Gitee OpenAPI), connectivity test, push / new repo, and auto-ignore files over 100MB with per-file skipped reasons. Cross-platform (Windows / Linux / macOS).",
   "type": "module",
   "main": "lib/index.js",