exomind 0.3.0 → 0.3.1

package/README.md

@@ -42,35 +42,33 @@ exomind feedback "entities/Redis.md" positive
 
 加 `--json` 获取机器可读输出(脚本/管道):`exomind --json stats | jq .total_nodes`。
 
-## 接入 Claude Code
+## 接入 Claude Code(一条命令,默认全装)
 
 ```bash
-exomind install --with-hook
+exomind install          # 装 skill + hook + MCP,全部自动(幂等+备份)
+# 不想要某项: exomind install --no-hook  或  --no-mcp
 ```
 
-一行完成:① 装 Claude Code skill(教 Agent 何时用 CLI);② 写入 `UserPromptSubmit` hook 指向 `exomind hook`(幂等,自动备份,不影响其它工具)。重启 Claude Code 后:
+一行完成三层,免手改任何 JSON:
+- **① MCP 工具**(能力):写 `~/.claude.json` 的 `mcpServers.exomind` → Agent 拿到 `mcp__exomind__*` 确定性工具。
+- **② skill**(指导):拷到 `~/.claude/skills/exomind/`。
+- **③ hook**(闸门):写 `settings.json` 的 `UserPromptSubmit → exomind hook`。
 
-- 说 **`存档`** / **`jdit`** → 自动回顾会话、运行 `exomind ingest`。
+重启 Claude Code 后:
+- 说 **`存档`** / **`jdit`** → 自动回顾会话、摄入。
 - 提问涉及知识库已有实体 → 自动注入 `[ExoMind 知识库上下文]`。
-- 产出经验/踩坑/架构决策/性能数据/最佳实践 → 自动提示摄入(飞轮)。
+- Agent 需查询/摄入时 → 直接调 `mcp__exomind__*`(确定),或按 skill 跑 `exomind` CLI。
 
-即便不装 hook,skill 也会让 Agent 主动遵循飞轮规则。完整接入步骤见服务端仓库 `myExoMindManager/docs/new-machine-setup.md`。
+完整接入步骤见服务端仓库 `myExoMindManager/docs/new-machine-setup.md`。
 
-## 作为 MCP 工具接入(可选,更确定 + 跨宿主)
+## 关于 MCP 工具层(Claude Code 已默认装;OpenCode 需手写)
 
-`exomind mcp` 启动一个**本地 stdio MCP server**,把 ingest/query/search/entity/relations/stats 暴露为**typed tool**。Agent 直接调 tool(确定参数/返回),不必"读 skill → 拼 bash"。复用同一份凭证(`~/.exomind/config.json`),本地 stdio 所以三平台都能跑。
+`exomind install` 已默认把 MCP 写进 Claude Code 的 `~/.claude.json`(见上)。这里仅给**其它宿主/手写**场景:
 
-**Claude Code**(`~/.claude.json` 或项目 `.mcp.json`):
-```json
-{ "mcpServers": { "exomind": { "command": "exomind", "args": ["mcp"] } } }
-```
-
-**OpenCode**(`opencode.json`):
-```json
-{ "mcp": { "exomind": { "type": "local", "command": ["exomind", "mcp"] } } }
-```
+- **OpenCode**(`opencode.json`):`{ "mcp": { "exomind": { "type": "local", "command": ["exomind", "mcp"] } } }`
+- **手写 Claude Code**:`~/.claude.json` 或项目 `.mcp.json`:`{ "mcpServers": { "exomind": { "command": "exomind", "args": ["mcp"] } } }`
 
-> 与 skill+hook 并存,不冲突:MCP 提供"确定的工具调用",skill 提供"何时用的指导",hook 提供"每 prompt 的强制注入"。详见 [三层模式说明](./docs/mcp.md)。
+`exomind mcp` 是本地 stdio MCP server,把 ingest/query/search/entity/relations/stats 暴露为 typed tool;复用同一份凭证,三平台都能跑(本地 stdio,不涉及远程 SSE 的 Windows 坑)。详见 [三层模式说明](./docs/mcp.md)。
 
 ## 命令一览
 

package/dist/cli.js

@@ -3119,7 +3119,7 @@ var {
 // package.json
 var package_default = {
   name: "exomind",
-  version: "0.3.0",
+  version: "0.3.1",
   description: "ExoMind \u8DE8\u5E73\u53F0\u547D\u4EE4\u884C\u5BA2\u6237\u7AEF \u2014 \u901A\u8FC7 REST \u4E0E ExoMind \u77E5\u8BC6\u5E93\u4EA4\u4E92(ingest/query/search/review),\u66FF\u4EE3 Windows \u4E0D\u53EF\u7528\u7684 MCP \u5BA2\u6237\u7AEF\u3002",
   bin: {
     exomind: "dist/cli.js"
@@ -4308,7 +4308,7 @@ async function install(_client, opts) {
   fs6.copyFileSync(SKILL_SRC, path6.join(skillDestDir, "SKILL.md"));
   console.log(ok("\u5DF2\u5B89\u88C5 Claude Code skill"));
   console.log(dim(`  \u2192 ${skillDestDir}/SKILL.md`));
-  if (opts.withHook) {
+  if (opts.hook !== false) {
     const settingsFile = path6.join(claudeDir, "settings.json");
     fs6.mkdirSync(claudeDir, { recursive: true });
     backup(settingsFile);
@@ -4327,9 +4327,20 @@ async function install(_client, opts) {
     console.log(ok("\u5DF2\u914D\u7F6E UserPromptSubmit hook \u2192 exomind hook"));
     console.log(dim("  \u91CD\u542F Claude Code \u751F\u6548\u3002hook \u51FA\u9519\u4E0D\u4F1A\u963B\u585E\u4F60\u7684\u8F93\u5165(\u9519\u8BEF\u53EA\u8FDB stderr)\u3002"));
   }
+  if (opts.mcp !== false) {
+    const claudeJson = path6.join(os2.homedir(), ".claude.json");
+    backup(claudeJson);
+    const cc = readJson2(claudeJson) ?? {};
+    const mcpServers = cc.mcpServers ?? {};
+    mcpServers.exomind = { command: "exomind", args: ["mcp"] };
+    cc.mcpServers = mcpServers;
+    fs6.writeFileSync(claudeJson, JSON.stringify(cc, null, 2) + "\n");
+    console.log(ok("\u5DF2\u914D\u7F6E MCP server \u2192 exomind mcp"));
+    console.log(dim("  \u2192 ~/.claude.json (mcpServers.exomind);\u91CD\u542F Claude Code \u540E Agent \u62FF\u5230 mcp__exomind__* \u5DE5\u5177"));
+  }
   console.log(yellow("\n\u4E0B\u4E00\u6B65:"));
   console.log(dim("  1. \u82E5\u672A\u914D\u7F6E\u51ED\u8BC1: exomind login"));
-  console.log(dim("  2. \u91CD\u542F Claude Code(\u82E5\u88C5\u4E86 hook)"));
+  console.log(dim("  2. \u91CD\u542F Claude Code \u2192 skill + hook + mcp__exomind__* \u5168\u90E8\u751F\u6548"));
 }
 
 // src/cli.ts
@@ -4413,7 +4424,7 @@ program2.command("mcp").description("\u542F\u52A8 stdio MCP server(\u4F9B Claude
   const client = new ApiClient(cfg);
   await runMcpServer(client);
 });
-program2.command("install").description("\u5B89\u88C5 Claude Code skill(\u53EF\u9009 --with-hook \u5199\u5165 UserPromptSubmit)").option("--with-hook", "\u540C\u65F6\u5199\u5165 ~/.claude/settings.json \u7684 hook").action(run(install));
+program2.command("install").description("\u5B89\u88C5 skill + hook + MCP(\u9ED8\u8BA4\u5168\u88C5;--no-hook / --no-mcp \u5173\u95ED\u67D0\u9879)").option("--no-hook", "\u4E0D\u5199 UserPromptSubmit hook").option("--no-mcp", "\u4E0D\u5199 MCP server \u914D\u7F6E").action(run(install));
 async function main() {
   const first = process.argv[2];
   if (first && /^(-v|--version)$/.test(first)) {