Initial commit: grok-free-register-oss

Open-source Grok free registration CLI, xai_enroller auth pipeline,
local auth service, tests and docs.

docs/guides/credential-inventory.md

@@ -0,0 +1,19 @@
+# 凭据库存与取用
+
+认证成功的凭据保存在本地认证目录，并在 SQLite 库存中维护三种状态：
+
+- `available`：已经认证、尚未取用；
+- `claiming`：正在移动到取用批次；
+- `claimed`：已经取用。
+
+运行认证服务后输入：
+
+```text
+take 100
+```
+
+服务会选择最新的 100 个可用凭据，移动到 `claimed/<batch-id>/`，再把对应库存标记为 `claimed`。认证 ledger 中的 `imported` 记录仍然保留，所以这些账号不会被重新认证。
+
+每条库存记录预留 `note` 字段，默认为空。取用操作不要求填写用途；以后需要备注时可直接更新该字段。
+
+若文件移动中断，服务下次启动会恢复 `claiming` 状态。库存不足或凭据文件缺失时，操作失败但认证服务继续运行。