trove-cli 0.0.0-stage → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 1o57
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,203 @@
-# Temporary Holding Version
+# trove
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+AI 会话资产归档工具:把本机 Claude Code / Codex / OpenCode / 豆包的会话**无损**归档到 WebDAV 或 S3 兼容对象存储,并支持多设备增量同步。
+
+## 安装
+
+```bash
+npm i -g trove-cli    # 提供 trove 命令
+npx trove-cli --help  # 免安装试用
+```
+
+npm 上 unscoped 的 `trove` 是别人的包(仍在发布中),所以本项目发布为 `trove-cli`,命令行还是 `trove`。
+
+## 用法
+
+```bash
+# 首次配置(设备名、远端后端、凭证)
+# 默认会拉起 daemon 并立即跑首轮同步;只写配置用 --no-daemon
+# 交互式:trove init 会先问远端类型(WebDAV / S3),再按类型问对应字段
+trove init
+trove init --url https://dav.example.com/ --username u --password p
+trove init --url https://dav.example.com/ --username u --password p --no-daemon
+
+# S3 兼容对象存储(阿里云 OSS / 腾讯云 COS)
+trove init --type s3 --provider aliyun --region cn-hangzhou \
+  --bucket my-bucket --access-key-id AKID --secret-access-key SK --no-daemon
+trove init --type s3 --provider tencent --region ap-guangzhou \
+  --bucket my-bucket-1250000000 --access-key-id AKID --secret-access-key SK --no-daemon
+# 私有 S3 兼容部署(MinIO 等):自定义 endpoint + path-style 寻址
+trove init --type s3 --endpoint http://127.0.0.1:9000 --force-path-style \
+  --region us-east-1 --bucket my-bucket --access-key-id AKID --secret-access-key SK --no-daemon
+
+# 同步:默认全量;日常建议限定时间窗
+trove sync --since 7d
+trove sync --since all          # 首次全量归档
+trove sync --pull-only          # 只拉取其他设备
+trove sync --push-only          # 只推送本机
+trove sync --no-raw             # 只同步 library(raw 只归档到本地)
+trove sync --raw                # 强制同步 raw(覆盖配置)
+trove config set sync.raw false # 默认只同步 library,可被 --raw 覆盖
+trove sync --quiet              # 不显示逐项进度
+
+# 概览与检索
+trove status                    # 本地 / 远端 / daemon / 待同步
+trove sessions                  # 列出 library 会话(最近 50 个)
+trove sessions --grep PATH      # 在标题/摘要/目录/模型/正文里搜
+trove sessions --harness opencode --json
+trove skills                    # 汇总后的技能(最新版本)
+trove skills show review        # 某技能的全部版本与来源
+trove library reindex           # 从设备分片重建统一索引
+trove usage                     # trove 自身 LLM 消耗的 token 用量
+trove usage --since 7d --json   # 限定时间窗,机器可读
+
+# 常驻服务:间隔/时间窗默认取 config.daemon,显式参数优先
+trove config set daemon.intervalSeconds 300
+trove config set daemon.since 7d
+trove config set daemon.startOnInit false   # init 不再自动启动
+trove daemon start                          # 等价于每 300s、时间窗 7d
+trove daemon start --interval 60 --since 24h
+trove daemon restart                        # 停止后按同样参数重新拉起
+trove daemon status
+trove daemon stop
+```
+
+`trove status` 输出四段:
+
+- **本地**:各工具已归档的会话数与体积
+- **远端**:5 秒超时探测,显示可达性、设备数与各设备上次在线时间
+- **daemon**:运行状态、间隔、时间窗、上次/下次同步与最近一轮结果
+- **待同步**:raw 层按工具分会话/文件数;library 按「会话 / 技能 / 索引」分类计数(只给计数,不逐条列)。
+  会话数按 `sessionKey` 去重,同一会话的多个文件算 1 个;Claude 子代理文件没有会话归并规则,会被算作独立会话。
+  `config.sync.raw=false` 时只显示「raw 同步已关闭」与 library 待同步。
+
+## 支持的数据源
+
+| 工具 | 位置 | 归档内容 |
+|---|---|---|
+| Claude Code | `~/.claude/projects/**/*.jsonl`、`~/.claude/transcripts/**/*.jsonl` | 两套互不重叠的会话原始 JSONL + skills/plans 等小资产 |
+| Codex | `~/.codex/sessions/**/*.jsonl`、`archived_sessions/**` | rollout 原始 JSONL + skills |
+| OpenCode | `~/.local/share/opencode/opencode.db` | `session_v2`/`session_message` 与旧表 `session`/`message`/`part` 的并集,逐会话导出确定性 JSONL(两套序列化都保留,保留全部列) |
+| 豆包(办公版) | `~/Library/Application Support/DoubaoWork/.../agent_mode/workspace` | `.sessions/<id>` 的 board/memory/agents 轨迹 + `conversation/<id>` |
+
+凭证类文件(`settings.json`、`auth.json`、`config.toml`、`*.key` 等)在适配器层硬排除。
+
+## 同步模型(Beacon poll 骨架)
+
+- **游标**:`{size, mtimeMs, prefixHash, generation}`。size+mtime 未变直接跳过;文件增长只搬新增字节;size 回退/同尺寸改写/前缀哈希不符 → 换世代全量重建。
+- **无损**:本地 vault 是源文件的原始字节副本;OpenCode 是数据库全字段导出(新旧表并集,实测 782 会话 / 153,406 行 / 990MB)。WebDAV 远端按 4MiB 分块(大请求不稳),S3 一个文件一个对象,拉取时都校验 sha256。
+- **增量**:WebDAV 远端只传新增块,块路径扁平到 `<device>/chunks/<harness>/`,避免每文件多次 MKCOL;S3 按文件覆盖写,大文件走 Multipart Upload。清单并入设备索引(`<device>/index.json`)。实测二次全量扫描 2450 项仅 14s、上传 2 项。
+- **只增不删**:远端和本地 vault 默认不删除;源文件被删后归档仍保留。唯一的删除入口是 `trove clean`(显式确认,只删索引不再引用且超过 24 小时的旧对象)。
+- **时间窗**:`--since 7d|24h|2026-10-01|all` 按会话最近变更时间过滤,避免首次全量过大。
+- **进度**:collect / pull / push 三阶段,TTY 单行刷新,管道按秒节流。
+- **daemon**:单实例 pid 锁、跨进程 sync 锁、SIGTERM 协作中止、状态写 `~/.trove/daemon.status.json`、日志轮转。间隔/时间窗/init 是否自动启动由 `config.daemon.{intervalSeconds,since,startOnInit}` 决定(默认 `300 / 7d / true`),`daemon start --interval/--since` 显式参数优先于配置。`daemon restart` 先优雅停止再按同样参数拉起;旧进程没停干净时不会起第二个实例。
+
+## library(个人资产层)
+
+`raw/` 是设备事实,`library/` 是合并后的个人资产,随同步一起走:
+
+```
+~/.trove/vault/
+├── raw/<device>/<harness>/…                原始字节(设备 × 工具)
+└── library/                                个人资产(同步)
+    ├── index.json                          统一索引(派生物,可重建)
+    ├── index/<device>.json                 每设备索引分片(只由本设备写)
+    ├── sessions/<harness>/<session>/<device>.jsonl
+    ├── skills/<name>/versions/<hash>/…     内容寻址,保留各版本
+    ├── skills/<name>/meta/<device>.json    来源与版本
+    └── lessons/                            学习沉淀(同步)
+```
+
+- **归组**:按 `(harness, sessionId)` 归并同一会话的多份 raw——Claude 主文件 + `subagents/*.jsonl`、豆包 `.sessions` + `conversation`。
+- **冲突**:每台设备只写自己的文件和分片,远端不存在并发覆盖。同一会话内容不同时,索引选 canonical(事件超集;豆包按事件 id 求并集),其余进 `variants`,文件永远保留。
+- **索引**:`index/<device>.json` 是权威,`index.json` 由本地合并生成;索引冲突只需重建,不会丢数据。
+- **技能**:按目录内容 hash 去重,来源由 `SKILL.md` frontmatter 与 `.git/config` origin 判定(`self/github/skillsh/unknown`);最新版本按 semver → updatedAt → hash 选择,历史版本保留。
+- **lessons**:按主题沉淀经验,内容用 `(harness, session, seq)` 引用会话。与 sessions/skills 一起同步;没有设备分片,多设备各自 learn 时同路径文件按最后写入覆盖,拉取只在本地缺失时恢复,不会覆盖本机刚生成的内容。
+
+事件 schema 仍是 `session/message/reasoning/tool_call/tool_result/meta`,带 `raw:{path,line}` 回指原始文件。
+
+## 同步模型补充
+
+- library **始终同步**(约 500 MB):推送本设备的会话文件、技能、lessons 与索引分片,拉取其他设备的分片与文件。
+- raw 是否上传/拉取按 **命令行 > `config.sync.raw` > 默认 true** 决定;关闭时只同步 library,raw 只归档到本地。
+- 配置示例:`trove config set sync.raw false`;`trove sync --raw` 可临时覆盖。
+- 索引分片按设备隔离,拉取时落盘后本地重建统一索引。
+
+## LLM 用量统计
+
+trove 自己调用 LLM 的场景(手动 `trove learn`、daemon 每轮同步后的经验提取)会把每次调用的 token 用量追加到 `~/.trove/usage.jsonl`:时间、任务(如 `learn:summarize`)、模型、输入/输出/合计 tokens。`trove usage` 按任务与模型汇总,`--since` 限定时间窗,`--json` 输出机器可读结果。
+
+该台账只统计 trove 自身调用 LLM 的消耗,不包含被归档会话里的 usage 字段;Jev 打分走 TypeSafe API,响应不含 token 用量,因此不计入。台账只留本机,不参与同步。
+
+## 本地布局
+
+```
+~/.trove/
+├── config.json              设备身份与远端凭证(600)
+├── state.json               游标 + 推送/拉取水位 + library 记录(原子写)
+├── usage.jsonl              trove 自身 LLM 调用的 token 用量(只追加,不同步)
+├── daemon.pid / daemon.status.json
+├── vault/raw/<device>/<harness>/...       原始字节归档
+├── vault/library/                         个人资产(会话/技能/索引/lessons)
+├── tmp/                     OpenCode 导出与 library 重建临时文件
+└── logs/daemon.log
+```
+
+远端布局(索引与设备元信息一致;raw 文件按后端区分):
+
+```
+raw/<device>/index.json                            索引(含每文件块清单与哈希)
+raw/<device>/meta.json                             设备名 / lastSeen
+raw/<device>/chunks/<harness>/<key>.<gen>.<off>-<len>.bin  WebDAV:不可变块
+raw/<device>/files/<harness>/<relPath>             S3:完整文件(控制台可直接浏览)
+library/index/<device>.json                        每设备索引分片
+library/sessions/…、library/skills/…               个人资产
+```
+
+WebDAV 服务端没有原生分片上传,只能按 4 MiB 块存;对象存储一个会话文件就是一个对象,
+路径即原始相对路径,桶里能直接打开会话原文。索引项的 `layout` 字段区分两种布局,老索引缺省按分块解释。
+
+## 远端后端
+
+| 后端 | 配置方式 | 说明 |
+|---|---|---|
+| WebDAV | `trove init --url … --username … --password …` | 默认后端,兼容自建与第三方网盘 |
+| 阿里云 OSS | `--type s3 --provider aliyun --region cn-hangzhou --bucket …` | S3 兼容,走 virtual-hosted 寻址 |
+| 腾讯云 COS | `--type s3 --provider tencent --region ap-guangzhou --bucket …` | S3 兼容;Bucket 名需带 `-<appid>` 后缀 |
+
+交互式配置(`trove init` / `trove config`)会先问远端类型,再按类型问对应字段 —— 选 S3 时依次问厂商、地域、Bucket、AccessKey,不选就沿用现有配置。
+
+**换后端与历史数据迁移**:索引、设备元信息与 library 布局在两种后端下一致,raw 文件布局按后端区分。`state.json` 里的 `remoteId` 记录了推送水位属于哪个远端;检测到后端变了,旧水位自动作废,历史数据会整份重推(不会"以为推过了"而静默丢数据)。首次切到新后端时跑一次 `trove sync --since all` 即可。S3 切到单对象布局后,旧的 `chunks/` 对象不会自动删除,需要时手工清理。
+
+**清理远端旧对象**:`trove clean` 扫描当前远端,删除不再被任何设备索引引用、且最后修改时间早于 24 小时的对象(旧布局分块、已无引用的会话/技能文件)。
+
+```bash
+trove clean --dry-run   # 只列出
+trove clean             # 列出后交互确认,默认否
+trove clean --yes       # 直接删除
+```
+
+安全边界:设备索引缺失时整个设备跳过;library 任一分片读取失败则整个 library 跳过;`lessons/**`、`merged.*.jsonl`、技能 `meta/*.json` 一律保留;24 小时内上传的对象、时间缺失的对象不删。切换远端后的第一次 `trove sync` 结束时(TTY 环境)会询问一次是否清理,默认不清理;daemon 永不触发清理。
+
+## 开发
+
+```bash
+pnpm test          # 单元 + 真实 WebDAV 服务集成 + 真实本机会话扫描
+pnpm typecheck
+pnpm build
+```
+
+## 发版
+
+合并到 `main` 即自动发版(`.github/workflows/release.yml`):
+
+1. PR 里改好 `package.json` 的 `version`,合并进 `main`
+2. Actions 装依赖 → 构建 → 跑测试 → 发布到 npm → 打 tag `v<version>` 并生成 GitHub Release(附带 npm 包 tarball)
+
+一次性配置(npm 侧):npmjs.com → 包的设置 → Trusted Publisher → GitHub Actions,填 `blankPen` / `trove` / `release.yml`,并允许 `npm publish`。之后 CI 用 OIDC 直接发布,不需要长期 token。
+
+仍用 token 的话:仓库 Settings → Secrets and variables → Actions → 新建 `NPM_TOKEN`(granular access token,Read and write(publish and stage)+ 勾选 Bypass 2FA)。只用 stage only 的 token 只会把版本暂存,需要人工 `npm stage approve <stage-id> --otp <code>` 才会真正上线。
+
+重复触发是幂等的:npm 上已有该版本就跳过发布,GitHub Release 已存在就跳过建 Release,两样都做完就整体跳过。
+
+npm 计划 2027 年 1 月起停用 bypass 2FA token 的直接发布,届时改走 trusted publishing(OIDC)即可,工作流不用动。

package/dist/adapters/file-source.d.ts

@@ -0,0 +1,31 @@
+/** 一个文件源(某个 agent 的原始落盘目录)。 */
+export interface FileSourceConfig {
+    id: string;
+    displayName: string;
+    root: string;
+    /** 白名单 glob,相对 root;命中才归档(设计原则 2) */
+    patterns: string[];
+    /** 硬排除 glob,相对 root;优先于白名单 */
+    exclusions: string[];
+    /** 整棵跳过的目录 glob(性能剪枝,如 plugins、plugins/**) */
+    pruneDirs?: string[];
+    /** 会话 id 推导;默认一个文件就是一个会话 */
+    sessionKeyOf?: (relPath: string) => string;
+    /** 哪些文件算"会话"(用于计数);默认等于 patterns */
+    sessionPatterns?: string[];
+}
+export interface DiscoveredFile {
+    /** root 内相对路径,统一 '/' */
+    relPath: string;
+    absPath: string;
+    sessionKey: string;
+    size: number;
+    mtimeMs: number;
+    /** 所属会话的最近变更时间(同会话多文件取最大) */
+    sessionMtimeMs: number;
+}
+/**
+ * 发现一个源里应归档的文件。只要目录遍历 + 路径匹配,不读文件内容,
+ * 源文件零改写。白名单 ∩ 排除,排除优先。
+ */
+export declare function discoverFiles(config: FileSourceConfig): Promise<DiscoveredFile[]>;

package/dist/adapters/file-source.js

@@ -0,0 +1,97 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { minimatch } from 'minimatch';
+function toPosix(p) {
+    return p.split(sep).join('/');
+}
+function matchesAny(path, globs) {
+    return globs.some((g) => minimatch(path, g, { dot: true }));
+}
+function isPruned(relDir, pruneDirs) {
+    if (!relDir)
+        return false;
+    return pruneDirs.some((p) => minimatch(relDir, p, { dot: true }) || minimatch(relDir, `${p}/**`, { dot: true }));
+}
+/** 递归收集目录下所有常规文件与"指向文件"的符号链接;不读内容。 */
+async function walk(root, pruneDirs) {
+    const out = [];
+    const stack = [''];
+    while (stack.length) {
+        const relDir = stack.pop();
+        const absDir = relDir ? join(root, relDir) : root;
+        let entries;
+        try {
+            entries = await readdir(absDir, { withFileTypes: true });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                continue;
+            throw err;
+        }
+        for (const e of entries) {
+            const relPath = toPosix(relDir ? `${relDir}/${e.name}` : e.name);
+            const absPath = join(absDir, e.name);
+            if (e.isDirectory()) {
+                if (!isPruned(relPath, pruneDirs))
+                    stack.push(relPath);
+                continue;
+            }
+            if (e.isSymbolicLink()) {
+                try {
+                    const st = await stat(absPath);
+                    if (!st.isFile())
+                        continue;
+                }
+                catch {
+                    continue; // 悬空链接
+                }
+            }
+            else if (!e.isFile()) {
+                continue;
+            }
+            out.push({ relPath, absPath });
+        }
+    }
+    return out;
+}
+/**
+ * 发现一个源里应归档的文件。只要目录遍历 + 路径匹配,不读文件内容,
+ * 源文件零改写。白名单 ∩ 排除,排除优先。
+ */
+export async function discoverFiles(config) {
+    const pruneDirs = config.pruneDirs ?? [];
+    const found = await walk(config.root, pruneDirs);
+    const out = [];
+    for (const f of found) {
+        if (matchesAny(f.relPath, config.exclusions))
+            continue;
+        if (!matchesAny(f.relPath, config.patterns))
+            continue;
+        let st;
+        try {
+            st = await stat(f.absPath);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                continue;
+            throw err;
+        }
+        const sessionKey = config.sessionKeyOf ? config.sessionKeyOf(f.relPath) : f.relPath;
+        out.push({
+            ...f,
+            sessionKey,
+            size: st.size,
+            mtimeMs: Math.round(st.mtimeMs),
+            sessionMtimeMs: Math.round(st.mtimeMs),
+        });
+    }
+    // 同一会话多文件:会话时间取最大,供 --since 判定(目录里旧附件不因自身 mtime 被漏掉)
+    const sessionMax = new Map();
+    for (const f of out) {
+        sessionMax.set(f.sessionKey, Math.max(sessionMax.get(f.sessionKey) ?? 0, f.mtimeMs));
+    }
+    for (const f of out)
+        f.sessionMtimeMs = sessionMax.get(f.sessionKey);
+    return out;
+}
+//# sourceMappingURL=file-source.js.map

package/dist/adapters/file-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-source.js","sourceRoot":"","sources":["../../src/adapters/file-source.ts"],"names":[],"mappings":"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"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,34 @@
+import type { FileSourceConfig } from './file-source.js';
+export type HarnessId = 'claude-code' | 'codex' | 'opencode' | 'doubao';
+export interface FileAdapter {
+    kind: 'files';
+    id: Exclude<HarnessId, 'opencode'>;
+    displayName: string;
+    source: FileSourceConfig;
+}
+export interface OpenCodeAdapter {
+    kind: 'opencode';
+    id: 'opencode';
+    displayName: string;
+    dbPath: string;
+}
+export type Adapter = FileAdapter | OpenCodeAdapter;
+export interface AdapterPaths {
+    home?: string;
+    claudeRoot?: string;
+    codexRoot?: string;
+    opencodeDb?: string;
+    doubaoRoot?: string;
+}
+export declare function claudeCodeAdapter(root: string): FileAdapter;
+export declare function codexAdapter(root: string): FileAdapter;
+export declare function doubaoAdapter(root: string): FileAdapter;
+export declare function opencodeAdapter(dbPath: string): OpenCodeAdapter;
+/** 这个归档项是否属于"会话"(skills/plans 等资产不算会话)。 */
+export declare function isSessionPath(adapter: Adapter, relPath: string): boolean;
+/**
+ * 按本机路径生成四个 adapter;调用方按 config.sources 过滤启用项。
+ * 允许用环境变量覆盖根目录,便于测试与迁移:
+ * TROVE_CLAUDE_ROOT / TROVE_CODEX_ROOT / TROVE_OPENCODE_DB / TROVE_DOUBAO_ROOT
+ */
+export declare function createAdapters(opts?: AdapterPaths, env?: NodeJS.ProcessEnv): Adapter[];

package/dist/adapters/index.js

@@ -0,0 +1,146 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { minimatch } from 'minimatch';
+/** 豆包 agent mode 工作区(办公版),会话内容在 .sessions/<id> 与 conversation/<id>。 */
+function defaultDoubaoRoot(home) {
+    return join(home, 'Library/Application Support/DoubaoWork/Default/.doubaowork/agent_mode/workspace');
+}
+export function claudeCodeAdapter(root) {
+    return {
+        kind: 'files',
+        id: 'claude-code',
+        displayName: 'Claude Code',
+        source: {
+            id: 'claude-code',
+            displayName: 'Claude Code',
+            root,
+            // 两套互不重叠的会话存储:projects/*.jsonl 与 transcripts/*.jsonl
+            patterns: [
+                'projects/**/*.jsonl',
+                'transcripts/**/*.jsonl',
+                'history.jsonl',
+                'skills/**',
+                'CLAUDE.md',
+                'RTK.md',
+                'plans/**',
+                'tasks/**',
+                // file-history 是编辑器快照(1797 个小文件),不是会话正文;默认不搬
+            ],
+            exclusions: ['.credentials.json', 'settings.json', 'settings.local.json'],
+            sessionPatterns: ['projects/**/*.jsonl', 'transcripts/**/*.jsonl'],
+            // 大而无价值的目录:整棵剪掉,不参与遍历
+            pruneDirs: [
+                'plugins',
+                'stats',
+                'stats2',
+                'stats3',
+                'stats4',
+                'bash-snapshots',
+                'downloads',
+                'telemetry',
+                'paste-cache',
+                'backups',
+                'shell-snapshots',
+                'sessions',
+                'cache',
+                'jobs',
+                'bin',
+                'ide',
+                'debug',
+                'session-models',
+                'token-offsets',
+                'hooks',
+                'daemon',
+            ],
+            // 会话 id = 文件名 UUID(与 group.claudeSessionOf 同口径),供 learn 入队与统一索引对齐
+            sessionKeyOf: (rel) => {
+                if (rel.startsWith('transcripts/') && rel.endsWith('.jsonl')) {
+                    return rel.slice('transcripts/'.length).replace(/\.jsonl$/, '');
+                }
+                if (rel.startsWith('projects/') && rel.endsWith('.jsonl')) {
+                    const parts = rel.split('/');
+                    const sub = parts.indexOf('subagents');
+                    return (sub > 0 ? parts[sub - 1] : parts[parts.length - 1]).replace(/\.jsonl$/, '');
+                }
+                return rel;
+            },
+        },
+    };
+}
+export function codexAdapter(root) {
+    return {
+        kind: 'files',
+        id: 'codex',
+        displayName: 'Codex',
+        source: {
+            id: 'codex',
+            displayName: 'Codex',
+            root,
+            patterns: [
+                'sessions/**/*.jsonl',
+                'archived_sessions/**/*.jsonl',
+                'history.jsonl',
+                'skills/**',
+            ],
+            // auth.json / config.toml 可能含 API key;SQLite 是运行态缓存,均不归档
+            exclusions: ['auth.json', 'config.toml', 'config.toml.bak', '*.sqlite', '*.sqlite-wal', '*.sqlite-shm'],
+            sessionPatterns: ['sessions/**/*.jsonl', 'archived_sessions/**/*.jsonl'],
+            pruneDirs: ['.tmp', 'tmp', 'log', 'logs', 'shell_snapshots', 'thread-writer-locks'],
+            // shortcut: 未配 sessionKeyOf,codex 会话 id 是内容派生(session_meta.payload.id)、文件名推不出,
+            // 因此 changedSessions 会落 relPath 形 key 并在 learn 里 fail(failed.json 优雅降级);待有 codex 数据时按 group.codexSessionOf 读内容对齐
+        },
+    };
+}
+export function doubaoAdapter(root) {
+    return {
+        kind: 'files',
+        id: 'doubao',
+        displayName: '豆包',
+        source: {
+            id: 'doubao',
+            displayName: '豆包',
+            root,
+            // 只收会话内容:board/memory/assignment/trajectory/socket 与后台任务输出。
+            // scratch、sandbox、skills 是生成物/技能库,不属于会话正文(体积也占九成)。
+            patterns: [
+                '.sessions/*/board.md',
+                '.sessions/*/memory/**',
+                '.sessions/*/agents/*/system/**',
+                '.sessions/*/agents/*/socket/**',
+                'conversation/**',
+            ],
+            exclusions: ['**/*.key', '**/*.pem', '**/.env', '**/auth.json', '**/credentials*'],
+            sessionPatterns: ['.sessions/**', 'conversation/**'],
+            pruneDirs: ['.skills', '.user_skills', 'experience', '**/scratch', '**/sandbox', '**/node_modules'],
+            sessionKeyOf: (rel) => {
+                const m = /^\.sessions\/([^/]+)\//.exec(rel) ?? /^conversation\/([^/]+)\//.exec(rel);
+                return m ? m[1] : rel;
+            },
+        },
+    };
+}
+export function opencodeAdapter(dbPath) {
+    return { kind: 'opencode', id: 'opencode', displayName: 'OpenCode', dbPath };
+}
+/** 这个归档项是否属于"会话"(skills/plans 等资产不算会话)。 */
+export function isSessionPath(adapter, relPath) {
+    if (adapter.kind === 'opencode')
+        return true;
+    const globs = adapter.source.sessionPatterns ?? adapter.source.patterns;
+    return globs.some((g) => minimatch(relPath, g, { dot: true }));
+}
+/**
+ * 按本机路径生成四个 adapter;调用方按 config.sources 过滤启用项。
+ * 允许用环境变量覆盖根目录,便于测试与迁移:
+ * TROVE_CLAUDE_ROOT / TROVE_CODEX_ROOT / TROVE_OPENCODE_DB / TROVE_DOUBAO_ROOT
+ */
+export function createAdapters(opts = {}, env = process.env) {
+    const home = opts.home ?? homedir();
+    return [
+        claudeCodeAdapter(opts.claudeRoot ?? env.TROVE_CLAUDE_ROOT ?? join(home, '.claude')),
+        codexAdapter(opts.codexRoot ?? env.TROVE_CODEX_ROOT ?? join(home, '.codex')),
+        opencodeAdapter(opts.opencodeDb ?? env.TROVE_OPENCODE_DB ?? join(home, '.local/share/opencode/opencode.db')),
+        doubaoAdapter(opts.doubaoRoot ?? env.TROVE_DOUBAO_ROOT ?? defaultDoubaoRoot(home)),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AA6BtC,uEAAuE;AACvE,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,IAAI,CACT,IAAI,EACJ,iFAAiF,CAClF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE;YACN,EAAE,EAAE,aAAa;YACjB,WAAW,EAAE,aAAa;YAC1B,IAAI;YACJ,qDAAqD;YACrD,QAAQ,EAAE;gBACR,qBAAqB;gBACrB,wBAAwB;gBACxB,eAAe;gBACf,WAAW;gBACX,WAAW;gBACX,QAAQ;gBACR,UAAU;gBACV,UAAU;gBACV,6CAA6C;aAE9C;YACD,UAAU,EAAE,CAAC,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,CAAC;YACzE,eAAe,EAAE,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;YAClE,sBAAsB;YACtB,SAAS,EAAE;gBACT,SAAS;gBACT,OAAO;gBACP,QAAQ;gBACR,QAAQ;gBACR,QAAQ;gBACR,gBAAgB;gBAChB,WAAW;gBACX,WAAW;gBACX,aAAa;gBACb,SAAS;gBACT,iBAAiB;gBACjB,UAAU;gBACV,OAAO;gBACP,MAAM;gBACN,KAAK;gBACL,KAAK;gBACL,OAAO;gBACP,gBAAgB;gBAChB,eAAe;gBACf,OAAO;gBACP,QAAQ;aACT;YACD,kEAAkE;YAClE,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;gBACpB,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7D,OAAO,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAClE,CAAC;gBACD,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;oBACvC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBACxF,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE;YACN,EAAE,EAAE,OAAO;YACX,WAAW,EAAE,OAAO;YACpB,IAAI;YACJ,QAAQ,EAAE;gBACR,qBAAqB;gBACrB,8BAA8B;gBAC9B,eAAe;gBACf,WAAW;aACZ;YACD,yDAAyD;YACzD,UAAU,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,CAAC;YACvG,eAAe,EAAE,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;YACxE,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,qBAAqB,CAAC;YACnF,+EAA+E;YAC/E,iHAAiH;SAClH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE;YACN,EAAE,EAAE,QAAQ;YACZ,WAAW,EAAE,IAAI;YACjB,IAAI;YACJ,4DAA4D;YAC5D,mDAAmD;YACnD,QAAQ,EAAE;gBACR,sBAAsB;gBACtB,uBAAuB;gBACvB,gCAAgC;gBAChC,gCAAgC;gBAChC,iBAAiB;aAClB;YACD,UAAU,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC;YAClF,eAAe,EAAE,CAAC,cAAc,EAAE,iBAAiB,CAAC;YACpD,SAAS,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,CAAC;YACnG,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;gBACpB,MAAM,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrF,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACzB,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC/E,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,OAAe;IAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAqB,EAAE,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACpC,OAAO;QACL,iBAAiB,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpF,YAAY,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5E,eAAe,CACb,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAC5F;QACD,aAAa,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/adapters/opencode.d.ts

@@ -0,0 +1,30 @@
+/**
+ * OpenCode 适配器(设计:SQLite 全表对比,Beacon 游标档位 3)。
+ *
+ * OpenCode 1.x 同时存在两套表:
+ *   - 新:session_v2 + session_message(消息内容含 parts,data 为完整 JSON)
+ *   - 旧:session + message + part
+ * 新表只覆盖了旧表的一部分,因此导出取并集,任何一行的字段都原样保留。
+ * 只读打开源库;归档内容是每会话一份确定性 JSONL。
+ */
+export interface OpenCodeSession {
+    id: string;
+    updatedAt: number;
+}
+/** 导出格式版本:导出逻辑变化时递增,collect 会据此强制重导(旧归档自动换世代)。 */
+export declare const OPENCODE_EXPORT_VERSION = 2;
+export declare class OpenCodeStore {
+    private db;
+    constructor(dbPath: string);
+    close(): void;
+    /** 列出全部会话(新表 + 仅存在于旧表的会话),updatedAt 取会话/消息/part 的最大值。 */
+    listSessions(cutoff?: number): OpenCodeSession[];
+    /**
+     * 导出单个会话为确定性 JSONL:每个数据库行一行,保留全部列。
+     * 行格式:{"v":1,"table":"session_v2","row":{...}}
+     */
+    exportSession(sessionId: string): string;
+}
+/** 便捷函数(测试/单次导出)。 */
+export declare function listSessions(dbPath: string, cutoff?: number): OpenCodeSession[];
+export declare function exportSession(dbPath: string, sessionId: string): string;