@sanqianx/project-knowledge 5.0.23 → 5.0.25

package/_site/lib/zcode-context-integration.js

@@ -1,60 +1,60 @@
-'use strict';
-const fs = require('node:fs');
-const path = require('node:path');
-const AtomicFile = require('./atomic-file');
-
-function configuration(file) {
-  if (!fs.existsSync(file)) return {};
-  let value; try { value = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { throw new Error('ZCode 配置不是有效 JSON，未覆盖原文件。'); }
-  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('ZCode 配置必须是 JSON 对象，未覆盖原文件。');
-  return value;
-}
-const scriptFor = root => path.join(root, 'plugins/project-knowledge/scripts/context-hook.cjs');
-const normalize = file => { const value = path.resolve(file).replace(/\\/g, '/'); return process.platform === 'win32' ? value.toLowerCase() : value; };
-function owned(hook, root) {
-  if (hook?.type !== 'process' || hook.command !== 'node' || !Array.isArray(hook.args) || hook.args.length !== 3 || typeof hook.args[0] !== 'string' || !path.isAbsolute(hook.args[0]) || hook.args[1] !== '--client' || hook.args[2] !== 'zcode') return false;
-  const file = normalize(hook.args[0]);
-  // Only the exact current script or a canonical managed npm installation is
-  // ours. An unrelated script with a similar basename remains untouched.
-  return file === normalize(scriptFor(root)) || /\/node_modules\/(?:@sanqianx\/)?project-knowledge\/plugins\/project-knowledge\/scripts\/context-hook\.cjs$/i.test(file);
-}
-function status({ configFile, rootDir }) {
-  const config = configuration(configFile);
-  const entries = (config.hooks?.events?.UserPromptSubmit || []).flatMap(g => Array.isArray(g?.hooks) ? g.hooks.filter(h => owned(h, rootDir)) : []);
-  const installed = entries.length === 1 && normalize(entries[0].args[0]) === normalize(scriptFor(rootDir)) && fs.existsSync(scriptFor(rootDir));
-  const disabled = config.hooks?.enabled === false;
-  return { state: disabled ? 'disabled' : installed && config.hooks?.enabled === true ? 'installed' : entries.length ? 'needs-repair' : 'not-installed', supported: true, installed: installed && !disabled && config.hooks?.enabled === true, detail: disabled ? 'ZCode 配置 Hook 已被用户禁用，未擅自启用。' : installed ? '原生 UserPromptSubmit 只读上下文入口已配置；MCP 插件状态不作已安装承诺。' : entries.length ? '知识读取入口仍指向旧安装或重复配置，请接入/修复；未误报就绪。' : '开发前知识读取尚未接入；与会话采集独立。' };
-}
-function install({ configFile, rootDir, dryRun }) {
-  const config = configuration(configFile);
-  if (config.hooks?.enabled === false) throw new Error('ZCode Hook 已被用户禁用，请在客户端明确启用后重试；未覆盖配置。');
-  if (!fs.existsSync(scriptFor(rootDir))) throw new Error('缺少已安装的知识读取脚本。');
-  if (!dryRun) {
-    if (config.hooks && (typeof config.hooks !== 'object' || Array.isArray(config.hooks))) throw new Error('ZCode Hook 配置格式无效，未覆盖。');
-    config.hooks ||= {}; config.hooks.events ||= {};
-    if (typeof config.hooks.events !== 'object' || Array.isArray(config.hooks.events)) throw new Error('ZCode Hook 事件配置格式无效，未覆盖。');
-    const groups = config.hooks.events.UserPromptSubmit || [];
-    if (!Array.isArray(groups)) throw new Error('ZCode UserPromptSubmit 配置格式无效，未覆盖。');
-    const hook = { type: 'process', command: 'node', args: [scriptFor(rootDir), '--client', 'zcode'], timeoutMs: 12000 };
-    let found = false;
-    const updated = groups.map(group => {
-      if (!Array.isArray(group?.hooks)) return group;
-      const hooks = group.hooks.flatMap(h => { if (!owned(h, rootDir)) return [h]; if (found) return []; found = true; return [hook]; });
-      return hooks.length || !group.hooks.length ? { ...group, hooks } : null;
-    }).filter(Boolean);
-    if (!found) updated.push({ hooks: [hook] });
-    config.hooks.events.UserPromptSubmit = updated; config.hooks.enabled = true;
-    AtomicFile.writeJsonAtomic(configFile, config);
-  }
-  return { state: dryRun ? 'planned' : 'installed', supported: true, installed: !dryRun, detail: 'ZCode 原生前置读取已配置，保留原模型、第三方 Hook 与采集入口；请重新打开会话。' };
-}
-function uninstall({ configFile, rootDir, dryRun }) {
-  const config = configuration(configFile), groups = config.hooks?.events?.UserPromptSubmit;
-  if (!dryRun && Array.isArray(groups)) {
-    const kept = groups.map(group => { if (!Array.isArray(group?.hooks)) return group; const hooks = group.hooks.filter(h => !owned(h, rootDir)); return hooks.length ? { ...group, hooks } : null; }).filter(Boolean);
-    if (kept.length) config.hooks.events.UserPromptSubmit = kept; else delete config.hooks.events.UserPromptSubmit;
-    AtomicFile.writeJsonAtomic(configFile, config);
-  }
-  return { state: dryRun ? 'planned' : 'removed', supported: true, installed: false, detail: '已移除知识上下文入口，采集、模型和第三方设置保留。' };
-}
-module.exports = { install, status, uninstall };
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+const AtomicFile = require('./atomic-file');
+
+function configuration(file) {
+  if (!fs.existsSync(file)) return {};
+  let value; try { value = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { throw new Error('ZCode 配置不是有效 JSON，未覆盖原文件。'); }
+  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('ZCode 配置必须是 JSON 对象，未覆盖原文件。');
+  return value;
+}
+const scriptFor = root => path.join(root, 'plugins/project-knowledge/scripts/context-hook.cjs');
+const normalize = file => { const value = path.resolve(file).replace(/\\/g, '/'); return process.platform === 'win32' ? value.toLowerCase() : value; };
+function owned(hook, root) {
+  if (hook?.type !== 'process' || hook.command !== 'node' || !Array.isArray(hook.args) || hook.args.length !== 3 || typeof hook.args[0] !== 'string' || !path.isAbsolute(hook.args[0]) || hook.args[1] !== '--client' || hook.args[2] !== 'zcode') return false;
+  const file = normalize(hook.args[0]);
+  // Only the exact current script or a canonical managed npm installation is
+  // ours. An unrelated script with a similar basename remains untouched.
+  return file === normalize(scriptFor(root)) || /\/node_modules\/(?:@sanqianx\/)?project-knowledge\/plugins\/project-knowledge\/scripts\/context-hook\.cjs$/i.test(file);
+}
+function status({ configFile, rootDir }) {
+  const config = configuration(configFile);
+  const entries = (config.hooks?.events?.UserPromptSubmit || []).flatMap(g => Array.isArray(g?.hooks) ? g.hooks.filter(h => owned(h, rootDir)) : []);
+  const installed = entries.length === 1 && normalize(entries[0].args[0]) === normalize(scriptFor(rootDir)) && fs.existsSync(scriptFor(rootDir));
+  const disabled = config.hooks?.enabled === false;
+  return { state: disabled ? 'disabled' : installed && config.hooks?.enabled === true ? 'installed' : entries.length ? 'needs-repair' : 'not-installed', supported: true, installed: installed && !disabled && config.hooks?.enabled === true, detail: disabled ? 'ZCode 配置 Hook 已被用户禁用，未擅自启用。' : installed ? '原生 UserPromptSubmit 只读上下文入口已配置；MCP 插件状态不作已安装承诺。' : entries.length ? '知识读取入口仍指向旧安装或重复配置，请接入/修复；未误报就绪。' : '开发前知识读取尚未接入；与会话采集独立。' };
+}
+function install({ configFile, rootDir, dryRun }) {
+  const config = configuration(configFile);
+  if (config.hooks?.enabled === false) throw new Error('ZCode Hook 已被用户禁用，请在客户端明确启用后重试；未覆盖配置。');
+  if (!fs.existsSync(scriptFor(rootDir))) throw new Error('缺少已安装的知识读取脚本。');
+  if (!dryRun) {
+    if (config.hooks && (typeof config.hooks !== 'object' || Array.isArray(config.hooks))) throw new Error('ZCode Hook 配置格式无效，未覆盖。');
+    config.hooks ||= {}; config.hooks.events ||= {};
+    if (typeof config.hooks.events !== 'object' || Array.isArray(config.hooks.events)) throw new Error('ZCode Hook 事件配置格式无效，未覆盖。');
+    const groups = config.hooks.events.UserPromptSubmit || [];
+    if (!Array.isArray(groups)) throw new Error('ZCode UserPromptSubmit 配置格式无效，未覆盖。');
+    const hook = { type: 'process', command: 'node', args: [scriptFor(rootDir), '--client', 'zcode'], timeoutMs: 12000 };
+    let found = false;
+    const updated = groups.map(group => {
+      if (!Array.isArray(group?.hooks)) return group;
+      const hooks = group.hooks.flatMap(h => { if (!owned(h, rootDir)) return [h]; if (found) return []; found = true; return [hook]; });
+      return hooks.length || !group.hooks.length ? { ...group, hooks } : null;
+    }).filter(Boolean);
+    if (!found) updated.push({ hooks: [hook] });
+    config.hooks.events.UserPromptSubmit = updated; config.hooks.enabled = true;
+    AtomicFile.writeJsonAtomic(configFile, config);
+  }
+  return { state: dryRun ? 'planned' : 'installed', supported: true, installed: !dryRun, detail: 'ZCode 原生前置读取已配置，保留原模型、第三方 Hook 与采集入口；请重新打开会话。' };
+}
+function uninstall({ configFile, rootDir, dryRun }) {
+  const config = configuration(configFile), groups = config.hooks?.events?.UserPromptSubmit;
+  if (!dryRun && Array.isArray(groups)) {
+    const kept = groups.map(group => { if (!Array.isArray(group?.hooks)) return group; const hooks = group.hooks.filter(h => !owned(h, rootDir)); return hooks.length ? { ...group, hooks } : null; }).filter(Boolean);
+    if (kept.length) config.hooks.events.UserPromptSubmit = kept; else delete config.hooks.events.UserPromptSubmit;
+    AtomicFile.writeJsonAtomic(configFile, config);
+  }
+  return { state: dryRun ? 'planned' : 'removed', supported: true, installed: false, detail: '已移除知识上下文入口，采集、模型和第三方设置保留。' };
+}
+module.exports = { install, status, uninstall };

package/_site/scripts/codex-notify-fanout.cjs

@@ -1,95 +1,95 @@
-#!/usr/bin/env node
-'use strict';
-
-// Codex supports one notify command. This fail-open fan-out preserves an
-// existing notifier and invokes the Bridge beside it.
-const { spawn } = require('child_process');
-const os = require('os');
-const path = require('path');
-
-function commandFrom(args, marker) {
-  const index = args.indexOf(marker);
-  if (index < 0 || !args[index + 1]) return null;
-  try {
-    const command = JSON.parse(Buffer.from(args[index + 1], 'base64').toString('utf8'));
-    return Array.isArray(command) && command.length && command.every(part => typeof part === 'string') ? command : null;
-  } catch {
-    return null;
-  }
-}
-
-function readStdin() {
-  return new Promise(resolve => {
-    let value = '';
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', chunk => { value += chunk; });
-    process.stdin.on('end', () => resolve(value));
-    process.stdin.on('error', () => resolve(value));
-  });
-}
-
-function payloadArgument(args) {
-  const last = args.length - 1;
-  if (last < 0 || ['--next-base64', '--bridge-base64'].includes(args[last - 1])) return null;
-  try {
-    const payload = JSON.parse(args[last]);
-    return payload && typeof payload === 'object' && !Array.isArray(payload) ? args[last] : null;
-  } catch {
-    return null;
-  }
-}
-
-function bridgePayload(raw) {
-  try {
-    const payload = JSON.parse(raw);
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return raw;
-    let changed = false;
-    if (!payload.session_id && !payload.sessionId && typeof payload['thread-id'] === 'string') {
-      payload.session_id = payload['thread-id'];
-      changed = true;
-    }
-    if (!payload.turn_id && !payload.turnId && typeof payload['turn-id'] === 'string') {
-      payload.turn_id = payload['turn-id'];
-      changed = true;
-    }
-    // The notification only wakes the authoritative rollout reader. It must
-    // never substitute its summary fields for captured conversation evidence.
-    return changed ? JSON.stringify(payload) : raw;
-  } catch {
-    return raw;
-  }
-}
-
-function invoke(command, payload, env, transport = 'stdin') {
-  if (!command) return;
-  try {
-    const [executable, ...args] = command;
-    const child = spawn(executable, transport === 'argv' ? [...args, payload] : args, {
-      detached: true,
-      stdio: [transport === 'argv' ? 'ignore' : 'pipe', 'ignore', 'ignore'],
-      windowsHide: true,
-      env,
-    });
-    child.on('error', () => {});
-    if (child.stdin) {
-      child.stdin.on('error', () => {});
-      child.stdin.end(payload || '');
-    }
-    child.unref();
-  } catch {
-    // A notifier must never block Codex itself.
-  }
-}
-
-(async () => {
-  const args = process.argv.slice(2);
-  const argument = payloadArgument(args);
-  // Codex passes one JSON argument; legacy callers used stdin. Do not wait for
-  // an open stdin in argv mode, and keep the third-party transport unchanged.
-  const payload = argument === null ? await readStdin() : argument;
-  invoke(commandFrom(args, '--next-base64'), payload, process.env, argument === null ? 'stdin' : 'argv');
-  invoke(commandFrom(args, '--bridge-base64'), bridgePayload(payload), {
-    ...process.env,
-    CODEX_SESSIONS_ROOT: process.env.CODEX_SESSIONS_ROOT || path.join(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'), 'sessions'),
-  });
-})();
+#!/usr/bin/env node
+'use strict';
+
+// Codex supports one notify command. This fail-open fan-out preserves an
+// existing notifier and invokes the Bridge beside it.
+const { spawn } = require('child_process');
+const os = require('os');
+const path = require('path');
+
+function commandFrom(args, marker) {
+  const index = args.indexOf(marker);
+  if (index < 0 || !args[index + 1]) return null;
+  try {
+    const command = JSON.parse(Buffer.from(args[index + 1], 'base64').toString('utf8'));
+    return Array.isArray(command) && command.length && command.every(part => typeof part === 'string') ? command : null;
+  } catch {
+    return null;
+  }
+}
+
+function readStdin() {
+  return new Promise(resolve => {
+    let value = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', chunk => { value += chunk; });
+    process.stdin.on('end', () => resolve(value));
+    process.stdin.on('error', () => resolve(value));
+  });
+}
+
+function payloadArgument(args) {
+  const last = args.length - 1;
+  if (last < 0 || ['--next-base64', '--bridge-base64'].includes(args[last - 1])) return null;
+  try {
+    const payload = JSON.parse(args[last]);
+    return payload && typeof payload === 'object' && !Array.isArray(payload) ? args[last] : null;
+  } catch {
+    return null;
+  }
+}
+
+function bridgePayload(raw) {
+  try {
+    const payload = JSON.parse(raw);
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return raw;
+    let changed = false;
+    if (!payload.session_id && !payload.sessionId && typeof payload['thread-id'] === 'string') {
+      payload.session_id = payload['thread-id'];
+      changed = true;
+    }
+    if (!payload.turn_id && !payload.turnId && typeof payload['turn-id'] === 'string') {
+      payload.turn_id = payload['turn-id'];
+      changed = true;
+    }
+    // The notification only wakes the authoritative rollout reader. It must
+    // never substitute its summary fields for captured conversation evidence.
+    return changed ? JSON.stringify(payload) : raw;
+  } catch {
+    return raw;
+  }
+}
+
+function invoke(command, payload, env, transport = 'stdin') {
+  if (!command) return;
+  try {
+    const [executable, ...args] = command;
+    const child = spawn(executable, transport === 'argv' ? [...args, payload] : args, {
+      detached: true,
+      stdio: [transport === 'argv' ? 'ignore' : 'pipe', 'ignore', 'ignore'],
+      windowsHide: true,
+      env,
+    });
+    child.on('error', () => {});
+    if (child.stdin) {
+      child.stdin.on('error', () => {});
+      child.stdin.end(payload || '');
+    }
+    child.unref();
+  } catch {
+    // A notifier must never block Codex itself.
+  }
+}
+
+(async () => {
+  const args = process.argv.slice(2);
+  const argument = payloadArgument(args);
+  // Codex passes one JSON argument; legacy callers used stdin. Do not wait for
+  // an open stdin in argv mode, and keep the third-party transport unchanged.
+  const payload = argument === null ? await readStdin() : argument;
+  invoke(commandFrom(args, '--next-base64'), payload, process.env, argument === null ? 'stdin' : 'argv');
+  invoke(commandFrom(args, '--bridge-base64'), bridgePayload(payload), {
+    ...process.env,
+    CODEX_SESSIONS_ROOT: process.env.CODEX_SESSIONS_ROOT || path.join(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'), 'sessions'),
+  });
+})();

package/_site/scripts/folder-picker.ps1

@@ -1,156 +1,156 @@
-# folder-picker.ps1 — modern folder picker for project-knowledge import dialog.
-# Uses the Vista+ IFileOpenDialog COM API (the same dialog VS Code / modern
-# Windows apps show) with the default initial folder set to "This PC".
-#
-# Reads title from $args[0]. Prints the selected absolute path to stdout, or
-# prints nothing if the user cancelled. Exits 0 in both cases.
-#
-# STA apartment + -WindowStyle Hidden is required by the caller; this script
-# assumes the host process has set those flags.
-
-param([string]$Title = 'Select folder')
-
-$ErrorActionPreference = 'Stop'
-[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
-
-$src = @'
-using System;
-using System.ComponentModel;
-using System.Linq;
-using System.Runtime.InteropServices;
-
-[Flags]
-public enum FOS : uint {
-  PICKFOLDERS     = 0x00000020,
-  FORCEFILESYSTEM = 0x00000040,
-  NOCHANGEDIR     = 0x00000008
-}
-
-[ComImport, Guid("d57c7288-d4ad-4768-be02-9d969532d960"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
-public interface IFileOpenDialog {
-  [PreserveSig] int Show(IntPtr hwndOwner);
-  [PreserveSig] int SetFileTypes(uint cFileTypes, IntPtr rgFilterSpec);
-  [PreserveSig] int SetFileTypeIndex(uint iFileType);
-  [PreserveSig] int GetFileTypeIndex(out uint piFileType);
-  [PreserveSig] int Advise(IntPtr pfde, out uint pdwCookie);
-  [PreserveSig] int Unadvise(uint dwCookie);
-  [PreserveSig] int SetOptions(FOS fos);
-  [PreserveSig] int GetOptions(out FOS pfos);
-  [PreserveSig] int SetDefaultFolder(IntPtr psi);
-  [PreserveSig] int SetFolder(IntPtr psi);
-  [PreserveSig] int GetFolder(out IntPtr ppsi);
-  [PreserveSig] int GetCurrentSelection(out IntPtr ppsi);
-  [PreserveSig] int SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);
-  [PreserveSig] int GetFileName([MarshalAs(UnmanagedType.LPWStr)] out string pszName);
-  [PreserveSig] int SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);
-  [PreserveSig] int SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);
-  [PreserveSig] int SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);
-  [PreserveSig] int GetResult(out IntPtr ppsi);
-  [PreserveSig] int AddPlace(IntPtr psi, int fdap);
-  [PreserveSig] int SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);
-  [PreserveSig] int Close(int hr);
-  [PreserveSig] int SetClientGuid(ref Guid guid);
-  [PreserveSig] int ClearClientData();
-  [PreserveSig] int SetFilter(IntPtr pFilter);
-  [PreserveSig] int GetResults(out IntPtr ppenum);
-  [PreserveSig] int GetSelectedItems(out IntPtr ppsai);
-}
-
-public static class Shell32 {
-  [DllImport("shell32.dll", CharSet = CharSet.Unicode, ExactSpelling = true, PreserveSig = true)]
-  public static extern int SHCreateItemFromParsingName(
-    [MarshalAs(UnmanagedType.LPWStr)] string pszPath,
-    IntPtr pbc,
-    [MarshalAs(UnmanagedType.LPStruct)] Guid riid,
-    out IntPtr ppv);
-
-  [DllImport("ole32.dll", PreserveSig = true)]
-  public static extern int CoCreateInstance(
-    ref Guid rclsid, IntPtr pUnkOuter, uint dwClsContext, ref Guid riid, out IntPtr ppv);
-}
-
-public static class User32 {
-  [DllImport("user32.dll")]
-  public static extern IntPtr GetForegroundWindow();
-}
-
-public static class FolderPicker {
-  public static string Pick(string title) {
-    Guid clsid = new Guid("DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7");
-    Guid iid   = new Guid("d57c7288-d4ad-4768-be02-9d969532d960");
-    IntPtr pIfod = IntPtr.Zero;
-    IntPtr pItem = IntPtr.Zero;
-    IntPtr pResult = IntPtr.Zero;
-
-    try {
-      int hr = Shell32.CoCreateInstance(ref clsid, IntPtr.Zero, 0x1, ref iid, out pIfod);
-      if (hr != 0) throw new Win32Exception(hr);
-
-      IFileOpenDialog dialog = (IFileOpenDialog)Marshal.GetTypedObjectForIUnknown(pIfod, typeof(IFileOpenDialog));
-
-      FOS opts = FOS.PICKFOLDERS | FOS.FORCEFILESYSTEM | FOS.NOCHANGEDIR;
-      hr = dialog.SetOptions(opts);
-      if (hr != 0) throw new Win32Exception(hr);
-
-      // On Win11 with system ANSI codepage set (e.g. 936 GBK) the Fluent
-// title-bar chrome can garble CJK even though the dialog stores the title
-// correctly in Unicode (taskbar preview is correct via the Unicode path).
-// Use an ASCII title to keep the chrome legible; the import button's
-// surrounding UI (Chinese) tells the user what the picker is for.
-string safeTitle = title.All(c => c < 128) ? title : "Select Project Folder";
-hr = dialog.SetTitle(safeTitle);
-if (hr != 0) throw new Win32Exception(hr);
-
-      // Initial folder = This PC (FOLDERID_ComputerFolder)
-      Guid iidShellItem = new Guid("43826d1e-e718-42ee-bc55-a1e261c37bfe");
-      hr = Shell32.SHCreateItemFromParsingName(
-        "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}",
-        IntPtr.Zero, iidShellItem, out pItem);
-      if (hr != 0) throw new Win32Exception(hr);
-      hr = dialog.SetFolder(pItem);
-      if (hr != 0) throw new Win32Exception(hr);
-
-      // Pass the current foreground window as owner so the dialog is parented
-      // to it (positioned on top, modal to it). Without an owner, the dialog
-      // has no z-order anchor and on Windows 11 ends up hidden behind the
-      // browser window that initiated the call.
-      IntPtr owner = User32.GetForegroundWindow();
-      hr = dialog.Show(owner);
-      // 0 = OK, 0x800704C7 = ERROR_CANCELLED, others = error
-      if (hr != 0) return null;
-
-      hr = dialog.GetResult(out pResult);
-      if (hr != 0 || pResult == IntPtr.Zero) return null;
-
-      // IShellItem vtable index 5 = GetDisplayName(SIGDN, LPWSTR*)
-      IntPtr vtable = Marshal.ReadIntPtr(pResult);
-      IntPtr getDisplayNameFn = Marshal.ReadIntPtr(vtable, 5 * IntPtr.Size);
-      GetDisplayNameDelegate del = (GetDisplayNameDelegate)Marshal.GetDelegateForFunctionPointer(
-        getDisplayNameFn, typeof(GetDisplayNameDelegate));
-
-      IntPtr strPtr = IntPtr.Zero;
-      int ghr = del(pResult, 0x80058000u, out strPtr);  // SIGDN_FILESYSPATH
-      if (ghr != 0 || strPtr == IntPtr.Zero) return null;
-
-      string path = Marshal.PtrToStringUni(strPtr);
-      Marshal.FreeCoTaskMem(strPtr);
-      return path;
-    } finally {
-      if (pResult != IntPtr.Zero) Marshal.Release(pResult);
-      if (pItem != IntPtr.Zero) Marshal.Release(pItem);
-      if (pIfod != IntPtr.Zero) Marshal.Release(pIfod);
-    }
-  }
-
-  [UnmanagedFunctionPointer(CallingConvention.StdCall)]
-  private delegate int GetDisplayNameDelegate(IntPtr pThis, uint sigdn, out IntPtr ppszName);
-}
-'@
-
-Add-Type -TypeDefinition $src -Language CSharp | Out-Null
-
-$path = [FolderPicker]::Pick($Title)
-if ($null -ne $path -and $path.Length -gt 0) {
-  Write-Output $path
-}
-exit 0
+# folder-picker.ps1 — modern folder picker for project-knowledge import dialog.
+# Uses the Vista+ IFileOpenDialog COM API (the same dialog VS Code / modern
+# Windows apps show) with the default initial folder set to "This PC".
+#
+# Reads title from $args[0]. Prints the selected absolute path to stdout, or
+# prints nothing if the user cancelled. Exits 0 in both cases.
+#
+# STA apartment + -WindowStyle Hidden is required by the caller; this script
+# assumes the host process has set those flags.
+
+param([string]$Title = 'Select folder')
+
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+
+$src = @'
+using System;
+using System.ComponentModel;
+using System.Linq;
+using System.Runtime.InteropServices;
+
+[Flags]
+public enum FOS : uint {
+  PICKFOLDERS     = 0x00000020,
+  FORCEFILESYSTEM = 0x00000040,
+  NOCHANGEDIR     = 0x00000008
+}
+
+[ComImport, Guid("d57c7288-d4ad-4768-be02-9d969532d960"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+public interface IFileOpenDialog {
+  [PreserveSig] int Show(IntPtr hwndOwner);
+  [PreserveSig] int SetFileTypes(uint cFileTypes, IntPtr rgFilterSpec);
+  [PreserveSig] int SetFileTypeIndex(uint iFileType);
+  [PreserveSig] int GetFileTypeIndex(out uint piFileType);
+  [PreserveSig] int Advise(IntPtr pfde, out uint pdwCookie);
+  [PreserveSig] int Unadvise(uint dwCookie);
+  [PreserveSig] int SetOptions(FOS fos);
+  [PreserveSig] int GetOptions(out FOS pfos);
+  [PreserveSig] int SetDefaultFolder(IntPtr psi);
+  [PreserveSig] int SetFolder(IntPtr psi);
+  [PreserveSig] int GetFolder(out IntPtr ppsi);
+  [PreserveSig] int GetCurrentSelection(out IntPtr ppsi);
+  [PreserveSig] int SetFileName([MarshalAs(UnmanagedType.LPWStr)] string pszName);
+  [PreserveSig] int GetFileName([MarshalAs(UnmanagedType.LPWStr)] out string pszName);
+  [PreserveSig] int SetTitle([MarshalAs(UnmanagedType.LPWStr)] string pszTitle);
+  [PreserveSig] int SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string pszText);
+  [PreserveSig] int SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string pszLabel);
+  [PreserveSig] int GetResult(out IntPtr ppsi);
+  [PreserveSig] int AddPlace(IntPtr psi, int fdap);
+  [PreserveSig] int SetDefaultExtension([MarshalAs(UnmanagedType.LPWStr)] string pszDefaultExtension);
+  [PreserveSig] int Close(int hr);
+  [PreserveSig] int SetClientGuid(ref Guid guid);
+  [PreserveSig] int ClearClientData();
+  [PreserveSig] int SetFilter(IntPtr pFilter);
+  [PreserveSig] int GetResults(out IntPtr ppenum);
+  [PreserveSig] int GetSelectedItems(out IntPtr ppsai);
+}
+
+public static class Shell32 {
+  [DllImport("shell32.dll", CharSet = CharSet.Unicode, ExactSpelling = true, PreserveSig = true)]
+  public static extern int SHCreateItemFromParsingName(
+    [MarshalAs(UnmanagedType.LPWStr)] string pszPath,
+    IntPtr pbc,
+    [MarshalAs(UnmanagedType.LPStruct)] Guid riid,
+    out IntPtr ppv);
+
+  [DllImport("ole32.dll", PreserveSig = true)]
+  public static extern int CoCreateInstance(
+    ref Guid rclsid, IntPtr pUnkOuter, uint dwClsContext, ref Guid riid, out IntPtr ppv);
+}
+
+public static class User32 {
+  [DllImport("user32.dll")]
+  public static extern IntPtr GetForegroundWindow();
+}
+
+public static class FolderPicker {
+  public static string Pick(string title) {
+    Guid clsid = new Guid("DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7");
+    Guid iid   = new Guid("d57c7288-d4ad-4768-be02-9d969532d960");
+    IntPtr pIfod = IntPtr.Zero;
+    IntPtr pItem = IntPtr.Zero;
+    IntPtr pResult = IntPtr.Zero;
+
+    try {
+      int hr = Shell32.CoCreateInstance(ref clsid, IntPtr.Zero, 0x1, ref iid, out pIfod);
+      if (hr != 0) throw new Win32Exception(hr);
+
+      IFileOpenDialog dialog = (IFileOpenDialog)Marshal.GetTypedObjectForIUnknown(pIfod, typeof(IFileOpenDialog));
+
+      FOS opts = FOS.PICKFOLDERS | FOS.FORCEFILESYSTEM | FOS.NOCHANGEDIR;
+      hr = dialog.SetOptions(opts);
+      if (hr != 0) throw new Win32Exception(hr);
+
+      // On Win11 with system ANSI codepage set (e.g. 936 GBK) the Fluent
+// title-bar chrome can garble CJK even though the dialog stores the title
+// correctly in Unicode (taskbar preview is correct via the Unicode path).
+// Use an ASCII title to keep the chrome legible; the import button's
+// surrounding UI (Chinese) tells the user what the picker is for.
+string safeTitle = title.All(c => c < 128) ? title : "Select Project Folder";
+hr = dialog.SetTitle(safeTitle);
+if (hr != 0) throw new Win32Exception(hr);
+
+      // Initial folder = This PC (FOLDERID_ComputerFolder)
+      Guid iidShellItem = new Guid("43826d1e-e718-42ee-bc55-a1e261c37bfe");
+      hr = Shell32.SHCreateItemFromParsingName(
+        "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}",
+        IntPtr.Zero, iidShellItem, out pItem);
+      if (hr != 0) throw new Win32Exception(hr);
+      hr = dialog.SetFolder(pItem);
+      if (hr != 0) throw new Win32Exception(hr);
+
+      // Pass the current foreground window as owner so the dialog is parented
+      // to it (positioned on top, modal to it). Without an owner, the dialog
+      // has no z-order anchor and on Windows 11 ends up hidden behind the
+      // browser window that initiated the call.
+      IntPtr owner = User32.GetForegroundWindow();
+      hr = dialog.Show(owner);
+      // 0 = OK, 0x800704C7 = ERROR_CANCELLED, others = error
+      if (hr != 0) return null;
+
+      hr = dialog.GetResult(out pResult);
+      if (hr != 0 || pResult == IntPtr.Zero) return null;
+
+      // IShellItem vtable index 5 = GetDisplayName(SIGDN, LPWSTR*)
+      IntPtr vtable = Marshal.ReadIntPtr(pResult);
+      IntPtr getDisplayNameFn = Marshal.ReadIntPtr(vtable, 5 * IntPtr.Size);
+      GetDisplayNameDelegate del = (GetDisplayNameDelegate)Marshal.GetDelegateForFunctionPointer(
+        getDisplayNameFn, typeof(GetDisplayNameDelegate));
+
+      IntPtr strPtr = IntPtr.Zero;
+      int ghr = del(pResult, 0x80058000u, out strPtr);  // SIGDN_FILESYSPATH
+      if (ghr != 0 || strPtr == IntPtr.Zero) return null;
+
+      string path = Marshal.PtrToStringUni(strPtr);
+      Marshal.FreeCoTaskMem(strPtr);
+      return path;
+    } finally {
+      if (pResult != IntPtr.Zero) Marshal.Release(pResult);
+      if (pItem != IntPtr.Zero) Marshal.Release(pItem);
+      if (pIfod != IntPtr.Zero) Marshal.Release(pIfod);
+    }
+  }
+
+  [UnmanagedFunctionPointer(CallingConvention.StdCall)]
+  private delegate int GetDisplayNameDelegate(IntPtr pThis, uint sigdn, out IntPtr ppszName);
+}
+'@
+
+Add-Type -TypeDefinition $src -Language CSharp | Out-Null
+
+$path = [FolderPicker]::Pick($Title)
+if ($null -ne $path -and $path.Length -gt 0) {
+  Write-Output $path
+}
+exit 0