← 返回首页

📖 KeepThinking v7.2.1 使用文档

最后更新：2026-06-03

一、安装

一键安装

wget https://keepthinking.vip/install.sh && bash install.sh

手动安装

1. 下载 keepthinking-v7.2.1.tar.gz
2. 解压：tar xzf keepthinking-v7.2.1.tar.gz
3. 安装：cd keepthinking-v7.2.1 && KEEPTHINKING_HOME=~/.keepthinking bash install.sh

检查运行状态

curl http://localhost:3456/api/health

返回 {"status":"ok","version":"7.2.0"} 即表示运行正常。

设置密码

node ~/.keepthinking/password.js --set 你的密码

密码通过 PBKDF2+SHA512 加密存储，无法逆推。

二、Web 控制台

浏览器打开 http://localhost:3456 即可访问。功能包括：

• 认知统计：节点数、边数、经验数、决策数
• 记忆搜索：关键词 + 语义搜索
• 认知图谱：可视化节点和边关系
• 项目列表：所有已知项目及活跃度
• 健康状态：磁盘、内存实时监控

三、MCP 接入指南

KeepThinking 提供 7 个 MCP 工具，兼容任何支持 MCP 协议的 AI 客户端。

Claude Desktop 配置

{
  "mcpServers": {
    "keepthinking": {
      "command": "node",
      "args": ["~/.keepthinking/mcp/server.js"]
    }
  }
}

7 个 MCP 工具

工具	功能	示例参数
search_memory	关键词搜索记忆	{"query":"支付Bug"}
search_semantic	语义搜索（ONNX本地推理）	{"query":"部署上线失败"}
get_context	获取项目上下文（自动注入）	{"project":"my-app"}
list_projects	列出所有已知项目	{}
cognitive_graph	查询认知图谱	{"maxNodes":10}
engine_status	引擎健康状态	{}
bug_diagnose	Bug模式诊断（6种模式）	{"query":"TypeError: Cannot read properties of null"}

四、API 文档

所有 API 监听在 http://localhost:3456（需密码认证的路径会返回 401）。

方法	路径	说明
GET	/api/health	健康检查
GET	/api/stats	统计信息
GET	/api/search?q=关键词&max=10	关键词搜索
GET	/api/search/semantic?q=查询&max=10	语义搜索
GET	/api/context?project=项目名	项目上下文
GET	/api/projects	项目列表
GET	/api/graph?maxNodes=50	认知图谱
POST	/api/nodes	添加节点
POST	/api/bug/diagnose	Bug诊断
POST	/api/login	登录获取token

添加节点示例

curl -X POST http://localhost:3456/api/nodes \
  -H "Content-Type: application/json" \
  -d '{
    "label": "修复了登录超时Bug",
    "project": "my-app",
    "tags": ["bug", "auth"],
    "context": "JWT token 过期后前端未正确处理刷新逻辑",
    "source": "api"
  }'

五、Git Hook 集成

# 在项目根目录运行
cd /path/to/your-project
kt-git-init

# 之后每次 git commit 都会自动同步到 KeepThinking

六、Bug 模式诊断

支持 6 种 Bug 模式自动识别：

1. null-pointer：空指针引用错误
2. state-not-updated：状态更新失败
3. api-error：API 请求错误
4. dependency-conflict：依赖冲突
5. async-race：异步竞态条件
6. config-missing：配置缺失

七、自动接管引擎

KeepThinking 安装后会自动扫描已有数据：

• OpenClaw 历史会话 → 自动提取关键决策
• Git 项目 → 自动发现 commit 历史
• 智能去重 → 已有数据不重复导入

八、自动采集循环

KeepThinking 启动后会每 10 分钟自动执行：

• 扫描 OpenClaw 会话文件 → 提取新决策写入图谱
• 扫描认知图谱中 Git 项目 → 发现新 commit 自动记录
• 智能 hash 去重 → 已有数据不重复导入
• 数据只追加不清空 → 重启后历史数据完整保留

九、FAQ

Q: 数据存在哪里？
A: ~/.keepthinking/memory/graph.json，100% 本地。

Q: 支持哪些 AI 工具？
A: 任何支持 MCP 协议的客户端（Claude Desktop、Cursor、VS Code 等）。OpenClaw 用户可通过 4 hook 插件自动捕获。

Q: ONNX 模型下载失败怎么办？
A: 语义搜索会自动降级为关键词搜索，不影响正常使用。模型会在网络可用时自动重试下载。

Q: 国内服务器能正常使用吗？
A: 可以。安装脚本和模型文件均托管在 keepthinking.vip，国内服务器可直接下载。语义搜索降级机制确保 HuggingFace 不可达时仍有搜索结果。

Q: 如何验证安装成功？
A: 访问 http://你的服务器IP:3456，使用设置的密码登录 Web 控制台，应能看到认知统计面板。

Q: 如何升级？
A: 运行 keepthinking-update，自动保留已有数据。

返回首页 · 法律声明