提交 5c4da5de authored 作者: 陈泽健's avatar 陈泽健

docs(服务自检): HANDOFF 明确 md 文档不放置桌面测试目录约定

上级 c39bdb26
...@@ -46,7 +46,8 @@ ...@@ -46,7 +46,8 @@
| 23 | 统一平台分类路径细分 - 提交推送 | commit `9d111845`(11 个代码文件)/ `9be5c892`(HANDOFF) | 已推送 develop 分支 | | 23 | 统一平台分类路径细分 - 提交推送 | commit `9d111845`(11 个代码文件)/ `9be5c892`(HANDOFF) | 已推送 develop 分支 |
| 24 | 统一平台分类路径细分 - HANDOFF 会话闭环提交 | `Docs/PRD/服务自检/HANDOFF_服务自检会话交接.md` | 2026-09-01 收尾:本会话 6 项新增内容(header/表格 #17-23/验证块/阻塞行/下一步 #6-7/给接手者)提交推送,commit `71bbf9c3`(36+/2-) | | 24 | 统一平台分类路径细分 - HANDOFF 会话闭环提交 | `Docs/PRD/服务自检/HANDOFF_服务自检会话交接.md` | 2026-09-01 收尾:本会话 6 项新增内容(header/表格 #17-23/验证块/阻塞行/下一步 #6-7/给接手者)提交推送,commit `71bbf9c3`(36+/2-) |
| 25 | 桌面同步补全(漏同步 7 文件) | `C:\Users\29194\Desktop\Sever_health_check\` | 2026-09-01 复核:上次仅同步主脚本,漏了 ConfigIPCheck/DataBackup/FilePermission/LogExport/Report/ShellAdapter.psm1 + `lib/shell/config_check.sh` 共 7 个文件(桌面停留在旧版);已从仓库最新版拷贝同步,`diff -rq` 全量校验 0 差异 | | 25 | 桌面同步补全(漏同步 7 文件) | `C:\Users\29194\Desktop\Sever_health_check\` | 2026-09-01 复核:上次仅同步主脚本,漏了 ConfigIPCheck/DataBackup/FilePermission/LogExport/Report/ShellAdapter.psm1 + `lib/shell/config_check.sh` 共 7 个文件(桌面停留在旧版);已从仓库最新版拷贝同步,`diff -rq` 全量校验 0 差异 |
| 26 | 踩坑警示补充 #8 | `Docs/PRD/服务自检/HANDOFF_服务自检会话交接.md` | 【待提交】新增警示:桌面同步必须覆盖 modules/ 全部模块与 lib/,不能只同步主脚本;同步后需全量 `diff -rq` 校验 | | 26 | 桌面同步范围确认 - md 文档不放置 | `C:\Users\29194\Desktop\Sever_health_check\` | 2026-09-01 确认:方案/需求类 md 文档(如 `PowerShell模块修复项确认改进方案.md`、`修复项确认交互改进方案.md`)**不放入桌面测试目录**,仅保留在仓库 Docs 中;桌面目录只放运行脚本 + 模块 + 运行时产物 |
| 27 | 踩坑警示补充 #8 | `Docs/PRD/服务自检/HANDOFF_服务自检会话交接.md` | 【待提交】新增警示:桌面同步必须覆盖 modules/ 全部模块与 lib/,不能只同步主脚本;同步后需全量 `diff -rq` 校验 |
### 验证结果 ### 验证结果
...@@ -127,7 +128,7 @@ grep fix_external_service_disconnect 残留: 无(仅 ps1 历史交互文案, ...@@ -127,7 +128,7 @@ grep fix_external_service_disconnect 残留: 无(仅 ps1 历史交互文案,
**2026-09-01 会话收尾**:HANDOFF 详情(本会话 6 项新增)已提交 `71bbf9c3` 并推送,任务 #1-#6 全部完成,无阻塞。 **2026-09-01 会话收尾**:HANDOFF 详情(本会话 6 项新增)已提交 `71bbf9c3` 并推送,任务 #1-#6 全部完成,无阻塞。
**2026-09-01 桌面同步补全**:复核发现桌面漏同步 7 个文件(上次仅同步主脚本,modules/lib 层停留在旧版),已全部从仓库最新版拷贝并 `diff -rq` 全量校验一致;HANDOFF 已记录(表格 #25-26 + 踩坑警示 #8),**本次 HANDOFF 变更待提交** **2026-09-01 桌面同步补全**:复核发现桌面漏同步 7 个文件(上次仅同步主脚本,modules/lib 层停留在旧版),已全部从仓库最新版拷贝并 `diff -rq` 全量校验一致;随后确认方案/需求类 md 文档不放置于桌面测试目录(已移除误拷的 2 个 md),桌面目录仅保留运行脚本 + 模块 + lib + 运行产物。HANDOFF 已记录(表格 #25-27 + 踩坑警示 #8-9),**本次 HANDOFF 变更待提交**。
--- ---
...@@ -155,7 +156,8 @@ grep fix_external_service_disconnect 残留: 无(仅 ps1 历史交互文案, ...@@ -155,7 +156,8 @@ grep fix_external_service_disconnect 残留: 无(仅 ps1 历史交互文案,
5. ❌ **提交前必须核对桌面与仓库两处文件一致** — 桌面测试目录是用户实际运行环境,改代码后需 `diff` 验证两处同步,避免测试版本与仓库版本漂移。 5. ❌ **提交前必须核对桌面与仓库两处文件一致** — 桌面测试目录是用户实际运行环境,改代码后需 `diff` 验证两处同步,避免测试版本与仓库版本漂移。
6. ❌ **桌面实际运行目录是 `C:\Users\29194\Desktop\Sever_health_check\`,不是 `Desktop\Test\`** — 2026-08-31 会话中用户最初指定 `Desktop\Test\`,但实际运行脚本的目录是 `Sever_health_check\`(`Test` 目录后来不存在)。同步代码时务必确认用户实际打开的目录。 6. ❌ **桌面实际运行目录是 `C:\Users\29194\Desktop\Sever_health_check\`,不是 `Desktop\Test\`** — 2026-08-31 会话中用户最初指定 `Desktop\Test\`,但实际运行脚本的目录是 `Sever_health_check\`(`Test` 目录后来不存在)。同步代码时务必确认用户实际打开的目录。
7. ❌ **不要把服务器明文密码写回脚本** — 本次已删除 `$ServerList` 中 6 台服务器的明文密码。后续如需"预设列表"功能,应迁移到独立配置文件(JSON),且配置文件不要提交到仓库。 7. ❌ **不要把服务器明文密码写回脚本** — 本次已删除 `$ServerList` 中 6 台服务器的明文密码。后续如需"预设列表"功能,应迁移到独立配置文件(JSON),且配置文件不要提交到仓库。
8.**桌面同步必须覆盖 modules/ 全部模块与 lib/,不能只同步主脚本** — 2026-09-01 复核发现上次只同步了 sh/auto/ps1/ServiceCheck.psm1 四个脚本,**漏了 7 个文件**(ConfigIPCheck/DataBackup/FilePermission/LogExport/Report/ShellAdapter.psm1 + `lib/shell/config_check.sh`),桌面长时间停留在旧版。同步后务必对整个 `ServiceSelfInspection\` 目录执行 `diff -rq` 全量校验(主脚本 + modules/16 + lib/),确认 0 差异才算完成。 8. ❌ **桌面同步必须覆盖 modules/ 全部模块与 lib/,不能只同步主脚本** — 2026-09-01 复核发现上次只同步了 sh/auto/ps1/ServiceCheck.psm1 四个脚本,**漏了 7 个文件**(ConfigIPCheck/DataBackup/FilePermission/LogExport/Report/ShellAdapter.psm1 + `lib/shell/config_check.sh`),桌面长时间停留在旧版。同步后务必对整个 `ServiceSelfInspection\` 目录执行 `diff -rq` 全量校验,确认 0 差异才算完成。
9.**方案/需求类 md 文档不要同步到桌面测试目录** — 2026-09-01 曾误将 `PowerShell模块修复项确认改进方案.md``修复项确认交互改进方案.md` 拷入桌面后按用户要求删除。桌面目录 `C:\Users\29194\Desktop\Sever_health_check\` 只放运行脚本 + 模块 + lib;md 文档仅保留在仓库 Docs 中。全量 diff 校验时这两类文件属预期差异,不算漏同步。
--- ---
......
Markdown 格式
0%
您添加了 0 到此讨论。请谨慎行事。
请先完成此评论的编辑!
注册 或者 后发表评论