@microi.net/cli 5.9.6 → 5.9.8

package/skills/playwright-e2e/SKILL.md

@@ -15,6 +15,8 @@ description: 按 Microi 系统真实业务逻辑进行 Playwright 全自动化
 
 `E2E` 是 `End-to-End`，中文通常叫"端到端测试"。它强调从用户入口开始，穿过前端页面、接口引擎、表单引擎、权限、缓存、数据库等真实链路，验证一条业务路径是否真的可交付。
 
+真实依赖与发布范围沿用 `../workspace-conventions/SKILL.md` 的“平台回归与独立应用测试归属”：常规验证指定 MCP 实际使用的 MySQL、MongoDB、Redis 和 MinIO 或 OSS/HDFS，不要求额外 SQL Server 环境；仅用户明确指定 SQL Server 问题时才做其专项。按 [发布测试矩阵](../microi-system-delivery/references/progressive-02-自动化测试必须覆盖的坑.md#按指定-mcp-选择发布测试矩阵) 记录实际覆盖，保留正常登录、业务闭环与资源收尾，不以连接成功代替真实读写验收。
+
 <!-- microi-progressive:begin -->
 <!-- microi-progressive:chunk id=playwright-e2e-000 sha256=a6ef528a2a940fd0f58efaee6b73eb5dbc159db93d95afedf41c7b8642536d18 -->
 ## 是否需要 `-e2e` 后缀

package/skills/report-engine/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "报表引擎"
-  short_description: "设计遵守菜单与行级权限的报表、聚合接口、写操作与导出验收"
-  default_prompt: "使用 $report-engine 设计并验收当前 Microi 报表。"
+interface:
+  display_name: "报表引擎"
+  short_description: "设计遵守菜单与行级权限的报表、聚合接口、写操作与导出验收"
+  default_prompt: "使用 $report-engine 设计并验收当前 Microi 报表。"

package/skills/scripts/optimize-progressive-disclosure.mjs

@@ -1,204 +1,204 @@
-import crypto from 'node:crypto'
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-const manifestPath = path.join(skillsRoot, '.progressive-disclosure-manifest.json')
-const maxEntryLines = 285
-const keepBudgetLines = 170
-const referenceBudgetLines = 245
-
-const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
-const lineCount = (value) => value.length === 0 ? 0 : value.split(/\r?\n/).length
-const slug = (value) => value
-  .replace(/^#+\s*/, '')
-  .replace(/[`*_]/g, '')
-  .trim()
-  .toLowerCase()
-  .replace(/[^\p{L}\p{N}]+/gu, '-')
-  .replace(/^-|-$/g, '')
-  .slice(0, 48) || 'reference'
-
-const splitAtHeading = (value, headingPattern) => {
-  const matches = [...value.matchAll(headingPattern)]
-  if (matches.length <= 1) return [value]
-  const parts = []
-  if (matches[0].index > 0) parts.push(value.slice(0, matches[0].index))
-  for (let index = 0; index < matches.length; index += 1) {
-    parts.push(value.slice(matches[index].index, matches[index + 1]?.index ?? value.length))
-  }
-  return parts.filter(Boolean)
-}
-
-const splitOversized = (value, eol) => {
-  if (lineCount(value) <= referenceBudgetLines) return [value]
-  let parts = splitAtHeading(value, /^###\s+.+$/gm)
-  if (parts.length === 1) parts = splitAtHeading(value, /^####\s+.+$/gm)
-  const output = []
-  for (const part of parts) {
-    if (lineCount(part) <= referenceBudgetLines) {
-      output.push(part)
-      continue
-    }
-    const lines = part.split(/\r?\n/)
-    let start = 0
-    while (start < lines.length) {
-      let end = Math.min(start + referenceBudgetLines - 8, lines.length)
-      if (end < lines.length) {
-        for (let cursor = end; cursor > start + 40; cursor -= 1) {
-          if (lines[cursor - 1].trim() === '') {
-            end = cursor
-            break
-          }
-        }
-      }
-      const hasTrailingBreak = end < lines.length || part.endsWith(eol)
-      output.push(lines.slice(start, end).join(eol) + (hasTrailingBreak ? eol : ''))
-      start = end
-    }
-  }
-  return output
-}
-
-const headingOf = (value, fallback) => value.match(/^#{2,4}\s+(.+)$/m)?.[1]?.trim() || fallback
-
-const skillDirectories = fs.readdirSync(skillsRoot, { withFileTypes: true })
-  .filter((entry) => entry.isDirectory() && fs.existsSync(path.join(skillsRoot, entry.name, 'SKILL.md')))
-  .map((entry) => entry.name)
-  .sort()
-
-const manifest = {
-  version: 1,
-  generatedAt: new Date().toISOString(),
-  policy: {
-    maxEntryLines,
-    referenceBudgetLines,
-    note: 'Original prefix and ordered chunks reconstruct the exact pre-split SKILL.md bytes.'
-  },
-  skills: {}
-}
-
-for (const skillName of skillDirectories) {
-  const skillPath = path.join(skillsRoot, skillName, 'SKILL.md')
-  const original = fs.readFileSync(skillPath, 'utf8')
-  if (lineCount(original) <= 300) continue
-  if (original.includes('<!-- microi-progressive:begin -->')) {
-    throw new Error(`${skillName} is already optimized; validate instead of running twice`)
-  }
-
-  const eol = original.includes('\r\n') ? '\r\n' : '\n'
-  const sectionMatches = [...original.matchAll(/^##\s+.+$/gm)]
-  if (sectionMatches.length < 2) {
-    throw new Error(`${skillName} needs at least two level-2 sections for safe semantic splitting`)
-  }
-  const prefix = original.slice(0, sectionMatches[0].index)
-  const sections = sectionMatches.map((match, index) => ({
-    heading: match[0].replace(/^##\s+/, '').trim(),
-    raw: original.slice(match.index, sectionMatches[index + 1]?.index ?? original.length),
-  }))
-
-  const kept = []
-  const moved = []
-  let keptLines = lineCount(prefix)
-  for (const section of sections) {
-    // Keep one contiguous prefix only. Picking a later short section after an
-    // earlier section was moved would reorder the original knowledge stream.
-    if (moved.length === 0 && (kept.length === 0 || keptLines + lineCount(section.raw) <= keepBudgetLines)) {
-      kept.push(section)
-      keptLines += lineCount(section.raw)
-    } else {
-      moved.push(section)
-    }
-  }
-  if (moved.length === 0) {
-    moved.push(kept.pop())
-  }
-
-  const fragments = moved.flatMap((section) => splitOversized(section.raw, eol).map((raw, index) => ({
-    raw,
-    heading: headingOf(raw, `${section.heading} (${index + 1})`),
-  })))
-
-  const referenceGroups = []
-  let current = []
-  let currentLines = 5
-  for (const fragment of fragments) {
-    const cost = lineCount(fragment.raw) + 3
-    if (current.length && currentLines + cost > referenceBudgetLines) {
-      referenceGroups.push(current)
-      current = []
-      currentLines = 5
-    }
-    current.push(fragment)
-    currentLines += cost
-  }
-  if (current.length) referenceGroups.push(current)
-
-  const referencesDirectory = path.join(skillsRoot, skillName, 'references')
-  fs.mkdirSync(referencesDirectory, { recursive: true })
-  const chunkRecords = []
-  let ordinal = 0
-  const wrapChunk = (raw, destination) => {
-    const id = `${skillName}-${String(ordinal).padStart(3, '0')}`
-    const record = {
-      id,
-      ordinal,
-      destination: destination.replaceAll('\\', '/'),
-      sha256: hash(raw),
-      lines: lineCount(raw),
-      heading: headingOf(raw, skillName),
-    }
-    chunkRecords.push(record)
-    ordinal += 1
-    return `<!-- microi-progressive:chunk id=${id} sha256=${record.sha256} -->${eol}${raw}<!-- /microi-progressive:chunk -->${eol}`
-  }
-
-  const entryChunks = kept.map((section) => wrapChunk(section.raw, `${skillName}/SKILL.md`)).join('')
-  const referenceRecords = []
-  referenceGroups.forEach((group, index) => {
-    const fileName = `progressive-${String(index + 1).padStart(2, '0')}-${slug(group[0].heading)}.md`
-    const relative = `references/${fileName}`
-    const destination = `${skillName}/${relative}`
-    const body = group.map((fragment) => wrapChunk(fragment.raw, destination)).join('')
-    const title = `# ${skillName} 详细参考 ${index + 1}${eol}${eol}`
-    const note = `> 按需读取；本文件由 SKILL.md 的原章节无损拆分。${eol}${eol}`
-    fs.writeFileSync(path.join(referencesDirectory, fileName), title + note + body, 'utf8')
-    referenceRecords.push({
-      path: relative,
-      headings: group.map((fragment) => fragment.heading),
-    })
-  })
-
-  const routerLines = [
-    '## 详细参考路由（渐进披露）',
-    '',
-    '仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。',
-    '',
-    ...referenceRecords.map((reference) =>
-      `- [${reference.path}](${reference.path})：${reference.headings.join('；')}`),
-    '',
-  ].join(eol)
-  const rewritten = prefix
-    + `<!-- microi-progressive:begin -->${eol}`
-    + entryChunks
-    + routerLines
-    + `<!-- microi-progressive:end -->${eol}`
-  if (lineCount(rewritten) > maxEntryLines) {
-    throw new Error(`${skillName} entry remains ${lineCount(rewritten)} lines; lower keepBudgetLines`)
-  }
-  fs.writeFileSync(skillPath, rewritten, 'utf8')
-
-  manifest.skills[skillName] = {
-    originalSha256: hash(original),
-    originalLines: lineCount(original),
-    prefixSha256: hash(prefix),
-    prefixBytes: Buffer.byteLength(prefix),
-    entryLines: lineCount(rewritten),
-    chunks: chunkRecords,
-    references: referenceRecords,
-  }
-}
-
-fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
-console.log(`Optimized ${Object.keys(manifest.skills).length} skills; manifest: ${manifestPath}`)
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const manifestPath = path.join(skillsRoot, '.progressive-disclosure-manifest.json')
+const maxEntryLines = 285
+const keepBudgetLines = 170
+const referenceBudgetLines = 245
+
+const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
+const lineCount = (value) => value.length === 0 ? 0 : value.split(/\r?\n/).length
+const slug = (value) => value
+  .replace(/^#+\s*/, '')
+  .replace(/[`*_]/g, '')
+  .trim()
+  .toLowerCase()
+  .replace(/[^\p{L}\p{N}]+/gu, '-')
+  .replace(/^-|-$/g, '')
+  .slice(0, 48) || 'reference'
+
+const splitAtHeading = (value, headingPattern) => {
+  const matches = [...value.matchAll(headingPattern)]
+  if (matches.length <= 1) return [value]
+  const parts = []
+  if (matches[0].index > 0) parts.push(value.slice(0, matches[0].index))
+  for (let index = 0; index < matches.length; index += 1) {
+    parts.push(value.slice(matches[index].index, matches[index + 1]?.index ?? value.length))
+  }
+  return parts.filter(Boolean)
+}
+
+const splitOversized = (value, eol) => {
+  if (lineCount(value) <= referenceBudgetLines) return [value]
+  let parts = splitAtHeading(value, /^###\s+.+$/gm)
+  if (parts.length === 1) parts = splitAtHeading(value, /^####\s+.+$/gm)
+  const output = []
+  for (const part of parts) {
+    if (lineCount(part) <= referenceBudgetLines) {
+      output.push(part)
+      continue
+    }
+    const lines = part.split(/\r?\n/)
+    let start = 0
+    while (start < lines.length) {
+      let end = Math.min(start + referenceBudgetLines - 8, lines.length)
+      if (end < lines.length) {
+        for (let cursor = end; cursor > start + 40; cursor -= 1) {
+          if (lines[cursor - 1].trim() === '') {
+            end = cursor
+            break
+          }
+        }
+      }
+      const hasTrailingBreak = end < lines.length || part.endsWith(eol)
+      output.push(lines.slice(start, end).join(eol) + (hasTrailingBreak ? eol : ''))
+      start = end
+    }
+  }
+  return output
+}
+
+const headingOf = (value, fallback) => value.match(/^#{2,4}\s+(.+)$/m)?.[1]?.trim() || fallback
+
+const skillDirectories = fs.readdirSync(skillsRoot, { withFileTypes: true })
+  .filter((entry) => entry.isDirectory() && fs.existsSync(path.join(skillsRoot, entry.name, 'SKILL.md')))
+  .map((entry) => entry.name)
+  .sort()
+
+const manifest = {
+  version: 1,
+  generatedAt: new Date().toISOString(),
+  policy: {
+    maxEntryLines,
+    referenceBudgetLines,
+    note: 'Original prefix and ordered chunks reconstruct the exact pre-split SKILL.md bytes.'
+  },
+  skills: {}
+}
+
+for (const skillName of skillDirectories) {
+  const skillPath = path.join(skillsRoot, skillName, 'SKILL.md')
+  const original = fs.readFileSync(skillPath, 'utf8')
+  if (lineCount(original) <= 300) continue
+  if (original.includes('<!-- microi-progressive:begin -->')) {
+    throw new Error(`${skillName} is already optimized; validate instead of running twice`)
+  }
+
+  const eol = original.includes('\r\n') ? '\r\n' : '\n'
+  const sectionMatches = [...original.matchAll(/^##\s+.+$/gm)]
+  if (sectionMatches.length < 2) {
+    throw new Error(`${skillName} needs at least two level-2 sections for safe semantic splitting`)
+  }
+  const prefix = original.slice(0, sectionMatches[0].index)
+  const sections = sectionMatches.map((match, index) => ({
+    heading: match[0].replace(/^##\s+/, '').trim(),
+    raw: original.slice(match.index, sectionMatches[index + 1]?.index ?? original.length),
+  }))
+
+  const kept = []
+  const moved = []
+  let keptLines = lineCount(prefix)
+  for (const section of sections) {
+    // Keep one contiguous prefix only. Picking a later short section after an
+    // earlier section was moved would reorder the original knowledge stream.
+    if (moved.length === 0 && (kept.length === 0 || keptLines + lineCount(section.raw) <= keepBudgetLines)) {
+      kept.push(section)
+      keptLines += lineCount(section.raw)
+    } else {
+      moved.push(section)
+    }
+  }
+  if (moved.length === 0) {
+    moved.push(kept.pop())
+  }
+
+  const fragments = moved.flatMap((section) => splitOversized(section.raw, eol).map((raw, index) => ({
+    raw,
+    heading: headingOf(raw, `${section.heading} (${index + 1})`),
+  })))
+
+  const referenceGroups = []
+  let current = []
+  let currentLines = 5
+  for (const fragment of fragments) {
+    const cost = lineCount(fragment.raw) + 3
+    if (current.length && currentLines + cost > referenceBudgetLines) {
+      referenceGroups.push(current)
+      current = []
+      currentLines = 5
+    }
+    current.push(fragment)
+    currentLines += cost
+  }
+  if (current.length) referenceGroups.push(current)
+
+  const referencesDirectory = path.join(skillsRoot, skillName, 'references')
+  fs.mkdirSync(referencesDirectory, { recursive: true })
+  const chunkRecords = []
+  let ordinal = 0
+  const wrapChunk = (raw, destination) => {
+    const id = `${skillName}-${String(ordinal).padStart(3, '0')}`
+    const record = {
+      id,
+      ordinal,
+      destination: destination.replaceAll('\\', '/'),
+      sha256: hash(raw),
+      lines: lineCount(raw),
+      heading: headingOf(raw, skillName),
+    }
+    chunkRecords.push(record)
+    ordinal += 1
+    return `<!-- microi-progressive:chunk id=${id} sha256=${record.sha256} -->${eol}${raw}<!-- /microi-progressive:chunk -->${eol}`
+  }
+
+  const entryChunks = kept.map((section) => wrapChunk(section.raw, `${skillName}/SKILL.md`)).join('')
+  const referenceRecords = []
+  referenceGroups.forEach((group, index) => {
+    const fileName = `progressive-${String(index + 1).padStart(2, '0')}-${slug(group[0].heading)}.md`
+    const relative = `references/${fileName}`
+    const destination = `${skillName}/${relative}`
+    const body = group.map((fragment) => wrapChunk(fragment.raw, destination)).join('')
+    const title = `# ${skillName} 详细参考 ${index + 1}${eol}${eol}`
+    const note = `> 按需读取；本文件由 SKILL.md 的原章节无损拆分。${eol}${eol}`
+    fs.writeFileSync(path.join(referencesDirectory, fileName), title + note + body, 'utf8')
+    referenceRecords.push({
+      path: relative,
+      headings: group.map((fragment) => fragment.heading),
+    })
+  })
+
+  const routerLines = [
+    '## 详细参考路由（渐进披露）',
+    '',
+    '仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。',
+    '',
+    ...referenceRecords.map((reference) =>
+      `- [${reference.path}](${reference.path})：${reference.headings.join('；')}`),
+    '',
+  ].join(eol)
+  const rewritten = prefix
+    + `<!-- microi-progressive:begin -->${eol}`
+    + entryChunks
+    + routerLines
+    + `<!-- microi-progressive:end -->${eol}`
+  if (lineCount(rewritten) > maxEntryLines) {
+    throw new Error(`${skillName} entry remains ${lineCount(rewritten)} lines; lower keepBudgetLines`)
+  }
+  fs.writeFileSync(skillPath, rewritten, 'utf8')
+
+  manifest.skills[skillName] = {
+    originalSha256: hash(original),
+    originalLines: lineCount(original),
+    prefixSha256: hash(prefix),
+    prefixBytes: Buffer.byteLength(prefix),
+    entryLines: lineCount(rewritten),
+    chunks: chunkRecords,
+    references: referenceRecords,
+  }
+}
+
+fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
+console.log(`Optimized ${Object.keys(manifest.skills).length} skills; manifest: ${manifestPath}`)

package/skills/scripts/refresh-progressive-disclosure.mjs

@@ -1,64 +1,64 @@
-import crypto from 'node:crypto'
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-const manifestPath = path.join(skillsRoot, '.progressive-disclosure-manifest.json')
-const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
-const requested = process.argv.slice(2)
-if (requested.length === 0) {
-  throw new Error('Pass each intentionally changed skill name explicitly.')
-}
-const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
-
-for (const skillName of requested) {
-  const skill = manifest.skills[skillName]
-  if (!skill) throw new Error(`${skillName} is not a progressive-disclosure skill`)
-  const sources = new Map()
-  const entryPath = path.join(skillsRoot, skillName, 'SKILL.md')
-  sources.set(`${skillName}/SKILL.md`, fs.readFileSync(entryPath, 'utf8'))
-  for (const reference of skill.references) {
-    const destination = `${skillName}/${reference.path}`
-    sources.set(destination, fs.readFileSync(path.join(skillsRoot, destination), 'utf8'))
-  }
-
-  const ordered = []
-  for (const chunk of skill.chunks) {
-    let source = sources.get(chunk.destination)
-    const openPattern = new RegExp(`<!-- microi-progressive:chunk id=${chunk.id} sha256=[a-f0-9]{64} -->`)
-    const match = source.match(openPattern)
-    if (!match) throw new Error(`${skillName}: missing chunk ${chunk.id}`)
-    const markerStart = match.index
-    const markerEnd = markerStart + match[0].length
-    const contentStart = markerEnd + (source.startsWith('\r\n', markerEnd) ? 2 : 1)
-    const close = '<!-- /microi-progressive:chunk -->'
-    const contentEnd = source.indexOf(close, contentStart)
-    const raw = source.slice(contentStart, contentEnd)
-    const digest = hash(raw)
-    source = source.slice(0, markerStart)
-      + `<!-- microi-progressive:chunk id=${chunk.id} sha256=${digest} -->`
-      + source.slice(markerEnd)
-    sources.set(chunk.destination, source)
-    chunk.sha256 = digest
-    chunk.lines = raw.split(/\r?\n/).length
-    ordered[chunk.ordinal] = raw
-  }
-
-  for (const [destination, source] of sources) {
-    fs.writeFileSync(path.join(skillsRoot, destination), source, 'utf8')
-  }
-  const entry = sources.get(`${skillName}/SKILL.md`)
-  const begin = entry.indexOf('<!-- microi-progressive:begin -->')
-  const prefix = entry.slice(0, begin)
-  skill.prefixSha256 = hash(prefix)
-  skill.prefixBytes = Buffer.byteLength(prefix)
-  skill.originalSha256 = hash(prefix + ordered.join(''))
-  skill.originalLines = (prefix + ordered.join('')).split(/\r?\n/).length
-  skill.entryLines = entry.split(/\r?\n/).length
-}
-
-manifest.generatedAt = new Date().toISOString()
-fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
-console.log(`Accepted intentional knowledge updates for: ${requested.join(', ')}`)
-
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const manifestPath = path.join(skillsRoot, '.progressive-disclosure-manifest.json')
+const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
+const requested = process.argv.slice(2)
+if (requested.length === 0) {
+  throw new Error('Pass each intentionally changed skill name explicitly.')
+}
+const hash = (value) => crypto.createHash('sha256').update(value).digest('hex')
+
+for (const skillName of requested) {
+  const skill = manifest.skills[skillName]
+  if (!skill) throw new Error(`${skillName} is not a progressive-disclosure skill`)
+  const sources = new Map()
+  const entryPath = path.join(skillsRoot, skillName, 'SKILL.md')
+  sources.set(`${skillName}/SKILL.md`, fs.readFileSync(entryPath, 'utf8'))
+  for (const reference of skill.references) {
+    const destination = `${skillName}/${reference.path}`
+    sources.set(destination, fs.readFileSync(path.join(skillsRoot, destination), 'utf8'))
+  }
+
+  const ordered = []
+  for (const chunk of skill.chunks) {
+    let source = sources.get(chunk.destination)
+    const openPattern = new RegExp(`<!-- microi-progressive:chunk id=${chunk.id} sha256=[a-f0-9]{64} -->`)
+    const match = source.match(openPattern)
+    if (!match) throw new Error(`${skillName}: missing chunk ${chunk.id}`)
+    const markerStart = match.index
+    const markerEnd = markerStart + match[0].length
+    const contentStart = markerEnd + (source.startsWith('\r\n', markerEnd) ? 2 : 1)
+    const close = '<!-- /microi-progressive:chunk -->'
+    const contentEnd = source.indexOf(close, contentStart)
+    const raw = source.slice(contentStart, contentEnd)
+    const digest = hash(raw)
+    source = source.slice(0, markerStart)
+      + `<!-- microi-progressive:chunk id=${chunk.id} sha256=${digest} -->`
+      + source.slice(markerEnd)
+    sources.set(chunk.destination, source)
+    chunk.sha256 = digest
+    chunk.lines = raw.split(/\r?\n/).length
+    ordered[chunk.ordinal] = raw
+  }
+
+  for (const [destination, source] of sources) {
+    fs.writeFileSync(path.join(skillsRoot, destination), source, 'utf8')
+  }
+  const entry = sources.get(`${skillName}/SKILL.md`)
+  const begin = entry.indexOf('<!-- microi-progressive:begin -->')
+  const prefix = entry.slice(0, begin)
+  skill.prefixSha256 = hash(prefix)
+  skill.prefixBytes = Buffer.byteLength(prefix)
+  skill.originalSha256 = hash(prefix + ordered.join(''))
+  skill.originalLines = (prefix + ordered.join('')).split(/\r?\n/).length
+  skill.entryLines = entry.split(/\r?\n/).length
+}
+
+manifest.generatedAt = new Date().toISOString()
+fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
+console.log(`Accepted intentional knowledge updates for: ${requested.join(', ')}`)
+

package/skills/scripts/sync-embedded-skills.mjs

@@ -1,46 +1,46 @@
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-// 后端只持有自包含的知识快照；规则正文仍以 microi.skills 为唯一可编辑事实源。
-const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const serverRoot = path.resolve(skillsRoot, '../Microi.Server/Microi.AI');
-const project = fs.readFileSync(path.join(serverRoot, 'Microi.AI.csproj'), 'utf8');
-const manifest = JSON.parse(fs.readFileSync(path.join(skillsRoot, '.progressive-disclosure-manifest.json'), 'utf8'));
-const check = process.argv.includes('--check');
-const names = process.argv.slice(2).filter(value => value !== '--check');
-if (!names.length) throw new Error('请显式指定本次需要同步的 Skill 名称。');
-const stripMarkers = text => text.replace(/<!--\s*\/?microi-progressive:[^>]*-->\r?\n?/g, '');
-const digest = text => crypto.createHash('sha256').update(text).digest('hex');
-const results = [];
-
-for (const name of names) {
-  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) throw new Error(`无效 Skill 名称：${name}`);
-  const file = `skill-${name}.md`;
-  // 不擅自新增程序集资源；只有现有项目明确注册的知识快照可以由此脚本刷新。
-  if (!project.includes(`Resource\\${file}`)) throw new Error(`后端尚未注册 ${file}，请先审阅资源归属。`);
-  let text = fs.readFileSync(path.join(skillsRoot, name, 'SKILL.md'), 'utf8');
-  const references = manifest.skills[name]?.references || [];
-  if (references.length) {
-    const route = text.indexOf('## 详细参考路由（渐进披露）');
-    const end = text.indexOf('<!-- microi-progressive:end -->', route);
-    if (route < 0 || end < route) throw new Error(`${name} 缺少受控参考路由，停止覆盖快照。`);
-    text = text.slice(0, route) + text.slice(end + '<!-- microi-progressive:end -->'.length);
-    for (const reference of references) {
-      const source = path.resolve(skillsRoot, name, reference.path);
-      const relative = path.relative(path.join(skillsRoot, name), source);
-      if (relative.startsWith('..') || path.isAbsolute(relative)) throw new Error('参考文件越过 Skill 目录。');
-      // 平台 AI 读取程序集时不能打开工作区相对路径，必须带上渐进参考的完整正文。
-      text += `\n\n${fs.readFileSync(source, 'utf8')}`;
-    }
-  }
-  text = `${stripMarkers(text).replace(/\r\n/g, '\n').trimEnd()}\n`;
-  const target = path.join(serverRoot, 'Resource', file);
-  const before = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : '';
-  const changed = before.replace(/\r\n/g, '\n') !== text;
-  if (changed && !check) fs.writeFileSync(target, text, 'utf8');
-  results.push({ name, changed, sha256: digest(text) });
-}
-console.log(JSON.stringify({ check, results }, null, 2));
-if (check && results.some(item => item.changed)) process.exitCode = 1;
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// 后端只持有自包含的知识快照；规则正文仍以 microi.skills 为唯一可编辑事实源。
+const skillsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const serverRoot = path.resolve(skillsRoot, '../Microi.Server/Microi.AI');
+const project = fs.readFileSync(path.join(serverRoot, 'Microi.AI.csproj'), 'utf8');
+const manifest = JSON.parse(fs.readFileSync(path.join(skillsRoot, '.progressive-disclosure-manifest.json'), 'utf8'));
+const check = process.argv.includes('--check');
+const names = process.argv.slice(2).filter(value => value !== '--check');
+if (!names.length) throw new Error('请显式指定本次需要同步的 Skill 名称。');
+const stripMarkers = text => text.replace(/<!--\s*\/?microi-progressive:[^>]*-->\r?\n?/g, '');
+const digest = text => crypto.createHash('sha256').update(text).digest('hex');
+const results = [];
+
+for (const name of names) {
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) throw new Error(`无效 Skill 名称：${name}`);
+  const file = `skill-${name}.md`;
+  // 不擅自新增程序集资源；只有现有项目明确注册的知识快照可以由此脚本刷新。
+  if (!project.includes(`Resource\\${file}`)) throw new Error(`后端尚未注册 ${file}，请先审阅资源归属。`);
+  let text = fs.readFileSync(path.join(skillsRoot, name, 'SKILL.md'), 'utf8');
+  const references = manifest.skills[name]?.references || [];
+  if (references.length) {
+    const route = text.indexOf('## 详细参考路由（渐进披露）');
+    const end = text.indexOf('<!-- microi-progressive:end -->', route);
+    if (route < 0 || end < route) throw new Error(`${name} 缺少受控参考路由，停止覆盖快照。`);
+    text = text.slice(0, route) + text.slice(end + '<!-- microi-progressive:end -->'.length);
+    for (const reference of references) {
+      const source = path.resolve(skillsRoot, name, reference.path);
+      const relative = path.relative(path.join(skillsRoot, name), source);
+      if (relative.startsWith('..') || path.isAbsolute(relative)) throw new Error('参考文件越过 Skill 目录。');
+      // 平台 AI 读取程序集时不能打开工作区相对路径，必须带上渐进参考的完整正文。
+      text += `\n\n${fs.readFileSync(source, 'utf8')}`;
+    }
+  }
+  text = `${stripMarkers(text).replace(/\r\n/g, '\n').trimEnd()}\n`;
+  const target = path.join(serverRoot, 'Resource', file);
+  const before = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : '';
+  const changed = before.replace(/\r\n/g, '\n') !== text;
+  if (changed && !check) fs.writeFileSync(target, text, 'utf8');
+  results.push({ name, changed, sha256: digest(text) });
+}
+console.log(JSON.stringify({ check, results }, null, 2));
+if (check && results.some(item => item.changed)) process.exitCode = 1;