dsh-config-manager 0.1.78 → 0.1.80

package/src/foreign/types.ts

@@ -165,7 +165,24 @@ export type ForeignSkipCode =
    * 该来源**没有自动根**（竞品 `defaultRoots.chatgpt = null`）—— 必须由用户显式给出导出文件
    * 路径；本机自动探测永远不会命中，如实报码而不是假装「未安装」。
    */
-  | 'source-needs-explicit-path';
+  | 'source-needs-explicit-path'
+  /* ---- 2026-10-18：Claude Code 插件 / 项目级配置 / 权限 / 设置键的如实诊断（纯 additive） ---- */
+  /** settings.json 的 permissions（allow/ask/deny）：DSH 无权限规则文件对等结构，只报告条数 */
+  | 'unsupported-permissions'
+  /** settings.json 里其余未迁移的顶层键（只记键名与条数，**值一律不读**） */
+  | 'unsupported-settings-keys'
+  /** .claude/agents/*.md 子代理定义：DSH 的 subagent 是运行时 provider 注册制，无文件级对等结构 */
+  | 'unsupported-agents'
+  /** .claude/rules/*.md 带 frontmatter 作用域：合并进全局指令会丢作用域，故只报告 */
+  | 'unsupported-rules'
+  /** Claude Code 插件本体（插件 API / hooks / commands 的执行面）：DSH 无法加载，**绝不复制其代码** */
+  | 'unsupported-plugins'
+  /** 会话记录里的 sessionId 与文件名 stem 不一致（DSH 以目录/文件名定位会话，故以文件名为准并如实报码） */
+  | 'session-id-mismatch'
+  /** 同名 MCP server 在多处出现（全局 / 项目级 / 插件）：先到先得，其余只报告 */
+  | 'mcp-server-id-conflict'
+  /** 项目级扫描触顶（maxProjects）：**不静默**，如实报码 */
+  | 'project-scan-truncated';
 
 /**
  * 冲突语义（**契约冻结**，§8.4）：同 id 会话恒「不覆盖、跳过并报码」。
@@ -201,7 +218,7 @@ export interface ClaudeCodeInput {
   skills?: ClaudeSkillInput[];
   /** ~/.claude/CLAUDE.md 原文（全局指令） */
   memory?: string;
-  /** ~/.claude/commands/* 的普通文件数（本期只报不搬） */
+  /** ~/.claude/commands/** 的普通文件数（**递归**；只报不搬） */
   commandCount?: number;
   /** ~/.claude/projects/<项目>/<uuid>.jsonl 的原文（转码在翻译层做） */
   sessions?: ClaudeSessionInput[];
@@ -210,6 +227,94 @@ export interface ClaudeCodeInput {
    * 缺省 = 不转码任何会话并逐条报 session-format-version-unknown，绝不猜版本。
    */
   targetSessionFormatVersion?: number;
+  /**
+   * 实际使用的 Claude 配置目录绝对路径（CLAUDE_CONFIG_DIR 覆盖时为该值，否则 <home>/.claude）。
+   * **只进溯源元数据**，不进任何分区载荷。
+   */
+  configDir?: string;
+  /** 位置被 CLAUDE_CONFIG_DIR 覆盖（命中即报 source-location-overridden） */
+  configDirOverridden?: boolean;
+  /** 来源侧版本标记（~/.claude.json 的 lastVersionBase 等；拿不到即省略） */
+  sourceVersion?: string;
+  /** 项目级配置的已读形态（项目根来自 ~/.claude.json 的 projects 键；**不猜路径**） */
+  projects?: ClaudeProjectInput[];
+  /** 用户级 Claude Code 插件的已读形态（只读元数据与组件，**绝不执行插件代码**） */
+  plugins?: ClaudePluginInput[];
+  /** 已登记的市场（name + 来源仓库；URL 的 userinfo 已剥离） */
+  marketplaces?: { name: string; repo?: string }[];
+}
+
+/**
+ * 一个 Claude Code **项目级**配置目录的已读形态（纯数据；翻译层不做任何 fs 访问）。
+ *
+ * 位置口径（实测取证 2026-10-18，本机 ~/.claude.json 的 projects 键）：项目根来自
+ * `~/.claude.json` 的 `projects` 键（绝对路径，Claude Code 自己写的权威清单）——
+ * **不按目录名猜项目路径**（猜 = 把会话归到不存在的目录）。
+ */
+export interface ClaudeProjectInput {
+  /** 项目根绝对路径（**仅进溯源元数据与报码，不进任何分区载荷**） */
+  root: string;
+  /** `<root>/.claude` 是否存在（false = 该项目没有 Claude 配置，读盘层不产出任何 finding） */
+  hasClaudeDir?: boolean;
+  /** `<root>/.claude/settings.json`（已解析） */
+  settings?: unknown;
+  /** `<root>/.claude/settings.local.json`（已解析；值一律不读，只做诊断） */
+  settingsLocal?: unknown;
+  /** `<root>/CLAUDE.md` 原文（项目级指令） */
+  memory?: string;
+  /** `<root>/CLAUDE.local.md` 原文（本地覆盖指令） */
+  memoryLocal?: string;
+  /** `<root>/.claude/rules/*.md`：文件名 + 原文（带 frontmatter 的按 unsupported-rules 只报告） */
+  rules?: { name: string; text: string }[];
+  /** `<root>/.mcp.json`（已解析；Claude Code 的项目级 MCP 载体） */
+  mcpJson?: unknown;
+  /** `~/.claude.json` → `projects[<root>].mcpServers`（已解析） */
+  projectMcp?: unknown;
+  /** `<root>/.claude/skills/*` 的单元 */
+  skills?: ClaudeSkillInput[];
+  /** `<root>/.claude/commands/**` 的普通文件数（**递归**；只报不搬） */
+  commandCount?: number;
+  /** `<root>/.claude/agents/*.md`：名字 + 文件名（只报告，无文件级对等结构） */
+  agents?: { name: string; file: string }[];
+  /** 读盘层发现的问题（读不到 / 超限 / 非法）——由翻译层原样带出 */
+  readFindings?: ForeignSkip[];
+}
+
+/**
+ * 一个 Claude Code **插件**的已读形态（纯数据）。
+ *
+ * 三条结构性保证：
+ *  ① **只读元数据与组件，绝不执行插件代码**（Claude 插件的 hooks/commands 是 JS 执行面）；
+ *  ② 安装位置/来源只进**溯源元数据**（bundle 的 foreign 块），不由本层写进任何分区；
+ *  ③ 能无损复用的组件只有 skills 与 .mcp.json 里的 MCP 定义（凭据先剥离），其余一律报码。
+ */
+export interface ClaudePluginInput {
+  /** 插件名（plugin.json 的 name；缺失时回落目录名） */
+  name: string;
+  /** 插件版本（plugin.json 的 version；缺失即省略） */
+  version?: string;
+  /** 来源市场名（known_marketplaces.json / marketplace.json 的键） */
+  marketplace?: string;
+  /** 来源仓库（owner/repo 或 URL；**已剥离 userinfo，绝不含凭据**） */
+  repo?: string;
+  /** 来源 ref / sha（若有） */
+  ref?: string;
+  /** 安装位置（相对 ~/.claude/plugins 的 POSIX 相对路径；进溯源用） */
+  installRel?: string;
+  /** 实际存在的组件种类（skills / commands / agents / hooks / mcp），供诊断文案用 */
+  components: string[];
+  /** 插件自带的 skills（name = 压平后的技能名） */
+  skills?: ClaudeSkillInput[];
+  /** 插件自带 `.mcp.json`（已解析） */
+  mcpJson?: unknown;
+  /** 插件自带 commands 的文件数（**递归**；只报不搬） */
+  commandCount?: number;
+  /** 插件自带 agents 的文件名（只报告） */
+  agents?: string[];
+  /** 插件自带 hooks 的文件数（只报告；绝不只是不执行） */
+  hookFiles?: number;
+  /** 读盘层发现的问题 */
+  readFindings?: ForeignSkip[];
 }
 
 /** 一个待转码的 Claude Code 会话文件 */
@@ -217,6 +322,19 @@ export interface ClaudeSessionInput {
   /** 文件名（不含 .jsonl）；同时作为 DSH 侧会话 id */
   id: string;
   text: string;
+  /**
+   * 记录里首个出现的 sessionId。与 id（文件名 stem）不一致时由翻译层报 session-id-mismatch：
+   * DSH 以「目录名/文件名」定位会话，故仍以文件名为准，但**不静默**。
+   */
+  recordSessionId?: string;
+  /**
+   * 确定性 createdAt 回落值（毫秒）：读盘层给「最早可解析记录时间」，没有时间戳时给文件 mtime。
+   *
+   * 为什么必须由读盘层给：DSH 侧「同内容 → Skip」的判定是**逐字节**的，而会话产物里带着
+   * createdAt/updatedAt；若回落用 Date.now()，同一来源转码两次字节必然不同 ⇒ 重复导入恒判
+   * Conflict 而不是 Skip（实测缺陷）。由文件自身 mtime 回落即可让转码**幂等**。
+   */
+  createdAtMs?: number;
 }
 
 /* ---------------- Hermes（~/.hermes，Windows 为 %LOCALAPPDATA%\Hermes） ---------------- */
@@ -309,4 +427,46 @@ export interface ForeignImportResult {
    */
   credentialRefs: string[];
   counts: Record<string, number>;
+  /**
+   * 溯源块（进 bundle 的 manifest.foreign；缺省 = 不写 —— 旧行为逐字不变）。
+   * 由**翻译层**装配（只有它同时看得到位置、项目根与插件清单）。
+   */
+  origin?: ForeignOrigin;
+}
+
+/**
+ * 外部来源的**溯源块**（进 bundle 的 manifest.foreign，见 src/schema/types.ts）。
+ *
+ * 为什么必须有：标准 bundle v1 的 manifest 原本没有任何「这包从哪来」的字段，落盘后
+ * 包与 DSH 自产备份**逐字同构**（实测缺陷）—— 事后无法复核来源、兼容性评分也因
+ * source.dshVersion 被填成目标机版本而被构造性拉满。
+ *
+ * 三条纪律：
+ *  ① **只放标识与计数，绝不放值**（凭据引用只有名字；错误只有机器码）；
+ *  ② 绝对路径只允许出现在 projects[] 与 installPath 这类「用户自己机器的来源位置」上，
+ *     且**不得**写进任何分区载荷；
+ *  ③ 缺字段即「不知道」，绝不填默认值假装知道。
+ */
+export interface ForeignOrigin {
+  /** 来源 agent id（ForeignSourceId 的运行期字面量） */
+  source: string;
+  /** 实际读取的位置（相对 home 的 POSIX 路径；不含任何值） */
+  locations: string[];
+  /** 来源侧版本标记（如 Claude Code `~/.claude.json` 的 lastVersionBase；读不到即省略） */
+  sourceVersion?: string;
+  /** 被扫描的项目根绝对路径（仅溯源，供用户核对） */
+  projects?: string[];
+  /** 插件清单（名称 / 版本 / 市场 / 来源仓库 / ref / 组件种类；**不含凭据**） */
+  plugins?: {
+    name: string;
+    version?: string;
+    marketplace?: string;
+    repo?: string;
+    ref?: string;
+    components?: string[];
+  }[];
+  /** 跳过与诊断汇总（机器码 + 条数，**不含任何值**） */
+  skipped?: { code: string; count: number }[];
+  /** 需要用户在目标机补录的凭据引用名（只有名字） */
+  credentialRefs?: string[];
 }

package/src/index.facade.test.ts

@@ -140,7 +140,7 @@ test('install: bundle 包成功 → 不补 patch 行（reconcile 维护 bundles
   }
 });
 
-test('install: 非 registry spec（github:）→ add 按 spec 安装；registry 版本区间 → 裸包名（npm 最新）', async () => {
+test('install: 非 registry spec（github:）原样安装；registry 区间按「包名@spec」安装（issue #101）', async () => {
   const { homeDir, profileDir, cleanup } = makeTempProfile();
   try {
     writeInstalledPkg(profileDir, 'dsh-memory-evolve', '1.0.0');
@@ -153,13 +153,35 @@ test('install: 非 registry spec（github:）→ add 按 spec 安装；registry
     const facade = new DshPluginsFacade(homeDir, 'web', new MemPatchFile(), runner);
 
     await facade.install('dsh-memory-evolve', 'github:csyangwen/dsh-memory-evolve');
-    await facade.install('dshmarket', '^1.0.3');
+    await facade.install('dshmarket', 'dshmarket@^1.0.3');
     await facade.install('pkg-plain');
     assert.deepEqual(calls.map((c) => c.args), [
       ['add', 'github:csyangwen/dsh-memory-evolve'],
-      ['add', 'dshmarket'],
+      ['add', 'dshmarket@^1.0.3'],
       ['add', 'pkg-plain'],
-    ], 'github: 来源按 spec 安装；registry 版本区间与裸包名都走 npm 最新版');
+    ], 'github: 来源原样安装；registry 区间带包名（裸包名会被目标机既有 spec 挡住，issue #101）；缺省仍退化为裸包名');
+  } finally {
+    cleanup();
+  }
+});
+
+test('install: 精确版本 target 原样执行，并回读 node_modules 实际版本（issue #101 落地校验依据）', async () => {
+  const { homeDir, profileDir, cleanup } = makeTempProfile();
+  try {
+    writeInstalledPkg(profileDir, 'dsh-free-search', '0.9.3');
+    const calls: { args: string[] }[] = [];
+    const runner = async (_p: string, _profile: string, args: readonly string[]): Promise<DshPluginResult> => {
+      calls.push({ args: [...args] });
+      // 模拟 pnpm 真的按 target 装了备份记录的版本
+      writeInstalledPkg(profileDir, 'dsh-free-search', '0.9.5');
+      return okResult();
+    };
+    const facade = new DshPluginsFacade(homeDir, 'web', new MemPatchFile(), runner);
+
+    const r = await facade.install('dsh-free-search', 'dsh-free-search@0.9.5');
+    assert.deepEqual(calls[0]?.args, ['add', 'dsh-free-search@0.9.5'], '精确版本必须进 argv，不能退化成裸包名');
+    assert.equal(r.needsRestart, true);
+    assert.equal(r.installedVersion, '0.9.5', '回读安装后的真实版本，供 adapter 校验是否真的落地');
   } finally {
     cleanup();
   }

package/src/index.ts

@@ -81,13 +81,14 @@ import { msgOf, zhMsg } from './core/messages.ts'
 import { engineMsg, getEngineLocale, setEngineLanguageSource, setEngineLocale } from './core/engine-locale.ts'
 import { RollbackAutoTracker, RollbackPointEngine, ROLLBACK_POINTS_DIR_NAME, rollbackSessionBindingOf, rollbackTrackedEventOf } from './core/rollback-point.ts'
 import { ROLLBACK_ATTRIBUTION_FILE_NAME, RollbackWriteAttribution } from './core/rollback-attribution.ts'
+import { ROLLBACK_ACTIVITY_FILE_NAME, RollbackSessionActivity } from './core/rollback-activity.ts'
 import { isRollbackEnabled, onRollbackEnabledChange, setRollbackEnabled } from './core/rollback-gate.ts'
 import type { RollbackForkCarrier, RollbackRewindResult } from './core/rollback-point.ts'
 // t3：宿主斜杠命令 /rollback（与 HTTP 路由同一道写入门；命令服务惰取，未组合时安静跳过）。
 import { agentSessionFactsOf, registerRollbackCommand } from './core/command-rollback.ts'
 import type { CommandServiceLike, RollbackCommandHost } from './core/command-rollback.ts'
 import type { MsgFunc } from './core/messages.ts'
-import { cleanupAbortedInstall, hasDshBundlePatch, installAnchorFromProfileContext, installErrorFor, installSpecFor, listInstalledPlugins, profileNameFromProfileContext, resolveProcessProfileName, resolveProfileDir, readProfileManifest, runDshPlugin, validateProfileName } from './core/plugin-cli.ts'
+import { cleanupAbortedInstall, hasDshBundlePatch, installAnchorFromProfileContext, installErrorFor, readInstalledVersion, listInstalledPlugins, profileNameFromProfileContext, resolveProcessProfileName, resolveProfileDir, readProfileManifest, runDshPlugin, validateProfileName } from './core/plugin-cli.ts'
 import type { ConfigAdapter, CredentialsFacade, ExportUnit, FileSystemFacade, HostContext, ImportDecisions, ImportPlan, NamedNamespaceInfo, NamespaceInfo, PatchFileFacade, PlanItemKind, PluginInfo, PluginsFacade, SessionMoveResult, SessionParentRelation, SessionRewriteResult, SessionStoreFacade, SettingsFacade, SkillDefinitionView, SkillStoreFacade, SkillSummaryView, WorkspaceFacade } from './core/types.ts'
 import { ImportUserSkippedError } from './core/types.ts'
 import { PLUGIN_NPM_PACKAGE } from './core/update-check.ts'
@@ -132,8 +133,13 @@ import { DEFAULT_RETENTION_POLICY, selectPruneCandidatesByPolicy } from './sync/
 import type { RetentionPolicy } from './sync/retention-policy.ts'
 import type { PruneSelector } from './core/backup.ts'
 import { selectPruneCandidates } from './core/backup.ts'
-import { readAllAutosyncConfigs, readAutosyncConfig } from './sync/autosync-config.ts'
-import type { AutosyncInterval, AutosyncRunStatus } from './sync/autosync-config.ts'
+import {
+  readAllAutosyncConfigs, readAutosyncConfig, DEFAULT_AUTOSYNC_REALTIME, DEFAULT_AUTOSYNC_REMOTE_CHECK_MS,
+  DEFAULT_AUTOSYNC_AUTO_APPLY_TIER, DEFAULT_AUTOSYNC_CONFLICT_POLICY, lastRunFailureMessage,
+} from './sync/autosync-config.ts'
+import type {
+  AutosyncInterval, AutosyncRunStatus, AutosyncAutoApplyTier, AutosyncConflictPolicy,
+} from './sync/autosync-config.ts'
 import { appendAutosyncEntry } from './sync/sync-history.ts'
 import { MigrationStore, type MigrationKind, type MigrationResult, MIGRATION_HISTORY_DIR } from './core/migration-history.ts'
 import { readSyncConfig, validateRepoUrl, validateWebDavUrl, isWebDavConfig, isS3Config, isGistConfig, channelOf, parseSyncChannel, SYNC_CHANNELS, GIST_PROVIDER, isS3CompatProvider, validateCloudChannelInput, cloudSecretRef } from './sync/sync-config.ts'
@@ -181,7 +187,7 @@ export const name = 'config-manager'
 export const inject = ['settings', 'credentials']
 
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.78'
+export const PLUGIN_VERSION = '0.1.80'
 
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager'
@@ -246,7 +252,7 @@ export interface Config {
 /**
  * 本文件保留的 7 条路由的路径（被源码级守卫按文件窗口钉住，见下方 routesList 注释）。
  *
- * 其余 72 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
+ * 其余 75 条路由的路径**声明在各自的组文件里**（src/routes/*.ts 的 endpoint({ path, methods })）——
  * 新增一条 API 只需那一条声明，不再有「常量表 + 路由对象」两处要同步。
  */
 export const API = {
@@ -649,12 +655,13 @@ export class DshPluginsFacade implements PluginsFacade {
     return listInstalledPlugins(this.homeDir, this.profile)
   }
 
-  async install(pkg: string, spec?: string, signal?: AbortSignal): Promise<{ needsRestart: boolean }> {
+  async install(pkg: string, target?: string, signal?: AbortSignal): Promise<{ needsRestart: boolean; installedVersion?: string | null }> {
     const profileDir = resolveProfileDir(this.homeDir, this.profile)
-    // 非 registry 来源（github:/git+/file: 等）按来源 spec 安装；registry 包按裸包名装
-    // npm 最新版（官方机制）。spec 丢失（旧备份）时退化为裸包名 → pnpm fetch-404，
-    // 由 installErrorFor 给出可操作诊断。
-    const result = await this.runner(profileDir, this.profile, ['add', installSpecFor(pkg, spec)], undefined, signal)
+    // target 由调用方（adapters/plugins.ts 的 pluginInstallTarget）推导完毕，这里只执行：
+    // registry 包带精确版本或「包名@spec」，pnpm 才不会静默沿用目标机既有 spec（issue #101）。
+    // 缺省退化为裸包名（旧调用方）→ pnpm fetch-404，由 installErrorFor 给出可操作诊断。
+    const spec = target !== undefined && target !== '' ? target : pkg
+    const result = await this.runner(profileDir, this.profile, ['add', spec], undefined, signal)
     // 用户「跳过当前插件」：宿主 kill 了子进程 → 清理半装状态（删依赖行 + 删 node_modules/<pkg>，
     // 防止「package.json 声明了依赖但没装全」导致 DSH 启动失败），再以跳过语义抛错。
     if (result.aborted || (signal !== undefined && signal.aborted)) {
@@ -670,7 +677,8 @@ export class DshPluginsFacade implements PluginsFacade {
       const reason = error instanceof Error ? error.message : String(error)
       throw new Error(this.msg('host.activationRowFailed', { pkg, reason }))
     }
-    return { needsRestart: true }
+    // 回读实际落盘版本：调用方据此校验升级是否真的生效（issue #101），而不是只看子进程退出码。
+    return { needsRestart: true, installedVersion: readInstalledVersion(profileDir, pkg) }
   }
 }
 
@@ -2307,7 +2315,7 @@ export async function tryDecryptCredentials(
  * （见 W1 报告的重测配方），把结果落到这里；makeRoutes 里的 const routeEnv: RouteEnvInferred =
  * 注解保证两侧不漂移（新增依赖漏登记会在构造点报错）。
  */
-export type RouteEnvInferred = { sessionExportFetch: ((input: string, init: RequestInit) => Promise<Response>) | undefined; sessionExportPort: number | undefined; adapters: ConfigAdapter<unknown>[]; sessionHealth: { homeDir: string; targetFormatVersion: () => number | undefined; workspaceKeys: () => Promise<ReadonlySet<string>>; knownSessionIds: () => Promise<ReadonlySet<string>>; sessionMeta: (ids: readonly string[]) => Promise<SessionMetaIndex>; }; backupScheduler: BackupScheduler; bootSafetyAudit: () => Promise<BootSafetyReport>; cancelDecisionTimeoutMs: number; buildMarketSummary: (e: { url: string; addedAt: string; }) => Promise<MarketSummary>; credentials: CredentialProvider; dataDir: string; exportsDir: string; githubAuth: GitHubAuthClient; githubClientId: string | undefined; githubClientSecret: string | undefined; githubFlows: DeviceFlowStore; history: MigrationStore; host: ConfigManagerHostContext; itemCached: (url: string, itemId: string) => Promise<boolean>; knownSyncSectionIds: Set<SectionId>; makeImporter: () => Importer; makeMarketReader: () => GitMarketReader; makeRecoveryExecutors: (runId: string) => RecoveryExecutorFns; makeSyncEngine: (cfg: SyncConfig, engineOpts?: { optInSections?: readonly SectionId[]; }) => SyncEngine; marketBootAutoRefreshed: { value: boolean; }; marketCacheIndex: (url: string) => string; marketDir: string; marketCacheItemDir: (url: string) => string; marketStarCache: StarCache; marketWorkDir: (url: string) => string; meGitHubRest: GitHubAuthRest; meService: MyRepoService; meTokenProvider: () => Promise<string>; msg: MsgFunc; prepareSync: (body: Record<string, unknown>) => Promise<SyncConfig>; profileLauncher: DshProfileLauncher; profileRuntime: DshProfileRuntimeRegistry; profiles: DshProfileManager; pruneStagedMarketZips: () => Promise<void>; readCachedIndexObj: (url: string) => Promise<MarketIndex | null>; recoveryOrchestrator: RecoveryOrchestrator; resolveSyncPassword: (ref: string) => Promise<string | undefined>; roots: string[]; runAbortControllers: Map<string, AbortController>; runCancels: Map<string, { signal: AbortController; settle: (d: 'rollback' | 'keep') => void; decided: boolean }>; runs: RunRegistry; scheduler: AutoSyncScheduler; selectionCache: Partial<Record<SyncTransportType, SyncSelection>>; selectionOptInSections: (channel: SyncTransportType, onlyAuto?: boolean) => SectionId[]; selectionView: (channel: SyncTransportType) => Promise<SelectionView>; selectionViewByChannel: () => Promise<Record<SyncTransportType, SelectionView>>; snapshotEntrySections: (snapshotDir: string) => Promise<string[]>; snapshotsDir: string; syncCredentialsByChannelView: () => Promise<Record<SyncTransportType, { encryptPasswordConfigured: boolean; decryptPasswordConfigured: boolean; }>>; syncDir: string; syncPasswordConfigured: (ref: string) => Promise<boolean>; syncWorkDir: { inspect: (repoUrl: string) => Promise<{ facts: GitWorkDirFacts; } | { error: string; }>; rebuild: (repoUrl: string, mode: 'relink' | 'reclone') => Promise<GitWorkDirFacts>; }; syncSectionCatalog: { id: SectionId; displayName: string; portability: Portability; defaultIncluded: boolean; }[]; syncSessions: SyncSessionStore; tmpDir: string; tryAppendHistory: (raw: { kind: MigrationKind; result: MigrationResult; sections: string[]; operationId?: string; snapshotId?: string; runId?: string; source: 'api' | 'autosync' | 'backup-scheduler' | 'recovery' | 'cli' | 'internal'; summary: string; error?: string; }) => Promise<string | undefined>; withMutationGate: (op: string, handler: (req: IncomingMessage, res: ServerResponse, lockCtx?: MutationLockContext, journalCtx?: JournalRunContext) => Promise<void>, opts?: { journaled?: boolean; deferredSnapshot?: boolean; }) => ((req: IncomingMessage, res: ServerResponse) => Promise<void>); selfUpdate: (targetVersion: string) => Promise<SelfUpdateOutcome>; writeItemCache: (url: string, itemId: string, manifestRaw: string, zipBytes: Uint8Array) => Promise<void>; }
+export type RouteEnvInferred = { sessionExportFetch: ((input: string, init: RequestInit) => Promise<Response>) | undefined; sessionExportPort: number | undefined; adapters: ConfigAdapter<unknown>[]; sessionHealth: { homeDir: string; targetFormatVersion: () => number | undefined; workspaceKeys: () => Promise<ReadonlySet<string>>; knownSessionIds: () => Promise<ReadonlySet<string>>; sessionMeta: (ids: readonly string[]) => Promise<SessionMetaIndex>; }; backupScheduler: BackupScheduler; bootSafetyAudit: () => Promise<BootSafetyReport>; cancelDecisionTimeoutMs: number; buildMarketSummary: (e: { url: string; addedAt: string; }) => Promise<MarketSummary>; credentials: CredentialProvider; dataDir: string; exportsDir: string; githubAuth: GitHubAuthClient; githubClientId: string | undefined; githubClientSecret: string | undefined; githubFlows: DeviceFlowStore; history: MigrationStore; host: ConfigManagerHostContext; itemCached: (url: string, itemId: string) => Promise<boolean>; knownSyncSectionIds: Set<SectionId>; makeImporter: () => Importer; makeMarketReader: () => GitMarketReader; makeRecoveryExecutors: (runId: string) => RecoveryExecutorFns; makeSyncEngine: (cfg: SyncConfig, engineOpts?: { optInSections?: readonly SectionId[]; }) => SyncEngine; marketBootAutoRefreshed: { value: boolean; }; marketCacheIndex: (url: string) => string; marketDir: string; marketCacheItemDir: (url: string) => string; marketStarCache: StarCache; marketWorkDir: (url: string) => string; meGitHubRest: GitHubAuthRest; meService: MyRepoService; meTokenProvider: () => Promise<string>; msg: MsgFunc; prepareSync: (body: Record<string, unknown>) => Promise<SyncConfig>; profileLauncher: DshProfileLauncher; profileRuntime: DshProfileRuntimeRegistry; profiles: DshProfileManager; pruneStagedMarketZips: () => Promise<void>; readCachedIndexObj: (url: string) => Promise<MarketIndex | null>; recoveryOrchestrator: RecoveryOrchestrator; resolveSyncPassword: (ref: string) => Promise<string | undefined>; roots: string[]; runAbortControllers: Map<string, AbortController>; runCancels: Map<string, { signal: AbortController; settle: (d: 'rollback' | 'keep') => void; decided: boolean }>; runs: RunRegistry; scheduler: AutoSyncScheduler; selectionCache: Partial<Record<SyncTransportType, SyncSelection>>; selectionOptInSections: (channel: SyncTransportType, onlyAuto?: boolean) => SectionId[]; selectionView: (channel: SyncTransportType) => Promise<SelectionView>; selectionViewByChannel: () => Promise<Record<SyncTransportType, SelectionView>>; snapshotEntrySections: (snapshotDir: string) => Promise<string[]>; snapshotsDir: string; syncCredentialsByChannelView: () => Promise<Record<SyncTransportType, { encryptPasswordConfigured: boolean; decryptPasswordConfigured: boolean; }>>; syncDir: string; syncPasswordConfigured: (ref: string) => Promise<boolean>; syncWorkDir: { inspect: (repoUrl: string) => Promise<{ facts: GitWorkDirFacts; } | { error: string; }>; rebuild: (repoUrl: string, mode: 'relink' | 'adopt' | 'reclone') => Promise<GitWorkDirFacts>; }; syncSectionCatalog: { id: SectionId; displayName: string; portability: Portability; defaultIncluded: boolean; }[]; syncSessions: SyncSessionStore; tmpDir: string; tryAppendHistory: (raw: { kind: MigrationKind; result: MigrationResult; sections: string[]; operationId?: string; snapshotId?: string; runId?: string; source: 'api' | 'autosync' | 'backup-scheduler' | 'recovery' | 'cli' | 'internal'; summary: string; error?: string; }) => Promise<string | undefined>; withMutationGate: (op: string, handler: (req: IncomingMessage, res: ServerResponse, lockCtx?: MutationLockContext, journalCtx?: JournalRunContext) => Promise<void>, opts?: { journaled?: boolean; deferredSnapshot?: boolean; }) => ((req: IncomingMessage, res: ServerResponse) => Promise<void>); selfUpdate: (targetVersion: string) => Promise<SelfUpdateOutcome>; writeItemCache: (url: string, itemId: string, manifestRaw: string, zipBytes: Uint8Array) => Promise<void>; }
 
 /** 解密错误 → 用户可读文本：BAD_PASSWORD 只报「密码错误」（不泄内部细节），其余原文 */
 export function decryptErrorText(error: unknown, msg: MsgFunc): string {
@@ -2694,12 +2702,19 @@ export async function buildAutosyncStatus(dir: string, channel: SyncTransportTyp
   const elapsedMs = cfg.lastRunAt === undefined || cfg.lastRunAt === ''
     ? -1
     : Math.max(0, Date.now() - Date.parse(cfg.lastRunAt))
+  // issue #105：只有本轮真的失败才回传错误原文（success/skipped/partial 不得带上一轮的旧错误）
+  const failureMessage = lastRunFailureMessage(cfg)
   return {
     enabled: cfg.enabled,
     interval: cfg.interval,
+    // 真·自动同步三件套（缺省值在读取层已补齐，这里回传「生效中的值」）
+    realtime: cfg.realtime ?? DEFAULT_AUTOSYNC_REALTIME,
+    remoteCheckMs: cfg.remoteCheckMs ?? DEFAULT_AUTOSYNC_REMOTE_CHECK_MS,
+    autoApplyTier: cfg.autoApplyTier ?? DEFAULT_AUTOSYNC_AUTO_APPLY_TIER,
+    conflictPolicy: cfg.conflictPolicy ?? DEFAULT_AUTOSYNC_CONFLICT_POLICY,
     ...(cfg.lastRunAt !== undefined ? { lastRunAt: cfg.lastRunAt } : {}),
     ...(cfg.lastRunStatus !== undefined ? { lastRunStatus: cfg.lastRunStatus } : {}),
-    ...(cfg.lastRunMessage !== undefined ? { lastRunMessage: cfg.lastRunMessage } : {}),
+    ...(failureMessage !== undefined ? { lastRunMessage: failureMessage } : {}),
     // issue #79：跳过原因以**码**回传（界面本地化）；不再只留在 info 级日志里
     ...(cfg.lastRunSkipReason !== undefined ? { lastRunSkipReason: cfg.lastRunSkipReason } : {}),
     ...(cfg.lastRunSkipCount !== undefined ? { lastRunSkipCount: cfg.lastRunSkipCount } : {}),
@@ -2717,12 +2732,18 @@ export async function buildAutosyncStatusByChannel(dir: string): Promise<Record<
     const elapsedMs = cfg.lastRunAt === undefined || cfg.lastRunAt === ''
       ? -1
       : Math.max(0, Date.now() - Date.parse(cfg.lastRunAt))
+    // issue #105：同 buildAutosyncStatus —— 只有本轮失败才带错误原文
+    const failureMessage = lastRunFailureMessage(cfg)
     return {
       enabled: cfg.enabled,
       interval: cfg.interval,
+      realtime: cfg.realtime ?? DEFAULT_AUTOSYNC_REALTIME,
+      remoteCheckMs: cfg.remoteCheckMs ?? DEFAULT_AUTOSYNC_REMOTE_CHECK_MS,
+      autoApplyTier: cfg.autoApplyTier ?? DEFAULT_AUTOSYNC_AUTO_APPLY_TIER,
+      conflictPolicy: cfg.conflictPolicy ?? DEFAULT_AUTOSYNC_CONFLICT_POLICY,
       ...(cfg.lastRunAt !== undefined ? { lastRunAt: cfg.lastRunAt } : {}),
       ...(cfg.lastRunStatus !== undefined ? { lastRunStatus: cfg.lastRunStatus } : {}),
-      ...(cfg.lastRunMessage !== undefined ? { lastRunMessage: cfg.lastRunMessage } : {}),
+      ...(failureMessage !== undefined ? { lastRunMessage: failureMessage } : {}),
       ...(cfg.lastRunSkipReason !== undefined ? { lastRunSkipReason: cfg.lastRunSkipReason } : {}),
       ...(cfg.lastRunSkipCount !== undefined ? { lastRunSkipCount: cfg.lastRunSkipCount } : {}),
       consecutiveFailures: cfg.consecutiveFailures,
@@ -2740,6 +2761,14 @@ export async function buildAutosyncStatusByChannel(dir: string): Promise<Record<
 interface AutosyncStatusResponse {
   enabled: boolean
   interval: AutosyncInterval
+  /** 真·自动同步：本地改动即时触发（缺省 true） */
+  realtime: boolean
+  /** realtime 下的远端轮询间隔（ms） */
+  remoteCheckMs: number
+  /** 自动应用的最高风险等级（缺省 medium：plugins/mcp 也自动落盘） */
+  autoApplyTier: AutosyncAutoApplyTier
+  /** 双侧都改时的策略（缺省 local：保留本机并推上去） */
+  conflictPolicy: AutosyncConflictPolicy
   lastRunAt?: string
   lastRunStatus?: AutosyncRunStatus
   lastRunMessage?: string
@@ -3598,6 +3627,10 @@ function makeRoutes(deps: RoutesDeps): { routes: WebRoute[]; scheduler: AutoSync
     mutationLock: host.mutationLock,
     isBlocked: () => host.safeModeIsBlocked?.() ?? false,
     phase3Recovery: host.phase3Recovery,
+    // 真·自动同步：本地配置文件监听（realtime 通道）以 $DSH_HOME 为基准；
+    // 监听清单由 sync/watch-scope.ts 静态派生，已排除 sessions/ 与调度器自写文件（避免自激）。
+    homeDir: host.homeDir,
+    ...(host.profile === undefined ? {} : { profile: host.profile }),
     // Phase 6：autosync 既写 sync-history.json（既有语义），也写统一迁移历史（COMPLETE 不变量）。
     appendHistoryFn: async (entry) => {
       await appendAutosyncEntry(syncDir, entry).catch(() => undefined)
@@ -3775,7 +3808,13 @@ function makeRoutes(deps: RoutesDeps): { routes: WebRoute[]; scheduler: AutoSync
       const port = host.mutationLock as EnvironmentLockManager | undefined
       if (port === undefined) return { state: 'FREE' }
       const insp = await port.inspectLockState()
-      return { state: insp.state, ...(insp.detail !== undefined ? { detail: insp.detail } : {}) }
+      // ownerInstanceId 只给编排器做 journal↔锁归属匹配（判定「正在跑」vs「残留事故」），
+      // 不进任何 HTTP 响应体（编排器只消费不回传）。
+      return {
+        state: insp.state,
+        ...(insp.detail !== undefined ? { detail: insp.detail } : {}),
+        ...(insp.ownerInstanceId !== undefined ? { ownerInstanceId: insp.ownerInstanceId } : {}),
+      }
     },
     recoverStaleLock: async () => {
       const port = host.mutationLock as EnvironmentLockManager | undefined
@@ -3892,13 +3931,17 @@ function makeRoutes(deps: RoutesDeps): { routes: WebRoute[]; scheduler: AutoSync
         // 也不伪装成「工作副本不存在」。
         inspect: async (repoUrl: string): Promise<{ facts: GitWorkDirFacts } | { error: string }> => {
           try {
-            return { facts: await makeGitTransport(repoUrl).inspectWorkDir() }
+            // issue #104 建议 3：`/sync/status` 要回传「领先远端提交数 / 远端快照数」，
+            // 用户看不见积压，就会在「以为在备份」的状态下一直失败。detail 多出的几条命令
+            // 都是本地只读（rev-list / status / ls-tree），不发网络请求。
+            return { facts: await makeGitTransport(repoUrl).inspectWorkDir({ detail: true }) }
           } catch (err) {
             return { error: err instanceof Error ? err.message : String(err) }
           }
         },
-        // 重建：relink 非破坏；reclone 删目录重克隆（调用方必须先取得用户确认）
-        rebuild: async (repoUrl: string, mode: 'relink' | 'reclone'): Promise<GitWorkDirFacts> => {
+        // 重建：relink 非破坏；adopt 合并远端历史（不改写本地提交，issue #104）；
+        // reclone 删目录重克隆（调用方必须先取得用户确认）
+        rebuild: async (repoUrl: string, mode: 'relink' | 'adopt' | 'reclone'): Promise<GitWorkDirFacts> => {
           const transport = makeGitTransport(repoUrl)
           await transport.rebuildWorkDir(mode)
           return await transport.inspectWorkDir()
@@ -3931,7 +3974,7 @@ function makeRoutes(deps: RoutesDeps): { routes: WebRoute[]; scheduler: AutoSync
   /**
    * 路由表：本文件只保留被源码级守卫按**文件窗口**钉住的 7 条（host-entry 审计 F-04 记录的
    * tests/host/**、src/core/model-tools.test.ts、src/core/phase1-wiring.test.ts 的窗口断言）。
-   * 其余 72 条已按域拆到 src/routes/*.ts，由 buildRoutes 组装。
+   * 其余 75 条已按域拆到 src/routes/*.ts，由 buildRoutes 组装。
    * 注册顺序不影响匹配：命名路由必须互不相同（webServer 契约）。
    */
   const routeEnv: RouteEnvInferred = makeRouteEnv()
@@ -4753,11 +4796,21 @@ export function apply(ctx: Context, config?: Config): void {
     warn: (line) => host.log.warn(line),
   })
   void rollbackAttribution.load()
+  // 会话活跃时间窗（2026-10-18）：**每个 session/event 都记一次**活跃 —— 与工具参数无关，
+  // 因此 bash / 脚本 / 外部编辑器写出的路径也能按「文件 mtime 落在谁的活跃窗口内」判定归属；
+  // 落在**谁都不活跃**的时刻 = 手改 / 外部工具 ⇒ 回退零写入并如实报 unclaimed（绝不静默覆盖）。
+  // 同样是 best-effort：读写失败只 warn，退化成「没有时间证据」（回退行为与加它之前逐字一致）。
+  const rollbackActivity = new RollbackSessionActivity({
+    file: path.join(dataDir, ROLLBACK_POINTS_DIR_NAME, ROLLBACK_ACTIVITY_FILE_NAME),
+    warn: (line) => host.log.warn(line),
+  })
+  void rollbackActivity.load()
   const rollbackEngine = new RollbackPointEngine({
     dataDir,
     homeDir,
     log: (line) => host.log.warn(line),
     attribution: rollbackAttribution,
+    activity: rollbackActivity,
     fork: async ({ sessionId, boundarySeq }) => {
       const forkSession = forkPort.forkSession
       if (typeof forkSession !== 'function') {
@@ -4780,6 +4833,7 @@ export function apply(ctx: Context, config?: Config): void {
     engine: rollbackEngine,
     log: (line) => host.log.warn(line),
     attribution: rollbackAttribution,
+    activity: rollbackActivity,
   })
   ctx.effect(() => {
     let chain: Promise<unknown> = Promise.resolve()
@@ -4855,6 +4909,9 @@ export function apply(ctx: Context, config?: Config): void {
       unlisten()
       detach()
       rollbackTracker.stop()
+      // 卸载时把**未落盘**的活跃窗口刷下去（debounce 里可能还有几条）：丢了它，
+      // 下次启动就少一段「谁在什么时候活跃」的证据 —— 归属会因此退回「未判定」。
+      void rollbackActivity.dispose()
     }
   }, 'config-manager: rollback auto points')
   // ------------------------------------------- 宿主斜杠命令 /rollback（t3）

package/src/market/git-file-writer.test.ts

@@ -98,6 +98,10 @@ test('git-file-writer: clone + 写文件 + commit + push（默认分支），凭
   const pushCall = calls[calls.length - 1]!;
   assert.deepEqual(pushCall.args.slice(pushCall.args.length - 4), ['push', '-u', 'origin', 'HEAD']);
   assert.ok(pushCall.args.some((a) => a.startsWith('credential.helper=store --file=')), 'push 必须注入 credential helper');
+  // issue #103：store 以 username 作查找键，只清 helper 不钉 username 会被全局 .gitconfig 顶掉
+  for (const call of [cloneCall, pushCall]) {
+    assert.ok(call.args.includes('credential.username=oauth2'), 'clone/push 必须钉住 credential.username（与 store 文件同源）');
+  }
   // commit message 原样传递
   const commitCall = calls.find((c) => gitCommandOf(c) === 'commit')!;
   assert.ok(commitCall.args.includes('publish: add my-config v1.0.0'));

package/src/market/git-file-writer.ts

@@ -256,7 +256,13 @@ export class GitFileWriterClient implements GitFileWriter {
     const fileArg = quoteGitValue(credFile.replace(/\\/g, '/'));
     await atomicWriteFile(credFile, `https://${this.credentialUsername}:${token}@github.com\n`, { mode: 0o600, symlink: 'reject' });
     return {
-      extraArgs: ['-c', 'credential.helper=', '-c', `credential.helper=store --file=${fileArg}`],
+      // issue #103：同 git-transport.buildCredentialArgs —— store 用 username 作查找键，
+      // 不钉住就会被全局 `.gitconfig` 的 `credential.<url>.username` 顶掉而查不到口令。
+      extraArgs: [
+        '-c', 'credential.helper=',
+        '-c', `credential.helper=store --file=${fileArg}`,
+        '-c', `credential.username=${this.credentialUsername}`,
+      ],
       cleanup: async () => { await fs.rm(tmpDir, { recursive: true, force: true }); },
     };
   }

package/src/profiles/dsh-profile-launcher.test.ts

@@ -10,13 +10,13 @@
  */
 import test from 'node:test'
 import assert from 'node:assert/strict'
-import { mkdtempSync, rmSync } from 'node:fs'
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 
 import {
-  DshProfileLauncher, buildLaunchArgs, logTail, parseLaunchUrl, parseLaunches, pickFreePortCandidates,
-  serializeLaunches,
+  DshProfileLauncher, buildLaunchArgs, findCliEntryForShim, logTail, parseLaunchUrl, parseLaunches,
+  pickFreePortCandidates, resolveDirectCliRunner, serializeLaunches,
   type DshCliCommand, type DshProfileLauncherDeps,
 } from './dsh-profile-launcher.ts'
 import { DshProfileError } from './dsh-profile-manager.ts'
@@ -376,3 +376,68 @@ test('stop：怎么都杀不掉 → stopFailed（附 pid）且记录保留（用
     assert.deepEqual(parseLaunches(h.state()).map((r) => r.name), ['work'], '杀不掉就不能清记录（否则 UI 显示「已停止」而进程还在）')
   } finally { h.cleanup() }
 })
+
+/**
+ * 真机根因（Windows）：启动器原先直接跑 PATH 上的 `dsh.cmd`，参数里带 `detached: true` ——
+ * 中间多一层 cmd.exe 后，孙进程（真正常驻的 node）的 stdout/stderr **全部丢失**，
+ * 日志文件恒 0 字节，于是永远读不到 `dsh web: <带 token 的 URL>`。
+ * 修法 = 从 .cmd 反解真正的 bin.js 直启；下面钉住反解的两条真实布局。
+ */
+function makeShimTree(binLayout: 'sibling' | 'parent' | 'embedded-parent'): { root: string; shim: string; entry: string; cleanup: () => void } {
+  const root = mkdtempSync(join(tmpdir(), 'dsh-shim-'))
+  const prefix = binLayout === 'sibling' ? root : join(root, 'bin')
+  mkdirSync(prefix, { recursive: true })
+  const pkgRoot = join(root, 'node_modules', '@deepseek-ai', 'dsh')
+  mkdirSync(join(pkgRoot, 'lib'), { recursive: true })
+  writeFileSync(join(pkgRoot, 'package.json'), JSON.stringify({ name: '@deepseek-ai/dsh' }))
+  const entry = join(pkgRoot, 'lib', 'bin.js')
+  writeFileSync(entry, '// dsh cli\n')
+  const shim = join(prefix, 'dsh.cmd')
+  if (binLayout === 'sibling') writeFileSync(shim, '"%_prog%" "%dp0%\\node_modules\\@deepseek-ai\\dsh\\lib\\bin.js" %*\r\n')
+  else writeFileSync(shim, '"%_prog%" "%dp0%\\..\\node_modules\\@deepseek-ai\\dsh\\lib\\bin.js" %*\r\n')
+  return { root, shim, entry, cleanup: () => { rmSync(root, { recursive: true, force: true }) } }
+}
+
+test('findCliEntryForShim：npm 全局布局（node_modules 与 shim 同目录）能反解出 bin.js', () => {
+  const tree = makeShimTree('sibling')
+  try {
+    assert.equal(findCliEntryForShim(tree.shim), tree.entry)
+  } finally { tree.cleanup() }
+})
+
+test('findCliEntryForShim：shim 在 bin/ 子目录、内嵌路径带 ..\\ → 仍能反解（否则会退回 shell 包装脚本，日志恒空）', () => {
+  const tree = makeShimTree('embedded-parent')
+  try {
+    assert.equal(findCliEntryForShim(tree.shim), tree.entry)
+  } finally { tree.cleanup() }
+})
+
+test('findCliEntryForShim：找不到 dsh 入口 → null（调用方退回包装脚本，并由 warn urlNotFound 如实告知）', () => {
+  const root = mkdtempSync(join(tmpdir(), 'dsh-shim-none-'))
+  try {
+    const shim = join(root, 'dsh.cmd')
+    writeFileSync(shim, '"%_prog%" "%dp0%\\somewhere\\else.js" %*\r\n')
+    assert.equal(findCliEntryForShim(shim), null)
+    assert.equal(findCliEntryForShim(join(root, 'missing.cmd')), null, '脚本读不到也不得抛')
+  } finally { rmSync(root, { recursive: true, force: true }) }
+})
+
+test('resolveDirectCliRunner：宿主是 Electron 时以 ELECTRON_RUN_AS_NODE=1 直启 bin.js，普通 node 不带该变量', () => {
+  assert.deepEqual(resolveDirectCliRunner({ electron: '30.0.0' }), {
+    command: process.execPath,
+    env: { ELECTRON_RUN_AS_NODE: '1' },
+  })
+  assert.deepEqual(resolveDirectCliRunner({ node: '24.13.0' }), { command: process.execPath })
+})
+
+test('launch：CLI 解析成「直启 bin.js」时，spawn 不得带 shell（中间 cmd 层 + detached 会丢 stdio）', async () => {
+  const h = makeHarness({
+    cli: { command: 'C:/node/node.exe', prefixArgs: ['C:/dsh/lib/bin.js'], shell: false },
+    log: 'dsh web: http://127.0.0.1:3099/?token=abc',
+  })
+  try {
+    const result = await h.launcher.launch({ name: 'work', shape: 'web', openBrowser: false })
+    assert.equal(result.url, 'http://127.0.0.1:3099/?token=abc')
+    assert.deepEqual(result.warnings, [])
+  } finally { h.cleanup() }
+})