vole-agent 0.1.7 → 0.1.9

package/README.md

@@ -10,16 +10,21 @@ npm install -g vole-agent
 
 ## Setup
 
-Set your API key in your shell profile or a `.env` file in your project root:
+Add your API key to `~/.vole/config.json` (created automatically on first run):
 
-```bash
-# Anthropic
-export VOLE_API_KEY=sk-ant-...
+```json
+{ "apiKey": "sk-ant-..." }
+```
+
+Or set an environment variable in your shell profile:
 
-# or OpenRouter
-export OPENROUTER_API_KEY=sk-or-...
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...   # Anthropic
+export OPENROUTER_API_KEY=sk-or-...   # OpenRouter
 ```
 
+Sessions are stored per-project under `<git-root>/.vole/sessions/` when inside a git repository, or `~/.vole/sessions/` otherwise.
+
 ## Usage
 
 ```bash
@@ -68,7 +73,19 @@ Inside `vole chat`:
 
 ## Configuration
 
-All configuration is via environment variables:
+Configuration is loaded from (in order of precedence): environment variables → `vole.config.json` (project) → `~/.vole/config.json` (user) → defaults.
+
+**File format** (`~/.vole/config.json` or `vole.config.json`):
+
+```json
+{
+  "apiKey": "sk-ant-...",
+  "model": "claude-haiku-4-5",
+  "defaultMode": "confirm"
+}
+```
+
+**Environment variables:**
 
 | Variable | Default | Description |
 |---|---|---|

package/README.zh-CN.md

@@ -10,16 +10,21 @@ npm install -g vole-agent
 
 ## 配置
 
-在 shell 配置文件或项目根目录的 `.env` 文件中设置 API key：
+将 API key 写入 `~/.vole/config.json`（首次运行时自动创建）：
 
-```bash
-# Anthropic
-export VOLE_API_KEY=sk-ant-...
+```json
+{ "apiKey": "sk-ant-..." }
+```
+
+或在 shell 配置文件中设置环境变量：
 
-# 或 OpenRouter
-export OPENROUTER_API_KEY=sk-or-...
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...   # Anthropic
+export OPENROUTER_API_KEY=sk-or-...   # OpenRouter
 ```
 
+在 git 仓库中运行时，会话存储在 `<git-root>/.vole/sessions/`；否则存储在 `~/.vole/sessions/`。
+
 ## 使用
 
 ```bash
@@ -66,7 +71,21 @@ vole sessions
 | `/help` | 显示所有指令 |
 | `/exit` | 退出对话 |
 
-## 环境变量配置
+## 环境变量与配置文件
+
+配置加载优先级：环境变量 → `vole.config.json`（项目级）→ `~/.vole/config.json`（用户级）→ 默认值。
+
+**配置文件格式**（`~/.vole/config.json` 或 `vole.config.json`）：
+
+```json
+{
+  "apiKey": "sk-ant-...",
+  "model": "claude-haiku-4-5",
+  "defaultMode": "confirm"
+}
+```
+
+**环境变量：**
 
 | 变量 | 默认值 | 说明 |
 |---|---|---|

package/dist/app.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import{a as le,d as W,h as ae}from"./chunk-ABKAA7HK.js";import{useState as T,useEffect as Se,useCallback as I,useMemo as fe,useRef as Ie}from"react";import{render as Ae,Box as c,Text as o,useInput as O,useApp as ke,useAnimation as Re,useStdout as Ee,Static as Me}from"ink";import _e from"ink-text-input";import{readFile as De,stat as Pe}from"fs/promises";import{dirname as je,join as U}from"path";import{marked as ze}from"marked";import{useRef as Ze}from"react";import{Text as Be}from"ink";import p from"chalk";import{marked as de}from"marked";var ce=!1;function ue(){ce||(ce=!0,de.use({tokenizer:{del(){}}}))}function y(e,l=0,d=!1){switch(e.type){case"heading":{let s=(e.tokens??[]).map(i=>y(i)).join("");return e.depth===1?p.bold.underline(s)+`
+import{a as le,d as W,h as ae}from"./chunk-6YKK6DUZ.js";import{useState as T,useEffect as Se,useCallback as I,useMemo as fe,useRef as Ie}from"react";import{render as Ae,Box as c,Text as o,useInput as O,useApp as ke,useAnimation as Re,useStdout as Ee,Static as Me}from"ink";import _e from"ink-text-input";import{readFile as De,stat as Pe}from"fs/promises";import{dirname as je,join as U}from"path";import{marked as ze}from"marked";import{useRef as Ze}from"react";import{Text as Be}from"ink";import p from"chalk";import{marked as de}from"marked";var ce=!1;function ue(){ce||(ce=!0,de.use({tokenizer:{del(){}}}))}function y(e,l=0,d=!1){switch(e.type){case"heading":{let s=(e.tokens??[]).map(i=>y(i)).join("");return e.depth===1?p.bold.underline(s)+`
 
 `:e.depth===2?p.bold(s)+`