dsh-paoding 0.2.2 → 0.3.0

package/tools/lib/util.mjs

@@ -13,6 +13,13 @@ export const SRC_DIR = path.join(REPO_ROOT, 'presets', 'orchestrator')
 
 export const ROLES = ['search_external', 'design', 'implement']
 
+/**
+ * profile 名白名单（bin/dsh-paoding.mjs 与 lib/cli.mjs 两处共用，抽在此处防两边
+ * 漂移）：首字符字母数字，其余限 [A-Za-z0-9._-] —— profile 名会被拼进 dsh 子进程
+ * 命令行（win32 经 shell 拼接），在解析源头就排除空格与 shell 元字符。
+ */
+export const PROFILE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/
+
 /**
  * 主 agent persona 尾部追加规则（默认值）。
  * 用户可在配置 UI 的「人设追加」里编辑/清空；配置键 main_agent_persona_extra：

package/tools/lib/version.mjs

@@ -0,0 +1,233 @@
+/**
+ * 版本提示 —— 检测线上是否有比本地更新的版本（Web 面板 + CLI 共用）。
+ *
+ * 检测源两级：npm registry 的 dist-tags/latest 优先（无认证无限流，发布即
+ * 可见，不像 GitHub release 需要另行打 tag），GitHub releases/latest 兜底。
+ *
+ * 零依赖纯 Node（>=18）：不引 cordis / npm 依赖，fetch 可注入（缺省用
+ * globalThis.fetch），超时用 AbortSignal.timeout()。所有失败路径都不抛错，
+ * 一律收敛为 { ok: false, error } 或带 error 字段的结果对象——调用方
+ * （面板 / CLI 收尾）按「失败即静默」处理，绝不影响主流程。
+ *
+ * 放在 tools/lib（而非 plugins/paoding-config-ui/lib）的理由：插件 UI → tools
+ * 核心的跨树依赖是既有方向（api-core.mjs 已 import '../../tools/install.mjs'），
+ * CLI 侧即可就地 import（'./version.mjs'）；npm files 布局包含 tools/，
+ * 仓库检出 / npm 包 / profile 安装三种形态下 '../../package.json'（本文件向上
+ * 两级）都指向包根。
+ */
+import { readFile } from 'node:fs/promises'
+
+// 仓库（与包名一致）的 GitHub latest release 接口与落地页。
+const RELEASE_API = 'https://api.github.com/repos/lifangjin/dsh-paoding/releases/latest'
+const RELEASE_PAGE = 'https://github.com/lifangjin/dsh-paoding/releases/latest'
+// npm registry 的 latest 元数据端点（等价 dist-tags.latest，无认证无限流）。
+const REGISTRY_LATEST = 'https://registry.npmjs.org/dsh-paoding/latest'
+
+// 读不到 package.json 时的版本兜底。当前版本不可知（source: 'fallback'）时
+// updateAvailable 恒 false —— 拿「0.0.0 恒小于任何真实版本」去比较，反而必然
+// 对任何 latest 误报新版，升级提示必须整体抑制（读不到版本就不提示）。
+const FALLBACK_VERSION = '0.0.0'
+
+// 内存缓存 TTL：1 小时内复用上次成功结果，过期才真的发外网请求。
+const CACHE_TTL_MS = 60 * 60 * 1000
+// 请求失败时的 stale-if-error 窗口：上次成功结果在 7 天内仍原样复用（lastGood）。
+// 窗口刻意明显大于新鲜 TTL（7 天 >> 1 小时，旧值 10 分钟比 TTL 还短，分支永远
+// 不可达 = 死逻辑）：外网偶发抖动不该立刻撤掉本可用的升级提示；超窗才返回 error。
+const LASTGOOD_TTL_MS = 7 * 24 * 60 * 60 * 1000
+
+// 模块级缓存：只在成功后写入；失败结果不进缓存（下次调用仍会重试）。
+let cache = { at: 0, info: null }
+
+/**
+ * 本地版本：读包根 package.json 的 version。读失败（文件缺失 / 解析失败 /
+ * 字段异常）回退 FALLBACK_VERSION 并标记 source: 'fallback'。
+ * @returns {Promise<{version: string, source: 'package.json'|'fallback'}>}
+ */
+export async function currentVersion() {
+  try {
+    const raw = await readFile(new URL('../../package.json', import.meta.url), 'utf8')
+    const pkg = JSON.parse(raw)
+    if (typeof pkg?.version === 'string' && pkg.version !== '') {
+      return { version: pkg.version, source: 'package.json' }
+    }
+  } catch {
+    /* 静默回退：版本读取失败不该打扰任何主流程 */
+  }
+  return { version: FALLBACK_VERSION, source: 'fallback' }
+}
+
+/** 拆版本号：剥前缀 v/V，按 '.' 切数值段，`-` 后为预发布后缀（原样保留）。 */
+function parseVersion(value) {
+  let s = String(value ?? '').trim()
+  if (s.startsWith('v') || s.startsWith('V')) s = s.slice(1)
+  const dash = s.indexOf('-')
+  const coreText = dash === -1 ? s : s.slice(0, dash)
+  const pre = dash === -1 ? '' : s.slice(dash + 1)
+  const core = coreText.split('.').map((n) => {
+    const x = parseInt(n, 10)
+    return Number.isFinite(x) ? x : 0
+  })
+  return { core, pre }
+}
+
+/**
+ * 版本比较（可测纯函数）：a < b 返回 -1，相等返回 0，a > b 返回 1。
+ * 简化语义（不追求完整 semver）：剥前缀 v/V 后按 '.' 逐段数值比较，缺段补 0；
+ * 核心段相同时带预发布后缀（如 0.3.0-rc.1）视为低于无后缀同版本，两个都有
+ * 预发布后缀则按字符串比较。
+ */
+export function compareVersions(a, b) {
+  const pa = parseVersion(a)
+  const pb = parseVersion(b)
+  const len = Math.max(pa.core.length, pb.core.length)
+  for (let i = 0; i < len; i++) {
+    const x = pa.core[i] ?? 0
+    const y = pb.core[i] ?? 0
+    if (x !== y) return x < y ? -1 : 1
+  }
+  if (pa.pre !== pb.pre) {
+    if (pa.pre === '') return 1 // 无后缀 > 有后缀
+    if (pb.pre === '') return -1
+    return pa.pre < pb.pre ? -1 : pa.pre > pb.pre ? 1 : 0
+  }
+  return 0
+}
+
+/**
+ * 请求 GitHub latest release。任何失败（网络 / 超时 / 限流 / 解析）都不抛出，
+ * 返回 { ok: false, error }；仓库尚无 release（404）不算错误，返回
+ * { ok: true, tag: null, url: null, notFound: true }。成功返回
+ * { ok: true, tag: 'vX.Y.Z', url: releasePage }。
+ */
+export async function fetchLatestRelease({ fetchImpl, timeoutMs = 3000 } = {}) {
+  const doFetch = typeof fetchImpl === 'function' ? fetchImpl : globalThis.fetch
+  if (typeof doFetch !== 'function') return { ok: false, error: 'fetch 不可用（当前运行时无 fetch 实现）' }
+  // GitHub API 必须带 User-Agent，顺手报上包名与本地版本便于排障。
+  const { version } = await currentVersion()
+  try {
+    const res = await doFetch(RELEASE_API, {
+      headers: {
+        'user-agent': `dsh-paoding/${version}`,
+        accept: 'application/vnd.github+json',
+      },
+      signal: AbortSignal.timeout(timeoutMs),
+    })
+    if (res.status === 404) return { ok: true, tag: null, url: null, notFound: true }
+    if (!res.ok) {
+      // 非 404 失败（403 限流、5xx 等）：带上 GitHub 的 message 便于排障
+      //（典型如未认证配额用尽的 rate limit 提示），仍按失败静默收敛。
+      let detail = ''
+      try {
+        const body = await res.json()
+        if (body && typeof body.message === 'string' && body.message !== '') detail = `: ${body.message}`
+      } catch {
+        /* 正文非 JSON 时忽略，只报状态码 */
+      }
+      return { ok: false, error: `GitHub API HTTP ${res.status}${detail}` }
+    }
+    let data = null
+    try {
+      data = await res.json()
+    } catch (err) {
+      return { ok: false, error: `GitHub API 响应解析失败: ${err?.message ?? err}` }
+    }
+    const tag = typeof data?.tag_name === 'string' && data.tag_name !== '' ? data.tag_name : null
+    if (!tag) return { ok: false, error: 'GitHub API 响应缺少 tag_name' }
+    const url = typeof data?.html_url === 'string' && data.html_url !== '' ? data.html_url : RELEASE_PAGE
+    return { ok: true, tag, url }
+  } catch (err) {
+    return { ok: false, error: String(err?.message ?? err) }
+  }
+}
+
+/**
+ * 请求 npm registry 的 latest 元数据（版本检测的首选源，runUpgrade 也复用）。
+ * 任何失败（网络 / 超时 / 解析 / 形状不对）都不抛出，返回 { ok: false, error }；
+ * 成功返回 { ok: true, latest: 'vX.Y.Z', releaseUrl, source: 'npm' }（registry
+ * 的 version 不带 v 前缀，这里统一补齐，与 GitHub tag 的显示口径一致）。
+ */
+export async function fetchLatestFromRegistry({ fetchImpl, timeoutMs = 3000 } = {}) {
+  const doFetch = typeof fetchImpl === 'function' ? fetchImpl : globalThis.fetch
+  if (typeof doFetch !== 'function') return { ok: false, error: 'fetch 不可用（当前运行时无 fetch 实现）' }
+  try {
+    const res = await doFetch(REGISTRY_LATEST, {
+      headers: { accept: 'application/vnd.npm+json' },
+      signal: AbortSignal.timeout(timeoutMs),
+    })
+    if (!res.ok) return { ok: false, error: `npm registry HTTP ${res.status}` }
+    let data = null
+    try {
+      data = await res.json()
+    } catch (err) {
+      return { ok: false, error: `npm registry 响应解析失败: ${err?.message ?? err}` }
+    }
+    // /<name>/latest 返回该版本的完整 manifest，顶层 version 即 latest 版本号；
+    // CDN 缓存抖动可能回形状不对的正文，按失败处理走 GitHub 兜底。
+    const ver = typeof data?.version === 'string' && data.version !== '' ? data.version : null
+    if (!ver) return { ok: false, error: 'npm registry 响应缺少 version' }
+    return { ok: true, latest: `v${ver}`, releaseUrl: RELEASE_PAGE, source: 'npm' }
+  } catch (err) {
+    return { ok: false, error: String(err?.message ?? err) }
+  }
+}
+
+/**
+ * 组合结果（面板路由与 CLI 收尾共用）：带 1 小时内存缓存，过期才重新请求；
+ * 请求失败时若上次成功结果在 lastGood 窗口（7 天，见 LASTGOOD_TTL_MS）内则
+ * 原样复用（stale-if-error），否则返回带 error 的降级结果（latest 置 null、
+ * updateAvailable 恒 false——调用方静默）。当前版本不可知（FALLBACK_VERSION
+ * 兜底）时 updateAvailable 恒 false：0.0.0 对任何 latest 都「更小」，比较必
+ * 误报新版，升级提示整体抑制。检测源 npm registry 优先，失败再试 GitHub
+ * release；双败才算本次检测失败，error 里带上两级的失败原因便于排障。成功
+ * 结果的 source 字段记录命中源。
+ * @param {{fetchImpl?: Function, timeoutMs?: number, now?: Function|number}} opts
+ *   now 可注入函数或时间戳（测试用）；缺省 Date.now()。
+ * @returns {Promise<{current: string, latest: string|null, updateAvailable: boolean,
+ *           releaseUrl: string|null, checkedAt: string, error: string|null,
+ *           source: 'npm'|'github'|null}>}
+ */
+export async function getVersionInfo({ fetchImpl, timeoutMs = 3000, now } = {}) {
+  const nowMs = typeof now === 'function' ? now() : typeof now === 'number' ? now : Date.now()
+  if (cache.info && nowMs - cache.at < CACHE_TTL_MS) return cache.info
+  const { version: current, source: currentSource } = await currentVersion()
+  // ① npm registry 优先；② 失败时 GitHub releases/latest 兜底。
+  const reg = await fetchLatestFromRegistry({ fetchImpl, timeoutMs })
+  let hit = null
+  let githubErr = null
+  if (reg.ok) {
+    hit = reg
+  } else {
+    const rel = await fetchLatestRelease({ fetchImpl, timeoutMs })
+    if (rel.ok) hit = { ok: true, latest: rel.tag, releaseUrl: rel.url, source: 'github' }
+    else githubErr = rel.error
+  }
+  if (hit && hit.ok) {
+    const info = {
+      current,
+      latest: hit.latest ?? null,
+      // 当前版本不可知（fallback 0.0.0）时不提示升级，latest 缺失同理。
+      updateAvailable:
+        currentSource === 'fallback' || !hit.latest ? false : compareVersions(current, hit.latest) < 0,
+      releaseUrl: hit.releaseUrl ?? null,
+      checkedAt: new Date(nowMs).toISOString(),
+      error: null,
+      source: hit.source ?? null,
+    }
+    cache = { at: nowMs, info }
+    return info
+  }
+  // 双失败：优先复用 lastGood 窗口（7 天）内的上次成功结果；超窗才给降级结果
+  // （不写缓存）。error 把 registry 与 GitHub 两级原因都带上（谁挂了一目了然）；
+  // 走到这里 githubErr 必有值（能进兜底说明 registry 已失败），无需再兜底文案。
+  const combined = `${reg.error}；GitHub 兜底也失败: ${githubErr}`
+  if (cache.info && nowMs - cache.at < LASTGOOD_TTL_MS) return cache.info
+  return {
+    current,
+    latest: null,
+    updateAvailable: false,
+    releaseUrl: null,
+    checkedAt: new Date(nowMs).toISOString(),
+    error: combined,
+    source: null,
+  }
+}

package/tools/lib/workspaces.mjs

@@ -0,0 +1,74 @@
+/**
+ * 工作区 slug 与 preset id：工作区目录路径 → 稳定的 preset 目录名后缀。
+ * sanitizeSlugBase 取 basename 归一成合法 id 片段（DSH preset 目录名约束
+ * /^[a-z0-9][a-z0-9-]*$/），stableHash 用 sha1 前 6 位给冲突路径加后缀，
+ * assignSlugs 对整组路径一次性分配（同 basename 冲突才加 hash，非冲突路径
+ * 保持可读的裸 basename），presetIdOf 拼出最终 preset id。
+ * 仅依赖 node:crypto / node:path；被 state（工作区 preset 落盘定位）引用，
+ * 并经 tools/install.mjs re-export 供插件侧（api-core 的 workspaceMeta）消费。
+ */
+import { createHash } from 'node:crypto'
+import path from 'node:path'
+
+/**
+ * basename → slug 片段：小写；[^a-z0-9-]+ 折叠为 '-'；去首尾 '-'。
+ * 空串（如 basename 为 '/' 或全非法字符）与保留名 'orchestrator'（会撞基础
+ * preset 本体）一律回落 'ws'，保证结果永远是合法且不冲突的 id 片段。
+ */
+export function sanitizeSlugBase(base) {
+  let slug = String(base ?? '')
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+  if (slug === '' || slug === 'orchestrator') slug = 'ws'
+  return slug
+}
+
+/** 稳定短哈希：sha1 hex 前 6 位。只用于 slug 冲突消解，非安全用途。 */
+export function stableHash(str) {
+  return createHash('sha1').update(String(str)).digest('hex').slice(0, 6)
+}
+
+/**
+ * 给一组工作区绝对路径分配 slug（Map<path, slug>）：basename 互不冲突的路径
+ * 直接用 basename；同 basename 的多个路径（含重复路径）各自加 stableHash(path)
+ * 后缀。先数后派两趟走，保证同一批输入下每个路径的 slug 稳定且互不相同；
+ * 分配完再做一次 Set 唯一性断言——basename+hash 组合仍可能相撞（如某路径的
+ * basename 恰为另一路径的 `<base>-<hash>` 形态），冲突者追加一层 hash 后缀
+ * 重试，直到全组互不相同。
+ */
+export function assignSlugs(paths) {
+  const list = (Array.isArray(paths) ? paths : []).map((p) => String(p)).filter((p) => p !== '')
+  const baseCount = new Map()
+  for (const p of list) {
+    const base = sanitizeSlugBase(path.basename(p))
+    baseCount.set(base, (baseCount.get(base) ?? 0) + 1)
+  }
+  const out = new Map()
+  for (const p of list) {
+    const base = sanitizeSlugBase(path.basename(p))
+    out.set(p, baseCount.get(base) > 1 ? `${base}-${stableHash(p)}` : base)
+  }
+  // 唯一性断言 + 冲突消解：按插入序扫一遍，撞名者依次试 `<slug>-<hash(p#n)>`。
+  // hash 输入含完整路径与轮次，实际上第一轮即唯一；上限兜底防病态输入死循环。
+  const seen = new Set()
+  for (const [p, slug] of out) {
+    if (!seen.has(slug)) {
+      seen.add(slug)
+      continue
+    }
+    let candidate = slug
+    for (let round = 1; seen.has(candidate) && round <= 64; round++) {
+      candidate = `${slug}-${stableHash(`${p}#${round}`)}`
+    }
+    if (seen.has(candidate)) throw new Error(`assignSlugs: cannot derive a unique slug for ${p}`)
+    out.set(p, candidate)
+    seen.add(candidate)
+  }
+  return out
+}
+
+/** 工作区 slug → preset id（即 .agent-presets/ 下的目录名）。 */
+export function presetIdOf(slug) {
+  return `orchestrator-${slug}`
+}

package/tools/lib/yaml.mjs

@@ -14,7 +14,7 @@ import { warn } from './util.mjs'
 
 /**
  * Resolve the `yaml` package from $DSH_HOME/node_modules via createRequire.
- * The directory is typically a symlink into dsh's npx node_modules, which
+ * The directory is managed by the dsh host (profile installs included), which
  * ships yaml v2.  Returns null when unavailable — callers then use the
  * built-in fallback parser.
  */
@@ -78,16 +78,56 @@ export function parsePatchFile(file, yamlMod) {
   }
 }
 
+/** 块标量值标记行：`|` / `>` 及裁剪（-）/保留（+）/显式缩进指示符（数字）的
+ * 全部组合变体（如 `|-`、`|2`、`|2-`、`>-`），两个指示符先后顺序均兼容。 */
+const BLOCK_SCALAR_MARKER_RE = /^[|>][+-]?\d*[+-]?$/
+
 /**
  * Minimal YAML subset parser, used only for patch files when `yaml` is
  * unavailable.  Supports: top-level list items, nested maps, scalar values
  * (single/double-quoted strings, numbers, true/false), `#` comments and
- * `- insert:` wrapping.
+ * `- insert:` wrapping.  Map keys may be quoted（workspaces 的路径键一律带
+ * 引号落盘，见 unquoteKey）—— 嵌套 map + 带引号键按同款规则解析。
+ * 块标量（| > 变体）正文原样保留：注释与空行在块标量里是数据不是结构，
+ * 预处理不得剥除（此前 loadConfig→saveConfig 会把 persona 里的注释/空段
+ * 静默抹掉）。两趟走：先在原文上标出块标量正文行，再只对结构行做剥注释/
+ * 丢空行。
  */
 export function parseYamlSubset(text) {
+  const rawLines = text.split(/\r?\n/)
+  // 第一趟：标记块标量正文行。结构行（剥注释后）以块标量标记结尾即开块，
+  // 其后「空行或缩进更深」的原文行都是正文（与 consumeBlockScalar 的相对
+  // 深度判定一致），直到缩进 <= 键缩进的结构行收块。
+  const inBody = new Array(rawLines.length).fill(false)
+  let bodyIndent = -1
+  for (let i = 0; i < rawLines.length; i++) {
+    const raw = rawLines[i]
+    if (bodyIndent !== -1) {
+      if (raw.trim() === '' || raw.match(/^[ \t]*/)[0].length > bodyIndent) {
+        inBody[i] = true
+        continue
+      }
+      bodyIndent = -1 // 落到下方按结构行处理
+    }
+    const stripped = stripInlineComment(raw).replace(/[ \t]+$/, '')
+    if (stripped.trim() === '') continue
+    const indent = stripped.match(/^[ \t]*/)[0].length
+    const probe = stripped.replace(/^[ \t]*-[ \t]+/, '') // 列表项 `- key: |-` 同款判定
+    if (looksLikeKeyValue(probe)) {
+      const [, value] = splitKeyValue(probe)
+      if (value !== undefined && BLOCK_SCALAR_MARKER_RE.test(value)) bodyIndent = indent
+    }
+  }
+  // 第二趟：结构行剥注释/去尾空白/丢空行；正文行整行原样入列（body 标记
+  // 供 consumeBlockScalar 跳过缩进判定，空行/浅缩进注释都算正文）。
   const lines = []
-  for (const raw of text.split(/\r?\n/)) {
-    const line = stripInlineComment(raw).replace(/[ \t]+$/, '')
+  for (let i = 0; i < rawLines.length; i++) {
+    if (inBody[i]) {
+      const indent = rawLines[i].match(/^[ \t]*/)[0].length
+      lines.push({ indent, text: rawLines[i].slice(indent), body: true })
+      continue
+    }
+    const line = stripInlineComment(rawLines[i]).replace(/[ \t]+$/, '')
     if (line.trim() === '') continue
     const indent = line.match(/^[ \t]*/)[0].length
     lines.push({ indent, text: line.slice(indent) })
@@ -107,7 +147,9 @@ export function stripInlineComment(line) {
       continue
     }
     if (inDouble) {
-      if (c === '"') inDouble = false
+      // 双引号内的 \" 是转义引号：翻转前回看前一字符是否为 \，否则含转义
+      // 引号的值会提前/推迟结束字符串，把真实注释误当正文（或反之截断）。
+      if (c === '"' && line[i - 1] !== '\\') inDouble = false
       continue
     }
     if (c === "'") inSingle = true
@@ -118,17 +160,22 @@ export function stripInlineComment(line) {
   return line
 }
 
-/** YAML 块标量（| > 及其折叠/裁剪变体）值标记：后续更深的行全部属该标量正文，
- * 直到遇到缩进 <= 键缩进的行（同级键/父级结束）。返回拼接正文与下一行下标。
+/** YAML 块标量（| > 及其折叠/裁剪/显式缩进指示符变体）值标记：后续更深的行
+ * 全部属该标量正文，直到遇到缩进 <= 键缩进的行（同级键/父级结束）。正文行带
+ * body 标记（parseYamlSubset 预处理产出）：空行/注释行在正文里是数据，不受
+ * keyIndent 判定约束，原样并入。返回拼接正文与下一行下标。
  * 说明：parseYamlSubset 是 yaml 包缺失时的回退解析器；此前块标量（如角色
  * persona: |-）之后的同级键/顶层键（roles_remove / main_agent_extra 等）会被
- * 误判为无法解析而静默丢弃，导致回读配置丢键。 */
+ * 误判为无法解析而静默丢弃，导致回读配置丢键；正文里的注释/空行也会被预处理
+ * 剥掉（loadConfig→saveConfig 往返丢段落）。尾部空行按裁剪（clip）语义去掉，
+ * 中段空行原样保留。 */
 export function consumeBlockScalar(lines, i, keyIndent) {
   const parts = []
-  while (i < lines.length && lines[i].indent > keyIndent) {
+  while (i < lines.length && (lines[i].body || lines[i].indent > keyIndent)) {
     parts.push(lines[i].text)
     i++
   }
+  while (parts.length > 0 && parts[parts.length - 1] === '') parts.pop()
   return { value: parts.join('\n'), next: i }
 }
 
@@ -164,7 +211,11 @@ export function parseList(lines, i, indent) {
         }
       } else {
         let parsed = parseScalar(value)
-        if (/^[|>][-+]?$/.test(String(value).trim()) && i < lines.length && lines[i].indent > indent) {
+        if (
+          BLOCK_SCALAR_MARKER_RE.test(String(value).trim()) &&
+          i < lines.length &&
+          (lines[i].indent > indent || lines[i].body)
+        ) {
           const blk = consumeBlockScalar(lines, i, indent)
           parsed = blk.value
           i = blk.next
@@ -202,7 +253,11 @@ export function parseMap(lines, i, indent) {
       }
     } else {
       let parsed = parseScalar(value)
-      if (/^[|>][-+]?$/.test(String(value).trim()) && i < lines.length && lines[i].indent > indent) {
+      if (
+        BLOCK_SCALAR_MARKER_RE.test(String(value).trim()) &&
+        i < lines.length &&
+        (lines[i].indent > indent || lines[i].body)
+      ) {
         const blk = consumeBlockScalar(lines, i, indent)
         parsed = blk.value
         i = blk.next
@@ -219,13 +274,35 @@ export function looksLikeKeyValue(rest) {
   return trimmed.includes(': ') || trimmed.includes(':\t')
 }
 
-/** Split `key: value` at the first colon; a trailing `key:` yields undefined. */
+/**
+ * 键名剥壳：workspaces 段的路径键一律单引号包裹落盘——路径可含 ':' / '#' 等
+ * 会被键值切分或行内注释截断的歧义字符，裸写有歧义。回读时必须剥掉引号还原
+ * 真实键，否则 workspaces.<path> 查不到条目；普通键名不含引号，原样放行。
+ * （局限：带引号键内含 ': ' 且同行还跟标量值时仍会切错位——本解析器只作
+ * yaml 包缺失时的回退，serializeConfig 写出的工作区键均为独立行，不受影响。）
+ */
+export function unquoteKey(key) {
+  if (key.length >= 2 && key.startsWith("'") && key.endsWith("'")) {
+    return key.slice(1, -1).replace(/''/g, "'")
+  }
+  if (key.length >= 2 && key.startsWith('"') && key.endsWith('"')) {
+    try {
+      return JSON.parse(key)
+    } catch {
+      return key.slice(1, -1)
+    }
+  }
+  return key
+}
+
+/** Split `key: value` at the first colon; a trailing `key:` yields undefined.
+ *  键名过 unquoteKey 剥壳（见上：workspaces 带引号路径键）。 */
 export function splitKeyValue(rest) {
   const trimmed = rest.trim()
-  if (trimmed.endsWith(':')) return [trimmed.slice(0, -1).trim(), undefined]
+  if (trimmed.endsWith(':')) return [unquoteKey(trimmed.slice(0, -1).trim()), undefined]
   const idx = trimmed.indexOf(': ')
-  if (idx === -1) return [trimmed, undefined]
-  return [trimmed.slice(0, idx).trim(), trimmed.slice(idx + 2).trim()]
+  if (idx === -1) return [unquoteKey(trimmed), undefined]
+  return [unquoteKey(trimmed.slice(0, idx).trim()), trimmed.slice(idx + 2).trim()]
 }
 
 export function parseScalar(raw) {

package/install.sh

@@ -1,31 +0,0 @@
-#!/usr/bin/env bash
-#
-# dsh-paoding installer — thin shell wrapper around tools/install.mjs, which
-# installs the orchestrator preset into $DSH_HOME/.agent-presets/ (the roster
-# root dsh-agent-presets scans for locally authored presets).  The Node
-# generator detects the host's enabled MCP servers and local tool plugins at
-# install time, resolves their exact tool names, and rewrites the role
-# toolFilter.allow lists in agent.cordis.yml — so tools.restrict() never
-# rejects a child agent for an unknown host-tool name.
-#
-# Usage: ./install.sh [--profile <name>] [--patch <file> ...] [--dry-run] [--help]
-# npx equivalent: npx dsh-paoding [options] (same options; defaults to --auto --config-ui)
-# After installing: restart the dsh host (or open a new session), then pick
-# 「编排模式 (Orchestrator)」 in the new-session preset selector. To make it
-# the default, set it in Settings → Agent Presets.
-#
-# Uninstall: rm -rf "${DSH_HOME:-$HOME/.dsh}/.agent-presets/orchestrator"
-
-set -euo pipefail
-
-DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
-export DSH_HOME
-
-REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-if ! command -v node >/dev/null 2>&1; then
-  echo "error: node (>=18) is required to run the dsh-paoding installer" >&2
-  exit 1
-fi
-
-exec node "$REPO_ROOT/tools/install.mjs" "$@"