Skip to content

IssueLens v0.1.0 — Initial Public Baseline / 首个公开基线

Pre-release
Pre-release

Choose a tag to compare

@eatdrop eatdrop released this 03 Aug 03:26
199ca73

IssueLens v0.1.0 是首个公开 Alpha 基线,展示一个本地优先、证据可追溯、默认只读的 Python Coding Agent。

IssueLens v0.1.0 is the first public alpha baseline of a local-first, evidence-grounded, read-only-by-default Coding Agent for Python repositories.

核心能力 / Highlights

  • 解析 Issue,并结合文本检索与 Python AST 索引定位候选代码。
    Parse Issues and locate candidate code with text retrieval and a Python AST symbol index.
  • 为诊断和修改计划保留文件、行号、代码片段及内容哈希证据。
    Preserve file, line, snippet, and content-hash evidence for diagnoses and change plans.
  • 通过路径、符号链接和前后快照校验证明分析过程没有修改目标仓库。
    Use path, symlink, and before/after snapshot checks to prove that analysis did not modify the target repository.
  • 提供有步数预算、显式工具契约和完整 Trace 的离线与 LLM Agent Policy。
    Provide offline and LLM Agent policies with step budgets, explicit tool contracts, and complete traces.
  • 支持 Unified Diff 策略检查、快照绑定提案、显式哈希审批、临时副本预检和内容寻址审计回执。
    Support Unified Diff policy checks, snapshot-bound proposals, explicit hash approval, temporary-copy preflight, and content-addressed audit receipts.
  • 运行时只依赖 Python 标准库;离线演示不需要 API Key。
    Use only the Python standard library at runtime; the offline demo requires no API key.

可复现验证 / Reproducible Verification

  • 90 项自动化测试通过,GitHub CI 覆盖 Python 3.11 与 3.12。
    All 90 automated tests pass, with GitHub CI covering Python 3.11 and 3.12.
  • 在 3 个合成冒烟案例的 deterministic baseline 上,两个代码定位案例的 Hit@1、Gold File Recall@3 与 MRR 均为 1.0。
    On a three-case synthetic smoke evaluation of the deterministic baseline, both localization cases achieve Hit@1, Gold File Recall@3, and MRR of 1.0.
  • 唯一的信息不足案例被安全拒绝,全部 3/3 次运行保持目标仓库快照不变。
    The sole underspecified case is safely rejected, and all 3/3 runs preserve the target-repository snapshot.

这些数字只描述固定合成夹具,不能代表真实公开 Issue 或陌生仓库上的通用准确率。

These numbers describe only fixed synthetic fixtures and do not establish general accuracy on real public Issues or unfamiliar repositories.

快速开始 / Quick Start

make demo
make patch-demo
make eval
make test

当前边界 / Current Scope

  • 本版本是可复现的 deterministic baseline,不声称能够自动修复任意 Issue。
    This release is a reproducible deterministic baseline and does not claim to repair arbitrary Issues automatically.
  • 补丁预检只在临时副本中进行,不会写入真实目标仓库。
    Patch preflight runs only in a temporary copy and never writes to the real target repository.
  • 当前评测不执行目标仓库测试,也不计算 Resolved@1。
    The current evaluation does not execute target-repository tests or calculate Resolved@1.
  • Docker Shadow Workspace、真实公开 Issue 时间切分评测和 GitHub Draft PR 集成仍在路线图中。
    Docker shadow workspaces, time-split evaluation on real public Issues, and GitHub Draft PR integration remain on the roadmap.