dsh-chat-sync

DSH（DeepSeek Harness）插件：把本地 Claude Code / Codex CLI / Cursor Agent 的对话自动导入为 DSH 会话，在侧边栏统一查看。

功能

能力	说明
自动导入	发现新对话自动创建 DSH 会话
工作区匹配	按源对话的项目路径自动匹配或创建 DSH 工作区
三源分组	侧边栏按 Claude Code / Codex CLI / Cursor Agent 分组显示
动态同步	fs.watch 递归监听 + SSE 推送，列表自动刷新
隐私围栏	所有 API 仅接受 loopback 请求

数据源

源	路径
Claude Code	~/.claude/projects/<项目>/<sessionId>.jsonl
Codex CLI	~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
Cursor Agent	~/.cursor/projects/<项目>/agent-transcripts/<uuid>/<uuid>.jsonl

工作原理

自动导入流程

1. 扫描：定期扫描三个数据源目录，发现新的对话文件
2. 匹配工作区：根据源对话的 cwd（工作目录）查找匹配的 DSH 工作区
   • 匹配到 → 直接使用
   • 未匹配 → 自动创建新工作区目录
3. 创建会话：通过 DSH API 创建新会话，挂载到对应工作区
4. 命名：会话标题格式为 [来源] 原始标题（如 [Claude] 修复登录bug）

状态追踪

已导入的会话记录在 .chat-sync/imported.json，避免重复导入。只导入最近 24 小时内有更新的会话。

安装

# 使用 dsh plugin 安装
dsh plugin --profile web add dsh-chat-sync

配置

在 profile 的 cordis.patch.yml（~/.dsh/profiles/web/cordis.patch.yml）按 id 覆盖：

- id: chat-sync
  config:
    enabled: true
    # 浏览功能
    watch: true                    # 动态同步
    syncToWorkspace: true          # 文件复制到 .chat-sync 目录
    # 自动导入
    autoImport: true               # 自动导入为 DSH 会话
    autoImportIntervalMs: 60000    # 扫描间隔（毫秒）
    # 高级
    maxSessions: 500               # 会话列表上限
    maxMessageChars: 8000          # 单条消息截断长度
    recentLiveMs: 180000           # 「活跃」判定窗口

配置项说明

配置项	默认值	说明
enabled	true	插件总开关
watch	true	文件监听 + SSE 推送
syncToWorkspace	true	文件复制到 .chat-sync 目录
autoImport	true	自动导入为 DSH 会话
autoImportIntervalMs	60000	自动导入扫描间隔

API（均 loopback-only）

路由	说明
GET /api/dsh-chat-sync/status	各源可用性 / 会话数 / 同步模式
GET /api/dsh-chat-sync/sessions	过滤后的会话列表
GET /api/dsh-chat-sync/session?id=<source:uuid>	消息流（增量）
GET /api/dsh-chat-sync/events	SSE 实时更新

开发与测试

node --check lib/index.js lib/sources.js lib/routes.js lib/client.js lib/auto-import.js
node tests/smoke.mjs         # 端到端测试
node tests/client-load.mjs   # 客户端加载测试

License

MIT