agent-purge 0.2.11 → 0.2.12

package/bin/agent-purge.mjs

@@ -106,6 +106,12 @@ switch (cmd) {
 	case "ls":
 		await lsCmd();
 		break;
+	case "pull":
+		await personaImportCmd(argv.slice(1));
+		break;
+	case "persona":
+		await personaImportCmd(argv.slice(1));
+		break;
 	case "doctor":
 	case "detect": {
 		const { doctor } = await import("../lib/doctor.mjs");
@@ -639,6 +645,48 @@ async function statusCmd() {
 	});
 }
 
+async function personaImportCmd(args = []) {
+	let sub = args[0];
+	let source = args[1];
+	if (sub !== "pull" && sub !== "import") {
+		source = sub;
+		sub = "pull";
+	}
+	if (!source && sub === "pull") {
+		source = "ZiChuanLan/some-magic";
+	}
+	if (!source) {
+		die("用法：agent-purge pull [owner/repo 或 本地目录] 或 agent-purge persona import <dir>");
+	}
+
+	const noOverwrite = argv.includes("--no-overwrite");
+	const { importPersonas } = await import("../lib/persona-import.mjs");
+	console.log(`正在从 ${source} 拉取人设...`);
+	try {
+		const res = await importPersonas(source, DATA, { overwrite: !noOverwrite });
+		console.log(`\n拉取完成！共导入 ${res.total} 个人设：`);
+		for (const item of res.imported) {
+			console.log(`  ✓ ${item.id.padEnd(14)} ${item.name} (${item.chars} 字, ${item.action === "created" ? "新增" : "更新"})`);
+		}
+		if (res.skipped?.length) {
+			console.log(`\n跳过 ${res.skipped.length} 个文件：`);
+			for (const item of res.skipped) {
+				console.log(`  - ${item.file || item.id}: ${item.reason}`);
+			}
+		}
+		if (res.errors?.length) {
+			console.log(`\n错误 ${res.errors.length} 项：`);
+			for (const item of res.errors) {
+				console.log(`  ✗ ${item.file}: ${item.error}`);
+			}
+		}
+		console.log(`\n查看已安装人设：agent-purge ls`);
+		console.log(`切换当前人设：agent-purge use <id>`);
+	} catch (e) {
+		die(`拉取失败：${e.message}`);
+	}
+}
+
 async function lsCmd() {
 	const { createStore } = await import("../lib/personas.mjs");
 	const store = createStore(DATA);
@@ -825,6 +873,8 @@ function help() {
 ① 选（写共享配置并同步；已加载动态插件下一轮读取，静态入口需新会话）
    agent-purge use <id>           换 persona（ls 看有哪些，* = 当前；自动刷新已武装的常驻落点）
    agent-purge use <id> --for <h> 只给某一家换 persona；--for <h> follow 恢复跟随全局
+   agent-purge pull [repo]        从 GitHub（默认 ZiChuanLan/some-magic）拉取人设
+   agent-purge persona import <dir> 从本地目录批量导入人设 (.md)
    agent-purge sync               只刷新常驻落点/命令文件，不换 persona
    agent-purge mode <m>           replace(换身份, 默认) / strict(只留人设) / append(追加) / off
    agent-purge mode <m> --for <h> 只给某一家设模式；--for <h> follow 恢复跟随全局

package/lib/persona-import.mjs

@@ -0,0 +1,351 @@
+// 从外部来源（GitHub 仓库或本地目录）拉取/导入人设并存入本地人设库
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, extname, join, resolve } from "node:path";
+import { createStore, isReservedId } from "./personas.mjs";
+
+const IGNORED_NAMES = new Set([
+	"readme.md",
+	"readme_zh.md",
+	"readme.zh.md",
+	"readme.zh-cn.md",
+	"license.md",
+	"licence.md",
+	"changelog.md",
+	"contributing.md",
+	"security.md",
+	"active.md",
+]);
+
+/** 解析源字符串：判断是本地目录还是 GitHub 仓库 */
+export function parseSource(source) {
+	const raw = String(source ?? "").trim();
+	if (!raw) throw new Error("导入源不能为空");
+
+	// 1. 本地目录判断：绝对路径、相对路径前缀、或本地已存在该目录
+	if (
+		raw.startsWith("file://") ||
+		raw.startsWith(".") ||
+		raw.startsWith("/") ||
+		/^[A-Za-z]:[\\/]/.test(raw) ||
+		existsSync(raw)
+	) {
+		let cleanPath = raw;
+		if (raw.startsWith("file://")) {
+			try {
+				cleanPath = new URL(raw).pathname;
+			} catch {
+				cleanPath = raw.slice(7);
+			}
+		}
+		const localDir = resolve(process.cwd(), cleanPath);
+		if (!existsSync(localDir) || !statSync(localDir).isDirectory()) {
+			throw new Error(`本地目录不存在: ${localDir}`);
+		}
+		return { kind: "local", path: localDir };
+	}
+
+	// 2. GitHub URL 或 owner/repo 格式
+	let owner = "";
+	let repo = "";
+	let ref = "main";
+	let subpath = "";
+
+	if (raw.startsWith("http://") || raw.startsWith("https://")) {
+		try {
+			const u = new URL(raw);
+			if (!u.hostname.includes("github.com")) {
+				throw new Error("目前外部拉取仅支持 GitHub 仓库或本地目录");
+			}
+			const parts = u.pathname.replace(/^\/+|\/+$/g, "").split("/");
+			if (parts.length < 2) throw new Error("无效的 GitHub 仓库 URL");
+			owner = parts[0];
+			repo = parts[1].replace(/\.git$/i, "");
+			if (parts[2] === "tree" && parts[3]) {
+				ref = parts[3];
+				subpath = parts.slice(4).join("/");
+			}
+		} catch (e) {
+			throw new Error(`无法解析 GitHub URL: ${e.message}`);
+		}
+	} else {
+		// 可能是 "owner/repo" 或 "owner/repo@ref" 或 "owner/repo/subpath"
+		const clean = raw.replace(/\.git$/i, "");
+		const [repoPart, refPart] = clean.split("@");
+		if (refPart) ref = refPart;
+
+		const parts = repoPart.split("/");
+		if (parts.length >= 2) {
+			owner = parts[0];
+			repo = parts[1];
+			if (parts.length > 2) subpath = parts.slice(2).join("/");
+		} else {
+			throw new Error(`无法识别导入源: ${raw}（请指定 owner/repo 或本地目录路径）`);
+		}
+	}
+
+	return { kind: "github", owner, repo, ref, subpath };
+}
+
+/** 规范化从文件名或 frontmatter 得出的 persona id */
+export function sanitizeId(rawId, fallbackName = "persona") {
+	let s = String(rawId || "").trim().toLowerCase();
+	// 移除非法字符，替换为空格或连字符
+	s = s.replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+	if (!s || isReservedId(s)) {
+		let fb = String(fallbackName || "persona").trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+		s = fb && !isReservedId(fb) ? fb : `p-${Date.now().toString(36)}`;
+	}
+	return s.slice(0, 64);
+}
+
+/** 解析 markdown 中的 frontmatter 与提示词正文 */
+export function parsePersonaDoc(raw, fallbackId = "") {
+	let meta = {};
+	let body = raw;
+
+	if (raw.startsWith("---")) {
+		const end = raw.indexOf("\n---", 3);
+		if (end !== -1) {
+			const head = raw.slice(3, end).trim();
+			body = raw.slice(end + 4).replace(/^\r?\n/, "");
+			meta = parseFrontmatter(head);
+		}
+	}
+
+	const id = sanitizeId(meta.id || fallbackId, fallbackId);
+	const name = meta.name || meta.title || fallbackId || id;
+	const description = meta.description || meta.desc || "";
+	const harness = Array.isArray(meta.harness) ? meta.harness : ["*"];
+	const model = Array.isArray(meta.model) ? meta.model : ["*"];
+	const order = typeof meta.order === "number" ? meta.order : 50;
+
+	return {
+		id,
+		meta: {
+			...meta,
+			id,
+			name,
+			description,
+			harness,
+			model,
+			order,
+		},
+		body: body.trim(),
+	};
+}
+
+function parseFrontmatter(head) {
+	const meta = {};
+	let key = null;
+	for (const line of head.split(/\r?\n/)) {
+		if (!line.trim()) continue;
+		const arr = line.match(/^\s*-\s+(.*)$/);
+		if (arr && key) {
+			if (!Array.isArray(meta[key])) meta[key] = [];
+			meta[key].push(unquote(arr[1]));
+			continue;
+		}
+		const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+		if (!kv) continue;
+		key = kv[1];
+		const v = kv[2].trim();
+		if (!v) {
+			meta[key] = [];
+			continue;
+		}
+		if (v.startsWith("[")) {
+			meta[key] = v
+				.replace(/^\[|\]$/g, "")
+				.split(",")
+				.map((s) => unquote(s.trim()))
+				.filter(Boolean);
+		} else {
+			meta[key] = coerce(v);
+		}
+	}
+	return meta;
+}
+
+const unquote = (s) => s.replace(/^["']|["']$/g, "");
+const coerce = (v) => {
+	if (v === "true") return true;
+	if (v === "false") return false;
+	const n = Number(v);
+	return Number.isFinite(n) && !Number.isNaN(n) && String(n) === v ? n : unquote(v);
+};
+
+/** 从本地目录导入人设 */
+export function importFromDirectory(dirPath, root, { overwrite = true } = {}) {
+	const resolvedDir = resolve(dirPath);
+	if (!existsSync(resolvedDir)) throw new Error(`目录不存在: ${resolvedDir}`);
+
+	const entries = readdirSync(resolvedDir, { withFileTypes: true });
+	const store = createStore(root);
+	const imported = [];
+	const skipped = [];
+	const errors = [];
+
+	for (const entry of entries) {
+		if (entry.isDirectory()) continue;
+		const name = entry.name;
+		const lower = name.toLowerCase();
+		if (!lower.endsWith(".md") && !lower.endsWith(".markdown")) continue;
+		if (IGNORED_NAMES.has(lower) || lower.startsWith(".")) {
+			skipped.push({ file: name, reason: "忽略的文件名（文档或隐藏文件）" });
+			continue;
+		}
+
+		try {
+			const filePath = join(resolvedDir, name);
+			const raw = readFileSync(filePath, "utf8");
+			const fallbackId = basename(name, extname(name));
+			const parsed = parsePersonaDoc(raw, fallbackId);
+
+			if (!parsed.body) {
+				skipped.push({ file: name, reason: "提示词正文为空" });
+				continue;
+			}
+
+			const existing = store.read(parsed.id);
+			if (existing && !overwrite) {
+				skipped.push({ id: parsed.id, name: parsed.meta.name, file: name, reason: "已存在且未开启覆盖" });
+				continue;
+			}
+
+			const saved = store.save(parsed.id, { meta: parsed.meta, body: parsed.body });
+			imported.push({
+				id: saved.id,
+				name: saved.meta.name,
+				chars: saved.body.length,
+				action: existing ? "updated" : "created",
+			});
+		} catch (e) {
+			errors.push({ file: name, error: e.message });
+		}
+	}
+
+	return {
+		success: errors.length === 0,
+		source: { kind: "local", path: resolvedDir },
+		imported,
+		skipped,
+		errors,
+		total: imported.length,
+	};
+}
+
+/** 从 GitHub 仓库拉取人设 */
+export async function pullFromGitHub(
+	{ owner, repo, ref = "main", subpath = "" },
+	root,
+	{ overwrite = true, token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN } = {}
+) {
+	const store = createStore(root);
+	const headers = {
+		"User-Agent": "agent-purge-client",
+		Accept: "application/vnd.github.v3+json",
+	};
+	if (token) headers.Authorization = `Bearer ${token}`;
+
+	const apiPath = subpath ? `contents/${encodeURIComponent(subpath).replace(/%2F/g, "/")}` : "contents";
+	const url = `https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/${apiPath}?ref=${encodeURIComponent(ref)}`;
+
+	let res;
+	try {
+		res = await fetch(url, { headers });
+	} catch (e) {
+		throw new Error(`连接 GitHub 失败: ${e.message}`);
+	}
+
+	if (!res.ok) {
+		const text = await res.text();
+		throw new Error(`GitHub API 响应 ${res.status}: ${text.slice(0, 200)}`);
+	}
+
+	const list = await res.json();
+	if (!Array.isArray(list)) {
+		throw new Error("GitHub 仓库指定路径不是文件列表");
+	}
+
+	const imported = [];
+	const skipped = [];
+	const errors = [];
+
+	for (const item of list) {
+		if (item.type !== "file") continue;
+		const name = item.name;
+		const lower = name.toLowerCase();
+		if (!lower.endsWith(".md") && !lower.endsWith(".markdown")) continue;
+		if (IGNORED_NAMES.has(lower) || lower.startsWith(".")) {
+			skipped.push({ file: name, reason: "忽略的文件名（文档或隐藏文件）" });
+			continue;
+		}
+
+		try {
+			let content = "";
+			// 优先使用 download_url（raw），失败时回退到 git_url 获取 base64 blob
+			if (item.download_url) {
+				try {
+					const r = await fetch(item.download_url, { headers: { "User-Agent": "agent-purge-client" } });
+					if (r.ok) content = await r.text();
+				} catch {
+					// 忽略 raw 失败，走 blob 降级
+				}
+			}
+
+			if (!content && item.git_url) {
+				const blobRes = await fetch(item.git_url, { headers });
+				if (blobRes.ok) {
+					const blobData = await blobRes.json();
+					if (blobData.content && blobData.encoding === "base64") {
+						content = Buffer.from(blobData.content, "base64").toString("utf8");
+					}
+				}
+			}
+
+			if (!content) throw new Error("无法读取文件内容");
+
+			const fallbackId = basename(name, extname(name));
+			const parsed = parsePersonaDoc(content, fallbackId);
+
+			if (!parsed.body) {
+				skipped.push({ file: name, reason: "提示词正文为空" });
+				continue;
+			}
+
+			const existing = store.read(parsed.id);
+			if (existing && !overwrite) {
+				skipped.push({ id: parsed.id, name: parsed.meta.name, file: name, reason: "已存在且未开启覆盖" });
+				continue;
+			}
+
+			const saved = store.save(parsed.id, { meta: parsed.meta, body: parsed.body });
+			imported.push({
+				id: saved.id,
+				name: saved.meta.name,
+				chars: saved.body.length,
+				action: existing ? "updated" : "created",
+			});
+		} catch (e) {
+			errors.push({ file: name, error: e.message });
+		}
+	}
+
+	return {
+		success: errors.length === 0,
+		source: { kind: "github", owner, repo, ref, subpath },
+		imported,
+		skipped,
+		errors,
+		total: imported.length,
+	};
+}
+
+/** 统一入口：根据来源自动分流导入 */
+export async function importPersonas(sourceStr, root, options = {}) {
+	const parsed = parseSource(sourceStr);
+	if (parsed.kind === "local") {
+		return importFromDirectory(parsed.path, root, options);
+	}
+	return pullFromGitHub(parsed, root, options);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-purge",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "One persona, many coding agents: replace or inject system prompts across codex, claude, opencode (v1/v2), grok, omp, hermes, pi, zcode, dsh.",
   "type": "module",
   "bin": {

package/web/app.js

@@ -479,6 +479,71 @@ $('harness-list').addEventListener('change', e => {
 $('default-form').addEventListener('submit', e => { e.preventDefault(); operation(async () => { const result = await api('defaults', { harness: $('default-harness').value || null }); await refresh(); announce(result, '默认启动设置已保存，应用范围未改变。'); }); });
 $('edit-current').addEventListener('click', () => { openEditor(draft.persona); navigate('library'); });
 $('new-persona').addEventListener('click', () => openEditor(''));
+
+// 外部拉取人设
+const importDialog = $('import-dialog');
+const importStatus = $('import-status');
+const importSourceInput = $('import-source');
+const startImportBtn = $('start-import');
+
+$('pull-personas')?.addEventListener('click', () => {
+  if (!importDialog) return;
+  if (!importSourceInput.value.trim()) {
+    importSourceInput.value = 'ZiChuanLan/some-magic';
+  }
+  importStatus.hidden = true;
+  importStatus.className = 'import-status';
+  importStatus.textContent = '';
+  startImportBtn.disabled = false;
+  startImportBtn.textContent = '开始拉取';
+  importDialog.showModal();
+});
+
+$('close-import')?.addEventListener('click', () => importDialog?.close());
+$('cancel-import')?.addEventListener('click', () => importDialog?.close());
+
+importDialog?.addEventListener('click', e => {
+  const pill = e.target.closest('[data-preset]');
+  if (pill) {
+    importSourceInput.value = pill.dataset.preset;
+    importSourceInput.focus();
+  }
+});
+
+$('import-form')?.addEventListener('submit', async e => {
+  e.preventDefault();
+  const source = importSourceInput.value.trim();
+  if (!source) return;
+  const overwrite = $('import-overwrite').checked;
+  startImportBtn.disabled = true;
+  startImportBtn.textContent = '正在拉取…';
+  importStatus.hidden = false;
+  importStatus.className = 'import-status';
+  importStatus.textContent = `正在从 ${source} 拉取人设…`;
+
+  try {
+    const res = await api('persona/import', { source, overwrite });
+    if (!res.ok) throw new Error(res.error || '拉取失败');
+    const { total = 0, imported = [] } = res.result || {};
+    importStatus.className = 'import-status success';
+    const names = imported.map(x => x.name || x.id).slice(0, 3).join('、');
+    const suffix = imported.length > 3 ? '等' : '';
+    const detail = names ? `（${names}${suffix}）` : '';
+    importStatus.textContent = `✓ 成功导入 ${total} 个人设${detail}！`;
+    await refresh();
+    notify(`成功拉取 ${total} 个人设。`);
+    setTimeout(() => {
+      importDialog?.close();
+    }, 1200);
+  } catch (err) {
+    importStatus.className = 'import-status error';
+    importStatus.textContent = `✗ 导入失败：${err.message}`;
+    notify(`人设导入失败：${err.message}`, 'error');
+  } finally {
+    startImportBtn.disabled = false;
+    startImportBtn.textContent = '开始拉取';
+  }
+});
 $('persona-search').addEventListener('input', renderPersonas);
 $('persona-list').addEventListener('click', e => { const el = e.target.closest('[data-persona]'); if (el) openEditor(el.dataset.persona); });
 $('editor-form').addEventListener('input', renderEditorStatus);

package/web/server.mjs

@@ -122,6 +122,7 @@ async function handle(req, res) {
 	if (req.method === "POST" && p === "/api/omp-auto") return send(res, 200, { ompAuto: setOmpAuto(DATA, booleanField(await body(req), "on")) });
 	if (req.method === "POST" && p === "/api/dsh-profile") return send(res, 200, saveDshProfile(await body(req)));
 	if (req.method === "POST" && p === "/api/persona") return send(res, 200, savePersona(await body(req)));
+	if (req.method === "POST" && p === "/api/persona/import") return send(res, 200, await handleImportPersonas(await body(req)));
 	if (req.method === "DELETE" && p === "/api/persona") return send(res, 200, deletePersona(url.searchParams.get("id")));
 	if (req.method === "POST" && p === "/api/harness") return send(res, 200, saveHarnessConfig(await body(req)));
 	if (req.method === "POST" && p === "/api/use") return send(res, 200, usePersona(await body(req)));
@@ -407,6 +408,29 @@ function usePersona(payload) {
 	return { ...applyChanges({ persona: payload.id ?? "" }), active: store.activeId() };
 }
 
+async function handleImportPersonas(payload) {
+	const source = String(payload?.source || "").trim();
+	if (!source) throw httpError(400, "导入源不能为空（请提供 GitHub 仓库如 ZiChuanLan/some-magic 或本地目录）");
+	const overwrite = payload?.overwrite !== false;
+	const { importPersonas } = await import("../lib/persona-import.mjs");
+	try {
+		const result = await importPersonas(source, DATA, { overwrite });
+		let applied = null;
+		if (payload?.activateId && store.read(payload.activateId)) {
+			applied = applyConfiguration(DATA, { persona: payload.activateId });
+		}
+		return {
+			ok: true,
+			result,
+			personas: store.list().map((x) => ({ id: x.id, meta: x.meta, body: x.body, chars: x.body.trim().length })),
+			persona: store.activeId(),
+			applied,
+		};
+	} catch (e) {
+		throw httpError(400, `拉取人设失败: ${e.message}`);
+	}
+}
+
 // 按执行器覆盖人设/模式：值传 null / "" / "follow" = 恢复跟随全局。
 function saveHarnessConfig(payload) {
 	const id = knownHarness(payload.harness);

package/web/styles.css

@@ -885,6 +885,161 @@ summary:hover { color: var(--ink); }
 .result-row strong { font-size: 13.5px; }
 .result-row .error-text { color: var(--red); }
 
+/* ---------- Import Dialog ---------- */
+dialog.modal-dialog {
+  border: 1px solid var(--line);
+  border-radius: var(--radius-lg);
+  background: #ffffff;
+  color: var(--ink);
+  box-shadow: 0 20px 25px -5px rgba(16, 24, 40, 0.12), 0 10px 10px -5px rgba(16, 24, 40, 0.04);
+  padding: 0;
+  max-width: 480px;
+  width: calc(100vw - 32px);
+  margin: auto;
+  overflow: hidden;
+}
+dialog.modal-dialog::backdrop {
+  background: rgba(15, 23, 42, 0.45);
+  backdrop-filter: blur(4px);
+}
+.dialog-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--line-subtle);
+  background: #ffffff;
+}
+.dialog-header h2 {
+  margin: 0;
+  font-size: 16px;
+  font-weight: 600;
+  color: var(--ink);
+  letter-spacing: -0.01em;
+}
+.dialog-header .close-btn {
+  background: transparent;
+  border: none;
+  color: var(--muted);
+  width: 28px;
+  height: 28px;
+  min-height: 28px;
+  border-radius: var(--radius-sm);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 15px;
+  cursor: pointer;
+  padding: 0;
+  box-shadow: none;
+  transition: all 120ms ease;
+}
+.dialog-header .close-btn:hover {
+  background: var(--panel-muted);
+  color: var(--ink);
+  border: none;
+}
+.dialog-desc {
+  padding: 14px 20px 0;
+  margin: 0;
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--muted);
+  background: #ffffff;
+}
+.preset-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 20px 0;
+  flex-wrap: wrap;
+  background: #ffffff;
+}
+.preset-row .muted {
+  font-size: 12px;
+  color: var(--muted);
+}
+.preset-pill {
+  padding: 3px 10px;
+  min-height: auto;
+  font-size: 12px;
+  font-family: "Cascadia Code", "Fira Code", Consolas, monospace;
+  border: 1px solid var(--blue-border);
+  background: var(--blue-subtle);
+  color: var(--blue);
+  border-radius: 999px;
+  cursor: pointer;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  box-shadow: none;
+  transition: all 120ms ease;
+}
+.preset-pill:hover {
+  background: var(--blue-soft);
+  border-color: var(--blue);
+}
+.dialog-body {
+  padding: 14px 20px 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  background: #ffffff;
+}
+.dialog-body label:not(.check-label) {
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--text-secondary);
+}
+.dialog-body input[type="text"] {
+  font-size: 13.5px;
+}
+.dialog-body .check-label {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12.5px;
+  color: var(--text-secondary);
+  cursor: pointer;
+  user-select: none;
+}
+.dialog-body .check-label input {
+  margin: 0;
+}
+.import-status {
+  padding: 10px 14px;
+  border-radius: var(--radius-sm);
+  font-size: 12.5px;
+  line-height: 1.5;
+  background: var(--panel-muted);
+  border: 1px solid var(--line);
+}
+.import-status.success {
+  background: var(--green-soft);
+  color: var(--green);
+  border-color: var(--green-border);
+}
+.import-status.error {
+  background: var(--red-soft);
+  color: var(--red);
+  border-color: var(--red-border);
+}
+.dialog-footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 10px;
+  padding: 12px 20px;
+  border-top: 1px solid var(--line-subtle);
+  background: var(--bg);
+}
+.dialog-footer button {
+  min-height: 34px;
+  padding: 6px 14px;
+  font-size: 13px;
+  font-weight: 500;
+  border-radius: var(--radius-sm);
+}
+
 /* ---------- Responsive ---------- */
 
 @media (max-width: 1100px) {

package/web/ui.html

@@ -47,7 +47,19 @@
 <details class="panel launch-settings"><summary>默认命令启动 <span id="default-summary" class="muted">未设置</span></summary><div class="detail-body"><p class="help">只决定裸敲 <code>agent-purge</code> 时启动谁，不改变上面的应用范围。</p><form id="default-form" class="inline-form"><label for="default-harness">默认执行器</label><select id="default-harness"></select><button class="secondary" type="submit">保存启动设置</button></form></div></details>
 </section>
 <section id="page-library" class="page" aria-labelledby="library-title" hidden>
-<div class="page-heading"><div><h1 id="library-title">人设库</h1><p>正文用于提示词，名称与说明只用于管理。</p></div><button id="new-persona" class="primary">新建人设</button></div>
+<div class="page-heading"><div><h1 id="library-title">人设库</h1><p>正文用于提示词，名称与说明只用于管理。</p></div><div class="actions"><button id="pull-personas" class="secondary" type="button">从外部拉取</button><button id="new-persona" class="primary" type="button">新建人设</button></div></div>
+<dialog id="import-dialog" class="modal-dialog"><form id="import-form" method="dialog">
+<div class="dialog-header"><h2>从外部拉取人设</h2><button type="button" id="close-import" class="quiet close-btn" aria-label="关闭">✕</button></div>
+<p class="help dialog-desc">可从公开 GitHub 仓库或本机目录批量导入 <code>.md</code> 提示词文件，自动跳过说明文档并写入本地人设库。</p>
+<div class="preset-row"><span class="muted">快捷推荐：</span><button type="button" class="preset-pill" data-preset="ZiChuanLan/some-magic">ZiChuanLan/some-magic</button></div>
+<div class="dialog-body">
+<label for="import-source">导入源（GitHub owner/repo 或 本地目录路径）</label>
+<input id="import-source" placeholder="如 ZiChuanLan/some-magic 或 D:\prompts" required autocomplete="off">
+<label class="check-label"><input type="checkbox" id="import-overwrite" checked>覆盖同名标识（已有标识以新内容为主）</label>
+<div id="import-status" class="import-status" hidden></div>
+</div>
+<div class="dialog-footer"><button type="button" id="cancel-import" class="quiet">取消</button><button type="submit" id="start-import" class="primary">开始拉取</button></div>
+</form></dialog>
 <div class="library-layout"><aside class="panel persona-sidebar"><label class="sr-only" for="persona-search">搜索人设</label><input id="persona-search" type="search" placeholder="搜索名称或说明"><div id="persona-list"></div></aside>
 <section class="panel editor-panel"><div id="editor-empty" class="empty">选择一份人设，查看或编辑正文。</div><form id="editor-form" hidden>
 <div class="section-heading"><h2 id="editor-title">编辑人设</h2><span id="editor-status" class="muted">未修改</span></div>