Skip to content

feat: clarify PatchProof value and quick start - #2

Merged
eatdrop merged 1 commit into
mainfrom
agent/improve-project-front-door
Aug 3, 2026
Merged

feat: clarify PatchProof value and quick start#2
eatdrop merged 1 commit into
mainfrom
agent/improve-project-front-door

Conversation

@eatdrop

@eatdrop eatdrop commented Aug 3, 2026

Copy link
Copy Markdown
Owner

内容 / What Changed

  • 重新定位 PatchProof:首页直接说明目标用户、真实痛点,以及它相对普通单次 CI 的差异。
  • Reposition PatchProof so the front page immediately explains the target user, real pain point, and differentiation from typical one-pass CI.
  • 新增基于真实夹具输出的终端 SVG、三分钟 Quick Start、适用/不适用范围、成熟度表和双语 FAQ。
  • Add a terminal SVG based on real fixture output, a three-minute quick start, fit/non-fit guidance, a maturity table, and bilingual FAQ.
  • 新增 make demo-local 一键 Demo;无需 Docker 与第三方依赖,并验证真实仓库未变、回执完整性可重验。
  • Add a one-command make demo-local flow with no Docker or third-party dependency, verifying an unchanged repository and re-verifiable receipt integrity.
  • 新增 patchproof verify-receipt CLI,让用户可以重新验证严格结构、阶段语义和内容哈希。
  • Add patchproof verify-receipt so users can revalidate strict structure, phase semantics, and content hashes.
  • 优化 PyPI/GitHub 搜索元数据并将版本提升至 0.1.1
  • Improve PyPI/GitHub discovery metadata and bump the version to 0.1.1.

原因 / Why

原首页技术细节完整,但用户需要较长时间才能判断“为什么不用普通 CI”,快速开始也要求手工执行多个步骤。更重要的是,回执价值缺少面向用户的重验入口。这让一个有明确工程边界的项目看起来更像完整但缺乏产品入口的技术样例。

The original page was technically complete, but users needed too long to understand why typical CI was insufficient, and the quick start required several manual steps. More importantly, receipts lacked a user-facing verification entry point. That made an intentionally bounded engineering protocol look like a complete yet productless technical sample.

验证 / Validation

  • PYTHONPATH=src python3 -m unittest discover -s tests -v — 71 passed
  • make demo-local — four phases pass, repository unchanged, receipt integrity verified
  • git diff --checkgit diff --cached --check / Both whitespace checks pass
  • 所有 Markdown 保持中英双语,内部相对链接全部存在 / All Markdown remains bilingual and every relative link resolves
  • SVG 通过 XML 校验并完成实际渲染检查 / SVG passes XML validation and was visually rendered for inspection
  • Wheel 0.1.1 构建、隔离安装和版本导入通过 / Wheel 0.1.1 builds, installs into an isolated target, and imports successfully

产品边界 / Product Boundary

本次没有把项目包装成通用平台。README 明确说明当前面向 Coding Agent 基础设施与评测工程师,只支持有界 UTF-8 Unified Diff、固定 unittest 与可信单租户宿主上的 Docker 加固;不声称生产多租户沙箱、身份认证或广泛采用。

This update does not present the project as a universal platform. The README explicitly targets coding-agent infrastructure and evaluation engineers, supports bounded UTF-8 unified diffs, fixed unittest, and Docker hardening on a trusted single-tenant host, and does not claim production multi-tenant sandboxing, identity authentication, or broad adoption.

@eatdrop
eatdrop marked this pull request as ready for review August 3, 2026 07:23
@eatdrop
eatdrop merged commit 17ffb61 into main Aug 3, 2026
3 checks passed
@eatdrop
eatdrop deleted the agent/improve-project-front-door branch August 3, 2026 07:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant