@zooique/memora 0.1.0

package/dist/utils/segmenter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 轻量关键词分词（用于关键词匹配场景）
+ *
+ * 与 segmentText() 的区别：
+ *   - segmentText：精确分词（Intl.Segmenter ICU 词典切分），用于 LLM 输出切分 + recall 关键词提取
+ *   - tokenizeKeywords：轻量分词，用于 persona/skill 关键词匹配
+ *     提取中文连续段（≥2 字）+ 英文词，不做 ICU 词典切分
+ *
+ * @param input - 用户输入文本
+ * @returns 分词后的 token 列表（去重）
+ */
+export declare function tokenizeKeywords(input: string): string[];
+/**
+ * 关键词匹配评分（Persona/Skill 共享逻辑）
+ *
+ * 匹配策略：先分词，再对每个关键词做子串搜索（tokens + 原文双保险）。
+ * 大小写不敏感，中英文混合友好。
+ *
+ * @param userInput - 用户输入文本
+ * @param keywordList - 待匹配的关键词数组
+ * @returns 匹配得分 (0~1)，0 表示无命中
+ */
+export declare function scoreByKeywords(userInput: string, keywordList: string[]): number;
+/**
+ * 单行分词（用于 LLM 输出的精确切分）
+ * @param text 原文
+ * @returns 分词数组（去标点、去空白、保留中英文 + 数字）
+ */
+export declare function segmentText(text: string): string[];
+//# sourceMappingURL=segmenter.d.ts.map

package/dist/utils/segmenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmenter.d.ts","sourceRoot":"","sources":["../../src/utils/segmenter.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAehF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAclD"}

package/dist/utils/segmenter.js

@@ -0,0 +1,80 @@
+/**
+ * 文本分词器
+ *
+ * 用 Node 内建 Intl.Segmenter（ECMAScript Intl API）实现中英文混合分词：
+ * - 英文按空格 + 标点
+ * - 中文按 ICU 词典（Node 18+ 内建）
+ * - 数字、emoji、英文单词保留为整体
+ *
+ * 详见 M-202：避免引入 nodejieba（C++ 扩展，Windows + Node 24 prebuilt 不可靠）
+ *
+ * 性能：~10 万字/秒（Intl.Segmenter 是 ICU C++ 实现，比纯 JS 快 10 倍+）
+ */
+const ZH_SEGMENTER = new Intl.Segmenter('zh-CN', { granularity: 'word' });
+/**
+ * 轻量关键词分词（用于关键词匹配场景）
+ *
+ * 与 segmentText() 的区别：
+ *   - segmentText：精确分词（Intl.Segmenter ICU 词典切分），用于 LLM 输出切分 + recall 关键词提取
+ *   - tokenizeKeywords：轻量分词，用于 persona/skill 关键词匹配
+ *     提取中文连续段（≥2 字）+ 英文词，不做 ICU 词典切分
+ *
+ * @param input - 用户输入文本
+ * @returns 分词后的 token 列表（去重）
+ */
+export function tokenizeKeywords(input) {
+    const tokens = [];
+    // 提取中文连续段（2 字以上的中文 token）
+    const chineseSegments = input.match(/[\u4e00-\u9fff]{2,}/g) ?? [];
+    tokens.push(...chineseSegments);
+    // 提取英文词
+    const englishSegments = input.match(/[a-zA-Z0-9]+/g) ?? [];
+    tokens.push(...englishSegments);
+    return tokens;
+}
+/**
+ * 关键词匹配评分（Persona/Skill 共享逻辑）
+ *
+ * 匹配策略：先分词，再对每个关键词做子串搜索（tokens + 原文双保险）。
+ * 大小写不敏感，中英文混合友好。
+ *
+ * @param userInput - 用户输入文本
+ * @param keywordList - 待匹配的关键词数组
+ * @returns 匹配得分 (0~1)，0 表示无命中
+ */
+export function scoreByKeywords(userInput, keywordList) {
+    if (keywordList.length === 0)
+        return 0;
+    const normalizedInput = userInput.toLowerCase();
+    const tokens = tokenizeKeywords(normalizedInput);
+    let hitCount = 0;
+    for (const kw of keywordList) {
+        const kwLower = kw.toLowerCase();
+        if (tokens.some((t) => t.includes(kwLower)) || normalizedInput.includes(kwLower)) {
+            hitCount++;
+        }
+    }
+    return hitCount / keywordList.length;
+}
+/**
+ * 单行分词（用于 LLM 输出的精确切分）
+ * @param text 原文
+ * @returns 分词数组（去标点、去空白、保留中英文 + 数字）
+ */
+export function segmentText(text) {
+    if (!text)
+        return [];
+    // 中英混合：先用 zh-CN 切中文词，再过滤标点
+    // zh-CN 也支持英文按空格切（不会破坏英文单词）
+    const tokens = [];
+    for (const segment of ZH_SEGMENTER.segment(text)) {
+        if (segment.isWordLike) {
+            const word = segment.segment.trim();
+            if (word.length > 0) {
+                tokens.push(word);
+            }
+        }
+    }
+    return tokens;
+}
+//# sourceMappingURL=segmenter.js.map

package/dist/utils/segmenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmenter.js","sourceRoot":"","sources":["../../src/utils/segmenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,0BAA0B;IAC1B,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IAChC,QAAQ;IACR,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,WAAqB;IACtE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEvC,MAAM,eAAe,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAEjD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACjF,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,2BAA2B;IAC3B,4BAA4B;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/strings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 字符串工具函数
+ *
+ * 从各模块提取的公共字符串处理函数，消除跨模块重复代码。
+ */
+/**
+ * 将字符串转换为 URL 友好的 slug 格式
+ *
+ * 规则：
+ *   - 冒号和空白替换为连字符
+ *   - 只保留字母、数字、中文、连字符、下划线
+ *   - 截断到 40 字符
+ *
+ * @param value 输入字符串
+ * @returns slug 格式的字符串
+ */
+export declare function slugify(value: string): string;
+//# sourceMappingURL=strings.d.ts.map

package/dist/utils/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO7C"}

package/dist/utils/strings.js

@@ -0,0 +1,25 @@
+/**
+ * 字符串工具函数
+ *
+ * 从各模块提取的公共字符串处理函数，消除跨模块重复代码。
+ */
+/**
+ * 将字符串转换为 URL 友好的 slug 格式
+ *
+ * 规则：
+ *   - 冒号和空白替换为连字符
+ *   - 只保留字母、数字、中文、连字符、下划线
+ *   - 截断到 40 字符
+ *
+ * @param value 输入字符串
+ * @returns slug 格式的字符串
+ */
+export function slugify(value) {
+    return value
+        .replace(/[:\s]+/g, '-')
+        .replace(/[^a-zA-Z0-9\u4e00-\u9fff\-_]/g, '')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 40);
+}
+//# sourceMappingURL=strings.js.map

package/dist/utils/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../src/utils/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;SAC5C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 时间工具函数
+ *
+ * 从 messageHistory.ts 提取的公共时间格式化函数，
+ * 消除跨模块 `new Date().toISOString()` 内联重复。
+ */
+/**
+ * 获取当前时间的 ISO 8601 时间戳
+ *
+ * @returns 如 "2026-06-21T12:34:56.789Z"
+ */
+export declare function nowIso(): string;
+/**
+ * 获取当前日期字符串（YYYY-MM-DD，本地时区）
+ *
+ * 使用本地时区日期，避免 UTC 偏移导致跨天错位
+ * （如 Asia/Shanghai 00:00-08:00 期间 UTC 仍是前一天，
+ * 会话文件会写入"昨天"导致跨天 reset 与 UI 错乱）
+ *
+ * @returns 如 "2026-06-21"
+ */
+export declare function todayDate(): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAMlC"}

package/dist/utils/time.js

@@ -0,0 +1,31 @@
+/**
+ * 时间工具函数
+ *
+ * 从 messageHistory.ts 提取的公共时间格式化函数，
+ * 消除跨模块 `new Date().toISOString()` 内联重复。
+ */
+/**
+ * 获取当前时间的 ISO 8601 时间戳
+ *
+ * @returns 如 "2026-06-21T12:34:56.789Z"
+ */
+export function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * 获取当前日期字符串（YYYY-MM-DD，本地时区）
+ *
+ * 使用本地时区日期，避免 UTC 偏移导致跨天错位
+ * （如 Asia/Shanghai 00:00-08:00 期间 UTC 仍是前一天，
+ * 会话文件会写入"昨天"导致跨天 reset 与 UI 错乱）
+ *
+ * @returns 如 "2026-06-21"
+ */
+export function todayDate() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils/toError.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 纯逻辑 toError — 零依赖，浏览器 / Node.js 通用
+ *
+ * 将 catch 块中的 unknown 值安全转换为 Error 对象。
+ * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging（pino）依赖。
+ *
+ * 转换规则：
+ * - Error 实例：原样返回
+ * - 对象且含 message 属性：包装为 Error
+ * - 其他：调用 String() 转为 message
+ */
+export declare function toError(err: unknown): Error;
+//# sourceMappingURL=toError.d.ts.map

package/dist/utils/toError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toError.d.ts","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAU3C"}

package/dist/utils/toError.js

@@ -0,0 +1,22 @@
+/**
+ * 纯逻辑 toError — 零依赖，浏览器 / Node.js 通用
+ *
+ * 将 catch 块中的 unknown 值安全转换为 Error 对象。
+ * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging（pino）依赖。
+ *
+ * 转换规则：
+ * - Error 实例：原样返回
+ * - 对象且含 message 属性：包装为 Error
+ * - 其他：调用 String() 转为 message
+ */
+export function toError(err) {
+    if (err instanceof Error)
+        return err;
+    if (typeof err === 'object' &&
+        err !== null &&
+        typeof err.message === 'string') {
+        return new Error(err.message);
+    }
+    return new Error(String(err));
+}
+//# sourceMappingURL=toError.js.map

package/dist/utils/toError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toError.js","sourceRoot":"","sources":["../../src/utils/toError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC;IACrC,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAA6B,CAAC,OAAO,KAAK,QAAQ,EAC1D,CAAC;QACD,OAAO,IAAI,KAAK,CAAE,GAA2B,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@zooique/memora",
+  "version": "0.1.0",
+  "description": "通用 Agent 架构（纯逻辑库）— 本地、私有、领域无关，万物皆记忆",
+  "type": "module",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "format": "prettier --write \"**/*.{ts,md,json}\"",
+    "format:check": "prettier --check \"**/*.{ts,md,json}\"",
+    "typecheck": "tsc --noEmit",
+    "prepare": "lefthook install || true",
+    "prepublishOnly": "npx rimraf dist && npm run build"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "agent",
+    "memory",
+    "llm",
+    "ai",
+    "local-first"
+  ],
+  "author": "Memora Contributors",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
+  "peerDependencies": {
+    "pino": ">=9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "pino": {
+      "optional": true
+    }
+  },
+
+  "devDependencies": {
+    "@commitlint/cli": "^21.0.2",
+    "@commitlint/config-conventional": "^21.0.2",
+    "@types/node": "^22.7.0",
+    "@typescript-eslint/eslint-plugin": "^8.8.0",
+    "@typescript-eslint/parser": "^8.8.0",
+    "@vitest/coverage-v8": "^4.1.8",
+    "eslint": "^9.12.0",
+    "lefthook": "^1.7.0",
+    "msw": "^2.4.0",
+    "pino-pretty": "^11.2.0",
+    "prettier": "^3.3.0",
+    "rimraf": "^6.1.3",
+    "tsc-alias": "^1.8.17",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.8"
+  }
+}