🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

会话方尖碑 tommy0103/obelisk

DeepSeek Harnessv0.5.5
tommy01032 天前有提交已提供中文文档扫描:含敏感能力

每个历史会话、子代理和工作流,智能体都能查询,你也能浏览

68.8/100
综合分
858
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/11/3 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过:缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。以下命令仍可尝试,但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add tommy0103/obelisk
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:需留意
是什么
dsh 原生插件 · chat
装得上吗
npm 包存在但缺 main/exports/bin 入口声明,源码安装也可能起不来
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 2 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包obelisk @ 0.5.5
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/3 15:50:01

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件
查看扫描证据(共 34 处,展示前 31 条)
  • 读取本地文件
    app/electron-vite.schema-plugin.mjs:20
    source: await readFile(schemaUrl, 'utf8'),
  • 读取本地文件
    packages/cli/src/obelisk.ts:31
    readFileSync(new URL('../../../package.json', import.meta.url), 'utf8'),
  • 读取本地文件
    packages/cli/src/obelisk.ts:84
    const script = readFileSync(resolve(args[1]), 'utf8');
  • 读取本地文件
    packages/cli/src/obelisk.ts:103
    try { emit(await executeAttune(readFileSync(resolve(args[1]), 'utf8'))); } catch (error) { fail(error); }
  • 执行外部命令来自配置/变量
    packages/cli/src/obelisk.ts:108
    const child = spawnSync(
  • 读取本地文件
    packages/core/src/db.ts:18
    const SCHEMA = readFileSync(new URL('./schema.sql', import.meta.url), 'utf8');
  • 读取本地文件
    packages/core/src/db.ts:21
    if (existsSync(DB_PATH)) return;
  • 读取本地文件
    packages/core/src/db.ts:22
    if (!existsSync(LEGACY_DB_PATH)) return;
  • 写入本地文件
    packages/core/src/db.ts:23
    mkdirSync(dirname(DB_PATH), { recursive: true });
  • 写入本地文件
    packages/core/src/db.ts:24
    copyFileSync(LEGACY_DB_PATH, DB_PATH);
  • 写入本地文件
    packages/core/src/db.ts:29
    mkdirSync(dirname(DB_PATH), { recursive: true });
  • 读取本地文件
    packages/core/src/db.ts:63
    if (!existsSync(DB_PATH)) {
  • 读取本地文件
    packages/core/src/indexer.ts:133
    if (!existsSync(DB_PATH)) return { skip: false };
  • 读取本地文件
    packages/core/src/indexer.ts:151
    if (!existsSync(DB_PATH)) return { ready: false };
  • 读取本地文件
    packages/core/src/parsing.ts:127
    function isDir(p: string): boolean { try { return statSync(p).isDirectory(); } catch { return false; } }
  • 读取本地文件
    packages/core/src/parsing.ts:209
    if (!existsSync(projectsDir)) return files;
  • 读取本地文件
    packages/core/src/parsing.ts:211
    try { projects = readdirSync(projectsDir); } catch (error) { reportIssue?.(sourceInventoryIssue(projectsDir, error)); return files; }
  • 读取本地文件
    packages/core/src/parsing.ts:216
    try { entries = readdirSync(projPath); } catch (error) { reportIssue?.(sourceInventoryIssue(projPath, error)); continue; }
  • 读取本地文件
    packages/core/src/parsing.ts:225
    try { saEntries = readdirSync(saDir); } catch (error) { reportIssue?.(sourceInventoryIssue(saDir, error)); continue; }
  • 读取本地文件
    packages/core/src/parsing.ts:233
    try { wfDirs = readdirSync(wfRoot); } catch (error) { reportIssue?.(sourceInventoryIssue(wfRoot, error)); continue; }
  • 读取本地文件
    packages/core/src/provider-indexing.ts:110
    entries = readdirSync(current, { withFileTypes: true });
  • 读取本地文件
    packages/core/src/provider-indexing.ts:128
    return { file, mtimeMs: statSync(file).mtimeMs };
  • 读取本地文件
    packages/core/src/provider-indexing.ts:166
    isDirectory = statSync(key).isDirectory();
  • 读取本地文件
    packages/core/src/provider-settings.ts:108
    if (!existsSync(settingsPath)) return { ok: true, settings: {} };
  • 读取本地文件
    packages/core/src/provider-settings.ts:110
    const parsed = JSON.parse(readFileSync(settingsPath, 'utf8')) as unknown;
  • 读取本地文件
    packages/core/src/query.ts:1057
    stat = statSync(resolved);
  • 写入本地文件
    packages/core/src/writer-lease.ts:62
    mkdirSync(dirname(lockPath), { recursive: true });
  • 读取本地文件
    packages/dsh-plugin/src/index.ts:37
    if (existsSync(fileURLToPath(new URL('SKILL.md', candidate)))) return candidate
  • 读取本地文件
    packages/dsh-plugin/src/index.ts:87
    const skill = parseSkill(readFileSync(bodyUrl, 'utf8'))
  • 删除本地文件递归
    packaging/build-skill.mjs:12
    rmSync(target, { recursive: true, force: true });
  • 写入本地文件
    packaging/build-skill.mjs:13
    mkdirSync(target, { recursive: true });
扫描于 2026/11/2(1 天前) · 范围 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

界面预览

2 张 · 点击查看大图

README

由 DeepSeek 最新模型翻译生成
你的 Claude Code、Codex、GitHub Copilot、DeepSeek Harness、Hermes Agent、Kiro、Kimi Code、OMP、OpenCode、Pi、ZCode 历史会话——agent 快速查询,你浏览它们。 English · 中文 Obelisk 把本地各种 coding agent 的历史会话统一索引进一个 SQLite 数据库,使得两种上游都可以使用: - Agent:提供 obelisk CLI 和相应的 agent skill,让 coding agent 学会查自己的历史——它现场写 JS 查询,本地执行,然后组织语言回答你。 - 你:提供一个 Electron 桌面应用,你可以翻会话、管记忆、看 token 用量、收每周回顾卡片。 读的是同一个 ~/.obelisk/obelisk.sqlite,后台监听各 provider 的目录自动更新。 让 2 万行散落的 JSONL,变成 agent 用 search() 和 sql() 毫秒级查询的索引。
展开完整文档(README 剩余 1 节)
你的 Claude Code、Codex、GitHub Copilot、DeepSeek Harness、Hermes Agent、Kiro、Kimi Code、OMP、OpenCode、Pi、ZCode 历史会话——agent 快速查询,你浏览它们。

English · 中文

Obelisk 把本地各种 coding agent 的历史会话统一索引进一个 SQLite 数据库,使得两种上游都可以使用:

- Agent:提供 obelisk CLI 和相应的 agent skill,让 coding agent 学会查自己的历史——它现场写 JS 查询,本地执行,然后组织语言回答你。
- 你:提供一个 Electron 桌面应用,你可以翻会话、管记忆、看 token 用量、收每周回顾卡片。

读的是同一个 ~/.obelisk/obelisk.sqlite,后台监听各 provider 的目录自动更新。

让 2 万行散落的 JSONL,变成 agent 用 search() 和 sql() 毫秒级查询的索引。

在 agent 里用

/obelisk 上次 auth bug 最后到底改了哪些文件,为什么这么改 /obelisk 这个文件最近在哪些 sessions 里被反复修改 /obelisk 找出最近失败的 tool calls,它们分别发生在哪些任务里 /obelisk 那个 review workflow 的 subagents 各自结论是什么 /obelisk recap this week

安装

让 agent 装(推荐)

最快速的办法:把下面这段话原样发给一个有 shell 权限的 coding agent (Claude Code、Codex 之类)。注意是发给 agent,不是贴进终端:

Install Obelisk by fetching and following this guide:
curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/SKILL.md

agent 会先问你、再动手:装好并验证 CLI 之后,再问你要把正式的 /obelisk skill 装在当前项目还是全局。

手动装

需要 Node.js 22.13+。CLI 没有运行时 npm 依赖,用的是 Node 内置的 SQLite:

npm install --global @obelisk-apps/cli
obelisk --version

macOS、Linux、WSL 也可以用一键脚本,效果相同:

curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/install.sh | sh

然后装 skill:

obelisk install

obelisk install 实际调的是 tommy0103/obelisk-skill 的标准 skills 安装器。
装完后在任意 agent 会话里直接 /obelisk <你的问题>。第一次运行会建索引(100 个会话大约 5 秒),之后都是增量更新。

工作原理

你提问 ↓ agent 针对 SQLite 索引写一段 JS 查询 ↓ 通过 obelisk --query 执行 ↓ 读 JSON 结果,用人话回答

默认查询接口(CLI 0.3.0+)为 overview()、sessions()、search()、
messages()、memories()、summaries() 和 sql()。
专题 helper 和旧脚本接口仍可使用。
签名、参数和查询范例都在 API 参考里。

记忆层

如果一次检索得出了值得留下的结论,agent 会提议写一个 markdown 记忆文件;你确认后,它用 obelisk --attune 注册进去,以后的会话里
memories() 就能召回。它是结论的缓存,不替代原始记录。

Recap

/obelisk recap 是可选功能:把一段时间的会话做成可分享的周报/月报卡片。
只有明确说要 recap 时才会加载对应文档。入口是 skill-doc/references/recap/overview.md,之后一张一张卡片往下走。

桌面应用

- Sessions —— 搜索、按项目筛选所有会话;tool call 可读化展示(diff、终端输出、文件查看器)
- Memory —— 记忆文件的列表和详情
- Activity —— GitHub 风格热力图、每周/累计 token 图表
- Recap —— 可分享的周报/月报卡片,带 archetype 主题
- Settings —— 数据源、自动刷新、重建索引

macOS 和 Linux amd64 有预编译包,见 Releases,支持应用内更新(macOS 走 Sparkle,Debian 包走 DebUpdater)。三个平台也都能跑源码——构建需要 Node.js 22.13+,应用本身用的是 Electron 内置的 Node:

git clone https://github.com/tommy0103/obelisk.git
cd obelisk/app
npm ci
npm run dev

调试、打包、发布这些维护者向的内容在 CONTRIBUTING.md 里。

请注意:桌面应用开着的时候,索引写入由它独占,这时 CLI 是只读的。

索引内容

所有 provider 都写进同一组表;有几张表只在来源工具有这个概念时才有数据:

| 表 | 内容 | 哪些 provider 有 |
| Sessions | 标题、项目、时间戳、git 分支、来源 | 全部 |
| Messages | 完整文本、模型、token 用量、父子链 | 全部 |
| Tool calls | 工具名、输入、文件路径 | 全部 |
| Subagents | agent 类型、描述、完整对话 | Claude Code、Codex、DeepSeek Harness、Hermes Agent、Kiro V3、Kimi Code、OpenCode、ZCode |
| Summaries | provider 自己产生的会话摘要 | Kiro V3、Kimi Code、OpenCode |
| Workflows | workflow 脚本、结果、每个 agent 的记录 | Claude Code |
| Memories | 结论及其来源会话 | 注册的 markdown 文件 |

全文搜索(FTS5)覆盖所有表。每个 provider 具体从哪读,见下面「支持的 Provider」。

支持的 Provider

所有 provider 共用一套 schema:每行带 source,非 Claude 的 ID 带 provider 前缀,不会撞。

| Provider | 默认读取位置 |
| Claude Code | ~/.claude/projects |
| Codex | ~/.codex/sessions、~/.codex/archived_sessions |
| GitHub Copilot | VS Code User 数据目录(Chronicle 存储 + workspace transcripts) |
| DeepSeek Harness | ~/.dsh/sessions(或 $DSH_HOME/sessions) |
| Hermes Agent | ~/.hermes/state.db(或 $HERMES_HOME/state.db) |
| Kiro | ~/.kiro/sessions 和平台 kiro-cli/data.sqlite3 数据库 |
| Kimi Code | ~/.kimi-code/sessions(或 $KIMI_CODE_HOME/sessions) |
| OMP | ~/.omp/agent/sessions |
| OpenCode | ~/.local/share/opencode/opencode.db(或 $XDG_DATA_HOME/opencode、$OPENCODE_DB 与 channel 库;支持 V1/V2 SQLite,不含早期 JSON 格式) |
| Pi | ~/.pi/agent/sessions |
| ZCode | ~/.zcode/cli/db/db.sqlite |

如果来源工具能标记哪些历史被覆盖了,Obelisk 会把这些旧记录存成 inactive——默认查询看不到,支持的查询方法可以用 includeInactive: true 显式带上:

| Provider | 被覆盖历史的处理 |
| Pi | 分支、叶子、压缩状态都能判定 inactive |
| OMP | 分支、叶子、压缩状态都能判定 inactive |
| ZCode | rewind 保留区间和压缩可判定 inactive |
| Kimi Code | undo/clear 可判定覆盖;保留实现还在路上 |
| Hermes Agent | 不细分:压缩归档和 rewind 的行都存为 inactive |
| OpenCode | 会话 revert 状态判定 inactive 历史 |
| Claude Code | 来源本身不标记 rewind / 当前叶子状态 |
| Codex | 会话没有分支概念 |

非默认位置——比如 Pi 的 --session-dir、OMP 的自定义目录、OpenCode 数据根目录(显式配置优先于 $OPENCODE_DB)、VS Code Insiders 的 User 目录——可以在应用的 Settings 里手动选。

适配器的内部细节(identity 哈希、覆盖重放、各 provider 的目录发现逻辑)见检索语义和 ADR。

参与贡献

欢迎贡献,提交 PR 前请先读 CONTRIBUTING.md。它不长,写的都是过去真实卡住 PR 的坑,不是泛泛的风格指南。几条核心:

- PR 描述里的每句话都要端到端跑通过。 卡住最常见的原因,是宣称的能力其实到不了——包括截图里的输入。
- 断言需求本身,而不是实现的形状。 把 issue 里的原话抄进测试名。
- transcript 内容一律视为不可信。 Obelisk 索引的是第三方 agent 的日志,任何流向 shell.、fs.、innerHTML 或 DDL 的路径默认拒绝。
- 合完 main 要重跑验证。 合并之后之前的结论全部作废,包括你自己写过的"已知限制"。

Star History

许可证

Copyright (C) 2026 tommy0103 and contributors.

Obelisk 采用 AGPL-3.0-only 许可证,见 LICENSE。欢迎二次开发:分发修改版时请保留各文件头部的版权声明,并按 AGPL-3.0 §5 的要求明确标注你的修改和日期。
预览分享卡片长什么样 ↓tommy0103/obelisk
分享 · DeepSeek Harness Hub
tommy0103/obelisk

每个历史会话、子代理和工作流,智能体都能查询,你也能浏览

回到顶部