AgentLineage v0.1.0-alpha.4

查看文件改动，找到对应的会话。

查看文件的修改记录，以及对应的会话、工具调用和回执。

终端 · 安装 AgentLineage
dsh plugin --profile web add "git+https://github.com/fuxi-ailabs/AgentLineage.git#211057da3b42eabbf92a7f723ce8c3fa46ce05ef&path:/integrations/dsh"

把 web 换成你使用的 Profile；Git 来源需要本机 Git 和仓库访问权限。 安装步骤 ↓

功能演示安装使用

DSH 0.2.1-rc.2 · Windows x64 · 预览版

Windows x64 随插件提供完整分析环境，无需另装 Python 或 Core。 使用条件 ↓

用 Viewer 查看文件改动来源

选中文件，就能一起查看修改记录、来源会话和具体 diff。

使用场景与适合人群

适合开发者和代码审查者

审查一个可疑改动

“这段配置是谁改的？”

审查代码或配置时，按文件查看每次修改，再找到对应的会话和具体操作。

适合接手项目的人和任务负责人

接手或复盘历史任务

“昨天那个 Agent 做了什么？”

接手项目时，选一个历史任务，查看它和子会话改过哪些文件。

适合报告作者和评审者

核对报告里的依据

“这个结论有原文支持吗？”

核对归因报告中的引用，找出引用不完整或缺少原文支持的部分。

查清发布说明的三次改动

release-note.md交互演示 · 固定示例数据

谁把发布说明的状态改成了“待评审”？

EDIT / 03

✓ 成功回执

更新评审状态

把状态从“草稿”改为“待评审”。

release-note.md

            
          

        
结果第 3 次操作来自会话 demo-session-01：用 edit 把“草稿”改为“待评审”，并收到成功回执。

      


      
页面演示使用固定示例数据；视频录自真实的 DSH 会话。

      
52 秒：查询改动，查看原始记录
录屏包含创建文件、两次修改、查询，以及在 Viewer 中展开 diff 和原文的操作。附中文字幕，已剪去登录和等待过程。

      
 在 DSH 中复现
发送给 DSH
请用 DSH 的 write 工具创建 release-note.md，内容为“# 搜索功能发布说明\n功能：新增搜索\n状态：草稿”；再用 edit 分两次修改：先把“新增搜索”改为“支持标题和标签搜索”，再把“草稿”改为“待评审”。不要使用 shell 写文件。完成后刷新当前会话的 Lineage 快照，查询这个文件的三次写入，给出来源会话、调用、成功回执和原文引用。

      
    


    

      
使用前后效果对比

      
使用前：在对话里找改动
搜索文件名，逐条打开 write / edit 调用，核对参数和返回结果。
使用后：按文件查看记录
选中 release-note.md，就能一起查看三次写入、来源会话和具体 diff。

      
 同一文件的操作集中显示
 每次修改都附有来源会话
 通过引用核对原始记录

    


    

      
安装与验证

      

        
使用条件
支持平台
Windows x64；DSH 0.2.1-rc.2、Node.js 24+，插件 0.1.0-alpha.4。
自动安装的组件
隔离的 Python、匹配版本的 Core、依赖库和 Viewer。其他系统可使用高级外部服务配置。
安装来源
需要本机 Git 和 AgentLineage 源码仓库的访问权限。


        
适用范围和限制 
安装失败可以直接恢复
运行缓存损坏会从随包材料重建；安装材料不完整时，在插件详情重新安装此版本。修复保留分析记录，不需要另外配置 Python。
新改动需要刷新快照
插件会按需生成快照。文件继续修改后，发送“刷新当前会话的分析材料”，再查看新记录。
部分操作可能没有完整记录
未导入的会话、缺少成功回执的调用，以及 shell 脚本内部的文件操作，都可能没有完整记录。
查到来源后，仍需验证结果
来源和引用可以用来核对操作过程。代码是否正确、结论是否成立，还要结合测试和实际结果判断。

      

      
  1. 在 DSH 安装插件 将 AgentLineage 0.1.0-alpha.4 安装到你使用的 Profile；需要时替换命令中的 web。 已有旧版本时，先卸载再安装新版，分析记录和会话绑定会保留。安装同时提供 Windows x64 运行环境；若 DSH 提示需要重启，按提示完成重启。 终端
    dsh plugin --profile web add "git+https://github.com/fuxi-ailabs/AgentLineage.git#211057da3b42eabbf92a7f723ce8c3fa46ce05ef&path:/integrations/dsh"
  2. 检查服务是否就绪 在插件详情等待“AgentLineage 已就绪”，或在 DSH 中检查运行状态。 若出现校验失败、目录占用或超时，页面会显示具体原因和重试操作。无需打开终端安装 Core。 发送给 DSH
    请调用 lineage_status，确认 Core 能力包含 dsh-native-v4。不要显示任何 token。
  3. 运行发布说明例子 创建 release-note.md，修改两次，再查询三次写入来源。 发送给 DSH
    请用 DSH 的 write 工具创建 release-note.md，内容为“# 搜索功能发布说明\n功能：新增搜索\n状态：草稿”；再用 edit 分两次修改：先把“新增搜索”改为“支持标题和标签搜索”，再把“草稿”改为“待评审”。不要使用 shell 写文件。完成后刷新当前会话的 Lineage 快照，查询这个文件的三次写入，给出来源会话、调用、成功回执和原文引用。
  4. 打开 Viewer 查看记录 在 Viewer 中选中 release-note.md 并展开 diff。后续有新改动时，刷新快照再查询。 从插件详情点击“打开溯源视图”，或使用 lineage_open 返回的同源地址。复用 DSH 登录，无需读取或粘贴 Core 凭据。 发送给 DSH
    打开当前分析快照的 Viewer。

      
检查结果 
  1. 在 DSH 安装插件
    AgentLineage 0.1.0-alpha.4 出现在已安装插件中，并开始准备本地分析服务。
  2. 检查服务是否就绪
    页面显示“AgentLineage 已就绪”；lineage_status 的 runtime.state 为 ready，能力包含 dsh-native-v4。
  3. 运行发布说明例子
    release-note.md 有三次确认写入；最后一次将“草稿”改为“待评审”，并有对应的调用和回执引用。
  4. 打开 Viewer 查看记录
    选中 release-note.md 后，能查看三次写入及对应的 diff。

      
安装与使用文档 ↗

    


    

      
常见问题

      
安装后还需要手动安装 Python 或 Core 吗？
Windows x64 版随插件提供隔离的 Python、匹配版本的 Core、依赖库和 Viewer，无需另外安装 Python 或 Core。需要已有的 DSH、Node.js 24+，以及 Git 来源所需的 Git 和仓库访问权限。其他系统按文档配置外部服务。
为什么看不到刚刚的文件改动？
插件按需生成快照。文件继续修改后，发送“刷新当前会话的分析材料”，再查询这个文件。
所有文件操作都会有记录吗？
未导入的会话、缺少成功回执的调用，以及 shell 脚本内部的文件操作，都可能没有完整记录。查到来源后，代码和结论是否正确仍需要通过测试和实际结果验证。
运行环境损坏或安装失败了，怎么恢复？
运行缓存损坏时，插件会用随包材料重建。安装材料不完整时，在插件详情中选择重新安装此版本。修复会保留分析记录，不需要另外配置 Python；其他启动错误按页面提示重试。
打开 Viewer 时需要填写 Core 凭据吗？
不需要。从插件详情点击“打开溯源视图”，或使用 lineage_open 返回的同源地址。Viewer 复用 DSH 登录，无需读取或粘贴 Core 凭据。

    

  

  
  

  
运行截图