release: v0.2.0

Author: Zehee

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.2.0] - 2026-06-25
+
+### Added
+- MCP tools: `delete_theme` and `delete_search_view` (with optional `deleteRefinedTurns` cascade).
+- Visual dashboard: delete actions for themes and search views, read-only default for Markdown editors, Edit/Delete buttons in composer headers, scrollable Markdown preview, dynamic page title using workspace folder name, lightweight Markdown rendering.
+- Frontend refactor: dashboard `app.js` split into ES modules (`state.js`, `api.js`, `utils/helpers.js`, `utils/markdown.js`).
+
+### Changed
+- Markdown documents in the dashboard now render in read-only mode by default; editing requires clicking the Edit button.
+- Breadcrumbs root label now shows the actual workspace folder name.
+
 ## [0.1.2] - 2026-06-25
 
 ### Added
@@ -48,7 +61,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Improved `scripts/session-search-verify.mjs` with CLI/env args, safer parsing, and cleanup.
 - Updated READMEs to reflect npm-published status and setup command.
 
-[Unreleased]: https://github.com/Zehee/kimi-code-memory-mcp-server/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/Zehee/kimi-code-memory-mcp-server/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/Zehee/kimi-code-memory-mcp-server/releases/tag/v0.2.0
 [0.1.2]: https://github.com/Zehee/kimi-code-memory-mcp-server/releases/tag/v0.1.2
 [0.1.1]: https://github.com/Zehee/kimi-code-memory-mcp-server/releases/tag/v0.1.1
 [0.1.0]: https://github.com/Zehee/kimi-code-memory-mcp-server/releases/tag/v0.1.0

README.en.md

@@ -19,6 +19,8 @@ A local stdio MCP server that gives [Kimi Code CLI](https://github.com/MoonshotA
 - **Theme tracing** — associate conversation turns and memories with themes, then trace their evolution.
 - **Refined turn summaries** — reusable turn-level atomic summaries shared across themes.
 - **Rebuilding index** — `index.json` is a cache; `.md` files are the source of truth.
+- **Theme & search-view deletion** — remove low-quality themes or saved search views, optionally purging their refined turns.
+- **Dashboard enhancements** — dynamic workspace title, read-only Markdown viewer with lightweight rendering, delete actions.
 
 ## Theme Tracing
 
@@ -256,6 +258,9 @@ You can override the storage root with the `MEMORY_STORE_ROOT` environment varia
 | `tag_theme` | Associate a turn or memory with a theme |
 | `trace_theme` | Trace a theme's evolution |
 | `list_themes` | List themes |
+| `delete_theme` | Delete a theme association file |
+| `list_search_views` | List saved search views |
+| `delete_search_view` | Delete a saved search view (optionally purge referenced refined turns) |
 | `open_memory_dashboard` | Open the memory dashboard in the browser |
 | `refine_session_turns` | Generate refined turn summaries |
 
@@ -269,6 +274,8 @@ npx kimi-memory-vis
 
 It starts on `http://127.0.0.1:58628` and opens the browser automatically.
 
+The dashboard now renders Markdown documents in read-only mode by default; click **Edit** to modify. Other improvements include a scrollable Markdown preview, dynamic page title using the workspace folder name, and delete actions for themes and search views.
+
 To auto-start the dashboard when the MCP server starts:
 
 ```bash

README.md

@@ -20,6 +20,8 @@
 - **主题追溯** —— 将对话轮次和记忆关联到主题，并追踪其演化。
 - **精炼轮次摘要** —— 可在多个主题间共享的轮次级原子摘要。
 - **可重建索引** —— `index.json` 只是缓存，`.md` 文件才是真相来源。
+- **主题与搜索视图删除** —— 支持删除低质量主题或搜索视图，并可选择级联清理其关联的精炼轮次。
+- **可视化仪表盘增强** —— 工作区标题动态显示文件夹名、Markdown 默认只读、轻量级渲染预览、主题/搜索视图删除。
 
 ## 主题追溯
 
@@ -257,6 +259,10 @@ Agent：[调用 mcp__kimi-memory__tag_theme] theme=cache-design
 | `tag_theme` | 将轮次或记忆关联到主题 |
 | `trace_theme` | 追溯主题演化 |
 | `list_themes` | 列出主题 |
+| `delete_theme` | 删除主题关联文件 |
+| `list_search_views` | 列出保存的搜索视图 |
+| `delete_search_view` | 删除搜索视图（可选级联删除关联精炼轮次） |
+| `open_memory_dashboard` | 在浏览器中打开记忆仪表盘 |
 | `refine_session_turns` | 生成精炼轮次摘要 |
 
 ## Prompts
@@ -303,10 +309,13 @@ export KIMI_MEMORY_AUTO_VIS=1
 
 仪表盘支持：
 
-- 工作区概览与 `essence.md` 行内编辑
-- 主题时间线浏览
+- 工作区概览与 `essence.md` 浏览/编辑（默认只读，点击“编辑”后修改）
+- Markdown 文档轻量级渲染，超长内容自带滚动条
+- 主题时间线浏览与主题删除
+- 搜索视图列表与删除（支持仅删视图或级联清理精炼轮次）
 - 近期决策列表
 - 显式记忆目录浏览
+- 控制面板标题与面包屑根目录显示为用户工作区文件夹名
 
 ## 开发
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "kimi-code-memory-mcp-server",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Local stdio MCP server providing cross-session memory for Kimi Code CLI",
   "main": "dist/server.js",
   "types": "dist/server.d.ts",

restart-kimi-web.bat

@@ -0,0 +1,5 @@
+@echo off
+kimi server kill
+timeout /t 3 /nobreak >nul
+cd /d "D:\workspace\kimi-code-memory-mcp-server"
+start "" cmd /c "kimi web"

src/refine/store.ts

@@ -208,6 +208,20 @@ export class RefinedStore {
     return rows.map((r) => rowToTurn(r));
   }
 
+  deleteRefinedTurns(refs: Array<{ sessionId: string; turnId: number }>): number {
+    if (refs.length === 0) return 0;
+    const deleteStmt = this.db.prepare('DELETE FROM refined_turns WHERE session_id = ? AND turn_id = ?');
+    const transaction = this.db.transaction(() => {
+      let count = 0;
+      for (const ref of refs) {
+        const info = deleteStmt.run(ref.sessionId, ref.turnId);
+        count += info.changes;
+      }
+      return count;
+    });
+    return transaction();
+  }
+
   close(): void {
     this.db.close();
   }

src/refined-manager.ts

@@ -69,6 +69,12 @@ export class RefinedManager {
     return this.store.listRecentTurns(limit);
   }
 
+  async deleteRefinedTurns(refs: Array<{ sessionId: string; turnId: number }>): Promise<number> {
+    return this.mutex.runExclusive(() => {
+      return this.store.deleteRefinedTurns(refs);
+    });
+  }
+
   close(): void {
     this.store.close();
   }

src/theme-manager.ts

@@ -69,6 +69,13 @@ export class ThemeManager {
     fs.renameSync(tmpPath, filePath);
   }
 
+  deleteTheme(theme: string): boolean {
+    const filePath = this.themeFilePath(theme);
+    if (!fs.existsSync(filePath)) return false;
+    fs.unlinkSync(filePath);
+    return true;
+  }
+
   listThemes(): string[] {
     if (!fs.existsSync(this.themesRoot)) return [];
     return fs

src/tools/context-tools.ts

@@ -3,6 +3,7 @@
  */
 
 import type {
+  DeleteSearchViewArgs,
   ListSearchViewsArgs,
   LoadMoreContextArgs,
   LoadTurnContextArgs,
@@ -572,6 +573,50 @@ export function createContextTools(ctx: Ctx): ToolDefinition[] {
     });
   }
 
+  async function handleDeleteSearchView(args: DeleteSearchViewArgs) {
+    const key = typeof args.key === 'string' ? args.key.trim() : '';
+    if (!key) {
+      return toolResult({ success: false, error: 'Missing or invalid "key"' }, true);
+    }
+    const deleteRefinedTurns = args.deleteRefinedTurns === true;
+    const filePath = path.join(storeRoot, 'searches', `${key}.json`);
+    if (!fs.existsSync(filePath)) {
+      return toolResult({ success: false, error: 'Search view not found' }, true);
+    }
+
+    const refinedTurnsToDelete: Array<{ sessionId: string; turnId: number }> = [];
+    if (deleteRefinedTurns) {
+      try {
+        const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        const clusters = Array.isArray(data.clusters) ? data.clusters : [];
+        const seen = new Set<string>();
+        for (const cluster of clusters) {
+          const members = Array.isArray(cluster.members) ? cluster.members : [];
+          for (const m of members) {
+            if (m && typeof m.sessionId === 'string' && typeof m.turnId === 'number') {
+              const id = `${m.sessionId}:${m.turnId}`;
+              if (!seen.has(id)) {
+                seen.add(id);
+                refinedTurnsToDelete.push({ sessionId: m.sessionId, turnId: m.turnId });
+              }
+            }
+          }
+        }
+      } catch {
+        // Ignore parse errors and proceed with deleting the view file.
+      }
+    }
+
+    fs.unlinkSync(filePath);
+
+    let deletedRefinedTurns = 0;
+    if (deleteRefinedTurns && refinedTurnsToDelete.length > 0) {
+      deletedRefinedTurns = await refinedManager.deleteRefinedTurns(refinedTurnsToDelete);
+    }
+
+    return toolResult({ success: true, deletedRefinedTurns });
+  }
+
   const tools: ToolDefinition[] = [
     {
       name: 'load_workspace_context',
@@ -661,6 +706,23 @@ export function createContextTools(ctx: Ctx): ToolDefinition[] {
       },
       handler: adaptHandler(handleListSearchViews),
     },
+    {
+      name: 'delete_search_view',
+      description:
+        'Delete a saved search view. Set deleteRefinedTurns to true to also remove the refined turns referenced by this view (useful for purging low-quality refined data).',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          key: { type: 'string', description: 'Search view file key (e.g. search-abc123.json without extension)' },
+          deleteRefinedTurns: {
+            type: 'boolean',
+            description: 'If true, also delete all refined turns referenced by this view.',
+          },
+        },
+        required: ['key'],
+      },
+      handler: adaptHandler(handleDeleteSearchView),
+    },
     {
       name: 'load_turn_context',
       description:

src/tools/system-tools.ts

@@ -31,6 +31,8 @@ const ESSENCE = {
     '不强制模板：Agent 自行决定最终结构和章节。',
     '大小提示：工具校验并提示是否超过 15KB，但不阻止保存。',
     '工具不碰 memory/ 源文件：Agent 整理后如需清理或重写源记忆，自行调用 delete / remember。',
+    '剔除过时内容：整理时识别并移除已被后续决策覆盖、已失效或仅具临时价值的记忆。',
+    '生成精要后，你可以重新组织 memory/ 区的文件内容和目录结构（重命名、移动、合并、拆分），并自行调用 remember / move / delete 等工具执行。',
   ].join('\n'),
 };
 
@@ -164,16 +166,43 @@ export function createSystemTools(ctx: Ctx): ToolDefinition[] {
   async function handleBootstrapWorkspace(args: {
     detailed_rounds?: number;
     summary_rounds?: number;
+    force?: boolean;
   }) {
     await indexDao.reconcileIndex();
 
     const contextData = await buildWorkspaceContext(ctx, args);
     const existingEssence = loadEssenceFile();
     const config = loadMcpConfig();
 
+    // Defensive: if the host already loaded this session's turns (e.g. `kimi web`
+    // or `kimi -c`), skip returning them again to avoid context duplication.
+    let recentContext:
+      | (typeof contextData.recentContext & {
+          skipped?: boolean;
+          reason?: string;
+        })
+      | null = contextData.recentContext;
+    if (
+      recentContext &&
+      args.force !== true &&
+      (recentContext.totalTurns > 0 ||
+        recentContext.detailedRounds.length > 0 ||
+        recentContext.summaryRounds.length > 0)
+    ) {
+      recentContext = {
+        ...recentContext,
+        detailedRounds: [],
+        summaryRounds: [],
+        compactionSummaries: [],
+        skipped: true,
+        reason:
+          'Session already has turns; skipping detailed/summary rounds to avoid duplicating host-loaded context.',
+      };
+    }
+
     return toolResult({
       workspace: contextData.workspace,
-      recentContext: contextData.recentContext,
+      recentContext,
       essence: existingEssence
         ? {
             found: true,
@@ -273,6 +302,11 @@ export function createSystemTools(ctx: Ctx): ToolDefinition[] {
             type: 'number',
             description: 'Number of preceding rounds to return as summaries.',
           },
+          force: {
+            type: 'boolean',
+            description:
+              'If true, return recent context even when the current session already has turns.',
+          },
         },
       },
       handler: adaptHandler(handleBootstrapWorkspace),