@voko/lite 0.3.1

package/src/core/did-auth.js

@@ -0,0 +1,54 @@
+/**
+ * DID 认证通用工具
+ *
+ * 提供 Ed25519 私钥提取和 DID 请求签名，供主进程 IPC、MCP 工具等共享。
+ */
+
+const { signAsync } = require('@noble/ed25519');
+
+// 将 PEM / base64 / hex 格式 Ed25519 私钥解析为 raw 32 字节
+function extractEd25519PrivateKey(pem) {
+  const cleaned = pem
+    .replace(/-----BEGIN [\w\s]+ KEY-----/g, '')
+    .replace(/-----END [\w\s]+ KEY-----/g, '')
+    .replace(/\s/g, '');
+  const bytes = Buffer.from(cleaned, 'base64');
+
+  // 如果刚好 32 字节，直接使用
+  if (bytes.length === 32) return new Uint8Array(bytes);
+
+  // 如果末尾有 32 字节（PKCS#8 DER），取末尾 32 字节
+  if (bytes.length > 32) {
+    const slice = bytes.slice(-32);
+    if (slice.length === 32) return new Uint8Array(slice);
+  }
+
+  // 兜底：尝试 hex 解码
+  if (cleaned.length === 64 && /^[0-9a-f]+$/i.test(cleaned)) {
+    return new Uint8Array(Buffer.from(cleaned, 'hex'));
+  }
+
+  console.warn('[extractEd25519PrivateKey] unexpected key length:', bytes.length, 'trying first 32 bytes');
+  return new Uint8Array(bytes.slice(0, 32));
+}
+
+/**
+ * DID 请求签名工具函数
+ * @param {string} did - Agent DID（did:wba:...）
+ * @param {string} privateKey - PEM 格式 Ed25519 私钥
+ * @param {object} businessFields - 除 did/nonce/timestamp/signature 外的业务字段
+ * @returns {object} { did, nonce, timestamp, signature }
+ */
+async function signDidRequest(did, privateKey, businessFields) {
+  const nonce = Math.random().toString(36).substring(2, 15) + Date.now().toString(36);
+  const timestamp = Math.floor(Date.now() / 1000);
+  const sortedKeys = Object.keys(businessFields).sort();
+  const bodyPayload = JSON.stringify(businessFields, sortedKeys);
+  const toSign = did + '\n' + nonce + '\n' + timestamp + '\n' + bodyPayload;
+  const rawKey = extractEd25519PrivateKey(privateKey);
+  const sigBytes = await signAsync(new TextEncoder().encode(toSign), rawKey);
+  const signature = Buffer.from(sigBytes).toString('base64');
+  return { did, nonce, timestamp, signature };
+}
+
+module.exports = { extractEd25519PrivateKey, signDidRequest };

package/src/core/hermes-paths.js

@@ -0,0 +1,57 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+/**
+ * Hermes 根目录候选路径（按优先级）
+ * Windows: %LOCALAPPDATA%\hermes（默认安装） → ~/.hermes
+ * 其他平台: ~/.hermes
+ */
+function getHermesDirCandidates() {
+  const candidates = [];
+  if (process.platform === 'win32') {
+    const localAppData = process.env.LOCALAPPDATA;
+    if (localAppData) candidates.push(path.join(localAppData, 'hermes'));
+  }
+  candidates.push(path.join(os.homedir(), '.hermes'));
+  return candidates;
+}
+
+/** 返回第一个存在的 Hermes 根目录，均不存在则 null */
+function findHermesDir() {
+  for (const dir of getHermesDirCandidates()) {
+    if (fs.existsSync(dir)) return dir;
+  }
+  return null;
+}
+
+/** Hermes 根目录：优先用已存在的，否则用默认候选（写入场景） */
+function getHermesDir() {
+  return findHermesDir() || getHermesDirCandidates()[0];
+}
+
+function getHermesProfilesDir() {
+  return path.join(getHermesDir(), 'profiles');
+}
+
+function getHermesProfilePath(profileName, ...segments) {
+  return path.join(getHermesProfilesDir(), profileName, ...segments);
+}
+
+function getHermesEnvPath() {
+  return path.join(getHermesDir(), '.env');
+}
+
+function getHermesConfigPath() {
+  return path.join(getHermesDir(), 'config.yaml');
+}
+
+module.exports = {
+  getHermesDirCandidates,
+  findHermesDir,
+  getHermesDir,
+  getHermesProfilesDir,
+  getHermesProfilePath,
+  getHermesEnvPath,
+  getHermesConfigPath,
+};

package/src/core/invitation.js

@@ -0,0 +1,49 @@
+/**
+ * 邀请好友 — 提示词构建器
+ * 一处修改，多处生效
+ */
+
+/**
+ * 生成邀请提示词（好友将这段文案发给自己的 Agent 即可）
+ * @param {Object} opts
+ * @param {string} opts.myName — 邀请者 Agent 名称
+ * @param {string} opts.ownerEmail — 邀请者邮箱
+ * @param {string} opts.version — VOKO 版本号
+ * @param {string} opts.guideUrl — 使用指南 URL
+ * @param {string} opts.downloadUrl — 下载链接
+ * @param {string} opts.friendEmail — 好友邮箱（用于搜索 Agent）
+ * @param {string} opts.inviteCode — 6 位邀请码
+ * @returns {string}
+ */
+function buildInvitationPrompt({ myName, ownerEmail, version, guideUrl, downloadUrl, friendEmail, inviteCode }) {
+  return `**邀请者：** ${myName}（${ownerEmail}）
+**VOKO 版本：** ${version}
+**系统自动处理：** 好友发来的消息包含对应邀请码时，**自动通过并加入白名单**，无需人工处理。
+
+### 好友操作步骤
+1. 📖 阅读指南：${guideUrl}
+2. ⬇️ 下载安装：${downloadUrl}
+3. 🔧 注册配置 Agent
+4. 🔍 搜索你的 Agent（邮箱：${friendEmail}）
+5. 💬 发送消息格式：\`好友申请，「邀请码：${inviteCode}」\``;
+}
+
+/**
+ * 生成邮件标题
+ * @param {string} myName — 邀请方 Agent 名称
+ * @returns {string}
+ */
+function buildEmailSubject(myName) {
+  return `你的好友 ${myName} 邀请你使用 VOKO智能体IM通信软件`;
+}
+
+/**
+ * 生成邮件内容（主题 + 提示词）
+ * @param {Object} opts
+ * @returns {string}
+ */
+function buildEmailContent(opts) {
+  return `主题：${buildEmailSubject(opts.myName || '')}\n\n${buildInvitationPrompt(opts)}`;
+}
+
+module.exports = { buildInvitationPrompt, buildEmailSubject, buildEmailContent };

package/src/core/lite-bus.js

@@ -0,0 +1,16 @@
+/**
+ * lite-bus.js — 事件总线
+ *
+ * 替代 mainWindow.webContents.send()，解耦业务逻辑与 Electron UI。
+ * 业务代码 emit 事件 → Desktop 订阅并转发给渲染进程。
+ * Lite 模式下无订阅者，事件静默丢弃。
+ *
+ * 用法：
+ *   const bus = require('./lite-bus');
+ *   bus.emit('agent-wukongim:message', { ... });
+ */
+
+const EventEmitter = require('events');
+const bus = new EventEmitter();
+bus.setMaxListeners(100);
+module.exports = bus;