【免费下载链接】pxpipecut Claude Code token usage by rendering text context as images项目地址https://gitcode.com/gh_mirrors/px/pxpipe点击查看免费下载导读pxpipe 是一个通过把冗长的文本上下文渲染为高密度 PNG 图片来削减 Claude Code token 消耗的代理项目其核心工作围绕模型可读性、token 节省、guard 行为展开。本文基于仓库根目录的 CONTRIBUTING.md完整讲解向 pxpipe 提交贡献时必须遵守的规则——从一个 PR 一个根因、强制脱敏、CI 绿灯到模型行为声明必须携带的六项证据字段再到评估eval、问题分诊与维护者晋升路径。读完本文你将掌握一套可复制的带收据receipts的贡献工作流知道如何写一份既不会被驳回、又能快速被合入的 pxpipe PR。一、项目背景与维护哲学为什么小 PR 收据会合并得快CONTRIBUTING.md 开篇就给出了一条与众不同的核心原则Small PRs with receipts merge fast.这句话是理解整个贡献规范的关键。pxpipe 由作者在一个周末内构建、以兼职方式维护审查速度有限因此规范被设计成用最少的维护成本换取最高的信息密度小 PR一次只解决一个根因便于快速定位与审查收据receipts任何关于模型行为的声明都必须附带可复现的实验证据而不是我觉得它变好了。这一文化不是空谈它贯穿了整个仓库。在 README.md 的 Benchmark results and receipts 一节中每个模型的质量数据都附带了profile provenance and receipts列指向具体的评估目录例如claude-fable-5的算术与 hex 收据指向 FINDINGS.mdgist/state/guards 收据指向 eval/gist-recall/Gemini 的收据指向 eval/gemini-profile/QUALITY_RESULTS.md。也就是说README 向读者承诺的标准正是 CONTRIBUTING.md 要求贡献者遵守的标准——The same standard I hold the README to。同时维护者对项目定位有清醒的认知它仍是一个实验场用于验证上下文以图片形式呈现是否会成为新常态见 CONTRIBUTING.md 的 Becoming a maintainer 一节。因此贡献者不应把 pxpipe 视为一个已经定型的项目而应把它当作一个需要不断用证据迭代的实验平台。二、硬性规则Rules四条不可逾越的红线CONTRIBUTING.md 的 Rules 部分是提交任何 PR 的前提违反任何一条都会直接导致 PR 无法合并。1. 一个 PR 一个根因One root cause per PR不相关的修复必须拆分到独立 PR。这一规则在什么会停滞一节中再次强调触及与声明根因无关文件的 PR会拖慢合并。对于 pxpipe 这种几份文件经常变动的小项目混入无关改动会让审查者难以判断真实影响也极易与主线分支产生冲突。2. 提交前基于当前 main 分支 rebaseCONTRIBUTING.md 明确警告仓库中有几份文件变动非常频繁陈旧分支几乎会立刻与之冲突A few files churn constantly; stale branches conflict with them almost immediately。从源码结构看这些高频变动文件包括 src/core/render.ts、src/core/transform.ts、src/core/atlas.ts 以及 src/core/ 下的模型 profile 文件如 claude-model-profiles.ts、gemini-model-profiles.ts——任何涉及渲染几何、profile 参数或评估逻辑的改动都会触碰这些文件。因此开工前先git rebase到最新的main而不是用git merge堆积合并提交。3. 脱敏红线Redaction禁止任何真实敏感数据进入仓库这是 pxpipe 作为处理 API 凭证与可能包含机密 prompt 的代理所特有的强制要求。PR 描述、issue、测试夹具test fixtures以及提交的日志中严禁出现原始 promptraw prompts凭证credentials会话文件session filesAPI key机器标识符machine identifiers主机名、用户名、绝对路径形式的主目录absolute home paths。规范给出的替代方案是使用编造的复现数据made-up repro data。这与仓库的安全模型一脉相承——SECURITY.md 明确说明 pxpipe 会处理 API 凭证与机密 prompt并规定PXPIPE_DEBUG_CAPTURE_4XX这类会捕获请求体的开关不得在生产开启因为捕获的请求体可能包含 prompt 与凭证。因此任何提交到仓库的复现样例都必须是合成数据。4. CI 绿灯pnpm test与pnpm typecheck必须本地通过规范要求提交前本地执行并通过pnpm test pnpm typecheck从 package.json 可以确认这两个命令的真实含义命令底层实现作用pnpm testvitest run运行全部 vitest 单元测试仓库现有约 80 个测试文件覆盖渲染、变换、缓存、网关、代理、历史几何等pnpm typechecktsc --noEmitTypeScript 全量类型检查不产出文件仓库的发布前检查链更完整package.json 中的prepublishOnly为pnpm run typecheck pnpm test pnpm run build即类型检查、测试、构建三步串行。贡献者在本地至少应跑通前两步若改动涉及渲染输出建议再执行pnpm run build以验证编译产物。引擎要求node 20.19包管理器为pnpm10.21.0见 package.json。三、仅适用时必需Required only when applicable声明必须携带证据这是 CONTRIBUTING.md 技术含量最高的一节。它规定当你的 PR 涉及以下两类声明时必须附带指定的证据字段否则不予采信。1. 模型行为声明六项证据字段凡涉及模型行为的声明——包括可读性readability、节省savings、guard 标志guard flags、拒绝refusals——必须附带model id模型标识如claude-fable-5、google/gemini-3.6-flashdate测试日期client version客户端版本如 Claude Code 版本render geometry渲染几何字体、字号、列数、页尺寸如 Spleen 5×8, 312 columns, 728pxsample size样本量 Nfailure categories失败分类而非笼统的失败。这套字段不是空泛要求仓库中的正式评估报告就是按此标准撰写的。以 eval/gemini-profile/QUALITY_RESULTS.md 为例其开头即声明Model:google/gemini-3.6-flashmodel id使用的生产配置shipped Spleen 5×8, 312-column, 728px profile and adjacent text factsheetrender geometry每项测试附 N 与分数novel arithmetic N100 得 100/100、gist recall 98/98、state tracking 18/18、never-stated guards 0/16样本量与失败分类、dense 12-char hex 14/15。同样README.md 的模型质量矩阵把numbers at测量所用渲染几何单独设列并逐行标注收据来源。这意味着贡献者写的评估报告应当具备同样的结构而不是一段我试了试效果不错的模糊描述。2. 定价声明来源 URL 日期凡涉及 provider 定价pricing的声明必须附带来源 URL 和日期。这是因为 token 节省率高度依赖各家 provider 的视觉 token 计价公式——README.md 明确写道image tokens use each models provider formula and actual rendered page dimensions且These figures establish profile cost on this corpus, not a universal workload savings rate。若你声称某个渲染几何在某 provider 下节省了多少百分比就必须给出计价来源与测量日期否则该数字无法被复核。3. 安全报告走 SECURITY.md不走公开 issue发现安全漏洞时不要在公开 issue 中报告。SECURITY.md 给出了完整流程使用 GitHub 的私有漏洞报告通道private vulnerability reporting form报告内容尽量包含受影响版本与运行时Node 或 Cloudflare Workers、可复现所需部署配置移除凭证、安全影响与触发者、最小复现步骤或 PoC、建议的缓解措施维护者会确认报告、评估严重性、协调修复与发布并在报告人未要求匿名的前提下致谢在补丁落地前请勿公开漏洞细节。此外 SECURITY.md 的部署安全条款也值得贡献者注意Node 服务应保持默认 loopback 绑定除非置于带认证与加密的反向代理之后Cloudflare Workers 注入 provider 凭证时必须配置PXPIPE_WORKER_SECRET否则 Worker 会 fail closed生产环境不得开启PXPIPE_DEBUG_CAPTURE_4XX。四、锦上添花Nice to have让审查者 30 秒内完成复核1. 先写一个失败测试再写修复规范建议先红后绿a failing test first, then the fix。pxpipe 的测试资产非常丰富贡献者可以参考现有测试的写法。例如 tests/render.test.ts 验证了模型可选字体的单元格几何默认 Spleen 5×8、jetbrains-mono-10 为 6×11、jetbrains-mono-12 为 8×13、jetbrains-mono-14 为 9×16并断言渲染 PNG 的像素尺寸随之变化tests/render.test.ts 则验证了 Sol 紧凑图集之外的 Unicode 会回退到完整 Spleen/Unifont 图集且droppedChars为 0。如果你的改动涉及渲染、变换或图集这类断言模式就是现成的模板。2. 在 PR 描述中给出精确命令与其输出规范要求在 PR 描述中写入确切的命令及其输出让审查者可以重新运行而不是重新推导re-run instead of re-derive。pxpipe 的评估体系为此提供了现成的 CLI。以 eval/run-eval.mjs 为例其支持的选项包括选项默认值说明--level 1\|2\|allall运行 L1OCR 保真或 L2会话回放或全部--dry-runfalse不发 API 请求用模拟分数跑通流程--confirmfalse真实 API 花费必须显式确认--estimate-onlyfalse只打印成本估算并退出--max-blocks N20L1 文本块数--max-sessions N10L2 会话数--model NAMEclaude-sonnet-4-5回放与转录模型--judge-model NAME同--modelL2 评判模型在 PR 描述中贴出如下形式的命令输出正是规范想要的收据node eval/run-eval.mjs --level 1 --dry-run # 无 API 花费验证链路 node eval/run-eval.mjs --estimate-only # 打印成本估算 node eval/run-eval.mjs --level all --confirm # 真实运行需 ANTHROPIC_API_KEY关于评估成本eval/README.md 给出了参考区间L1 单次20 块claude-sonnet-4-5约 40 次 API 调用、约 $0.50–$1.00L2 单次10 会话约 $1.50–$4.00完整 L1L2 约 $2.00–$5.00可用--model claude-haiku-4-5降低约 4 倍成本。这些数字可帮助贡献者在提交评估类 PR 前自行估算花费。3. 三行修复 清晰复现胜过堆砌规范特别强调A three-line fix with a clear repro is a good PR. Do not bulk it up to look more serious.不要为了显得重要而人为扩充 PR 范围——这与一个 PR 一个根因相互呼应。五、什么会拖慢合并What tends to stall三类典型拒收场景CONTRIBUTING.md 明确列出了会让 PR 停滞的三类情况贡献者应主动规避需要在每个模型上都测试才能验证的模型行为声明。规范的态度是Ship what a test can check; leave the judgment call to me.——凡测试可覆盖的部分请用测试证明凡是需要跨全部模型逐一验证的宽泛判断交给维护者裁决。这与仓库的现实约束一致README 的模型矩阵中就有大量未运行—的格子项目并不追求全模型覆盖。触及与声明根因无关文件的 PR。如前所述这是对一个 PR 一个根因的强化。没有调用方no caller的新 opt-in 标志。pxpipe 对新增配置开关非常克制——如果你引入一个新的PXPIPE_*环境变量或 dashboard 选项却没有一处真实调用、没有测试覆盖它这类改动基本不会被合入。从源码看现有配置项如 README.md 提到的PXPIPE_MODELS、PXPIPE_GPT_HISTORY_MAX_IMAGES都有明确的生产调用路径与防御性上限defensive cap 100新增标志应遵循同样的标准。六、成为维护者Becoming a maintainer无需正式流程的晋升路径CONTRIBUTING.md 的最后一节描述了开放、非正式的维护者招募机制If you want to help maintain this, tell me. I grant commit access on track record: a few good PRs plus useful issue triage. No formal process.获得 commit 权限的条件是业绩记录几个质量良好的 PR 加上有实质价值的问题分诊issue triage。没有正式流程、没有考试、没有评审委员会。维护者最需要的三类帮助恰好对应仓库目前最薄弱的环节评估结果Eval results在自己的硬件与 provider 上跑出各模型的可读性与节省数据并附上前述六项证据字段。CONTRIBUTING.md 直言This is the work that stalls PRs today.——评估数据不足正是当前拖慢 PR 的主要原因。参考格式见 eval/gemini-profile/QUALITY_RESULTS.md 与 eval/README.md后者完整描述了 L0 单元测试、L1 OCR 保真、L2 任务级会话回放的评估体系及其门槛阈值L1 平均字符准确率 delta ≥ −2pp 可接受、L2 平均 judge 分数 ≥ 0.80 才能放行 reflow。问题分诊Issue triage复现repro、打标签label、关闭重复 issueclose duplicates。评审Review为 render 与 transform 相关的 PR 提供第二双眼睛。这两块正是项目的技术核心——src/core/render.ts 负责文本到 PNG 的渲染管线renderChunkToPng、renderTextToPngs等src/core/transform.ts 负责请求变换与压缩收益判断transformRequest、isCompressionProfitable、maxCharsPerImage等。值得注意的是维护者在这节还写了一句颇有实验精神的自我定位First disbelieved, then called a temp hack.——项目被质疑过、被称作临时 hack但作者仍希望验证context as images是否会成为常态。对潜在维护者而言这意味着你加入的是一个仍在被检验方向的实验性项目而非一个功成名就的稳定库。七、贡献者速查清单提交 pxpipe PR 的完整路径把 CONTRIBUTING.md 的全部要求浓缩为一份可执行清单提交前基于最新mainrebase避免高频变动文件render/transform/atlas/profile冲突本地通过pnpm testvitest run与pnpm typechecktsc --noEmit检查所有内容已脱敏无原始 prompt、凭证、会话文件、API key、主机名/用户名/绝对主目录路径复现数据一律使用合成数据若有模型行为声明可读性/节省/guard/拒绝补齐六项证据字段model id、日期、客户端版本、渲染几何、样本量、失败分类若有定价声明附来源 URL 与日期若为安全漏洞走 SECURITY.md 的私有上报通道绝不发公开 issue。PR 内容一个 PR 只解决一个根因不混入无关文件优先先失败测试、后修复渲染/变换改动参考 tests/render.test.ts 的断言风格PR 描述中贴出确切的复现命令与输出让审查者可重跑而非重推三行修复 清晰复现是好 PR不要刻意膨胀不新增无调用方的 opt-in 标志。想长期参与提交自己的硬件/provider 上的评估结果这是目前最缺的工作参与 issue 分诊复现、打标签、关闭重复项为 render/transform 的 PR 提供评审意见直接向维护者表达意愿以 PR 业绩与分诊贡献换取 commit 权限。结语pxpipe 的贡献规范本质上是一套为证据驱动的小步迭代而设计的工程纪律脱敏红线保护了代理类工具特有的隐私风险六项证据字段让每个模型行为声明都可复核评估 CLI 让收据的生成成本降到最低而开放的维护者路径则在为项目补充最稀缺的评估产能。对贡献者来说遵守这份规范不仅是为了让 PR 快速合并更是为了加入一个用实验数据而非直觉驱动决策的开源项目。若你计划提交第一个 PR最稳妥的起点是挑一个明确的根因写一个失败测试附上可重跑的命令与输出然后在描述中声明这属于测试可覆盖的修复判断性结论留给维护者。这就是一份带收据的小 PR的标准形态。赞分享【免费下载链接】pxpipecut Claude Code token usage by rendering text context as images项目地址https://gitcode.com/gh_mirrors/px/pxpipe点击查看免费下载相关推荐变更描述变更描述 简要说明实现的功能或修复的问题 实现细节 核心算法说明 关键API变更 兼容性处理 测试验证 单元测试覆盖率 80% 已在Android 10设备验音视频移动开发trouble.nvim贡献指南提交PR的步骤与规范trouble.nvim贡献指南提交PR的步骤与规范 一、贡献前准备 1.1 环境搭建 bash 克隆仓库 git clone https://gitcode开发工具How do I install a custom image?How do I install a custom image? In order to download an unsupported ISO image,虚拟化上一篇PS4存档管理工具终极指南Apollo Save Tool让备份、迁移、修复一次到位下一篇WVP-PRO 视频监控平台快速上手指南多品牌设备统一接入与国标级联一文读懂创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
pxpipe 贡献指南：以“带收据的小 PR”为核心的提交规范与证据文化
【免费下载链接】pxpipecut Claude Code token usage by rendering text context as images项目地址https://gitcode.com/gh_mirrors/px/pxpipe点击查看免费下载导读pxpipe 是一个通过把冗长的文本上下文渲染为高密度 PNG 图片来削减 Claude Code token 消耗的代理项目其核心工作围绕模型可读性、token 节省、guard 行为展开。本文基于仓库根目录的 CONTRIBUTING.md完整讲解向 pxpipe 提交贡献时必须遵守的规则——从一个 PR 一个根因、强制脱敏、CI 绿灯到模型行为声明必须携带的六项证据字段再到评估eval、问题分诊与维护者晋升路径。读完本文你将掌握一套可复制的带收据receipts的贡献工作流知道如何写一份既不会被驳回、又能快速被合入的 pxpipe PR。一、项目背景与维护哲学为什么小 PR 收据会合并得快CONTRIBUTING.md 开篇就给出了一条与众不同的核心原则Small PRs with receipts merge fast.这句话是理解整个贡献规范的关键。pxpipe 由作者在一个周末内构建、以兼职方式维护审查速度有限因此规范被设计成用最少的维护成本换取最高的信息密度小 PR一次只解决一个根因便于快速定位与审查收据receipts任何关于模型行为的声明都必须附带可复现的实验证据而不是我觉得它变好了。这一文化不是空谈它贯穿了整个仓库。在 README.md 的 Benchmark results and receipts 一节中每个模型的质量数据都附带了profile provenance and receipts列指向具体的评估目录例如claude-fable-5的算术与 hex 收据指向 FINDINGS.mdgist/state/guards 收据指向 eval/gist-recall/Gemini 的收据指向 eval/gemini-profile/QUALITY_RESULTS.md。也就是说README 向读者承诺的标准正是 CONTRIBUTING.md 要求贡献者遵守的标准——The same standard I hold the README to。同时维护者对项目定位有清醒的认知它仍是一个实验场用于验证上下文以图片形式呈现是否会成为新常态见 CONTRIBUTING.md 的 Becoming a maintainer 一节。因此贡献者不应把 pxpipe 视为一个已经定型的项目而应把它当作一个需要不断用证据迭代的实验平台。二、硬性规则Rules四条不可逾越的红线CONTRIBUTING.md 的 Rules 部分是提交任何 PR 的前提违反任何一条都会直接导致 PR 无法合并。1. 一个 PR 一个根因One root cause per PR不相关的修复必须拆分到独立 PR。这一规则在什么会停滞一节中再次强调触及与声明根因无关文件的 PR会拖慢合并。对于 pxpipe 这种几份文件经常变动的小项目混入无关改动会让审查者难以判断真实影响也极易与主线分支产生冲突。2. 提交前基于当前 main 分支 rebaseCONTRIBUTING.md 明确警告仓库中有几份文件变动非常频繁陈旧分支几乎会立刻与之冲突A few files churn constantly; stale branches conflict with them almost immediately。从源码结构看这些高频变动文件包括 src/core/render.ts、src/core/transform.ts、src/core/atlas.ts 以及 src/core/ 下的模型 profile 文件如 claude-model-profiles.ts、gemini-model-profiles.ts——任何涉及渲染几何、profile 参数或评估逻辑的改动都会触碰这些文件。因此开工前先git rebase到最新的main而不是用git merge堆积合并提交。3. 脱敏红线Redaction禁止任何真实敏感数据进入仓库这是 pxpipe 作为处理 API 凭证与可能包含机密 prompt 的代理所特有的强制要求。PR 描述、issue、测试夹具test fixtures以及提交的日志中严禁出现原始 promptraw prompts凭证credentials会话文件session filesAPI key机器标识符machine identifiers主机名、用户名、绝对路径形式的主目录absolute home paths。规范给出的替代方案是使用编造的复现数据made-up repro data。这与仓库的安全模型一脉相承——SECURITY.md 明确说明 pxpipe 会处理 API 凭证与机密 prompt并规定PXPIPE_DEBUG_CAPTURE_4XX这类会捕获请求体的开关不得在生产开启因为捕获的请求体可能包含 prompt 与凭证。因此任何提交到仓库的复现样例都必须是合成数据。4. CI 绿灯pnpm test与pnpm typecheck必须本地通过规范要求提交前本地执行并通过pnpm test pnpm typecheck从 package.json 可以确认这两个命令的真实含义命令底层实现作用pnpm testvitest run运行全部 vitest 单元测试仓库现有约 80 个测试文件覆盖渲染、变换、缓存、网关、代理、历史几何等pnpm typechecktsc --noEmitTypeScript 全量类型检查不产出文件仓库的发布前检查链更完整package.json 中的prepublishOnly为pnpm run typecheck pnpm test pnpm run build即类型检查、测试、构建三步串行。贡献者在本地至少应跑通前两步若改动涉及渲染输出建议再执行pnpm run build以验证编译产物。引擎要求node 20.19包管理器为pnpm10.21.0见 package.json。三、仅适用时必需Required only when applicable声明必须携带证据这是 CONTRIBUTING.md 技术含量最高的一节。它规定当你的 PR 涉及以下两类声明时必须附带指定的证据字段否则不予采信。1. 模型行为声明六项证据字段凡涉及模型行为的声明——包括可读性readability、节省savings、guard 标志guard flags、拒绝refusals——必须附带model id模型标识如claude-fable-5、google/gemini-3.6-flashdate测试日期client version客户端版本如 Claude Code 版本render geometry渲染几何字体、字号、列数、页尺寸如 Spleen 5×8, 312 columns, 728pxsample size样本量 Nfailure categories失败分类而非笼统的失败。这套字段不是空泛要求仓库中的正式评估报告就是按此标准撰写的。以 eval/gemini-profile/QUALITY_RESULTS.md 为例其开头即声明Model:google/gemini-3.6-flashmodel id使用的生产配置shipped Spleen 5×8, 312-column, 728px profile and adjacent text factsheetrender geometry每项测试附 N 与分数novel arithmetic N100 得 100/100、gist recall 98/98、state tracking 18/18、never-stated guards 0/16样本量与失败分类、dense 12-char hex 14/15。同样README.md 的模型质量矩阵把numbers at测量所用渲染几何单独设列并逐行标注收据来源。这意味着贡献者写的评估报告应当具备同样的结构而不是一段我试了试效果不错的模糊描述。2. 定价声明来源 URL 日期凡涉及 provider 定价pricing的声明必须附带来源 URL 和日期。这是因为 token 节省率高度依赖各家 provider 的视觉 token 计价公式——README.md 明确写道image tokens use each models provider formula and actual rendered page dimensions且These figures establish profile cost on this corpus, not a universal workload savings rate。若你声称某个渲染几何在某 provider 下节省了多少百分比就必须给出计价来源与测量日期否则该数字无法被复核。3. 安全报告走 SECURITY.md不走公开 issue发现安全漏洞时不要在公开 issue 中报告。SECURITY.md 给出了完整流程使用 GitHub 的私有漏洞报告通道private vulnerability reporting form报告内容尽量包含受影响版本与运行时Node 或 Cloudflare Workers、可复现所需部署配置移除凭证、安全影响与触发者、最小复现步骤或 PoC、建议的缓解措施维护者会确认报告、评估严重性、协调修复与发布并在报告人未要求匿名的前提下致谢在补丁落地前请勿公开漏洞细节。此外 SECURITY.md 的部署安全条款也值得贡献者注意Node 服务应保持默认 loopback 绑定除非置于带认证与加密的反向代理之后Cloudflare Workers 注入 provider 凭证时必须配置PXPIPE_WORKER_SECRET否则 Worker 会 fail closed生产环境不得开启PXPIPE_DEBUG_CAPTURE_4XX。四、锦上添花Nice to have让审查者 30 秒内完成复核1. 先写一个失败测试再写修复规范建议先红后绿a failing test first, then the fix。pxpipe 的测试资产非常丰富贡献者可以参考现有测试的写法。例如 tests/render.test.ts 验证了模型可选字体的单元格几何默认 Spleen 5×8、jetbrains-mono-10 为 6×11、jetbrains-mono-12 为 8×13、jetbrains-mono-14 为 9×16并断言渲染 PNG 的像素尺寸随之变化tests/render.test.ts 则验证了 Sol 紧凑图集之外的 Unicode 会回退到完整 Spleen/Unifont 图集且droppedChars为 0。如果你的改动涉及渲染、变换或图集这类断言模式就是现成的模板。2. 在 PR 描述中给出精确命令与其输出规范要求在 PR 描述中写入确切的命令及其输出让审查者可以重新运行而不是重新推导re-run instead of re-derive。pxpipe 的评估体系为此提供了现成的 CLI。以 eval/run-eval.mjs 为例其支持的选项包括选项默认值说明--level 1\|2\|allall运行 L1OCR 保真或 L2会话回放或全部--dry-runfalse不发 API 请求用模拟分数跑通流程--confirmfalse真实 API 花费必须显式确认--estimate-onlyfalse只打印成本估算并退出--max-blocks N20L1 文本块数--max-sessions N10L2 会话数--model NAMEclaude-sonnet-4-5回放与转录模型--judge-model NAME同--modelL2 评判模型在 PR 描述中贴出如下形式的命令输出正是规范想要的收据node eval/run-eval.mjs --level 1 --dry-run # 无 API 花费验证链路 node eval/run-eval.mjs --estimate-only # 打印成本估算 node eval/run-eval.mjs --level all --confirm # 真实运行需 ANTHROPIC_API_KEY关于评估成本eval/README.md 给出了参考区间L1 单次20 块claude-sonnet-4-5约 40 次 API 调用、约 $0.50–$1.00L2 单次10 会话约 $1.50–$4.00完整 L1L2 约 $2.00–$5.00可用--model claude-haiku-4-5降低约 4 倍成本。这些数字可帮助贡献者在提交评估类 PR 前自行估算花费。3. 三行修复 清晰复现胜过堆砌规范特别强调A three-line fix with a clear repro is a good PR. Do not bulk it up to look more serious.不要为了显得重要而人为扩充 PR 范围——这与一个 PR 一个根因相互呼应。五、什么会拖慢合并What tends to stall三类典型拒收场景CONTRIBUTING.md 明确列出了会让 PR 停滞的三类情况贡献者应主动规避需要在每个模型上都测试才能验证的模型行为声明。规范的态度是Ship what a test can check; leave the judgment call to me.——凡测试可覆盖的部分请用测试证明凡是需要跨全部模型逐一验证的宽泛判断交给维护者裁决。这与仓库的现实约束一致README 的模型矩阵中就有大量未运行—的格子项目并不追求全模型覆盖。触及与声明根因无关文件的 PR。如前所述这是对一个 PR 一个根因的强化。没有调用方no caller的新 opt-in 标志。pxpipe 对新增配置开关非常克制——如果你引入一个新的PXPIPE_*环境变量或 dashboard 选项却没有一处真实调用、没有测试覆盖它这类改动基本不会被合入。从源码看现有配置项如 README.md 提到的PXPIPE_MODELS、PXPIPE_GPT_HISTORY_MAX_IMAGES都有明确的生产调用路径与防御性上限defensive cap 100新增标志应遵循同样的标准。六、成为维护者Becoming a maintainer无需正式流程的晋升路径CONTRIBUTING.md 的最后一节描述了开放、非正式的维护者招募机制If you want to help maintain this, tell me. I grant commit access on track record: a few good PRs plus useful issue triage. No formal process.获得 commit 权限的条件是业绩记录几个质量良好的 PR 加上有实质价值的问题分诊issue triage。没有正式流程、没有考试、没有评审委员会。维护者最需要的三类帮助恰好对应仓库目前最薄弱的环节评估结果Eval results在自己的硬件与 provider 上跑出各模型的可读性与节省数据并附上前述六项证据字段。CONTRIBUTING.md 直言This is the work that stalls PRs today.——评估数据不足正是当前拖慢 PR 的主要原因。参考格式见 eval/gemini-profile/QUALITY_RESULTS.md 与 eval/README.md后者完整描述了 L0 单元测试、L1 OCR 保真、L2 任务级会话回放的评估体系及其门槛阈值L1 平均字符准确率 delta ≥ −2pp 可接受、L2 平均 judge 分数 ≥ 0.80 才能放行 reflow。问题分诊Issue triage复现repro、打标签label、关闭重复 issueclose duplicates。评审Review为 render 与 transform 相关的 PR 提供第二双眼睛。这两块正是项目的技术核心——src/core/render.ts 负责文本到 PNG 的渲染管线renderChunkToPng、renderTextToPngs等src/core/transform.ts 负责请求变换与压缩收益判断transformRequest、isCompressionProfitable、maxCharsPerImage等。值得注意的是维护者在这节还写了一句颇有实验精神的自我定位First disbelieved, then called a temp hack.——项目被质疑过、被称作临时 hack但作者仍希望验证context as images是否会成为常态。对潜在维护者而言这意味着你加入的是一个仍在被检验方向的实验性项目而非一个功成名就的稳定库。七、贡献者速查清单提交 pxpipe PR 的完整路径把 CONTRIBUTING.md 的全部要求浓缩为一份可执行清单提交前基于最新mainrebase避免高频变动文件render/transform/atlas/profile冲突本地通过pnpm testvitest run与pnpm typechecktsc --noEmit检查所有内容已脱敏无原始 prompt、凭证、会话文件、API key、主机名/用户名/绝对主目录路径复现数据一律使用合成数据若有模型行为声明可读性/节省/guard/拒绝补齐六项证据字段model id、日期、客户端版本、渲染几何、样本量、失败分类若有定价声明附来源 URL 与日期若为安全漏洞走 SECURITY.md 的私有上报通道绝不发公开 issue。PR 内容一个 PR 只解决一个根因不混入无关文件优先先失败测试、后修复渲染/变换改动参考 tests/render.test.ts 的断言风格PR 描述中贴出确切的复现命令与输出让审查者可重跑而非重推三行修复 清晰复现是好 PR不要刻意膨胀不新增无调用方的 opt-in 标志。想长期参与提交自己的硬件/provider 上的评估结果这是目前最缺的工作参与 issue 分诊复现、打标签、关闭重复项为 render/transform 的 PR 提供评审意见直接向维护者表达意愿以 PR 业绩与分诊贡献换取 commit 权限。结语pxpipe 的贡献规范本质上是一套为证据驱动的小步迭代而设计的工程纪律脱敏红线保护了代理类工具特有的隐私风险六项证据字段让每个模型行为声明都可复核评估 CLI 让收据的生成成本降到最低而开放的维护者路径则在为项目补充最稀缺的评估产能。对贡献者来说遵守这份规范不仅是为了让 PR 快速合并更是为了加入一个用实验数据而非直觉驱动决策的开源项目。若你计划提交第一个 PR最稳妥的起点是挑一个明确的根因写一个失败测试附上可重跑的命令与输出然后在描述中声明这属于测试可覆盖的修复判断性结论留给维护者。这就是一份带收据的小 PR的标准形态。赞分享【免费下载链接】pxpipecut Claude Code token usage by rendering text context as images项目地址https://gitcode.com/gh_mirrors/px/pxpipe点击查看免费下载相关推荐变更描述变更描述 简要说明实现的功能或修复的问题 实现细节 核心算法说明 关键API变更 兼容性处理 测试验证 单元测试覆盖率 80% 已在Android 10设备验音视频移动开发trouble.nvim贡献指南提交PR的步骤与规范trouble.nvim贡献指南提交PR的步骤与规范 一、贡献前准备 1.1 环境搭建 bash 克隆仓库 git clone https://gitcode开发工具How do I install a custom image?How do I install a custom image? In order to download an unsupported ISO image,虚拟化上一篇PS4存档管理工具终极指南Apollo Save Tool让备份、迁移、修复一次到位下一篇WVP-PRO 视频监控平台快速上手指南多品牌设备统一接入与国标级联一文读懂创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
