Gitlines for DeepSeek Harness

让 Git 提交、代码差异和 AI 修改记录出现在同一个工作台。

English · 安装包 · 问题反馈

Gitlines 是独立安装的 DeepSeek Harness 插件。浏览提交时，先看到改动的原因、影响和上下文；需要核对代码时，再打开文件树和 Diff。AI 可以维护概览，也可以把一次跨文件修改保存成可审阅的流程标记。

能做什么

• 提交图谱：展示作者、分支、提交与父提交的关系；图例解释普通连线和合并。颜色区分历史路径，不代表作者或固定分支。
• 提交概览：摘要、变更原因、影响范围、核心变更、上下文、依赖关系和相关文档。支持手动编辑或让 AI 整理并保存。
• 文件树与 Diff：可折叠目录、文件筛选、统一与并排差异、面板拉伸；同时支持已提交和未提交文件。
• 会话追踪：查看同一文件在不同会话、不同回复中的成功编辑记录，保留具体调用的位置。来源记录和完整原会话各有入口。
• 流程标记：把目标、涉及文件、完成内容和后续事项归在一起；选择一个流程后，回到原会话继续修改，保留已有草稿，由你发送。
• 文档中心：按分支和提交组织可编辑的本地归档。
• 本地运行：显示仓库相关的监听进程与端口，不包含测试结果面板。

文件树与代码差异

截图使用公开的 DeepSeek Harness 仓库，来自 Gitlines 开发预览；不包含用户的私有项目或会话内容。

安装

本版本针对 DeepSeek Harness 0.2.1-rc.5。Harness API 尚未稳定，其他版本请先核对兼容性。Git 需要在本机可执行。

桌面版

1. 打开 Harness 的 插件 → 添加插件。

2. 粘贴以下固定版本的 GitHub 地址：

   git+https://github.com/xiaowuDev/dsh-gitlines.git#v0.1.0
   

3. 安装并启用 Gitlines。如果界面未刷新，重启 Harness。

4. 在工作区中选择一个本地 Git 仓库，从侧栏打开 Gitlines。

也可下载 Release 中的 dsh-gitlines-0.1.0.tgz，通过添加插件入口安装。发布包已包含构建产物，安装时不需要构建插件。

CLI / Web

在已经安装 dsh 的环境中执行：

dsh plugin add 'git+https://github.com/xiaowuDev/dsh-gitlines.git#v0.1.0'

Desktop 的插件由 Desktop 自己管理；不要用 CLI 修改它的专用 profile。

常用流程

了解一次提交：提交图谱 → 选择提交 → 概览 → 请 AI 整理概览。请求进入该提交的原会话，AI 读取事实与当前版本后保存，完成后自动更新概览。

审阅未提交修改：未提交变更 → 展开目录 → 查看 Diff → 会话追踪。历史记录表明某个会话曾编辑文件；它不等于当前 Diff 每一行的作者归属。

继续一个流程：流程标记 → 选择流程 → 带入 AI 继续修改。插件重新打开原会话并准备包含流程 ID 的草稿，不自动发送，也不创建替代会话。缓存是否命中仍取决于模型与提供方。

AI 工具

工具	用途
gitlines_history	读取本地提交历史
gitlines_read_commit	读取提交、变更文件与当前概览版本
gitlines_read_file_diff	读取指定文件差异
gitlines_read_document	读取该提交中的相关文档
gitlines_update_overview	按 expectedRevision 保存概览
gitlines_checkpoint_workflow	保存一个已完成阶段及其文件、上下文和会话位置
gitlines_read_workflows	读取流程与前序流程
gitlines_file_history	查看一个文件的会话编辑历史

AI 的聊天回答不会自动被当作已保存概览；需要成功调用保存工具。并发修改使用版本检查，冲突会明确返回。

数据与权限

your-repository/
└── gitlines/
    ├── <encoded-branch>/
    │   └── <full-commit-sha>/
    │       ├── overview.json
    │       ├── overview.md
    │       └── evidence.json
    └── .workflows/
        └── <workflow-id>.json

• Git 查询只读，不 fetch、不 checkout、不提交或推送，不修改暂存区。
• 显式保存概览或流程时，写入当前仓库的 gitlines/。是否把这些归档纳入 Git 由你决定。
• 会话追踪读取本地 Harness 会话记录。没有成功编辑证据时显示缺失，不猜测归属。
• 插件不收集遥测、不提供独立云端服务。你明确请求 AI 处理时，相关上下文会经 Harness 发送给当前配置的模型提供方。
• 插件 Host 代码在 Harness 进程中执行；AI 归档写入仍遵守 Harness 当前工作区权限与只读模式。

兼容性与边界

• 标准桌面版没有公开的原生聊天精确滚动接口。Gitlines 使用自己的来源面板展示具体回复或工具记录，同时提供打开完整原会话的入口；不替换 Harness 的聊天组件。
• 流程标记记录说明与编辑证据，不冻结阶段文件内容。“查看当前变更”展示的是当前工作树。
• 外部编辑器、Shell 命令和插件安装前没有保留的编辑记录不能可靠归属到某个会话。
• 依赖图来自 manifest 声明，不代表完整运行时调用关系；大仓库和会话历史受到读取上限约束，截断会明确标出。
• 本地监听进程发现使用 lsof；不支持的平台会显示没有观测到的运行项。

卸载

在 Harness 的 插件 页面禁用或移除 Gitlines，然后按提示重启。卸载不会删除仓库中的 gitlines/ 归档或 Harness 原会话。需要删除归档时，请先自行备份。

本地开发

npm ci
npm run typecheck
npm test
npm run build

源码位于 src/，构建脚本位于 scripts/build.mjs，插件组合入口为 cordis.patch.yml。lib/ 随版本提交，保证从 GitHub 安装时无需执行构建。修改源码后，请重新构建并一并提交产物。

许可

MIT。Gitlines 是社区项目，与 DeepSeek 官方无隶属关系。上游代码归属见 NOTICE。