kimi-code-usage 0.1.2__tar.gz → 0.1.4__tar.gz

kimi_code_usage-0.1.4/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run ruff check
+        run: uv run ruff check src/
+
+      - name: Run mypy
+        run: uv run mypy src/ || true
+      - name: Run security scan (bandit)
+        run: uv tool run bandit -r src/ || true
+
+      - name: Run dependency audit
+        run: uv audit || true
+
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov --cov-report=term-missing tests/
+
+      - name: Enforce coverage threshold
+        run: uv run coverage report

kimi_code_usage-0.1.4/AGENTS.md

@@ -0,0 +1,76 @@
+# Agent 协作指南
+
+本文件记录本项目的开发流程、发布经验和常见陷阱，供后续 AI/人类协作者参考。
+
+## 发布流程（Release Checklist）
+
+### 1. 前置条件
+
+- 所有变更已合并到 `main`
+- 测试全部通过且覆盖率达到预期
+- `pyproject.toml` 中的版本号已更新
+
+### 2. 版本号与标签
+
+```bash
+rtk git add pyproject.toml
+rtk git commit -m "chore: bump version to X.Y.Z
+
+chore: 将版本号提升至 X.Y.Z"
+rtk git tag vX.Y.Z
+rtk git push origin main --tags
+```
+
+### 3. 构建与发布
+
+```bash
+# 清理旧版本构建产物
+rm -f dist/kimi_code_usage-*
+
+# 构建 sdist 和 wheel
+uv build
+
+# 发布到 PyPI
+# 注意：uv publish 不会自动读取 ~/.pypirc，需要通过环境变量传入凭据
+UV_PUBLISH_USERNAME=__token__ UV_PUBLISH_PASSWORD=<your-pypi-token> uv publish dist/*
+```
+
+### 4. 验证
+
+```bash
+uv run -- python -c "import urllib.request, json; print(json.load(urllib.request.urlopen('https://pypi.org/pypi/kimi-code-usage/json'))['info']['version'])"
+```
+
+## 已知陷阱
+
+### uv publish 不读取 ~/.pypirc
+
+`uv publish` 当前版本不会自动读取 `~/.pypirc` 中的用户名/密码配置。即使 `~/.pypirc` 已正确配置，也必须通过以下方式之一提供凭据：
+
+- 环境变量：`UV_PUBLISH_USERNAME` 和 `UV_PUBLISH_PASSWORD`
+- 命令行参数：`--username` 和 `--password`
+
+### dist/ 目录残留旧版本
+
+`uv build` 不会自动清理 `dist/` 中的旧文件。如果目录中存在旧版本（如 `0.1.2`）的 wheel/tar.gz，`uv publish dist/*` 会尝试上传这些旧文件并导致冲突。发布前务必清理：
+
+```bash
+rm -f dist/kimi_code_usage-*
+```
+
+### 版本号与 git tag 必须一致
+
+PyPI 包版本来自 `pyproject.toml`，git tag 用于标记代码状态。两者应保持一致（如 `v0.1.3` 对应 `version = "0.1.3"`）。
+
+## 测试与覆盖率
+
+- 运行全部测试：`uv run pytest`
+- 带覆盖率检查：`uv run pytest --cov=kimi_code_usage --cov-report=term-missing`
+- 目标覆盖率：100%
+
+## Git 工作流
+
+- 使用 `git-feature` skill 创建功能分支
+- 按文件粒度提交，遵循 conventional commits
+- 通过 PR 合并到 `main`
+- 合并后删除本地和远程 feature 分支

{kimi_code_usage-0.1.2 → kimi_code_usage-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kimi-code-usage
-Version: 0.1.2
+Version: 0.1.4
 Summary: A curated Kimi Coding Plan usage monitor with aesthetic CLI and MCP server.
 Project-URL: Homepage, https://github.com/Golden0Voyager/kimi-code-usage
 Project-URL: Repository, https://github.com/Golden0Voyager/kimi-code-usage
@@ -40,7 +40,15 @@ Description-Content-Type: text/markdown
 
 In the era of "Vibecoding," transparency of resources is a prerequisite for flow. **Kimi Code Usage** is a meticulously crafted toolchain — three components, one soul.
 
-**Prerequisite:** A [Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key, set as `KIMI_API_KEY` in your environment or `.env` file.
+> **⚠️ 重要：API Key 类型说明**
+>
+> 本工具查询的是 **Kimi Code 平台（Coding Plan 会员）** 的用量数据。你需要的是 **Kimi Code 控制台** 创建的 API Key（格式 `sk-kimi-xxx`），
+> **不是** Kimi 开放平台（platform.kimi.com）的 API Key（格式 `sk-xxx`）。两种 Key 不互通。
+>
+> 获取方式：登录 Kimi Code 控制台 → 创建 API Key → 设置环境变量 `KIMI_API_KEY`。
+> 详见 [Kimi Code 文档](https://www.kimi.com/code/docs/)。
+
+**Prerequisite:** A [Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key (`sk-kimi-xxx`), set as `KIMI_API_KEY` in your environment or `.env` file.
 
 ---
 

{kimi_code_usage-0.1.2 → kimi_code_usage-0.1.4}/README.md

@@ -22,7 +22,15 @@
 
 In the era of "Vibecoding," transparency of resources is a prerequisite for flow. **Kimi Code Usage** is a meticulously crafted toolchain — three components, one soul.
 
-**Prerequisite:** A [Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key, set as `KIMI_API_KEY` in your environment or `.env` file.
+> **⚠️ 重要：API Key 类型说明**
+>
+> 本工具查询的是 **Kimi Code 平台（Coding Plan 会员）** 的用量数据。你需要的是 **Kimi Code 控制台** 创建的 API Key（格式 `sk-kimi-xxx`），
+> **不是** Kimi 开放平台（platform.kimi.com）的 API Key（格式 `sk-xxx`）。两种 Key 不互通。
+>
+> 获取方式：登录 Kimi Code 控制台 → 创建 API Key → 设置环境变量 `KIMI_API_KEY`。
+> 详见 [Kimi Code 文档](https://www.kimi.com/code/docs/)。
+
+**Prerequisite:** A [Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key (`sk-kimi-xxx`), set as `KIMI_API_KEY` in your environment or `.env` file.
 
 ---
 

{kimi_code_usage-0.1.2 → kimi_code_usage-0.1.4}/README.zh.md

@@ -22,7 +22,15 @@
 
 在"直觉编程"时代，资源的透明度是进入心流状态的前提。**Kimi Code Usage** 是一套精心打磨的工具链 — 三种形态，一个灵魂。
 
-**统一前提：** 在环境变量或 `.env` 文件中设置 `KIMI_API_KEY`（[Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key）。
+> **⚠️ 重要：API Key 类型说明**
+>
+> 本工具查询的是 **Kimi Code 平台（Coding Plan 会员）** 的用量数据。你需要的是 **Kimi Code 控制台** 创建的 API Key（格式 `sk-kimi-xxx`），
+> **不是** Kimi 开放平台（platform.kimi.com）的 API Key（格式 `sk-xxx`）。两种 Key 不互通。
+>
+> 获取方式：登录 Kimi Code 控制台 → 创建 API Key → 设置环境变量 `KIMI_API_KEY`。
+> 详见 [Kimi Code 文档](https://www.kimi.com/code/docs/)。
+
+**统一前提：** 在环境变量或 `.env` 文件中设置 `KIMI_API_KEY`（[Kimi Coding Plan](https://api.kimi.com/coding/v1) API Key，格式 `sk-kimi-xxx`）。
 
 ---
 

kimi_code_usage-0.1.4/htmlcov/.gitignore

@@ -0,0 +1,2 @@
+# Created by coverage.py
+*

kimi_code_usage-0.1.4/htmlcov/class_index.html

@@ -0,0 +1,281 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+    <title>Coverage report</title>
+    <link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png">
+    <link rel="stylesheet" href="style_cb_4667309f.css" type="text/css">
+    <script src="coverage_html_cb_dd2e7eb5.js" defer></script>
+</head>
+<body class="indexfile">
+<header>
+    <div class="content">
+        <h1>Coverage report:
+            <span class="pc_cov">100%</span>
+        </h1>
+        <aside id="help_panel_wrapper">
+            <input id="help_panel_state" type="checkbox">
+            <label for="help_panel_state">
+                <img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts">
+            </label>
+            <div id="help_panel">
+                <p class="legend">Shortcuts on this page</p>
+                <div class="keyhelp">
+                    <p>
+                        <kbd>f</kbd>
+                        <kbd>n</kbd>
+                        <kbd>s</kbd>
+                        <kbd>m</kbd>
+                        <kbd>x</kbd>
+                        <kbd>c</kbd>
+                        &nbsp; change column sorting
+                    </p>
+                    <p>
+                        <kbd>[</kbd>
+                        <kbd>]</kbd>
+                        &nbsp; prev/next file
+                    </p>
+                    <p>
+                        <kbd>?</kbd> &nbsp; show/hide this help
+                    </p>
+                </div>
+            </div>
+        </aside>
+        <form id="filter_container">
+            <input id="filter" type="text" value="" placeholder="filter...">
+            <div>
+                <input id="hide100" type="checkbox" >
+                <label for="hide100">hide covered</label>
+            </div>
+        </form>
+        <h2>
+                <a class="button" href="index.html">Files</a>
+                <a class="button" href="function_index.html">Functions</a>
+                <a class="button current">Classes</a>
+        </h2>
+        <p class="text">
+            <a class="nav" href="https://coverage.readthedocs.io/en/7.14.1">coverage.py v7.14.1</a>,
+            created at 2026-06-20 20:05 +0800
+        </p>
+    </div>
+</header>
+<main id="index">
+    <table class="index" data-sortable>
+        <thead>
+            <tr class="tablehead" title="Click to sort">
+                <th id="file" class="name" aria-sort="none" data-shortcut="f">File<span class="arrows"></span></th>
+                <th id="region" class="name" aria-sort="none" data-default-sort-order="ascending" data-shortcut="n">class<span class="arrows"></span></th>
+                <th class="spacer">&nbsp;</th>
+                <th id="statements" aria-sort="none" data-default-sort-order="descending" data-shortcut="s">statements<span class="arrows"></span></th>
+                <th id="missing" aria-sort="none" data-default-sort-order="descending" data-shortcut="m">missing<span class="arrows"></span></th>
+                <th id="excluded" aria-sort="none" data-default-sort-order="descending" data-shortcut="x">excluded<span class="arrows"></span></th>
+                <th class="spacer">&nbsp;</th>
+                <th id="coverage" aria-sort="none" data-shortcut="c">coverage<span class="arrows"></span></th>
+            </tr>
+        </thead>
+        <tbody>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610___init___py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>__init__.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610___init___py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>0</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="0 0">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t9">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>config.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t9"><data value='ProviderConfig'>ProviderConfig</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>0</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="0 0">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t16">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>config.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t16"><data value='AppConfig'>AppConfig</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>1</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="1 1">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t31">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>config.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t31"><data value='ConfigResolver'>ConfigResolver</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>70</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="70 70">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>config.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610_config_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>50</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="50 50">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610_main_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>main.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610_main_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>657</td>
+                <td>0</td>
+                <td>14</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="657 657">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_581a990e2fe7e610_mcp_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>mcp.py</a></td>
+                <td class="name"><a href="z_581a990e2fe7e610_mcp_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>121</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="121 121">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t8">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>__init__.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t8"><data value='ModelUsage'>ModelUsage</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>0</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="0 0">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t18">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>__init__.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t18"><data value='DailyUsage'>DailyUsage</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>0</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="0 0">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t25">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>__init__.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t25"><data value='ActivityTotals'>ActivityTotals</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>0</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="0 0">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t34">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>__init__.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html#t34"><data value='ProviderUsage'>ProviderUsage</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>0</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="0 0">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>__init__.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af___init___py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>71</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="71 71">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af_anthropic_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>anthropic.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af_anthropic_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>19</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="19 19">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af_kimi_py.html#t67">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>kimi.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af_kimi_py.html#t67"><data value='KimiRow'>KimiRow</data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>5</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="5 5">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af_kimi_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>kimi.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af_kimi_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>118</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="118 118">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af_openai_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>openai.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af_openai_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>42</td>
+                <td>0</td>
+                <td>0</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="42 42">100%</td>
+            </tr>
+            <tr class="region">
+                <td class="name"><a href="z_aaf3485d2243f1af_openrouter_py.html">src<span class="sep">/</span>kimi_code_usage<span class="sep">/</span>providers<span class="sep">/</span>openrouter.py</a></td>
+                <td class="name"><a href="z_aaf3485d2243f1af_openrouter_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
+                <td class="spacer">&nbsp;</td>
+                <td>167</td>
+                <td>0</td>
+                <td>4</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="167 167">100%</td>
+            </tr>
+        </tbody>
+        <tfoot>
+            <tr class="total">
+                <td class="name">Total</td>
+                <td class="name">&nbsp;</td>
+                <td class="spacer">&nbsp;</td>
+                <td>1321</td>
+                <td>0</td>
+                <td>18</td>
+                <td class="spacer">&nbsp;</td>
+                <td data-ratio="1321 1321">100%</td>
+            </tr>
+        </tfoot>
+    </table>
+    <p id="no_rows">
+        No items found using the specified filter.
+    </p>
+</main>
+<footer>
+    <div class="content">
+        <p>
+            <a class="nav" href="https://coverage.readthedocs.io/en/7.14.1">coverage.py v7.14.1</a>,
+            created at 2026-06-20 20:05 +0800
+        </p>
+    </div>
+    <aside class="hidden">
+        <a id="prevFileLink" class="nav" href=""></a>
+        <a id="nextFileLink" class="nav" href=""></a>
+        <button type="button" class="button_prev_file" data-shortcut="["></button>
+        <button type="button" class="button_next_file" data-shortcut="]"></button>
+        <button type="button" class="button_show_hide_help" data-shortcut="?"></button>
+    </aside>
+</footer>
+</body>
+</html>