@synth-coder/memhub 0.2.3 → 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.eslintrc.cjs +45 -45
- package/.factory/commands/opsx-apply.md +150 -150
- package/.factory/commands/opsx-archive.md +155 -155
- package/.factory/commands/opsx-explore.md +171 -171
- package/.factory/commands/opsx-propose.md +104 -104
- package/.factory/skills/openspec-apply-change/SKILL.md +156 -156
- package/.factory/skills/openspec-archive-change/SKILL.md +114 -114
- package/.factory/skills/openspec-explore/SKILL.md +288 -288
- package/.factory/skills/openspec-propose/SKILL.md +110 -110
- package/.github/workflows/ci.yml +110 -74
- package/.github/workflows/release.yml +67 -0
- package/.iflow/commands/opsx-apply.md +152 -152
- package/.iflow/commands/opsx-archive.md +157 -157
- package/.iflow/commands/opsx-explore.md +173 -173
- package/.iflow/commands/opsx-propose.md +106 -106
- package/.iflow/skills/openspec-apply-change/SKILL.md +156 -156
- package/.iflow/skills/openspec-archive-change/SKILL.md +114 -114
- package/.iflow/skills/openspec-explore/SKILL.md +288 -288
- package/.iflow/skills/openspec-propose/SKILL.md +110 -110
- package/.prettierrc +11 -11
- package/AGENTS.md +167 -169
- package/README.md +276 -195
- package/README.zh-CN.md +245 -193
- package/dist/src/cli/agents/claude-code.d.ts +5 -0
- package/dist/src/cli/agents/claude-code.d.ts.map +1 -0
- package/dist/src/cli/agents/claude-code.js +14 -0
- package/dist/src/cli/agents/claude-code.js.map +1 -0
- package/dist/src/cli/agents/cline.d.ts +5 -0
- package/dist/src/cli/agents/cline.d.ts.map +1 -0
- package/dist/src/cli/agents/cline.js +14 -0
- package/dist/src/cli/agents/cline.js.map +1 -0
- package/dist/src/cli/agents/codex.d.ts +5 -0
- package/dist/src/cli/agents/codex.d.ts.map +1 -0
- package/dist/src/cli/agents/codex.js +14 -0
- package/dist/src/cli/agents/codex.js.map +1 -0
- package/dist/src/cli/agents/cursor.d.ts +5 -0
- package/dist/src/cli/agents/cursor.d.ts.map +1 -0
- package/dist/src/cli/agents/cursor.js +14 -0
- package/dist/src/cli/agents/cursor.js.map +1 -0
- package/dist/src/cli/agents/factory-droid.d.ts +5 -0
- package/dist/src/cli/agents/factory-droid.d.ts.map +1 -0
- package/dist/src/cli/agents/factory-droid.js +14 -0
- package/dist/src/cli/agents/factory-droid.js.map +1 -0
- package/dist/src/cli/agents/gemini-cli.d.ts +5 -0
- package/dist/src/cli/agents/gemini-cli.d.ts.map +1 -0
- package/dist/src/cli/agents/gemini-cli.js +14 -0
- package/dist/src/cli/agents/gemini-cli.js.map +1 -0
- package/dist/src/cli/agents/index.d.ts +14 -0
- package/dist/src/cli/agents/index.d.ts.map +1 -0
- package/dist/src/cli/agents/index.js +30 -0
- package/dist/src/cli/agents/index.js.map +1 -0
- package/dist/src/cli/agents/windsurf.d.ts +5 -0
- package/dist/src/cli/agents/windsurf.d.ts.map +1 -0
- package/dist/src/cli/agents/windsurf.js +14 -0
- package/dist/src/cli/agents/windsurf.js.map +1 -0
- package/dist/src/cli/index.d.ts +8 -0
- package/dist/src/cli/index.d.ts.map +1 -0
- package/dist/src/cli/index.js +168 -0
- package/dist/src/cli/index.js.map +1 -0
- package/dist/src/cli/init.d.ts +34 -0
- package/dist/src/cli/init.d.ts.map +1 -0
- package/dist/src/cli/init.js +160 -0
- package/dist/src/cli/init.js.map +1 -0
- package/dist/src/cli/instructions.d.ts +29 -0
- package/dist/src/cli/instructions.d.ts.map +1 -0
- package/dist/src/cli/instructions.js +141 -0
- package/dist/src/cli/instructions.js.map +1 -0
- package/dist/src/cli/types.d.ts +22 -0
- package/dist/src/cli/types.d.ts.map +1 -0
- package/dist/src/cli/types.js +86 -0
- package/dist/src/cli/types.js.map +1 -0
- package/dist/src/contracts/mcp.js +34 -34
- package/dist/src/contracts/schemas.js.map +1 -1
- package/dist/src/server/mcp-server.d.ts.map +1 -1
- package/dist/src/server/mcp-server.js +7 -14
- package/dist/src/server/mcp-server.js.map +1 -1
- package/dist/src/services/embedding-service.d.ts.map +1 -1
- package/dist/src/services/embedding-service.js +1 -1
- package/dist/src/services/embedding-service.js.map +1 -1
- package/dist/src/services/memory-service.d.ts.map +1 -1
- package/dist/src/services/memory-service.js.map +1 -1
- package/dist/src/storage/markdown-storage.d.ts.map +1 -1
- package/dist/src/storage/markdown-storage.js +1 -1
- package/dist/src/storage/markdown-storage.js.map +1 -1
- package/dist/src/storage/vector-index.d.ts.map +1 -1
- package/dist/src/storage/vector-index.js +4 -5
- package/dist/src/storage/vector-index.js.map +1 -1
- package/docs/README.md +21 -0
- package/docs/mcp-tools.md +136 -0
- package/docs/user-guide.md +182 -0
- package/package.json +61 -59
- package/src/cli/agents/claude-code.ts +14 -0
- package/src/cli/agents/cline.ts +14 -0
- package/src/cli/agents/codex.ts +14 -0
- package/src/cli/agents/cursor.ts +14 -0
- package/src/cli/agents/factory-droid.ts +14 -0
- package/src/cli/agents/gemini-cli.ts +14 -0
- package/src/cli/agents/index.ts +36 -0
- package/src/cli/agents/windsurf.ts +14 -0
- package/src/cli/index.ts +192 -0
- package/src/cli/init.ts +218 -0
- package/src/cli/instructions.ts +156 -0
- package/src/cli/types.ts +112 -0
- package/src/contracts/index.ts +12 -12
- package/src/contracts/mcp.ts +223 -223
- package/src/contracts/schemas.ts +307 -307
- package/src/contracts/types.ts +410 -410
- package/src/index.ts +8 -8
- package/src/server/index.ts +5 -5
- package/src/server/mcp-server.ts +169 -186
- package/src/services/embedding-service.ts +114 -114
- package/src/services/index.ts +5 -5
- package/src/services/memory-service.ts +656 -663
- package/src/storage/frontmatter-parser.ts +243 -243
- package/src/storage/index.ts +6 -6
- package/src/storage/markdown-storage.ts +228 -236
- package/src/storage/vector-index.ts +159 -160
- package/src/utils/index.ts +5 -5
- package/src/utils/slugify.ts +63 -63
- package/test/cli/init.test.ts +380 -0
- package/test/contracts/schemas.test.ts +313 -313
- package/test/contracts/types.test.ts +21 -21
- package/test/frontmatter-parser-more.test.ts +94 -94
- package/test/server/mcp-server.test.ts +211 -210
- package/test/services/memory-service-edge.test.ts +248 -248
- package/test/services/memory-service.test.ts +291 -279
- package/test/storage/frontmatter-parser.test.ts +223 -223
- package/test/storage/markdown-storage.test.ts +226 -217
- package/test/storage/storage-edge.test.ts +238 -238
- package/test/storage/vector-index.test.ts +149 -153
- package/test/utils/slugify-edge.test.ts +94 -94
- package/test/utils/slugify.test.ts +72 -68
- package/tsconfig.json +25 -25
- package/tsconfig.test.json +8 -8
- package/vitest.config.ts +29 -29
- package/docs/architecture-diagrams.md +0 -368
- package/docs/architecture.md +0 -381
- package/docs/contracts.md +0 -190
- package/docs/prompt-template.md +0 -33
- package/docs/proposals/mcp-typescript-sdk-refactor.md +0 -568
- package/docs/proposals/proposal-close-gates.md +0 -58
- package/docs/tool-calling-policy.md +0 -101
- package/docs/vector-search.md +0 -306
package/README.zh-CN.md
CHANGED
|
@@ -1,193 +1,245 @@
|
|
|
1
|
-
# MemHub
|
|
2
|
-
|
|
3
|
-
一个面向编码代理(Codex / Claude Code / OpenCode 等)的 **Git 友好记忆 MCP Server**。
|
|
4
|
-
|
|
5
|
-
MemHub 将“用户决策、长期偏好、可复用知识”保存为 **Markdown 文件 + YAML Front Matter**,便于人读、审查、版本管理和协作。
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## 为什么用 MemHub
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
1
|
+
# MemHub
|
|
2
|
+
|
|
3
|
+
一个面向编码代理(Codex / Claude Code / OpenCode 等)的 **Git 友好记忆 MCP Server**。
|
|
4
|
+
|
|
5
|
+
MemHub 将“用户决策、长期偏好、可复用知识”保存为 **Markdown 文件 + YAML Front Matter**,便于人读、审查、版本管理和协作。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 为什么用 MemHub
|
|
10
|
+
|
|
11
|
+
大多数 AI 记忆工具依赖外部 API 或简单的关键词匹配。MemHub 不同:
|
|
12
|
+
|
|
13
|
+
### 本地 AI 语义搜索
|
|
14
|
+
|
|
15
|
+
- **向量数据库**:基于 LanceDB 实现快速相似度搜索
|
|
16
|
+
- **本地嵌入模型**:量化版 Transformers.js 模型,完全在本地运行
|
|
17
|
+
- **零 API 成本**:无需外部服务、无需 API 密钥、无速率限制
|
|
18
|
+
- **隐私优先**:你的记忆永远不会离开你的电脑
|
|
19
|
+
|
|
20
|
+
### Git 原生存储
|
|
21
|
+
|
|
22
|
+
- **纯文本格式**:所有记忆都是带 YAML front matter 的 Markdown 文件
|
|
23
|
+
- **版本控制**:像代码一样提交、分支、审查、回滚
|
|
24
|
+
- **人类可读**:用任何文本编辑器浏览和编辑记忆
|
|
25
|
+
- **团队友好**:通过 git 仓库共享记忆
|
|
26
|
+
|
|
27
|
+
### 工作原理
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
用户查询 → 本地嵌入模型 → 向量搜索 → 排序结果
|
|
31
|
+
↑ ↓
|
|
32
|
+
运行在 CPU LanceDB 索引
|
|
33
|
+
(无需 GPU) (嵌入式数据库)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
当你调用 `memory_load` 时,MemHub:
|
|
37
|
+
1. 使用本地量化模型将查询转换为向量
|
|
38
|
+
2. 在 LanceDB 索引中搜索语义相似的记忆
|
|
39
|
+
3. 返回带有相关性分数的排序结果
|
|
40
|
+
|
|
41
|
+
这意味着"测试框架偏好"可以找到关于"Vitest vs Jest 决策"的记忆——即使没有精确的关键词匹配。
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 核心特性
|
|
46
|
+
|
|
47
|
+
- **语义搜索** — 基于 LanceDB 的向量相似度搜索
|
|
48
|
+
- **本地嵌入** — 量化版 Transformers.js 模型,CPU 运行
|
|
49
|
+
- **Markdown 存储** — 人类可读的 `.md` 文件,带 YAML front matter
|
|
50
|
+
- **Git 友好** — 版本控制、diff、审查你的记忆
|
|
51
|
+
- **MCP 协议** — 支持 Claude Code、Cursor、Cline、Windsurf 等
|
|
52
|
+
- **一键配置** — `npx -y @synth-coder/memhub init`
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 快速开始
|
|
57
|
+
|
|
58
|
+
### 一键配置
|
|
59
|
+
|
|
60
|
+
使用一条命令为你的 AI 代理配置 MemHub:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx -y @synth-coder/memhub init
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
这将启动交互式提示选择你的代理。MemHub 会:
|
|
67
|
+
1. 将 MCP 服务器配置添加到代理的配置文件
|
|
68
|
+
2. 将 MemHub 使用说明添加到代理的规则文件
|
|
69
|
+
|
|
70
|
+
**支持的代理:**
|
|
71
|
+
|
|
72
|
+
| 代理 | 配置文件 | 指令文件 |
|
|
73
|
+
|------|----------|----------|
|
|
74
|
+
| Claude Code | `~/.claude/settings.json` | `~/.claude/CLAUDE.md` |
|
|
75
|
+
| Cursor | `~/.cursor/mcp.json` | `~/.cursorrules` |
|
|
76
|
+
| Cline | `~/.cline/mcp.json` | `~/.clinerules` |
|
|
77
|
+
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | `~/.windsurfrules` |
|
|
78
|
+
| Factory Droid | `~/.factory/mcp.json` | `~/.factory/AGENTS.md` |
|
|
79
|
+
| Gemini CLI | `~/.gemini/settings.json` | `~/.gemini/GEMINI.md` |
|
|
80
|
+
| Codex | `~/.codex/config.toml` | `~/.codex/AGENTS.md` |
|
|
81
|
+
|
|
82
|
+
### CLI 选项
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
# 交互式选择(全局 - 默认)
|
|
86
|
+
npx -y @synth-coder/memhub init
|
|
87
|
+
|
|
88
|
+
# 跳过交互式提示
|
|
89
|
+
npx -y @synth-coder/memhub init -a claude-code
|
|
90
|
+
|
|
91
|
+
# 仅配置当前项目(本地)
|
|
92
|
+
npx -y @synth-coder/memhub init -a cursor -l
|
|
93
|
+
|
|
94
|
+
# 更新现有配置
|
|
95
|
+
npx -y @synth-coder/memhub init -a claude-code --force
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
| 选项 | 说明 |
|
|
99
|
+
|------|------|
|
|
100
|
+
| `-a, --agent <名称>` | 代理类型(跳过交互式选择) |
|
|
101
|
+
| `-l, --local` | 配置当前项目(默认:全局) |
|
|
102
|
+
| `-f, --force` | 更新现有配置 |
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 作为 MCP Server 使用(stdio)
|
|
107
|
+
|
|
108
|
+
### 方式 A:npx 直接运行(推荐)
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
npx -y @synth-coder/memhub
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
> Windows 下不要在包名后再加 `memhub` 参数。
|
|
115
|
+
> 如果出现“弹出源码 .js 文件”的情况,请升级到最新版本(`0.1.2+`)后重试。
|
|
116
|
+
|
|
117
|
+
在你的 MCP 客户端配置中添加:
|
|
118
|
+
|
|
119
|
+
```json
|
|
120
|
+
{
|
|
121
|
+
"mcpServers": {
|
|
122
|
+
"memhub": {
|
|
123
|
+
"command": "npx",
|
|
124
|
+
"args": ["-y", "@synth-coder/memhub"],
|
|
125
|
+
"env": {
|
|
126
|
+
"MEMHUB_STORAGE_PATH": "/绝对路径/你的记忆目录",
|
|
127
|
+
"MEMHUB_LOG_LEVEL": "info"
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### 方式 B:本地仓库运行
|
|
135
|
+
|
|
136
|
+
```json
|
|
137
|
+
{
|
|
138
|
+
"mcpServers": {
|
|
139
|
+
"memhub": {
|
|
140
|
+
"command": "node",
|
|
141
|
+
"args": ["dist/src/server/mcp-server.js"]
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## 环境变量
|
|
150
|
+
|
|
151
|
+
- `MEMHUB_STORAGE_PATH`:记忆存储目录(默认:`./memories`)
|
|
152
|
+
- `MEMHUB_LOG_LEVEL`:日志级别(默认:`info`,可选:`debug|info|warn|error`)
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## 记忆文件格式
|
|
157
|
+
|
|
158
|
+
```markdown
|
|
159
|
+
---
|
|
160
|
+
id: "550e8400-e29b-41d4-a716-446655440000"
|
|
161
|
+
created_at: "2026-03-03T08:00:00.000Z"
|
|
162
|
+
updated_at: "2026-03-03T08:00:00.000Z"
|
|
163
|
+
tags:
|
|
164
|
+
- architecture
|
|
165
|
+
- tdd
|
|
166
|
+
category: "engineering"
|
|
167
|
+
importance: 4
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
# Contract-first MCP 设计
|
|
171
|
+
|
|
172
|
+
先定义工具契约与 schema,再进入实现。
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
文件名格式:
|
|
176
|
+
|
|
177
|
+
```text
|
|
178
|
+
YYYY-MM-DD-title-slug.md
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## MCP 工具列表
|
|
184
|
+
|
|
185
|
+
> 详见 [docs/mcp-tools.md](docs/mcp-tools.md) 获取 API 参考。
|
|
186
|
+
|
|
187
|
+
- `memory_load`:首轮加载短期记忆(STM)上下文
|
|
188
|
+
- `memory_update`:末轮回写决策/偏好/知识/状态变化
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## 开发说明
|
|
193
|
+
|
|
194
|
+
### 常用脚本
|
|
195
|
+
|
|
196
|
+
```bash
|
|
197
|
+
npm run build
|
|
198
|
+
npm run lint
|
|
199
|
+
npm run typecheck
|
|
200
|
+
npm run test
|
|
201
|
+
npm run test:coverage
|
|
202
|
+
npm run quality
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### 工程流程(默认)
|
|
206
|
+
|
|
207
|
+
- 契约优先(先类型与 schema)
|
|
208
|
+
- 严格 TDD(`红 -> 绿 -> 重构`)
|
|
209
|
+
- 合并前必须通过质量门禁
|
|
210
|
+
- 覆盖率阈值:**>= 80%**
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
## 项目结构
|
|
215
|
+
|
|
216
|
+
```text
|
|
217
|
+
memhub/
|
|
218
|
+
├── docs/
|
|
219
|
+
├── src/
|
|
220
|
+
│ ├── contracts/
|
|
221
|
+
│ ├── server/
|
|
222
|
+
│ ├── services/
|
|
223
|
+
│ ├── storage/
|
|
224
|
+
│ └── utils/
|
|
225
|
+
├── test/
|
|
226
|
+
└── .github/workflows/
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
## 路线图
|
|
232
|
+
|
|
233
|
+
- [x] 架构与契约设计
|
|
234
|
+
- [x] 核心实现(storage/service/server)
|
|
235
|
+
- [x] 质量门禁(lint/typecheck/test/coverage)
|
|
236
|
+
- [x] CLI init 命令快速配置
|
|
237
|
+
- [ ] 集成测试
|
|
238
|
+
- [ ] 性能优化
|
|
239
|
+
- [x] npm 发布(`@synth-coder/memhub@0.2.3`)
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## License
|
|
244
|
+
|
|
245
|
+
MIT
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/claude-code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASrF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Claude Code MCP configuration generator
|
|
3
|
+
*/
|
|
4
|
+
export function generateClaudeCodeConfig(_memhubPath) {
|
|
5
|
+
return {
|
|
6
|
+
mcpServers: {
|
|
7
|
+
memhub: {
|
|
8
|
+
command: 'npx',
|
|
9
|
+
args: ['-y', '@synth-coder/memhub'],
|
|
10
|
+
},
|
|
11
|
+
},
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=claude-code.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../../src/cli/agents/claude-code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/cline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAShF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cline MCP configuration generator
|
|
3
|
+
*/
|
|
4
|
+
export function generateClineConfig(_memhubPath) {
|
|
5
|
+
return {
|
|
6
|
+
mcpServers: {
|
|
7
|
+
memhub: {
|
|
8
|
+
command: 'npx',
|
|
9
|
+
args: ['-y', '@synth-coder/memhub'],
|
|
10
|
+
},
|
|
11
|
+
},
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=cline.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cline.js","sourceRoot":"","sources":["../../../../src/cli/agents/cline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAShF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Codex MCP configuration generator
|
|
3
|
+
*/
|
|
4
|
+
export function generateCodexConfig(_memhubPath) {
|
|
5
|
+
return {
|
|
6
|
+
mcpServers: {
|
|
7
|
+
memhub: {
|
|
8
|
+
command: 'npx',
|
|
9
|
+
args: ['-y', '@synth-coder/memhub'],
|
|
10
|
+
},
|
|
11
|
+
},
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=codex.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../src/cli/agents/codex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASjF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cursor MCP configuration generator
|
|
3
|
+
*/
|
|
4
|
+
export function generateCursorConfig(_memhubPath) {
|
|
5
|
+
return {
|
|
6
|
+
mcpServers: {
|
|
7
|
+
memhub: {
|
|
8
|
+
command: 'npx',
|
|
9
|
+
args: ['-y', '@synth-coder/memhub'],
|
|
10
|
+
},
|
|
11
|
+
},
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=cursor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../../src/cli/agents/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"factory-droid.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/factory-droid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASvF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Factory Droid MCP configuration generator
|
|
3
|
+
*/
|
|
4
|
+
export function generateFactoryDroidConfig(_memhubPath) {
|
|
5
|
+
return {
|
|
6
|
+
mcpServers: {
|
|
7
|
+
memhub: {
|
|
8
|
+
command: 'npx',
|
|
9
|
+
args: ['-y', '@synth-coder/memhub'],
|
|
10
|
+
},
|
|
11
|
+
},
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=factory-droid.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"factory-droid.js","sourceRoot":"","sources":["../../../../src/cli/agents/factory-droid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gemini-cli.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/gemini-cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASpF"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gemini CLI MCP configuration generator
|
|
3
|
+
*/
|
|
4
|
+
export function generateGeminiCliConfig(_memhubPath) {
|
|
5
|
+
return {
|
|
6
|
+
mcpServers: {
|
|
7
|
+
memhub: {
|
|
8
|
+
command: 'npx',
|
|
9
|
+
args: ['-y', '@synth-coder/memhub'],
|
|
10
|
+
},
|
|
11
|
+
},
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=gemini-cli.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gemini-cli.js","sourceRoot":"","sources":["../../../../src/cli/agents/gemini-cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO;QACL,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,qBAAqB,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agent configuration generators index
|
|
3
|
+
*/
|
|
4
|
+
export { generateCursorConfig } from './cursor.js';
|
|
5
|
+
export { generateClaudeCodeConfig } from './claude-code.js';
|
|
6
|
+
export { generateClineConfig } from './cline.js';
|
|
7
|
+
export { generateWindsurfConfig } from './windsurf.js';
|
|
8
|
+
export { generateFactoryDroidConfig } from './factory-droid.js';
|
|
9
|
+
export { generateGeminiCliConfig } from './gemini-cli.js';
|
|
10
|
+
export { generateCodexConfig } from './codex.js';
|
|
11
|
+
import type { AgentType } from '../types.js';
|
|
12
|
+
export type ConfigGenerator = (memhubPath: string) => Record<string, unknown>;
|
|
13
|
+
export declare function getConfigGenerator(agentId: AgentType): ConfigGenerator;
|
|
14
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/agents/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,MAAM,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAY9E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,eAAe,CAEtE"}
|