@noob-stupid/dsh-plugin-console 0.5.27 → 0.5.29

package/lib/client.js

@@ -309,7 +309,11 @@ window.__ModuleLoader__.load({
 			diagIntegrityNone: "来源无摘要，未校验",
 			diagIntegrityMismatch: "摘要不匹配（已安装，未拦截）",
 			diagIntegritySkip: "摘要未校验（读取失败，不影响安装）",
-			presetDot: "。预设：新建会话时选择",
+			// 0.5.28 改错：框架 0.1.7-rc.x 起预设改为**声明行**（不再扫 .agent-presets 目录），
+			// "新建会话时选择"对没写成声明行的预设是错的。可见性由服务端下发的 presetNote 说清
+			// （「已声明为预设行 … 重启实例后在新会话可选」／「文件已就位，但…需要声明行」），
+			// 这里只留一句中性提示，不再替服务端断言"选了就能用"。
+			presetDot: "。预设：见上方说明（需要声明行才会出现在选择器里）",
 			presetInstalledMsg: "预设已装配",
 			diagChannelNotes: "通道说明",
 			direct: "（浏览器直连 GitHub；若你的浏览器打不开 GitHub，将自动回退到服务端通道）",
@@ -593,7 +597,7 @@ window.__ModuleLoader__.load({
 			frameworkUpgradeMore: "展开全部可选版本（{n}）",
 			// 升级前契约预检（2026-09-24 事故：v4 消息格式变更让运行期生产方全部失效）
 			fwPreflightBtn: "升级预检",
-			fwPreflightTitle: "升级前契约预检：抓目标版本的会话格式契约（迁移边），扫描 agent-presets 与已装插件里的旧形状消息来源；可一键适配并自动备份（.bak-preflight-*）",
+			fwPreflightTitle: "升级前契约预检：抓目标版本的会话格式契约（迁移边），扫描 .agent-presets 与已装插件里的旧形状消息来源；可一键适配并自动备份（.bak-preflight-*）",
 			fwPreflightRunning: "预检中…",
 			fwPreflightClean: "预检通过：本地生产方没有会触发格式校验的旧写法",
 			fwPreflightFound: "预检发现 {n} 处必须适配（另有 {m} 处提示）",
@@ -848,7 +852,7 @@ window.__ModuleLoader__.load({
 			diagIntegrityNone: "No digest from source; not verified",
 			diagIntegrityMismatch: "Digest mismatch (installed, not blocked)",
 			diagIntegritySkip: "Digest not verified (read failed; install unaffected)",
-			presetDot: ". Preset: pick it when starting a new session",
+			presetDot: ". Preset: see the note above (a declaration row is required for it to appear)",
 			presetInstalledMsg: "Presets installed",
 			diagChannelNotes: "Channel notes",
 			direct: "(The browser calls GitHub directly; the server channel is used as fallback.)",
@@ -1132,7 +1136,7 @@ window.__ModuleLoader__.load({
 			frameworkUpgradeMore: "Show all available versions ({n})",
 			// Pre-upgrade contract preflight (2026-09-24 incident: v4 message-format change broke every runtime producer)
 			fwPreflightBtn: "Pre-upgrade preflight",
-			fwPreflightTitle: "Pre-upgrade contract preflight: fetch the target session-format contract (migration edges) and scan agent-presets + installed plugins for legacy message sources; one click adapts with .bak-preflight-* backups",
+			fwPreflightTitle: "Pre-upgrade contract preflight: fetch the target session-format contract (migration edges) and scan .agent-presets + installed plugins for legacy message sources; one click adapts with .bak-preflight-* backups",
 			fwPreflightRunning: "Preflighting…",
 			fwPreflightClean: "Preflight passed: no legacy producer shape that would fail format validation",
 			fwPreflightFound: "Preflight found {n} blockers to adapt ({m} advisories)",

package/lib/server/domain/ai.js

@@ -209,7 +209,10 @@ 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）。',
-    '- 用户名含中文（花火）：任何写盘路径若含中文，各语言的 Rust/原生向量库会报 UnicodeDecodeError——服务数据目录必须纯 ASCII（如 `D:/OpenVikingData`）。',
+    // 0.5.28 改错：这条原本把它写成"本机用户名含中文（花火）"的**个案**，读起来像只在
+    // 那台机器上成立。真正的规则是通用的：只要**写盘路径**里出现非 ASCII 字符，各语言的
+    // Rust/原生向量库就可能报 UnicodeDecodeError —— 与用户名具体是不是中文无关。
+    '- 用户名/路径含非 ASCII 字符时：任何写盘路径若含非 ASCII 字符，各语言的 Rust/原生向量库会报 UnicodeDecodeError——服务数据目录必须纯 ASCII（如 `D:/OpenVikingData`）。',
     '- 凭据复用：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。',
   ]

package/lib/server/domain/format-scan.js

@@ -1,7 +1,10 @@
 // L1 · domain —— format-scan.js：会话格式契约预检（Step 2 · 本地生产方扫描 + 补丁）
 //
 // 扫描面（这次事故的三类生产方，正是它们让「一发消息就炸」）：
-//   ① ~/.dsh/agent-presets/**  —— 用户自己的 agent 预设（10 个文件 11 处）
+//   ① ~/.dsh/.agent-presets/** —— 用户自己的 agent 预设（10 个文件 11 处）
+//      （★ 2026-09-27 改错：这里旧注释写成 `~/.dsh/agent-presets/**`，**少一个点**。
+//       框架的目录是 `.agent-presets`（旧 discovery 的 USER_PRESET_DIR），routes/framework-preflight.js
+//       的扫描面也跟着错了同一个字 —— 于是预检**从未**扫到预设，升级前"0 blocker"是假绿。）
 //   ② profile 内已装插件包里的运行时代码 —— agent.inject / createUserMessage 的构造点（3 处）
 //   ③ 插件里引用了目标版本已移除的框架 API（报告项，不自动改）
 //

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

@@ -72,6 +72,8 @@ function channelImpls(ports) {
  *    属无意义尝试）**并保留 !expanded**（同一作业里对同一个 job.repo 反复 clone 纯属浪费时间，
  *    级联顺序也不该被破坏）。 */
 async function tryCandidateChannels({ job, ch, name, profileDir, registries, repoChannelAllowed, budget, baseUrl = null, expanded = false, deadline = null, expand = null, sourceDeps = {} }) {
+  // 声明行的目标 profile（0.5.28）：框架 0.1.7-rc.x 起预设不再靠目录发现，装配后必须往这个 profile 的补丁写 `preset-<id>` 行，否则用户看不见（见 preset-declare.js 顶部）。
+  const patchPath = join(profileDir, 'cordis.patch.yml')
   let installedName = null
   let lastError = null
   // 加法优化：包已在 node_modules 且名字匹配时，不再重复安装/触发 EPERM，直接进入启用流程
@@ -219,7 +221,7 @@ async function runInstallJob(job, ports, deps = {}) {
     probes.expandSubpackages = (opts = {}) => expandSubpackageCandidates({ ...opts, deps: { fetchSubpackageNames: probes.fetchSubpackageNames } })
   }
   const jobBudgetMs = Number.isFinite(deps.jobBudgetMs) && deps.jobBudgetMs > 0 ? deps.jobBudgetMs : 8 * 60 * 1000
-  // 源码通道（体积门禁 + 稀疏取源码 + 预设装配）的注入缝：与 marketProbes 同一风格，生产调用方不传
+  // 源码通道（体积门禁 + 稀疏取源码 + 预设装配）的注入缝：与 marketProbes 同一风格，生产调用方不传。
   const sourceDeps = deps.sourceDeps ?? {}
   const aiConsentTimeoutMs = Number.isFinite(deps.aiConsentTimeoutMs) && deps.aiConsentTimeoutMs > 0 ? deps.aiConsentTimeoutMs : AI_CONSENT_TIMEOUT_MS
   /** 「安装即声明」的收尾（三个调用点共用一个出口）：清单写回结果 → job 上的可见字段。
@@ -544,7 +546,6 @@ async function runInstallJob(job, ports, deps = {}) {
     job.finishedAt = Date.now()
   }
 }
-
 /** 用 corepack pnpm 移除包（与安装同一管理器与凭据抑制环境）。
  * 注意：pnpm remove 不支持 --registry 选项，去掉避免静默失败。 */
 async function pnpmRemove(profileDir, packageName) {
@@ -562,7 +563,6 @@ async function pnpmRemove(profileDir, packageName) {
   // 与 pnpmInstall 同一套跨平台定位（Linux 的 corepack 不在 <node bin>/node_modules 下）
   await runPnpmWithFallback(args, { execOpts: opts })
 }
-
 /** 读取用户额外 bundle（非官方模板）的补丁插入行 id 与包名，用于"额外插件"判定。 */
 async function readExtraBundleRows(profileDir) {
   const rows = new Set()