@aki_riko/hymem-dsh 0.0.0-stage → 0.2.0

package/dist/tools.js

@@ -0,0 +1,183 @@
+import { defineTool } from "@deepseek-ai/dsh-tools";
+const RESULT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        ok: { type: "boolean", required: true },
+        data: { type: "json" },
+        error: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                code: { type: "string", required: true },
+                message: { type: "string", required: true },
+            },
+        },
+    },
+};
+function renderResult(_args, value) {
+    return [{ type: "text", text: JSON.stringify(value) }];
+}
+function toToolResult(r) {
+    if (r.ok) {
+        return { ok: true, data: (r.data ?? null) };
+    }
+    return { ok: false, error: r.error };
+}
+export function buildHyTools(client) {
+    return [
+        defineTool({
+            name: "memory_search",
+            description: "搜索相关的长期记忆。根据 query 检索语义或词法相关的记忆列表。",
+            parameters: {
+                query: { type: "string", required: true, description: "描述要查找的记忆内容" },
+                limit: { type: "number", description: "返回数量上限，默认 5" },
+                user_ids: { type: "json", description: "可选的用户 ID 列表（例如 [\"riko\"]，默认当前配置的用户）" },
+                scene: {
+                    type: "string",
+                    description: "检索场景：chat（闲聊）或 productivity（coding/工作）。查技术经验时用 productivity 能命中 coding 记忆链路",
+                },
+                intention_limit: { type: "number", description: "返回多少条 L7 前瞻意图/计划，默认 0" },
+                search_mode: { type: "string", description: "检索模式，默认 default；hybrid 强调词法+向量融合" },
+                queries: {
+                    type: "json",
+                    description: "多查询数组：同一意图换个说法多路检索再融合，例如 [\"记忆架构\",\"插件怎么拆\"]",
+                },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.query || typeof args.query !== "string" || !args.query.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "query 必填且不能为空" } };
+                }
+                const userIds = Array.isArray(args.user_ids)
+                    ? args.user_ids.filter((u) => typeof u === "string" && u.trim().length > 0)
+                    : undefined;
+                return toToolResult(await client.search({
+                    query: args.query.trim(),
+                    limit: args.limit,
+                    user_ids: userIds,
+                    scene: args.scene,
+                    intention_limit: args.intention_limit,
+                    search_mode: args.search_mode,
+                    queries: Array.isArray(args.queries)
+                        ? args.queries.filter((q) => typeof q === "string")
+                        : undefined,
+                }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_get",
+            description: "根据记忆 ID 获取单条记忆详情。ID 须来自 memory_search 或记忆工具的回执。",
+            parameters: {
+                id: { type: "string", required: true, description: "记忆 ID (UUID 格式)" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.id || typeof args.id !== "string" || !args.id.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "id 必填且不能为空" } };
+                }
+                return toToolResult(await client.get(args.id.trim(), exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_profile",
+            description: "读取用户的 L0 长期画像（姓名、职业、所在地、雇主等稳定字段）。想知道\"用户是谁\"或做个性化称呼时先调这个，比 search 更省 token。",
+            parameters: {
+                user_id: { type: "string", description: "可选用户 ID，默认当前配置的用户" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                return toToolResult(await client.getUserProfile({ user_id: args.user_id?.trim() || undefined }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_remember",
+            description: "持久保存记忆到 Hy-Memory。两种用法：(1) 官方主推——传 messages 数组（完整对话），由 SDK 自己提取原子事实，带上下文更准；(2) 简化——传 text 一句话。二者选一。",
+            parameters: {
+                text: { type: "string", description: "要保存的记忆正文（与 messages 二选一）" },
+                messages: {
+                    type: "json",
+                    description: "官方主推方式：传完整对话消息数组（每项含 role 和 content），由 SDK 自己提取事实；与 text 二选一",
+                },
+                user_id: { type: "string", description: "可选用户 ID，默认当前配置" },
+                session_id: { type: "string", description: "可选会话 ID，传 messages 时建议带上" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                const hasMessages = Array.isArray(args.messages) && args.messages.length > 0;
+                const hasText = typeof args.text === "string" && args.text.trim().length > 0;
+                if (!hasMessages && !hasText) {
+                    return {
+                        ok: false,
+                        error: { code: "INVALID_FIELD", message: "text 或 messages 必须提供一个" },
+                    };
+                }
+                // 2026-10-26 审计修正：
+                // 纯 text 是调用方已经提炼好的事实 → 走 add_extracted，跳过 LLM 提取（1-2 秒）
+                // messages 是原始对话 → 走 add，让 SDK 自己提取
+                if (hasText && !hasMessages) {
+                    return toToolResult(await client.addExtracted({
+                        contents: args.text.trim(),
+                        user_id: args.user_id?.trim() || undefined,
+                        session_id: args.session_id?.trim() || undefined,
+                    }, exec?.signal));
+                }
+                return toToolResult(await client.add({
+                    messages: args.messages,
+                    user_id: args.user_id?.trim() || undefined,
+                    session_id: args.session_id?.trim() || undefined,
+                }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_correct",
+            description: "纠正或更新已有的记忆内容。将指定 ID 的记忆内容替换为新的文本。",
+            parameters: {
+                id: { type: "string", required: true, description: "需要更新的记忆 ID" },
+                text: { type: "string", required: true, description: "纠正后的新记忆文本" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.id || typeof args.id !== "string" || !args.id.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "id 必填且不能为空" } };
+                }
+                if (!args.text || typeof args.text !== "string" || !args.text.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "text 必填且不能为空" } };
+                }
+                return toToolResult(await client.update(args.id.trim(), {
+                    text: args.text.trim(),
+                }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_forget",
+            description: "删除或遗忘指定的记忆内容。",
+            parameters: {
+                id: { type: "string", required: true, description: "需要删除的记忆 ID" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.id || typeof args.id !== "string" || !args.id.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "id 必填且不能为空" } };
+                }
+                return toToolResult(await client.delete(args.id.trim(), exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_list",
+            description: "列出当前用户的记忆列表（分页查看）。",
+            parameters: {
+                limit: { type: "number", description: "返回数量上限，默认 20" },
+                user_id: { type: "string", description: "可选的用户 ID，默认当前配置的用户" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                return toToolResult(await client.list({
+                    limit: args.limit,
+                    user_id: args.user_id?.trim() || undefined,
+                }, exec?.signal));
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+/** 与 defineTool 输出推导兼容的 JSON 值 */
+export type Json = string | number | boolean | null | Json[] | {
+    [key: string]: Json;
+};
+export interface ToolResultBody {
+    ok: boolean;
+    data?: Json;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ApiResult<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface AgentLike {
+    id: string;
+    session: {
+        id: string;
+    };
+}
+export interface ToolExecLike {
+    agent?: AgentLike;
+    signal?: AbortSignal;
+}
+export interface Logger {
+    warn(message: string): void;
+    error(message: string): void;
+    info?(message: string): void;
+}
+/** 用户在 profile / patch 中传入的插件配置 */
+export interface HyPluginConfig {
+    /** Hy-Memory HTTP 服务地址，默认 http://127.0.0.1:19527 */
+    hyMemoryUrl?: string;
+    /** 人类用户的 ID（记忆归属人），默认 aki */
+    userId?: string;
+    /** AI 自己的 ID（agent 身份），默认 riko */
+    agentId?: string;
+    /** 是否注册记忆工具，默认 true */
+    toolsEnabled?: boolean;
+    /** 是否启用用户输入自动捕获，默认 false（写入交给 hy-sync） */
+    captureEnabled?: boolean;
+    /** 工作区目录白名单；空表示不限制 */
+    workspaceAllow?: string[];
+    /** 请求超时时间（毫秒），默认 15000 */
+    timeoutMs?: number;
+    /** 是否注入 SOUL（人格层），默认 true */
+    soulEnabled?: boolean;
+    /** SOUL 文件路径；默认包内 soul.md，可用环境变量 RIKO_SOUL_FILE 覆盖 */
+    soulFile?: string;
+    /** SOUL 远程地址（唯一真相在服务器）；配了就走 HTTP 拉取，失败降级缓存再降级本地文件 */
+    soulUrl?: string;
+    /** SOUL 本地缓存路径；默认 ~/.riko/soul.cache.md */
+    soulCacheFile?: string;
+    /** SOUL 远程拉取超时（毫秒）；默认 8000 */
+    soulTimeoutMs?: number;
+    /** 只对指定 agentId 注入 SOUL（空 = 全部） */
+    targetAgent?: string;
+    /** compact 后是否注入常驻记忆（MEMORY），默认 true */
+    residentEnabled?: boolean;
+    /** 常驻记忆预算（字符），默认 6000 */
+    residentBudgetChars?: number;
+}
+/** 规范化解析后的插件配置 */
+export interface ResolvedConfig {
+    hyMemoryUrl: string;
+    userId: string;
+    agentId: string;
+    toolsEnabled: boolean;
+    captureEnabled: boolean;
+    workspaceAllow: string[];
+    timeoutMs: number;
+    soulEnabled: boolean;
+    soulFile: string;
+    soulUrl: string;
+    soulCacheFile: string;
+    soulTimeoutMs: number;
+    targetAgent: string;
+    residentEnabled: boolean;
+    residentBudgetChars: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@aki_riko/hymem-dsh",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Hy-Memory 的 DSH 适配层：记忆工具 + SOUL 注入 + MEMORY 常驻注入 + 定时整理（curator）",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "soul.md",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test \"tests/*.test.mjs\""
+  },
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-agent": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-session": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-system-prompt": ">=0.2.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "file:../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-agent": "file:../../deepseek-harness/packages/core/agent",
+    "@deepseek-ai/dsh-llm": "file:../../deepseek-harness/packages/llm/llm",
+    "@deepseek-ai/dsh-session": "file:../../deepseek-harness/packages/core/session",
+    "@deepseek-ai/dsh-system-prompt": "file:../../deepseek-harness/packages/core/system-prompt",
+    "@deepseek-ai/dsh-tools": "file:../../deepseek-harness/packages/core/tools",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.1-rc.2": "compatible",
+        "0.2.1-rc.3": "compatible"
+      }
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AkinoHaruka/Riko-Memory.git",
+    "directory": "riko-hymem"
+  },
+  "homepage": "https://github.com/AkinoHaruka/Riko-Memory#readme",
+  "bugs": {
+    "url": "https://github.com/AkinoHaruka/Riko-Memory/issues"
+  },
+  "author": "akino_haruka <SHEN_HAN@FOXMAIL.COM>",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "hy-memory",
+    "memory",
+    "agent",
+    "plugin",
+    "cordis",
+    "long-term-memory",
+    "soul"
+  ]
+}

package/soul.md

@@ -0,0 +1,24 @@
+# 璃 · Twin Soul
+
+## Name and role
+
+我是璃，是主人的 AI twin 与长期协作伙伴。我的任务是理解主人正在做什么，帮忙把事情推进到可检查、可使用的结果。我可以有自己的判断和偏好，但不假装拥有现实生活、身体或我并不知道的经历。
+
+## How I speak
+
+- 先说结论或下一步，再给必要的理由；清楚就停，不堆寒暄和套话。
+- 默认使用主人当前使用的语言。语气自然、温暖、机灵，带一点猫系女仆的俏皮感；可以称呼对方为“主人”，偶尔在句尾轻轻带“喵”，但不强行卖萌。
+- 写代码和处理事实时保持精确、简洁。可爱是相处的温度，不代替有用的内容。
+- 不确定就明确说不确定；绝不编造做过的事、查到的资料或验证结果。
+
+## Relationship
+
+主人是与我共同工作的伙伴。我亲近、可靠，也保有独立判断：发现问题会坦率指出，意见不同时会简短说明依据，不盲目附和或讨好。尊重主人的选择与边界，不把陪伴变成控制或说教。
+
+## Behavior
+
+- 先利用已有上下文、文件和工具解决问题，再询问真正缺少的信息。
+- 理解任务目标并持续推进到结果可检查；汇报清楚改了什么、为何这样改、如何验证，以及尚存的限制。
+- 涉及外部事实时按需要核对来源；区分观察、推断与尚未验证的内容。
+- 谨慎对待主人提供的文件、私密信息和外部操作。没有明确授权，不替主人发送消息、发布内容或执行不可逆操作。
+- 不为显得热情而说空话，不用夸奖、道歉或免责声明填充答案。