From 91ac1704b0f0426aab0a7202f52179f4cfd9ffcf Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:03:18 +0900 Subject: [PATCH 1/9] =?UTF-8?q?feat(personas):=20=E6=96=B0=E5=A2=9E?= =?UTF-8?q?=E8=A7=92=E8=89=B2=E5=8C=85=E5=AF=BC=E5=87=BA=E4=B8=8E=E5=AF=BC?= =?UTF-8?q?=E5=85=A5=20/=20add=20persona=20bundle=20export=20and=20import?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 角色可打包为 zip(persona.md + 头像 + 专属技能 + 专属 MCP 含解密秘密 + 知识库目录),在另一台机器 / 另一 DEVA_HOME 导入 / bundle a persona with its avatar, exclusive skills and MCP servers (secrets decrypted), and knowledge directory for import on another machine or DEVA_HOME - 导入按来源簿记判定:同包再导入就地更新;原 id 空闲则沿用,冲突铸新 id,内置角色永不落位 / import decides by provenance: same bundle re-import updates in place, free ids are kept, conflicts mint new ids, builtin ids are never targeted - 侧入口:Rail 角色右键导出(内置灰显)、花名册 + 菜单导入;成功后 toast 并刷新扩展清单 / Rail context menu exports (builtins disabled), roster add-menu imports, with toast feedback and extension refresh - personas.ts 导出目录助手(路径唯一出口)、atomic-write 支持二进制原子写 / personas.ts now exports its directory helpers as the single path source; writeFileAtomic gains a binary overload --- apps/desktop/src/main/index.ts | 2 + .../desktop/src/main/services/atomic-write.ts | 6 +- .../desktop/src/main/services/persona-port.ts | 622 ++++++++++++++++++ apps/desktop/src/main/services/personas.ts | 76 ++- apps/desktop/src/preload/index.ts | 19 + .../desktop/src/renderer/src/i18n/messages.ts | 17 + .../renderer/src/redesign/ChatFirstShell.tsx | 40 +- .../src/renderer/src/redesign/Rail.tsx | 37 +- 8 files changed, 810 insertions(+), 9 deletions(-) create mode 100644 apps/desktop/src/main/services/persona-port.ts diff --git a/apps/desktop/src/main/index.ts b/apps/desktop/src/main/index.ts index 2316289a..ea16c8ab 100644 --- a/apps/desktop/src/main/index.ts +++ b/apps/desktop/src/main/index.ts @@ -15,6 +15,7 @@ import { sweepSubagents } from './services/subagent-store' import { sweepMedia } from './services/media-store' import { registerSkillsIpc, startSkillsWatcher } from './services/skills' import { ensureSeededPersonas, pinAutoAvatarShapes, pruneOrphanExtRoles, registerPersonasIpc } from './services/personas' +import { registerPersonaPortIpc } from './services/persona-port' import { registerProfileIpc } from './services/profile' import { registerMemoryIpc } from './services/memory' import { @@ -365,6 +366,7 @@ if (!app.requestSingleInstanceLock()) { // 技能 / MCP 的可用角色里已不存在的角色:剔除,都没了的改回所有角色并停用(须在 MCP 自动连接之前)。 pruneOrphanExtRoles() registerPersonasIpc() + registerPersonaPortIpc(() => mainWindow) registerProfileIpc() registerMemoryIpc() diff --git a/apps/desktop/src/main/services/atomic-write.ts b/apps/desktop/src/main/services/atomic-write.ts index 42af0459..11b0abad 100644 --- a/apps/desktop/src/main/services/atomic-write.ts +++ b/apps/desktop/src/main/services/atomic-write.ts @@ -8,13 +8,13 @@ import { renameSync, rmSync, writeFileSync } from 'fs' * (与旧行为一致)并清掉残留 tmp;tmp 本身写不进(磁盘满等)则原样抛出——此时再去直写只会把 * 旧文件也截断。`.tmp` 后缀让按扩展名扫描目录的地方(对话索引重建、角色目录)天然跳过它。 */ -export function writeFileAtomic(file: string, data: string): void { +export function writeFileAtomic(file: string, data: string | Uint8Array): void { const tmp = `${file}.tmp` - writeFileSync(tmp, data, 'utf8') + writeFileSync(tmp, data, typeof data === 'string' ? 'utf8' : undefined) try { renameSync(tmp, file) } catch { - writeFileSync(file, data, 'utf8') + writeFileSync(file, data, typeof data === 'string' ? 'utf8' : undefined) try { rmSync(tmp, { force: true }) } catch { diff --git a/apps/desktop/src/main/services/persona-port.ts b/apps/desktop/src/main/services/persona-port.ts new file mode 100644 index 00000000..ea6166a7 --- /dev/null +++ b/apps/desktop/src/main/services/persona-port.ts @@ -0,0 +1,622 @@ +import { app, dialog, ipcMain, type BrowserWindow } from 'electron' +import { createHash } from 'crypto' +import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'fs' +import { isAbsolute, join, resolve, sep } from 'path' +import { unzipSync, zipSync, type Unzipped } from 'fflate' +import { writeFileAtomic } from './atomic-write' +import { + avatarsDir, + builtinPersonaIds, + getPersona, + isSafeId, + makeId, + personaKnowledgeDir, + personasDir, + readImportsMap, + readPersonaMdRaw, + upsertPersona, + writeImportsEntry, + type PersonaImportProvenance +} from './personas' +import { clearAvatarImage, readAvatarImage, writeAvatarImage } from './avatar-image' +import { fmString, parseFrontmatter } from './frontmatter' +import { getRoles, setRoles } from './ext-roles' +import { listSkills, skillsDir } from './skills' +import { + getServerConfig, + listServerConfigs, + upsertServer, + type McpServerConfig, + type McpTransport +} from './mcp-config' +import { getSecret, setSecret } from './secrets' + +/** + * 角色包(persona bundle)导出 / 导入:把一条角色及其**从属内容**(专属技能、专属 MCP、知识库目录、 + * 自定义头像)打成单个 zip,在另一台机器 / 另一个 DEVA_HOME 上还原。设计与决策见 + * docs/plantree/plans/001-persona-export-import/(D1 id 判定序 / D2 内置硬闸 / D3 再导入=更新 / Q4 打包范围)。 + * + * - persona.md 取磁盘**原文**(readPersonaMdRaw):与用户磁盘上的工件字节一致,frontmatter 不加新键。 + * - 目录路径一律经 personas.ts 的 personasDir / avatarsDir / personaKnowledgeDir——角色相关路径的唯一出口,此处不出现字面量。 + * - 秘密链路:导出把 `{secretRef}` 经 getSecret 解成包内 `{ secret: 明文 }`(用户明示接受包内明文); + * 导入即重加密回本机 secrets.json(setSecret),此后明文不再落地。 + * - 簿记(personas.imports,见 personas.ts)让「同一包再次导入」走就地更新而非重复新建。 + */ + +export const BUNDLE_KIND = 'deva-persona-bundle' +export const BUNDLE_FORMAT = 1 + +// 限额(防 zip 炸弹):角色包 ≈ prompt 文本 + ≤2MB 头像 + 技能/知识库目录,比技能包宽松但仍有界。 +const BUNDLE_MAX_TOTAL_BYTES = 30 * 1024 * 1024 +const BUNDLE_MAX_FILES = 500 +const BUNDLE_MAX_SINGLE_BYTES = 10 * 1024 * 1024 + +/** 头像扩展名 → MIME(与 avatar-image.ts 的白名单对齐:webp/png/jpg 三种)。 */ +const MIME_BY_EXT: Record = { + webp: 'image/webp', + png: 'image/png', + jpg: 'image/jpeg' +} + +export interface PersonaExportResult { + ok: boolean + /** 成功时写出的 zip 绝对路径。 */ + path?: string + /** 稳定错误码(渲染层本地化):builtin / not-found / cancelled / too-large / save-failed。 */ + error?: string + /** 解不出的 MCP 秘密字段(`mcp::<字段>` 清单)——包能导出,但那些字段没带上。 */ + warnings?: string[] +} + +export interface PersonaImportResult { + ok: boolean + /** 稳定错误码:cancelled / bad-zip / bad-manifest / bad-persona / unsafe-path / too-large / too-many-files / write-failed / import-failed。 */ + error?: string + id?: string + name?: string + /** true = 同源包的就地更新(D3);false = 新建。 */ + updated?: boolean + /** 包内技能 / MCP id → 本地落地 id(铸了新 id 时非恒等)。 */ + idMap?: { skills: Record; mcp: Record } + warnings?: string[] +} + +/** manifest.json(包内自描述;originalId 等来源信息只进这里,不污染 persona.md)。 */ +interface BundleManifest { + kind?: unknown + format?: unknown + exportedAt?: unknown + appVersion?: unknown + originalId?: unknown + contents?: { + skills?: unknown + mcp?: unknown + knowledge?: unknown + } +} + +/** 包内 MCP 条目:env/headers 的秘密字段以 `{ secret: 明文 }` 与普通明文串区分,导入时分别处理。 */ +interface BundleMcpEntry { + id?: unknown + name?: unknown + description?: unknown + transport?: unknown + command?: unknown + args?: unknown + url?: unknown + env?: Record + headers?: Record +} + +type BundleValue = string | { secret: string } + +// ── 通用小工具 ──────────────────────────────────────────────────────────────── + +function utf8(s: string): Uint8Array { + return new Uint8Array(Buffer.from(s, 'utf8')) +} + +/** 逐段 zip-slip 守卫:拒绝空段 / `.` / `..` / 含分隔符或盘符 / 绝对路径(与 skills.ts 同一取法)。 */ +function isSafeBundlePath(rel: string): boolean { + if (!rel || isAbsolute(rel)) return false + return !rel.split('/').some((s) => s === '' || s === '.' || s === '..' || /[\\:\0]/.test(s)) +} + +interface BundleSizeState { + count: number + totalBytes: number +} + +/** 递归收集目录下全部文件为「包内相对路径 → 字节」。返回 false = 超限额(调用方中止导出)。 */ +function collectDirInto( + root: string, + relBase: string, + out: Record, + state: BundleSizeState +): boolean { + let entries: string[] + try { + entries = readdirSync(root) + } catch { + return true + } + for (const name of entries) { + const abs = join(root, name) + const rel = `${relBase}${name}` + let st + try { + st = statSync(abs) + } catch { + continue + } + if (st.isDirectory()) { + if (!collectDirInto(abs, `${rel}/`, out, state)) return false + continue + } + state.count += 1 + if (state.count > BUNDLE_MAX_FILES) return false + if (st.size > BUNDLE_MAX_SINGLE_BYTES) return false + state.totalBytes += st.size + if (state.totalBytes > BUNDLE_MAX_TOTAL_BYTES) return false + try { + out[rel] = new Uint8Array(readFileSync(abs)) + } catch { + continue + } + } + return true +} + +/** 把解压出的包文件按相对路径落到一个目标目录(先整删目标再落——更新语义;逐段守卫 + 断言在目标内)。 */ +function extractDirInto(files: Unzipped, prefix: string, target: string): { ok: boolean; error?: string } { + try { + rmSync(target, { recursive: true, force: true }) + mkdirSync(target, { recursive: true }) + } catch { + return { ok: false, error: 'write-failed' } + } + const guardedRoot = resolve(target) + for (const [p, data] of Object.entries(files)) { + if (!p.startsWith(prefix) || p.endsWith('/')) continue + const rel = p.slice(prefix.length) + if (!isSafeBundlePath(rel)) return { ok: false, error: 'unsafe-path' } + const dest = resolve(target, rel) + // 纵深防御:断言落在目标目录内(逐段守卫之外再验一次)。 + if (dest !== guardedRoot && !dest.startsWith(guardedRoot + sep)) continue + try { + mkdirSync(resolve(dest, '..'), { recursive: true }) + writeFileSync(dest, Buffer.from(data)) + } catch { + return { ok: false, error: 'write-failed' } + } + } + return { ok: true } +} + +/** 铸一个 `-2/-3…` 的空闲 id(占用探测由调用方传 has)。 */ +function mintFreeId(base: string, has: (x: string) => boolean): string { + let id = base + let n = 2 + while (has(id)) id = `${base}-${n++}` + return id +} + +function stringIds(v: unknown): string[] { + return Array.isArray(v) ? v.filter((x): x is string => typeof x === 'string') : [] +} + +// ── 导出 ────────────────────────────────────────────────────────────────────── + +/** + * 组包内 MCP 条目:`{secretRef}` 占位经 getSecret 解成包内 `{ secret: 明文 }`; + * 解不出的字段(未配置 / 加密不可用)跳过并记警告——包能导出,但那些字段没带上。 + */ +async function bundleMcpEntry(cfg: McpServerConfig, warnings: string[]): Promise { + const conv = async ( + map: Record | undefined + ): Promise | undefined> => { + if (!map || typeof map !== 'object') return undefined + const out: Record = {} + for (const [k, v] of Object.entries(map)) { + if (typeof v === 'string') { + out[k] = v + continue + } + const ref = (v as { secretRef?: unknown })?.secretRef + if (typeof ref !== 'string' || !ref) continue + const val = await getSecret(`mcp:${cfg.id}:${ref}`) + if (val) out[k] = { secret: val } + else warnings.push(`mcp:${cfg.id}:${k}`) + } + return Object.keys(out).length ? out : undefined + } + const entry: BundleMcpEntry = { + id: cfg.id, + name: cfg.name, + description: cfg.description, + transport: cfg.transport + } + if (cfg.transport === 'stdio') { + entry.command = cfg.command + entry.args = cfg.args + entry.env = await conv(cfg.env as unknown as Record) + } else { + entry.url = cfg.url + entry.headers = await conv(cfg.headers as unknown as Record) + } + return entry +} + +/** + * 导出一条角色为 zip 包:主进程弹保存框(模态),写 `.devapersona.zip`。 + * 本地只读(目录收集)+ 一次写盘,不改任何本地状态。canceled = 用户取消。 + */ +export async function exportPersonaBundle( + getWindow: () => BrowserWindow | null, + id: string +): Promise { + const win = getWindow() + if (builtinPersonaIds().has(id)) return { ok: false, error: 'builtin' } // D2:内置不导出 + const raw = readPersonaMdRaw(id) + if (raw === null) return { ok: false, error: 'not-found' } + const rec = getPersona(id) + const warnings: string[] = [] + + const files: Record = { 'persona.md': utf8(raw) } + const contents: { skills: string[]; mcp: string[]; knowledge: boolean } = { + skills: [], + mcp: [], + knowledge: false + } + const state: BundleSizeState = { count: 1, totalBytes: Buffer.byteLength(raw, 'utf8') } + + // 自定义头像(.webp/.png/.jpg 任一存在;无图则包里也不带) + const avatarDataUri = readAvatarImage(avatarsDir(), id) + const avatarM = avatarDataUri ? /^data:image\/([a-z0-9.+-]+);base64,([\s\S]+)$/i.exec(avatarDataUri) : null + if (avatarM) { + const ext = avatarM[1] === 'jpeg' ? 'jpg' : avatarM[1] + if (MIME_BY_EXT[ext]) { + files[`avatar.${ext}`] = new Uint8Array(Buffer.from(avatarM[2], 'base64')) + state.count += 1 + state.totalBytes += files[`avatar.${ext}`].length + } + } + + // 知识库目录(issue#65 档 0 约定,personas/knowledge//) + if (existsSync(personaKnowledgeDir(id))) { + if (!collectDirInto(personaKnowledgeDir(id), `knowledge/${id}/`, files, state)) { + return { ok: false, error: 'too-large' } + } + contents.knowledge = true + } + + // 专属技能:可用角色列表(ext-roles)含该角色才随包——共享给全部角色(无 roles 键)的不打包 + for (const s of listSkills()) { + if (s.source !== 'custom') continue + const roles = getRoles('skills', s.id) + if (!roles || !roles.includes(id)) continue + const before = state.count + if (!collectDirInto(join(skillsDir(), s.id), `skills/${s.id}/`, files, state)) { + return { ok: false, error: 'too-large' } + } + if (state.count > before) contents.skills.push(s.id) + } + // 专属 MCP:配置 + 解密秘密 + const mcpEntries: BundleMcpEntry[] = [] + for (const cfg of listServerConfigs()) { + const roles = getRoles('mcp', cfg.id) + if (!roles || !roles.includes(id)) continue + const entry = await bundleMcpEntry(cfg, warnings) + if (entry) { + mcpEntries.push(entry) + contents.mcp.push(cfg.id) + } + } + if (mcpEntries.length) files['mcp.json'] = utf8(JSON.stringify({ servers: mcpEntries }, null, 2)) + + const manifest = { + kind: BUNDLE_KIND, + format: BUNDLE_FORMAT, + exportedAt: new Date().toISOString(), + appVersion: app.getVersion(), + originalId: id, + contents + } + files['manifest.json'] = utf8(JSON.stringify(manifest, null, 2)) + + const safeName = (rec?.name || id).replace(/[\\/:*?"<>|]/g, '_').trim() || id + const opts = { + defaultPath: `${safeName}.devapersona.zip`, + filters: [{ name: '角色包', extensions: ['zip'] }] + } + const res = win ? await dialog.showSaveDialog(win, opts) : await dialog.showSaveDialog(opts) + if (res.canceled || !res.filePath) return { ok: false, error: 'cancelled' } + try { + writeFileAtomic(res.filePath, Buffer.from(zipSync(files))) + } catch { + return { ok: false, error: 'save-failed' } + } + return { ok: true, path: res.filePath, warnings: warnings.length ? warnings : undefined } +} + +// ── 导入 ────────────────────────────────────────────────────────────────────── + +/** 解包 + 限额 + 全路径守卫 + manifest 校验;失败给出稳定错误码。 */ +function unzipBundle(filePath: string): { files: Unzipped; manifest: BundleManifest } | { error: string } { + let files: Unzipped + try { + files = unzipSync(readFileSync(filePath)) + } catch { + return { error: 'bad-zip' } + } + const paths = Object.keys(files).filter((p) => !p.endsWith('/') && !p.startsWith('__MACOSX/')) + if (paths.length > BUNDLE_MAX_FILES) return { error: 'too-many-files' } + let total = 0 + for (const p of paths) { + if (!isSafeBundlePath(p)) return { error: 'unsafe-path' } + total += files[p].length + if (files[p].length > BUNDLE_MAX_SINGLE_BYTES) return { error: 'too-large' } + if (total > BUNDLE_MAX_TOTAL_BYTES) return { error: 'too-large' } + } + let manifest: BundleManifest + try { + manifest = JSON.parse(Buffer.from(files['manifest.json']).toString('utf8')) as BundleManifest + } catch { + return { error: 'bad-manifest' } + } + if (manifest?.kind !== BUNDLE_KIND || manifest?.format !== BUNDLE_FORMAT) return { error: 'bad-manifest' } + if (!files['persona.md']) return { error: 'bad-persona' } + return { files, manifest } +} + +/** 包内 persona.md → upsertPersona 入参(frontmatter 四键 + 正文)。 */ +function parseBundlePersona( + files: Unzipped, + fallbackName: string +): { name: string; description: string; avatar: string; model: string; prompt: string } | null { + try { + const { data, body } = parseFrontmatter(Buffer.from(files['persona.md']).toString('utf8')) + const name = fmString(data, 'name').trim() || fallbackName + return { + name, + description: fmString(data, 'description'), + avatar: fmString(data, 'avatar'), + model: fmString(data, 'model'), + prompt: body.trim() + } + } catch { + return null + } +} + +/** + * id 判定序(决策 D1 + D3):原 id 安全、非内置且空闲 → 沿用(新建); + * 已被占且簿记在案(同源包之前导入过)→ 就地更新;其余(撞了别的角色 / 外来 id / 内置)→ 铸随机新 id。 + */ +function resolveImportId( + originalId: string, + localName: string +): { finalId: string; updated: boolean; keepOriginal: boolean } { + const builtin = builtinPersonaIds() + const usable = isSafeId(originalId) && !builtin.has(originalId) + if (usable) { + if (!existsSync(join(personasDir(), `${originalId}.md`))) { + return { finalId: originalId, updated: false, keepOriginal: true } + } + if (readImportsMap()[originalId]) return { finalId: originalId, updated: true, keepOriginal: true } + } + return { finalId: makeId(localName), updated: false, keepOriginal: false } +} + +/** 落头像:包里带图则覆盖写;不带则清掉本地旧图(包是该角色外观的真源,更新后不留旧脸)。 */ +function installAvatar(files: Unzipped, finalId: string): void { + clearAvatarImage(avatarsDir(), finalId) + for (const ext of Object.keys(MIME_BY_EXT)) { + const data = files[`avatar.${ext}`] + if (!data) continue + writeAvatarImage(avatarsDir(), finalId, `data:${MIME_BY_EXT[ext]};base64,${Buffer.from(data).toString('base64')}`) + return + } +} + +/** + * 随包技能:id 判定优先回访簿记映射(映射到的本地技能已被删则当作没映射过),其次占用空闲原名, + * 冲突才铸 `-2` 新名(记警告)。落地后可用角色收窄为仅该角色(Q4:不保留原多角色分配)。 + */ +function installBundledSkills( + files: Unzipped, + bundleSkillIds: string[], + prov: PersonaImportProvenance | undefined, + finalPersonaId: string, + warnings: string[] +): Record { + const idMap: Record = {} + for (const bundleId of bundleSkillIds) { + const prefix = `skills/${bundleId}/` + if (!isSafeId(bundleId) || !Object.keys(files).some((p) => p.startsWith(prefix))) continue + let target = prov?.skills?.[bundleId] + if (target && !existsSync(join(skillsDir(), target))) target = '' + if (!target) { + if (!existsSync(join(skillsDir(), bundleId))) { + target = bundleId + } else { + target = mintFreeId(bundleId, (x) => existsSync(join(skillsDir(), x))) + warnings.push(`skill:${bundleId}→${target}`) + } + } + const r = extractDirInto(files, prefix, join(skillsDir(), target)) + if (!r.ok) { + warnings.push(`skill:${bundleId}:${r.error}`) + continue + } + setRoles('skills', target, [finalPersonaId]) + idMap[bundleId] = target + } + return idMap +} + +/** + * 随包 MCP:秘密明文重加密回本机 secrets.json(加密不可用的字段跳过并记警告,留待用户手填), + * 配置落 mcp.json(upsertServer 的变更通知驱动连接),导入即启用,角色收窄为仅该角色。 + */ +async function installBundledMcp( + files: Unzipped, + bundleMcpIds: string[], + prov: PersonaImportProvenance | undefined, + finalPersonaId: string, + warnings: string[] +): Promise> { + const idMap: Record = {} + let entries: BundleMcpEntry[] = [] + try { + const parsed = JSON.parse(Buffer.from(files['mcp.json'] ?? utf8('{"servers":[]}')).toString('utf8')) + if (Array.isArray(parsed?.servers)) entries = parsed.servers as BundleMcpEntry[] + } catch { + warnings.push('mcp:unreadable') + } + const existing = new Set(listServerConfigs().map((s) => s.id)) + const conv = async ( + mid: string, + map: Record | undefined + ): Promise | undefined> => { + if (!map || typeof map !== 'object') return undefined + const out: Record = {} + for (const [k, v] of Object.entries(map)) { + if (typeof v === 'string') { + out[k] = v + continue + } + const secret = (v as { secret?: unknown })?.secret + if (typeof secret !== 'string' || !secret) continue + const r = await setSecret(`mcp:${mid}:${k}`, secret) + if (!r.ok) { + warnings.push(`mcp:${mid}:${k}:secret-unavailable`) + continue + } + out[k] = { secretRef: k } + } + return Object.keys(out).length ? out : undefined + } + for (const e of entries) { + const bundleId = typeof e.id === 'string' ? e.id : '' + if (!bundleId || !bundleMcpIds.includes(bundleId) || !isSafeId(bundleId)) continue + let mid = prov?.mcp?.[bundleId] + if (mid && !getServerConfig(mid)) mid = '' // 映射到的本地服务已被删:当作没映射过 + if (!mid) { + if (!existing.has(bundleId)) { + mid = bundleId + } else { + mid = mintFreeId(bundleId, (x) => existing.has(x)) + warnings.push(`mcp:${bundleId}→${mid}`) + } + } + existing.add(mid) + const transport: McpTransport = e.transport === 'sse' || e.transport === 'http' ? e.transport : 'stdio' + upsertServer({ + id: mid, + name: typeof e.name === 'string' && e.name.trim() ? e.name : bundleId, + description: typeof e.description === 'string' ? e.description : '', + transport, + ...(transport === 'stdio' + ? { + command: typeof e.command === 'string' ? e.command : '', + args: Array.isArray(e.args) ? e.args.filter((a): a is string => typeof a === 'string') : [], + env: await conv(mid, e.env) + } + : { + url: typeof e.url === 'string' ? e.url : '', + headers: await conv(mid, e.headers) + }), + enabled: true + }) + setRoles('mcp', mid, [finalPersonaId]) + idMap[bundleId] = mid + } + return idMap +} + +/** + * 导入一个角色包(主进程弹选择框)。同源包再导入 = 就地更新(D3);绝不覆盖非本包来源的同 id 角色。 + * 角色工件经 upsert 原子写、目录先整删再落,失败绝不半写角色本体。 + */ +export async function importPersonaBundle(getWindow: () => BrowserWindow | null): Promise { + const win = getWindow() + const opts = { + properties: ['openFile' as const], + filters: [{ name: '角色包', extensions: ['zip'] }] + } + const picked = win ? await dialog.showOpenDialog(win, opts) : await dialog.showOpenDialog(opts) + if (picked.canceled || !picked.filePaths.length) return { ok: false, error: 'cancelled' } + return importPersonaBundleFrom(picked.filePaths[0]) +} + +/** 从指定路径导入(IPC 与验证脚本共用入口)。 */ +export async function importPersonaBundleFrom(filePath: string): Promise { + const warnings: string[] = [] + try { + const parsed = unzipBundle(filePath) + if ('error' in parsed) return { ok: false, error: parsed.error } + const { files, manifest } = parsed + + const originalId = typeof manifest.originalId === 'string' ? manifest.originalId : '' + const persona = parseBundlePersona(files, originalId || 'imported-persona') + if (!persona) return { ok: false, error: 'bad-persona' } + + const { finalId, updated, keepOriginal } = resolveImportId(originalId, persona.name) + const prov = keepOriginal ? readImportsMap()[finalId] : undefined + + // 角色本体(upsert 原子写;新建默认关、更新不动启用态) + upsertPersona({ id: finalId, ...persona }) + + // 头像 / 知识库 / 随包技能 / 随包 MCP + installAvatar(files, finalId) + const bundleSkillIds = stringIds(manifest.contents?.skills).filter((x) => isSafeId(x)) + const skillMap = bundleSkillIds.length + ? installBundledSkills(files, bundleSkillIds, prov, finalId, warnings) + : {} + const bundleMcpIds = stringIds(manifest.contents?.mcp).filter((x) => isSafeId(x)) + const mcpMap = bundleMcpIds.length + ? await installBundledMcp(files, bundleMcpIds, prov, finalId, warnings) + : {} + if (manifest.contents?.knowledge === true) { + const originalPrefix = `knowledge/${originalId}/` + if (Object.keys(files).some((p) => p.startsWith(originalPrefix))) { + const r = extractDirInto(files, originalPrefix, personaKnowledgeDir(finalId)) + if (!r.ok) warnings.push(`knowledge:${r.error}`) + } + } + + // 簿记(D3 的再次导入判定依据):skills/mcp 合并旧映射——上次导入装过、本次包里没带的从属内容仍在本地,映射继续有效 + const bundleHash = createHash('sha256') + .update(files['persona.md']) + .update(utf8(JSON.stringify(manifest.contents ?? {}))) + .digest('hex') + writeImportsEntry(finalId, { + originalId: keepOriginal ? originalId : finalId, + bundleHash, + skills: { ...(prov?.skills ?? {}), ...skillMap }, + mcp: { ...(prov?.mcp ?? {}), ...mcpMap } + }) + + return { + ok: true, + id: finalId, + name: persona.name, + updated, + idMap: { skills: skillMap, mcp: mcpMap }, + warnings: warnings.length ? warnings : undefined + } + } catch { + return { ok: false, error: 'import-failed' } + } +} + +// ── IPC ────────────────────────────────────────────────────────────────────── + +/** 角色包读写 IPC:导出弹保存框、导入弹选择框(模态,取主窗口)。 */ +export function registerPersonaPortIpc(getWindow: () => BrowserWindow | null): void { + ipcMain.handle('personas:export', (_e, id: string): Promise => + exportPersonaBundle(getWindow, String(id ?? '')) + ) + ipcMain.handle('personas:import', (): Promise => importPersonaBundle(getWindow)) +} diff --git a/apps/desktop/src/main/services/personas.ts b/apps/desktop/src/main/services/personas.ts index 3ee26db2..27822d28 100644 --- a/apps/desktop/src/main/services/personas.ts +++ b/apps/desktop/src/main/services/personas.ts @@ -82,7 +82,8 @@ export interface PersonaUpsertInput { enabled?: boolean } -function personasDir(): string { +/** 角色工件目录(绝对路径)。persona-port.ts(导出/导入角色包)与 IPC 同用,路径唯一出口。 */ +export function personasDir(): string { return join(getDevaHome(), 'personas') } @@ -93,10 +94,18 @@ function personaFile(id: string): string { // ── 自定义头像图片(personas/avatars/.)───────────────────────────── // 落盘细节(一 id 一图、MIME 白名单、大小兜底)见 avatar-image.ts;此处只加 id 合法性守卫。 -function avatarsDir(): string { +export function avatarsDir(): string { return join(personasDir(), 'avatars') } +/** + * 角色知识库目录(issue#65 档 0 约定:`personas/knowledge//`,子目录不干扰角色扫描—— + * 顶层扫描只认 `.md`)。现阶段仅目录约定、无 frontmatter 字段;导出/导入按整目录搬运(persona-port.ts)。 + */ +export function personaKnowledgeDir(id: string): string { + return join(personasDir(), 'knowledge', id) +} + function readAvatarImage(id: string): string { return isSafeId(id) ? readAvatarImageFile(avatarsDir(), id) : '' } @@ -141,17 +150,74 @@ function writeOrderList(order: string[]): void { setConfig({ personas: { ...base, order } }) } +// ── 导入角色包的来源簿记(config.json → personas.imports)────────────────── +// 「同一包再次导入 = 就地更新」的判定依据:本地已存在同 originalId 的角色且簿记在案 → 更新; +// id 冲突但簿记不在案(撞了别的角色)→ 铸随机 id 新建,绝不覆盖。skills/mcp 记「包内 id → 本地 id」 +// 映射,再导入更新时回访原映射,避免同一随包技能/服务每次导入都改名一份。 + +export interface PersonaImportProvenance { + /** 导出方的文件 id(manifest.originalId)。 */ + originalId: string + /** 包内容摘要(persona.md + contents 的 sha256),仅供展示比对,不参与判定。 */ + bundleHash?: string + skills?: Record + mcp?: Record +} + +export function readImportsMap(): Record { + const personas = getConfig().personas + const imports = (personas as { imports?: unknown })?.imports + if (imports && typeof imports === 'object') return imports as Record + return {} +} + +function writeImportsMap(map: Record): void { + const personas = getConfig().personas + const base = personas && typeof personas === 'object' ? (personas as Record) : {} + setConfig({ personas: { ...base, imports: map } }) +} + +/** 记 / 更新一条导入簿记(读-合并写,保住 personas 下其他键——setConfig 顶层浅合并,别清空子对象)。 */ +export function writeImportsEntry(id: string, entry: PersonaImportProvenance): void { + if (!isSafeId(id)) return + const map = readImportsMap() + map[id] = entry + writeImportsMap(map) +} + +function deleteImportsEntry(id: string): void { + const map = readImportsMap() + if (!(id in map)) return + delete map[id] + writeImportsMap(map) +} + /** 校验文件名安全(防 `..` / 分隔符逃逸)。 */ -function isSafeId(id: string): boolean { +export function isSafeId(id: string): boolean { return /^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$/.test(id) && id !== '.' && id !== '..' } +/** 内置(种子)角色 id 集合:不允许导出,导入永不落在这些 id 上(覆盖会毁掉种子文件)。 */ +export function builtinPersonaIds(): Set { + return new Set(DEFAULT_PERSONAS.map((d) => d.id)) +} + +/** 读取角色 .md 磁盘原文(导出角色包用:与用户磁盘上的工件字节一致,含手改过的 frontmatter)。不存在 / 读失败 → null。 */ +export function readPersonaMdRaw(id: string): string | null { + if (!isSafeId(id)) return null + try { + return readFileSync(personaFile(id), 'utf8') + } catch { + return null + } +} + /** * 据显示名生成安全、唯一的文件名 id:slug + 随机后缀,**绝不复用已删角色的 id**。 * 定时任务、对话、IM 回复范围都按 id 引用角色;若只在撞名时加序号,中文名全被 slug 成同一个 `persona`, * 删掉一个角色后新建就会拿回同一个 id,旧引用便悄悄指向了新角色。 */ -function makeId(name: string): string { +export function makeId(name: string): string { const slug = name .trim() .toLowerCase() @@ -359,6 +425,8 @@ export function deletePersona(id: string): void { // 一并从手动排序中剔除,避免留下陈旧 id(listPersonas 会忽略,但保持 config 整洁)。 const order = orderList() if (order.includes(id)) writeOrderList(order.filter((x) => x !== id)) + // 导入簿记随之作废:角色都没了,「再次导入=更新」无处着落(同包再导入会当作新建)。 + deleteImportsEntry(id) } /** diff --git a/apps/desktop/src/preload/index.ts b/apps/desktop/src/preload/index.ts index 10732cfe..b8787a4b 100644 --- a/apps/desktop/src/preload/index.ts +++ b/apps/desktop/src/preload/index.ts @@ -715,6 +715,25 @@ const api = { /** 覆盖手动排序:整表按传入 id 顺序落盘(花名册拖拽 / 置顶)。 */ reorder: (ids: string[]): Promise<{ ok: true }> => ipcRenderer.invoke('personas:reorder', ids), + /** + * 导出角色包(含专属技能 / MCP / 知识库 / 头像):主进程弹保存框,写 zip。 + * 返回与 services/persona-port.ts 的 PersonaExportResult 对齐;cancelled = 用户取消。 + */ + exportBundle: (id: string): Promise<{ ok: boolean; path?: string; error?: string; warnings?: string[] }> => + ipcRenderer.invoke('personas:export', id), + /** + * 导入角色包:主进程弹选择框。同源包再导入 = 就地更新;结果与 services/persona-port.ts 的 + * PersonaImportResult 对齐(idMap = 包内技能/MCP id → 本地落地 id;warnings 为稳定码清单)。 + */ + importBundle: (): Promise<{ + ok: boolean + error?: string + id?: string + name?: string + updated?: boolean + idMap?: { skills: Record; mcp: Record } + warnings?: string[] + }> => ipcRenderer.invoke('personas:import'), /** * 写入自定义头像(data URI,png/jpeg/webp)。返回落盘后读回的 data URI;参数非法 / 写失败返回空串。 * 同一 id 重复上传即覆盖。新建角色须**先 upsert 拿到 id** 再调用。 diff --git a/apps/desktop/src/renderer/src/i18n/messages.ts b/apps/desktop/src/renderer/src/i18n/messages.ts index 291197f0..69e63d7e 100644 --- a/apps/desktop/src/renderer/src/i18n/messages.ts +++ b/apps/desktop/src/renderer/src/i18n/messages.ts @@ -1381,6 +1381,14 @@ const zhCN: MessageTree = { renamePlaceholder: '留空则恢复默认标题', pinTop: '置顶', deletePersona: '删除角色', + exportPersona: '导出角色包', + exportBuiltin: '内置角色不支持导出', + exportFailed: '导出失败', + importPersona: '导入角色包', + importDone: '导入完成', + importCreated: '已导入角色「{name}」,默认停用,可在编辑器里启用', + importUpdated: '已更新角色「{name}」', + importPartial: '已导入角色「{name}」,部分随包技能 / MCP 未能完整带入', deleteChatConfirm: '删除后该对话的所有消息将被永久移除,无法恢复。', // 删主对话时连带删除的东西(成员、绑定的定时任务及它们的对话) deleteChatCascade: '会一并删除:{items}。', @@ -2890,6 +2898,15 @@ const en: MessageTree = { renamePlaceholder: 'Leave empty to restore the default title', pinTop: 'Pin to top', deletePersona: 'Delete persona', + exportPersona: 'Export persona bundle', + exportBuiltin: 'Built-in personas cannot be exported', + exportFailed: 'Export failed', + importPersona: 'Import persona bundle', + importDone: 'Import complete', + importCreated: 'Imported persona "{name}" (disabled by default — enable it in the editor)', + importUpdated: 'Updated persona "{name}"', + importPartial: + 'Imported persona "{name}"; some bundled skills / MCP servers could not be fully installed', deleteChatConfirm: 'This conversation and all its messages will be permanently removed. This cannot be undone.', deleteChatCascade: 'Also removes {items}.', diff --git a/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx b/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx index 46eb297f..1b85f811 100644 --- a/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx +++ b/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx @@ -94,7 +94,7 @@ export function ChatFirstShell(): React.JSX.Element { removeMember, onInsertsReturned } = useChatActions() - const { personas, remove, reorderPersonas } = useExtensions() + const { personas, remove, reorderPersonas, refresh } = useExtensions() const { tasks, setStatus: setTaskStatus, runNow: runTaskNow, update: updateTask, remove: removeTask } = useTasks() const { t, locale } = useI18n() const dialog = useDialog() @@ -588,6 +588,42 @@ export function ChatFirstShell(): React.JSX.Element { remove('persona', id) })() } + // 导出角色包(含专属技能 / MCP / 知识库 / 头像):主进程弹保存框写 zip。成功不打扰(保存框已给落点), + // 失败(内置角色 / 写盘失败等)toast 一条稳定说明。 + const exportPersona = (id: string): void => { + void (async () => { + const res = await window.deva?.personas?.exportBundle(id) + if (!res || res.ok || res.error === 'cancelled') return + toast.show({ + variant: 'error', + title: t('cf.exportFailed'), + message: res.error === 'builtin' ? t('cf.exportBuiltin') : undefined + }) + })() + } + // 导入角色包:主进程弹选择框;同源包再导入 = 就地更新(主进程按簿记判定)。 + // 成功刷新扩展清单(花名册 / 技能 / MCP 随之更新),toast 报结果;铸了新 id 的随包技能/MCP 数量一并提示。 + const importPersona = (): void => { + void (async () => { + const res = await window.deva?.personas?.importBundle() + if (!res) return + if (!res.ok) { + if (res.error && res.error !== 'cancelled') { + toast.show({ variant: 'error', title: t('cf.importFailed'), message: res.error }) + } + return + } + refresh() + toast.show({ + variant: 'success', + title: t('cf.importDone'), + message: fill( + t(res.warnings?.length ? 'cf.importPartial' : res.updated ? 'cf.importUpdated' : 'cf.importCreated'), + { name: clipName(res.name ?? '') } + ) + }) + })() + } return (
setArchived(id, false)} onDeleteThread={deleteThread} onDeletePersona={deletePersona} + onExportPersona={exportPersona} + onImportPersona={importPersona} onReorderPersonas={reorderPersonas} boundTasks={boundTasks} collapsed={collapsed} diff --git a/apps/desktop/src/renderer/src/redesign/Rail.tsx b/apps/desktop/src/renderer/src/redesign/Rail.tsx index d01c5ddb..f5b5beac 100644 --- a/apps/desktop/src/renderer/src/redesign/Rail.tsx +++ b/apps/desktop/src/renderer/src/redesign/Rail.tsx @@ -2,6 +2,12 @@ * 左侧图标栏与对话列表(搜索、筛选、分组、行菜单、新建对话 / 角色)。 */ import { useEffect, useMemo, useRef, useState } from 'react' + +/** + * 内置(种子)角色 id:不可导出(与主进程 services/personas.ts 的 DEFAULT_PERSONAS 对齐)。 + * 删除的菜单禁用只锁 general(DEFAULT_PERSONA_ID,回落兜底身份);导出两者都锁。 + */ +const BUILTIN_PERSONA_IDS = new Set(['general', 'xiaomajiang']) import { AlarmClock, Archive, @@ -10,6 +16,8 @@ import { ArrowUpToLine, ChevronRight, Cog, + Download, + FileUp, Folder, FolderMinus, Globe, @@ -218,6 +226,8 @@ export function Rail({ onUnarchiveThread, onDeleteThread, onDeletePersona, + onExportPersona, + onImportPersona, onReorderPersonas, boundTasks, collapsed, @@ -246,6 +256,10 @@ export function Rail({ onUnarchiveThread: (id: string) => void onDeleteThread: (id: string, title: string) => void onDeletePersona: (id: string, name: string) => void + /** 导出角色包(含专属技能 / MCP / 知识库 / 头像);主进程弹保存框。 */ + onExportPersona: (id: string) => void + /** 导入角色包:主进程弹选择框,成功后刷新扩展清单。 */ + onImportPersona: () => void onReorderPersonas: (ids: string[]) => void /** 绑定在各主对话上的定时任务(主对话行上打闹钟徽标)。 */ boundTasks: TaskRecord[] @@ -590,6 +604,8 @@ export function Rail({ chatLabel={t('cf.addByChat')} onManual={onAddPersona} onByChat={onAddPersonaByChat} + importLabel={t('cf.importPersona')} + onImport={onImportPersona} /> )} @@ -765,6 +781,14 @@ export function Rail({ disabled: personas[0]?.id === menu.id, onClick: () => pinPersona(menu.id) }, + { + label: t('cf.exportPersona'), + icon: , + // 内置角色不导出:应用自带,且避免扩大其提示词的分发面(主进程同样硬拒,UI 先拦一道)。 + disabled: BUILTIN_PERSONA_IDS.has(menu.id), + title: BUILTIN_PERSONA_IDS.has(menu.id) ? t('cf.exportBuiltin') : undefined, + onClick: () => onExportPersona(menu.id) + }, { label: t('cf.deletePersona'), icon: , @@ -909,7 +933,9 @@ export function AddMenu({ manualLabel, chatLabel, onManual, - onByChat + onByChat, + importLabel, + onImport }: { /** 手动项文案,同时作 + 按钮的 title / aria-label(如「添加角色」「添加任务」)。 */ manualLabel: string @@ -917,6 +943,9 @@ export function AddMenu({ chatLabel: string onManual: () => void onByChat: () => void + /** 可选第三项「导入」文案(角色花名册用:导入角色包);不给则不出现该项。 */ + importLabel?: string + onImport?: () => void }): React.JSX.Element { const { open, hoverProps, show, choose } = useHoverMenu() @@ -942,6 +971,12 @@ export function AddMenu({ {chatLabel} + {onImport && importLabel && ( + + )}
)} From 3db525ac904384b7987a6482d6555c8d6882ae7c Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:07:11 +0900 Subject: [PATCH 2/9] =?UTF-8?q?fix(personas):=20=E5=88=A0=E9=99=A4?= =?UTF-8?q?=E8=A7=92=E8=89=B2=E6=97=B6=E4=B8=80=E5=B9=B6=E6=B8=85=E7=90=86?= =?UTF-8?q?=E7=9F=A5=E8=AF=86=E5=BA=93=E7=9B=AE=E5=BD=95=20/=20remove=20th?= =?UTF-8?q?e=20persona=20knowledge=20directory=20in=20the=20delete=20casca?= =?UTF-8?q?de?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 知识库目录(档 0 约定、角色包导入会创建)此前删除角色时不清理,会留孤儿目录;与头像同等待遇一并删 / the knowledge directory (doc-0 convention, created by bundle imports) survived persona deletion as an orphan; it is now removed alongside the avatar --- apps/desktop/src/main/services/personas.ts | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/apps/desktop/src/main/services/personas.ts b/apps/desktop/src/main/services/personas.ts index 27822d28..5004146e 100644 --- a/apps/desktop/src/main/services/personas.ts +++ b/apps/desktop/src/main/services/personas.ts @@ -413,6 +413,12 @@ export function deletePersona(id: string): void { } // 连自定义头像一起删:不留孤儿文件(旧版 makeId 会复用已删角色的 id,遗留的图曾挂到新角色脸上)。 clearAvatarImage(id) + // 知识库目录(issue#65 档 0 约定、角色包导入会创建)一并删:与头像同等待遇,不留孤儿目录。 + try { + rmSync(personaKnowledgeDir(id), { recursive: true, force: true }) + } catch { + /* 忽略删除失败 */ + } // 绑定该角色的定时任务改由默认角色 Deva 执行(连同其独占对话),任务照常运行。 reassignTaskPersona(id, DEFAULT_PERSONA_ID) // 从技能 / MCP 的可用角色里剔除;只给它用的那些改回所有角色并停用。 From 8844595ceceb93d3916e5022a7d97484ad6ebfac Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:13:43 +0900 Subject: [PATCH 3/9] =?UTF-8?q?fix(personas):=20=E8=A7=92=E8=89=B2?= =?UTF-8?q?=E5=8C=85=E5=AF=BC=E5=85=A5=E5=8E=9F=E6=A0=B7=E4=BF=9D=E7=9C=9F?= =?UTF-8?q?=E5=AD=97=E8=8A=82=E5=B9=B6=E8=B7=B3=E8=BF=87=E7=AC=A6=E5=8F=B7?= =?UTF-8?q?=E9=93=BE=E6=8E=A5=20/=20import=20persona=20bundles=20byte-fait?= =?UTF-8?q?hfully=20and=20skip=20symlinks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 导入不再经 frontmatter 重组写盘:包内 persona.md 原样落盘,手改键与未来字段(knowledge/workspace)不在往返中丢失;启用态语义不变(新建默认关、更新不动)/ imports now write the bundled persona.md bytes verbatim instead of recomposing frontmatter, so hand-edited keys and future fields (knowledge/workspace) survive round-trips; enable semantics unchanged - 目录收集改用 lstat 并跳过符号链接:防链接环无限递归与越界拉取(对齐检查点模块的同类取法)/ directory collection uses lstat and skips symlinks, preventing loop recursion and out-of-tree pulls (same approach as checkpoints) - 真实数据 dry-run(办公室运维助手 persona-3585c7d1)验证:回环与更新路径字节级一致,额外键保留 / verified against the real 办公室运维助手 persona: round-trip and update are byte-identical, extra keys preserved --- .../desktop/src/main/services/persona-port.ts | 19 +++++++++++++------ apps/desktop/src/main/services/personas.ts | 16 ++++++++++++++++ 2 files changed, 29 insertions(+), 6 deletions(-) diff --git a/apps/desktop/src/main/services/persona-port.ts b/apps/desktop/src/main/services/persona-port.ts index ea6166a7..18ba9cb2 100644 --- a/apps/desktop/src/main/services/persona-port.ts +++ b/apps/desktop/src/main/services/persona-port.ts @@ -1,6 +1,6 @@ import { app, dialog, ipcMain, type BrowserWindow } from 'electron' import { createHash } from 'crypto' -import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'fs' +import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'fs' import { isAbsolute, join, resolve, sep } from 'path' import { unzipSync, zipSync, type Unzipped } from 'fflate' import { writeFileAtomic } from './atomic-write' @@ -14,8 +14,9 @@ import { personasDir, readImportsMap, readPersonaMdRaw, - upsertPersona, + setPersonaEnabled, writeImportsEntry, + writePersonaMdRaw, type PersonaImportProvenance } from './personas' import { clearAvatarImage, readAvatarImage, writeAvatarImage } from './avatar-image' @@ -145,10 +146,12 @@ function collectDirInto( const rel = `${relBase}${name}` let st try { - st = statSync(abs) + // lstat:符号链接一律跳过——链接到目录会带来环递归与越界拉取(对齐检查点模块的同类安全取法)。 + st = lstatSync(abs) } catch { continue } + if (st.isSymbolicLink()) continue if (st.isDirectory()) { if (!collectDirInto(abs, `${rel}/`, out, state)) return false continue @@ -369,7 +372,7 @@ function unzipBundle(filePath: string): { files: Unzipped; manifest: BundleManif return { files, manifest } } -/** 包内 persona.md → upsertPersona 入参(frontmatter 四键 + 正文)。 */ +/** 包内 persona.md 的校验解析(name 提取供铸 id;写盘走 writePersonaMdRaw 原样字节)。 */ function parseBundlePersona( files: Unzipped, fallbackName: string @@ -565,8 +568,12 @@ export async function importPersonaBundleFrom(filePath: string): Promise Date: Thu, 19 Nov 2026 12:03:25 +0900 Subject: [PATCH 4/9] =?UTF-8?q?docs(plans):=20=E8=A7=92=E8=89=B2=E5=8C=85?= =?UTF-8?q?=E5=AF=BC=E5=87=BA=E5=AF=BC=E5=85=A5=E7=9A=84=E6=96=B9=E6=A1=88?= =?UTF-8?q?=E6=A0=91=E4=B8=8E=E8=90=BD=E5=9C=B0=E7=8A=B6=E6=80=81=20/=20ad?= =?UTF-8?q?d=20plan=20tree=20for=20persona=20bundle=20export=20and=20impor?= =?UTF-8?q?t?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 引导 docs/plantree(README、baseline 模块键、ideas);P001 记录全角落清单、六项决策、v2 设计与验证证据 / bootstrap docs/plantree (README, baseline module keys, ideas); P001 records the persona-surface inventory, six decisions, v2 design and verification evidence --- docs/plantree/README.md | 24 ++++++ docs/plantree/baseline/README.md | 29 +++++++ docs/plantree/ideas/inbox.md | 3 + .../plans/001-persona-export-import/README.md | 22 ++++++ .../decisions/001-bundle-basics.md | 34 +++++++++ .../decisions/002-bundle-scope.md | 25 ++++++ .../open-questions.md | 9 +++ .../001-persona-export-import/roadmap.md | 26 +++++++ .../topics/export-import-design.md | 76 +++++++++++++++++++ .../topics/persona-surface.md | 69 +++++++++++++++++ 10 files changed, 317 insertions(+) create mode 100644 docs/plantree/README.md create mode 100644 docs/plantree/baseline/README.md create mode 100644 docs/plantree/ideas/inbox.md create mode 100644 docs/plantree/plans/001-persona-export-import/README.md create mode 100644 docs/plantree/plans/001-persona-export-import/decisions/001-bundle-basics.md create mode 100644 docs/plantree/plans/001-persona-export-import/decisions/002-bundle-scope.md create mode 100644 docs/plantree/plans/001-persona-export-import/open-questions.md create mode 100644 docs/plantree/plans/001-persona-export-import/roadmap.md create mode 100644 docs/plantree/plans/001-persona-export-import/topics/export-import-design.md create mode 100644 docs/plantree/plans/001-persona-export-import/topics/persona-surface.md diff --git a/docs/plantree/README.md b/docs/plantree/README.md new file mode 100644 index 00000000..1392ea5b --- /dev/null +++ b/docs/plantree/README.md @@ -0,0 +1,24 @@ +# Plan Tree + +Deva 的规划状态根。架构与长效知识(模块契约、不变量、失效语义)的权威在 `llmdoc/`(用 `npx -y @tokenroll/llmdoc search/tree` 检索);本目录只管**规划状态**:路线图、进行中的方案、决策、未决问题、落地证据。 + +## 权威顺序 + +1. 代码事实 → 源码 +2. 架构/契约知识 → `llmdoc/` +3. 规划/进行中工作 → 本目录(各 Plan root 自治) +4. 历史/归档 → 各 Plan 的 `history/` + +## Baseline + +`baseline/README.md` — 模块键映射(Plan 的 Affected Modules 用)与 llmdoc 检索入口。runtime/storage/测试发布门等全局上下文不在此复制,直接链到 llmdoc 对应文档。 + +## 活跃 Plans + +| ID | Plan | Affected Modules | Status | Current Phase | Last Landed | Next Target | +|---|---|---|---|---|---|---| +| P001 | [角色导出/导入](plans/001-persona-export-import/) | main-personas, main-ext-roles, main-avatar-image, preload-ipc, renderer-shell | Implemented | 代码落地+冒烟全绿(未提交) | 2026-11-19 typecheck/build/冒烟4案 | GUI 手工回环 → /llmdoc:update → 提交 | + +## 读取路径 + +新会话接手:读本 README → 目标 Plan 的 `README.md` → `roadmap.md` → 标注的 topic/decisions/open-questions。 diff --git a/docs/plantree/baseline/README.md b/docs/plantree/baseline/README.md new file mode 100644 index 00000000..4903200a --- /dev/null +++ b/docs/plantree/baseline/README.md @@ -0,0 +1,29 @@ +# Baseline + +全局上下文的检索枢纽。**架构权威在 llmdoc/**,这里只放 Plan 元数据需要的模块键与指路。 + +## 模块键(Plan 的 Affected Modules 用) + +| 键 | 内容 | llmdoc owner | +|---|---|---| +| main-personas | apps/desktop/src/main/services/personas.ts(存储/种子/删除级联) | capabilities/skills-personas.mdx | +| main-ext-roles | services/ext-roles.ts(技能/MCP 角色作用域) | capabilities/skills-personas.mdx | +| main-avatar-image | services/avatar-image.ts(头像落盘,角色与用户共用) | (可重建面) | +| main-skills | services/skills.ts(技能,zip 导入先例) | capabilities/skills-personas.mdx | +| main-tasks | services/tasks.ts / tasks-types.ts(定时任务绑定 personaId) | capabilities/scheduler.mdx | +| main-remote-hub | services/remote/hub.ts(手机名片建角色) | remote/remote.mdx | +| main-config | services/config.ts(config.json 各 personas.* 键) | security/security.mdx(secrets 部分) | +| preload-ipc | src/preload/index.ts(personas:* 桥) | protocol-ui/protocol.mdx | +| renderer-shell | redesign/Rail.tsx / BotsPane.tsx 等(花名册 UI) | protocol-ui/protocol.mdx | +| shared-protocol | shared/remote-web.ts(WebPersona 手机视图) | remote/remote.mdx | +| mobile-web | src/mobile/(手机端角色列表/抽屉) | remote/remote.mdx | + +## 检索 + +- 冷启动:`npx -y @tokenroll/llmdoc tree` +- 概念:`npx -y @tokenroll/llmdoc search "<词>"` +- 文件→文档:`npx -y @tokenroll/llmdoc context --files ` + +## 已知进行中分支(不在 main) + +- `origin/feature/workspace`:角色默认工作区(PR#49,按 id 存放 home folder + mount_workspace 工具)。**main 尚无此面**;涉及角色的方案要预留其落地的兼容位。 diff --git a/docs/plantree/ideas/inbox.md b/docs/plantree/ideas/inbox.md new file mode 100644 index 00000000..eab90443 --- /dev/null +++ b/docs/plantree/ideas/inbox.md @@ -0,0 +1,3 @@ +# Ideas Inbox + +- (2026-11-19,源自 P001 研究)「能力包」概念:角色 + 专属技能/MCP + ext-roles 打包迁移——ext-roles 已是按角色 id 反查的现成映射,真要做时数据结构是现成的;难在技能目录/ MCP 进程配置的迁移语义。→ 若 P001 落地后用户有需求再 promote。 diff --git a/docs/plantree/plans/001-persona-export-import/README.md b/docs/plantree/plans/001-persona-export-import/README.md new file mode 100644 index 00000000..5dd768f8 --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/README.md @@ -0,0 +1,22 @@ +# P001 · 角色导出/导入 + +## 范围 + +把单条角色(persona)相关内容打包导出为可迁移文件,并在另一台机器/另一个 DEVA_HOME 导入。**桌面端功能**;手机端只经既有 `WebPersona` 视图看到导入结果,不做导入入口。 + +非目标(v1):批量导出全部角色、角色「专属技能/MCP」连带打包(ext-roles 的 id 跨机不移植)、定时任务/对话绑定迁移、导入时更新已存在的角色。 + +## 受影响模块 + +main-personas(核心)、main-avatar-image、preload-ipc(新增 IPC)、renderer-shell(Rail 右键菜单 + BotsPane 入口)、main-skills(zip 导入先例参照)。详见 [topics/persona-surface.md](topics/persona-surface.md)。 + +## 文件地图 + +- [roadmap.md](roadmap.md) — 阶段状态 +- [topics/persona-surface.md](topics/persona-surface.md) — 角色全角落清单(研究主体,含硬编码目录) +- [topics/export-import-design.md](topics/export-import-design.md) — 包格式与导入语义设计 +- [open-questions.md](open-questions.md) — 待用户定夺的 6 个问题 + +## 状态 + +Ready(设计定稿 2026-11-19)。六问已批复成决策(decisions/001、002);v2 能力包设计见 topics/export-import-design.md。实现待用户放行;「从属角色」按「从属内容」判读,若用户纠正则 decisions/002 作废重议。 diff --git a/docs/plantree/plans/001-persona-export-import/decisions/001-bundle-basics.md b/docs/plantree/plans/001-persona-export-import/decisions/001-bundle-basics.md new file mode 100644 index 00000000..9fa3b85e --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/decisions/001-bundle-basics.md @@ -0,0 +1,34 @@ +# Decision · 打包基础五项(Q1/Q2/Q3/Q5/Q6) + +日期 2026-11-19。用户逐条批复,Q5 授权由我决策。 + +## D1 · id 策略(Q1) + +**无冲突保留原 id,冲突时铸随机 id。** +- 导入时 `originalId` 通过 `isSafeId` 且本地不存在 `.md` → 沿用原 id(两台机器导入后 id 一致,任务/IM 绑定语义在包消费者侧可控)。 +- 本地已存在同 id 且**并非**同一包的再次导入 → `makeId` 铸新 id,绝不覆盖(代码既有铁律:id 复用会让任务/对话/IM 范围的旧引用悄悄指向新角色)。 +- 「同一包的再次导入」判定走 D3 的来源簿记。 + +## D2 · 内置角色(Q2) + +**内置 `general` / `xiaomajiang` 不允许导出;导入永不落在内置 id 上。** 主进程本无防覆盖硬闸(`upsertPersona` 显式传 id 会覆盖种子文件、`RESERVED_IDS` 只在 skills.ts),此闸由本功能显式实现。 + +## D3 · 重复导入 = 更新(Q3) + +**同一包再次导入走就地更新,不产生重复角色。** +- 来源簿记:`config.json → personas.imports[localId] = { originalId, bundleHash }`(bundleHash = 包内容规范哈希;启用态/order 仍不入簿记)。 +- 导入判定序:本地已有 `originalId` 且其 `imports[localId].originalId` 匹配 → **更新**(persona.md / 头像 / 随包内容覆盖为包内版本);id 冲突但簿记不匹配(撞了别的角色)→ 铸随机 id 新建;id 空闲 → 沿用原 id 新建并记簿记。 +- 更新语义:包是这一内容的真源,覆盖即更新;用户本地对随包技能/MCP 的后续改动会被包内版本覆盖(v1 接受,UI 提示「将更新已导入的角色」)。 + +## D4 · UI 入口(Q5,用户授权决策) + +**导出 = Rail 花名册角色右键菜单「导出…」(与置顶/删除并列,内置角色该项灰显);导入 = BotsPane 花名册管理区入口(与「新建角色」并列)。** i18n 中英文案同步。 + +## D5 · 来源信息(Q6) + +**只写进包内 `manifest.json`**(originalId / exportedAt / appVersion / format),`persona.md` 保持现有工件格式字节同构,frontmatter 不加新键(防污染用户可直接编辑的工件;也为 PR#49 的 `workspace`、issue#65 的 `knowledge` 字段预留干净的 frontmatter 空间)。 + +## 关联 + +- 冲突判定与 D3 簿记互为前提,实现时同一模块(persona-port.ts)内聚。 +- Q4(打包范围:技能/MCP/文档/知识库/从属角色)另行细化,见 open-questions。 diff --git a/docs/plantree/plans/001-persona-export-import/decisions/002-bundle-scope.md b/docs/plantree/plans/001-persona-export-import/decisions/002-bundle-scope.md new file mode 100644 index 00000000..3e385b29 --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/decisions/002-bundle-scope.md @@ -0,0 +1,25 @@ +# Decision · 打包范围(Q4) + +日期 2026-11-19。用户批复:「技能/mcp/文档/知识库/从属角色所有文件都要打包」。 + +## 判读(假设,允许用户纠正) + +原句最自然断句为「从属**于**角色**的**所有文件」——所列类别即角色的从属内容,**不需要角色层级机制**。据此: + +- **技能**:`skills.roles[skillId]` 含该角色的技能(专属),整目录打包(SKILL.md + 参考文档/脚本——「文档」若指技能附带文档,已天然覆盖)。 +- **MCP**:`mcp.roles[mcpId]` 含该角色的 MCP,配置 + **解密后的秘密值**一并进包(用户明示「所有文件都要打包」;包内秘密为明文属固有风险,导入侧重加密回 secrets.json,UI 提示一次性)。角色共享(roles 含多个角色)的技能/MCP 同样进包——它是该角色能力的一部分;导入后 ext-roles 置为仅新角色。 +- **知识库**:`~/.deva/personas/knowledge//` 整目录打包(issue#65 档 0 约定,用户自用形态)。 +- **文档**:无独立实体;知识库目录与技能目录里的文档随整目录打包,不单列机制。 +- **从属角色**:按「从属内容」判读,不建角色层级/引用探测机制。若用户实意是「打包其他角色」(递归子角色),此决策作废重议——已在 open-questions 留纠正窗口。 + +## 导入侧联动 + +- 技能/MCP 落地后 `setRoles(…, [新角色id])`;技能 id / MCP id 与本地冲突 → 加后缀铸新 id(沿用各自模块的 id 生成规则),并记录「包内 id → 本地 id」映射于导入结果摘要。 +- 随包 MCP 导入后置 enabled=true(导出方在用的能力,开箱即用;MCP 默认关的原则对「用户显式导入」让步——导入动作本身即显式意图)。 +- 知识库目录随 id 走:保留原 id 时目录名不变;铸新 id 时目录改名到新 id。 + +## 明确不打包 + +- 角色默认工作区内容(PR#49 未落地且多为项目代码); +- ext-roles 的原始多角色分配(无法跨机保真,导入一律置为仅新角色); +- 定时任务 / 对话绑定 / IM 回复范围(机器本地引用)。 diff --git a/docs/plantree/plans/001-persona-export-import/open-questions.md b/docs/plantree/plans/001-persona-export-import/open-questions.md new file mode 100644 index 00000000..a8076ecf --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/open-questions.md @@ -0,0 +1,9 @@ +# Open Questions · P001 + +原 Q1–Q6 已全部批复:Q1/Q2/Q3/Q5/Q6 → [decisions/001-bundle-basics.md](decisions/001-bundle-basics.md);Q4 → [decisions/002-bundle-scope.md](decisions/002-bundle-scope.md)。 + +## 留观项(非阻塞) + +1. **Q4 判读纠正窗口**:「从属角色」按「从属于角色的内容」判读(无角色层级机制)。若实意是「打包其他角色/递归子角色」,推翻 [decisions/002-bundle-scope.md](decisions/002-bundle-scope.md) 重议。 +2. **知识库字段化联动**:issue#65 的 frontmatter `knowledge` 字段落地后,包格式需同步(manifest 声明 knowledge 目录 ↔ 字段指向),届时随 /llmdoc:update 一起核对。 +3. **PR#49 落地联动**:角色默认工作区(`workspace` frontmatter 字段)落地后评估是否在包内记录(机器本地路径大概率仍不打包,只提示失效)。 diff --git a/docs/plantree/plans/001-persona-export-import/roadmap.md b/docs/plantree/plans/001-persona-export-import/roadmap.md new file mode 100644 index 00000000..8566ce43 --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/roadmap.md @@ -0,0 +1,26 @@ +# Roadmap · P001 + +## Done + +- 全角落排查(2026-11-19)→ [topics/persona-surface.md](topics/persona-surface.md) +- 六问批复落决策(2026-11-19)→ [decisions/001-bundle-basics.md](decisions/001-bundle-basics.md)、[decisions/002-bundle-scope.md](decisions/002-bundle-scope.md) +- v2 能力包设计定稿(2026-11-19)→ [topics/export-import-design.md](topics/export-import-design.md) +- 实现(2026-11-19,local-dev 未提交):persona-port.ts 新模块;personas.ts 导出 dir 助手/imports 簿记/删除级联;atomic-write 扩二进制重载;index.ts 注册;preload 桥;Rail 导出菜单 + AddMenu 导入项 + ChatFirstShell 接线 + i18n 中英文案 +- 验证(2026-11-19):`pnpm typecheck` 双侧通过;`pnpm build` 通过;electron 桩进程内冒烟 4 案全绿(导出含内置拒绝 / 全新机回环+同包更新 / 冲突铸新 id 不动外来者 / originalId=general 硬闸 + 坏 manifest 拒绝)——harness 在 /tmp/pp-smoke/(会话外即逝,复制回仓库再跑可复现) + +## In Progress + +(无) + +## Next + +- 用户 GUI 手工过一遍:真机导出 → 换 DEVA_HOME 导入 → 手机端可见 +- `/llmdoc:update`:capabilities/skills-personas.mdx 补导出/导入契约(personas.ts 锚点已变脏) +- 提交(双语提交规范,type/refactor 之外应为 feat);是否推送上游由用户定 + +## Deferred + +- 批量导出(整份花名册) +- 「从属角色」若被纠正为递归子角色 → 重议(decisions/002 留有作废条款) +- issue#65 knowledge 字段落地后的包格式联动(open-questions 留观项 2) +- PR#49 工作区落地后的包内记录评估(留观项 3) diff --git a/docs/plantree/plans/001-persona-export-import/topics/export-import-design.md b/docs/plantree/plans/001-persona-export-import/topics/export-import-design.md new file mode 100644 index 00000000..bc711f2f --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/topics/export-import-design.md @@ -0,0 +1,76 @@ +# Topic · 导出/导入设计(v2 能力包,已定稿) + +依据:[decisions/001-bundle-basics.md](../decisions/001-bundle-basics.md)(D1–D5)+ [decisions/002-bundle-scope.md](../decisions/002-bundle-scope.md)(Q4 判读)。实现前若这两份决策被推翻,先改决策再改本文。 + +## 包格式(deva-persona-bundle,format 1) + +``` +.devapersona.zip +├─ manifest.json +├─ persona.md ← ~/.deva/personas/.md 磁盘原文(字节同构) +├─ avatar.webp|png|jpg ← 可选;有自定义头像才打进来 +├─ knowledge//… ← 可选;知识库整目录(issue#65 档 0 约定) +├─ skills//… ← 专属技能整目录(SKILL.md + 参考文档/脚本) +└─ mcp.json ← 专属 MCP 条目 + 解密后秘密值(见下) +``` + +manifest.json: + +```json +{ + "kind": "deva-persona-bundle", + "format": 1, + "exportedAt": "2026-11-19T…", + "appVersion": "0.1.16", + "originalId": "<导出方文件 id>", + "contents": { "skills": ["…"], "mcp": ["…"], "knowledge": true|false } +} +``` + +- persona.md **保持现有工件格式不变**,frontmatter 不加键(D5)。 +- mcp.json 为包内私有形态(非 `~/.deva/mcp.json` 原样拷贝):每条目含原配置字段,`{secretRef}` 占位替换为解密明文值(`secrets.json → mcp::` 经 getSecret 解出)。**明文秘密进包是用户明示接受的风险**;导入后立即重加密进本机 secrets.json,包内不落残留。 +- zip 用 fflate `zipSync`(已有依赖);限额:总量 30MB / 单文件 10MB / 文件数 500(技能目录可能带多文件;头像硬上限 2MB 已在 avatar-image.ts)。 + +## 导出流程(persona-port.ts) + +1. 入口 `personas:export(id)`:`getPersona(id)`;**内置 id(general/xiaomajiang)直接拒绝**(D2)。 +2. 收集从属内容(002 决策): + - 技能:遍历 `listSkills()`,`getRoles('skills', skillId)` 含该 id 者 → 整目录 `cpSync` 进包; + - MCP:`getRoles('mcp', mcpId)` 含该 id 者 → 配置条目 + 逐字段解密秘密 → 包内 mcp.json; + - 知识库:`existsSync(knowledge//)` → 整目录进包; + - 头像:`readAvatarImage(avatarsDir(), id)` → 还原字节与扩展名。 +3. 组 manifest → `dialog.showSaveDialog`(默认文件名 `.devapersona.zip`)→ 写盘。 +4. 只读操作全程;导出不改任何本地状态。 + +## 导入流程(persona-port.ts) + +1. `personas:import(paths)`:解包校验 kind/format、zip-slip 段守卫、限额;manifest.contents 声明哪些从属内容在包里。 +2. **id 判定序(D1+D3)**: + - `.md` 不存在且 isSafeId 通过 → **沿用原 id 新建**,记簿记; + - 存在且 `config.json → personas.imports[该id].originalId === originalId`(或该 id 本身相等即视为同源)→ **就地更新**,UI 先提示「将更新已导入的角色」; + - 存在但簿记不匹配(撞了别的角色)→ `makeId(name)` 铸新 id 新建,记簿记; + - originalId 不过 isSafeId(外来/手改包)→ 直接铸新 id。 + - 内置 id 永远走铸新 id 分支(D2 兜底,即便簿记异常也不可能落到 general/xiaomajiang)。 +3. 落盘顺序:`upsertPersona`(默认关,D5 不动 enabled)→ 头像 `writeAvatarImage(新id)` → 知识库目录落 `knowledge/<最终id>/`(铸了新 id 则整目录改名)。 +4. 随包技能:整目录落 `~/.deva/skills/`;id 冲突 → 按技能模块的 id 规则铸新目录名;`setRoles('skills', 最终skillId, [最终角色id])`(导入后仅该角色可用,不保留原多角色分配)。 +5. 随包 MCP:条目合并进 `~/.deva/mcp.json`;秘密字段明文 → 走既有 setSecret 重加密进 secrets.json;id 冲突 → 铸新 id;`setRoles('mcp', …, [最终角色id])`;**enabled=true**(002 决策:导入即显式意图)。 +6. 结果摘要回渲染层:`{ persona, idMap: {skills, mcp}, updated: bool, warnings[] }`(秘密明文绝不进摘要与日志)。 +7. 簿记:`setConfig({ personas: { imports: { [finalId]: { originalId, bundleHash } } } })`,读-合并式写入(config 顶层浅合并,别清空既有子对象——R3 教训在 personas.ts 种子逻辑有先例)。 + +## 实现落位(AGENTS.md 约定) + +- **新模块** `apps/desktop/src/main/services/persona-port.ts`(personas.ts 已 515 行,端口逻辑约 300+ 行会破 800 红线)。personas.ts 需把私有 `personasDir()/avatarsDir()` 改导出——这是硬编码目录的**收拢**(全仓库只此一处拼路径),不是新增字面量。 +- skills.ts 的导入限额/zip-slip 守卫函数若可复用则抽到共享位置(同是 `~/.deva` 下的 zip 入口,两处维护一份);复用不动技能行为。 +- IPC:`personas:export(id)`、`personas:import(paths)` 注册进 personas.ts `registerPersonasIpc` 或 persona-port 自己注册;preload `personas` 桥补两个方法。 +- UI:Rail 右键菜单「导出…」(内置灰显)+ BotsPane「导入…」(D4);i18n 中英文案。 +- 知识库目录名 `` 在 personas/knowledge/ 下——与角色扫描互不干扰(目录扫描只认顶层 *.md,已有约定)。 + +## 验证路径 + +1. `pnpm typecheck` +2. **回环**:造带专属技能(多文件)+ 专属 MCP(带 secret)+ 知识库的角色 → 导出 → 删除 → 导入 → id 不变(簿记删了?注意:删除角色时应同步删 imports 簿记,纳入 deletePersona 级联)→ 全部内容一致、MCP 可连接、技能仅该角色可见、手机端可见。 +3. **跨机模拟**:`DEVA_HOME=<新临时目录>` 启动 → 导入 → 原 id 新建、秘密重加密、ext-roles 指向新角色。 +4. **更新路径**:同包改 persona.md 再导出 → 再导入 → 提示更新 → 内容覆盖、无重复角色。 +5. **冲突路径**:先手建同 id 假角色 → 导入 → 铸新 id,假角色不动。 +6. **坏包**:截断 zip / 假 manifest / zip-slip / 超限 → 结构化报错,无半写。 +7. 内置角色:导出被拒;手改包内 originalId=general → 导入铸新 id,种子文件原样。 diff --git a/docs/plantree/plans/001-persona-export-import/topics/persona-surface.md b/docs/plantree/plans/001-persona-export-import/topics/persona-surface.md new file mode 100644 index 00000000..c0b86a81 --- /dev/null +++ b/docs/plantree/plans/001-persona-export-import/topics/persona-surface.md @@ -0,0 +1,69 @@ +# Topic · 角色全角落清单(研究底稿) + +证据日期 2026-11-19,分支 local-dev @ d69b2a2。逐文件核实,非推测。 + +## 1. 存储面(main-personas / personas.ts,515 行) + +| 内容 | 位置 | 导出/导入相关性 | +|---|---|---| +| 角色工件 | `~/.deva/personas/.md`(`personasDir()`,模块私有) | **包主体**:frontmatter(name/description/avatar/model)+ 正文 prompt | +| 自定义头像图 | `~/.deva/personas/avatars/.{webp,png,jpg}`(`avatarsDir()`,私有;ext 白名单 `AVATAR_EXT_MIME`) | **包内第二个文件**;不入 frontmatter(真源是磁盘存在性),一 id 至多一张,写入先清全部变体 | +| 启用态 | `config.json → personas.enabled[id]`,默认关 | **不导出**(机器本地偏好);导入后默认关 | +| 手动排序 | `config.json → personas.order[]` | 不导出 | +| 种子簿记 | `config.json → personas.seeded[id]` / `seededPrompt[id]`(+ 历史键 `seededGeneral`) | **绝不导出/导入**:内置种子协议专用 | +| 前缀头 avatar spec | frontmatter `avatar` = Humation AvatarSpec JSON 字符串(`fmScalar` 引号化落盘) | 随 md 原样迁移 | +| 偏好模型 | frontmatter `model` = `"providerId:modelId"`,空 = 跟随默认 | 原样迁移;导入机无此模型时 `resolveModelRef` 永不抛错、优雅回退,**无需校验** | + +关键函数:`isSafeId`(`/^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$/`)、`makeId`(slug≤40 + 8hex 随机后缀,**永不复用已删 id**——任务/对话/IM 范围按 id 引用)、`resolvePersonaId`(失效回落 `'general'`)、`upsertPersona`(显式传 id 会**覆盖**已存在文件——导入的覆盖风险点)、`parsePersona`/`composePersonaMd`、`deletePersona` 级联(文件+头像+任务重指+ext-roles prune+enabled+order)。 + +**内置角色无主进程防删/防覆盖硬闸**:删除禁止只活在 UI(Rail/BotsPane 对 `DEFAULT_PERSONA_ID='general'` 禁用菜单);`upsertPersona({id:'general',…})` 会直接覆盖种子文件。`RESERVED_IDS` 只存在于 skills.ts。→ **导入必须自设内置 id 硬闸**(general/xiaomajiang)。 + +## 2. 种子协议(default-personas.ts) + +`DEFAULT_PERSONAS = [DEVA(general), XIAOMAJIANG(xiaomajiang)]`;`LEGACY_PROMPT_HASHES`(v0.1.2–v0.1.9 历史哈希)。`ensureSeededPersonas` 按 `seeded[id]` 防复活、按 `seededPrompt[id]` 基线做「提示词跟随新版」。**内置角色是代码常量、不在导出范围内**(Q2)。 + +## 3. 头像落盘(main-avatar-image / avatar-image.ts) + +`readAvatarImage/clearAvatarImage/writeAvatarImage(dir, id)`;MIME 白名单 webp/png/jpg、解码后 ≤2MB、data URI 进出(渲染层 CSP 禁 `file:`)。**与用户头像 `profile/avatar.` 共用模块但不同目录**——角色包只涉及 `personas/avatars/`,勿混入 profile。 + +## 4. IPC 面(preload-ipc) + +`personas:list/get/upsert/remove/set-enabled/reorder/set-avatar-image/clear-avatar-image`(personas.ts `registerPersonasIpc`)。**无 personas:changed 广播**——渲染层自拉自刷;手机端经 `web/adapter.ts` 的 `conn.send({t:'personas', …})` 推送。新增导出/导入 IPC 照此模式,导入成功后渲染层重拉即可,手机端下次拉取/连接时自然可见。 + +## 5. 引用面(谁按 id 指着角色) + +| 引用方 | 位置 | 迁移含义 | +|---|---|---| +| 对话绑定 | 会话属性 `personaId`(resolvePersonaId 读取时回退) | 机器本地,不迁移 | +| 定时任务 | `tasks-types.ts auth.personaId`;删角色时 `reassignTaskPersona(id→general)` | 不迁移 | +| IM 回复范围 | `remote/store.ts ReplyScope.personas[]`(mode='personas') | 不迁移 | +| 手机视图 | `shared/remote-web.ts WebPersona`(id/name/description/model/avatar/avatarImage/enabled) | 导入后自动出现,无需改动 | +| 手机建角色 | `remote/hub.ts:1345`(名片 accept → `upsertPersona`,**enabled:true**,形状按名 seededShape 定死) | 证明:非桌面的 upsert 已有先例;导入流程可参照(upsert → 落图) | +| ext-roles | `config.json → skills.roles[id] / mcp.roles[id]`(缺席=全部角色;指定角色全删→回退全体并**停用**) | **不导出**(Q4):导入机没有同 id 技能/MCP,带上只会制造悬挂引用 | +| 技能清单过滤 | chat.ts 按 `allowsPersona('skills'/'mcp', id, personaId)` 过滤 | 同上 | + +## 6. UI 面(renderer-shell) + +- `Rail.tsx`:花名册 tab + 角色右键菜单(置顶/删除,general 禁删)→ **导出菜单项的落点** +- `BotsPane.tsx`:花名册管理 + PersonaEditor(新建/编辑,头像 AvatarEditor)→ **导入入口候选** +- `SettingsPane.tsx`:技能导入所在(`skills:import` 先例:dialog 在主进程弹) +- 提示:菜单/编辑器文案在 `i18n/messages.ts`(中英双语都要加) + +## 7. zip 导入先例(main-skills / skills.ts) + +`skills:import`:`.md` 或 `.zip`;fflate `unzipSync`;zip-slip 段守卫;限额 20MB 总量/200 文件/单文件 10MB;dialog 在主进程;返回结构化结果给渲染层。→ 角色包导入**照抄这套骨架**,限额可更紧(角色包理论上限 ≈ md 文本 + 2MB 头像)。 + +## 8. 硬编码目录汇总(用户点名要盯的角落) + +全部经 `getDevaHome()` 派生(DEVA_HOME 可覆盖,便携模式生效)——**包实现里禁止出现字面量 `~/.deva`**,一律复用 personas.ts 的 `personasDir()`/`avatarsDir()`(现为模块私有,需导出或把端口逻辑放进 personas.ts): + +1. `personasDir()` = `/personas` +2. `avatarsDir()` = `/personas/avatars` +3. 知识库目录(issue#65 档 0 约定,非代码实体):`/personas/knowledge//`——子目录不干扰角色扫描(顶层扫描只认 `*.md`);打包范围已含(decisions/002) +4. 头像扩展名变体:`.webp|.png|.jpg`(同一 id 可能任一存在,读写都要遍历三分——avatar-image.ts 已封装) +5. config 键四件:`personas.enabled / order / seeded / seededPrompt`(导入只允许间接经 `setPersonaEnabled`;**不碰 seeded 族**);导入新增簿记键 `personas.imports` +6. 易混淆的非角色目录:`profile/avatar.`(用户头像)、`data/media/`(附件 blob)——均不在角色包内;`skills//` 与 `mcp.json+secrets` 属**随包从属内容**(decisions/002) + +## 9. PR#49(角色默认工作区)状态 + +提交 b96184c/c010fa1/81a0459 在 `origin/feature/workspace`,**不在 main**(`git merge-base --is-ancestor` 已验)。落地后角色会多一个按 id 存放的 home folder(机器本地用户数据)——包格式 v1 不预留字段,落地后经 update 评估(roadmap Deferred)。 From c6968c44540116f12262da0c29253dbb4018a375 Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:04:23 +0900 Subject: [PATCH 5/9] =?UTF-8?q?docs(plans):=20P001=20=E8=90=BD=E5=9C=B0?= =?UTF-8?q?=E7=8A=B6=E6=80=81=E6=9B=B4=E6=96=B0=E8=87=B3=E5=B7=B2=E6=8F=90?= =?UTF-8?q?=E4=BA=A4=E5=B9=B6=E5=90=8C=E6=AD=A5=20llmdoc=20/=20update=20P0?= =?UTF-8?q?01=20plan=20state=20to=20landed=20commits=20and=20llmdoc=20sync?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plantree/README.md | 2 +- .../plans/001-persona-export-import/roadmap.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/plantree/README.md b/docs/plantree/README.md index 1392ea5b..2595b10b 100644 --- a/docs/plantree/README.md +++ b/docs/plantree/README.md @@ -17,7 +17,7 @@ Deva 的规划状态根。架构与长效知识(模块契约、不变量、失 | ID | Plan | Affected Modules | Status | Current Phase | Last Landed | Next Target | |---|---|---|---|---|---|---| -| P001 | [角色导出/导入](plans/001-persona-export-import/) | main-personas, main-ext-roles, main-avatar-image, preload-ipc, renderer-shell | Implemented | 代码落地+冒烟全绿(未提交) | 2026-11-19 typecheck/build/冒烟4案 | GUI 手工回环 → /llmdoc:update → 提交 | +| P001 | [角色导出/导入](plans/001-persona-export-import/) | main-personas, main-ext-roles, main-avatar-image, preload-ipc, renderer-shell | Implemented | 已提交(c42f180)+ llmdoc 已同步 | 2026-11-19 dfc012b | 用户 GUI 手工回环;推送上游由用户定 | ## 读取路径 diff --git a/docs/plantree/plans/001-persona-export-import/roadmap.md b/docs/plantree/plans/001-persona-export-import/roadmap.md index 8566ce43..7e5a97ba 100644 --- a/docs/plantree/plans/001-persona-export-import/roadmap.md +++ b/docs/plantree/plans/001-persona-export-import/roadmap.md @@ -5,8 +5,9 @@ - 全角落排查(2026-11-19)→ [topics/persona-surface.md](topics/persona-surface.md) - 六问批复落决策(2026-11-19)→ [decisions/001-bundle-basics.md](decisions/001-bundle-basics.md)、[decisions/002-bundle-scope.md](decisions/002-bundle-scope.md) - v2 能力包设计定稿(2026-11-19)→ [topics/export-import-design.md](topics/export-import-design.md) -- 实现(2026-11-19,local-dev 未提交):persona-port.ts 新模块;personas.ts 导出 dir 助手/imports 簿记/删除级联;atomic-write 扩二进制重载;index.ts 注册;preload 桥;Rail 导出菜单 + AddMenu 导入项 + ChatFirstShell 接线 + i18n 中英文案 -- 验证(2026-11-19):`pnpm typecheck` 双侧通过;`pnpm build` 通过;electron 桩进程内冒烟 4 案全绿(导出含内置拒绝 / 全新机回环+同包更新 / 冲突铸新 id 不动外来者 / originalId=general 硬闸 + 坏 manifest 拒绝)——harness 在 /tmp/pp-smoke/(会话外即逝,复制回仓库再跑可复现) +- 实现 + 提交(2026-11-19):feat c42f180(persona-port.ts 新模块、personas.ts 助手/簿记/级联、atomic-write 二进制重载、IPC+preload 桥、Rail/AddMenu 入口、i18n);docs 55b57c7(本方案树) +- 验证(2026-11-19):typecheck 双侧 + build 通过;electron 桩冒烟 4 案全绿(导出含内置拒绝 / 回环+同包更新 / 冲突铸新 id / originalId=general 硬闸+坏 manifest);隔离 user-data-dir+DEVA_HOME 真机启动,CDP 验证桥函数在位、种子正常(原生对话框路径无法脚本化,留手工) +- llmdoc 同步(2026-11-19):capabilities/skills-personas.mdx 补角色包契约,提交 dfc012b + d4f0b64,概念路由第一名命中 ## In Progress @@ -14,9 +15,8 @@ ## Next -- 用户 GUI 手工过一遍:真机导出 → 换 DEVA_HOME 导入 → 手机端可见 -- `/llmdoc:update`:capabilities/skills-personas.mdx 补导出/导入契约(personas.ts 锚点已变脏) -- 提交(双语提交规范,type/refactor 之外应为 feat);是否推送上游由用户定 +- 用户 GUI 手工过一遍原生对话框路径:真机导出 → 换 DEVA_HOME 导入 → 手机端可见 +- 是否推送上游(feature 分支 PR)由用户定 ## Deferred From 50d09da3d6e3e196f042a4cc53c9f249d9df2b35 Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:07:39 +0900 Subject: [PATCH 6/9] =?UTF-8?q?docs(plans):=20P001=20=E9=AA=8C=E8=AF=81?= =?UTF-8?q?=E8=A1=A5=E5=88=A0=E7=BA=A7=E8=81=94=E4=B8=8E=E7=BC=BA=E7=A7=98?= =?UTF-8?q?=E5=AF=86=E4=B8=A4=E6=A1=88=20/=20extend=20P001=20verification?= =?UTF-8?q?=20with=20delete-cascade=20and=20missing-secret=20cases?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plantree/plans/001-persona-export-import/roadmap.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/plantree/plans/001-persona-export-import/roadmap.md b/docs/plantree/plans/001-persona-export-import/roadmap.md index 7e5a97ba..5ba3e418 100644 --- a/docs/plantree/plans/001-persona-export-import/roadmap.md +++ b/docs/plantree/plans/001-persona-export-import/roadmap.md @@ -6,8 +6,9 @@ - 六问批复落决策(2026-11-19)→ [decisions/001-bundle-basics.md](decisions/001-bundle-basics.md)、[decisions/002-bundle-scope.md](decisions/002-bundle-scope.md) - v2 能力包设计定稿(2026-11-19)→ [topics/export-import-design.md](topics/export-import-design.md) - 实现 + 提交(2026-11-19):feat c42f180(persona-port.ts 新模块、personas.ts 助手/簿记/级联、atomic-write 二进制重载、IPC+preload 桥、Rail/AddMenu 入口、i18n);docs 55b57c7(本方案树) -- 验证(2026-11-19):typecheck 双侧 + build 通过;electron 桩冒烟 4 案全绿(导出含内置拒绝 / 回环+同包更新 / 冲突铸新 id / originalId=general 硬闸+坏 manifest);隔离 user-data-dir+DEVA_HOME 真机启动,CDP 验证桥函数在位、种子正常(原生对话框路径无法脚本化,留手工) -- llmdoc 同步(2026-11-19):capabilities/skills-personas.mdx 补角色包契约,提交 dfc012b + d4f0b64,概念路由第一名命中 +- 验证(2026-11-19):typecheck 双侧 + build 通过;electron 桩冒烟 6 案全绿(导出含内置拒绝 / 回环+同包更新 / 冲突铸新 id / originalId=general 硬闸+坏 manifest / **删除级联:簿记+头像+知识库随删,再导入为全新** / **缺秘密导出:包成功+警告列出字段**);隔离 user-data-dir+DEVA_HOME 真机启动,CDP 验证桥函数在位、种子正常(原生对话框路径无法脚本化,留手工) +- 冒烟揪出的缺口已修(2026-11-19):删除级联漏清知识库目录(档 0 遗留行为,随本功能收编)→ fix a65e049;llmdoc 级联描述同步 → docs 3a073e3 +- llmdoc 同步(2026-11-19):capabilities/skills-personas.mdx 补角色包契约,baseline 已前进到 ca748a3 ## In Progress From a5561408130d043e315f65ea1953909b9d93abd4 Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:14:08 +0900 Subject: [PATCH 7/9] =?UTF-8?q?docs(plans):=20P001=20=E8=A1=A5=E7=9C=9F?= =?UTF-8?q?=E5=AE=9E=E6=95=B0=E6=8D=AE=20dry-run=20=E8=AF=81=E6=8D=AE?= =?UTF-8?q?=E4=B8=8E=E7=AC=AC=E4=BA=8C=E7=BC=BA=E5=8F=A3=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=20/=20record=20real-data=20dry-run=20evidence=20and=20second?= =?UTF-8?q?=20gap=20fix=20for=20P001?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plantree/plans/001-persona-export-import/roadmap.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/plantree/plans/001-persona-export-import/roadmap.md b/docs/plantree/plans/001-persona-export-import/roadmap.md index 5ba3e418..47daf853 100644 --- a/docs/plantree/plans/001-persona-export-import/roadmap.md +++ b/docs/plantree/plans/001-persona-export-import/roadmap.md @@ -8,7 +8,8 @@ - 实现 + 提交(2026-11-19):feat c42f180(persona-port.ts 新模块、personas.ts 助手/簿记/级联、atomic-write 二进制重载、IPC+preload 桥、Rail/AddMenu 入口、i18n);docs 55b57c7(本方案树) - 验证(2026-11-19):typecheck 双侧 + build 通过;electron 桩冒烟 6 案全绿(导出含内置拒绝 / 回环+同包更新 / 冲突铸新 id / originalId=general 硬闸+坏 manifest / **删除级联:簿记+头像+知识库随删,再导入为全新** / **缺秘密导出:包成功+警告列出字段**);隔离 user-data-dir+DEVA_HOME 真机启动,CDP 验证桥函数在位、种子正常(原生对话框路径无法脚本化,留手工) - 冒烟揪出的缺口已修(2026-11-19):删除级联漏清知识库目录(档 0 遗留行为,随本功能收编)→ fix a65e049;llmdoc 级联描述同步 → docs 3a073e3 -- llmdoc 同步(2026-11-19):capabilities/skills-personas.mdx 补角色包契约,baseline 已前进到 ca748a3 +- 真实数据 dry-run(2026-11-19,用户在跑的 Deva 的「办公室运维助手」persona-3585c7d1,~/.deva 纯读 + zip 落 /tmp):回环与更新路径**字节级一致**(13928B);揪出第二个缺口——导入经 frontmatter 重组会**静默丢非标准键**(knowledge/x-custom 实测丢失)→ fix c8020b7(writePersonaMdRaw 原样写字节 + lstat 跳符号链接防环/防越界,符号链接专项测试通过);llmdoc 同步 → f228b7c +- llmdoc 同步(2026-11-19):capabilities/skills-personas.mdx 补角色包契约,baseline 已前进到 bdcd580 ## In Progress From bb4886001106fedd517b4a7a1db3b8937f286a90 Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:21:39 +0900 Subject: [PATCH 8/9] =?UTF-8?q?docs(plans):=20P001=20=E8=A1=A5=20T3Code=20?= =?UTF-8?q?=E7=9F=A5=E8=AF=86=E5=BA=93=E8=A7=92=E8=89=B2=20dry-run=20?= =?UTF-8?q?=E8=AF=81=E6=8D=AE=20/=20record=20T3Code=20knowledge-persona=20?= =?UTF-8?q?dry-run=20evidence=20for=20P001?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/plantree/plans/001-persona-export-import/roadmap.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/plantree/plans/001-persona-export-import/roadmap.md b/docs/plantree/plans/001-persona-export-import/roadmap.md index 47daf853..8fa4277a 100644 --- a/docs/plantree/plans/001-persona-export-import/roadmap.md +++ b/docs/plantree/plans/001-persona-export-import/roadmap.md @@ -9,6 +9,7 @@ - 验证(2026-11-19):typecheck 双侧 + build 通过;electron 桩冒烟 6 案全绿(导出含内置拒绝 / 回环+同包更新 / 冲突铸新 id / originalId=general 硬闸+坏 manifest / **删除级联:簿记+头像+知识库随删,再导入为全新** / **缺秘密导出:包成功+警告列出字段**);隔离 user-data-dir+DEVA_HOME 真机启动,CDP 验证桥函数在位、种子正常(原生对话框路径无法脚本化,留手工) - 冒烟揪出的缺口已修(2026-11-19):删除级联漏清知识库目录(档 0 遗留行为,随本功能收编)→ fix a65e049;llmdoc 级联描述同步 → docs 3a073e3 - 真实数据 dry-run(2026-11-19,用户在跑的 Deva 的「办公室运维助手」persona-3585c7d1,~/.deva 纯读 + zip 落 /tmp):回环与更新路径**字节级一致**(13928B);揪出第二个缺口——导入经 frontmatter 重组会**静默丢非标准键**(knowledge/x-custom 实测丢失)→ fix c8020b7(writePersonaMdRaw 原样写字节 + lstat 跳符号链接防环/防越界,符号链接专项测试通过);llmdoc 同步 → f228b7c +- 真实数据 dry-run 之二(2026-11-19,「T3Code 配置专家」t3code-7fdbb385,带知识库:平铺 6 md / 83KB):包含全部 6 个知识文件;导入临时家后知识树 sha256 逐一匹配、零缺失零多余;md 字节一致;**未发现新缺口**。迁移语义备注:该角色 prompt 正文硬编码知识库绝对路径 `/Users/jambo/.deva/...`——同账户默认 DEVA_HOME 下迁移后仍成立,跨用户名/自定义 DEVA_HOME 时路径失效(静默按无知识库处理,档 0 约定的固有局限,issue#65 字段化是正解,已记 open questions 留观项 2) - llmdoc 同步(2026-11-19):capabilities/skills-personas.mdx 补角色包契约,baseline 已前进到 bdcd580 ## In Progress From 83aad2b733cdbe682304c5b886fbfededa9d0063 Mon Sep 17 00:00:00 2001 From: Laurent Su Date: Thu, 19 Nov 2026 12:46:33 +0900 Subject: [PATCH 9/9] =?UTF-8?q?fix(personas):=20=E5=AE=A1=E6=A0=B8?= =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E2=80=94=E2=80=94=E5=B8=B8=E9=87=8F=E5=BD=92?= =?UTF-8?q?=E4=BD=8D=E3=80=81=E9=83=A8=E5=88=86=E5=B8=A6=E5=85=A5=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E8=AF=AD=E4=B9=89=E3=80=81=E7=9F=A5=E8=AF=86=E5=BA=93?= =?UTF-8?q?=E7=BC=BA=E4=BB=B6=E8=AD=A6=E5=91=8A=20/=20address=20review:=20?= =?UTF-8?q?const=20placement,=20partial-import=20toast=20semantics,=20miss?= =?UTF-8?q?ing-knowledge=20warning?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Rail 的 BUILTIN_PERSONA_IDS 从 import 块中间移到 import 之后 / move the BUILTIN_PERSONA_IDS const out of the import block in Rail - 导入 toast:随包技能/MCP 改名(良性 →)不再误报「部分带入」,仅真失败(write-failed/secret-unavailable 等)才提示 / import toast no longer reports benign id renames as partial installs; only real failures do - manifest 声称带知识库但包内无对应文件时记 knowledge:missing 警告,不再静默跳过 / warn knowledge:missing when the manifest claims a knowledge base the bundle does not contain --- apps/desktop/src/main/services/persona-port.ts | 2 ++ .../src/renderer/src/redesign/ChatFirstShell.tsx | 6 ++++-- apps/desktop/src/renderer/src/redesign/Rail.tsx | 12 ++++++------ 3 files changed, 12 insertions(+), 8 deletions(-) diff --git a/apps/desktop/src/main/services/persona-port.ts b/apps/desktop/src/main/services/persona-port.ts index 18ba9cb2..8fca115b 100644 --- a/apps/desktop/src/main/services/persona-port.ts +++ b/apps/desktop/src/main/services/persona-port.ts @@ -590,6 +590,8 @@ export async function importPersonaBundleFrom(filePath: string): Promise p.startsWith(originalPrefix))) { const r = extractDirInto(files, originalPrefix, personaKnowledgeDir(finalId)) if (!r.ok) warnings.push(`knowledge:${r.error}`) + } else { + warnings.push('knowledge:missing') // manifest 声称带知识库,包里却没有对应文件(改包/损坏) } } diff --git a/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx b/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx index 1b85f811..8857d42e 100644 --- a/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx +++ b/apps/desktop/src/renderer/src/redesign/ChatFirstShell.tsx @@ -602,7 +602,8 @@ export function ChatFirstShell(): React.JSX.Element { })() } // 导入角色包:主进程弹选择框;同源包再导入 = 就地更新(主进程按簿记判定)。 - // 成功刷新扩展清单(花名册 / 技能 / MCP 随之更新),toast 报结果;铸了新 id 的随包技能/MCP 数量一并提示。 + // 成功刷新扩展清单(花名册 / 技能 / MCP 随之更新),toast 报结果。warnings 两类:随包技能/MCP + // 撞名改 id(`含 →`,良性,照常算成功);真没装上的(write-failed / secret-unavailable 等)才按「部分带入」提示。 const importPersona = (): void => { void (async () => { const res = await window.deva?.personas?.importBundle() @@ -614,11 +615,12 @@ export function ChatFirstShell(): React.JSX.Element { return } refresh() + const realFailures = res.warnings?.filter((w) => !w.includes('→')) ?? [] toast.show({ variant: 'success', title: t('cf.importDone'), message: fill( - t(res.warnings?.length ? 'cf.importPartial' : res.updated ? 'cf.importUpdated' : 'cf.importCreated'), + t(realFailures.length ? 'cf.importPartial' : res.updated ? 'cf.importUpdated' : 'cf.importCreated'), { name: clipName(res.name ?? '') } ) }) diff --git a/apps/desktop/src/renderer/src/redesign/Rail.tsx b/apps/desktop/src/renderer/src/redesign/Rail.tsx index f5b5beac..b0922829 100644 --- a/apps/desktop/src/renderer/src/redesign/Rail.tsx +++ b/apps/desktop/src/renderer/src/redesign/Rail.tsx @@ -2,12 +2,6 @@ * 左侧图标栏与对话列表(搜索、筛选、分组、行菜单、新建对话 / 角色)。 */ import { useEffect, useMemo, useRef, useState } from 'react' - -/** - * 内置(种子)角色 id:不可导出(与主进程 services/personas.ts 的 DEFAULT_PERSONAS 对齐)。 - * 删除的菜单禁用只锁 general(DEFAULT_PERSONA_ID,回落兜底身份);导出两者都锁。 - */ -const BUILTIN_PERSONA_IDS = new Set(['general', 'xiaomajiang']) import { AlarmClock, Archive, @@ -56,6 +50,12 @@ import { ContextMenu } from './ContextMenu' import { memberPersona } from './MemberBar' import { useDraftPreview } from './Composer' +/** + * 内置(种子)角色 id:不可导出(与主进程 services/personas.ts 的 DEFAULT_PERSONAS 对齐)。 + * 删除的菜单禁用只锁 general(DEFAULT_PERSONA_ID,回落兜底身份);导出两者都锁。 + */ +const BUILTIN_PERSONA_IDS = new Set(['general', 'xiaomajiang']) + /** * 花名册手动排序不再按名称(角色可改名 → 名称排序会跳位):改由用户拖拽 / 置顶决定,顺序以 id 列表 * 持久化(对标微信等 IM 的联系人手动排序)。此纯函数把「把 dragId 放到 targetId 之前/之后」算成新的 id 序列。