⚙️ 设置

关于

荔枝记账 v1.0.0

轻量级云端记账服务

服务端渲染 · 极速加载 · 端到端加密

查看免责声明与服务条款

🔑 API 访问密钥

生成密钥后可在终端用 curl 直接记账。密钥仅在生成时显示一次,请妥善保管。

📖 如何调用

设置 API Key 后,可在终端用 curl 或脚本调用记账 API。三端通用:

① 设置环境变量

# 添加到 ~/.bashrc 或 ~/.zshrc
export LEDGER_KEY="你的API密钥"
export LEDGER_HOST="https://lycheeledger.cn"

② 记一笔支出

curl -s -X POST "$LEDGER_HOST/api/v1/ledger/sync/upload" \
  -H "X-API-Key: $LEDGER_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":$(date +%s),\"date\":\"$(date +%Y-%m-%d)\",\"category\":\"餐饮\",\"amount\":-35,\"note\":\"外卖\",\"modified_ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}]}"

③ 记一笔收入

curl -s -X POST "$LEDGER_HOST/api/v1/ledger/sync/upload" \
  -H "X-API-Key: $LEDGER_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":$(date +%s),\"date\":\"$(date +%Y-%m-%d)\",\"category\":\"工资\",\"amount\":8000,\"note\":\"本月\",\"modified_ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}]}"

④ 查看所有记录

curl -s "$LEDGER_HOST/api/v1/ledger/sync/all" -H "X-API-Key: $LEDGER_KEY" | python3 -m json.tool

⑤ 删除记录

curl -s -X POST "$LEDGER_HOST/api/v1/ledger/sync/batch-delete" \
  -H "X-API-Key: $LEDGER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"device_id":"cli","client_ids":[ID1,ID2]}'

① 设置环境变量

:: 临时生效(当前 CMD 窗口)
set LEDGER_KEY=你的API密钥
set LEDGER_HOST=https://lycheeledger.cn

:: 永久生效:setx LEDGER_KEY "你的API密钥"(需重开 CMD)
::
:: ⚠️ 每次记账前改 client_id 避免覆盖上一条:%RANDOM%%RANDOM% 生成 0~10亿随机数

② 记一笔支出

:: 每次执行前改 C_ID 值,或用 set /a C_ID=%RANDOM%%RANDOM% 自动生成
set C_ID=1

curl -s -X POST "%LEDGER_HOST%/api/v1/ledger/sync/upload" ^
  -H "X-API-Key: %LEDGER_KEY%" ^
  -H "Content-Type: application/json" ^
  -d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":%C_ID%,\"date\":\"2026-07-16\",\"category\":\"餐饮\",\"amount\":-35,\"note\":\"外卖\",\"modified_ts\":\"2026-07-16T12:00:00Z\"}]}"

③ 记一笔收入

set /a C_ID=%RANDOM%%RANDOM%

curl -s -X POST "%LEDGER_HOST%/api/v1/ledger/sync/upload" ^
  -H "X-API-Key: %LEDGER_KEY%" ^
  -H "Content-Type: application/json" ^
  -d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":%C_ID%,\"date\":\"2026-07-16\",\"category\":\"工资\",\"amount\":8000,\"note\":\"本月\",\"modified_ts\":\"2026-07-16T12:00:00Z\"}]}"

④ 查看所有记录

curl -s "%LEDGER_HOST%/api/v1/ledger/sync/all" -H "X-API-Key: %LEDGER_KEY%"

⑤ 删除记录

:: 用查到的 client_id 替换 1,2
curl -s -X POST "%LEDGER_HOST%/api/v1/ledger/sync/batch-delete" ^
  -H "X-API-Key: %LEDGER_KEY%" ^
  -H "Content-Type: application/json" ^
  -d "{\"device_id\":\"cli\",\"client_ids\":[1,2]}"

① 设置环境变量

# 当前会话
$env:LEDGER_KEY="你的API密钥"
$env:LEDGER_HOST="https://lycheeledger.cn"

# 永久生效:[Environment]::SetEnvironmentVariable("LEDGER_KEY","你的密钥","User")

② 记一笔支出

$body = @{
  device_id="cli"
  records=@(@{
    client_id=(Get-Date -UFormat %s)
    date=(Get-Date -Format "yyyy-MM-dd")
    category="餐饮"
    amount=-35
    note="外卖"
    modified_ts=(Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ")
  })
} | ConvertTo-Json -Compress

Invoke-RestMethod -Uri "$env:LEDGER_HOST/api/v1/ledger/sync/upload" `
  -Method Post `
  -Headers @{"X-API-Key"=$env:LEDGER_KEY} `
  -ContentType "application/json" `
  -Body $body

③ 查看所有记录

Invoke-RestMethod -Uri "$env:LEDGER_HOST/api/v1/ledger/sync/all" `
  -Headers @{"X-API-Key"=$env:LEDGER_KEY} | ConvertTo-Json -Depth 10

④ 删除记录

$body = '{"device_id":"cli","client_ids":[1,2]}'
Invoke-RestMethod -Uri "$env:LEDGER_HOST/api/v1/ledger/sync/batch-delete" `
  -Method Post `
  -Headers @{"X-API-Key"=$env:LEDGER_KEY} `
  -ContentType "application/json" `
  -Body $body

💡 API Key 仅限记账/查询/删除,无法改密码或访问 AI 功能。生成后只显示一次。
📋 amount 负数=支出,正数=收入;client_id 每次需不同,重复会覆盖上一条记录。

账户信息

用户 ID:

记录数:

⚠️ 安全提示:您的密码可能不符合最新安全要求

新规则要求密码必须包含字母、数字和特殊符号。建议您修改密码以提升账户安全性。

🔒 修改密码

☁️ 云端备份

最多保留 5 个备份

暂无备份