Skip to content

v0.1.0 —— 首个发布版本

Latest
Latest

Choose a tag to compare

View all tags
@cygmris cygmris released this 11 Aug 09:23
· 17 commits to main since this release
v0.1.0
0f13213

把 Claude Code 与 Codex 的全部历史会话变成可检索的东西。本地常驻，只读，不联网。

你和 AI 一起做的每个决定、踩过的每个坑、写对的每条命令，都躺在几千个 JSONL 文件里，
没有任何入口能找回来。chatdex 给它们一个入口 —— 给你，也给 agent 自己。

装

下载对应平台的包，解开把 chatdex 放进 PATH：

tar -xzf chatdex_0.1.0_linux_amd64.tar.gz
install -m755 chatdex_0.1.0_linux_amd64/chatdex ~/.local/bin/chatdex

chatdex index      # 首次全量索引，3000 会话约 13 分钟
chatdex serve      # dashboard :5021 / API+MCP :5022

浏览器打开 http://127.0.0.1:5021 。常驻运行见 docs/deploy.md。

也可以自己构建（需 Go 1.26+，无 CGO、无 Node、无 Docker）：

go build -o ~/.local/bin/chatdex ./cmd/chatdex

校验和见 SHA256SUMS。

接 MCP

{ "mcpServers": { "chatdex": { "url": "http://127.0.0.1:5022/mcp" } } }

⚠️ 走 Streamable HTTP，不是 stdio —— 填 url，不要写成 command/args。
chatdex 是常驻服务，MCP 端点挂在已经在跑的那个进程上。
提供三个工具：search_sessions、get_session、list_projects。

这个版本有什么

  • 中英混合全文检索 —— CJK 单字切分 + FTS5。中位 37 ms（3265 会话 / 74.7 万块的真实语料）
  • 摘要一并入索引 —— 本地 LLM 用概念词重写原文，填平「记的词与原文对不上」那道鸿沟
  • 问一问 —— 大白话提问，LLM 多轮改写查询自己重试，每一轮搜了什么都摊开给你看；可限定项目范围
  • 子代理串起来 —— 近一半会话是子代理（本机 1591/3265），三态过滤 + 父子互跳
  • 语法高亮与图表 —— 代码、命令、以及读文件命令的输出都上色；mermaid 点了才渲染
  • 备份（对接 restic，可选） —— restic 管存得住存得安全，chatdex 管它做不到的：
    你索引过的会话备份里到底有没有、源文件消失后怎么把原件读回来
  • MCP 端点 —— agent 可以自己查「我上次是怎么解决这个的」
  • 四套主题，对比度全部由脚本验证达到 WCAG AA

安全边界（不可放宽）

  • 只读：绝不写、改、删任何会话原始文件
  • 只监听 127.0.0.1：索引库权限 0600 —— 它含工具结果里的明文凭证，等于一份集中的凭据副本
  • LLM 端点只接受回环地址：填远端会被直接拒绝，没有任何开关可以放宽
  • 本地 LLM 是可选依赖：不装照样索引照样检索

已知边界

  • 界面只有中文，尚未做 i18n
  • 需要 Go 1.26+ 自行构建时才用得上；预编译包无此要求
Assets 7
Loading