InkDash Lite（墨板轻量版）

InkDash Lite 是一个面向 Kindle 等电子墨水屏浏览器的 Codex 用量面板。目标很窄：在局域网内启动一个 Python 标准库服务，让 Kindle 常亮显示 Codex 周额度余量、本机 Token 消耗，以及可选的 z.ai 额度。

保留功能

• Kindle 友好的黑白大字号页面。
• Codex 周额度余量显示（兼容周限位于 primary 或 secondary 的返回结构）。
• 可选的 BigModel CN Coding Plan 5 小时额度显示。
• 本机近 24 小时和近 7 天 Token 消耗统计。
• Codex CLI RPC 优先读取，失败后回退本机会话文件。
• HTML meta refresh 自动刷新，不依赖 JavaScript。
• no-cache 响应头，减少 Kindle 显示旧页面。
• /settings 基础设置页。
• /status.txt 纯文本兜底。
• /api/usage、/api/config、/api/health 三个只读 JSON API。

不包含功能

• 协作状态看板。
• POST /api/status、/api/vibe、状态写入 API。
• vibe_update.py CLI、preset 状态包、Makefile 状态命令。
• systemd / launchd 示例。
• 大量协作文档和维护文档。

运行

python3 app.py

指定监听地址或端口：

python3 app.py --host 0.0.0.0 --port 8080

然后在 Kindle 浏览器打开：

http://<你的局域网 IP>:8080

配置

编辑 config.json，或打开 /settings：

{
  "server": {
    "host": "0.0.0.0",
    "port": 8080
  },
  "refresh": {
    "interval_seconds": 300,
    "auto_refresh_page_ms": 300000
  },
  "codex": {
    "enabled": true,
    "source": "auto",
    "session_file_limit": 10
  },
  "z_ai": {
    "enabled": false,
    "region": "bigmodel-cn"
  },
  "display": {
    "show_plan_type": true,
    "show_data_source": false,
    "show_last_updated": true,
    "text_scale_percent": 125
  }
}

z.ai 推荐通过环境变量提供 API Key，避免把密钥写入仓库：

export Z_AI_API_KEY="你的 z.ai API Key"
python3 app.py

然后在 /settings 中启用 z.ai；默认区域是 BigModel CN。页面和 /status.txt 只显示 Coding Plan 的 5 小时额度，MCP 及其他额度窗口不会展示。也可以在设置页保存 API Key；密钥只会写入已被 Git 忽略的 config.local.json，/api/config 也会始终隐藏密钥内容。

API

• GET /：Kindle 主页面。
• GET /settings：基础设置页。
• GET /status.txt：纯文本摘要。
• GET /api/usage：Codex 与可选 z.ai 用量 JSON。
• GET /api/config：当前配置 JSON。
• GET /api/health：服务健康状态。

验证

make ci

或直接运行：

python3 -m py_compile app.py
python3 -m unittest discover -s tests