oc-tweaks 0.1.3 → 0.2.0

package/README.md

@@ -11,6 +11,7 @@ A collection of runtime enhancement plugins for [OpenCode](https://opencode.ai/)
 The currently available plugins are:
 - **`notify`**: Sends desktop notifications when a task is completed or an error occurs.
 - **`compaction`**: Injects a language preference prompt during session compaction to ensure summaries are in your preferred language.
+- **`autoMemory`**: Smart memory assistant that injects memory context, detects memory trigger phrases, and supports active memory writes via `remember` tool and `/remember` command.
 - **`backgroundSubagent`**: Adds a system prompt to encourage using background sub-agents for better responsiveness.
 - **`leaderboard`**: Reports token usage to [claudecount.com](https://claudecount.com) for community leaderboards.
 
@@ -96,6 +97,20 @@ This plugin ensures that when OpenCode compacts a session's context, the resulti
 |---|---|---|---|
 | `enabled` | boolean | `true` | Enable or disable the plugin. |
 
+### `autoMemory`
+
+This plugin provides an intelligent memory workflow:
+- Injects global/project memory context into system prompt.
+- Adds trigger phrases (Chinese + English) so the assistant remembers when to persist key information.
+- Registers a custom `remember` tool for active memory writes.
+- Creates `~/.config/opencode/commands/remember.md` automatically (if missing) so users can run `/remember` explicitly.
+
+**Configuration Options:**
+
+| Property | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | boolean | `true` | Enable or disable the plugin. |
+
 ### `backgroundSubagent`
 
 This plugin injects a policy into the system prompt, reminding the AI agent to use `run_in_background=true` by default when dispatching sub-agents. It helps maintain a responsive main conversation. If a foreground task is dispatched, a friendly reminder is shown.
@@ -150,6 +165,9 @@ Here is an example of a `~/.config/opencode/oc-tweaks.json` file with all option
   "compaction": {
     "enabled": true
   },
+  "autoMemory": {
+    "enabled": true
+  },
   "backgroundSubagent": {
     "enabled": true
   },
@@ -179,6 +197,7 @@ Here is an example of a `~/.config/opencode/oc-tweaks.json` file with all option
 目前可用的插件包括：
 - **`notify`**: 在任务完成或发生错误时发送桌面通知。
 - **`compaction`**: 在会话上下文压缩期间注入语言偏好提示，以确保摘要使用你的首选语言。
+- **`autoMemory`**: 智能记忆助手——自动注入 memory 上下文、识别触发词，并支持 `remember` tool 与 `/remember` 命令主动写入。
 - **`backgroundSubagent`**: 添加系统提示，鼓励使用后台子代理以获得更好的响应性。
 - **`leaderboard`**: 向 [claudecount.com](https://claudecount.com) 报告 token 用量，用于社区排行榜。
 
@@ -264,6 +283,20 @@ bunx oc-tweaks init
 |---|---|---|---|
 | `enabled` | boolean | `true` | 启用或禁用此插件。 |
 
+### `autoMemory`
+
+该插件提供智能记忆工作流：
+- 自动把全局/项目 memory 上下文注入 system prompt。
+- 内置中英文触发词，命中后优先执行记忆写入。
+- 注册自定义 `remember` tool，支持 AI 主动写入 memory 文件。
+- 自动创建 `~/.config/opencode/commands/remember.md`（若不存在），支持用户显式输入 `/remember`。
+
+**配置选项:**
+
+| 属性 | 类型 | 默认值 | 描述 |
+|---|---|---|---|
+| `enabled` | boolean | `true` | 启用或禁用此插件。 |
+
 ### `backgroundSubagent`
 
 此插件向系统提示中注入一项策略，提醒 AI 代理在派发子代理时默认使用 `run_in_background=true`。这有助于保持主对话的响应性。如果派发了前台任务，则会显示一个友好的提醒。
@@ -318,6 +351,9 @@ bunx oc-tweaks init
   "compaction": {
     "enabled": true
   },
+  "autoMemory": {
+    "enabled": true
+  },
   "backgroundSubagent": {
     "enabled": true
   },

package/dist/cli/init.js

@@ -7,6 +7,7 @@ import { dirname } from "path";
 var DEFAULT_CONFIG = {
   notify: { enabled: true },
   compaction: { enabled: true },
+  autoMemory: { enabled: true },
   backgroundSubagent: { enabled: true },
   leaderboard: { enabled: false },
   logging: { enabled: false, maxLines: 200 }

package/dist/index.js

@@ -1,3 +1,7 @@
+// src/plugins/auto-memory.ts
+import { tool } from "@opencode-ai/plugin";
+import { mkdir as mkdir2, readdir } from "node:fs/promises";
+
 // src/utils/logger.ts
 import { mkdir } from "node:fs/promises";
 import { dirname } from "node:path";
@@ -59,6 +63,7 @@ async function loadJsonConfig(path, defaults) {
 }
 var DEFAULT_CONFIG = {
   compaction: {},
+  autoMemory: {},
   backgroundSubagent: {},
   leaderboard: {},
   notify: {}
@@ -76,6 +81,203 @@ async function loadOcTweaksConfig() {
     return null;
   }
 }
+// src/plugins/auto-memory.ts
+var TRIGGER_WORDS_CN = ["记住", "保存偏好", "记录一下", "记到memory", "别忘了"];
+var TRIGGER_WORDS_EN = ["remember", "save to memory", "note this down", "don't forget", "record"];
+var REMEMBER_COMMAND_CONTENT = `---
+description: 记忆助手 - 从当前会话提取关键信息并写入 memory 文件
+---
+
+当用户希望你记住偏好、决策或长期有价值的信息时：
+1. 提取要保存的信息（保持原意，不扩写）
+2. 推断 category（如 preferences / decisions / setup / notes）
+3. 推断 scope（global 或 project）
+4. 调用 remember tool 执行写入
+
+参数：
+- content: 要保存的内容
+- category: 目标文件分类（不带 .md）
+- scope: global | project
+
+如有参数，则优先围绕参数提取重点：$ARGUMENTS
+`;
+function getHome2() {
+  return Bun.env?.HOME ?? process.env.HOME ?? "";
+}
+function sanitizeCategory(raw) {
+  if (!raw || !raw.trim())
+    return "notes";
+  const normalized = raw.trim().toLowerCase().replace(/\.md$/i, "").replace(/[^a-z0-9-_]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return normalized || "notes";
+}
+function resolveScope(raw) {
+  if (!raw)
+    return "global";
+  return raw.trim().toLowerCase() === "project" ? "project" : "global";
+}
+async function listMarkdownFiles(path) {
+  try {
+    const entries = await readdir(path);
+    return entries.filter((item) => item.endsWith(".md")).sort();
+  } catch {
+    return [];
+  }
+}
+async function readPreferences(path) {
+  try {
+    const file = Bun.file(path);
+    if (!await file.exists())
+      return "（尚无 preferences.md）";
+    const content = await file.text();
+    return content.trim() || "（preferences.md 为空）";
+  } catch {
+    return "（读取 preferences.md 失败）";
+  }
+}
+async function ensureRememberCommand(home) {
+  const commandDir = `${home}/.config/opencode/commands`;
+  const commandPath = `${commandDir}/remember.md`;
+  const commandFile = Bun.file(commandPath);
+  if (await commandFile.exists())
+    return;
+  await mkdir2(commandDir, { recursive: true });
+  await Bun.write(commandPath, REMEMBER_COMMAND_CONTENT);
+}
+async function ensureAutoMemoryInfra(home, projectMemoryDir) {
+  await mkdir2(`${home}/.config/opencode/memory`, { recursive: true });
+  await mkdir2(projectMemoryDir, { recursive: true });
+  await ensureRememberCommand(home);
+}
+async function appendMemoryRecord(filePath, content) {
+  const file = Bun.file(filePath);
+  let previous = "";
+  try {
+    if (await file.exists()) {
+      previous = await file.text();
+    }
+  } catch {}
+  const prefix = previous.length > 0 && !previous.endsWith(`
+`) ? `
+` : "";
+  const record = `[${new Date().toISOString()}]
+${content.trim()}
+
+`;
+  await Bun.write(filePath, `${previous}${prefix}${record}`);
+}
+function buildMemoryGuide(params) {
+  const globalList = params.globalFiles.length > 0 ? params.globalFiles.map((name) => `- \`${name}\``).join(`
+`) : "- （暂无全局 memory 文件）";
+  const projectList = params.projectFiles.length > 0 ? params.projectFiles.map((name) => `- \`${name}\``).join(`
+`) : "- （暂无项目级 memory 文件）";
+  return `## \uD83E\uDDE0 Memory 系统指引
+
+可用记忆层：
+1. 全局 memory：\`${params.globalMemoryDir}\`
+2. 项目 memory：\`${params.projectMemoryDir}\`
+
+### 当前文件
+**全局**
+${globalList}
+
+**项目级**
+${projectList}
+
+### 触发词（优先调用 remember tool）
+- 中文：${TRIGGER_WORDS_CN.join("、")}
+- English: ${TRIGGER_WORDS_EN.join(", ")}
+
+命中触发词后：
+1. 提取要保存的信息
+2. 判断 scope（global / project）
+3. 判断 category（例如 preferences / decisions / setup / notes）
+4. 调用 \`remember\` tool 写入
+
+### 用户核心 Preferences
+\`\`\`markdown
+${params.preferencesContent}
+\`\`\`
+`;
+}
+var autoMemoryPlugin = async ({ directory }) => {
+  const home = getHome2();
+  const globalMemoryDir = `${home}/.config/opencode/memory`;
+  const projectMemoryDir = `${directory}/.opencode/memory`;
+  try {
+    const config = await loadOcTweaksConfig();
+    if (config?.autoMemory?.enabled === true) {
+      await ensureAutoMemoryInfra(home, projectMemoryDir);
+    }
+  } catch {}
+  return {
+    "experimental.chat.system.transform": safeHook("auto-memory:system.transform", async (_input, output) => {
+      const config = await loadOcTweaksConfig();
+      if (!config || config.autoMemory?.enabled !== true)
+        return;
+      await ensureAutoMemoryInfra(home, projectMemoryDir);
+      const [globalFiles, projectFiles, preferencesContent] = await Promise.all([
+        listMarkdownFiles(globalMemoryDir),
+        listMarkdownFiles(projectMemoryDir),
+        readPreferences(`${globalMemoryDir}/preferences.md`)
+      ]);
+      output.system.push(buildMemoryGuide({
+        globalMemoryDir,
+        projectMemoryDir,
+        globalFiles,
+        projectFiles,
+        preferencesContent
+      }));
+    }),
+    "experimental.session.compacting": safeHook("auto-memory:compacting", async (_input, output) => {
+      const config = await loadOcTweaksConfig();
+      if (!config || config.autoMemory?.enabled !== true)
+        return;
+      await ensureAutoMemoryInfra(home, projectMemoryDir);
+      output.context.push(`## \uD83D\uDCBE Memory 保存提示 (Compaction Phase)
+
+如果本轮对话有值得长期保存的信息，请在摘要中标记：
+
+\`\`\`
+[MEMORY: 文件名.md]
+这里写要保存的内容
+\`\`\`
+
+后续对话中应根据该标记调用 write/edit 或 remember tool 写入对应 memory 文件。`);
+    }),
+    tool: {
+      remember: tool({
+        description: "Save important session facts into global/project memory markdown files",
+        args: {
+          content: tool.schema.string(),
+          category: tool.schema.string().optional(),
+          scope: tool.schema.string().optional()
+        },
+        async execute(args, context) {
+          try {
+            const config = await loadOcTweaksConfig();
+            if (!config || config.autoMemory?.enabled !== true) {
+              return "autoMemory is disabled in oc-tweaks config";
+            }
+            const scope = resolveScope(args.scope);
+            const category = sanitizeCategory(args.category);
+            const runtimeHome = getHome2();
+            await ensureAutoMemoryInfra(runtimeHome, `${context.directory}/.opencode/memory`);
+            const targetDir = scope === "project" ? `${context.directory}/.opencode/memory` : `${runtimeHome}/.config/opencode/memory`;
+            await mkdir2(targetDir, { recursive: true });
+            const targetPath = `${targetDir}/${category}.md`;
+            await appendMemoryRecord(targetPath, args.content);
+            return `Saved to ${targetPath}
+
+Content preview: ${args.content.slice(0, 150)}${args.content.length > 150 ? "..." : ""}`;
+          } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return `Failed to save memory: ${message}`;
+          }
+        }
+      })
+    }
+  };
+};
 // src/plugins/background-subagent.ts
 var SUB_AGENT_DISPATCH_PROMPT = `
 ## Sub-Agent Dispatch Policy
@@ -141,7 +343,7 @@ var compactionPlugin = async () => {
   };
 };
 // src/plugins/leaderboard.ts
-function getHome2() {
+function getHome3() {
   return Bun.env?.HOME ?? (globalThis?.process?.env?.HOME ?? "") ?? "";
 }
 var API_ENDPOINT = "https://api.claudecount.com/api/usage/hook";
@@ -185,7 +387,7 @@ async function loadLeaderboardConfig(configPath) {
   if (typeof configPath === "string") {
     return readLeaderboardConfig(configPath);
   }
-  const paths = [`${getHome2()}/.claude/leaderboard.json`, `${getHome2()}/.config/claude/leaderboard.json`];
+  const paths = [`${getHome3()}/.claude/leaderboard.json`, `${getHome3()}/.config/claude/leaderboard.json`];
   for (const path of paths) {
     const config = await readLeaderboardConfig(path);
     if (config)
@@ -550,5 +752,6 @@ export {
   notifyPlugin,
   leaderboardPlugin,
   compactionPlugin,
-  backgroundSubagentPlugin
+  backgroundSubagentPlugin,
+  autoMemoryPlugin
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-tweaks",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"