leetcode-local-cli 0.7.1__tar.gz → 0.8.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/PKG-INFO +73 -22
  2. leetcode_local_cli-0.8.0/README.md +282 -0
  3. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/pyproject.toml +1 -1
  4. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/auth.py +53 -63
  5. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/cli.py +124 -21
  6. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/client.py +12 -6
  7. leetcode_local_cli-0.8.0/src/leetcode_local_cli/config.py +317 -0
  8. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/doctor.py +12 -6
  9. leetcode_local_cli-0.8.0/src/leetcode_local_cli/paths.py +95 -0
  10. leetcode_local_cli-0.8.0/src/leetcode_local_cli/safe_files.py +192 -0
  11. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/service.py +36 -21
  12. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/ui.py +65 -33
  13. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/workspace.py +24 -22
  14. leetcode_local_cli-0.7.1/README.md +0 -231
  15. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/LICENSE +0 -0
  16. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/__init__.py +0 -0
  17. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/__main__.py +0 -0
  18. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/problem.py +0 -0
  19. {leetcode_local_cli-0.7.1 → leetcode_local_cli-0.8.0}/src/leetcode_local_cli/version.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: leetcode-local-cli
3
- Version: 0.7.1
3
+ Version: 0.8.0
4
4
  Summary: Local coding workflow CLI for LeetCode CN.
5
5
  Keywords: cli,leetcode,leetcode-cn,uv
6
6
  Author: Aetherialter
@@ -24,18 +24,26 @@ Description-Content-Type: text/markdown
24
24
 
25
25
  # 力扣中文站本地化刷题 CLI 工具
26
26
 
27
- 一个面向 LeetCode 中文站的轻量本地刷题 CLI。它复用浏览器登录态,在线获取题目,在当前工作目录生成单文件 `solution.py`,并支持本地测试和远程提交。
27
+ 一个面向 LeetCode 中文站的轻量本地刷题 CLI。它复用浏览器登录态,在线获取题目,在显式配置的默认工作区维护单文件 `solution.py`,并支持本地测试和远程提交。
28
28
 
29
- 当前版本:`v0.7.1`
29
+ 当前版本:`v0.8.0`
30
+
31
+ ## 长期开发手册
32
+
33
+ [完整文档索引](docs/README.md)集中列出项目状态、架构、产品边界、技术决策、开发计划、安全审计和发布手册。
34
+
35
+ [v1.0 总体设计大纲](docs/PROJECT_DESIGN.md)记录了从当前版本演进到稳定 CLI 与 Python API 的长期架构、版本阶段和验收标准。该文档目前处于 Draft 状态,具体实施前仍需按阶段审查。
36
+
37
+ [产品边界与待定决策](docs/PRODUCT_BOUNDARIES.md)记录当前已经确认的行为,以及必须先由维护者拍板才能实现的测试、提交、工作区、编辑器和兼容性语义。[安全审计与修复清单](docs/SECURITY_REVIEW.md)记录当前源码仍需处理的风险。
30
38
 
31
39
  ## 核心能力
32
40
 
33
41
  - 读取 Chrome 中的 `leetcode.cn` Cookie,复用登录态。
34
42
  - 在线获取题目详情和题目索引。
35
- - 使用当前工作目录的 `solution.py` 作为唯一主要工作区。
43
+ - 使用 `lc init` 配置的默认工作区和单个 `solution.py`。
36
44
  - `lc solve <题号>` 生成可编辑的 Python 解题模板。
37
45
  - 生成模板后会按当前系统尝试打开 `solution.py`。
38
- - `lc test` 运行 `solution.py` 中的 `run_cases()`。
46
+ - `lc test` 执行本地 `solution.py`;`run_cases()` 的最终调用契约仍在产品边界文档中待定。
39
47
  - `lc doctor` 一次检查 Session 文件、站点连通性、Cookie 登录态和本地解题文件。
40
48
  - `lc submit` 提交 marker 区域代码到 LeetCode 中文站,并轮询判题结果。
41
49
  - 生成模板时写入 `problem_id` 和 `submit_question_id`,避免展示题号和 LeetCode 内部提交 ID 混用。
@@ -54,16 +62,16 @@ Description-Content-Type: text/markdown
54
62
  Linux / macOS 一键安装:
55
63
 
56
64
  ```bash
57
- curl -LsSf https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.7.1/scripts/install.sh | sh
65
+ curl -LsSf https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.8.0/scripts/install.sh | sh
58
66
  ```
59
67
 
60
68
  Windows PowerShell 一键安装:
61
69
 
62
70
  ```powershell
63
- powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.7.1/scripts/install.ps1 | iex"
71
+ powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.8.0/scripts/install.ps1 | iex"
64
72
  ```
65
73
 
66
- 安装器会在缺少 uv 时通过 uv 官方 HTTPS 安装器完成引导,然后使用 `uv tool install` 安装 `leetcode-local-cli`,并执行 `lc --version` 验证结果。安装过程不使用 `sudo`,也不会保存 PyPI 或 GitHub 凭据。
74
+ 安装器要求系统已安装 uv;如果未检测到 uv,会安全退出并提示访问 [uv 官方文档](https://docs.astral.sh/uv/),不会自动下载或执行第三方远端安装脚本。检测到 uv 后,安装器会使用 `uv tool install` 安装 `leetcode-local-cli`,执行绝对路径的 `lc --version` 验证结果,并在可交互终端继续运行 `lc init`。安装过程不使用 `sudo`,也不会保存 PyPI 或 GitHub 凭据。
67
75
 
68
76
  已经安装 uv 时,也可以直接安装:
69
77
 
@@ -71,6 +79,20 @@ powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.c
71
79
  uv tool install leetcode-local-cli
72
80
  ```
73
81
 
82
+ 直接执行 `uv tool install` 不会运行项目自定义的安装后交互。首次使用前还需要手动执行:
83
+
84
+ ```shell
85
+ lc init
86
+ ```
87
+
88
+ 自动化或 AI 验收可以显式指定完整工作区路径:
89
+
90
+ ```shell
91
+ lc init D:/Projects/leetcode-local-cli --yes
92
+ ```
93
+
94
+ 官方安装器在非交互环境中不会等待输入,而是提示稍后手动执行 `lc init`。CI 可设置 `LEETCODE_LOCAL_CLI_NO_INIT=1` 显式跳过。版本更新发现有效默认工作区时会直接复用,不会重新询问、清空 `solution.py` 或修改工作区配置。
95
+
74
96
  升级或卸载:
75
97
 
76
98
  ```shell
@@ -83,6 +105,7 @@ uv tool uninstall leetcode-local-cli
83
105
  ## 基本工作流
84
106
 
85
107
  ```shell
108
+ lc init
86
109
  lc login
87
110
  lc doctor
88
111
  lc status
@@ -96,19 +119,24 @@ lc submit
96
119
 
97
120
  | 命令 | 作用 |
98
121
  | --- | --- |
122
+ | `lc init` | 交互输入父目录并创建或复用默认 `leetcode-local-cli` 工作区 |
123
+ | `lc init <完整路径> --yes` | 非交互配置明确的完整工作区路径,适合 AI/CI 验收 |
99
124
  | `lc login` | 读取或手动录入 LeetCode 中文站 Cookie |
100
125
  | `lc status` | 检查当前登录态 |
101
126
  | `lc profile` | 展示账号和刷题统计 |
102
127
  | `lc show --limit 20 --skip 0` | 分页展示题目索引,`limit` 单次最大为 100 |
103
128
  | `lc get <题号>` | 在线展示题目详情 |
104
- | `lc solve <题号>` | 覆盖生成当前目录的 `solution.py` |
129
+ | `lc solve <题号>` | 原子覆盖生成默认工作区的 `solution.py` |
105
130
  | `lc test` | 运行本地 `solution.py` |
106
- | `lc doctor` | 诊断 Session、网络、Cookie 和 `solution.py` |
131
+ | `lc doctor` | 诊断 Session、网络、Cookie 和 `solution.py`,默认不执行代码 |
132
+ | `lc doctor --run-solution` | 额外运行当前工作区的 `solution.py` |
107
133
  | `lc submit` | 提交当前 `solution.py` 的提交区域代码 |
108
134
 
109
135
  ## solution.py 规则
110
136
 
111
- `lc solve` 会覆盖当前目录的 `solution.py`。切换题目前请自行保存当前解法。
137
+ `lc init` 会创建不存在的空 `solution.py`,但已有普通文件会完整保留。`lc solve` 会创建不存在的 `solution.py`,也会原子覆盖默认工作区中的普通 `solution.py`。切换题目前请自行保存当前解法。
138
+
139
+ 如果工作区、配置或同名文件是符号链接、断链、目录链接、Windows junction 或其他 reparse point,初始化或写入会拒绝并以非零状态退出。普通文件覆盖使用同目录随机临时文件和原子替换,写入失败不会先截断旧解法。
112
140
 
113
141
  生成文件会包含题目元信息和提交区域:
114
142
 
@@ -142,28 +170,32 @@ class Solution:
142
170
  - 当前仅自动读取 Chrome Cookie。
143
171
  - `lc solve` 生成模板后会尝试打开 `solution.py`;Windows 使用系统默认打开方式,macOS 使用 `open`,Linux 使用 `xdg-open`。
144
172
  - 当前远程提交仅支持 Python3。
145
- - 当前只维护 CLI 启动目录中的单个 `solution.py`,不会生成每题独立目录。
173
+ - 当前只维护用户配置所指向的单个默认工作区和单个 `solution.py`,不会生成每题独立目录,也不提供全局 `--workspace`。
146
174
  - 当前不保存完整题面到本地,也不引入本地数据库。
147
- - `lc solve` 会强制覆盖 `solution.py`。
175
+ - `lc solve` 会强制覆盖普通 `solution.py`,但拒绝符号链接、断链、目录、目录链接和 Windows reparse point。
148
176
  - `lc show` 的 `limit` 必须为正整数且不超过 100,`skip` 必须为非负整数。
149
177
  - `lc test` 默认隐藏 Python traceback,只展示本地测试通过或失败。
150
- - 如果 `run_cases()` 中没有断言,`lc test` 显示通过是当前轻量化设计允许的行为。
178
+ - 当前 `lc test` 执行整个 `solution.py`,不验证或主动调用 `run_cases()`;缺少该函数的非空脚本可能显示通过,此行为正在重新定界。
151
179
  - 树、链表等题型中,LeetCode 模板里的 `TreeNode` / `ListNode` 定义默认保持注释状态;如需本地构造用例,请自行取消注释并编写测试数据。
152
- - `lc doctor` 会向 LeetCode 中文站发送一次登录态查询,并在本地运行语法有效的 `solution.py`;本地运行超过 10 秒会判定失败。
180
+ - `lc doctor` 会向 LeetCode 中文站发送一次登录态查询,并静态检查 `solution.py` 的存在性、可读性、Python 语法和提交结构;默认不会执行文件。
181
+ - `lc doctor --run-solution` 会额外运行语法有效的 `solution.py`,本地运行超过 10 秒会判定失败。
182
+ - `lc test` 和 `lc doctor --run-solution` 会以当前用户权限执行本地 Python 代码,请勿在不可信工作区中运行。
153
183
 
154
184
  ## 安全说明
155
185
 
156
- 登录态会保存到:
186
+ 登录态会保存到默认工作区:
157
187
 
158
188
  ```text
159
189
  .leetcode_local_cli/session.json
160
190
  ```
161
191
 
162
- 该文件可能包含敏感 Cookie 信息,已在 `.gitignore` 中忽略。v0.7 首次读取登录态时会把旧版 `.aether_lc/session.json` 自动迁移到新目录;迁移过程不会输出 Cookie 值。发布前请确认仓库根目录的 `solution.py` 为空,避免把个人解法提交到公开仓库。
192
+ 该文件包含敏感 Cookie 信息,当前仓库已在 `.gitignore` 中忽略。v0.8 不读取、迁移或删除旧 `.aether_lc/session.json`,也暂不接入操作系统凭据管理器;这是为维护者授权 AI 使用真实账号验收而保留的阶段性方案,不是长期安全终点。不要把工作区放进同步盘或共享目录,不要输出、暂存、提交或上传 Session 内容。发布前请确认仓库根目录的 `solution.py` 为空。
193
+
194
+ 仓库还会忽略常见个人编辑器目录、`.env*` 和常见凭据 JSON 文件名,并通过测试检查已跟踪 JSON 中的高风险秘密字段。不要使用 `git add -f` 强制添加这些文件;提交前仍应检查 `git status`,因为 `.gitignore` 不能替代秘密扫描,也不能保护已经被跟踪的文件。
163
195
 
164
196
  ## 登录态说明
165
197
 
166
- `leetcode-local-cli` 会把浏览器 Cookie 的本地副本保存到 CLI 启动目录下的 `.leetcode_local_cli/session.json`。本地保存的 Cookie 不会延长 LeetCode 登录态有效期;实际是否有效以 LeetCode 服务端验证为准。v0.8 的 `lc init` 会进一步将用户登录态与工作区分离。
198
+ `leetcode-local-cli` 会把浏览器 Cookie 的本地副本保存到默认工作区的 `.leetcode_local_cli/session.json`。本地保存的 Cookie 不会延长 LeetCode 登录态有效期;实际是否有效以 LeetCode 服务端验证为准。`lc init`、版本更新和工具卸载都不会覆盖或删除该文件。
167
199
 
168
200
  如果浏览器 Cookie 刷新,或旧 Cookie 被服务端判定失效,CLI 可能在 `lc status`、`lc profile` 或 `lc submit` 时提示重新执行:
169
201
 
@@ -201,7 +233,7 @@ uv run lc test
201
233
  uv run ruff check solution.py
202
234
  ```
203
235
 
204
- 维护者发布流程见 [RELEASING.md](https://github.com/Aetherialter/leetcode-local-cli/blob/main/RELEASING.md)。标签触发的发布工作流会在 Linux、macOS 和 Windows 上验收安装器,分别验证 wheel 与源码包,通过 PyPI Trusted Publisher 上传发行包,并创建 GitHub Release。
236
+ 维护者发布流程见 [发布手册](docs/RELEASING.md)。标签触发的发布工作流会在 Linux、macOS 和 Windows 上验收安装器,分别验证 wheel 与源码包,通过 PyPI Trusted Publisher 上传发行包,并创建 GitHub Release。
205
237
 
206
238
  ## 项目结构
207
239
 
@@ -210,8 +242,11 @@ src/leetcode_local_cli/
210
242
  auth.py Cookie 读取与本地 session
211
243
  client.py LeetCode 中文站 HTTP 客户端
212
244
  cli.py Typer 命令入口
245
+ config.py 版本化配置读取与工作区初始化
213
246
  doctor.py 本地环境、网络与登录态诊断
247
+ paths.py 跨平台路径与 AppPaths 运行上下文
214
248
  problem.py 题号解析与题目数据标准化
249
+ safe_files.py 非普通目标拒绝与原子文件写入
215
250
  service.py 应用层流程编排
216
251
  ui.py Rich 终端输出
217
252
  version.py 已安装发行版版本读取
@@ -222,14 +257,28 @@ scripts/
222
257
  smoke_test.py wheel 与源码包发布验收
223
258
  .github/workflows/
224
259
  release.yml 跨平台验证、PyPI 发布与 GitHub Release
260
+ docs/
261
+ README.md 文档索引与权威顺序
262
+ PROJECT_STATUS.md 当前实现状态
263
+ ARCHITECTURE.md 当前架构与数据流
264
+ PRODUCT_BOUNDARIES.md 已确认边界与待定决策
265
+ TECH_DECISIONS.md 技术决策记录
266
+ DEVELOPMENT_PLAN.md 唯一长期开发路线
267
+ PROJECT_DESIGN.md v1.0 长期架构设计
268
+ SECURITY_REVIEW.md 当前安全与可靠性问题
269
+ RELEASING.md 发布流程
270
+ release-notes/ 版本化发布说明
225
271
  tests/
226
272
  test_auth.py
227
273
  test_cli.py
228
274
  test_client.py
275
+ test_config.py
229
276
  test_doctor.py
230
277
  test_install_scripts.py
231
278
  test_problem.py
279
+ test_paths.py
232
280
  test_release.py
281
+ test_safe_files.py
233
282
  test_service.py
234
283
  test_ui.py
235
284
  test_workspace.py
@@ -245,9 +294,11 @@ tests/
245
294
  - `v0.6.0`: 新增 `lc doctor`,完善客户端边界校验、本地文件诊断、错误提示和提交目标展示。
246
295
  - `v0.7.0`: uv 全局工具安装、跨平台引导脚本和 PyPI Trusted Publisher 发布流程。
247
296
  - `v0.7.1`: 修正安装版 CLI 的命令建议,并引入版本化 GitHub Release Notes。
248
- - `v0.8`: `lc init` 与正式工作区管理。
249
- - `v0.9`: 轻量缓存。
250
- - `v0.10`: 样例提取原型。
297
+ - `v0.7.2`: 收紧安全边界,避免诊断命令默认执行解题文件,并移除安装器的远端脚本执行。
298
+ - `v0.8.0`: 新增显式运行上下文、版本化配置、`lc init`、默认工作区和安装后初始化。
299
+ - `v0.9`: 领域模型、异常与 Python API 预览。
300
+ - `v0.10`: 双站点客户端与独立账号体系。
301
+ - 后续版本:CLI 迁移、题面与 UI、源码收口和发布加固,详见[长期开发计划](docs/DEVELOPMENT_PLAN.md)。
251
302
  - `v1.0`: 稳定轻量 CLI。
252
303
 
253
304
  ## License
@@ -0,0 +1,282 @@
1
+ # 力扣中文站本地化刷题 CLI 工具
2
+
3
+ 一个面向 LeetCode 中文站的轻量本地刷题 CLI。它复用浏览器登录态,在线获取题目,在显式配置的默认工作区维护单文件 `solution.py`,并支持本地测试和远程提交。
4
+
5
+ 当前版本:`v0.8.0`
6
+
7
+ ## 长期开发手册
8
+
9
+ [完整文档索引](docs/README.md)集中列出项目状态、架构、产品边界、技术决策、开发计划、安全审计和发布手册。
10
+
11
+ [v1.0 总体设计大纲](docs/PROJECT_DESIGN.md)记录了从当前版本演进到稳定 CLI 与 Python API 的长期架构、版本阶段和验收标准。该文档目前处于 Draft 状态,具体实施前仍需按阶段审查。
12
+
13
+ [产品边界与待定决策](docs/PRODUCT_BOUNDARIES.md)记录当前已经确认的行为,以及必须先由维护者拍板才能实现的测试、提交、工作区、编辑器和兼容性语义。[安全审计与修复清单](docs/SECURITY_REVIEW.md)记录当前源码仍需处理的风险。
14
+
15
+ ## 核心能力
16
+
17
+ - 读取 Chrome 中的 `leetcode.cn` Cookie,复用登录态。
18
+ - 在线获取题目详情和题目索引。
19
+ - 使用 `lc init` 配置的默认工作区和单个 `solution.py`。
20
+ - `lc solve <题号>` 生成可编辑的 Python 解题模板。
21
+ - 生成模板后会按当前系统尝试打开 `solution.py`。
22
+ - `lc test` 执行本地 `solution.py`;`run_cases()` 的最终调用契约仍在产品边界文档中待定。
23
+ - `lc doctor` 一次检查 Session 文件、站点连通性、Cookie 登录态和本地解题文件。
24
+ - `lc submit` 提交 marker 区域代码到 LeetCode 中文站,并轮询判题结果。
25
+ - 生成模板时写入 `problem_id` 和 `submit_question_id`,避免展示题号和 LeetCode 内部提交 ID 混用。
26
+ - 生成模板时加入 Pyright/Ruff 文件级配置,减少刷题工作区的未使用导入、未使用变量和 star import 相关提示。
27
+ - 使用统一的客户端错误结果类型区分网络、HTTP、JSON、接口结构和登录态错误。
28
+
29
+ ## 环境要求
30
+
31
+ - Windows / Linux / macOS
32
+ - Python 3.12+
33
+ - [uv](https://docs.astral.sh/uv/)
34
+ - 已在浏览器中登录 LeetCode 中文站
35
+
36
+ ## 安装
37
+
38
+ Linux / macOS 一键安装:
39
+
40
+ ```bash
41
+ curl -LsSf https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.8.0/scripts/install.sh | sh
42
+ ```
43
+
44
+ Windows PowerShell 一键安装:
45
+
46
+ ```powershell
47
+ powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.8.0/scripts/install.ps1 | iex"
48
+ ```
49
+
50
+ 安装器要求系统已安装 uv;如果未检测到 uv,会安全退出并提示访问 [uv 官方文档](https://docs.astral.sh/uv/),不会自动下载或执行第三方远端安装脚本。检测到 uv 后,安装器会使用 `uv tool install` 安装 `leetcode-local-cli`,执行绝对路径的 `lc --version` 验证结果,并在可交互终端继续运行 `lc init`。安装过程不使用 `sudo`,也不会保存 PyPI 或 GitHub 凭据。
51
+
52
+ 已经安装 uv 时,也可以直接安装:
53
+
54
+ ```shell
55
+ uv tool install leetcode-local-cli
56
+ ```
57
+
58
+ 直接执行 `uv tool install` 不会运行项目自定义的安装后交互。首次使用前还需要手动执行:
59
+
60
+ ```shell
61
+ lc init
62
+ ```
63
+
64
+ 自动化或 AI 验收可以显式指定完整工作区路径:
65
+
66
+ ```shell
67
+ lc init D:/Projects/leetcode-local-cli --yes
68
+ ```
69
+
70
+ 官方安装器在非交互环境中不会等待输入,而是提示稍后手动执行 `lc init`。CI 可设置 `LEETCODE_LOCAL_CLI_NO_INIT=1` 显式跳过。版本更新发现有效默认工作区时会直接复用,不会重新询问、清空 `solution.py` 或修改工作区配置。
71
+
72
+ 升级或卸载:
73
+
74
+ ```shell
75
+ uv tool upgrade leetcode-local-cli
76
+ uv tool uninstall leetcode-local-cli
77
+ ```
78
+
79
+ 如果安装完成后当前终端仍找不到 `lc`,请重新打开终端,或执行 `uv tool update-shell` 后重载 shell 配置。
80
+
81
+ ## 基本工作流
82
+
83
+ ```shell
84
+ lc init
85
+ lc login
86
+ lc doctor
87
+ lc status
88
+ lc get 1
89
+ lc solve 1
90
+ lc test
91
+ lc submit
92
+ ```
93
+
94
+ 常用命令:
95
+
96
+ | 命令 | 作用 |
97
+ | --- | --- |
98
+ | `lc init` | 交互输入父目录并创建或复用默认 `leetcode-local-cli` 工作区 |
99
+ | `lc init <完整路径> --yes` | 非交互配置明确的完整工作区路径,适合 AI/CI 验收 |
100
+ | `lc login` | 读取或手动录入 LeetCode 中文站 Cookie |
101
+ | `lc status` | 检查当前登录态 |
102
+ | `lc profile` | 展示账号和刷题统计 |
103
+ | `lc show --limit 20 --skip 0` | 分页展示题目索引,`limit` 单次最大为 100 |
104
+ | `lc get <题号>` | 在线展示题目详情 |
105
+ | `lc solve <题号>` | 原子覆盖生成默认工作区的 `solution.py` |
106
+ | `lc test` | 运行本地 `solution.py` |
107
+ | `lc doctor` | 诊断 Session、网络、Cookie 和 `solution.py`,默认不执行代码 |
108
+ | `lc doctor --run-solution` | 额外运行当前工作区的 `solution.py` |
109
+ | `lc submit` | 提交当前 `solution.py` 的提交区域代码 |
110
+
111
+ ## solution.py 规则
112
+
113
+ `lc init` 会创建不存在的空 `solution.py`,但已有普通文件会完整保留。`lc solve` 会创建不存在的 `solution.py`,也会原子覆盖默认工作区中的普通 `solution.py`。切换题目前请自行保存当前解法。
114
+
115
+ 如果工作区、配置或同名文件是符号链接、断链、目录链接、Windows junction 或其他 reparse point,初始化或写入会拒绝并以非零状态退出。普通文件覆盖使用同目录随机临时文件和原子替换,写入失败不会先截断旧解法。
116
+
117
+ 生成文件会包含题目元信息和提交区域:
118
+
119
+ ```python
120
+ # pyright: reportUnusedImport=false, reportUnusedVariable=false
121
+ # ruff: noqa: F401, F841
122
+ # @lc problem_id: 1
123
+ # @lc submit_question_id: 1
124
+ # @lc title: Two Sum
125
+ # @lc title_slug: two-sum
126
+
127
+ # @lc submit_begin
128
+ class Solution:
129
+ def twoSum(self, nums: List[int], target: int) -> List[int]: pass
130
+ # @lc submit_end
131
+ ```
132
+
133
+ `lc submit` 只提交:
134
+
135
+ ```text
136
+ # @lc submit_begin
137
+ ...
138
+ # @lc submit_end
139
+ ```
140
+
141
+ 之间的代码。
142
+
143
+ ## 当前限制
144
+
145
+ - 当前仅支持 LeetCode 中文站。
146
+ - 当前仅自动读取 Chrome Cookie。
147
+ - `lc solve` 生成模板后会尝试打开 `solution.py`;Windows 使用系统默认打开方式,macOS 使用 `open`,Linux 使用 `xdg-open`。
148
+ - 当前远程提交仅支持 Python3。
149
+ - 当前只维护用户配置所指向的单个默认工作区和单个 `solution.py`,不会生成每题独立目录,也不提供全局 `--workspace`。
150
+ - 当前不保存完整题面到本地,也不引入本地数据库。
151
+ - `lc solve` 会强制覆盖普通 `solution.py`,但拒绝符号链接、断链、目录、目录链接和 Windows reparse point。
152
+ - `lc show` 的 `limit` 必须为正整数且不超过 100,`skip` 必须为非负整数。
153
+ - `lc test` 默认隐藏 Python traceback,只展示本地测试通过或失败。
154
+ - 当前 `lc test` 执行整个 `solution.py`,不验证或主动调用 `run_cases()`;缺少该函数的非空脚本可能显示通过,此行为正在重新定界。
155
+ - 树、链表等题型中,LeetCode 模板里的 `TreeNode` / `ListNode` 定义默认保持注释状态;如需本地构造用例,请自行取消注释并编写测试数据。
156
+ - `lc doctor` 会向 LeetCode 中文站发送一次登录态查询,并静态检查 `solution.py` 的存在性、可读性、Python 语法和提交结构;默认不会执行文件。
157
+ - `lc doctor --run-solution` 会额外运行语法有效的 `solution.py`,本地运行超过 10 秒会判定失败。
158
+ - `lc test` 和 `lc doctor --run-solution` 会以当前用户权限执行本地 Python 代码,请勿在不可信工作区中运行。
159
+
160
+ ## 安全说明
161
+
162
+ 登录态会保存到默认工作区:
163
+
164
+ ```text
165
+ .leetcode_local_cli/session.json
166
+ ```
167
+
168
+ 该文件包含敏感 Cookie 信息,当前仓库已在 `.gitignore` 中忽略。v0.8 不读取、迁移或删除旧 `.aether_lc/session.json`,也暂不接入操作系统凭据管理器;这是为维护者授权 AI 使用真实账号验收而保留的阶段性方案,不是长期安全终点。不要把工作区放进同步盘或共享目录,不要输出、暂存、提交或上传 Session 内容。发布前请确认仓库根目录的 `solution.py` 为空。
169
+
170
+ 仓库还会忽略常见个人编辑器目录、`.env*` 和常见凭据 JSON 文件名,并通过测试检查已跟踪 JSON 中的高风险秘密字段。不要使用 `git add -f` 强制添加这些文件;提交前仍应检查 `git status`,因为 `.gitignore` 不能替代秘密扫描,也不能保护已经被跟踪的文件。
171
+
172
+ ## 登录态说明
173
+
174
+ `leetcode-local-cli` 会把浏览器 Cookie 的本地副本保存到默认工作区的 `.leetcode_local_cli/session.json`。本地保存的 Cookie 不会延长 LeetCode 登录态有效期;实际是否有效以 LeetCode 服务端验证为准。`lc init`、版本更新和工具卸载都不会覆盖或删除该文件。
175
+
176
+ 如果浏览器 Cookie 刷新,或旧 Cookie 被服务端判定失效,CLI 可能在 `lc status`、`lc profile` 或 `lc submit` 时提示重新执行:
177
+
178
+ ```shell
179
+ lc login
180
+ ```
181
+
182
+ `lc show` 和 `lc get` 访问公开题目数据,可能在登录态失效时仍然可用。遇到登录态、网络或本地解题文件问题时,可以执行:
183
+
184
+ ```shell
185
+ lc doctor
186
+ ```
187
+
188
+ 诊断输出只包含用户名、Cookie 缺失项等安全元数据,不会展示 Cookie 值。
189
+
190
+ ## 开发与验证
191
+
192
+ ```shell
193
+ uv run ruff format src tests scripts
194
+ uv run ruff check src tests scripts pyproject.toml
195
+ uv run pyright src tests scripts
196
+ uv run pytest
197
+ uv build --no-sources
198
+ ```
199
+
200
+ 发布前常用手动检查:
201
+
202
+ ```shell
203
+ uv run lc --help
204
+ uv run lc --version
205
+ uv run lc doctor
206
+ uv run lc get 2196
207
+ uv run lc solve 1
208
+ uv run lc test
209
+ uv run ruff check solution.py
210
+ ```
211
+
212
+ 维护者发布流程见 [发布手册](docs/RELEASING.md)。标签触发的发布工作流会在 Linux、macOS 和 Windows 上验收安装器,分别验证 wheel 与源码包,通过 PyPI Trusted Publisher 上传发行包,并创建 GitHub Release。
213
+
214
+ ## 项目结构
215
+
216
+ ```text
217
+ src/leetcode_local_cli/
218
+ auth.py Cookie 读取与本地 session
219
+ client.py LeetCode 中文站 HTTP 客户端
220
+ cli.py Typer 命令入口
221
+ config.py 版本化配置读取与工作区初始化
222
+ doctor.py 本地环境、网络与登录态诊断
223
+ paths.py 跨平台路径与 AppPaths 运行上下文
224
+ problem.py 题号解析与题目数据标准化
225
+ safe_files.py 非普通目标拒绝与原子文件写入
226
+ service.py 应用层流程编排
227
+ ui.py Rich 终端输出
228
+ version.py 已安装发行版版本读取
229
+ workspace.py solution.py 生成、解析与运行
230
+ scripts/
231
+ install.sh Linux/macOS 一键安装器
232
+ install.ps1 Windows PowerShell 一键安装器
233
+ smoke_test.py wheel 与源码包发布验收
234
+ .github/workflows/
235
+ release.yml 跨平台验证、PyPI 发布与 GitHub Release
236
+ docs/
237
+ README.md 文档索引与权威顺序
238
+ PROJECT_STATUS.md 当前实现状态
239
+ ARCHITECTURE.md 当前架构与数据流
240
+ PRODUCT_BOUNDARIES.md 已确认边界与待定决策
241
+ TECH_DECISIONS.md 技术决策记录
242
+ DEVELOPMENT_PLAN.md 唯一长期开发路线
243
+ PROJECT_DESIGN.md v1.0 长期架构设计
244
+ SECURITY_REVIEW.md 当前安全与可靠性问题
245
+ RELEASING.md 发布流程
246
+ release-notes/ 版本化发布说明
247
+ tests/
248
+ test_auth.py
249
+ test_cli.py
250
+ test_client.py
251
+ test_config.py
252
+ test_doctor.py
253
+ test_install_scripts.py
254
+ test_problem.py
255
+ test_paths.py
256
+ test_release.py
257
+ test_safe_files.py
258
+ test_service.py
259
+ test_ui.py
260
+ test_workspace.py
261
+ ```
262
+
263
+ ## 版本路线
264
+
265
+ - `v0.5.x`: 远程提交上线后的 bugfix patch 线。
266
+ - `v0.5.4`: 修复 GraphQL `data: null` 导致 traceback,并精简 README。
267
+ - `v0.5.5`: 引入客户端错误结果类型,收敛 service 层错误处理并补充边界测试。
268
+ - `v0.5.6`: 收束 `lc show` 参数校验,避免非法分页参数触发远端接口异常提示。
269
+ - `v0.5.7`: 修复非 Windows 环境导入 `os.startfile` 导致 CLI 无法启动的问题。
270
+ - `v0.6.0`: 新增 `lc doctor`,完善客户端边界校验、本地文件诊断、错误提示和提交目标展示。
271
+ - `v0.7.0`: uv 全局工具安装、跨平台引导脚本和 PyPI Trusted Publisher 发布流程。
272
+ - `v0.7.1`: 修正安装版 CLI 的命令建议,并引入版本化 GitHub Release Notes。
273
+ - `v0.7.2`: 收紧安全边界,避免诊断命令默认执行解题文件,并移除安装器的远端脚本执行。
274
+ - `v0.8.0`: 新增显式运行上下文、版本化配置、`lc init`、默认工作区和安装后初始化。
275
+ - `v0.9`: 领域模型、异常与 Python API 预览。
276
+ - `v0.10`: 双站点客户端与独立账号体系。
277
+ - 后续版本:CLI 迁移、题面与 UI、源码收口和发布加固,详见[长期开发计划](docs/DEVELOPMENT_PLAN.md)。
278
+ - `v1.0`: 稳定轻量 CLI。
279
+
280
+ ## License
281
+
282
+ 本项目使用 [MIT License](LICENSE) 开源。
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "leetcode-local-cli"
3
- version = "0.7.1"
3
+ version = "0.8.0"
4
4
  description = "Local coding workflow CLI for LeetCode CN."
5
5
  readme = "README.md"
6
6
  license = "MIT"