kimi-code-usage 0.1.3__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.3 → kimi_code_usage-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kimi-code-usage
-Version: 0.1.3
+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.3 → 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.3 → 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.3 → kimi_code_usage-0.1.4}/htmlcov/class_index.html

@@ -11,7 +11,7 @@
 <header>
     <div class="content">
         <h1>Coverage report:
-            <span class="pc_cov">95%</span>
+            <span class="pc_cov">100%</span>
         </h1>
         <aside id="help_panel_wrapper">
             <input id="help_panel_state" type="checkbox">
@@ -55,7 +55,7 @@
         </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-14 14:57 +0800
+            created at 2026-06-20 20:05 +0800
         </p>
     </div>
 </header>
@@ -85,8 +85,8 @@
                 <td data-ratio="0 0">100%</td>
             </tr>
             <tr class="region">
-                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t10">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#t10"><data value='ProviderConfig'>ProviderConfig</data></a></td>
+                <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>
@@ -95,8 +95,8 @@
                 <td data-ratio="0 0">100%</td>
             </tr>
             <tr class="region">
-                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t17">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#t17"><data value='AppConfig'>AppConfig</data></a></td>
+                <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>
@@ -105,44 +105,44 @@
                 <td data-ratio="1 1">100%</td>
             </tr>
             <tr class="region">
-                <td class="name"><a href="z_581a990e2fe7e610_config_py.html#t32">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#t32"><data value='ConfigResolver'>ConfigResolver</data></a></td>
+                <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>3</td>
+                <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="67 70">96%</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>51</td>
-                <td>1</td>
+                <td>50</td>
+                <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="50 51">98%</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>658</td>
-                <td>36</td>
+                <td>657</td>
+                <td>0</td>
                 <td>14</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="622 658">95%</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>122</td>
-                <td>17</td>
+                <td>121</td>
+                <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="105 122">86%</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>
@@ -188,25 +188,25 @@
                 <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>72</td>
+                <td>71</td>
                 <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="72 72">100%</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>21</td>
+                <td>19</td>
                 <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="21 21">100%</td>
+                <td data-ratio="19 19">100%</td>
             </tr>
             <tr class="region">
-                <td class="name"><a href="z_aaf3485d2243f1af_kimi_py.html#t63">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#t63"><data value='KimiRow'>KimiRow</data></a></td>
+                <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>
@@ -218,31 +218,31 @@
                 <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>117</td>
+                <td>118</td>
                 <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="117 117">100%</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>43</td>
+                <td>42</td>
                 <td>0</td>
                 <td>0</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="43 43">100%</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>172</td>
-                <td>8</td>
+                <td>167</td>
                 <td>0</td>
+                <td>4</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="164 172">95%</td>
+                <td data-ratio="167 167">100%</td>
             </tr>
         </tbody>
         <tfoot>
@@ -250,11 +250,11 @@
                 <td class="name">Total</td>
                 <td class="name">&nbsp;</td>
                 <td class="spacer">&nbsp;</td>
-                <td>1332</td>
-                <td>65</td>
-                <td>14</td>
+                <td>1321</td>
+                <td>0</td>
+                <td>18</td>
                 <td class="spacer">&nbsp;</td>
-                <td data-ratio="1267 1332">95%</td>
+                <td data-ratio="1321 1321">100%</td>
             </tr>
         </tfoot>
     </table>
@@ -266,7 +266,7 @@
     <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-14 14:57 +0800
+            created at 2026-06-20 20:05 +0800
         </p>
     </div>
     <aside class="hidden">