agent-wiki 0.1.1 → 0.2.0
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/README.md +89 -5
- package/package.json +2 -8
package/README.md
CHANGED
|
@@ -6,24 +6,90 @@
|
|
|
6
6
|
|
|
7
7
|
## 安装
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
所有主流 Agent 通用，底层都是同一个 `npx agent-wiki`。装完重启 Agent 就行。
|
|
10
|
+
|
|
11
|
+
### Claude Code
|
|
12
|
+
|
|
10
13
|
```bash
|
|
11
14
|
claude mcp add agent-wiki -- npx agent-wiki
|
|
12
15
|
```
|
|
13
16
|
|
|
14
|
-
|
|
17
|
+
### Cursor
|
|
18
|
+
|
|
19
|
+
Settings → MCP → Add new MCP Server：
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"mcpServers": {
|
|
24
|
+
"agent-wiki": {
|
|
25
|
+
"command": "npx",
|
|
26
|
+
"args": ["-y", "agent-wiki"]
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### Trae
|
|
33
|
+
|
|
34
|
+
Settings → MCP → 添加服务器（或从 MCP Marketplace 搜索安装）：
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"mcpServers": {
|
|
39
|
+
"agent-wiki": {
|
|
40
|
+
"command": "npx",
|
|
41
|
+
"args": ["-y", "agent-wiki"]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Qoder
|
|
48
|
+
|
|
49
|
+
MCP Settings → Connect your own MCP server（或从 MCP Square 搜索安装）：
|
|
50
|
+
|
|
15
51
|
```json
|
|
16
52
|
{
|
|
17
53
|
"mcpServers": {
|
|
18
54
|
"agent-wiki": {
|
|
19
55
|
"command": "npx",
|
|
20
|
-
"args": ["agent-wiki"]
|
|
56
|
+
"args": ["-y", "agent-wiki"]
|
|
21
57
|
}
|
|
22
58
|
}
|
|
23
59
|
}
|
|
24
60
|
```
|
|
25
61
|
|
|
26
|
-
|
|
62
|
+
### Windsurf
|
|
63
|
+
|
|
64
|
+
Plugins → Browse MCP Servers → Install，或编辑 `mcp_config.json`：
|
|
65
|
+
|
|
66
|
+
```json
|
|
67
|
+
{
|
|
68
|
+
"mcpServers": {
|
|
69
|
+
"agent-wiki": {
|
|
70
|
+
"command": "npx",
|
|
71
|
+
"args": ["-y", "agent-wiki"]
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### OpenClaw
|
|
78
|
+
|
|
79
|
+
编辑 `~/.openclaw/workspace/_workspace/config/mcporter.json`：
|
|
80
|
+
|
|
81
|
+
```json
|
|
82
|
+
{
|
|
83
|
+
"mcpServers": {
|
|
84
|
+
"agent-wiki": {
|
|
85
|
+
"command": "npx",
|
|
86
|
+
"args": ["-y", "agent-wiki"]
|
|
87
|
+
"env": {},
|
|
88
|
+
"disabled": false
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
```
|
|
27
93
|
|
|
28
94
|
## 首次使用
|
|
29
95
|
|
|
@@ -50,15 +116,28 @@ Agent：你好！我是 agent-wiki 知识库助手。
|
|
|
50
116
|
你：整理一下知识库
|
|
51
117
|
你：搜一下 RAG 相关的内容
|
|
52
118
|
你：帮我写一篇 Agent 工程化的综述
|
|
119
|
+
你：这段分析不错，存到知识库吧
|
|
53
120
|
你：检查一下知识库健不健康
|
|
54
121
|
```
|
|
55
122
|
|
|
123
|
+
## 支持的文件格式
|
|
124
|
+
|
|
125
|
+
| 格式 | 处理方式 |
|
|
126
|
+
|------|---------|
|
|
127
|
+
| `.md` | 直接摄入 |
|
|
128
|
+
| `.txt` | 自动转为 .md |
|
|
129
|
+
| `.html` | 去标签提取正文，转 .md |
|
|
130
|
+
| `.csv` | 转为 Markdown 表格 |
|
|
131
|
+
| `.pdf` / `.docx` / `.xlsx` | 原样存储，Agent 多模态读取 |
|
|
132
|
+
| 图片 | 存储到 raw/assets/ |
|
|
133
|
+
|
|
56
134
|
## 知识库结构
|
|
57
135
|
|
|
58
136
|
```
|
|
59
137
|
你的知识库目录/
|
|
60
138
|
├── SCHEMA.md # 知识库说明书（Agent 自动读取）
|
|
61
139
|
├── raw/ # 原始文章（不可变）
|
|
140
|
+
│ └── assets/ # 图片等资源
|
|
62
141
|
├── wiki/ # AI 编译后的维基页面
|
|
63
142
|
│ ├── INDEX.md # 分类索引
|
|
64
143
|
│ ├── LOG.md # 操作日志
|
|
@@ -72,12 +151,13 @@ Agent：你好！我是 agent-wiki 知识库助手。
|
|
|
72
151
|
|------|------|
|
|
73
152
|
| wiki_status | 查询知识库状态，首次使用自动引导 |
|
|
74
153
|
| wiki_init | 初始化知识库（创建目录 + SCHEMA.md） |
|
|
75
|
-
| wiki_ingest | 摄入文章到 raw/ |
|
|
154
|
+
| wiki_ingest | 摄入文章到 raw/（支持 md/txt/html/csv/pdf/docx/xlsx/图片） |
|
|
76
155
|
| wiki_tag | 写入标签到 frontmatter |
|
|
77
156
|
| wiki_compile | 生成 Wiki 页面 + 更新索引 + 记录日志 |
|
|
78
157
|
| wiki_search | 标签 + 全文搜索 |
|
|
79
158
|
| wiki_article | 保存原创文章到 outputs/ |
|
|
80
159
|
| wiki_lint | 自检死链接、缺摘要等 |
|
|
160
|
+
| wiki_feedback | 保存问答分析到知识库（用户确认后） |
|
|
81
161
|
|
|
82
162
|
## 写文章风格
|
|
83
163
|
|
|
@@ -86,6 +166,10 @@ Agent：你好！我是 agent-wiki 知识库助手。
|
|
|
86
166
|
- 有自己的观点和态度
|
|
87
167
|
- 适合直接发微信公众号
|
|
88
168
|
|
|
169
|
+
## 知识自进化
|
|
170
|
+
|
|
171
|
+
每次问答中的综合分析，用户确认后会自动存入知识库。问得越多，知识库越厚。存入的内容会标记为 `query-derived`，与原始材料编译的内容区分开。
|
|
172
|
+
|
|
89
173
|
## 技术栈
|
|
90
174
|
|
|
91
175
|
- TypeScript + @modelcontextprotocol/sdk
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-wiki",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "卡帕西智能知识库 MCP 插件 — 一行安装，纯对话交互，Agent 自动帮你管理知识库、写有人味儿的原创文章",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -12,13 +12,7 @@
|
|
|
12
12
|
"start": "node dist/index.js",
|
|
13
13
|
"dev": "tsc --watch"
|
|
14
14
|
},
|
|
15
|
-
"keywords": [
|
|
16
|
-
"mcp",
|
|
17
|
-
"wiki",
|
|
18
|
-
"knowledge-base",
|
|
19
|
-
"karpathy",
|
|
20
|
-
"obsidian"
|
|
21
|
-
],
|
|
15
|
+
"keywords": ["mcp", "wiki", "knowledge-base", "karpathy", "obsidian"],
|
|
22
16
|
"author": "",
|
|
23
17
|
"license": "MIT",
|
|
24
18
|
"dependencies": {
|