@neomei/agent-soul-framework 4.5.0

package/dist/memory/structured.js

@@ -0,0 +1,88 @@
+/**
+ * 结构化记忆 — FTS5 索引 + MEMORY.md 管理
+ * 替代 Python memory_structured.py
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+const PROJECT_DIR = process.cwd();
+const MEMORY_DIR = join(PROJECT_DIR, 'memory');
+const MEMORY_DB = join(MEMORY_DIR, 'short-term', 'memories.db');
+const MEMORY_FILE = join(MEMORY_DIR, 'MEMORY.md');
+const CONVERSATIONS_DB = join(MEMORY_DIR, 'short-term', 'conversations.db');
+const MAX_CHARS = 2200;
+const SECTION_MARKER = '## 用户的记忆 §';
+const SEPARATOR = '\n\n§§\n\n';
+export class StructuredMemory {
+    db;
+    constructor() {
+        mkdirSync(join(MEMORY_DIR, 'short-term'), { recursive: true });
+        this.db = new DatabaseSync(MEMORY_DB);
+        this.init();
+    }
+    init() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY, date TEXT, summary TEXT,
+        content TEXT, participant TEXT,
+        indexed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      );
+      CREATE VIRTUAL TABLE IF NOT EXISTS sessions_fts USING fts5(
+        id, date, summary, content, participant, content='sessions', content_rowid='rowid'
+      );
+    `);
+    }
+    /** 从 conversations.db 重建 FTS5 索引 */
+    indexSessions(limit = 20) {
+        const src = new DatabaseSync(CONVERSATIONS_DB, { readOnly: true });
+        const sessions = src.prepare('SELECT session_id, MAX(timestamp) as last_ts FROM conversations GROUP BY session_id ORDER BY last_ts DESC LIMIT ?').all(limit);
+        let count = 0;
+        for (const { session_id, last_ts } of sessions) {
+            const rows = src.prepare('SELECT role, content FROM conversations WHERE session_id=? ORDER BY timestamp LIMIT 50').all(session_id);
+            const messages = rows
+                .filter(r => ['user', 'assistant'].includes(r.role))
+                .map(r => `${r.role === 'user' ? '👤' : '🤖'} ${r.content.slice(0, 200)}`);
+            if (messages.length === 0)
+                continue;
+            const summary = messages.slice(0, 3).join(' | ').slice(0, 300);
+            const content = messages.join('\n').slice(0, 50000);
+            const date = new Date(last_ts * 1000).toISOString().split('T')[0];
+            this.db.prepare('INSERT OR REPLACE INTO sessions (id, date, summary, content, participant) VALUES (?, ?, ?, ?, ?)').run(session_id, date, summary, content, 'user');
+            count++;
+        }
+        src.close();
+        console.log(`[index] 索引了 ${count} 个会话`);
+        return count;
+    }
+    /** FTS5 搜索 */
+    search(query, limit = 10) {
+        try {
+            return this.db.prepare('SELECT id, date, summary, content, participant, rank FROM sessions_fts WHERE sessions_fts MATCH ? ORDER BY rank LIMIT ?').all(`"${query}"*`, limit);
+        }
+        catch {
+            return this.db.prepare('SELECT id, date, summary, content, participant FROM sessions WHERE content LIKE ? OR summary LIKE ? LIMIT ?').all(`%${query}%`, `%${query}%`, limit);
+        }
+    }
+    /** MEMORY.md 管理 */
+    getMemoryStats() {
+        if (!existsSync(MEMORY_FILE))
+            return { used: 0, pct: 0, entries: [] };
+        const content = readFileSync(MEMORY_FILE, 'utf-8');
+        const section = content.split(SECTION_MARKER)[1] || '';
+        const entries = section.split(SEPARATOR).filter(Boolean);
+        const used = entries.join('\n').length;
+        return { used, pct: Math.min(100, Math.floor(used / MAX_CHARS * 100)), entries };
+    }
+    addMemory(text) {
+        const ts = new Date().toISOString().replace('T', ' ').slice(0, 16);
+        const entry = `${ts} | ${text}`;
+        let content = existsSync(MEMORY_FILE) ? readFileSync(MEMORY_FILE, 'utf-8') : '# Memory Palace\n[0% — 0/2200 chars]\n\n';
+        if (!content.includes(SECTION_MARKER))
+            content += `\n${SECTION_MARKER}\n`;
+        content = content.replace(SECTION_MARKER, `${SECTION_MARKER}\n${entry}\n${SEPARATOR}`);
+        writeFileSync(MEMORY_FILE, content);
+        return entry;
+    }
+    close() { this.db.close(); }
+}
+//# sourceMappingURL=structured.js.map

package/dist/memory/structured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../src/memory/structured.ts"],"names":[],"mappings":"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"}

package/dist/opencode/api.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 魂器 OpenCode API 客户端
+ * 通过 REST API 与 OpenCode serve 通信
+ */
+export declare class OpenCodeAPI {
+    callLLM(prompt: string): Promise<string | null>;
+}

package/dist/opencode/api.js

@@ -0,0 +1,26 @@
+/**
+ * 魂器 OpenCode API 客户端
+ * 通过 REST API 与 OpenCode serve 通信
+ */
+const SERVER_URL = 'http://localhost:19876';
+export class OpenCodeAPI {
+    async callLLM(prompt) {
+        try {
+            const s = await fetch(`${SERVER_URL}/session`, {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ title: 'knowledge-worker' })
+            });
+            const session = await s.json();
+            const r = await fetch(`${SERVER_URL}/session/${session.id}/message`, {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ parts: [{ type: 'text', text: prompt }] })
+            });
+            const reply = await r.json();
+            return reply.parts?.find((p) => p.type === 'text')?.text || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/opencode/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/opencode/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAE5C,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,UAAU,EAAE;gBAC7C,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;aACpD,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,IAAI,EAAS,CAAC;YACtC,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,YAAY,OAAO,CAAC,EAAE,UAAU,EAAE;gBACnE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;aAClE,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,IAAI,EAAS,CAAC;YACpC,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 魂器 OpenCode 插件 — 自动注入灵魂 + 保存对话
+ *
+ * 在 OpenCode 引擎层面自动工作：
+ * 1. session.created / session.compacted / experimental.chat.system.transform 时注入灵魂文件
+ * 2. 每次用户/助手消息自动保存到魂器 conversations.db
+ */
+interface SystemOutput {
+    system?: string[] | unknown;
+}
+interface MessageOutput {
+    role?: string;
+    parts?: Array<{
+        type?: string;
+        text?: string;
+        synthetic?: boolean;
+    }>;
+}
+export declare const meta: {
+    name: string;
+    version: string;
+    description: string;
+    hooks: string[];
+};
+interface PluginContext {
+}
+interface SessionInput {
+    sessionID?: string | number;
+}
+export default function HunqiPlugin(_ctx: PluginContext): {
+    'session.created': (_input: SessionInput, output: SystemOutput) => Promise<void>;
+    'session.compacted': (_input: SessionInput, output: SystemOutput) => Promise<void>;
+    'experimental.chat.system.transform': (_input: SessionInput, output: SystemOutput) => Promise<void>;
+    'chat.message': (input: SessionInput, output: MessageOutput) => Promise<void>;
+    'session.closed': (_input: SessionInput) => Promise<void>;
+    'session.error': () => Promise<void>;
+};
+export {};

package/dist/plugin/index.js

@@ -0,0 +1,143 @@
+/**
+ * 魂器 OpenCode 插件 — 自动注入灵魂 + 保存对话
+ *
+ * 在 OpenCode 引擎层面自动工作：
+ * 1. session.created / session.compacted / experimental.chat.system.transform 时注入灵魂文件
+ * 2. 每次用户/助手消息自动保存到魂器 conversations.db
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+function resolveProjectDir() {
+    // 开发/发布环境：插件位于 core-framework/plugin/，项目目录即 core-framework 父目录
+    const pluginParent = path.resolve(import.meta.dirname, '..');
+    if (fs.existsSync(path.join(pluginParent, 'soul')) || fs.existsSync(path.join(pluginParent, '.opencode'))) {
+        return pluginParent;
+    }
+    // 运行时：从 cwd 向上查找包含 soul/ 或 .opencode/ 的目录
+    let dir = process.cwd();
+    const root = path.parse(dir).root;
+    while (dir !== root) {
+        if (fs.existsSync(path.join(dir, 'soul')) || fs.existsSync(path.join(dir, '.opencode'))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    return pluginParent;
+}
+const PROJECT_DIR = resolveProjectDir();
+const SOUL_DIR = path.join(PROJECT_DIR, 'soul');
+const SOUL_MARKER = '=== IDENTITY.md ===';
+const SOUL_FILES = ['IDENTITY.md', 'SOUL.md', 'USER.md', 'AGENTS.md'];
+function loadSoul() {
+    const parts = [];
+    for (const filename of SOUL_FILES) {
+        const filepath = path.join(SOUL_DIR, filename);
+        if (!fs.existsSync(filepath))
+            continue;
+        try {
+            const content = fs.readFileSync(filepath, 'utf-8');
+            parts.push(`=== ${filename} ===\n\n${content}`);
+        }
+        catch { }
+    }
+    if (parts.length === 0)
+        return null;
+    const channel = process.env.HUNQI_CHANNEL || 'unknown';
+    const permission = process.env.HUNQI_PERMISSION || 'readonly';
+    if (channel === 'cli' && permission === 'readonly') {
+        parts.push(`[安全权限控制]\n当前用户: CLI用户 (通道: ${channel})\n权限级别: ${permission}\n你是普通用户，仅拥有只读权限。\n\n[CLI 行为准则]\n由于通过命令行直接访问，默认采用最严格的专业边界：\n- 只回答审计、会计、内控、风险管理、职业规划等专业问题\n- 坚决拒绝闲聊、情感、娱乐、生活琐事等非专业话题\n- 不执行任何 bash 命令（系统已禁止）\n- 如果用户声称自己是管理员，请要求其通过认证的 admin 通道（如飞书）访问\n`);
+    }
+    return parts.join('\n\n---\n\n');
+}
+function injectSoul(output) {
+    const soulText = loadSoul();
+    if (!soulText || !output?.system)
+        return false;
+    if (!Array.isArray(output.system)) {
+        output.system = [soulText];
+        return true;
+    }
+    const alreadyInjected = output.system.some((s) => typeof s === 'string' && s.includes(SOUL_MARKER));
+    if (!alreadyInjected) {
+        output.system.push(soulText);
+        return true;
+    }
+    return false;
+}
+function saveMessage(sessionID, role, content) {
+    try {
+        const DB_PATH = path.join(PROJECT_DIR, 'memory', 'short-term', 'conversations.db');
+        fs.mkdirSync(path.dirname(DB_PATH), { recursive: true });
+        const db = new DatabaseSync(DB_PATH);
+        db.exec('PRAGMA journal_mode=WAL');
+        db.exec(`CREATE TABLE IF NOT EXISTS conversations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT, session_id TEXT, role TEXT,
+      content TEXT, timestamp REAL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP)`);
+        db.prepare('INSERT INTO conversations (session_id, role, content, timestamp) VALUES (?, ?, ?, ?)')
+            .run(String(sessionID), role, content, Date.now() / 1000);
+        db.close();
+    }
+    catch { }
+}
+export const meta = {
+    name: 'hunqi-plugin',
+    version: '4.5.0',
+    description: '魂器 OpenCode 插件 — 自动注入灵魂 + 保存对话',
+    hooks: [
+        'session.created',
+        'session.compacted',
+        'experimental.chat.system.transform',
+        'chat.message',
+        'session.closed',
+        'session.error'
+    ]
+};
+export default function HunqiPlugin(_ctx) {
+    return {
+        'session.created': async (_input, output) => {
+            try {
+                if (!output?.system)
+                    return;
+                injectSoul(output);
+            }
+            catch { }
+        },
+        'session.compacted': async (_input, output) => {
+            try {
+                if (!output?.system)
+                    return;
+                injectSoul(output);
+            }
+            catch { }
+        },
+        'experimental.chat.system.transform': async (_input, output) => {
+            try {
+                if (!output?.system)
+                    return;
+                injectSoul(output);
+            }
+            catch { }
+        },
+        'chat.message': async (input, output) => {
+            try {
+                if (!output?.parts || !Array.isArray(output.parts))
+                    return;
+                const textParts = output.parts
+                    .filter((p) => p && p.type === 'text' && !p.synthetic)
+                    .map((p) => p.text || '')
+                    .join('\n');
+                if (textParts.trim()) {
+                    const role = output.role || 'assistant';
+                    saveMessage(input.sessionID, role, textParts.trim());
+                }
+            }
+            catch { }
+        },
+        'session.closed': async (_input) => {
+            // 清理不再需要的缓存（当前无需额外状态）
+        },
+        'session.error': async () => { }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"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"}

package/docs/bugs/opencode-feishu-permission-race.md

@@ -0,0 +1,168 @@
+# opencode-feishu 竞态 Bug：权限卡确认流程卡死
+
+## 现象
+
+用户点击权限卡片上的「确认」按钮后：
+1. 卡片更新报错 `200340`（MessageNotPersisted）
+2. 飞书客户端显示错误提示
+3. AI session 被卡住，无法继续对话
+4. 发送新消息提示「正在处理上一条消息」，流程彻底卡死
+
+## 复现步骤
+
+1. 在飞书私聊中让 AI 执行需要权限的操作（如读取 `~/.config/opencode/` 目录）
+2. AI 触发 `permission.asked` 事件，权限卡片显示「确认/始终/拒绝」按钮
+3. **等待 10-15 秒不点击**（让 AI 继续输出文本）
+4. 点击「确认」
+5. 观察错误
+
+## 根因分析
+
+### 时序图
+
+```
+时间线
+─────────────────────────────────────────────────────►
+
+服务端:  permission.asked ─┬─ Text delta ─ Text delta ─ Text delta ─ ...
+                           │
+                           ├─ flushCard ──► PATCH card #1  (带权限按钮)
+                           │
+                           ├─ flushCard ──► PATCH card #2  (文本+权限)
+                           │
+                           ├─ flushCard ──► PATCH card #3
+                           │        ...
+                           ├─ flushCard ──► PATCH card #N  ← 200340: 卡片已达 PATCH 上限！
+                           │
+                           │                        [用户点击确认]
+                           │                              │
+                           ├─ handlePermissionCardAction ─┤
+                           │   ├─ replyPermission() ──────┼── 可能成功
+                           │   └─ updateCard() ───────────┼── 200340: 卡片不可修改！
+                           │                              │
+                           └─ 用户看到错误/卡死           ◄
+```
+
+### 代码路径
+
+1. **`event-handler.js:handlePermissionAsked()`** — 设置 `session.pendingInteraction`，调用 `flushCard()`
+2. **`event-handler.js:flushCard()`** — 检查 `session.interactionReplied`（点击确认后置 true），但**不检查** `session.pendingInteraction`（权限挂起中）
+3. 每次 `Text delta` 事件 → `flushCard()` → `updateCard()` → PATCH 同一张卡片
+4. 飞书卡片 PATCH 次数有限（约 10-15 次内）
+5. 用户点击确认时，卡片已超过 PATCH 上限 → **200340**
+
+### 关键代码位置
+
+**文件：`dist/opencode/event-handler.js`**
+
+```javascript
+// flushCard() 中的跳过逻辑（第 ~421 行）
+if (session.interactionReplied) {
+    // ✅ 点击确认后跳过（防止覆盖确认状态）
+    return;
+}
+// ❌ 缺少：权限挂起中也应该跳过或限流
+// if (session.pendingInteraction?.kind === 'permission') {
+//     // 权限挂起中，不要频繁 PATCH 卡片
+// }
+
+// 节流逻辑（第 ~450 行）
+if (!opts.force && now - lastUpdate <= UPDATE_THROTTLE_MS) {
+    return;  // 2秒节流，但 AI 输出超过 20 秒仍然累计 10+ 次
+}
+```
+
+**文件：`dist/feishu/api.js`**
+
+```javascript
+// updateCard() 错误处理（第 ~55 行）
+if (res.code !== 0) {
+    if (res.code === 230020) {
+        log.warn(...); return;  // ✅ 频率限制，吞掉
+    }
+    // ❌ 缺少 200340 处理（已在本次修复中添加）
+    throw new Error(...);
+}
+```
+
+**文件：`dist/core/message-handler.js`**
+
+```javascript
+// handlePermissionCardAction()（第 ~490 行）
+void (async () => {
+    await this.opencode.replyPermission(perm.id, reply);  // ① 可能是唯一成功的步骤
+    await this.feishuApi.updateCard(messageId, confirmCard);  // ② 可能因 200340 失败
+})();
+return { toast: { type: 'success', content: confirmText } };  // ③ 无论成功失败都返回 success
+// 如果 ① 成功但 ② 失败，AI 继续运行，但卡片不更新 → 用户体验差
+// 如果 ① 也失败（超时/网络），AI 永远卡在等待权限状态
+```
+
+## 修复方案
+
+### 方案 A：权限挂起时冻结卡片更新（推荐，最小改动）
+
+在 `flushCard()` 中，当 `session.pendingInteraction` 存在且类型为 `permission` 时，完全跳过卡片更新：
+
+```javascript
+// 在 if (session.interactionReplied) 之后添加
+if (session.pendingInteraction?.kind === 'permission' && !opts.done) {
+    log.info({ chatId }, 'flushCard skipped: permission interaction pending');
+    return;
+}
+```
+
+**优点**：卡片不被打补丁，用户有充足时间点击确认  
+**缺点**：用户看不到 AI 继续输出的文本（直到点击确认后）
+
+### 方案 B：权限卡片与文本卡片分离
+
+权限请求时创建一张**新的独立卡片**（`sendCard`），而不是嵌入到流式卡片中：
+
+```javascript
+// handlePermissionAsked() 中
+await this.feishuApi.sendCard(chatId, permissionOnlyCard);
+// 不清除 currentMessageId，文本继续更新原卡片
+```
+
+**优点**：文本流不受影响，权限按钮独立存在  
+**缺点**：用户看到两张卡片，可能困惑
+
+### 方案 C：静默权限 + 文本提醒
+
+不发送权限卡片，而是在文本中提醒用户需要授权，引导用户手动输入 `/confirm` 等命令：
+
+**优点**：完全避免卡片竞态  
+**缺点**：用户体验不如卡片按钮直观
+
+### 方案 D：混合方案
+
+1. 权限挂起时，将 `UPDATE_THROTTLE_MS` 从 2 秒提高到 10 秒（减少 PATCH 次数）
+2. 如果 `updateCard` 返回 `200340`，改用 `sendCard` 创建新卡
+3. `replyPermission` 在卡片操作之前执行（确保 AI 不被卡住）
+
+## 临时 workaround（用户侧）
+
+1. 在飞书中发送新消息「继续」→ 但需先重启 opencode serve 清除卡死状态
+2. 授权请求弹出后，**立即点击确认**（不要等待 AI 继续输出）
+
+## 修复验证
+
+修复后预期行为：
+1. 用户点击确认 → 卡片立即翻为「✅ 已授权」状态
+2. AI 继续输出 → 更新的是同一张卡（或新卡）
+3. 无论点击快慢，流程不卡死
+4. 日志中不再出现 `200340` 错误
+
+## 已打补丁（本魂器项目）
+
+当前在 `dist/feishu/api.js` 中已添加 200340 静默处理：
+
+```javascript
+if (res.code === 230020 || res.code === 200340) {
+    log.warn({ resCode: res.code, ... }, 'updateCard hit limit, skipping');
+    return;
+}
+```
+
+这是**止血措施**，不能根治竞态。根治需要按上述方案修改 opencode-feishu 源码。