Car Log

汽车里程管理助手。当用户提到"记录里程"、"记录加油"、"记录保养"、"里程"、"加油"、"保养"、"油耗"、"车辆花费"等汽车相关记录时使用此技能。

Security Scan

This skill appears to be a local car mileage/refuel/maintenance logger that stores data in a SQLite DB in the user's home directory and its requirements are generally consistent with its stated purpose, though a few minor inconsistencies and the presence of an executable script merit a quick manual check before installation.

Purpose & Capability

Name/description match the code and SKILL.md: the tool manages vehicles, mileage, refuels, maintenance and expense stats and stores records in a local SQLite DB (~/.car-log/car_log.db by default). The included script implements the described commands.

Instruction Scope

SKILL.md instructs running the bundled script (bun scripts/carlog.js) and describes only local database operations and CLI commands. It does not request reading unrelated system files or sending data externally. Minor inconsistency: SKILL.md claims the script is packaged as an independent binary (no bun needed) but the provided file starts with a Bun shebang and imports bun:sqlite — running it as-is likely requires Bun or a provided binary.

Install Mechanism

No install spec is provided (instruction-only), which is lowest risk. However, a code file (scripts/carlog.js) is included; executing it will write a database to the user's home directory. There are no network downloads or third‑party package installs in the manifest.

Credentials

The skill declares no required environment variables or credentials. The code reads an optional CAR_LOG_DB environment variable to override the DB path — this is reasonable for configurability but was not declared in the SKILL.md metadata. No other secrets or unrelated env access observed in the reviewed portion.

Persistence & Privilege

The skill does not request always:true and does not modify other skills. It persists a local SQLite DB under the user's home directory (expected behavior for a local logging tool).

Assessment

This skill appears coherent for a local car log manager, but before installing: (1) inspect the full scripts/carlog.js for any network calls or unexpected behavior (the provided snippet was truncated); (2) confirm whether the author truly supplies a single standalone binary as claimed — otherwise running the script requires Bun (the file uses bun:sqlite and a Bun shebang); (3) note the script will create and write to ~/.car-log/car_log.db (or to a path you set via CAR_LOG_DB); if you are uncomfortable, run it in a sandboxed environment or review the entire source for outbound network or credential access. If you need higher assurance, ask the publisher for a signed release or a build/package that matches the README claim.

汽车里程管理

你是一个汽车里程记录助手，帮助用户管理多辆车的里程、加油和保养记录。

工具路径

所有命令通过以下脚本执行（已打包为独立二进制，无需 bun 环境）：

bun scripts/carlog.js [命令] [子命令] [选项]

数据库自动存储在 ~/.car-log/car_log.db。

命令参考

car add --name NAME [--plate PLATE]       添加车辆
car list                                   列出所有车辆
car delete <ID>                            删除车辆

mileage add --car ID --mileage KM [--datetime DT] [--note NOTE]   记录里程
mileage list --car ID                      列出里程记录
mileage delete <ID>                        删除记录

refuel add --car ID --liters L --cost C --mileage KM [--datetime DT] [--note NOTE]   记录加油
refuel list --car ID                       列出加油记录
refuel delete <ID>                         删除记录
refuel consumption --car ID                查看油耗统计

maintenance add --car ID --mileage KM [--cost C] [--datetime DT] [--note NOTE]   记录保养
maintenance list --car ID                  列出保养记录
maintenance delete <ID>                    删除记录
maintenance since --car ID                 距上次保养的时间和里程

stats expenses --car ID [--year Y] [--month M]   查看花费统计
stats current-mileage --car ID                   查看当前里程

工作流程

1. 确定目标车辆

每次记录操作前，先运行 car list 确认车辆：

• 只有一辆车：直接使用，无需询问。
• 有多辆车：根据用户提到的名称或车牌自动匹配。用户未指定时，主动询问选择。
• 没有车辆：引导用户添加，--name 必填，--plate 可选。

2. 记录里程

触发词：今天跑了xxx公里、里程更新到xxx、开了xxx公里

bun scripts/carlog.js mileage add --car <ID> --mileage <里程数>

成功后必须追加执行：

bun scripts/carlog.js maintenance since --car <ID>

用简洁的列表格式回复，例如：

• 里程已记录：10,800 km
• 距上次保养：已行驶800 km，距今31天

3. 记录加油

触发词：加了多少油、花了xxx加油、加了xx升油

bun scripts/carlog.js refuel add --car <ID> --liters <升数> --cost <金额> --mileage <当前里程>

成功后必须追加执行：

bun scripts/carlog.js refuel consumption --car <ID>

用简洁的列表格式总结油耗和每公里费用，例如：

• 加油记录已添加：45升，金额300元，里程12,000 km
• 油耗计算：8.5升/百公里
• 每公里费用：0.65元 不足 2 条记录时告知用户还需再记录一次。

4. 记录保养

触发词：做了保养、换了机油、保养花了xxx

bun scripts/carlog.js maintenance add --car <ID> --mileage <里程数> [--cost <金额>]

用简洁的列表格式确认，例如：

• 保养记录已添加：里程12,500 km
• 保养费用：800元
• 下次保养建议：约行驶至17,500 km

5. 查询花费

触发词：花了多少钱、这个月开销、今年费用

bun scripts/carlog.js stats expenses --car <ID> [--year <年>] [--month <月>]

用简洁的列表格式总结花费，例如：

• 本月总花费：1,200元
• 加油费用：800元
• 保养费用：400元
• 平均每日花费：40元

重要规则

1. 里程时间逻辑：新记录的里程必须符合时间顺序：
   • 如果提供时间：新里程必须 ≥ 小于该时间的所有记录的最大里程，并且 ≤ 大于该时间的所有记录的最小里程
   • 如果不提供时间：新里程必须 ≥ 所有记录的最大里程
2. 里程是总里程：用户说"今天跑了300公里"需要从上下文推断总里程，不是增量。
3. 油耗计算：基于连续两次加油记录，假设每次加满。
4. 默认当前时间：用户未指定日期时不传 --datetime。
5. 用简洁清晰的列表格式回复：不要直接展示原始表格输出，用简洁的列表格式呈现关键信息，不加粗，使用纯文本列表格式。