Skip to content

Spot it. Save it. Free, local-first Chrome extension for images, videos and prompts. Explore 2,000+ curated cases and connect your library to AI Agents via MCP. 提示词导演

8.1 KB
Raw Blame
import { homedir } from 'node:os';
import { join } from 'node:path';
import { Client } from '@modelcontextprotocol/client';
import { StdioClientTransport } from '@modelcontextprotocol/client/stdio';
import { installationPlan, install } from './install.mjs';
import { HOSTS, hostConfiguration, configurationPlan, writeConfiguration } from './host-config.mjs';
import { discoverLibraries } from './discovery.mjs';
import { connectorRoot, instancePaths } from './paths.mjs';
import { isMain } from './is-main.mjs';
import { nodeCommand } from './node-command.mjs';
import { lstat } from 'node:fs/promises';

export function mcpConfiguration(root, instanceId) {
  if (instanceId) instancePaths(root, instanceId);
  return { command: nodeCommand(), args: [join(root, 'runtime/mcp.mjs')],
    env: { PROMPTDIRECTOR_CONNECTOR_HOME: root, ...(instanceId ? { PROMPTDIRECTOR_INSTANCE: instanceId } : {}) } };
}
export async function setupPlan({ host, root = connectorRoot(), instanceId, home = homedir(), env = process.env, profile, nativeDirectory, extensionId } = {}) {
  const installation = await installationPlan({ root, nativeDirectory, extensionId });
  const mcp = mcpConfiguration(installation.root, instanceId);
  const configuration = await configurationPlan(hostConfiguration(host, { home, env, profile }), mcp);
  return { installation, configuration, instanceId, mcp };
}
function value(result) {
  const text = result.content?.filter(item => item.type === 'text').map(item => item.text).join('');
  if (result.isError) throw new Error(text || 'MCP 调用失败');
  return JSON.parse(text);
}
export async function verifyConnection({ root = connectorRoot(), instanceId, probe = discoverLibraries, onProgress = stage => { if (process.env.PROMPTDIRECTOR_DEBUG) console.error(`[PromptDirector verify] ${stage}`); } } = {}) {
  onProgress('library-discovery');
  const libraries = await probe({ root, instanceId });
  if (!libraries.length) return { state: 'awaiting_browser', connected: false,
    diagnostics: await offlineDiagnostics(root, instanceId),
    next: '在已安装 PromptDirector 的 Chrome 中打开设置 → Agent 连接 → 启用。若已启用请断开再启用;浏览器要求重新加载时先保存未完成编辑,然后重试 verify。' };
  if (libraries.length > 1) return { state: 'library_selection_required', connected: false, libraries,
    next: '请从目标案例库复制连接指令,使用其中的 instance 参数;不要猜测用户要连接哪个资料库。' };
  const selected = libraries[0].instanceId;
  const mcp = mcpConfiguration(root, selected);
  const client = new Client({ name: 'promptdirector-setup-check', version: '1' });
  try {
    onProgress('mcp-start');
    await client.connect(new StdioClientTransport({ ...mcp, env: { ...mcp.env, ...(process.env.PROMPTDIRECTOR_DEBUG ? { PROMPTDIRECTOR_DEBUG: process.env.PROMPTDIRECTOR_DEBUG } : {}) } }));
    onProgress('mcp-tools');
    const listed = await client.listTools();
    const names = listed.tools.map(tool => tool.name);
    for (const required of ['promptdirector_status', 'promptdirector_search_cases', 'promptdirector_read_case', 'promptdirector_read_media']) {
      if (!names.includes(required)) throw new Error(`MCP 缺少所需能力:${required}`);
    }
    onProgress('library-status');
    const status = value(await client.callTool({ name: 'promptdirector_status', arguments: {} }));
    if (status.instanceId !== selected || !status.enabled || status.status !== 'connected') throw new Error('MCP 返回的资料库与目标不一致或尚未连接。');
    onProgress('library-search');
    const result = value(await client.callTool({ name: 'promptdirector_search_cases', arguments: { query: '', limit: 3 } }));
    if (!Array.isArray(result.cases) || !Number.isInteger(result.total)) throw new Error('案例搜索未返回有效结果。');
    return { state: 'connector_verified', connected: true, instanceId: selected, mcp,
      extensionVersion: status.extensionVersion, caseCount: result.total, sampleCases: result.cases,
      hostSessionVerified: false,
      next: '连接器已实际查询案例库。还需在当前 Agent 会话发现 promptdirector 工具并调用 status/search_cases;如需重载请使用宿主正常入口。只有当前会话实际调用成功后才报告已连接;需要展示案例时按返回的媒体编号读取原件。' };
  } finally { onProgress('mcp-close'); await client.close(); onProgress('mcp-closed'); }
}
async function offlineDiagnostics(root, instanceId) {
  const present = async path => {
    try { await lstat(path); return 'present'; }
    catch (error) { return error.code === 'ENOENT' ? 'missing' : 'unreadable'; }
  };
  const paths = instanceId ? instancePaths(root, instanceId) : null;
  return { runtime: await present(join(root, 'runtime/mcp.mjs')), launcher: await present(join(root, process.platform === 'win32' ? 'native-host.cmd' : 'native-host')),
    pairing: paths ? await present(paths.record) : 'unknown',
    endpoint: paths && process.platform !== 'win32' ? await present(paths.socket) : 'unknown',
    browserRunning: 'unknown', extensionInstalled: 'unknown', agentSwitchEnabled: 'unknown',
    note: '仅核对连接器自有文件;文件存在不表示握手成功,endpoint缺失不能区分浏览器、扩展或开关状态。' };
}
export async function connect(options, { installRuntime = install, verify = verifyConnection } = {}) {
  const plan = await setupPlan(options);
  if (plan.configuration.state === 'host_verification_required') return { state: plan.configuration.state, connected: false, configuration: await writeConfiguration(plan.configuration) };
  await installRuntime(plan.installation);
  const configured = plan.instanceId ? await writeConfiguration(plan.configuration)
    : { changed: false, state: 'awaiting_pairing' };
  const checked = await verify({ root: plan.installation.root, instanceId: plan.instanceId });
  // Bind a discovered single library explicitly so another Chrome profile cannot
  // later redirect this host through the global selected.json preference.
  let finalConfiguration = configured;
  if (!plan.instanceId && checked.connected) {
    finalConfiguration = await writeConfiguration(await configurationPlan(
      hostConfiguration(options.host, { home: options.home, env: options.env, profile: options.profile }), checked.mcp));
  }
  return { ...checked, configuration: finalConfiguration, mcp: checked.mcp || (plan.instanceId ? plan.mcp : undefined),
    skill: join(plan.installation.runtime, 'SKILL.md') };
}
function optionsFrom(args) {
  const options = {};
  const keys = { '--host': 'host', '--instance': 'instanceId', '--root': 'root', '--profile': 'profile' };
  for (let index = 0; index < args.length; index += 2) {
    const key = keys[args[index]];
    if (!key || !args[index + 1] || args[index + 1].startsWith('--')) throw new Error(`用法:node connector/setup.mjs plan|connect|verify --host ${HOSTS.join('|')} [--instance 编号] [--root 私有目录] [--profile DSH配置名称]`);
    options[key] = args[index + 1];
  }
  return options;
}
if (isMain(import.meta.url)) {
  try {
    const [command = 'plan', ...args] = process.argv.slice(2);
    const options = optionsFrom(args);
    let result;
    if (command === 'plan') {
      const plan = await setupPlan(options);
      result = { installation: plan.installation, configuration: { path: plan.configuration.path, changed: plan.configuration.changed, host: plan.configuration.host, state: plan.configuration.state, hostEnabled: plan.configuration.hostEnabled, next: plan.configuration.next, importConfig: plan.configuration.importConfig }, mcp: plan.instanceId && plan.configuration.state !== 'host_verification_required' ? plan.mcp : undefined };
    } else if (command === 'connect') result = await connect(options);
    else if (command === 'verify') result = await verifyConnection(options);
    else throw new Error('未知命令,请使用 plan、connect 或 verify。');
    console.log(JSON.stringify(result, null, 2));
  } catch (error) {
    // Configuration files can contain credentials. Never echo their contents.
    console.error(JSON.stringify({ state: 'failed', connected: false, message: error.message })); process.exitCode = 1;
  }
}