@noob-stupid/dsh-plugin-console 0.5.30 → 0.5.31

package/README.md

@@ -66,7 +66,7 @@
 dsh plugin --profile web add @noob-stupid/dsh-plugin-console
 
 # or install from GitHub source (needs git; allowBuilds authorization on first add)
-dsh plugin --profile web add github:Noob-stupid/dsh-plugin-hub
+dsh plugin --profile web add github:Noob-stupid/dsh-plugin-gating-hub
 ```
 
 Then restart the dsh service → refresh the page → **Settings → Plugins → Plugin Console**.
@@ -78,13 +78,13 @@ Then restart the dsh service → refresh the page → **Settings → Plugins →
 Windows (PowerShell):
 
 ```powershell
-git clone https://github.com/Noob-stupid/dsh-plugin-hub "$env:TEMP\dsh-plugin-console" 2>$null; & "$env:TEMP\dsh-plugin-console\deploy.ps1"
+git clone https://github.com/Noob-stupid/dsh-plugin-gating-hub "$env:TEMP\dsh-plugin-console" 2>$null; & "$env:TEMP\dsh-plugin-console\deploy.ps1"
 ```
 
 Linux / macOS:
 
 ```bash
-git clone https://github.com/Noob-stupid/dsh-plugin-hub /tmp/dsh-plugin-console 2>/dev/null; bash /tmp/dsh-plugin-console/deploy.sh
+git clone https://github.com/Noob-stupid/dsh-plugin-gating-hub /tmp/dsh-plugin-console 2>/dev/null; bash /tmp/dsh-plugin-console/deploy.sh
 ```
 
 The script copies the plugin into `$DSH_HOME/profiles/<profile>/node_modules/` and
@@ -96,7 +96,7 @@ idempotently appends an enable entry to `cordis.patch.yml`. Afterwards:
 
 ### Option 3: hand it to an AI in one sentence
 
-> Install the DSH plugin hub (dsh-plugin-hub): run `dsh plugin --profile web add @noob-stupid/dsh-plugin-console` (npm release); if there is no dsh CLI, clone https://github.com/Noob-stupid/dsh-plugin-hub to `~/.dsh/profiles/web/node_modules/` and register it in `cordis.patch.yml` (id: plugin-console, name: @noob-stupid/dsh-plugin-console). Restart dsh web afterwards.
+> Install the DSH plugin hub (dsh-plugin-hub): run `dsh plugin --profile web add @noob-stupid/dsh-plugin-console` (npm release); if there is no dsh CLI, clone https://github.com/Noob-stupid/dsh-plugin-gating-hub to `~/.dsh/profiles/web/node_modules/` and register it in `cordis.patch.yml` (id: plugin-console, name: @noob-stupid/dsh-plugin-console). Restart dsh web afterwards.
 
 Requires: DSH ≥ 0.1.0-rc.6 (web profile, with `dsh-client-modules` / `dsh-host-plugin-inventory`).
 
@@ -384,7 +384,7 @@ If this panel saves you time or makes DSH more fun to use:
 - ⭐ **Star this repo** — it directly helps more DSH users find it;
 - Share it with DSH users or in DSH communities;
 - Submit your own plugin (tag it `dsh-plugin`) to grow the ecosystem;
-- Found a bug or want a feature? [Open an issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues).
+- Found a bug or want a feature? [Open an issue](https://github.com/Noob-stupid/dsh-plugin-gating-hub/issues).
 
 ---
 
@@ -395,7 +395,7 @@ Contributions of all kinds are welcome — issues, PRs, docs, translations.
 - **Guidelines**: [CONTRIBUTING.md](CONTRIBUTING.md)
 - **Code of Conduct**: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
 - **Security policy**: [SECURITY.md](SECURITY.md) (report vulnerabilities privately)
-- **Issue templates**: bug reports & feature requests via the [new issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues/new/choose) page
+- **Issue templates**: bug reports & feature requests via the [new issue](https://github.com/Noob-stupid/dsh-plugin-gating-hub/issues/new/choose) page
 
 ---
 
@@ -420,4 +420,4 @@ The layered-refactor preview lives in its **own repository**: [**`Noob-stupid/ds
 - **What it is**: the monolithic `lib/index.js` (8547 lines) split into layers — `lib/index.js` **141 lines** + `lib/server/**` **38 modules**; **feature-equivalent to `0.3.57`**, maintainability only;
 - **Verified**: 19 test suites green · 8 architecture-guard assertions · **route inventory identical** (`status` + response fields) against the stable build;
 - **Not yet exercised**: real framework upgrade / rollback, restart guardian, component start/stop, real AI run, Gitee OAuth (~10–25% long-tail risk, subjective);
-- **For everyday use** stick to npm `@noob-stupid/dsh-plugin-console@0.3.67`, or `main` of this repo.
+- **For everyday use** stick to the **latest npm release** of `@noob-stupid/dsh-plugin-console` (`npm view @noob-stupid/dsh-plugin-console version`), or `main` of this repo.

package/README.zh.md

@@ -45,7 +45,7 @@
 dsh plugin --profile web add @noob-stupid/dsh-plugin-console
 
 # 或直接装 GitHub 源码（需 git，首次需 allowBuilds 授权）
-dsh plugin --profile web add github:Noob-stupid/dsh-plugin-hub
+dsh plugin --profile web add github:Noob-stupid/dsh-plugin-gating-hub
 ```
 
 然后重启 dsh 服务 → 刷新页面 → **设置 → 插件 → 插件控制台**。
@@ -57,13 +57,13 @@ dsh plugin --profile web add github:Noob-stupid/dsh-plugin-hub
 Windows（PowerShell）：
 
 ```powershell
-git clone https://github.com/Noob-stupid/dsh-plugin-hub "$env:TEMP\dsh-plugin-console" 2>$null; & "$env:TEMP\dsh-plugin-console\deploy.ps1"
+git clone https://github.com/Noob-stupid/dsh-plugin-gating-hub "$env:TEMP\dsh-plugin-console" 2>$null; & "$env:TEMP\dsh-plugin-console\deploy.ps1"
 ```
 
 Linux / macOS：
 
 ```bash
-git clone https://github.com/Noob-stupid/dsh-plugin-hub /tmp/dsh-plugin-console 2>/dev/null; bash /tmp/dsh-plugin-console/deploy.sh
+git clone https://github.com/Noob-stupid/dsh-plugin-gating-hub /tmp/dsh-plugin-console 2>/dev/null; bash /tmp/dsh-plugin-console/deploy.sh
 ```
 
 脚本会做两件事：把插件包拷进 `$DSH_HOME/profiles/<profile>/node_modules/`，
@@ -74,7 +74,7 @@ git clone https://github.com/Noob-stupid/dsh-plugin-hub /tmp/dsh-plugin-console
 
 ### 方式三：一句话交给 AI
 
-> 安装 DSH 插件中心（dsh-plugin-hub）：运行 `dsh plugin --profile web add @noob-stupid/dsh-plugin-console`（npm 发布版）；若没有 dsh CLI，则克隆 https://github.com/Noob-stupid/dsh-plugin-hub 到 `~/.dsh/profiles/web/node_modules/`，在 `cordis.patch.yml` 注册（id: plugin-console，name: @noob-stupid/dsh-plugin-console）。完成后重启 dsh web。
+> 安装 DSH 插件中心（dsh-plugin-hub）：运行 `dsh plugin --profile web add @noob-stupid/dsh-plugin-console`（npm 发布版）；若没有 dsh CLI，则克隆 https://github.com/Noob-stupid/dsh-plugin-gating-hub 到 `~/.dsh/profiles/web/node_modules/`，在 `cordis.patch.yml` 注册（id: plugin-console，name: @noob-stupid/dsh-plugin-console）。完成后重启 dsh web。
 
 要求：DSH ≥ 0.1.0-rc.6（web profile，含 `dsh-client-modules` / `dsh-host-plugin-inventory`）。
 
@@ -287,7 +287,7 @@ git clone https://github.com/Noob-stupid/dsh-plugin-hub /tmp/dsh-plugin-console
 
 ## 帮助 / Help
 
-遇到问题先看这里；仍有疑问请到 [议题](https://github.com/Noob-stupid/dsh-plugin-hub/issues) 提问。
+遇到问题先看这里；仍有疑问请到 [议题](https://github.com/Noob-stupid/dsh-plugin-gating-hub/issues) 提问。
 
 - **面板没出现**：重启 dsh 服务 → 刷新页面 → 设置 → 插件 → 插件管理。
 - **点开关没反应**：基础设施行带"受保护"标签（禁止开关，这是保护机制）；普通插件开关经
@@ -318,7 +318,7 @@ git clone https://github.com/Noob-stupid/dsh-plugin-hub /tmp/dsh-plugin-console
 - ⭐ **给本仓库点个 Star**——直接帮助更多 DSH 用户发现它；
 - 分享给身边的 DSH 用户或社区；
 - 提交你自己的插件（打上 `dsh-plugin` 标签）一起壮大生态；
-- 发现 bug 或有新需求？[开一个 Issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues)。
+- 发现 bug 或有新需求？[开一个 Issue](https://github.com/Noob-stupid/dsh-plugin-gating-hub/issues)。
 
 ---
 
@@ -329,7 +329,7 @@ git clone https://github.com/Noob-stupid/dsh-plugin-hub /tmp/dsh-plugin-console
 - **贡献指南**：[CONTRIBUTING.md](CONTRIBUTING.md)
 - **行为准则**：[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
 - **安全政策**：[SECURITY.md](SECURITY.md)（漏洞私下报告）
-- **Issue 模板**：从 [新建 Issue](https://github.com/Noob-stupid/dsh-plugin-hub/issues/new/choose) 页面选择 Bug / 功能建议
+- **Issue 模板**：从 [新建 Issue](https://github.com/Noob-stupid/dsh-plugin-gating-hub/issues/new/choose) 页面选择 Bug / 功能建议
 
 ---
 
@@ -355,5 +355,5 @@ MIT
 - **已验证**：19 套测试全绿 · 8 条架构守卫断言 · 与稳定版逐条对打**路由清单一致**（`status` + 响应字段）；
 - **已实测**（2026-09-20 真装真卸演练）：普通插件 / bundle 插件 / 无 npm 仓库 / 套装 / 技能 / 聚合仓库子包 / 仓库落地 / 服务器组件启停；
 - **尚未实测**：真框架升级 / 真回滚、重启守护链路、AI 真跑、Gitee OAuth 回调（长尾风险主观估计 **10%~25%**）；
-- **日常使用请继续用**：npm `@noob-stupid/dsh-plugin-console@0.3.67`，或本仓库 `main`。
+- **日常使用请继续用**：npm `@noob-stupid/dsh-plugin-console` 的**最新发布版**（`npm view @noob-stupid/dsh-plugin-console version`），或本仓库 `main`。
 - 请多反馈问题

package/SECURITY.md

@@ -1,6 +1,6 @@
 # 安全政策 Security Policy
 
-本文件说明 `@noob-stupid/dsh-plugin-console`（仓库 [Noob-stupid/dsh-plugin-hub](https://github.com/Noob-stupid/dsh-plugin-hub)）的安全政策：这个插件**能做什么**（能力清单）、已内置哪些护栏、自动化静态扫描容易误报的地方，以及如何报告漏洞。
+本文件说明 `@noob-stupid/dsh-plugin-console`（仓库 [Noob-stupid/dsh-plugin-gating-hub](https://github.com/Noob-stupid/dsh-plugin-gating-hub)）的安全政策：这个插件**能做什么**（能力清单）、已内置哪些护栏、自动化静态扫描容易误报的地方，以及如何报告漏洞。
 
 英文能力摘要见文末 [Capability summary (English)](#capability-summary-english)。
 
@@ -15,7 +15,7 @@
 
 **请勿在公开 Issue 中披露安全漏洞**。请通过以下方式私下报告：
 
-1. 通过 GitHub 的 [Security Advisory](https://github.com/Noob-stupid/dsh-plugin-hub/security/advisories/new)（推荐，私密）
+1. 通过 GitHub 的 [Security Advisory](https://github.com/Noob-stupid/dsh-plugin-gating-hub/security/advisories/new)（推荐，私密）
 2. 或给仓库 owner 发 GitHub 私信
 
 请在报告中包含：

package/lib/client.js

@@ -500,7 +500,7 @@ window.__ModuleLoader__.load({
 			archiveSourcesDesc: "git 协议拉不动时的替代通道：直接用 HTTP 下载仓库压缩包再解压建仓（真机实测同一镜像下 archive 4 MB/s、git 协议 0 B/s）。模板用 {owner}/{repo} 占位符，可选 {branch}；主源优先，失败自动回退下一个。示例：https://ghproxy.net/https://github.com/{owner}/{repo}/archive/refs/heads/{branch}.tar.gz",
 			archiveUrlPlaceholder: "https://ghproxy.net/https://github.com/{owner}/{repo}/archive/refs/heads/{branch}.tar.gz",
 			addArchiveSource: "添加 archive 源",
-			gitSourcesDesc: "克隆仓库时用的地址模板（{owner}/{repo} 占位符）。下面这个列表就是「自定义 Git 源」——内置两条是默认值，点「添加 Git 源」即可换成你自己的：Gitee = https://gitee.com/{owner}/{repo}.git；GitLab = https://gitlab.com/{owner}/{repo}.git；自建 Gitea = https://你的域名/{owner}/{repo}.git；镜像代理 = https://镜像站/https://github.com/{owner}/{repo}.git；本地裸仓库 = file:///D:/repos/{owner}/{repo}.git。主源优先，失败自动回退下一个",
+			gitSourcesDesc: "克隆仓库时用的地址模板（{owner}/{repo} 占位符）。下面这个列表就是「自定义 Git 源」——内置两条是默认值，点「添加 Git 源」即可换成你自己的：Gitee = https://gitee.com/{owner}/{repo}.git；GitLab = https://gitlab.com/{owner}/{repo}.git；自建 Gitea = https://你的域名/{owner}/{repo}.git；镜像代理 = https://镜像站/https://github.com/{owner}/{repo}.git；本地裸仓库 = file:///C:/repos/{owner}/{repo}.git。主源优先，失败自动回退下一个",
 			addGitSource: "添加 Git 源",
 			gitUrlPlaceholder: "如 https://gitee.com/{owner}/{repo}.git",
 			gitSourceBtn: "Git 源",
@@ -1050,7 +1050,7 @@ window.__ModuleLoader__.load({
 			archiveSourcesDesc: "Fallback transport when the git protocol cannot move data: download the repo tarball over plain HTTP, extract, and create a repo from it (measured: on the same mirror archive ran at 4 MB/s while git moved 0 B/s). Templates use {owner}/{repo}, optionally {branch}; primary first, falls back on failure.",
 			archiveUrlPlaceholder: "https://ghproxy.net/https://github.com/{owner}/{repo}/archive/refs/heads/{branch}.tar.gz",
 			addArchiveSource: "Add archive source",
-			gitSourcesDesc: "URL template for cloning ({owner}/{repo} placeholders). This list IS the custom git-source list — the two built-ins are just defaults; click Add git source to swap in your own: Gitee = https://gitee.com/{owner}/{repo}.git; GitLab = https://gitlab.com/{owner}/{repo}.git; self-hosted Gitea = https://your-domain/{owner}/{repo}.git; mirror proxy = https://mirror/https://github.com/{owner}/{repo}.git; local bare repo = file:///D:/repos/{owner}/{repo}.git. Primary first, falls back on failure",
+			gitSourcesDesc: "URL template for cloning ({owner}/{repo} placeholders). This list IS the custom git-source list — the two built-ins are just defaults; click Add git source to swap in your own: Gitee = https://gitee.com/{owner}/{repo}.git; GitLab = https://gitlab.com/{owner}/{repo}.git; self-hosted Gitea = https://your-domain/{owner}/{repo}.git; mirror proxy = https://mirror/https://github.com/{owner}/{repo}.git; local bare repo = file:///C:/repos/{owner}/{repo}.git. Primary first, falls back on failure",
 			addGitSource: "Add Git source",
 			gitUrlPlaceholder: "e.g. https://gitee.com/{owner}/{repo}.git",
 			gitSourceBtn: "Git sources",

package/lib/index.js

@@ -1,141 +1,141 @@
-/**
- * @deepseek-ai/dsh-plugin-console — 插件控制台宿主端。
- *
- * 提供环回 HTTP 路由（前缀 /plugin-console）：
- *   GET  /plugin-console/state    当前插件清单 + 用户补丁层状态
- *   POST /plugin-console/toggle   一键启用/停用插件（写 cordis.patch.yml，HMR 生效）
- *   POST /plugin-console/search   GitHub 仓库搜索（dsh-plugin 相关）
- *   POST /plugin-console/repo     读取仓库的 package.json，判断是否可安装
- *   POST /plugin-console/install  安装 npm 包（或 git 仓库）并追加启用条目
- *
- * 插件开关的机制：用户补丁层 cordis.patch.yml 是逐键覆盖（id-targeted patch），
- * 追加 `- id: X` + `disabled: true` 即可停用任意行（含 bundle 行与用户 insert 行），
- * 移除该块即恢复；HMR 监视器会自动重组合，无需重启。
- */
-import { readFile, writeFile } from 'node:fs/promises'
-import { readFileSync, writeFileSync, existsSync, statSync, rmSync, readdirSync, mkdirSync, copyFileSync, realpathSync } from 'node:fs'
-import { execFile, spawn } from 'node:child_process'
-import { promisify } from 'node:util'
-import { dirname, join, basename, sep } from 'node:path'
-import { tmpdir, homedir } from 'node:os'
-import { fileURLToPath, pathToFileURL } from 'node:url'
-import { createRequire } from 'node:module'
-import { request as httpsRequest } from 'node:https'
-import { aiJobsFile, componentsFile, dshHome, entryPkgMeta, findPatchPath, marketIndexCacheFile, packageNameOf, pluginRoot, profileDirOf, repoLandConfFile, resolvePackageJson, rowIdOf } from './server/infra/paths.js'
-import { isFrameworkVersionNewer, parseFrameworkVersion, semverRangeMatch, semverRangeMatchLoose } from './server/infra/semver.js'
-import { GITHUB_API, curlJson, fetchJsonUrl, githubJson, postJsonUrl, rawTextWithFallback } from './server/infra/http.js'
-import { cleanupStalePackageDir, copyTree, queuedWrite, startTrashCleanup, trashScanRoots } from './server/infra/fsx.js'
-import { execFileAsync, gitEnv, processAlive } from './server/infra/exec.js'
-import { escapeRegExp, maskUrl } from './server/infra/mask.js'
-import { isAllowedWriteOrigin, isLoopback, readBody, sendError, sendJson } from './server/infra/httpd.js'
-import { DEFAULT_SOURCES, consumeGiteeOAuthState, createGiteeOAuthState, gitCloneUrls, giteeStatusView, isAllowedGitSourceUrl, isAllowedSourceUrl, maskSources, orderedRegistries, readGiteeConfig, readSources, writeSources } from './server/domain/sources.js'
-import { CORE_PATCH_ROW_IDS, appendInsert, disableEntry, enableEntry, healPatchSafety, readPatchState, removeDisableBlock, removeInsertRow, sanitizePatchText, syncNameFromNote } from './server/domain/patch.js'
-import { enrichItems, fetchRepoPackage, fetchSubpackageNames, githubRepoInfo, normalizePlatformItems, readPluginDetails, subpackageCandidates } from './server/domain/market.js'
-import { SKILL_TOPICS, detectSkillRepo, fetchSkillMeta, listInstalledSkills, runSkillInstallJob, setSkillEnabled } from './server/domain/skills.js'
-import { autostartComponents, compFind, compStart, compStatus, compStop, compUiUrl, compUpsert, findComponents } from './server/domain/components.js'
-import { getReposDir, gitCloneRepo, listLandedRepos, setReposDir } from './server/domain/repoland.js'
-import { DEFAULT_BUNDLES, addBundleToManifest, backfillMissingDeps, curlManualInstall, detectBundleOnly, ensureBundlePatchIntegrity, githubReleaseInstall, installJobView, pnpmInstall, raceInstallChannels, readBundlePatchRefNames, readExtraBundleOwners, readGithubAuth, syncAggregateSubpackageVersions } from './server/domain/install.js'
-import { findPresetDirs, readGitmodules } from './server/domain/suite.js'
-import { FIBER_PHASE, SUPPORTED_WEB_APP_PATTERN, checkPluginFrameworkCompat, frameworkCheckPromptText, isFrameworkOwnedPackage, probePluginImport, readCompatGate, readCompatPending, writeCompatGate, writeCompatPending } from './server/domain/compat.js'
-import { logQuarantineMergeError, markPendingAdopted, mergeQuarantineRecord, planQuarantine, readQuarantineRecord, reconcileCompatPending } from './server/domain/quarantine.js'
-import { FRAMEWORK_BACKUP_ROOT, FRAMEWORK_STATE_FILE, applyFrameworkTolerancePatchOnce, checkpointFrameworkTree, cleanupStaleFwTasks, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules } from './server/domain/framework.js'
-import { migrateAgentConfigsForUpgrade } from './server/domain/presets.js'
-import { GITEE_AUTH_URL, GITEE_TOKEN_URL } from './server/domain/sources.js'
-import { aiEmpowerPresetFor, aiJobs, builtinPlanFor, isAllowedWritePath, isSafeRunCmd, loadAiJobs, parsePlanJson, resolvePlaceholders, resolvePythonPath, saveAiJobs } from './server/domain/ai.js'
-import { jobLog, waitHealth } from './server/domain/jobs.js'
-import { fwCheckCache, installJobs, marketIndexCache, nextAiJobSeq, nextInstallJobSeq, patchHealAt, patchHealReport, setFwCheckCache, setMarketIndexCache, setPatchHealAt, setPatchHealReport } from './server/state.js'
-import { routeStateGet, routeDetails } from './server/routes/state.js'
-import {routeFrameworkUpgradeStatusGet, routeFrameworkRelaunch, routeFrameworkCheck, routeCompatGate, routeCheckUpdate, routeFrameworkRollback, routeRestart } from './server/routes/framework.js'
-import { routeFrameworkUpgrade } from './server/routes/framework-upgrade.js'
-import { routeToggle, routeUninstall, routeAdaptUnlock, routeAdaptUnlockAll, routeCleanResiduals, routeSelfUpdate } from './server/routes/plugins.js'
-import { routeSearch, routeEnrich, routeRepo, routeSubpackages, routeMarketIndex } from './server/routes/market.js'
-import { routeAiConsent, routeAiEmpowerPlan, routeAiEmpowerStatus, routeAiEmpowerList, routeAiEmpowerRun, routeAiEmpowerCancel } from './server/routes/ai.js'
-import { routeComponents, routeRepoClone, routeRepoList, routeRepoLandConfig, routeRepoRemove, routeRepoOpen, routeComponentAutostart, routeComponentStart, routeComponentStop, routeComponentStatus } from './server/routes/components.js'
-import { routeSourcesGet, routeGiteeOauthUrlGet, routeGiteeOauthCallbackGet, routeRegistryScan, routeSources } from './server/routes/sources.js'
-import { routeSkillsInstalledGet, routeSkillRemove, routeSkillToggle } from './server/routes/skills.js'
-import { routeInstall, routeInstallStatus } from './server/routes/install.js'
-import { detectAdoptablePending, detectCompat, frameworkCompatReportFor, maybeAutoAdaptCompat, rowIdModuleMap } from './server/domain/compat.js'
-import { backupProfileSnapshot, currentFrameworkVersion, detectFrameworkUpgrade, preflightDisableIncompatible } from './server/domain/framework.js'
-import { listEntries, webPort } from './server/domain/runtime.js'
-import { isProtectedModule } from './server/domain/runtime.js'
-import { aiEmpowerExecute, aiEmpowerPlan } from './server/domain/ai-run.js'
-import { runInstallJob } from './server/domain/install-job.js'
-import { runSuiteInstallJob } from './server/domain/suite.js'
-import { pnpmRemove, readExtraBundleRows } from './server/domain/install-job.js'
-import { DEFAULT_SEARCH } from './server/domain/sources.js'
-import { ROUTE_PREFIX, handle } from './server/routes/index.js'
-
-/** Cordis 插件元信息。 */
-export const name = '@noob-stupid/dsh-plugin-console'
-export const inject = ['webServer', 'loader']
-
-/**
- * 后台安装任务注册表：请求立即返回，安装继续在服务端执行；
- * 面板通过 /install-status 轮询进度（stage + status），离开面板不中断。
- */
-/** 静态插件索引内存缓存（/market-index 用）。 */
-
-// ============================================================
-// AI 赋能：文档驱动的通用组件部署（读文档 → 出计划 → 确认 → 执行 → 组件控制）
-// ============================================================
-
-/** 应用插件：注册 /plugin-console 路由。 */
-export function apply(ctx) {
-  // 恢复 AI 赋能任务（restart 后 running 置失败，plan-ready/结果保留）
-  loadAiJobs()
-  // 升级脚本的「启动失败隔离」记录并入适配门清单（让用户看到谁被自动关了）
-  // v0.3.44：这里的 catch 不再静默 —— 2026-09-11 那次隔离记录（20 行）就是这样凭空消失的：
-  // 合并函数在中途抛错、catch 吞掉，界面只剩一个没有解释的【停用】。失败必须留痕。
-  try { mergeQuarantineRecord(ctx) } catch (error) { logQuarantineMergeError(error) }
-  // v0.3.45：清单与现实对账 —— 补 moduleName（否则「全家桶一键启用已适配」永远匹配不到），
-  // 以及把「已经启用、却还挂着 pending」的记录转成已适配（用户实测：启用后重启又变【待适配】）
-  try {
-    const fixed = reconcileCompatPending(ctx)
-    if (fixed.backfilled > 0 || fixed.adopted > 0) {
-      try { writeFileSync(join(dshHome(), 'plugin-console', 'fw-merge-error.log'), `${new Date().toISOString()} 清单对账：补 moduleName ${fixed.backfilled} 行，已启用转已适配 ${fixed.adopted} 行\n`, { flag: 'a' }) } catch {}
-    }
-  } catch (error) { logQuarantineMergeError(error) }
-  // 启动时清掉上次升级/回滚/重启留下的僵尸计划任务（脚本被强杀时来不及自删）+ 后台清掉 `.trash-*` 降级目录（2026-09-26 加法；覆盖 tmpdir / profile node_modules / skills / repos，即发即忘、绝不阻塞启动）
-  try { cleanupStaleFwTasks(); startTrashCleanup({ roots: trashScanRoots({ profileDir: profileDirOf(ctx) ?? '', extra: [join(dshHome(), 'skills'), getReposDir()] }) }) } catch {}
-  // DSH 启动时自动拉起标记了「自启动」的服务器组件（幂等，不阻塞启动）
-  autostartComponents().catch(() => {})
-  ctx.effect(() => {
-    const route = {
-      kind: 'prefix',
-      path: ROUTE_PREFIX,
-      handler: async (req, res) => {
-        if (!isLoopback(req.socket?.remoteAddress ?? '')) {
-          sendError(res, 403, '仅允许本机访问')
-          return
-        }
-        const port = webPort(ctx)
-        const host = typeof req.headers?.host === 'string' ? req.headers.host : ''
-        if (![`127.0.0.1:${port}`, `localhost:${port}`, `[::1]:${port}`].includes(host)) {
-          sendError(res, 403, 'Host 校验失败（仅允许本机访问）')
-          return
-        }
-        // 安全护栏（issue #9）：写路由必须是本机同源请求，防止恶意网页跨站驱动敏感操作。
-        const method = req.method ?? 'GET'
-        if (method !== 'GET' && method !== 'HEAD' && !isAllowedWriteOrigin(req, port)) {
-          sendError(res, 403, '跨站请求被拒绝（Origin/Sec-Fetch-Site 校验）')
-          return
-        }
-        try {
-          await handle(ctx, req, res)
-        } catch (error) {
-          sendError(res, 500, error instanceof Error ? error.message : String(error))
-        }
-      },
-    }
-    return ctx.webServer.register(route)
-  }, 'plugin-console: routes')
-}
-
-// ── 路由表（分层 Step 8b：表驱动分发，替代逐条 if 分支）─────────────────────────
-// 方法限定且位于 405 守卫之前的分支（只读接口）
-
-/** 路由处理器需要的宿主服务（仍住在 index.js 的 ctx 相关函数）—— ports 注入点（方案 §四）。
- *  用函数而不是模块级常量：这些是函数声明（会提升），但用惰性函数可以彻底避免初始化顺序问题。 */
-
-/** 框架版本检查缓存（功能包 → 框架 面板用；5 分钟 TTL，避免每次打开面板都打 registry）。 */
-
+/**
+ * @deepseek-ai/dsh-plugin-console — 插件控制台宿主端。
+ *
+ * 提供环回 HTTP 路由（前缀 /plugin-console）：
+ *   GET  /plugin-console/state    当前插件清单 + 用户补丁层状态
+ *   POST /plugin-console/toggle   一键启用/停用插件（写 cordis.patch.yml，HMR 生效）
+ *   POST /plugin-console/search   GitHub 仓库搜索（dsh-plugin 相关）
+ *   POST /plugin-console/repo     读取仓库的 package.json，判断是否可安装
+ *   POST /plugin-console/install  安装 npm 包（或 git 仓库）并追加启用条目
+ *
+ * 插件开关的机制：用户补丁层 cordis.patch.yml 是逐键覆盖（id-targeted patch），
+ * 追加 `- id: X` + `disabled: true` 即可停用任意行（含 bundle 行与用户 insert 行），
+ * 移除该块即恢复；HMR 监视器会自动重组合，无需重启。
+ */
+import { readFile, writeFile } from 'node:fs/promises'
+import { readFileSync, writeFileSync, existsSync, statSync, rmSync, readdirSync, mkdirSync, copyFileSync, realpathSync } from 'node:fs'
+import { execFile, spawn } from 'node:child_process'
+import { promisify } from 'node:util'
+import { dirname, join, basename, sep } from 'node:path'
+import { tmpdir, homedir } from 'node:os'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { createRequire } from 'node:module'
+import { request as httpsRequest } from 'node:https'
+import { aiJobsFile, componentsFile, dshHome, entryPkgMeta, findPatchPath, marketIndexCacheFile, packageNameOf, pluginRoot, profileDirOf, repoLandConfFile, resolvePackageJson, rowIdOf } from './server/infra/paths.js'
+import { isFrameworkVersionNewer, parseFrameworkVersion, semverRangeMatch, semverRangeMatchLoose } from './server/infra/semver.js'
+import { GITHUB_API, curlJson, fetchJsonUrl, githubJson, postJsonUrl, rawTextWithFallback } from './server/infra/http.js'
+import { cleanupStalePackageDir, copyTree, queuedWrite, startTrashCleanup, trashScanRoots } from './server/infra/fsx.js'
+import { execFileAsync, gitEnv, processAlive } from './server/infra/exec.js'
+import { escapeRegExp, maskUrl } from './server/infra/mask.js'
+import { isAllowedWriteOrigin, isLoopback, readBody, sendError, sendJson } from './server/infra/httpd.js'
+import { DEFAULT_SOURCES, consumeGiteeOAuthState, createGiteeOAuthState, gitCloneUrls, giteeStatusView, isAllowedGitSourceUrl, isAllowedSourceUrl, maskSources, orderedRegistries, readGiteeConfig, readSources, writeSources } from './server/domain/sources.js'
+import { CORE_PATCH_ROW_IDS, appendInsert, disableEntry, enableEntry, healPatchSafety, readPatchState, removeDisableBlock, removeInsertRow, sanitizePatchText, syncNameFromNote } from './server/domain/patch.js'
+import { enrichItems, fetchRepoPackage, fetchSubpackageNames, githubRepoInfo, normalizePlatformItems, readPluginDetails, subpackageCandidates } from './server/domain/market.js'
+import { SKILL_TOPICS, detectSkillRepo, fetchSkillMeta, listInstalledSkills, runSkillInstallJob, setSkillEnabled } from './server/domain/skills.js'
+import { autostartComponents, compFind, compStart, compStatus, compStop, compUiUrl, compUpsert, findComponents } from './server/domain/components.js'
+import { getReposDir, gitCloneRepo, listLandedRepos, setReposDir } from './server/domain/repoland.js'
+import { DEFAULT_BUNDLES, addBundleToManifest, backfillMissingDeps, curlManualInstall, detectBundleOnly, ensureBundlePatchIntegrity, githubReleaseInstall, installJobView, pnpmInstall, raceInstallChannels, readBundlePatchRefNames, readExtraBundleOwners, readGithubAuth, syncAggregateSubpackageVersions } from './server/domain/install.js'
+import { findPresetDirs, readGitmodules } from './server/domain/suite.js'
+import { FIBER_PHASE, SUPPORTED_WEB_APP_PATTERN, checkPluginFrameworkCompat, frameworkCheckPromptText, isFrameworkOwnedPackage, probePluginImport, readCompatGate, readCompatPending, writeCompatGate, writeCompatPending } from './server/domain/compat.js'
+import { logQuarantineMergeError, markPendingAdopted, mergeQuarantineRecord, planQuarantine, readQuarantineRecord, reconcileCompatPending } from './server/domain/quarantine.js'
+import { FRAMEWORK_BACKUP_ROOT, FRAMEWORK_STATE_FILE, applyFrameworkTolerancePatchOnce, checkpointFrameworkTree, cleanupStaleFwTasks, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules } from './server/domain/framework.js'
+import { migrateAgentConfigsForUpgrade } from './server/domain/presets.js'
+import { GITEE_AUTH_URL, GITEE_TOKEN_URL } from './server/domain/sources.js'
+import { aiEmpowerPresetFor, aiJobs, builtinPlanFor, isAllowedWritePath, isSafeRunCmd, loadAiJobs, parsePlanJson, resolvePlaceholders, resolvePythonPath, saveAiJobs } from './server/domain/ai.js'
+import { jobLog, waitHealth } from './server/domain/jobs.js'
+import { fwCheckCache, installJobs, marketIndexCache, nextAiJobSeq, nextInstallJobSeq, patchHealAt, patchHealReport, setFwCheckCache, setMarketIndexCache, setPatchHealAt, setPatchHealReport } from './server/state.js'
+import { routeStateGet, routeDetails } from './server/routes/state.js'
+import {routeFrameworkUpgradeStatusGet, routeFrameworkRelaunch, routeFrameworkCheck, routeCompatGate, routeCheckUpdate, routeFrameworkRollback, routeRestart } from './server/routes/framework.js'
+import { routeFrameworkUpgrade } from './server/routes/framework-upgrade.js'
+import { routeToggle, routeUninstall, routeAdaptUnlock, routeAdaptUnlockAll, routeCleanResiduals, routeSelfUpdate } from './server/routes/plugins.js'
+import { routeSearch, routeEnrich, routeRepo, routeSubpackages, routeMarketIndex } from './server/routes/market.js'
+import { routeAiConsent, routeAiEmpowerPlan, routeAiEmpowerStatus, routeAiEmpowerList, routeAiEmpowerRun, routeAiEmpowerCancel } from './server/routes/ai.js'
+import { routeComponents, routeRepoClone, routeRepoList, routeRepoLandConfig, routeRepoRemove, routeRepoOpen, routeComponentAutostart, routeComponentStart, routeComponentStop, routeComponentStatus } from './server/routes/components.js'
+import { routeSourcesGet, routeGiteeOauthUrlGet, routeGiteeOauthCallbackGet, routeRegistryScan, routeSources } from './server/routes/sources.js'
+import { routeSkillsInstalledGet, routeSkillRemove, routeSkillToggle } from './server/routes/skills.js'
+import { routeInstall, routeInstallStatus } from './server/routes/install.js'
+import { detectAdoptablePending, detectCompat, frameworkCompatReportFor, maybeAutoAdaptCompat, rowIdModuleMap } from './server/domain/compat.js'
+import { backupProfileSnapshot, currentFrameworkVersion, detectFrameworkUpgrade, preflightDisableIncompatible } from './server/domain/framework.js'
+import { listEntries, webPort } from './server/domain/runtime.js'
+import { isProtectedModule } from './server/domain/runtime.js'
+import { aiEmpowerExecute, aiEmpowerPlan } from './server/domain/ai-run.js'
+import { runInstallJob } from './server/domain/install-job.js'
+import { runSuiteInstallJob } from './server/domain/suite.js'
+import { pnpmRemove, readExtraBundleRows } from './server/domain/install-job.js'
+import { DEFAULT_SEARCH } from './server/domain/sources.js'
+import { ROUTE_PREFIX, handle } from './server/routes/index.js'
+
+/** Cordis 插件元信息。 */
+export const name = '@noob-stupid/dsh-plugin-console'
+export const inject = ['webServer', 'loader']
+
+/**
+ * 后台安装任务注册表：请求立即返回，安装继续在服务端执行；
+ * 面板通过 /install-status 轮询进度（stage + status），离开面板不中断。
+ */
+/** 静态插件索引内存缓存（/market-index 用）。 */
+
+// ============================================================
+// AI 赋能：文档驱动的通用组件部署（读文档 → 出计划 → 确认 → 执行 → 组件控制）
+// ============================================================
+
+/** 应用插件：注册 /plugin-console 路由。 */
+export function apply(ctx) {
+  // 恢复 AI 赋能任务（restart 后 running 置失败，plan-ready/结果保留）
+  loadAiJobs()
+  // 升级脚本的「启动失败隔离」记录并入适配门清单（让用户看到谁被自动关了）
+  // v0.3.44：这里的 catch 不再静默 —— 2026-09-11 那次隔离记录（20 行）就是这样凭空消失的：
+  // 合并函数在中途抛错、catch 吞掉，界面只剩一个没有解释的【停用】。失败必须留痕。
+  try { mergeQuarantineRecord(ctx) } catch (error) { logQuarantineMergeError(error) }
+  // v0.3.45：清单与现实对账 —— 补 moduleName（否则「全家桶一键启用已适配」永远匹配不到），
+  // 以及把「已经启用、却还挂着 pending」的记录转成已适配（用户实测：启用后重启又变【待适配】）
+  try {
+    const fixed = reconcileCompatPending(ctx)
+    if (fixed.backfilled > 0 || fixed.adopted > 0) {
+      try { writeFileSync(join(dshHome(), 'plugin-console', 'fw-merge-error.log'), `${new Date().toISOString()} 清单对账：补 moduleName ${fixed.backfilled} 行，已启用转已适配 ${fixed.adopted} 行\n`, { flag: 'a' }) } catch {}
+    }
+  } catch (error) { logQuarantineMergeError(error) }
+  // 启动时清掉上次升级/回滚/重启留下的僵尸计划任务（脚本被强杀时来不及自删）+ 后台清掉 `.trash-*` 降级目录（2026-09-26 加法；覆盖 tmpdir / profile node_modules / skills / repos，即发即忘、绝不阻塞启动）
+  try { cleanupStaleFwTasks(); startTrashCleanup({ roots: trashScanRoots({ profileDir: profileDirOf(ctx) ?? '', extra: [join(dshHome(), 'skills'), getReposDir()] }) }) } catch {}
+  // DSH 启动时自动拉起标记了「自启动」的服务器组件（幂等，不阻塞启动）
+  autostartComponents().catch(() => {})
+  ctx.effect(() => {
+    const route = {
+      kind: 'prefix',
+      path: ROUTE_PREFIX,
+      handler: async (req, res) => {
+        if (!isLoopback(req.socket?.remoteAddress ?? '')) {
+          sendError(res, 403, '仅允许本机访问')
+          return
+        }
+        const port = webPort(ctx)
+        const host = typeof req.headers?.host === 'string' ? req.headers.host : ''
+        if (![`127.0.0.1:${port}`, `localhost:${port}`, `[::1]:${port}`].includes(host)) {
+          sendError(res, 403, 'Host 校验失败（仅允许本机访问）')
+          return
+        }
+        // 安全护栏（issue #9）：写路由必须是本机同源请求，防止恶意网页跨站驱动敏感操作。
+        const method = req.method ?? 'GET'
+        if (method !== 'GET' && method !== 'HEAD' && !isAllowedWriteOrigin(req, port)) {
+          sendError(res, 403, '跨站请求被拒绝（Origin/Sec-Fetch-Site 校验）')
+          return
+        }
+        try {
+          await handle(ctx, req, res)
+        } catch (error) {
+          sendError(res, 500, error instanceof Error ? error.message : String(error))
+        }
+      },
+    }
+    return ctx.webServer.register(route)
+  }, 'plugin-console: routes')
+}
+
+// ── 路由表（分层 Step 8b：表驱动分发，替代逐条 if 分支）─────────────────────────
+// 方法限定且位于 405 守卫之前的分支（只读接口）
+
+/** 路由处理器需要的宿主服务（仍住在 index.js 的 ctx 相关函数）—— ports 注入点（方案 §四）。
+ *  用函数而不是模块级常量：这些是函数声明（会提升），但用惰性函数可以彻底避免初始化顺序问题。 */
+
+/** 框架版本检查缓存（功能包 → 框架 面板用；5 分钟 TTL，避免每次打开面板都打 registry）。 */
+

package/lib/server/domain/ai-run.js

@@ -1,6 +1,6 @@
 // L1 · domain —— ai-run.js（AI 赋能的执行侧：规划 / 执行 / 修复 / 单步运行）。
 // 分层 Step 8c-2 从 lib/index.js 搬出；形参由 ctx 收窄为 ports，只搬移未改逻辑。
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { writeFileSync, existsSync, statSync, rmSync, mkdirSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/lib/server/domain/ai.js

@@ -1,5 +1,5 @@
 // L1 · domain —— ai.js（AI 赋能的纯逻辑部分：任务表与视图、DeepSeek 密钥与配置、占位符/Python/VLM 解析、写入白名单与运行白名单、内置计划模板、计划 JSON 解析；分层 Step 7 从 lib/index.js 搬出，只搬移未改逻辑。注：aiEmpowerPlan/Execute、runAiStep、aiRepair 吃运行上下文，留到 Step 8）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
 import { dirname, join, basename, resolve } from 'node:path'
@@ -126,15 +126,41 @@ function resolvePlaceholders(value, jobOrEnv) {
     .replaceAll('${python}', python)
     .replaceAll('${scripts}', join(dirname(python), 'Scripts'))
     .replaceAll('${node}', process.execPath)
+    .replaceAll('${asciiData}', openVikingDataRoot())
     .replaceAll('${deepseekKey}', readDeepSeekKey())
 }
 
+/** 解析 Python 解释器：候选按平台分开，**不含任何开发机专有路径**。
+ *  win32：用户级安装目录（AppData\Local\Programs\Python）+ PATH 上的 python.exe；
+ *  POSIX：/usr/bin/python3、/usr/local/bin/python3、PATH 上的 python3/python。
+ *  原实现第一条写死开发机的绝对路径（`<盘符>:\python314\python.exe`），且三个候选全是 Windows 形态 ——
+ *  非 Windows 上永远解析不到，`${python}` 会退化成 Windows 专有名字。
+ *  解析不到时返回**本平台的命令名**（由执行阶段如实报错），不在这里抛。 */
 function resolvePythonPath() {
-  const candidates = [join('E:', 'python314', 'python.exe'), join(homedir(), 'AppData', 'Local', 'Programs', 'Python', 'Python314', 'python.exe'), 'python.exe']
+  const win = process.platform === 'win32'
+  const candidates = win
+    ? [
+      join(homedir(), 'AppData', 'Local', 'Programs', 'Python', 'Python314', 'python.exe'),
+      'python.exe',
+    ]
+    : ['/usr/bin/python3', '/usr/local/bin/python3', 'python3', 'python']
   for (const c of candidates) {
     if (existsSync(c)) return c
   }
-  return 'python.exe'
+  return win ? 'python.exe' : 'python3'
+}
+
+/** OpenViking 数据根：**必须纯 ASCII**（home 含非 ASCII 字符时，各语言的 Rust/原生向量库
+ *  写盘会报 UnicodeDecodeError）。三种来源，**不含任何写死的盘符**：
+ *    ① 环境变量 DSH_OPENVIKING_DATA_ROOT（用户显式指定，最高优先）
+ *    ② win32 历史默认：D:/OpenVikingData（保持既有实例的数据位置不变）
+ *    ③ 其他平台：${home}/.openviking/ascii-data
+ *  原实现无条件返回 'D:/OpenVikingData'：非 Windows 上它是个**相对路径**，会被写进 CWD
+ *  （服务进程的工作目录），在别人的机器上根本不是"ASCII 数据根"。 */
+function openVikingDataRoot() {
+  const override = process.env.DSH_OPENVIKING_DATA_ROOT
+  if (typeof override === 'string' && override.trim() !== '') return override.trim()
+  return process.platform === 'win32' ? 'D:/OpenVikingData' : join(homedir(), '.openviking', 'ascii-data')
 }
 
 /** 写入路径白名单：只允许 DSH profile、~/.dsh、~/.openviking、~/.cache/openviking、ASCII 数据根。 */
@@ -148,13 +174,13 @@ function isAllowedWritePath(p, profileDir) {
     norm(homedir()) + '/.local/share/openviking',
     norm(homedir()) + '/.dsh/repos',
     norm(profileDir),
-    'D:/OpenVikingData',
+    norm(openVikingDataRoot()),
   ]
   return roots.some((root) => target === root || target.startsWith(root + '/'))
 }
 
-/** run-cmd 可执行文件白名单（按 basename）。 */
-const ALLOWED_RUN_FILES = new Set(['curl.exe', 'curl', 'git.exe', 'git', 'node.exe', 'node', 'python.exe', 'python', 'py.exe', 'py', 'gh.exe', 'gh', 'npm.cmd', 'npm', 'ov.cmd', 'ov'])
+/** run-cmd 可执行文件白名单（按 basename；含 POSIX 名 python3，否则 ${python}=python3 会被自己拒掉）。 */
+const ALLOWED_RUN_FILES = new Set(['curl.exe', 'curl', 'git.exe', 'git', 'node.exe', 'node', 'python.exe', 'python3', 'python', 'py.exe', 'py', 'gh.exe', 'gh', 'npm.cmd', 'npm', 'ov.cmd', 'ov'])
 
 const DESTRUCTIVE_RE = /(^|\s)(rm\s+(-[a-zA-Z]*r)|rmdir\s+\/s|del\s+\/s|format\s+[a-zA-Z]:|Remove-Item\b|taskkill\s+\/im|reg\s+delete|schtasks\s+\/delete|shutdown|cipher\s+\/w)/iu
 
@@ -178,7 +204,7 @@ function builtinPlanFor(source) {
     .replace(/\/$/u, '')
   if (norm !== 'openviking' && norm !== 'volcengine/openviking') return null
   const home = homedir()
-  const storage = /^[\x00-\x7F]+$/u.test(home) ? `${home}/.openviking/data` : 'D:/OpenVikingData'
+  const storage = /^[\x00-\x7F]+$/u.test(home) ? `${home}/.openviking/data` : openVikingDataRoot()
   const vlm = resolveVlmForOpenViking()
   // 注意：路径必须在此处（JSON.stringify 之前）使用真实值，由 stringify 统一转义；
   // 不能在 content 中保留 ${home} 占位符——写文件时替换会把反斜杠路径变成非法 JSON 转义。
@@ -209,10 +235,12 @@ function aiEmpowerPresetFor(source) {
   const common = [
     '## 本机环境事实（务必遵守）',
     '- 网络：pypi.org 不通、清华镜像 403；pip 必须用 `--index-url https://mirrors.aliyun.com/pypi/simple/`。npm registry.npmjs.org 可能黑洞，pnpm 用 `--registry https://registry.npmmirror.com`。huggingface.co 被墙，模型文件一律用 `https://hf-mirror.com/<同一路径>`（执行器会自动把 huggingface.co 换成 hf-mirror.com，计划里也可直接写 hf-mirror）。',
-    // 0.5.28 改错：这条原本把它写成"本机用户名含中文（花火）"的**个案**，读起来像只在
+    // 0.5.28 改错：这条原本把它写成"本机用户名含非 ASCII 字符"的**个案**，读起来像只在
     // 那台机器上成立。真正的规则是通用的：只要**写盘路径**里出现非 ASCII 字符，各语言的
     // Rust/原生向量库就可能报 UnicodeDecodeError —— 与用户名具体是不是中文无关。
-    '- 用户名/路径含非 ASCII 字符时：任何写盘路径若含非 ASCII 字符，各语言的 Rust/原生向量库会报 UnicodeDecodeError——服务数据目录必须纯 ASCII（如 `D:/OpenVikingData`）。',
+    // 2026-09-29 改错：ASCII 数据根不再写死某个盘符，改用 `${asciiData}` 占位符
+    // （由 resolvePlaceholders 解析成"本平台/本用户"的 ASCII 数据根，见 openVikingDataRoot）。
+    '- 用户名/路径含非 ASCII 字符时：任何写盘路径若含非 ASCII 字符，各语言的 Rust/原生向量库会报 UnicodeDecodeError——服务数据目录必须纯 ASCII，用 `${asciiData}` 引用控制台给出的 ASCII 数据根（可用环境变量 DSH_OPENVIKING_DATA_ROOT 覆盖）。',
     '- 凭据复用：DSH 的 DeepSeek 密钥在 `${home}/.dsh/.credentials.yaml`（YAML 行 `DEEPSEEK_API_KEY: sk-...`）；模型选择在 `${home}/.dsh/settings.yaml` 的 `agent-default-model`（provider deepseek-official）。对外 OpenAI 兼容接口：api_base `https://api.deepseek.com`，模型名 `deepseek-v4-flash-vision-exp`。',
     '- 步骤解释用中文；每个动作一个步骤；步骤数尽量少；不得包含任何破坏性命令；服务类组件必须配 start-service + wait-health。',
   ]
@@ -222,8 +250,8 @@ function aiEmpowerPresetFor(source) {
       '## OpenViking 已验证的部署事实（v0.4.17，Python 3.14）',
       '- 安装：`pip install openviking[local-embed]`（含 llama-cpp-python 0.3.35，cp310-abi3 轮子可用；无需加 --force-reinstall）。',
       '- 嵌入模型：`bge-small-zh-v1.5-f16.gguf`（47MB，512 维中文）下载到 `${home}/.cache/openviking/models/`（写 download 步骤；URL 写 huggingface.co 会被执行器自动换 hf-mirror.com）。',
-      '- ov.conf 路径 `${home}/.openviking/ov.conf`，内容：vlm = { provider: openai, api_base: https://api.deepseek.com, model: deepseek-v4-flash-vision-exp, api_key: 从 `${home}/.dsh/.credentials.yaml` 读取并内联 }；embedding.dense = { provider: local, model: bge-small-zh-v1.5-f16, model_path: <上面的 gguf 路径> }；server = { host: 127.0.0.1, port: 1933 }（不要写 root_api_key，dev 免鉴权模式自动启用）；storage.workspace = `${home}` 含非 ASCII 时写 `D:/OpenVikingData`，否则 `${home}/.openviking/data`。',
-      '- 启动：start-service，file=`${python}`，args=`["-m","openviking_cli.server_bootstrap"]`，cwd=`${home}/.openviking`，healthUrl=`http://127.0.0.1:1933/health`，port=1933。服务器启动首次会建 `D:/OpenVikingData` 数据目录。',
+      '- ov.conf 路径 `${home}/.openviking/ov.conf`，内容：vlm = { provider: openai, api_base: https://api.deepseek.com, model: deepseek-v4-flash-vision-exp, api_key: 从 `${home}/.dsh/.credentials.yaml` 读取并内联 }；embedding.dense = { provider: local, model: bge-small-zh-v1.5-f16, model_path: <上面的 gguf 路径> }；server = { host: 127.0.0.1, port: 1933 }（不要写 root_api_key，dev 免鉴权模式自动启用）；storage.workspace = `${home}` 含非 ASCII 时写 `${asciiData}`，否则 `${home}/.openviking/data`。',
+      '- 启动：start-service，file=`${python}`，args=`["-m","openviking_cli.server_bootstrap"]`，cwd=`${home}/.openviking`，healthUrl=`http://127.0.0.1:1933/health`，port=1933。服务器启动首次会建 `${asciiData}` 数据目录。',
       '- 部署完成后惯例：重启 DSH 会话后 mcp__openviking__* 工具出现，`${home}/.openviking/pending` 的积压消息会在新会话启动时自动回放——把这写进总结。',
     ].join('\n')
   }

package/lib/server/domain/compat.js

@@ -1,5 +1,5 @@
 // L1 · domain —— compat.js（框架兼容判定与适配门：设置 API 扫描 / 兼容门读写 / 待适配记录 / 隔离记录合并的前置部分 / 启动失败分析；分层 Step 6 从 lib/index.js 搬出，只搬移未改逻辑。注：detectCompat 等吃运行上下文的留到 Step 8）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, readdirSync, mkdirSync, realpathSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/lib/server/domain/components.js

@@ -1,5 +1,5 @@
 // L1 · domain —— components.js（服务器组件：注册表 / 增删改 / 进程启停 / 状态 / 自启动；分层 Step 4 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
 import { spawn } from 'node:child_process'

package/lib/server/domain/dep-source.js

@@ -11,7 +11,7 @@
 //   lock（删 lock / 清 node_modules / 换机 / CI）→ `ERR_PNPM_FETCH_404`，而报错指向 npm registry，
 //   用户根本联想不到是几周前面板安装改写造成的。
 //
-// 两条硬约束（本机真 pnpm 10.34.5 实测矩阵见 D:\dsh\dsh-plugin-hub-plan\refactor-bugs.zh.md 第 23 节）：
+// 两条硬约束（真 pnpm 10.34.5 实测矩阵见仓库外私有方案稿第 23 节）：
 //   ① 写回前必须确认「这个包的**这个版本**」在 registry 可解析，否则**绝不**写裸版本号；
 //   ② 不可解析时**也不能**写 tarball URL：pnpm 10 对 direct-URL 依赖只在冷缓存真下载时记 integrity，
 //      命中缓存重写 lock 时 resolution 里没有 integrity → `ERR_PNPM_MISSING_TARBALL_INTEGRITY`，

package/lib/server/domain/framework.js

@@ -1,5 +1,5 @@
 // L1 · domain —— framework.js（升级三件套的可搬部分：状态/备份路径、dsh 可执行文件定位、app boot 定位、容忍补丁、版本比较、重启前奏；分层 Step 6 从 lib/index.js 搬出，只搬移未改逻辑。注：detectFrameworkUpgrade / backupProfileSnapshot / currentFrameworkVersion 吃运行上下文，留到 Step 8）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync, copyFileSync } from 'node:fs'
 import { execFile } from 'node:child_process'
@@ -27,6 +27,27 @@ const FRAMEWORK_STATE_FILE = () => join(dshHome(), 'plugin-console', 'framework-
 
 const FRAMEWORK_BACKUP_ROOT = () => join(dshHome(), 'plugin-console', 'framework-backups')
 
+/** npm 缓存下的 npx 缓存目录候选（**不写死盘符/用户名**）。
+ *  npm 的 cache 位置本来就是用户配置（把 cache 指到别的盘是常见做法），所以按 npm 自己的
+ *  配置来源读取：环境变量 npm_config_cache / NPM_CONFIG_CACHE，以及用户级 ~/.npmrc 的 `cache=`。
+ *  （原实现把开发机上某个盘符下的 `node_cache\_npx` 直接写进源码，随 npm 发给所有用户。） */
+function npmNpxCacheRoots() {
+  const roots = []
+  const push = (value) => {
+    if (typeof value !== 'string') return
+    const dir = value.trim().replace(/^["']|["']$/gu, '').replace(/^~(?=[\\/]|$)/u, homedir())
+    if (dir !== '') roots.push(join(dir, '_npx'))
+  }
+  for (const key of ['npm_config_cache', 'NPM_CONFIG_CACHE']) push(process.env[key])
+  try {
+    for (const line of readFileSync(join(homedir(), '.npmrc'), 'utf8').split(/\r?\n/u)) {
+      const hit = /^\s*cache\s*=\s*(.*?)\s*$/iu.exec(line)
+      if (hit) push(hit[1])
+    }
+  } catch {}
+  return roots
+}
+
 /** 定位 @deepseek-ai/dsh-app-boot（与 @deepseek-ai/dsh 同级）。 */
 function locateAppBootFile(baseUrl) {
   try {
@@ -35,15 +56,26 @@ function locateAppBootFile(baseUrl) {
     const candidate = join(dirname(dshPkg), 'dsh-app-boot', 'lib', 'index.js')
     if (existsSync(candidate)) return candidate
   } catch {}
+  // 缓存根一律由「环境变量 / 用户配置 / 用户目录」派生，**不含任何写死的盘符或开发机路径**：
+  //   · NODE_CACHE：npx 缓存根的可选覆盖（直接就是 _npx 那一层）
+  //   · npm_config_cache / ~/.npmrc 的 cache=：npm 自己配置的缓存根（下面挂 _npx）
+  //   · ~/.npm/_npx：npm/npx 的默认用户级缓存（POSIX 与 Windows 同一处）
+  //   · %LOCALAPPDATA%\node_cache\_npx：缓存被重定向到 LOCALAPPDATA 时的位置（仅 Windows 有意义）
+  // 原实现第一条写死开发机上的缓存绝对路径（某个盘符下的 node_cache\_npx），且 LOCALAPPDATA
+  // 缺失时会拼出**相对路径** 'node_cache/_npx'（相对 CWD）——两处都已去掉。
   const cacheRoots = [
     process.env.NODE_CACHE || '',
-    'D:\\node_cache\\_npx',
+    ...npmNpxCacheRoots(),
     join(homedir(), '.npm', '_npx'),
-    join(process.env.LOCALAPPDATA || '', 'node_cache', '_npx'),
+    process.env.LOCALAPPDATA ? join(process.env.LOCALAPPDATA, 'node_cache', '_npx') : '',
   ].filter(Boolean)
   for (const root of cacheRoots) {
     if (!existsSync(root)) continue
-    for (const entry of readdirSync(root, { withFileTypes: true })) {
+    // 读目录失败（权限/竞态）只跳过这一条候选，绝不抛给调用方——本函数的契约是
+    // 「定位不到就返回 null」（调用方据此如实报「dsh-app-boot 未找到」）。
+    let entries = []
+    try { entries = readdirSync(root, { withFileTypes: true }) } catch { continue }
+    for (const entry of entries) {
       if (!entry.isDirectory()) continue
       const candidate = join(root, entry.name, 'node_modules', '@deepseek-ai', 'dsh-app-boot', 'lib', 'index.js')
       if (existsSync(candidate)) return candidate
@@ -141,7 +173,7 @@ function checkpointFrameworkTree(fwRoot, destRoot) {
  *
  * 事故现场（官方桌面端实例，127.0.0.1:19387，20:28）：
  *   桌面端里 DSH host 是 **Electron 二进制**跑的 asar 内入口
- *   （`D:\dsh-desktop\DeepSeek Harness.exe --expose-internals …\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\index.js …`），
+ *   （`<桌面端安装目录>\DeepSeek Harness.exe --expose-internals …\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\index.js …`），
  *   不是 `node bin.js web`。我们的「重启服务 / 回滚 / 框架升级重启」那一套会
  *   `Stop-Process` 掉 host，然后 `Resolve-DshBin` 三种方式全找不到 bin.js
  *   （桌面端 profile 的 node_modules 里根本没有 `@deepseek-ai` 作用域）→ 拉不起来 →
@@ -212,6 +244,33 @@ function shellHostedRefusal(deps) {
   }
 }
 
+/**
+ * 非 Windows 平台的标准拒绝载荷（**纯数据，不碰 HTTP**）：路由层负责翻成响应。
+ * 返回 null = win32（放行，行为与旧实现一字不改）。
+ *
+ * 为什么必须拒绝（2026-09-29 改错）：一键升级/回滚通道整体建立在 Windows 机制上 ——
+ * `schtasks.exe` 计划任务（脱离服务进程树）+ PowerShell 脚本 + `Get-NetTCPConnection` 探端口。
+ * 非 Windows 上 execFile('schtasks.exe') 必然 ENOENT，而旧实现先 writeFileSync 一个
+ * 「脚本已通过 detached 启动」的状态文件、再去 exec 不存在的 powershell.exe，
+ * 最后**照样** `upgraded = true` 并回 `ok: true, steps: ['框架升级脚本已启动…']` ——
+ * 用户看到"已启动"，实际一个字节都没动（静默失败 + 假成功）。宁可明确说"不支持"。
+ */
+function platformUpgradeRefusal() {
+  if (process.platform === 'win32') return null
+  return {
+    error: '当前平台暂不支持「一键框架升级/回滚」：该通道依赖 Windows 计划任务（schtasks.exe）与 PowerShell',
+    details: {
+      code: 'unsupported-platform',
+      platform: process.platform,
+      manual: [
+        '手动升级框架：npm i -g @deepseek-ai/dsh@latest（用 npx 的实例：清掉 npx 缓存后重跑 npx @deepseek-ai/dsh web）',
+        '升级前请自行备份 profile 目录（~/.dsh/profiles/<profile>）与 cordis.patch.yml',
+        '升级完成后本控制台仍会自动：备份新版本配置快照、重打框架补丁（issue #5 容错）、给出适配提示',
+      ],
+    },
+  }
+}
+
 /**
  * 生成「拉起 DSH 服务」的 PowerShell 前导块（升级脚本 / 回滚脚本共用，v0.3.37 事故修复）。
  *
@@ -477,4 +536,4 @@ async function preflightDisableIncompatible({ ports, profileDir, patchPath, targ
   }
   return { disabled, skipped }
 }
-export { FRAMEWORK_STATE_FILE, FRAMEWORK_BACKUP_ROOT, SHELL_HOSTED_NOTICE, detectHostShape, shellHostedRefusal, cleanupStaleFwTasks, resolveDshBin, locateAppBootFile, applyFrameworkTolerancePatchOnce, resolveFrameworkRootNodeModules, checkpointFrameworkTree, relaunchPrelude, isVersionAtLeast, pickFrameworkTarget, resolveFrameworkUpgradePlan, currentFrameworkVersion, backupProfileSnapshot, detectFrameworkUpgrade, preflightDisableIncompatible }
+export { FRAMEWORK_STATE_FILE, FRAMEWORK_BACKUP_ROOT, SHELL_HOSTED_NOTICE, detectHostShape, shellHostedRefusal, platformUpgradeRefusal, cleanupStaleFwTasks, resolveDshBin, locateAppBootFile, applyFrameworkTolerancePatchOnce, resolveFrameworkRootNodeModules, checkpointFrameworkTree, relaunchPrelude, isVersionAtLeast, pickFrameworkTarget, resolveFrameworkUpgradePlan, currentFrameworkVersion, backupProfileSnapshot, detectFrameworkUpgrade, preflightDisableIncompatible }

package/lib/server/domain/install-job.js

@@ -1,6 +1,6 @@
 // L1 · domain —— install-job.js（安装任务编排：多通道安装 + 套装补丁 + 适配门 + 收尾）。
 // 分层 Step 8c-2 从 lib/index.js 搬出；形参由 ctx 收窄为 ports（调用方注入的窄接口），只搬移未改逻辑。
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, existsSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/lib/server/domain/install.js

@@ -1,5 +1,5 @@
 // L1 · domain —— install.js（插件安装/卸载全链路：pnpm / curl 手动 / GitHub Release 三通道 + 包盒校验 + 套装补丁完整性；分层 Step 5 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, existsSync, rmSync, readdirSync, mkdirSync } from 'node:fs'
 import { readFile, writeFile } from 'node:fs/promises'

package/lib/server/domain/jobs.js

@@ -1,5 +1,5 @@
 // L1 · domain —— jobs.js（任务辅助：日志追加 + 健康等待轮询）。方案原稿把 jobLog 归 ai.js、waitHealth 归 components.js，但这俩是 install / suite / ai 三个域共用的，埋在任何一个域里都会造成跨域反向依赖 —— 故单独成模块（偏离已记录）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 function jobLog(job, line) {

package/lib/server/domain/market.js

@@ -1,5 +1,5 @@
 // L1 · domain —— market.js（分层 Step 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, mkdirSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'

package/lib/server/domain/patch.js

@@ -1,5 +1,5 @@
 // L1 · domain —— patch.js（由 Step 2 从 lib/index.js 原样切出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L1 · domain
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFile, writeFile } from 'node:fs/promises'
 import { dirname } from 'node:path'

package/lib/server/domain/presets.js

@@ -1,5 +1,5 @@
 // L1 · domain —— presets.js（预设/agent 配置迁移：config 文件收集、persona 迁移、升级期迁移；分层 Step 6 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, existsSync, readdirSync, copyFileSync } from 'node:fs'
 import { join } from 'node:path'

package/lib/server/domain/release-source.js

@@ -443,9 +443,9 @@ async function downloadReleaseArtifact(url, dest, options = {}) {
  * node_modules（包根本身由 paths.js 的 pluginRoot() 解析——全仓库只有那一处算包根）。
  * 返回 `<root>/<packageName>`。
  * ★ 特判的判据必须包含"自身确实住在某个 node_modules 里"（dirname 的 basename 为 node_modules）：
- * 旧判据只有 `existsSync(<pkg>/package.json)`，而任何**开发检出**（D:\dsh\dsh-plugin-hub-refactor 这种
- * 不在 node_modules 下的目录）都满足它 → 目标会被算成检出的**父目录**，release 通道装一次插件就往
- * `D:\dsh\<包名>` 写一份。生产布局不变：宿主根层 `<host>/node_modules/<pkg>` 仍然命中特判。 */
+ * 旧判据只有 `existsSync(<pkg>/package.json)`，而任何**开发检出**（不在 node_modules 下的目录，
+ * 例如 `~/dev/<包名>`）都满足它 → 目标会被算成检出的**父目录**，release 通道装一次插件就往
+ * `~/dev/<包名>` 写一份。生产布局不变：宿主根层 `<host>/node_modules/<pkg>` 仍然命中特判。 */
 function releaseInstallTarget(profileDir, packageName) {
   let targetRoot = join(profileDir, 'node_modules')
   try {

package/lib/server/domain/repoland.js

@@ -1,5 +1,5 @@
 // L1 · domain —— repoland.js（仓库落地：落地目录配置 / 已落地列表 / 克隆；分层 Step 4 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync, renameSync, statSync } from 'node:fs'
 import { spawn } from 'node:child_process'

package/lib/server/domain/runtime.js

@@ -1,6 +1,6 @@
 // L1 · domain —— runtime.js（从宿主运行时读取信息：loader 条目 / webServer 端口）。
 // 这两个函数原本吃 cordis 的 ctx；Step 8c 起它们的形参改名为 ports（= 调用方注入的窄接口），domain 层不再出现 ctx 标识符。
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { FIBER_PHASE } from './compat.js'
 import { rowIdOf } from '../infra/paths.js'

package/lib/server/domain/skills.js

@@ -1,5 +1,5 @@
 // L1 · domain —— skills.js（分层 Step 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, writeFileSync, existsSync, rmSync, readdirSync, mkdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'

package/lib/server/domain/sources.js

@@ -1,5 +1,5 @@
 // L1 · domain —— sources.js（分层 Step 从 lib/index.js 搬出，只搬移未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, rmSync } from 'node:fs'
 import { writeFile } from 'node:fs/promises'

package/lib/server/domain/suite.js

@@ -1,5 +1,5 @@
 // L1 · domain —— suite.js（聚合套装：.gitmodules 解析 / 预设目录发现 / 包入口存在性；分层 Step 5 从 lib/index.js 搬出，只搬移未改逻辑。注：runSuiteInstallJob 含 ctx，留到 Step 8）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md 三
+// 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, existsSync, rmSync, readdirSync, mkdirSync } from 'node:fs'
 import { dirname, join, basename } from 'node:path'

package/lib/server/infra/exec.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { execFile, spawn, spawnSync } from 'node:child_process'
 import { promisify } from 'node:util'
@@ -44,7 +44,7 @@ function cmdCommandLine(parts) {
     .map((text) => {
       // 2026-09-28 改错（真机：`cmd-corepack` 一条都跑不动 → pnpm-runners / suite-fallback /
       // install-smoke 三套红，报 `cmd-corepack :: status=1 out=""`）：
-      //   `corepack` 在本机是 **cmd 批处理 shim**（`D:\nvm4w\nodejs\corepack.cmd` →
+      //   `corepack` 在 Windows 上常是 **cmd 批处理 shim**（`<node 安装目录>\corepack.cmd` →
       //   `node …\corepack\dist\corepack.js %*`）。对批处理，cmd **不会剥掉参数外层的引号**，
       //   引号会随 `%*` 一路进到 node 的 argv —— 于是 corepack 收到的是 `"pnpm"` / `"--version"`
       //   （带引号当成了包管理器名）→ 直接崩：status=1、stdout 空。

package/lib/server/infra/fsx.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { existsSync, rmSync, readdirSync, mkdirSync, copyFileSync, chmodSync, lstatSync, renameSync } from 'node:fs'
 import { dirname, join, basename } from 'node:path'
@@ -66,9 +66,9 @@ let writeQueue = Promise.resolve()
 
 /**
  * 删除目录树并**核实删除结果**。
- * 为什么要核实：本机某些环境（受限令牌/沙箱/杀软占用）下 `rmSync` 会**静默落空**——不抛错、目录仍在。
+ * 为什么要核实：某些环境（受限令牌/沙箱/杀软占用）下 `rmSync` 会**静默落空**——不抛错、目录仍在。
  * 路由若删完直接 `{ok:true}` 就是对用户撒谎（2026-09-20 多类型演练实测：同一个 `rmSync` 在
- * `D:\dsh\repos` 删得掉，在 `C:\Users\<user>\.dsh\...` 下返回成功但目录原封不动）。
+ * 短路径（如 `C:\repos`）删得掉，在 `C:\Users\<user>\.dsh\...` 下返回成功但目录原封不动）。
  * 返回 `{ok, attempts, error}`；`ok:false` 时调用方必须如实报错，不能吞。
  */
 function removeDirVerified(dir) {

package/lib/server/infra/http.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { execFile } from 'node:child_process'
 import { resolve } from 'node:path'

package/lib/server/infra/httpd.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 /** 写请求跨站防护：浏览器同源策略不阻止跨站发送，必须校验 Origin / Sec-Fetch-Site。

package/lib/server/infra/mask.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 function maskUrl(url) {

package/lib/server/infra/paths.js

@@ -1,5 +1,5 @@
 // L0 · infra（paths.js）—— 分层 Step 从 lib/index.js 搬出，只搬移未改逻辑
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 import { readFileSync, existsSync, statSync } from 'node:fs'
 import { dirname, join, resolve } from 'node:path'

package/lib/server/infra/semver.js

@@ -1,5 +1,5 @@
 // 由 Step 1 搬运工具从 lib/index.js 原样切出（只移动、未改逻辑）
-// 分组见 D:\dsh\dsh-plugin-hub-plan\architecture.zh.md §三 L0 · infra
+// 分层分组：L0 · infra（边界由 tests/test-architecture-guard.mjs 断言）
 
 
 /** 最小 semver：解析（含 prerelease/build）。 */

package/lib/server/routes/components.js

@@ -109,7 +109,7 @@ async function routeRepoLandConfig(req, res, rc) {
   const body = rc.body
     const dir = typeof body.dir === 'string' ? body.dir.trim() : ''
     if (dir === '' || !/^[A-Za-z]:[\\/]/.test(dir) && !/^\\\\/.test(dir)) {
-      // 0.5.28 改错：示例原本写成本机真实目录 `D:\dsh\repos`（把开发者的目录当成了通用示例）。
+      // 0.5.28 改错：示例原本写成本机真实目录（把开发者的目录当成了通用示例）。
       // 换成中性的任意绝对路径示例，并说明"任意绝对路径"——判据是形状（盘符/UNC），不是具体目录。
       sendError(res, 400, '保存路径不合法：请提供绝对路径（任意绝对路径均可，如 C:\\repos 或 \\\\server\\share\\repos）')
       return

package/lib/server/routes/framework-upgrade.js

@@ -1,7 +1,6 @@
 // L2 · routes —— 框架升级（POST /framework-upgrade）
-// 分层 Step 8b：从 lib/index.js 的 handle() 原样搬出（只搬移未改逻辑）。
-// 注：这个 handler 661 行（内置大段 PowerShell 脚本模板），是守卫「单文件 ≤ 600 行」的受限例外（见守卫 SIZE_EXCEPTIONS）；
-// 待抽包阶段把脚本模板挪进 domain/framework-script.js 后撤销例外。
+// 分层 Step 8b：从 lib/index.js 的 handle() 原样搬出（只搬移未改逻辑）。这个 handler 内置大段
+// PowerShell 脚本模板，是守卫「单文件 ≤ 600 行」的受限例外（见 SIZE_EXCEPTIONS），待抽包阶段撤销。
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
 import { writeFile } from 'node:fs/promises'
@@ -11,7 +10,7 @@ import { tmpdir } from 'node:os'
 import { pathToFileURL } from 'node:url'
 import { createRequire } from 'node:module'
 import { readCompatMode, writeCompatMode } from '../domain/compat-state.js'
-import { FRAMEWORK_BACKUP_ROOT, backupProfileSnapshot, checkpointFrameworkTree, preflightDisableIncompatible, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, resolveFrameworkUpgradePlan, shellHostedRefusal } from '../domain/framework.js'
+import { FRAMEWORK_BACKUP_ROOT, backupProfileSnapshot, checkpointFrameworkTree, platformUpgradeRefusal, preflightDisableIncompatible, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, resolveFrameworkUpgradePlan, shellHostedRefusal } from '../domain/framework.js'
 import { fwIntegrityCheck } from '../infra/fw-integrity-check.js'
 import { CORE_PATCH_ROW_IDS } from '../domain/patch.js'
 import { migrateAgentConfigsForUpgrade } from '../domain/presets.js'
@@ -80,12 +79,15 @@ async function routeFrameworkUpgrade(req, res, rc) {
       } catch {}
     }
     // 拉元数据 → 候选版本列表 → 本次目标（helper 里同时做「用户自选版本」的白名单校验）
-    const plan = await resolveFrameworkUpgradePlan({ current, wanted: body.version, fetchJson: fetchJsonUrl })
+    const plan = await resolveFrameworkUpgradePlan({ current, wanted: body.version, fetchJson: rc.deps.fetchJson ?? fetchJsonUrl })
     const { latest, next, alpha, versions, tagDefault, registryError } = plan
     if (plan.rejected !== null) {
       sendError(res, 400, `升级目标 ${plan.rejected} 不在可选列表内（只接受比当前 ${current ?? '?'} 更新的已发布版本；降级请用「回滚到上一版」）`)
       return
     }
+    // 平台守卫（2026-09-29 改错）：本通道 = schtasks.exe + PowerShell，只有 win32 有；判据与文案见
+    // domain/framework.js#platformUpgradeRefusal。放在入参校验之后、任何副作用之前 —— 绝不假成功。
+    const platformRefusal = platformUpgradeRefusal(); if (platformRefusal !== null) { sendError(res, 501, platformRefusal.error, platformRefusal.details); return }
     const target = plan.target
     const profileDir = dirname(findPatchPath(ctx))
     // 1) 升级前打包备份现有配置（patch / profile package.json / 插件清单）
@@ -138,17 +140,16 @@ async function routeFrameworkUpgrade(req, res, rc) {
         steps.push(`另有 ${preflight.skipped.length} 行无法预判（受保护行/包信息读不到），保持启用，由升级后的启动失败隔离兜底`)
       }
     }
-    // 2) 自动升级框架：运行中的服务锁着 dsh/lib 目录（EBUSY 无法原地替换），
-    //    因此生成独立升级脚本（kill 服务 → npm 升级 → 失败回滚 → 拉起服务），后台执行。
-    //    与 /restart 同款自守护模式：端口无监听会自动拉起，不会留下"服务起不来"。
+    // 2) 自动升级框架：运行中的服务锁着 dsh/lib 目录（EBUSY 无法原地替换）→ 生成独立升级脚本
+    //    （kill 服务 → npm 升级 → 失败回滚 → 拉起服务）后台执行；与 /restart 同款自守护，不会留下"服务起不来"。
     if (hasUpdate && dshDir !== null) {
       const port = webPort(ctx)
       const nodePath = process.execPath
       const binPath = resolveDshBin()
       const npmCli = join(dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')
       // 事故教训：npm 的 lib/cli.js 是「函数模块」（module.exports = (process) => validateEngines(...)），
-      // 直跑 `node lib/cli.js` 只加载函数定义、不执行命令——立即退出 exit 0（假成功，曾导致
-      // "npm 退出码 0 但版本未更新"）。唯一正确入口是 bin/npm-cli.js（它调用 cli.js 函数）。
+      // 直跑它只加载函数定义、不执行命令——立即退出 exit 0（假成功，"npm 退出码 0 但版本未更新"）。
+      // 唯一正确入口是 bin/npm-cli.js（它调用 cli.js 函数）。
       const corepackJs = join(dirname(process.execPath), 'node_modules', 'corepack', 'dist', 'corepack.js')
       // 预检（事故教训）：corepack（pnpm 通道）/ dsh bin.js 缺失时**拒绝生成升级脚本**（不 kill 服务）——
       // 避免"kill 后升级/拉起双双失败，服务永久 down"
@@ -640,16 +641,14 @@ async function routeFrameworkUpgrade(req, res, rc) {
       setFwCheckCache(null)
       // UTF-8 BOM：powershell 5.1 按 ANSI 读无 BOM 文件，中文会乱码——加 BOM 保证解析正确。
       // 执行方式：schtasks 一次性计划任务（Task Scheduler 启动，独立于服务进程树/Job Object）——
-      // 服务进程被杀时，其子进程（execFile/detached 的 powershell）会被 Job/进程树连带杀死，
-      // 曾多次卡死在「停止服务」之后；计划任务彻底脱离，杀服务绝对影响不到升级脚本。
+      // 服务进程被杀时其子进程（execFile/detached 的 powershell）会被 Job 连带杀死，
+      // 计划任务彻底脱离，杀服务影响不到升级脚本。
       writeFile(ps1, `\uFEFF${lines}`, 'utf8').then(
         () => {
           const ps1Posix = ps1.replace(/\\/gu, '/')
-          // 无引号 /tr（重要）：Task Scheduler 对带引号命令的解析会把 Command 拆坏成
-          // `"powershell ... -File \"`（非有效可执行文件）——任务显示 Ready、/run 报 SUCCESS
-          // 但永不执行（曾导致升级/重启脚本反复"已启动"却不动作、服务不停止）。实测无引号
-          // 格式（exe 与脚本路径均无空格时）任务正常执行、脚本完整跑通。仅当脚本路径含空格
-          // 时才退回带引号格式（schtasks 引号解析在服务 execFile 上下文不可靠，此时宁可用它）。
+          // 无引号 /tr（重要）：Task Scheduler 会把带引号命令的 Command 拆坏成 `"powershell … -File \"`
+          // （非有效可执行文件）——任务显示 Ready、/run 报 SUCCESS 但永不执行（曾导致脚本反复"已启动"
+          // 却不动作）。实测无引号格式（exe 与脚本路径均无空格时）正常；仅脚本路径含空格时才退回带引号格式。
           const tr = / /.test(ps1Posix)
             ? `"powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File \\"${ps1Posix}\\""`
             : `C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File ${ps1Posix}`

package/lib/server/routes/framework.js

@@ -8,7 +8,7 @@ import { dirname, join, resolve } from 'node:path'
 import { tmpdir } from 'node:os'
 import { createRequire } from 'node:module'
 import { readCompatGate, writeCompatGate } from '../domain/compat.js'
-import { cleanupStaleFwTasks, currentFrameworkVersion, pickFrameworkTarget, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, shellHostedRefusal } from '../domain/framework.js'
+import { cleanupStaleFwTasks, currentFrameworkVersion, pickFrameworkTarget, platformUpgradeRefusal, relaunchPrelude, resolveDshBin, resolveFrameworkRootNodeModules, shellHostedRefusal } from '../domain/framework.js'
 import { readGithubAuth } from '../domain/install.js'
 import { webPort } from '../domain/runtime.js'
 import { fetchJsonUrl } from '../infra/http.js'
@@ -32,6 +32,21 @@ function refuseWhenShellHosted(res) {
   return true
 }
 
+/**
+ * 平台守卫（2026-09-29 改错，与宿主守卫同形）：一键升级/回滚脚本整体依赖 Windows 机制 ——
+ * `schtasks.exe` 计划任务 + PowerShell + `Get-NetTCPConnection`；非 Windows 上 execFile 必然 ENOENT，
+ * 而旧实现会先写一个「脚本已启动」的状态文件、再去 exec 不存在的 powershell.exe，**最后仍回 ok:true**
+ * （用户以为在跑，实际零动作）。判据与文案见 domain/framework.js#platformUpgradeRefusal。
+ * 命中时：不写状态文件、不 spawn、不建计划任务，直接 501 + 手动升级出路。
+ * 返回 true = 已拒绝（调用方直接 return）；false = win32，原路径一字不改。
+ */
+function refuseWhenPlatformUnsupported(res) {
+  const refusal = platformUpgradeRefusal()
+  if (refusal === null) return false
+  sendError(res, 501, refusal.error, refusal.details)
+  return true
+}
+
 async function routeFrameworkUpgradeStatusGet(req, res, rc) {
   const ctx = rc.ctx
   const url = rc.url
@@ -355,6 +370,7 @@ async function routeFrameworkRollback(req, res, rc) {
       sendError(res, 409, '没有可用的框架全树回滚点（framework-rollback.json 缺失或 checkpoint 已清理）')
       return
     }
+    if (refuseWhenPlatformUnsupported(res)) return // 平台守卫（改错）：回滚脚本同样是 schtasks+PowerShell，非 win32 一律拒绝而不是假成功（放在只读状态校验之后、任何写盘/exec 之前）
     const port = webPort(ctx)
     const nodePath = process.execPath
     const taskName = `DSH-FW-Rollback-${process.pid}`
@@ -576,4 +592,4 @@ async function routeFrameworkStatusClear(req, res, rc) {
   }
   sendJson(res, 200, { ok: true, removed, status: 'idle', message: null })
 }
-export { refuseWhenShellHosted, routeFrameworkStatusClear, routeFrameworkUpgradeStatusGet, routeFrameworkRelaunch, routeFrameworkCheck, routeCompatGate, routeCheckUpdate, routeFrameworkRollback, routeRestart }
+export { refuseWhenShellHosted, refuseWhenPlatformUnsupported, routeFrameworkStatusClear, routeFrameworkUpgradeStatusGet, routeFrameworkRelaunch, routeFrameworkCheck, routeCompatGate, routeCheckUpdate, routeFrameworkRollback, routeRestart }

package/lib/server/routes/github-login.js

@@ -149,8 +149,8 @@ function shortOpenError(error) {
  * POST /plugin-console/github-open-login —— 唤起 dsh-github-login 的设备码登录窗口。
  *
  * 为什么失败也回 200（而不是 500）：这个能力是**外挂**的，装没装、装的是不是带 exe 的版本、
- * 当前 profile 有没有把它挂到 webServer 上，全都不由本插件决定（2026-09-20 实测：本机虽然装了
- * 该插件、exe 也在 D:\dsh\dsh-github-login\dist\，但当前 profile 下 GET /github-auth/status 仍是
+ * 当前 profile 有没有把它挂到 webServer 上，全都不由本插件决定（2026-09-20 实测：某个 profile 里虽然装了
+ * 该插件、exe 也在，但当前 profile 下 GET /github-auth/status 仍是
  * 404）。这些都是"这个通道现在不可用"，不是"服务端出错"：
  *   · 回 500 → 前端弹一句看不懂的报错，还看不出"该走 token 兜底"这条正路；
  *   · 回 200 + started:false + reason → 前端照原样把原因念给用户，并自动展开 token 粘贴面板。

package/lib/server/routes/index.js

@@ -11,6 +11,7 @@ import { pnpmRemove, readExtraBundleRows, runInstallJob } from '../domain/instal
 import { isProtectedModule, listEntries, webPort } from '../domain/runtime.js'
 import { DEFAULT_SEARCH } from '../domain/sources.js'
 import { runSuiteInstallJob } from '../domain/suite.js'
+import { fetchJsonUrl } from '../infra/http.js'
 import { readBody, sendError } from '../infra/httpd.js'
 import { routeAiConsent, routeAiEmpowerCancel, routeAiEmpowerList, routeAiEmpowerPlan, routeAiEmpowerRun, routeAiEmpowerStatus } from './ai.js'
 import { routeRunSuggested } from './actions.js'
@@ -53,7 +54,9 @@ const ROUTES_EARLY = [
 ]
 
 function routeDeps() {
-  return { runInstallJob, runSuiteInstallJob, webPort, readExtraBundleRows, detectAdoptablePending, listEntries, detectCompat, detectFrameworkUpgrade, DEFAULT_SEARCH, aiEmpowerExecute, aiEmpowerPlan, backupProfileSnapshot, currentFrameworkVersion, frameworkCompatReportFor, isProtectedModule, pnpmRemove, preflightDisableIncompatible, rowIdModuleMap }
+  // fetchJson：registry 元数据取数的注入缝（默认就是真通道）。测试要断言「非 win32 拒绝且零副作用」
+  // 时用它喂固定元数据，免得把网络与 CI 稳定性绑在一起（与其余 deps 同一种注入风格）。
+  return { runInstallJob, runSuiteInstallJob, webPort, readExtraBundleRows, detectAdoptablePending, listEntries, detectCompat, detectFrameworkUpgrade, DEFAULT_SEARCH, aiEmpowerExecute, aiEmpowerPlan, backupProfileSnapshot, currentFrameworkVersion, frameworkCompatReportFor, isProtectedModule, pnpmRemove, preflightDisableIncompatible, rowIdModuleMap, fetchJson: fetchJsonUrl }
 }
 
 async function handle(ctx, req, res) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.30",
+  "version": "0.5.31",
   "description": "DSH 框架升级安全与插件升级门控：一键升级、失败自动回滚、升级后回滚上版、旧插件不适配自动禁用；内置多源插件市场为发现层，插件源全部可自定义，可指向公司内网私有源 / 私有索引 / 本地 Git 仓库，纯内网离线可用 | Framework upgrade safety & plugin version gating for DSH, with a customizable multi-source plugin market: point every source at internal mirrors or a local file:// repo for intranet-only, offline installs.",
   "repository": {
     "type": "git",