led-review 0.1.0__tar.gz

led_review-0.1.0/.env.example

@@ -0,0 +1,13 @@
+# 真实运行所需的 API key（复制本文件为 .env 后填入）
+
+# Moonshot 通用 API key（kimi / kimi-k2.7-code / kimi-k2.6 等）
+# 获取地址：https://platform.moonshot.cn/
+MOONSHOT_API_KEY=sk-your-key-here
+
+# Kimi Code 专用 API key（kimi-code / kimi-code-256k / kimi-code-k2.7 等）
+# 获取地址：https://www.kimi.com/code/console
+#KIMI_CODE_API_KEY=sk-your-key-here
+
+# 默认启动的模型档案（可选，默认 kimi-code；可选值见 models.default.json 或 /model 列表）
+# 默认 kimi-code 需要配置 KIMI_CODE_API_KEY；切回 kimi / kimi-k2.7-code 等用 MOONSHOT_API_KEY
+#MINI_AGENT_MODEL=kimi-code

led_review-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+      - name: Install dependencies
+        run: pip install -r requirements.txt pytest ruff
+      - name: Lint
+        run: ruff check .
+      - name: Test
+        run: python -m pytest -q

led_review-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+# 发布到 PyPI：led-review（用户 pipx install led-review 即可用，BYOK——自带 key）
+#
+# 触发：push 任意 tag（推荐语义化：v0.1.0）
+# 前置（一次性，需人工完成）：
+#   1. 注册 https://pypi.org/account/register/（用户名如 jljleo）
+#   2. 在 https://pypi.org/manage/account/token/ 创建 API token（scope: 整个账号）
+#   3. 仓库 Settings → Secrets → Actions 添加: PYPI_API_TOKEN=<token>
+#   4. 可选：test.pypi 先试发（把 publish 步骤的 repository 指到 test.pypi 账号同理）
+#
+# 产物：pipx install led-review → 命令 `led`：
+#   led review "origin/main...HEAD"          # 分支审查，high findings → exit 1
+#   led review --format json                 # 机器消费
+#   led                                     # 交互 REPL
+
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+
+      - name: 构建 wheel + sdist
+        run: |
+          pip install -q build
+          python -m build
+
+      - name: 发布到 PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

led_review-0.1.0/.github/workflows/review.yml

@@ -0,0 +1,44 @@
+# PR 自动 code review：led dogfood 闭环——uses 仓库自身的 action（自举）
+#
+# 每个 PR 用 PR 自己的代码 review 自己的 diff：
+#   - uses: ./ 是本地 action 路径（本仓库根 action.yml），install_from: . 装的是
+#     PR 分支源码——改坏 review 能力的 PR 会立刻体现在自己的 review 质量里。
+#   - 用户场景唯一差异是 install_from 缺省（PyPI 包 led-review），其余逻辑相同。
+#   - action 封装被每个 PR 实测，封装坏了的 PR 会自己卡住自己/报错在评论里。
+#
+# 需要在仓库 Settings → Secrets 配置 KIMI_CODE_API_KEY（BYOK）。
+# 设计决策：
+#   - fail_on_high 缺省 false：review 是信息性评论，不阻塞合并（precision 未被
+#     充分证明前不做门禁；E8-E10 的误报数据够格后再开门禁）
+#   - fork PR 跳过（secrets 不可用，也防外部 PR 烧 key）
+#   - concurrency cancel：force-push 时取消过期的 review
+
+name: review
+
+on:
+  pull_request:
+
+concurrency:
+  group: review-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    permissions:
+      pull-requests: write  # gh pr comment 需要（默认 token 在某些仓库设置下只读）
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # review 需要 base...HEAD 的完整祖先
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+
+      - uses: ./
+        with:
+          api_key: ${{ secrets.KIMI_CODE_API_KEY }}
+          install_from: "."

led_review-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+/.env
+/.venv/
+__pycache__/
+.DS_Store
+.chat_history
+session_todos.json
+.session.json
+models.json
+bench/results/
+# 个人笔记/设计文档：只保留本地，不进仓库
+ROADMAP.md
+AGENT_DESIGN.md
+DESIGN_NOTES.md
+
+# 打包构建产物
+build/
+*.egg-info/
+
+# 构建/发布产物与 IDE
+dist/
+build/
+.idea/

led_review-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,10 @@
+# 提交前自动检查：ruff lint（自动修复）
+# 安装：pip install pre-commit && pre-commit install
+# 注：刻意不含 ruff-format——仓库现有手工排版（中文注释对齐、刻意折行），
+# 全量格式化会改写 31 个文件；如将来决定统一排版，一次性跑 ruff format 后再加回该钩子。
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.5
+    hooks:
+      - id: ruff
+        args: [--fix]

led_review-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

led_review-0.1.0/AGENTS.md

@@ -0,0 +1,54 @@
+# AGENTS.md
+
+> 本文件会被 `mini_agent/kernel/agent.py` 自动注入 system prompt（随会话保留，compact 不截断）：
+> 它是对 AI 协作者的行为契约（编码规范/架构边界/踩坑清单），与 `mini_agent/repo_map.py`
+> 注入的代码库地图互补——地图回答「仓库有什么」，本文件回答「应该怎么改」。
+> 修改后即刻生效，无需重启。不要把一次性指令/环境特定信息写在这里（放 .env/README）。
+
+## 项目形态
+
+- 项目主线是 **code review agent**：`mini_agent/review.py` 是 review 管道与子命令（主形态：非交互批处理、CI 可消费、exit code 门禁）；交互 REPL 是辅助形态。diff 提取在 `mini_agent/tools/gitdiff.py`（只读确定性），skills 机制在 `mini_agent/skills.py`（索引常驻注入 + read_file 惰性加载，规范轴载体）。
+- Python 3.13 CLI agent，代码组织为 `mini_agent/` 包（kernel / tools / commands / ui / eval 分层）；有最小 `requirements.txt`（openai / python-dotenv / prompt_toolkit / rich），没有构建步骤、lint 配置或代码生成。使用仓库内虚拟环境：`.venv/bin/python`；新环境先 `.venv/bin/pip install -r requirements.txt`。
+- 代码库感知（mini_agent/repo_map.py）全语言统一走 tree-sitter 解析（lazy import，语言包缺失时该语言静默为空）：python / javascript / typescript(含 tsx) / go / rust / java。加新语言 = 在 repo_map.py 注册 `@_extractor(".xxx")` 提取器 + 装对应 tree-sitter-xxx 包，索引/排序/缓存/检索逻辑语言无关无需改动。
+- 入口是 `mini_agent/main.py`（`.venv/bin/python -m mini_agent`，发布后安装 `pipx install led-review` 得到命令 `led`）：`led review` 子命令走 review.py 管道，无子命令进交互主循环 `_chat_loop`（tty/管道自适应）。曾有的 Textual 全屏 TUI 与 patch_stdout 常驻输入框均已于 2026-09 移除（R0：自研全屏 UI 是负资产；patch_stdout 与 Live 光标重绘互斥必闪烁），不要再引入全屏前端或运行中输入框。
+- 运行时配置在 `config.py`，会加载 `.env`；真实运行需要对应档案的 API key（默认档案 kimi-code → `KIMI_CODE_API_KEY`，详见 `.env.example`）。不要读取或提交 `.env`。
+- 内核/UI 边界很重要：`mini_agent/kernel/`（agent / streaming / compact）必须保持为事件生产者，不能 import `mini_agent/ui/`。通过产出/消费 `kernel/events.py` 事件来渲染或上报（`ui.renderer.consume`、bench 消费者）。
+
+## 命令
+
+- 运行应用：`.venv/bin/python -m mini_agent`
+- 运行全部测试：`.venv/bin/python -m pytest -q`
+- 运行单个测试文件：`.venv/bin/python -m pytest tests/test_compact.py -q`
+- 运行单个测试：`.venv/bin/python -m pytest tests/test_compact.py::test_name -q`
+- 运行 benchmark：`.venv/bin/python bench/run_bench.py [task_name]`；会访问真实 API，在每个任务独立的临时沙箱里自动批准，并写入 `bench/results/*.json`。
+- Lint：`.venv/bin/ruff check .`（配置在 `pyproject.toml`，规则集 E/F/I/UP/B，E501 行长不查）；pre-commit 钩子可选（`pip install pre-commit && pre-commit install`）。仓库未配置 formatter 与 typecheck，不要臆造必须的命令顺序。
+
+## 测试规则
+
+- `pytest.ini` 只设置 `testpaths = tests`。
+- `tests/conftest.py` 会把仓库根目录插入 `sys.path`，重置 `compact._chars_per_token`，并把 `socket.socket` 替换成哨兵类：任何真实网络请求都会立即失败。OpenAI client 调用必须打桩；测试绝不能访问网络。
+- 使用 `session` fixture 获得隔离的 `ChatSession`：假 API key + `tmp_path` 会话文件。
+- 优先写行为契约回归测试，而不是实现细节断言；文件系统和全局状态隔离用 `tmp_path`/`monkeypatch`。
+
+## 仓库特有约定与坑
+
+- 工具只在 `mini_agent/tools/builtin.py` 里用 `@tool` 注册；工具 schema 和实现共用这一个事实来源。常驻工具只由 `tools/registry.py` 的 `RESIDENT_TOOL_NAMES` 控制；新工具默认通过 `search_tools` 可发现，除非显式加入常驻名单。
+- 斜杠命令在 `mini_agent/commands/builtin.py` 里用 `@command` 注册；`main.py` 导入 `tools.builtin` 和 `commands.builtin` 是为了触发注册副作用。
+- 上下文压缩只做发送时投影：`kernel/compact.py` 变换的是消息副本，绝不能改存储历史。必须保留 assistant `tool_calls` 与 tool 消息配对；截断不能制造孤儿 tool 消息。
+- 如果流式响应 `finish_reason == "length"` 且带 tool calls，要整批拒绝执行并补上明确的 tool 结果；半截 arguments 不安全，孤儿 tool calls 会导致 API 400。
+- 交互循环刻意没有硬性最大轮次限制。保险丝是 `config.py` 的 `MAX_SAME_TOOL_CALLS`；无人值守场景的轮次限制应放在调用侧（如 bench、子 agent 的 `max_turns`），不要污染核心循环。
+- 子 agent（`spawn_subagent`）：类型化派生（`config.SUBAGENT_TYPES`——researcher 只读 / coder 可写可跑），进程内新 `ChatSession(tools=类型工具表, depth+1)`，上下文隔离只回结论；子 agent 直接操作真实项目，安全由工具表 + command_policy + 用户审批保证（沙箱机制已移除）。子 agent 的 bash 命令按 command_policy 裁决：researcher 命中只读白名单直通、非白名单一律硬拒（零 LLM 成本）；coder 即使命中 allow 也降级为 ask、未命中冒泡给人工审批（带 `[子 agent]` 前缀）；越界路径硬拒绝（不评审不冒泡）。防套娃双保险：类型工具表不含 spawn_subagent + `MAX_SUBAGENT_DEPTH=1`。
+- 命令权限随类型声明（`SUBAGENT_TYPES[*].command_policy`）：researcher=read_only（白名单直通，非白名单确定性硬拒，零 LLM 成本）；coder=human（allow 也降级为 ask，与 ambiguous 一起冒泡给人工审批，带 `[子 agent]` 前缀）。限制的唯一可信来源是 config，不是模型生成的参数。
+- 防乱派生：`spawn_subagent` 工具描述写死派生纪律（先规划边界、任务自包含、别乱派）；子 agent 运行中被拒的命令/访问计入 `_subagent_context`，达到 `SUBAGENT_DENIAL_LIMIT`（默认 3）即 `control.abort()` 熔断本轮，拒绝次数附在结论里回传主 agent 自我修正。
+- 文件工具是窄接口，围栏限制在 `PROJECT_ROOT`；项目外路径需要确认。`run_bash` 由 `permissions.json` 裁决：`deny > allow > ask`；如果命令包含项目外路径，即使命中 allow 也会降级为 ask。不要用 bash 绕过文件围栏访问项目外路径。
+- `edit_file` 是容错策略链（AGENT_DESIGN 13 条）：L1 精确匹配（count>1 拒绝防误改）→ L2 行级宽容定位（忽略行尾空白/换行差异，仍强制唯一）→ L3 失败时报错带 read_file 指引 + 文件头部预览。改后自动做语法冒烟（tree-sitter），坏代码以带行号的 ⚠ 报错附在工具结果里回喂。两个工程纪律：读写必须 `newline=""` 保真（否则 CRLF 仓库换行风格被毁）；`_resolve_safe_path` 必须对 `PROJECT_ROOT` realpath 化（macOS /var→/private/var 符号链接会误判越界）。
+- `$web_search` 在 `config.py` 中被刻意禁用，因为 kimi-k3 当前处理内置工具结果会失败；需要联网时用 `run_bash` + `curl`，并先告诉用户要访问的 URL。
+- UI 输出统一走语义化 helper；tty 与管道都用 `mini_agent/ui/renderer.py`（StreamRenderer：tty 下 Live 增量重排，管道自动降级纯文本直出）。动态/模型文本必须用 `Text`/`markup=False`，避免 `[brackets]` 被当成 Rich markup 解析。
+- `.session.json`、`.chat_history`、`session_todos.json`、`bench/results/` 都是运行时产物，已 gitignore。
+- **评测必留档**：任何真实 API 评测（`bench/run_bench.py` 真跑）完成后必须追加一节到 `bench/EXPERIMENTS.md`（文件头部的强制规范与模板）并随代码提交——负结果也要记；评测抓到内核缺陷（已发生三次：动态注入时序 400、符号链接根误判、@tool 装饰器挂错）是本体系最高价值产出，不许丢在对话里。
+- **评测任务设计准则**（E12 系列豆腐块——新任务/改判分前必须过一遍，每条都有实测事故背书）：
+  合成 bug 保持无关行为不变（别把 base 既有行为弄丢，如 get 的过期清理 pop）；
+  ground truth zones 间距必须 > 2×line_tolerance、alias 不得与其它 bug 的 zone 重叠（重叠 → finder 错配 → 假漏检，E12.5 实锤）；
+  alias 应收录「契约声明处」——docstring 声明契约、实现违反它的 bug，报声明位置是模型的合理定位（E8/E12.8 两次数过）；
+  OSS 注入（remote revert）只选「修 bug」型单父提交（revert「加功能」型得到的是删功能，不是潜伏缺陷），测试文件回退区标 neutral；
+  多样本统计排除 tokens=0 的运行（那是基础设施故障，不是模型漏检，E12.9 实锤）。

led_review-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jljleo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

led_review-0.1.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.5
+Name: led-review
+Version: 0.1.0
+Summary: led——可度量检出率的 code review agent（BYOK：用户自配 AI API key）
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: openai>=1.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tree-sitter-go>=0.25
+Requires-Dist: tree-sitter-java>=0.23
+Requires-Dist: tree-sitter-javascript>=0.25
+Requires-Dist: tree-sitter-python>=0.25
+Requires-Dist: tree-sitter-rust>=0.24
+Requires-Dist: tree-sitter-typescript>=0.23
+Requires-Dist: tree-sitter>=0.26

led_review-0.1.0/README.md

@@ -0,0 +1,128 @@
+# led
+
+一个 code review CLI：审查一个 diff 范围（PR、分支、工作区改动），输出结构化 findings
+（severity / 文件:行号 / 问题描述 / 修复建议），带 CI 门禁语义。
+
+```bash
+led review main...HEAD    # 审查分支改动
+led review                # 审查工作区+暂存（默认）
+led review --format json  # 机器消费（CI/评测）
+# 有 high findings 时退出码为 1——任何 CI 都能直接当门禁用，不绑定特定平台
+```
+
+不带子命令启动则进入通用 coding agent REPL（辅助形态）。
+
+> 📖 **完整使用文档见 [docs/USAGE.md](docs/USAGE.md)**——安装、模型档案、review/REPL
+> 两种形态、权限与安全模型、评测体系、开发与排查。
+
+## 零操作接入：GitHub Action（用户不需要源码）
+
+用户自己的仓库里放一个 workflow（3 行核心 + 一个 secret），PR 一开就自动
+review 并评论，不需要任何人手动调用：
+
+```yaml
+# .github/workflows/review.yml
+on: pull_request
+permissions:
+  pull-requests: write
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: jljleo/mini-agent@v1
+        with:
+          api_key: ${{ secrets.KIMI_CODE_API_KEY }}   # BYOK：用户自己的 key
+```
+
+- led 自动从 PyPI 安装（用户仓库拿不到本项目源码也没关系）
+- 默认信息性评论不阻塞合并；想开门禁加 `fail_on_high: "true"`
+- fork PR 自动跳过（防止外部 PR 烧用户的 key）
+
+## 凭什么不同
+
+- **检出率可度量**：自带 benchmark 体系（`bench/`），review 质量用注入 bug 任务量化
+  （检出率/误报率），不靠「看起来能 review」。当前 35 任务（合成 + 真实仓库 revert
+  注入，覆盖 Python/Go/Rust/JS），k3 实测结论：合成/跨文件/multi-bug 全检出、
+  OSS n=3 零误报（E12 系列，见 `bench/EXPERIMENTS.md`）
+- **代码库感知**：tree-sitter 符号索引（Python/JS/TS/Go/Rust/Java），review 时能定位
+  变更的影响面，而不是孤立看 diff
+- **规范可沉淀**：项目的 AGENTS.md 与 `skills/` 约定自动注入 system prompt，作为审查依据
+- **dogfood**：本仓库的提交由它自己 review——首个版本就抓到过一个真 bug（见提交 565d621）
+
+## 快速开始
+
+要求 Python 3.13+。
+
+```bash
+pipx install .
+# 配置 API key：默认档案 kimi-code 需要 KIMI_CODE_API_KEY 环境变量
+# （也可在项目目录放 .env；更多模型档案见 mini_agent/models.default.json）
+cd 你的项目 && led review HEAD
+```
+
+从源码运行：`pip install -r requirements.txt` 后 `.venv/bin/python -m mini_agent review HEAD`。
+
+## 工作原理
+
+review 是一个确定性管道，不是一句 prompt：
+
+1. **diff 提取**（`tools/gitdiff.py`）：纯 Python、只读——文件级概览（状态/增删行）常驻，
+   patch 详情按预算分配，超预算文件降级为概览条目
+2. **审查**：只读会话（read_file / search_symbols / 只读 bash）执行双轴审查——
+   正确性（主）+ 规范（对照 AGENTS.md/skills）；AGENTS.md、repo map、skills 索引
+   自动注入 system prompt
+3. **输出**：约定格式的 findings 由程序解析成结构（解析不动的由 raw 原文兜底），
+   high findings → exit code 1
+
+底座是一个完整的 coding agent 内核：三级上下文压缩、工具分档发现、类型化子 agent、
+权限裁决、benchmark 评测（见「项目结构」）。
+
+## CI 集成
+
+review 是宿主无关的批处理命令，任何 CI 都能接入（exit code 门禁 / `--format json` 机器消费）。
+本仓库自带的 GitHub Actions 示例见 `.github/workflows/review.yml`：PR 上自动 review
+并把 findings 评论到 PR——它同时是本项目的 dogfood 闭环（用 PR 自己的代码 review 自己）。
+需要配置 `KIMI_CODE_API_KEY` secret。
+
+## 开发
+
+```bash
+.venv/bin/python -m pytest -q        # 全部测试（零网络，OpenAI client 已打桩）
+.venv/bin/ruff check .               # lint
+.venv/bin/python bench/run_bench.py  # benchmark（访问真实 API，写入 bench/results/）
+```
+
+测试约定见 `tests/conftest.py`（socket 被替换为哨兵，任何真实网络请求立即失败）。
+
+## 安全模型
+
+- review 会话只读：不能写文件；bash 只有只读白名单命令直通，其余在非交互环境默认拒绝
+- 通用 REPL：文件工具围栏在项目根内，项目外路径需逐次确认；`run_bash` 由
+  `permissions.json` 裁决（`deny > allow > ask`）；子 agent 权限随类型收窄
+
+> ⚠️ 这个项目会让 LLM 在你机器上执行命令。请理解 `permissions.json` 的规则后再放权。
+
+## 项目结构
+
+```
+mini_agent/
+├── main.py           入口（review 子命令分发 + tty/管道单一主循环）
+├── review.py         code review 管道（确定性输入→双轴审查→结构化 findings→门禁）
+├── skills.py         skills 机制（索引常驻注入 + read_file 惰性加载）
+├── config.py         运行时配置（模型档案、子 agent 类型、阈值）
+├── repo_map.py       tree-sitter 代码库感知
+├── kernel/           事件生产者（agent / streaming / compact / events / bridge）
+├── tools/            工具实现与注册表（builtin / registry / gitdiff）
+├── commands/         斜杠命令实现与注册表（builtin / registry）
+├── ui/               界面层（renderer / input / segments）
+└── eval/             评测支撑（judge / trace）
+bench/                benchmark 任务包与驱动
+tests/                行为契约测试
+AGENTS.md             面向 AI 协作者的仓库约定
+```
+
+## 许可证
+
+[MIT](LICENSE)

led_review-0.1.0/action.yml

@@ -0,0 +1,90 @@
+# led review — 可复用 GitHub Action
+#
+# 用户接入（自己的仓库 .github/workflows/review.yml）：
+#   name: led review
+#   on: pull_request
+#   permissions:
+#     pull-requests: write
+#   jobs:
+#     review:
+#       runs-on: ubuntu-latest
+#       steps:
+#         - uses: actions/checkout@v4
+#           with: { fetch-depth: 0 }          # review 需要 base...HEAD 完整祖先
+#         - uses: jljleo/mini-agent@v1
+#           with:
+#             api_key: ${{ secrets.KIMI_CODE_API_KEY }}   # BYOK：用户自己的 key
+#
+# PR 一开就自动 review 并评论，无需用户主动调用。默认信息性评论（--no-fail）；
+# 想开门禁设 fail_on_high: "true"（会阻止合并，precision 够格后再用）。
+
+name: "led review"
+description: >
+  PR 上自动运行 led code review（检出率/误报率可复现的 review agent）并评论
+  findings。BYOK：用户自配 KIMI_CODE_API_KEY。
+author: jljleo
+branding:
+  icon: "clipboard-check"
+  color: "purple"
+
+inputs:
+  api_key:
+    description: "KIMI_CODE_API_KEY（用户自己的 key，Repository secrets 传入）"
+    required: true
+  review_spec:
+    description: "审查范围（git revspec）；缺省 = origin/<base>...HEAD"
+    required: false
+    default: ""
+  fail_on_high:
+    description: "true 时 high findings 让 job 失败（门禁）；默认 false 信息性评论"
+    required: false
+    default: "false"
+  install_from:
+    description: "安装来源：缺省 PyPI 包名 led-review（用户场景）；本项目 dogfood 传 '.' 装 PR 源码（自举）"
+    required: false
+    default: "led-review"
+
+runs:
+  using: "composite"
+  steps:
+    - name: 跳过 fork PR（secrets 不可用，也防外部 PR 烧 key）
+      if: ${{ github.event.pull_request.head.repo.full_name != github.repository }}
+      shell: bash
+      run: echo "fork PR 跳过（BYOK secret 只在同仓库 PR 可用）" && exit 0
+
+    - name: 取 base 分支（review 的 diff 端点）
+      shell: bash
+      run: |
+        # GITHUB_BASE_REF 是 PR 触发的内置环境变量（base 分支）；缺省 main
+        git fetch -q origin "${GITHUB_BASE_REF:-main}"
+
+    - name: 安装 led
+      shell: bash
+      run: pip install -q "${{ inputs.install_from }}"
+      # 缺省 install_from=led-review（PyPI，用户场景）；dogfood 传 "." 装 PR 源码
+
+    - name: 运行 led review
+      shell: bash
+      env:
+        KIMI_CODE_API_KEY: ${{ inputs.api_key }}
+        REVIEW_SPEC: ${{ inputs.review_spec }}
+        FAIL_ON_HIGH: ${{ inputs.fail_on_high }}
+      run: |
+        SPEC="${REVIEW_SPEC:-origin/${GITHUB_BASE_REF:-main}...HEAD}"
+        {
+          echo "## 🤖 led review"
+          echo
+          if [ "${FAIL_ON_HIGH}" = "true" ]; then
+            led review "$SPEC"          # 门禁：high findings → 非零 → step 失败
+          else
+            led review "$SPEC" --no-fail || true   # 默认信息性评论
+          fi
+        } > review.md
+
+    - name: 评论 findings
+      if: ${{ github.event_name == 'pull_request' }}
+      shell: bash
+      env:
+        GH_TOKEN: ${{ github.token }}
+        PR_NUMBER: ${{ github.event.pull_request.number }}
+      run: gh pr comment "$PR_NUMBER" --body-file review.md