Reasonix到底是个啥玩意儿？

先说吧，Reasonix 是一个本地化的 AI 助手框架。

它Ke以把大模型的Neng力装进你自己的机器里。

别kan名字拗口，实际用起来一点dou不拗。

说实话，它背后用了不少开源项目，像是 Ollama、SearXNG 那种。

不过别担心，你不需要去搞太多配置。

咱就是说一键启动，马上Neng和模型聊聊天。

哈哈，这种体验跟在咖啡店里对着屏幕敲代码差不多，只是多了点 AI 的陪聊。

核心概念：Skill、Memory、Hook

Skill 就是你写的“技Neng脚本”。

比如想让 Reasonix 自动生成 React 组件，你只需要写一个 Skill 文件。

Memory 则是本地的知识库，记住你的偏好、项目背景之类的东西。

它们dou保存在 ~/.reasonix 目录下安全又私密。

Hook 是在特定事件触发时执行的外部命令。

比如每次跑工具前dou想审计一下就Ke以写 PreToolUse Hook。

快速上手——几行命令搞定

/skill new hello-world

/skill show hello-world

/memory list

/memory forget hello-world

/permissions add git

/permissions rm npm

配置文件到底长啥样？

{

"lang": "zh",

"preset": "auto",

"editMode": "review",

"semantic": {

"provider": "ollama",

"ollama": {

"baseUrl": "http://localhost:11434",

"model": "nomic-embed-text"

}

}

}

为什么百度不收录 Reasonix？

说实话，这个问题常被问到。

其实百度搜索引擎对新兴开源项目的抓取有点慢。

第一，它们geng倾向于收录Yi经有大量外链的网站。

第二，Reasonix 的文档大多数托管在 GitHub 或者自建的 Markdown 仓库里这些域名对百度来说权重相对低。

再者，hen多用户dou是在内部网络使用，不会产生外部访问日志，导致搜索爬虫根本找不到入口。

所以啊，Ru果想让百度收录，就得把文档搬到自己可控的站点上，多Zuo一些外链推广。

玩转 Search Engine —— 内置 Mojeek 与自托管 SearXNG

SearXNG Ke以帮你摆脱第三方搜索限制，完全自给自足。

SearXNG 部署hen简单，一条 Docker 命令搞定：

# docker run -d --name searxng -e BASE_URL=http://localhost -e PORT=8080 searxng/searxng

MCP到底怎么回事？

MCP 是一种协议，让模型Ke以直接调用外部服务，比如数据库、Git 仓库之类的。

MCP 配置放在 config.json 的 mcpServers 字段里。

// 示例片段

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ,
      "env": {"GITHUB_TOKEN":"gh_***"}
    },
    "postgres": {
      "transport":"sse",
      "url":"https://mcp.internal/pg/sse",
      "headers":{"Authorization":"Bearer ***"}
    }
  }
}

Aaa，那这个怎么用呢？

/skill new fetch-data-from-pg

/skill show fetch-data-from-pg

// 在 Skill 文件里写上调用 mcpServers.postgres 的逻辑就行啦。

语义索引：让搜索geng懂你的需求

"我想找所有关于分页的实现代码" ，普通关键词匹配可Neng只会返回标题含“分页”。

Reasonix 用嵌入向量Zuo语义检索，一下子就Neng把相关实现全部挑出来。

// 启动索引命令

# reasonix index --path ./my-project

// 查询时直接这样：

# reasonix query “分页实现”

CNN 那种深度学习模型背后支撑了这套系统，你要是不懂也没关系——Reasonix Yi经帮你封装好啦。

Semi‑Auto 编辑模式，让 AI 给你提建议，你来决定接受还是拒绝

EditMode 有三档：review，auto，yolo。

- review：AI 给出修改建议，你手动确认。

- auto：AI 自动 文件，但仍保留日志供回溯。

- yolo：全自动，无人监管——危！哈哈，我开玩笑啦，不过真的要慎用。

Troubleshooting 小贴士

• 启动报错 “cannot find model” —— 检查 ollama 是否运行在本机端口。 不对不对，是检查 config.json 里的 baseUrl 是否拼写错误。

• Memory 不生效 —— 确认文件路径是否放在 ~/.reasonix/memory/ 下而不是项目根目录误放了。

• Hook 没触发 —— kankan events 配置里是否漏掉了 PreToolUse 或者对应的 JSON 格式错误。.

• SearXNG 搜索慢 —— 检查容器资源配额，CPU 限制太严会导致响应迟缓。害，这么细节你也得关注啊！.

P.S. 一点小感慨——我和 Reasonix 的故事

说实话，我Zui初接触 Reasonix 时还以为它是某种高级 IDE 插件呢。害！后来才发现，它其实是一整套“AI + 本地化”的工作流体系。咱就是说用它以后再也不用担心数据泄露，因为所有请求dou跑在自己的机器上——你懂的，那种安全感真的是满分！.

还有啊，有一次我忘记保存 Memory，然后又重新跑了一遍 Skill，结果模型居然记得我的偏好，我直接笑喷了——那叫一个惊喜啊！哈哈.

P.S. Ru果你也想尝鲜，不妨先 clone 官方仓库，然后跑一遍 npx reasonix init，kan一kan自动生成的目录结构是不是跟我描述的一致。不对不对，是先打开终端，再输入那条命令就行啦~.

# 小结：为什么要选 Reasonix？

• 完全本地化，无需担心隐私泄露；

• 支持自定义 Skill，几乎任何业务场景douNeng落地；

• 内置语义索引，让知识检索像聊天一样自然；

• 可插拔 Hook 与 MCP，让 变得超灵活；

• 开源社区活跃，有大量案例可参考；.

好了我今天就聊到这儿吧。Ru果还有啥疑问，随时来撩我——咱们一起玩转 Reasonix！哈哈~

---