leetcode-local-cli

面向 LeetCode 中文站的轻量本地刷题 CLI：配置一个工作区，通过 Chrome、Edge 或手动 Cookie 登录，在线获取题目，在 solution.py 中解题并进行本地调用、诊断和远程提交。

本文对应版本：v0.11.0。发布记录见 GitHub Releases。

开发本地源码使用 uv sync --locked --all-groups，随后用 uv run lc ...；未激活虚拟环境或安装全局工具时，裸 lc 不一定可用。

安装

需要 Python 3.12+、uv 和 Chrome 或 Microsoft Edge。

Linux / macOS：

curl -LsSf https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.11.0/scripts/install.sh | sh

Windows PowerShell：

powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.11.0/scripts/install.ps1 | iex"

也可以直接安装并初始化：

uv tool install leetcode-local-cli
lc init

自动化验收可以显式指定完整工作区路径：

lc init D:/Projects/leetcode-local-cli --yes

升级或卸载：

uv tool upgrade leetcode-local-cli
uv tool uninstall leetcode-local-cli

从 0.10.x 或更早版本升级后，请重新执行 lc login，并用 lc init <原工作区完整路径> --yes 注册工作区；已有普通 solution.py 会保留。旧工作区 Session 和根目录 .leetcode-local-cli.toml 不自动读取或迁移。旧凭据应由用户自行安全清理，不要提交或同步。

快速开始

lc login
lc status
lc profile
lc show
lc get 1
lc init
lc doctor
lc solve 1
lc test
lc submit
lc check <Submission ID>

lc solve 会覆盖默认工作区中的普通 solution.py，切题前请自行保存解法。符号链接、目录、junction 和其他 reparse point 会被拒绝。

生成模板用 raise NotImplementedError("请实现题目方法") 标记待实现方法；开始解题后将它替换为实际返回逻辑。

命令

login、status、profile、show、get、check 和不带 --run-solution 的 doctor 不要求先初始化工作区。账号和题目命令需要有效 Session；doctor 在 Session 缺失时仍会诊断并返回失败。solve、test、submit 和 doctor --run-solution 需要已配置的工作区。

解法保存成功但系统无法打开文件时，solve 显示保存路径和警告，仍返回 0；写入失败则返回 1，并且不打开文件。

用户配置或 marker 损坏时，普通 init 不覆盖它们。明确修复目标后执行：

uv run lc init D:/Projects/leetcode-local-cli --repair --yes

修复前会在损坏文件旁创建 原文件名.<随机标识>.bak，保留原始字节。后续失败会尝试回滚本次文件变化，已创建的备份保留供恢复；版本、站点或语言不受支持，以及链接或权限问题，不会被 --repair 强行覆盖。

浏览器登录

首次使用浏览器自动登录前：

1. Chrome 打开 chrome://inspect/#remote-debugging；Edge 打开 edge://inspect/#remote-debugging。
2. 勾选 Allow remote debugging for this browser instance，再执行 lc login。
3. CLI 优先尝试日常 Chrome，再尝试日常 Edge；如果设置页面没有自动显示，请手动打开上述地址。
4. 出现 Allow remote debugging? 连接确认框时选择 Allow，并保持 LeetCode 页面已登录。
5. CLI 只获取 leetcode.cn 的 LEETCODE_SESSION 和 csrftoken，在线验证后保存。
6. 自动登录失败时，回退到隐藏输入的手动 Cookie。

CLI 不读取或解密浏览器 Cookie 数据库，不创建专用 profile，也不关闭日常浏览器。授权等待上限为 180 秒。

本地调用

lc test 自动选择 Solution 中第一个不以 _ 开头的实例方法。输入安全 Python 字面量参数：

参数 > nums = [3, 2, 4], target = 6

连续两次回车退出。每组默认限时 1 秒；无输入、参数错误、异常或超时返回退出码 1。退出码 0 只表示调用正常完成，不代表算法正确。链表和二叉树暂不自动转换。

非交互示例：

printf 'nums = [3, 2, 4], target = 6\n' | lc test --stdin

--stdin 的运行时启动失败（包括未初始化工作区）也输出 JSON Lines，包含 kind: startup_error、稳定的 code 和中文 error，退出码为 1。非法 CLI 参数仍使用标准用法错误，退出码为 2。

lc submit 取得 submission ID 后默认等待判题 30 秒。判题查询只在总预算内有限重试；初始提交 POST 不自动重试，避免重复提交。等待超时或查询失败时会保留 submission ID，并返回退出码 1。

等待超时后可执行 lc check <Submission ID> 重新查询。该命令只请求一次：已经判题则展示结果，仍在判题则提示稍后重试；只有结果为 Accepted 时返回退出码 0。

安全与限制

• 当前只支持 LeetCode 中文站和 Python3 提交。
• HTTP 凭据仅发往 https://leetcode.cn 的默认 HTTPS 端口，拒绝全部重定向；不自动切换到其他域名、子域名或 HTTP 地址。
• Session 包含真实 Cookie，保存在当前系统用户的本地状态目录：Windows 为 %LOCALAPPDATA%\leetcode-local-cli\session.json，macOS 为 ~/Library/Application Support/leetcode-local-cli/session.json，Linux 为 ${XDG_STATE_HOME:-~/.local/state}/leetcode-local-cli/session.json。不得提交、上传、同步或共享。
• 工作区 marker 保存在 .leetcode_local_cli/workspace.toml，属于本机工作区元数据；建议忽略，不提交。CLI 不自动修改用户仓库的 .gitignore。
• 本项目源码仓库忽略根目录 solution.py；开发者可将工作区与源码放在一起，个人解法不属于工具源码。普通用户仍可自选独立工作区。
• solution.py 只接受 UTF-8 或 UTF-8 BOM。
• lc test 与 lc doctor --run-solution 会执行本地代码，只能用于可信工作区。
• 判题等待超时不代表提交失败，应使用终端显示的 submission ID 到 LeetCode 查看最终结果。

维护者文档

• 当前状态
• 架构
• 产品边界
• 安全边界
• 技术决策
• 发布流程

License

MIT License