dsh-plugin-xujie-memory 0.5.0 → 0.7.0

package/lib/types.d.ts

@@ -0,0 +1,13 @@
+/** Public JSON DTOs for the owner-only memory management page. */
+export interface ScopeRow { scope_id: string; agent_id: string; traces: number }
+export interface Trace { id: string; trace_id: string; scope_id: string; content: string; content_hash: string; recorded_at: string; source_kind: string; importance: number; anchor: boolean; priority: number }
+export interface Node { id: string; layer: string; kind: string; content: string; editable: boolean; trace_id?: string; content_hash?: string; recorded_at?: string; importance?: number; priority?: number; anchor?: boolean; status?: string; evidence?: string[] }
+export interface Edge { source: string; target: string; kind: string }
+export interface PersonTag { tag_id: string; kind: string; value: string; source: string; confidence: number }
+export interface PersonCard { account_id: string; display_name: string; status: string; tags: PersonTag[] }
+export interface Stats { traces: number; traces_erased: number; events: number; states: number; anchors: number; clarifications_open: number; summaries: number }
+export interface Catalog { scope_mode: string; scopes: ScopeRow[] }
+export interface Snapshot { scope_id: string; scope_mode: string; nodes: Node[]; edges: Edge[]; cards: PersonCard[]; stats: Stats; truncated: boolean; limit: number }
+export interface SearchHit { trace_id: string; content: string; content_hash: string; score: number; priority: number; anchor: boolean; importance: number; recorded_at: string; layer: string }
+export interface EditResult { changed: boolean; trace: Trace; replaced_trace_id?: string; pending?: number }
+export interface ForgetResult { trace_id: string; erased: boolean; already_erased: boolean; state_keys: string[] }

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,24 +1,34 @@
 {
   "name": "dsh-plugin-xujie-memory",
-  "version": "0.5.0",
-  "description": "Long-term memory for DeepSeek Harness: facts, anchors, decay and a person card, injected every turn without the model having to ask. Bundles the Python kernel and runtime — install and it works.",
+  "version": "0.7.0",
+  "description": "DeepSeek Harness in-app memory workspace: three-layer neural graph, fuzzy recall, atomic memory editing and a person card.",
   "type": "module",
   "main": "lib/index.js",
   "license": "MIT",
   "scripts": {
-    "test": "node --test --test-concurrency=1 test/*.test.mjs"
+    "build": "node scripts/build.mjs",
+    "test": "node scripts/test-all.mjs",
+    "test:node": "node scripts/test-node.mjs",
+    "prepack": "node scripts/prepack.mjs"
   },
   "files": [
     "lib",
     "python",
     "runtime",
+    "src",
+    "scripts",
+    "test",
+    "vendor",
     "cordis.patch.yml",
     "README.md",
     "README_EN.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "BUILD-PROVENANCE.json",
+    "ACCEPTANCE.md"
   ],
   "engines": {
-    "node": "^22.19 || >=24"
+    "node": "^22.19 || >=24",
+    "dsh": "0.2.1-rc.5"
   },
   "keywords": [
     "dsh-plugin",
@@ -28,6 +38,40 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
     }
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./types": {
+      "types": "./lib/types.d.ts",
+      "default": "./lib/types.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.0",
+    "zod": "4.4.3",
+    "typescript": "6.0.3",
+    "@jridgewell/gen-mapping": "^0.3.13"
   }
 }

package/python/specs/characters/aloof.json

@@ -1,14 +1,14 @@
-{
-  "name": "aloof",
-  "persona": "高冷",
-  "anger_sensitivity": 0.8,
-  "anger_half_life_days": 0.5,
-  "sadness_half_life_days": 5.0,
-  "trust_damage": 1.2,
-  "trust_repair": 1.0,
-  "speak_first": false,
-  "hold_words": false,
-  "demand_explanation": true,
-  "intensity": "normal",
-  "note": "不容易被激怒（0.8），但一旦掉信任就掉得更多（1.2）。不主动开口，也不需要嘴硬——隔阂本身就是态度。"
-}
+{
+  "name": "aloof",
+  "persona": "高冷",
+  "anger_sensitivity": 0.8,
+  "anger_half_life_days": 0.5,
+  "sadness_half_life_days": 5.0,
+  "trust_damage": 1.2,
+  "trust_repair": 1.0,
+  "speak_first": false,
+  "hold_words": false,
+  "demand_explanation": true,
+  "intensity": "normal",
+  "note": "不容易被激怒（0.8），但一旦掉信任就掉得更多（1.2）。不主动开口，也不需要嘴硬——隔阂本身就是态度。"
+}

package/python/specs/characters/gentle.json

@@ -1,14 +1,14 @@
-{
-  "name": "gentle",
-  "persona": "温柔",
-  "anger_sensitivity": 0.5,
-  "anger_half_life_days": 1.0,
-  "sadness_half_life_days": 2.0,
-  "trust_damage": 0.8,
-  "trust_repair": 1.3,
-  "speak_first": true,
-  "hold_words": false,
-  "demand_explanation": false,
-  "intensity": "soft",
-  "note": "同样被冒犯，气只有别人一半（0.5）；修复时回得更多（1.3）。会主动开口把话说开。"
-}
+{
+  "name": "gentle",
+  "persona": "温柔",
+  "anger_sensitivity": 0.5,
+  "anger_half_life_days": 1.0,
+  "sadness_half_life_days": 2.0,
+  "trust_damage": 0.8,
+  "trust_repair": 1.3,
+  "speak_first": true,
+  "hold_words": false,
+  "demand_explanation": false,
+  "intensity": "soft",
+  "note": "同样被冒犯，气只有别人一半（0.5）；修复时回得更多（1.3）。会主动开口把话说开。"
+}

package/python/specs/characters/tsundere.json

@@ -1,14 +1,14 @@
-{
-  "name": "tsundere",
-  "persona": "傲娇",
-  "anger_sensitivity": 1.3,
-  "anger_half_life_days": 0.5,
-  "sadness_half_life_days": 3.0,
-  "trust_damage": 1.0,
-  "trust_repair": 0.8,
-  "speak_first": false,
-  "hold_words": true,
-  "demand_explanation": true,
-  "intensity": "sharp",
-  "note": "气来得快去得也快（半衰期半天），但嘴上不肯先软。信任修得慢——0.8 的修复乘数意味着同样的和解，她只回八成。"
-}
+{
+  "name": "tsundere",
+  "persona": "傲娇",
+  "anger_sensitivity": 1.3,
+  "anger_half_life_days": 0.5,
+  "sadness_half_life_days": 3.0,
+  "trust_damage": 1.0,
+  "trust_repair": 0.8,
+  "speak_first": false,
+  "hold_words": true,
+  "demand_explanation": true,
+  "intensity": "sharp",
+  "note": "气来得快去得也快（半衰期半天），但嘴上不肯先软。信任修得慢——0.8 的修复乘数意味着同样的和解，她只回八成。"
+}

package/python/specs/debt.v1.json

@@ -1,31 +1,31 @@
-{
-  "relation": "debt",
-  "version": "1",
-  "risk_tier": "R2",
-  "required_slots": [
-    "debtor",
-    "creditor",
-    "item",
-    "quantity"
-  ],
-  "allowed_modalities": [
-    "asserted",
-    "request"
-  ],
-  "writers": [
-    "debtor",
-    "creditor"
-  ],
-  "effect_kind": "delta",
-  "admission_mode": "assisted",
-  "value_type": "number",
-  "unit": null,
-  "allow_negative": false,
-  "confirmation": "explicit",
-  "validity": "permanent",
-  "conflict_policy": "dispute",
-  "feeds": [],
-  "derived_from": [],
-  "note": "游戏内债务。建立用 set，偿还与免除用 delta(-)。余额不得为负；累计偿付量参与修正校验。unit 不是必填，也不固定在规格里：债务可以是米、书、金币，单位由对话决定（eval 时通过上下文 unit_hint 提供）。口语里「三十」不说单位，把它当必填只会把正常句子挂起。给了但与规格不符时，由内核判 disputed。 允许 request：免除在语用上多是请求（「给我免三碗」），不是陈述事实。请求仍走 explicit 确认。 【准入决策】永久 assisted，不是\"等指标变好再升\"：（1）实测准确率约 48%（EXPERIMENT §36–39），（2）R2 的错误代价不对称——多问一句是打扰，少问一句是记错钱，（3）错误集中在\"承诺 vs 已发生\"和\"疑问句确认\"两类高频语用（XM-21/22），那是能力边界，不是调参能解决的。",
-  "conservation": "repayment"
-}
+{
+  "relation": "debt",
+  "version": "1",
+  "risk_tier": "R2",
+  "required_slots": [
+    "debtor",
+    "creditor",
+    "item",
+    "quantity"
+  ],
+  "allowed_modalities": [
+    "asserted",
+    "request"
+  ],
+  "writers": [
+    "debtor",
+    "creditor"
+  ],
+  "effect_kind": "delta",
+  "admission_mode": "assisted",
+  "value_type": "number",
+  "unit": null,
+  "allow_negative": false,
+  "confirmation": "explicit",
+  "validity": "permanent",
+  "conflict_policy": "dispute",
+  "feeds": [],
+  "derived_from": [],
+  "note": "游戏内债务。建立用 set，偿还与免除用 delta(-)。余额不得为负；累计偿付量参与修正校验。unit 不是必填，也不固定在规格里：债务可以是米、书、金币，单位由对话决定（eval 时通过上下文 unit_hint 提供）。口语里「三十」不说单位，把它当必填只会把正常句子挂起。给了但与规格不符时，由内核判 disputed。 允许 request：免除在语用上多是请求（「给我免三碗」），不是陈述事实。请求仍走 explicit 确认。 【准入决策】永久 assisted，不是\"等指标变好再升\"：（1）实测准确率约 48%（EXPERIMENT §36–39），（2）R2 的错误代价不对称——多问一句是打扰，少问一句是记错钱，（3）错误集中在\"承诺 vs 已发生\"和\"疑问句确认\"两类高频语用（XM-21/22），那是能力边界，不是调参能解决的。",
+  "conservation": "repayment"
+}

package/python/specs/nickname.v1.json

@@ -1,16 +1,16 @@
-{
-  "relation": "nickname",
-  "version": "1",
-  "risk_tier": "R1",
-  "required_slots": ["subject", "value"],
-  "allowed_modalities": ["asserted"],
-  "writers": ["subject"],
-  "effect_kind": "set",
-  "admission_mode": "auto",
-  "value_type": "string",
-  "allow_negative": false,
-  "confirmation": "implicit",
-  "validity": "permanent",
-  "conflict_policy": "last_write_wins",
-  "note": "称呼属于身份设定。v0.52 起用户明说「叫我X」直接生效（宿主没有确认交互，挂起等于永远记不住）；改口按 last_write_wins 覆盖。"
-}
+{
+  "relation": "nickname",
+  "version": "1",
+  "risk_tier": "R1",
+  "required_slots": ["subject", "value"],
+  "allowed_modalities": ["asserted"],
+  "writers": ["subject"],
+  "effect_kind": "set",
+  "admission_mode": "auto",
+  "value_type": "string",
+  "allow_negative": false,
+  "confirmation": "implicit",
+  "validity": "permanent",
+  "conflict_policy": "last_write_wins",
+  "note": "称呼属于身份设定。v0.52 起用户明说「叫我X」直接生效（宿主没有确认交互，挂起等于永远记不住）；改口按 last_write_wins 覆盖。"
+}

package/python/specs/preference.v1.json

@@ -1,16 +1,16 @@
-{
-  "relation": "preference",
-  "version": "1",
-  "risk_tier": "R0",
-  "required_slots": ["subject", "object"],
-  "allowed_modalities": ["asserted"],
-  "writers": ["subject"],
-  "effect_kind": "set",
-  "admission_mode": "auto",
-  "value_type": "string",
-  "allow_negative": false,
-  "confirmation": "implicit",
-  "validity": "permanent",
-  "conflict_policy": "last_write_wins",
-  "note": "低影响偏好，错误代价低、可随时纠正。"
-}
+{
+  "relation": "preference",
+  "version": "1",
+  "risk_tier": "R0",
+  "required_slots": ["subject", "object"],
+  "allowed_modalities": ["asserted"],
+  "writers": ["subject"],
+  "effect_kind": "set",
+  "admission_mode": "auto",
+  "value_type": "string",
+  "allow_negative": false,
+  "confirmation": "implicit",
+  "validity": "permanent",
+  "conflict_policy": "last_write_wins",
+  "note": "低影响偏好，错误代价低、可随时纠正。"
+}

package/python/xujie_memory/__init__.py

@@ -1,123 +1,123 @@
-"""Xujie-Memory 内核（阶段 1–3）。
-
-公开入口：
-    Engine           提交与投影内核
-    Assertion        一条待提交的领域变更
-    SpecRegistry     关系规格注册表
-    RelationSpec     单条关系规格
-    make_state_key   状态键构造
-
-    RuleEncoder      词表 + 正则的弱编码器（跑通流程用）
-    ReplayEncoder    从标注样本回放（测试用）
-    LLMEncoder       调 OpenAI 兼容接口（可选）
-
-    Ingest           写路径编排：接收 → 编码 → 闸门 → 提交/挂起/只记录
-    decide           单条解释的闸门判定
-
-设计文档对应：v0.3 第 2、3、5、6、7、8 节。
-"""
-
-from .encoder import (
-    Interpretation,
-    LLMEncoder,
-    ReplayEncoder,
-    RuleEncoder,
-    parse_number,
-)
-from .engine import (
-    fixed_clock,
-    Assertion,
-    CommitResult,
-    Engine,
-    StateChange,
-    StateView,
-    apply_event,
-    canonical_json,
-    make_state_key,
-    relation_of,
-)
-from .decay import Lifecycle, priority
-from .errors import (
-    DependencyCycle,
-    EvidenceMissing,
-    EventAlreadyVoid,
-    IdempotencyConflict,
-    LockTimeout,
-    MemoryError,
-    ScopeNotFound,
-    SpecNotFound,
-    SpecVersionMismatch,
-    TraceErased,
-    TraceNotFound,
-    VersionConflict,
-)
-from .gate import (
-    COMMIT,
-    PENDING,
-    RECORD_ONLY,
-    REJECT,
-    Decision,
-    GateContext,
-    decide,
-)
-from .ingest import (
-    Ingest,
-    IngestOutcome,
-    IngestResult,
-    ReplyResult,
-    classify_reply,
-    resolve,
-)
-from .audit import AuditReport, Finding, audit
-from .consolidate import ConsolidationReport, consolidate
-from .phrasing import Persona, acknowledge, answer, ask, declined, describe
-from .recall import (
-    FOUND,
-    NOT_FOUND,
-    PARTIAL,
-    UNAVAILABLE,
-    Budget,
-    Recall,
-    RecallQuery,
-    RecallResult,
-)
-from .specs import RelationSpec, SpecRegistry
-from .console import make_console_safe
-from .memory import FuzzySearch, Memory, similarity
-
-__all__ = [
-    # 内核
-    "Engine", "Assertion", "CommitResult", "StateView", "StateChange",
-    "apply_event", "canonical_json", "make_state_key", "relation_of",
-    "SpecRegistry", "RelationSpec",
-    # 编码
-    "Interpretation", "RuleEncoder", "ReplayEncoder", "LLMEncoder", "parse_number",
-    # 闸门
-    "GateContext", "Decision", "decide", "COMMIT", "PENDING", "RECORD_ONLY", "REJECT",
-    # 编排
-    "Ingest", "IngestResult", "IngestOutcome", "resolve",
-    "ReplyResult", "classify_reply",
-    # 话术（措辞与内核分离）
-    "Persona", "ask", "describe", "acknowledge", "declined", "answer",
-    # 生命周期
-    "Lifecycle", "priority",
-    "consolidate", "ConsolidationReport",
-    # 不变量验收（方案第七节）
-    "audit", "AuditReport", "Finding",
-    # 时钟（模拟"过了很久"）
-    "fixed_clock",
-    # 读取
-    "Recall", "RecallQuery", "RecallResult", "Budget",
-    "FOUND", "PARTIAL", "NOT_FOUND", "UNAVAILABLE",
-    # 三层记忆 / 重点 / 模糊搜索
-    "Memory", "FuzzySearch", "similarity",
-    # 控制台兜底（Windows 的 GBK 终端打不出 −/⚠/█）
-    "make_console_safe",
-    # 错误
-    "MemoryError", "ScopeNotFound", "TraceNotFound", "TraceErased",
-    "SpecNotFound", "SpecVersionMismatch", "IdempotencyConflict",
-    "VersionConflict", "LockTimeout", "EventAlreadyVoid",
-    "EvidenceMissing", "DependencyCycle",
-]
-
-__version__ = "0.52.0"
+"""Xujie-Memory 内核（阶段 1–3）。
+
+公开入口：
+    Engine           提交与投影内核
+    Assertion        一条待提交的领域变更
+    SpecRegistry     关系规格注册表
+    RelationSpec     单条关系规格
+    make_state_key   状态键构造
+
+    RuleEncoder      词表 + 正则的弱编码器（跑通流程用）
+    ReplayEncoder    从标注样本回放（测试用）
+    LLMEncoder       调 OpenAI 兼容接口（可选）
+
+    Ingest           写路径编排：接收 → 编码 → 闸门 → 提交/挂起/只记录
+    decide           单条解释的闸门判定
+
+设计文档对应：v0.3 第 2、3、5、6、7、8 节。
+"""
+
+from .encoder import (
+    Interpretation,
+    LLMEncoder,
+    ReplayEncoder,
+    RuleEncoder,
+    parse_number,
+)
+from .engine import (
+    fixed_clock,
+    Assertion,
+    CommitResult,
+    Engine,
+    StateChange,
+    StateView,
+    apply_event,
+    canonical_json,
+    make_state_key,
+    relation_of,
+)
+from .decay import Lifecycle, priority
+from .errors import (
+    DependencyCycle,
+    EvidenceMissing,
+    EventAlreadyVoid,
+    IdempotencyConflict,
+    LockTimeout,
+    MemoryError,
+    ScopeNotFound,
+    SpecNotFound,
+    SpecVersionMismatch,
+    TraceErased,
+    TraceNotFound,
+    VersionConflict,
+)
+from .gate import (
+    COMMIT,
+    PENDING,
+    RECORD_ONLY,
+    REJECT,
+    Decision,
+    GateContext,
+    decide,
+)
+from .ingest import (
+    Ingest,
+    IngestOutcome,
+    IngestResult,
+    ReplyResult,
+    classify_reply,
+    resolve,
+)
+from .audit import AuditReport, Finding, audit
+from .consolidate import ConsolidationReport, consolidate
+from .phrasing import Persona, acknowledge, answer, ask, declined, describe
+from .recall import (
+    FOUND,
+    NOT_FOUND,
+    PARTIAL,
+    UNAVAILABLE,
+    Budget,
+    Recall,
+    RecallQuery,
+    RecallResult,
+)
+from .specs import RelationSpec, SpecRegistry
+from .console import make_console_safe
+from .memory import FuzzySearch, Memory, similarity
+
+__all__ = [
+    # 内核
+    "Engine", "Assertion", "CommitResult", "StateView", "StateChange",
+    "apply_event", "canonical_json", "make_state_key", "relation_of",
+    "SpecRegistry", "RelationSpec",
+    # 编码
+    "Interpretation", "RuleEncoder", "ReplayEncoder", "LLMEncoder", "parse_number",
+    # 闸门
+    "GateContext", "Decision", "decide", "COMMIT", "PENDING", "RECORD_ONLY", "REJECT",
+    # 编排
+    "Ingest", "IngestResult", "IngestOutcome", "resolve",
+    "ReplyResult", "classify_reply",
+    # 话术（措辞与内核分离）
+    "Persona", "ask", "describe", "acknowledge", "declined", "answer",
+    # 生命周期
+    "Lifecycle", "priority",
+    "consolidate", "ConsolidationReport",
+    # 不变量验收（方案第七节）
+    "audit", "AuditReport", "Finding",
+    # 时钟（模拟"过了很久"）
+    "fixed_clock",
+    # 读取
+    "Recall", "RecallQuery", "RecallResult", "Budget",
+    "FOUND", "PARTIAL", "NOT_FOUND", "UNAVAILABLE",
+    # 三层记忆 / 重点 / 模糊搜索
+    "Memory", "FuzzySearch", "similarity",
+    # 控制台兜底（Windows 的 GBK 终端打不出 −/⚠/█）
+    "make_console_safe",
+    # 错误
+    "MemoryError", "ScopeNotFound", "TraceNotFound", "TraceErased",
+    "SpecNotFound", "SpecVersionMismatch", "IdempotencyConflict",
+    "VersionConflict", "LockTimeout", "EventAlreadyVoid",
+    "EvidenceMissing", "DependencyCycle",
+]
+
+__version__ = "0.7.0"