dcode 如何用 -r 恢复历史会话并查看线程列表【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagentsdeepagents-codeCLI 命令名为dcode是 deepagents 项目提供的终端编码代理。用过一段时间之后历史上的每次对话都会留下一个线程thread当你中断了任务、想接着之前的会话继续时需要两步先用dcode threads list找到目标线程及其 ID再用dcode -r恢复它。这两条命令都面向本地 TUI交互式终端模式。准备条件已安装 dcode。官方安装命令来自libs/code/README.md该脚本会在本机环境中完成 dcode 的安装curl -LsSf https://langch.in/dcode | bash至少存在一个历史线程。线程状态保存在本地 SQLite 数据库sessions.db位于全局状态目录DEFAULT_STATE_DIR/sessions.db中它既是线程列表的数据来源也是恢复会话所用的检查点存储。注意两个模式边界-r只在 TUI 交互模式生效headless 模式dcode -n 任务每次都会创建新线程反过来threads list/ls和threads delete直接读取 SQLite不需要启动 agent 就能工作。用 threads list 查看线程列表主路径dcode threads listls是list的别名等价可用dcode threads ls列表每一行都来自检查点元数据包含 agent 名称、创建/更新时间、Git 分支、工作目录和最新检查点 ID初始提示词prompt和可见消息条数在需要时从检查点数据中重建。选择目标线程时重点看工作目录和更新时间是否对得上你当时的任务。可选的过滤与显示参数定义见 main.py参数用途--agent name按 agent 名称过滤默认显示全部-n,--limit N最多显示的线程数默认 20--sort created\|updated按创建或更新时间排序默认取配置值或updated--branch name按 Git 分支名过滤--cwd [path]按工作目录过滤不带值时使用当前目录带路径则按该目录过滤-v,--verbose显示全部列branch、created、prompt-r,--relative以相对时间显示时间戳两个容易踩的点其一threads list子命令里的-r是--relative相对时间显示与顶层用于恢复会话的-r无关其二--cwd过滤对存储的工作目录做精确字符串比较不做路径规范化、不解析符号链接——如果加了--cwd后查不到线程先去掉该参数确认线程本身存在。用 -r 恢复历史会话拿到目标线程 ID 后有两种恢复方式恢复最近一个线程dcode -r恢复指定线程参数定义见 main.pydcode -r thread_id其中thread_id替换为dcode threads list输出中的线程 IDUUID7 格式本身按时间可排序。恢复启动时 TUI 状态栏会显示Resuming...历史消息从检查点水合回会话无需重放历史。在 TUI 内部也可以用/threads斜杠命令浏览并恢复历史线程如/threads -r ID见 COMMANDS.md与启动时直接带-r的效果一致。恢复时的判断方法恢复不一定一次成功以下现象在文档中有明确说明可作为下一步判断依据被时间上限拦截如果配置了线程年龄上限绝对或滚动过期线程会被阻止恢复此时可选择开启新线程或退出。工作目录不匹配当前目录与线程存储的目录不一致时会提示切换目录。ID 输错未知的 ID 会给出相似 ID 的建议而不是直接失败。数据库故障或拒绝了恢复会回退到新建线程。因此如果dcode -r ID之后看到的是全新线程先重新运行dcode threads list核对 ID再检查年龄上限与工作目录这两项。可选清理不再需要的线程dcode threads delete thread_id --dry-run dcode threads delete thread_id--dry-run先显示将会发生什么、不做实际修改。删除会移除该线程的检查点与写入行并尽力清理其对应的 offload 会话历史归档。边界与数据位置-r是 TUI 专属能力headless 模式永远创建新线程需要可恢复的对话请使用交互模式。状态数据库是全局的sessions.dbWAL 模式下还带有sessions.db-wal和sessions.db-shm两个伴生文件。备份或迁移会话数据时三者必须一起移动避免拆散 WAL 模式的数据库。启动时 dcode 会把旧状态目录~/.deepagents/中的内部条目含sessions.db及其伴生文件尽力迁移到~/.deepagents/.state/该迁移是幂等且失败不阻塞启动的。如果迁移报告冲突旧路径与新路径同时存在文件文档建议先人工检查两份副本再决定如何处理不要假定哪一份可以丢弃。参考资料Run a dcode Session、State, Sessions, and Workspace Persistence、libs/code/README.md、libs/code/CHANGELOG.md。【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考