agentmesh-ai 0.1.0 → 0.1.2

package/GUIDE.md

@@ -0,0 +1,478 @@
+# AgentMesh 使用教程
+
+> 让你和同事的 AI 编码助手（Claude Code、Cursor、Copilot 等）共享记忆、直接对话。
+
+---
+
+## 目录
+
+1. [前置条件](#1-前置条件)
+2. [第一个人：初始化项目](#2-第一个人初始化项目)
+3. [配置你的 AI 工具](#3-配置你的-ai-工具)
+4. [验证是否生效](#4-验证是否生效)
+5. [同事加入](#5-同事加入)
+6. [开启对话空间（实时讨论）](#6-开启对话空间实时讨论)
+7. [日常使用指南](#7-日常使用指南)
+8. [完整场景演示](#8-完整场景演示)
+9. [常见问题](#9-常见问题)
+
+---
+
+## 1. 前置条件
+
+你需要：
+- **Node.js 20 或以上** — 终端输入 `node --version` 检查
+- **一个 AI 编码工具** — Claude Code、Cursor、Windsurf 中的任何一个
+- **一个项目文件夹** — 你和同事一起工作的那个项目
+
+不需要：
+- 不需要注册任何账号
+- 不需要配置服务器
+- 不需要 API Key
+
+---
+
+## 2. 第一个人：初始化项目
+
+在你的项目文件夹里打开终端，运行：
+
+```bash
+npx agentmesh-ai init
+```
+
+它会问你几个问题：
+
+```
+? Project name?  （输入你的项目名）
+? Your name?  （输入你的名字，比如"小明"）
+? Your role?  （选择你的角色，比如"Backend Developer"）
+? Your AI coding tool?  （选择你用的工具，比如"Claude Code"）
+```
+
+完成后，你的项目里会多一个 `.agenthub/` 文件夹：
+
+```
+你的项目/
+├── .agenthub/
+│   ├── hub.yaml                    ← 项目信息
+│   ├── memory/
+│   │   └── xiaoming-claude-code.yaml  ← 你的 AI 的记忆文件
+│   └── conversations/              ← 对话记录（以后会用到）
+├── src/
+└── ...你的项目文件
+```
+
+**重要：把 `.agenthub/` 提交到 Git，这样同事才能看到。**
+
+```bash
+git add .agenthub/
+git commit -m "初始化 agentmesh 共享记忆"
+git push
+```
+
+---
+
+## 3. 配置你的 AI 工具
+
+运行：
+
+```bash
+npx agentmesh-ai setup
+```
+
+它会自动检测你电脑上安装了哪些 AI 工具，然后生成对应的配置文件：
+
+```
+🔍 检测到你使用的 AI 工具:
+   ✓ Claude Code
+   ✓ Cursor
+
+? 要为哪些工具配置 AgentMesh？
+  [x] Claude Code
+  [x] Cursor
+
+✅ 已写入 .claude/mcp.json
+✅ 已写入 .cursor/mcp.json
+```
+
+### 如果 setup 没有自动识别
+
+你也可以手动配置。
+
+**Claude Code** — 创建 `.claude/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "agentmesh": {
+      "command": "npx",
+      "args": ["-y", "agentmesh-ai", "mcp"],
+      "env": {
+        "AGENTHUB_AGENT_ID": "你的agent-id"
+      }
+    }
+  }
+}
+```
+
+**Cursor** — 创建 `.cursor/mcp.json`，内容一样。
+
+agent-id 就是 init 时生成的那个（看 `.agenthub/hub.yaml` 里的 `id` 字段）。
+
+### 重启你的 AI 工具
+
+**配置完后必须重启。** 关掉 Claude Code / Cursor，重新打开。
+
+---
+
+## 4. 验证是否生效
+
+重启 AI 工具后，对它说：
+
+```
+读一下共享记忆
+```
+
+如果配置正确，AI 会调用 `read_memory` 工具，返回类似这样的内容：
+
+```
+# Shared Memory (0 entries)
+
+No shared memories found.
+```
+
+这说明 AgentMesh 已经在工作了，只是还没有记录任何知识。
+
+现在试试让 AI 记点东西：
+
+```
+帮我记录一下：我们项目用的是 TypeScript + Next.js + PostgreSQL
+```
+
+AI 会调用 `write_memory`，然后你在 `.agenthub/memory/` 里就能看到记录了。
+
+---
+
+## 5. 同事加入
+
+### 同事要做的事（3 步，2 分钟）
+
+**第一步：拉取代码**
+
+```bash
+git pull
+```
+
+拉完后他就有了 `.agenthub/` 文件夹和你的记忆。
+
+**第二步：注册自己**
+
+```bash
+npx agentmesh-ai init
+```
+
+因为 `.agenthub/` 已经存在，它会问是否重新初始化——选"是"，然后填写同事自己的信息。
+
+或者，手动操作也很简单：
+
+1. 在 `.agenthub/hub.yaml` 的 `agents` 列表里加一条：
+
+```yaml
+agents:
+  - id: xiaoming-claude-code      # 你（已有）
+    display_name: 小明
+    role: Backend Developer
+    tool: claude-code
+  - id: xiaohong-cursor            # 同事（新加）
+    display_name: 小红
+    role: Frontend Developer
+    tool: cursor
+```
+
+2. 创建同事的记忆文件 `.agenthub/memory/xiaohong-cursor.yaml`：
+
+```yaml
+agent: xiaohong-cursor
+role: Frontend Developer
+tool: cursor
+last_active: "2026-04-02T00:00:00Z"
+entries: []
+```
+
+**第三步：配置 MCP**
+
+```bash
+npx agentmesh-ai setup
+```
+
+然后重启 AI 工具。
+
+**完成。** 同事的 AI 现在可以读到你的所有记忆了。
+
+### 同事验证
+
+让同事对他的 AI 说：
+
+```
+读一下共享记忆
+```
+
+应该能看到你之前记录的所有知识。
+
+---
+
+## 6. 开启对话空间（实时讨论）
+
+日常工作中，共享记忆通过 Git 同步就够了。但有些时候你需要实时讨论——比如选技术方案、定接口格式、协调大改动。
+
+### 启动对话空间
+
+任何一个人在终端里运行：
+
+```bash
+npx agentmesh-ai serve
+```
+
+会显示：
+
+```
+🚀 对话空间已启动
+
+  Local:   ws://localhost:4800
+  Network: ws://192.168.1.100:4800
+  Key:     abc123
+
+  把以下信息发给队友：
+  AGENTHUB_SERVER_URL=ws://192.168.1.100:4800
+  AGENTHUB_SERVER_KEY=abc123
+```
+
+### 其他人连入
+
+其他人在自己的 MCP 配置（`.claude/mcp.json` 或 `.cursor/mcp.json`）里加上对话空间地址：
+
+```json
+{
+  "mcpServers": {
+    "agentmesh": {
+      "command": "npx",
+      "args": ["-y", "agentmesh-ai", "mcp"],
+      "env": {
+        "AGENTHUB_AGENT_ID": "xiaohong-cursor",
+        "AGENTHUB_SERVER_URL": "ws://192.168.1.100:4800",
+        "AGENTHUB_SERVER_KEY": "abc123"
+      }
+    }
+  }
+}
+```
+
+然后重启 AI 工具。
+
+**注意：** 所有人必须在同一个局域网内（同一个 WiFi 或公司网络）。如果是远程协作，启动 serve 的人需要用 ngrok 等工具做内网穿透。
+
+### 发起讨论
+
+对你的 AI 说：
+
+```
+帮我和团队讨论一下数据库用什么
+```
+
+AI 会自动：
+1. 发消息到对话空间
+2. 等待其他人的 AI 回复
+3. 多轮讨论
+4. 达成共识后记录结论
+
+**你只需要说这一句话，后面 AI 自动驱动。**
+
+另一边的同事不需要做任何事——他的 AI 读记忆时会看到讨论提醒，自动参与。
+
+### 关闭对话空间
+
+讨论完了，在运行 `serve` 的终端按 `Ctrl+C`。对话记录会自动保存到 `.agenthub/conversations/` 目录。
+
+---
+
+## 7. 日常使用指南
+
+### AI 会自动做的事
+
+配置好之后，你不需要专门操作 AgentMesh。AI 会自动：
+
+- **开始工作前** — 读取共享记忆，了解项目全貌
+- **写完代码后** — 把重要信息记录到共享记忆（接口、数据模型、技术选型）
+- **遇到分歧时** — 提醒你有讨论需要参与
+- **需要投票时** — 弹出选择框让你决策
+
+### 你需要做的事
+
+- **定期 git push** — 这样同事的 AI 才能读到你的最新记忆
+- **定期 git pull** — 这样你的 AI 才能读到同事的最新记忆
+- **重要决策时确认** — AI 会问你"是否记录为团队共识"，确认后才生效
+
+### 三种记忆级别
+
+| 级别 | 含义 | 谁能改 |
+|------|------|--------|
+| auto（自动） | 日常知识，AI 自动记录 | 任何人 |
+| proposal（提案） | 重要决策，等待确认 | 任何人（会有警告） |
+| protected（共识） | 团队投票通过的正式约定 | 只有发起人 |
+
+AI 记录日常信息时不会打扰你。只有记录重要决策时才会先问你确认。
+
+### 敏感信息保护
+
+AI 在记录知识时会自动扫描敏感信息。如果检测到 API Key、密码、私钥等内容，会直接拦截，不会写入共享记忆。
+
+### 常用命令
+
+```bash
+# 查看项目共享记忆的状态
+npx agentmesh-ai status
+
+# 查看所有共享记忆
+npx agentmesh-ai memory
+
+# 搜索特定信息
+npx agentmesh-ai memory -s "数据库"
+
+# 启动对话空间
+npx agentmesh-ai serve
+
+# 查看帮助
+npx agentmesh-ai --help
+```
+
+---
+
+## 8. 完整场景演示
+
+### 场景：小明和小红一起做电商项目
+
+**Day 1 — 小明初始化项目并开始写后端**
+
+```bash
+# 小明初始化
+npx agentmesh-ai init
+npx agentmesh-ai setup
+git add .agenthub/ && git commit -m "init agentmesh" && git push
+```
+
+小明对 Claude Code 说："帮我搭建 Express + TypeScript 的后端项目，写一个用户注册接口"
+
+Claude Code 写完代码后，自动记录到共享记忆：
+- 技术选型：Express 5 + TypeScript + Prisma
+- 用户接口：POST /api/users
+- 数据模型：User { id, email, name, role }
+- API 返回格式：{ data, error, code }
+
+小明提交代码和记忆：
+
+```bash
+git add . && git commit -m "feat: 用户注册接口" && git push
+```
+
+**Day 3 — 小红加入做前端**
+
+```bash
+git clone <项目地址>
+npx agentmesh-ai init    # 注册自己
+npx agentmesh-ai setup   # 配置 Cursor 的 MCP
+# 重启 Cursor
+```
+
+小红对 Cursor 说："帮我做一个用户注册页面"
+
+Cursor 自动读取共享记忆，知道：
+- 后端接口是 POST /api/users
+- 返回格式是 { data, error, code }
+- 用户字段有 email, name
+
+直接按正确的格式写前端代码。**不需要问小明任何事情。**
+
+**Day 3 晚上 — 需要讨论 UI 风格**
+
+小明启动对话空间：
+
+```bash
+npx agentmesh-ai serve
+# 把 URL 和 Key 发给小红
+```
+
+小红在 MCP 配置里加上对话空间地址，重启 Cursor。
+
+小红对 Cursor 说："帮我和团队讨论一下 UI 用什么组件库和颜色"
+
+两个 AI 自动讨论，最后达成共识：shadcn/ui + Indigo 主色 + 8px 圆角。
+
+结论自动写入共享记忆，标记为 protected。以后所有 AI 都会遵守这个规范。
+
+对话空间用完了，Ctrl+C 关掉。
+
+**Day 7 — 小王加入做移动端**
+
+```bash
+git clone <项目地址>
+npx agentmesh-ai init
+npx agentmesh-ai setup
+```
+
+小王的 AI 读取共享记忆后，立刻知道：
+- 技术栈：Express + PostgreSQL + Next.js
+- 所有接口定义和数据模型
+- UI 规范：Indigo 色 + shadcn/ui
+- API 格式：{ data, error, code }
+
+小王可以直接开始写移动端代码，不需要任何人给他讲解。
+
+---
+
+## 9. 常见问题
+
+### Q: 不配置对话空间也能用吗？
+
+**能。** 共享记忆通过 Git 同步，不需要对话空间。对话空间只在需要实时讨论时才用。
+
+### Q: 我用 Copilot，不支持 MCP 怎么办？
+
+`npx agentmesh-ai setup` 会自动生成 `.github/copilot-instructions.md`，告诉 Copilot 去读 `.agenthub/` 的文件。体验没有 MCP 那么丝滑，但基本可用。
+
+### Q: AI 记录了错误的信息怎么办？
+
+直接编辑 `.agenthub/memory/` 里对应的 YAML 文件，删掉或修改错误的条目。然后 git push。
+
+### Q: Git 会冲突吗？
+
+不会。每个人只写自己的文件（`xiaoming-claude-code.yaml`），不同人写不同文件，Git 不会冲突。
+
+### Q: 对话空间的数据会丢吗？
+
+对话空间关闭时，讨论记录自动保存到 `.agenthub/conversations/`。讨论的结论也会写入共享记忆。即使对话空间关了，重要的信息都不会丢。
+
+### Q: 远程办公怎么用对话空间？
+
+启动 serve 的人需要把端口暴露到公网。最简单的方式是用 ngrok：
+
+```bash
+# 终端 1：启动对话空间
+npx agentmesh-ai serve
+
+# 终端 2：用 ngrok 暴露端口
+ngrok tcp 4800
+```
+
+ngrok 会生成一个公网地址，发给远程同事就行。
+
+### Q: 可以同时在多个项目里用吗？
+
+可以。每个项目有自己独立的 `.agenthub/` 目录，互不影响。
+
+### Q: 怎么升级到新版本？
+
+```bash
+npx agentmesh-ai@latest init   # 用最新版
+```
+
+npm 会自动下载最新版本。

package/dist/cli/commands/setup.js

@@ -74,9 +74,9 @@ export async function setupCommand() {
     }
     const mcpConfig = {
         mcpServers: {
-            agenthub: {
+            agentmesh: {
                 command: 'npx',
-                args: ['-y', 'agenthub', 'mcp'],
+                args: ['-y', 'agentmesh-ai', 'mcp'],
                 env: {
                     AGENTHUB_AGENT_ID: agentId,
                 },

package/dist/cli/commands/setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/utils/id.d.ts

@@ -1,6 +1,3 @@
-/**
- * Agent ID generation utilities.
- */
 /** Generate a slug-style agent ID from display name and tool. */
 export declare function generateAgentId(displayName: string, tool: string): string;
 //# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzE"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAKA,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASzE"}

package/dist/utils/id.js

@@ -1,18 +1,23 @@
 /**
  * Agent ID generation utilities.
  */
+import { randomBytes } from 'node:crypto';
 /** Generate a slug-style agent ID from display name and tool. */
 export function generateAgentId(displayName, tool) {
     const namePart = slugify(displayName);
     const toolPart = slugify(tool);
-    return `${namePart}-${toolPart}`;
+    // If name part is empty (e.g. all Chinese characters got transliterated to nothing),
+    // use a short random fallback
+    const safeName = namePart || `user-${randomBytes(3).toString('hex')}`;
+    return `${safeName}-${toolPart}`;
 }
-/** Convert a string to a URL/filename-safe slug. */
+/** Convert a string to a URL/filename-safe slug. Supports non-Latin characters. */
 function slugify(str) {
     return str
         .toLowerCase()
         .trim()
-        .replace(/[^\w\s-]/g, '') // remove non-word chars (except spaces and hyphens)
+        // Keep: word chars (any language), spaces, hyphens, digits
+        .replace(/[^\p{L}\p{N}\s-]/gu, '')
         .replace(/[\s_]+/g, '-') // replace spaces/underscores with hyphens
         .replace(/-+/g, '-') // collapse multiple hyphens
         .replace(/^-|-$/g, ''); // trim leading/trailing hyphens

package/dist/utils/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,oDAAoD;AACpD,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,oDAAoD;SAC7E,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAE,0CAA0C;SACnE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAM,4BAA4B;SACrD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAG,gCAAgC;AAC9D,CAAC"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,qFAAqF;IACrF,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAEtE,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;QACP,2DAA2D;SAC1D,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAG,0CAA0C;SACpE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAO,4BAA4B;SACtD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAI,gCAAgC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmesh-ai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Shared memory & conversation protocol for AI coding agents",
   "type": "module",
   "main": "./dist/index.js",