@banlan/inkstone

v0.0.7

Published

7 days ago

Browse and manage conversation history from Claude Code, Codex CLI, OpenCode, Reasonix, Oh My PI (omp), Pi, and DeepSeek Harness (dsh)

Inkstone · 砚录

砚台研磨墨汁，典藏对话墨迹——本地浏览、搜索与管理 AI 编程助手对话历史的 Web 应用。

直接读取本地会话文件（JSONL / SQLite），零数据库、零配置启动。

快速开始

npx inkstone open    # 一行启动：自动开服务 + 打开浏览器

或全局安装：npm install -g inkstone，然后 inkstone open / start / stop / status。

注意：若安装时出现 allow-scripts 关于 better-sqlite3 的警告（npm 安全白名单机制拦截其安装脚本），请先执行 npm config set allow-scripts=better-sqlite3 --location=user 再重装，否则 OpenCode 数据源将不可用（其余数据源不受影响）。

支持的数据源

| 数据源 | 数据路径 | |--------|---------| | Claude Code | ~/.claude/projects/ | | OpenAI Codex CLI | ~/.codex/sessions/ | | OpenCode CLI | ~/.local/share/opencode/opencode.db（SQLite） | | Reasonix (Go v1.8.1+) | %APPDATA%\reasonix / ~/.reasonix | | Oh My PI (omp) | ~/.omp/agent/sessions/ | | Pi (pi coding agent) | ~/.pi/agent/sessions/ | | DeepSeek Harness (dsh) | ~/.dsh/sessions/（zstd 压缩，需 Node ≥ 22.2） |

缺失的数据源静默跳过；新数据源可通过适配层扩展。

功能亮点

统一会话列表 — 七数据源聚合，按数据源分组（Claude / Codex / OpenCode / Reasonix / OMP / Pi / DSH），按项目目录归类，收藏置顶、时间分组、分支筛选
对话详情 — Markdown 渲染、可折叠 Thinking / Tool Use 块、连续 assistant 合并、分页加载
搜索 — 全局全文搜索（Cmd+K）跨所有会话；会话内搜索（Cmd+F）支持正则、大小写、全字匹配
Diff 视图 — LCS 逐行对齐的 Side-by-Side 文件变更对比，变更块导航，可跳回原始消息
Prompt Library — 全局 / 项目 / 会话三级 Prompt 浏览、复用、复盘
会话管理 — 重命名、标签、收藏、软删除（sidecar 存储，不修改原始 JSONL）；一键在系统终端恢复 CLI 会话
数据统计 — Token 用量汇总、30 天柱状图、按项目 / 模型明细
时间线 — GitHub 风格活跃度热力图，按天查看会话
深/浅主题 — 一键切换，localStorage 持久化

项目结构

inkstone/
  server.js              # 后端：Express + 全部 API + 五数据源解析
  bin/cli.js             # CLI 入口（open / start / stop / status / update）
  public/                # 前端 SPA（原生 JS，无框架）
    index.html · style.css · app.js
    modules/             # router / chat-view / search / stats / features /
                         # timeline / diff-view / prompts
  docs/                  # 项目文档（见下方）
  scripts/               # 构建与工具脚本（pkg 打包 / 便携版 / native 模块）

数据来源

应用只读各数据源原生会话文件，用户元数据（重命名 / 标签 / 收藏）写入各数据源下的独立 session-meta/ sidecar 目录。

详见 docs/data-storage.md。

API

共 11 个后端接口，完整参考见 docs/api-reference.md：/api/projects、/api/sessions、/api/projects/:pid/sessions-full、/api/projects/:pid/sessions/:sid、PUT /meta、/api/search、/api/stats、/api/tags、/api/timeline、/api/prompts、/api/open-terminal。

文档

完整文档索引见 docs/README.md，包括：

技术架构 · 数据存储 · API 参考
浏览与导航 · 对话详情 · 搜索
Diff 视图 · Prompt Library · 会话管理
统计 · 时间线 · 导出 · 主题
数据源集成：Codex · OpenCode · Reasonix · OMP · Pi · DSH

License

CC BY-NC-SA 4.0 — 允许自由使用与修改，禁止商用，衍生作品须同协议开源。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme