memorix 1.3.4 → 1.4.1

package/dist/sdk.js

@@ -32934,7 +32934,7 @@ var init_models_generated = __esm({
           provider: "minimax",
           baseUrl: "https://api.minimax.io/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -32987,7 +32987,7 @@ var init_models_generated = __esm({
           provider: "minimax-cn",
           baseUrl: "https://api.minimaxi.com/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -52262,11 +52262,11 @@ var init_simple_options = __esm({
 });
 
 // packages/ai/dist/providers/transform-messages.js
-function replaceImagesWithPlaceholder(content, placeholder) {
+function replaceMediaWithPlaceholder(content, dropType, placeholder) {
   const result = [];
   let previousWasPlaceholder = false;
   for (const block of content) {
-    if (block.type === "image") {
+    if (block.type === dropType) {
       if (!previousWasPlaceholder) {
         result.push({ type: "text", text: placeholder });
       }
@@ -52274,33 +52274,39 @@ function replaceImagesWithPlaceholder(content, placeholder) {
       continue;
     }
     result.push(block);
-    previousWasPlaceholder = block.text === placeholder;
+    previousWasPlaceholder = block.type === "text" && block.text === placeholder;
   }
   return result;
 }
-function downgradeUnsupportedImages(messages, model) {
-  if (model.input.includes("image")) {
+function downgradeUnsupportedMedia(messages, model) {
+  const supportsImage = model.input.includes("image");
+  const supportsVideo = model.input.includes("video");
+  if (supportsImage && supportsVideo) {
     return messages;
   }
   return messages.map((msg) => {
     if (msg.role === "user" && Array.isArray(msg.content)) {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_USER_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_USER_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_USER_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     if (msg.role === "toolResult") {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_TOOL_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_TOOL_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_TOOL_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     return msg;
   });
 }
 function transformMessages(messages, model, normalizeToolCallId2) {
   const toolCallIdMap = /* @__PURE__ */ new Map();
-  const imageAwareMessages = downgradeUnsupportedImages(messages, model);
+  const imageAwareMessages = downgradeUnsupportedMedia(messages, model);
   const transformed = imageAwareMessages.map((msg) => {
     if (msg.role === "user") {
       return msg;
@@ -52412,13 +52418,15 @@ function transformMessages(messages, model, normalizeToolCallId2) {
   insertSyntheticToolResults();
   return result;
 }
-var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER;
+var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER, NON_VISION_USER_VIDEO_PLACEHOLDER, NON_VISION_TOOL_VIDEO_PLACEHOLDER;
 var init_transform_messages = __esm({
   "packages/ai/dist/providers/transform-messages.js"() {
     "use strict";
     init_esm_shims();
     NON_VISION_USER_IMAGE_PLACEHOLDER = "(image omitted: model does not support images)";
     NON_VISION_TOOL_IMAGE_PLACEHOLDER = "(tool image omitted: model does not support images)";
+    NON_VISION_USER_VIDEO_PLACEHOLDER = "(video omitted: model does not support video)";
+    NON_VISION_TOOL_VIDEO_PLACEHOLDER = "(tool video omitted: model does not support video)";
   }
 });
 
@@ -52449,8 +52457,8 @@ function getCacheControl(model, cacheRetention) {
   };
 }
 function convertContentBlocks(content) {
-  const hasImages = content.some((c) => c.type === "image");
-  if (!hasImages) {
+  const hasMedia = content.some((c) => c.type === "image" || c.type === "video");
+  if (!hasMedia) {
     return sanitizeSurrogates(content.map((c) => c.text).join("\n"));
   }
   const blocks = content.map((block) => {
@@ -52460,6 +52468,16 @@ function convertContentBlocks(content) {
         text: sanitizeSurrogates(block.text)
       };
     }
+    if (block.type === "video") {
+      return {
+        type: "video",
+        source: {
+          type: "base64",
+          media_type: block.mimeType,
+          data: block.data
+        }
+      };
+    }
     return {
       type: "image",
       source: {
@@ -52473,7 +52491,7 @@ function convertContentBlocks(content) {
   if (!hasText) {
     blocks.unshift({
       type: "text",
-      text: "(see attached image)"
+      text: "(see attached media)"
     });
   }
   return blocks;
@@ -52823,6 +52841,15 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
               type: "text",
               text: sanitizeSurrogates(item.text)
             };
+          } else if (item.type === "video") {
+            return {
+              type: "video",
+              source: {
+                type: "base64",
+                media_type: item.mimeType,
+                data: item.data
+              }
+            };
           } else {
             return {
               type: "image",
@@ -52903,6 +52930,8 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
       toolResults.push({
         type: "tool_result",
         tool_use_id: msg.toolCallId,
+        // MiniMax's Anthropic-compatible API accepts video in tool results;
+        // the SDK's ToolResultBlockParam.content type predates video support.
         content: convertContentBlocks(msg.content),
         is_error: msg.isError
       });
@@ -52929,7 +52958,7 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
     if (lastMessage.role === "user") {
       if (Array.isArray(lastMessage.content)) {
         const lastBlock = lastMessage.content[lastMessage.content.length - 1];
-        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) {
+        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "video" || lastBlock.type === "tool_result")) {
           lastBlock.cache_control = cacheControl;
         }
       } else if (typeof lastMessage.content === "string") {
@@ -152679,6 +152708,7 @@ function compareDateStrings(a, b) {
 }
 function detectStaleProgressNotes(input) {
   const candidates = [
+    "ACTIVE_WORK.md",
     "progress.txt",
     "docs/dev-log/progress.txt",
     "docs/memcode/dev-log/progress.txt"
@@ -164129,7 +164159,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.3.4" : "1.0.1"
+    version: true ? "1.4.1" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {

package/dist/vector-backfill-runner.js

@@ -33079,7 +33079,7 @@ var init_models_generated = __esm({
           provider: "minimax",
           baseUrl: "https://api.minimax.io/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -33132,7 +33132,7 @@ var init_models_generated = __esm({
           provider: "minimax-cn",
           baseUrl: "https://api.minimaxi.com/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -52407,11 +52407,11 @@ var init_simple_options = __esm({
 });
 
 // packages/ai/dist/providers/transform-messages.js
-function replaceImagesWithPlaceholder(content, placeholder) {
+function replaceMediaWithPlaceholder(content, dropType, placeholder) {
   const result = [];
   let previousWasPlaceholder = false;
   for (const block of content) {
-    if (block.type === "image") {
+    if (block.type === dropType) {
       if (!previousWasPlaceholder) {
         result.push({ type: "text", text: placeholder });
       }
@@ -52419,33 +52419,39 @@ function replaceImagesWithPlaceholder(content, placeholder) {
       continue;
     }
     result.push(block);
-    previousWasPlaceholder = block.text === placeholder;
+    previousWasPlaceholder = block.type === "text" && block.text === placeholder;
   }
   return result;
 }
-function downgradeUnsupportedImages(messages, model) {
-  if (model.input.includes("image")) {
+function downgradeUnsupportedMedia(messages, model) {
+  const supportsImage = model.input.includes("image");
+  const supportsVideo = model.input.includes("video");
+  if (supportsImage && supportsVideo) {
     return messages;
   }
   return messages.map((msg) => {
     if (msg.role === "user" && Array.isArray(msg.content)) {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_USER_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_USER_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_USER_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     if (msg.role === "toolResult") {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_TOOL_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_TOOL_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_TOOL_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     return msg;
   });
 }
 function transformMessages(messages, model, normalizeToolCallId2) {
   const toolCallIdMap = /* @__PURE__ */ new Map();
-  const imageAwareMessages = downgradeUnsupportedImages(messages, model);
+  const imageAwareMessages = downgradeUnsupportedMedia(messages, model);
   const transformed = imageAwareMessages.map((msg) => {
     if (msg.role === "user") {
       return msg;
@@ -52557,13 +52563,15 @@ function transformMessages(messages, model, normalizeToolCallId2) {
   insertSyntheticToolResults();
   return result;
 }
-var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER;
+var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER, NON_VISION_USER_VIDEO_PLACEHOLDER, NON_VISION_TOOL_VIDEO_PLACEHOLDER;
 var init_transform_messages = __esm({
   "packages/ai/dist/providers/transform-messages.js"() {
     "use strict";
     init_esm_shims();
     NON_VISION_USER_IMAGE_PLACEHOLDER = "(image omitted: model does not support images)";
     NON_VISION_TOOL_IMAGE_PLACEHOLDER = "(tool image omitted: model does not support images)";
+    NON_VISION_USER_VIDEO_PLACEHOLDER = "(video omitted: model does not support video)";
+    NON_VISION_TOOL_VIDEO_PLACEHOLDER = "(tool video omitted: model does not support video)";
   }
 });
 
@@ -52594,8 +52602,8 @@ function getCacheControl(model, cacheRetention) {
   };
 }
 function convertContentBlocks(content) {
-  const hasImages = content.some((c) => c.type === "image");
-  if (!hasImages) {
+  const hasMedia = content.some((c) => c.type === "image" || c.type === "video");
+  if (!hasMedia) {
     return sanitizeSurrogates(content.map((c) => c.text).join("\n"));
   }
   const blocks = content.map((block) => {
@@ -52605,6 +52613,16 @@ function convertContentBlocks(content) {
         text: sanitizeSurrogates(block.text)
       };
     }
+    if (block.type === "video") {
+      return {
+        type: "video",
+        source: {
+          type: "base64",
+          media_type: block.mimeType,
+          data: block.data
+        }
+      };
+    }
     return {
       type: "image",
       source: {
@@ -52618,7 +52636,7 @@ function convertContentBlocks(content) {
   if (!hasText) {
     blocks.unshift({
       type: "text",
-      text: "(see attached image)"
+      text: "(see attached media)"
     });
   }
   return blocks;
@@ -52968,6 +52986,15 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
               type: "text",
               text: sanitizeSurrogates(item.text)
             };
+          } else if (item.type === "video") {
+            return {
+              type: "video",
+              source: {
+                type: "base64",
+                media_type: item.mimeType,
+                data: item.data
+              }
+            };
           } else {
             return {
               type: "image",
@@ -53048,6 +53075,8 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
       toolResults.push({
         type: "tool_result",
         tool_use_id: msg.toolCallId,
+        // MiniMax's Anthropic-compatible API accepts video in tool results;
+        // the SDK's ToolResultBlockParam.content type predates video support.
         content: convertContentBlocks(msg.content),
         is_error: msg.isError
       });
@@ -53074,7 +53103,7 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
     if (lastMessage.role === "user") {
       if (Array.isArray(lastMessage.content)) {
         const lastBlock = lastMessage.content[lastMessage.content.length - 1];
-        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) {
+        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "video" || lastBlock.type === "tool_result")) {
           lastBlock.cache_control = cacheControl;
         }
       } else if (typeof lastMessage.content === "string") {

package/docs/1.3.3-MULTIMODAL-MEDIA-AND-MCP-COMPAT.md

@@ -318,20 +318,20 @@ then document the 2026-07-28 migration boundary.
 - no personal Codex/Claude/OpenCode configuration mutation;
 - documentation and changelog reviewed.
 
-### Phase G: 1.3.4 hardening
+### Phase G: 1.3.4 hardening (completed 2026-08-02)
 
-1.3.4 is not a feature release. It exercises fresh install, Windows CLI
-windows-hide behavior, CLI/stdio/HTTP MCP routes, cancellation/restart of media
-jobs, quota cleanup, failure messages, and agent-facing UX. Only defects found
-through that work are fixed.
+1.3.4 exercised fresh install, Windows CLI windows-hide behavior,
+CLI/stdio/HTTP MCP routes, cancellation/restart of media jobs, quota cleanup,
+failure messages, and agent-facing UX. The resulting fixes are published in
+the 1.3.4 release notes and passed Windows and Ubuntu CI.
 
-### Phase H: 1.4 stable release
+### Phase H: 1.4 stable release (completed 2026-08-02)
 
-1.4 is cut only when 1.3.3 and 1.3.4 gates are green, all supported paths have
-packaged CLI evidence, the compatibility matrix is updated, and there is no
-known high-severity data-loss, credential-retention, Windows-popup, or MCP
-binding regression. “No bug” means no known release blocker after these tests,
-not an impossible claim of mathematical perfection.
+1.4.0 was cut after the 1.3.3 and 1.3.4 gates were green, supported paths had
+packaged CLI evidence, and no high-severity data-loss, credential-retention,
+Windows-popup, or MCP binding regression was known. “Stable” means no known
+release blocker after these tests, not an impossible claim of mathematical
+perfection.
 
 ## Acceptance criteria
 
@@ -351,8 +351,8 @@ not an impossible claim of mathematical perfection.
 8. No generated asset enters project memory without an explicit attach action.
 9. The same media action works through CLI and MCP using an explicit resolved
    project binding, independent of a legacy HTTP session identifier.
-10. 1.3.4 regression tests cover Windows, fresh package install, CLI, stdio,
-    HTTP MCP, quota cleanup, and error UX before 1.4 is published.
+10. 1.3.4 regression tests covered Windows, fresh package install, CLI, stdio,
+    HTTP MCP, quota cleanup, and error UX before 1.4.0 was published.
 
 ## Research and implementation basis
 

package/docs/API_REFERENCE.md

@@ -114,7 +114,7 @@ MCP:
 - `memorix_codegraph_status` returns provider/index counts for the current project.
 - `memorix_context_pack` builds a task-specific packet with reliable current memories, lower-trust unbound memories, current code facts, freshness warnings, suggested reads, and suggested verification.
 
-`memorix context` defaults to `--refresh auto`, so first use can seed Code State without a separate manual `memorix codegraph refresh`. Its brief puts live package/changelog/Git facts before memory hints and flags old `progress.txt` / dev-log notes as historical when they predate the latest changelog, so agents should treat current facts as the source of truth when files disagree. Task lenses keep the packet shaped to the work: bugfix briefs prefer failing tests and repros, release briefs prefer metadata/changelog/package checks, and onboarding briefs prefer docs and entry points while hiding unrelated suspect details. Continuation delivery is separate from the task lens: continuation language in `memorix_project_context` enables a bounded prior-work projection, and `memorix resume "..."` makes that choice explicit. It includes only the latest useful session summary, up to three readable durable memories, and at most one recent source-labelled compact checkpoint. Checkpoints are host lifecycle evidence, not durable memory or transcript backups; ordinary new tasks do not receive historical-session context. A completed MCP brief is the default retrieval boundary: search, detail, or Context Pack should expand it only for a named missing fact or an explicit request for deeper history. Use `--refresh never` for read-only inspection and `--refresh always` when you want to force a fresh scan.
+`memorix context` defaults to `--refresh auto`, so first use can seed Code State without a separate manual `memorix codegraph refresh`. Its brief puts live package/changelog/Git facts before memory hints and flags an old `ACTIVE_WORK.md`, legacy `progress.txt`, or legacy dev-log note as historical when it predates the latest changelog, so agents should treat current facts as the source of truth when files disagree. Task lenses keep the packet shaped to the work: bugfix briefs prefer failing tests and repros, release briefs prefer metadata/changelog/package checks, and onboarding briefs prefer docs and entry points while hiding unrelated suspect details. Continuation delivery is separate from the task lens: continuation language in `memorix_project_context` enables a bounded prior-work projection, and `memorix resume "..."` makes that choice explicit. It includes only the latest useful session summary, up to three readable durable memories, and at most one recent source-labelled compact checkpoint. Checkpoints are host lifecycle evidence, not durable memory or transcript backups; ordinary new tasks do not receive historical-session context. A completed MCP brief is the default retrieval boundary: search, detail, or Context Pack should expand it only for a named missing fact or an explicit request for deeper history. Use `--refresh never` for read-only inspection and `--refresh always` when you want to force a fresh scan.
 
 Project-specific generated, vendored, or cache paths can be excluded from Code State with `[codegraph].exclude_patterns` in `memorix.toml` or `~/.memorix/config.toml` (`codegraph.excludePatterns` in legacy YAML). User patterns extend the built-in excludes and are applied to indexing, Project Context suggested reads, and Context Pack suggested reads.
 

package/docs/KNOWN_ISSUES_AND_ROADMAP.md

@@ -1,149 +1,73 @@
-# Memorix 已知问题 & 未来路线图
+# Memorix 已知边界与路线图
 
-> 最后更新: 2026-03-09 (v1.0.0)
+> 最后审阅：2026-08-03（对照 v1.4.0）
 
----
+这份文档说明仍然成立的产品边界、风险和方向；它不是发布流水账。
 
-## 已知问题 & 限制
+- 已发布版本和每次修复的事实，以 [CHANGELOG](../CHANGELOG.md) 为准。
+- 当前正在进行的维护工作，以 [ACTIVE_WORK](../ACTIVE_WORK.md) 为准。
+- 可讨论、可订阅的后续事项，以 GitHub Open Issues 为准。
 
-### 🔴 严重
+---
 
-| # | 问题 | 影响 | 状态 |
-|---|------|------|------|
-| 1 | ~~**无文件锁**~~ — 多 Agent 同时写入 | 数据完整性 | ✅ v0.7.11 (`withFileLock` + `atomicWriteFile`) |
-| 2 | **Orama where 过滤不可靠** — 空 term + number filter 时结果可能不正确 | `compactDetail` 已绕过 (使用内存查找) | 已变通 |
+## 当前产品边界
 
-### 🟡 中等
+Memorix 是本地优先、可插拔的 Agent Memory 系统。它给不同 Agent 或同一 Agent 的新会话提供同一个项目记忆层，并把 CLI 作为最完整、最稳定的控制面；MCP 是面向 Agent 的受控入口，而不是唯一入口。
 
-| # | 问题 | 影响 | 状态 |
-|---|------|------|------|
-| 3 | **非 Git 项目的 projectId 不稳定** — 基于目录名，不同机器或路径会不同 | 数据隔离 | 未修复 |
-| 4 | ~~**retention 只有报告没有执行**~~ | 数据膨胀 | ✅ v0.7.11 (`archiveExpired` + `action="archive"`) |
-| 5 | ~~**实体抽取不支持中文标识符**~~ | 中文项目覆盖不足 | ✅ v0.7.11 (中文括号/反引号 + 因果语言) |
-| 6 | ~~**auto-relations 每次读取全图**~~ | 性能 | ✅ v0.7.11 (entityIndex O(1) 查找) |
-| 7 | **高重要性 observations 永远免疫** — gotcha/decision/trade-off 永不过期 | 数据膨胀 | 设计如此，需评估 |
+当前版本已经包括：
 
-### 🟢 轻微
+- 项目记忆、会话续接、任务透镜和按需展开的上下文；
+- 代码状态、知识库 / Wiki、知识图谱投影和工作流记录；
+- 受控的本地媒体资产库，可显式导入图片、音频、视频和 PDF，并保留来源、哈希、配额和删除审计；
+- 多 Agent 集成、hook、doctor / repair，以及可选择的后台维护；
+- SQLite 规范存储、可见性边界、保留策略和清理审计。
 
-| # | 问题 | 影响 | 状态 |
-|---|------|------|------|
-| 8 | ~~**Kiro/Trae Agent hooks 未实现**~~ | 功能缺失 | ✅ v0.9.12+ (Kiro/Trae/OpenCode/Gemini CLI 全部支持) |
-| 9 | **fastembed 首次使用需下载模型** — ~30MB，可能在网络不好时超时 | 用户体验 | 需用户显式安装 |
-| 10 | **npx 缓存可能损坏** — 见 `MODULE_NOT_FOUND chownr` 问题 | 安装体验 | 需文档说明 |
+这些能力并不等于“任何数据都会被自动收集”或“所有媒体都已经被模型理解”。Memorix 的默认边界是显式、可追溯、可清理，避免把无关聊天、任意本地文件或有成本的模型调用悄悄写入长期记忆。
 
 ---
 
-## 未来路线图
-
-### Phase 1: 稳定化 ✅
-- [x] Copilot Adapter 实现
-- [x] Antigravity Adapter 实现
-- [x] MCP Server 集成验证
-- [x] 753 测试通过 (v1.0.0)
-- [x] 开发文档编写
-- [x] README 优化 (中英双语, Antigravity 配置指南)
-- [x] npm 发布配置优化
-
-### Phase 2: 推广 & 用户获取
-- [ ] 社区推广 (Reddit, HN, X, Discord)
-- [ ] 技术博客文章
-- [ ] 演示视频
-- [ ] 与其他 MCP Server 项目的对比文档
-
-### Phase 3: Web Dashboard ✅
-- [x] 知识图谱可视化 (D3.js force graph)
-- [x] Observation 搜索/浏览 Web UI
-- [x] 记忆保留状态仪表板
-- [x] 跨项目记忆概览 (project switcher)
-
-### Phase 4: 功能增强 ✅
-- [x] 自动归档过期记忆 (`memorix_retention action="archive"`)
-- [x] 文件锁机制 (多进程安全)
-- [x] 搜索精确度优化 (fuzzy + field boosting)
-- [x] 中文实体抽取
-- [x] 图谱-记忆双向同步
-- [x] `memorix_transfer` — 导出/导入记忆 (JSON + Markdown)
-- [x] 记忆去重和冲突检测 (`memorix_deduplicate` + `memorix_consolidate`)
-- [x] LLM 增强模式 (压缩/重排序/写入时去重)
-
-### Phase 5: Agent 集成 ✅
-- [x] Kiro 完整支持
-- [x] Trae 支持
-- [x] OpenCode 支持
-- [x] Gemini CLI 支持
-- [x] Copilot hooks 支持
-- [x] 10 个 Agent 全覆盖
-
-### Phase 6: v1.0.0 特性 ✅
-- [x] 团队协作 (Agent注册/文件锁/任务板/消息)
-- [x] 工具合并 (41 → 22 默认)
-- [x] 启动自动清理 (归档 + LLM/Jaccard 去重)
-- [x] Mini-Skills (永久技能, 自动注入)
-- [x] 会话管理 (跨会话上下文注入)
-
-### Phase 7: 未来路线图
-- [ ] 多项目记忆关联搜索
-- [ ] LLM-based 实体抽取 (替代正则)
-- [ ] JetBrains AI 支持
-- [ ] VS Code + Continue.dev 支持
-- [ ] 自定义 embedding 模型支持
-- [ ] 记忆联邦协议 (跨团队共享)
+## 仍需注意的边界
+
+| 主题 | 现状 | 使用建议 |
+|---|---|---|
+| 项目绑定 | 没有可靠工作区根目录时，MCP 会等待显式根目录、MCP Roots 或会话启动，而不会猜测上一个项目。 | 这是防止跨项目读写的安全边界；首次接入时按客户端的项目根目录配置即可。 |
+| 向量与外部模型 | 可选嵌入提供商、网络和首次模型准备会影响写入或检索延迟。 | 不要把外部 API 的瞬时可用性当作本地数据是否已写入的唯一判断；先用 `memorix status` / `doctor` 看状态。 |
+| 媒体记忆 | 已有受控附件和元数据/向量基础，但 PDF 文本提取、音频转写、视频语义提取仍不是默认的全自动链路。 | 只导入确实需要长期复用的资产；不要把截图或工具输出当作默认记忆来源。 |
+| 图谱与 Wiki | 它们是从规范记忆和代码状态生成的可追溯投影，不是可任意编辑的 GraphRAG 数据库。 | 先写清楚有来源的知识和决策，让投影自然形成关联；不要把图谱当作另一份手工真相。 |
+| Agent 集成 | 上游客户端会改变 hook、MCP、配置文件和权限模型。 | 使用 `memorix doctor agents` 诊断，优先让 `setup` / `repair` 做非破坏性修复。 |
+| 大规模数据 | 保留、归档、去重和检索预算已存在，但上万至百万级数据仍需要按项目负载做容量验证。 | 为高增长项目配置明确的保留与清理策略，并关注 Dashboard / CLI 的审计信息。 |
 
 ---
 
-## 依赖关系
-
-### 运行时依赖
-| 包 | 版本 | 用途 |
-|---|------|------|
-| `@modelcontextprotocol/sdk` | ^latest | MCP 协议 SDK |
-| `@orama/orama` | ^latest | 全文/向量搜索 |
-| `gpt-tokenizer` | ^latest | Token 计数 |
-| `citty` | ^latest | CLI 框架 |
-| `@clack/prompts` | ^latest | CLI 交互提示 |
-| `zod` | ^3 | 参数验证 |
-
-### 可选依赖
-| 包 | 版本 | 用途 |
-|---|------|------|
-| `fastembed` | ^latest | 本地 ONNX embedding (384d)，需用户显式安装 |
-
-### 开发依赖
-| 包 | 版本 | 用途 |
-|---|------|------|
-| `vitest` | ^latest | 测试框架 |
-| `tsup` | ^latest | 打包构建 |
-| `typescript` | ^5 | 类型系统 |
+## 公开路线
 
----
+### 1. 稳定性与可操作性
+
+- 继续以 Windows、macOS/Linux、CLI、MCP、后台服务和全新安装作为发布门槛；
+- 保持 MCP 工具面小而按需展开，CLI 保持完整的管理和恢复能力；
+- 让配置迁移、诊断、修复和清理保持非破坏性、可解释、可回退。
+
+### 2. 记忆质量与知识工作区
 
-## 技术债务
+- 提高“新会话接手”时的相关性：先给简短进度卡，再按任务取详情；
+- 统一保留状态、归档、检索预算和 Dashboard 的解释，避免同一条记忆在不同入口显示不同状态；
+- 继续发展代码状态、知识库、Wiki、图谱和工作流之间的可追溯关联，而不是重复堆叠文本摘要。
 
-| 优先级 | 项目 | 说明 |
-|--------|------|------|
-| ~~P0~~ | ~~文件锁~~ | ~~✅ v0.7.11~~ |
-| ~~P1~~ | ~~自动归档~~ | ~~✅ v0.7.11~~ |
-| P1 | projectId 稳定性 | 非 Git 项目需要更好的识别策略 |
-| ~~P2~~ | ~~中文实体抽取~~ | ~~✅ v0.7.11~~ |
-| ~~P2~~ | ~~auto-relations 性能~~ | ~~✅ v0.7.11~~ |
-| P3 | Orama 持久化 | 考虑 Orama 的原生持久化而非每次重建 |
-| ~~P3~~ | ~~测试覆盖~~ | ~~✅ 753 tests, 56 files, 含 HTTP 集成测试~~ |
+### 3. 受控的多模态派生能力
+
+- 在现有资产生命周期之上评估 PDF 文本提取、音频转写、视频语义派生；
+- 每一类派生都必须有来源、成本边界、配额、删除联动和重建路径；
+- 不把“接受任意 URL / 任意文件”误宣传为完整多模态 RAG。
+
+### 4. Agent 生态与研究
+
+- 跟进受用户需求推动的集成，例如 [Qwen 自动 hooks](https://github.com/AVIDS2/memorix/issues/3) 与 [持久化 Agent 身份](https://github.com/AVIDS2/memorix/issues/49)；
+- 独立推进记忆能力的实证研究，例如[模型能力如何改变项目记忆收益与伤害边界](https://github.com/AVIDS2/memorix/issues/152)，不把研究假设当作产品已经证明的效果。
 
 ---
 
-## 历史重要事件
-
-| 日期 | 事件 |
-|------|------|
-| 2026-02-13 | Copilot Adapter 实现完成，274 测试全部通过 |
-| 2026-02-13 | Antigravity MCP 配置修复，Memorix MCP Server 首次成功运行 |
-| 2026-02-13 | 发现并修复 npx 缓存损坏问题 (MODULE_NOT_FOUND chownr) |
-| 2026-02-15 | 完成全部核心模块的深度代码审查 |
-| 2026-02-15 | 开发文档完成 (ARCHITECTURE, MODULES, DEVELOPMENT, DESIGN_DECISIONS, API_REFERENCE) |
-| 2026-02-24 | v0.7.8-0.7.10: Antigravity 兼容 + MCP roots + 中英双语文档 |
-| 2026-02-24 | v0.7.11: P0-P2 全部完成 (文件锁 + 搜索优化 + 自动归档 + 中文实体 + 性能优化 + 图谱同步) |
-| 2026-02-25 | v0.9.0-0.9.12: Hooks 系统全量修复 + 10 Agent 支持 |
-| 2026-02-28 | v0.9.25: Windsurf 兼容性修复 |
-| 2026-03-05 | v0.10.5: Antigravity/Claude Code hooks 修复 |
-| 2026-03-07 | v0.11.0: Mini-Skills + LLM 增强模式 |
-| 2026-03-09 | **v1.0.0**: 首个稳定版 — 22 工具 + 团队协作 + 自动清理 + 753 测试 |
+## 贡献与验证原则
+
+贡献会先检查三件事：是否符合当前存储/可见性/生命周期边界，是否能由 CLI 与 MCP 一致地使用，是否有可重复的测试或人工验证证据。功能方向有价值但架构已演进的 PR 会保留作者署名，并通过公开后续 Issue 延续，而不是悄悄重写或吞掉成果。
+
+历史版本、已解决问题和详细发布日期请查看 [CHANGELOG](../CHANGELOG.md)。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.3.4",
+  "version": "1.4.1",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,
@@ -44,6 +44,7 @@
     "README.zh-CN.md",
     "assets",
     "docs",
+    "!docs/dev-log",
     "!docs/memcode",
     "!docs/superpowers",
     "plugins",
@@ -69,9 +70,11 @@
     "generate:star-history": "node scripts/generate-star-history.mjs",
     "sync:mcp-registry": "node scripts/sync-mcp-registry-manifest.mjs",
     "check:mcp-registry": "node scripts/check-mcp-registry-manifest.mjs",
+    "sync:plugin-release": "node scripts/sync-plugin-release-manifests.mjs",
+    "check:plugin-release": "node scripts/sync-plugin-release-manifests.mjs --check",
     "audit:pi-upstream": "node scripts/pi-upstream-audit.mjs",
     "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run sync:mcp-registry && npm run check:mcp-registry && npm run build && npm test"
+    "prepublishOnly": "npm run sync:mcp-registry && npm run sync:plugin-release && npm run check:mcp-registry && npm run check:plugin-release && npm run build && npm test"
   },
   "keywords": [
     "mcp",

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.3.4",
+  "version": "1.4.1",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",