chaimi-keep-mcp 3.3.3-beta.1 → 3.3.3-beta.11

package/README.md

@@ -23,7 +23,7 @@
 # 1. 安装 MCPorter（WorkBuddy/OpenClaw 等 OpenClaw 架构的 Agent 必需）
 npm install -g mcporter
 
-# 2. 安装柴米记账 MCP
+# 2. 安装柴米AI记账 MCP
 npm install -g chaimi-keep-mcp
 
 # 3. 启动（自动配置 mcporter）
@@ -89,6 +89,29 @@ export MCP_PROMPT_URL="你的Prompt服务地址"
 
 ## Changelog
 
+### v3.3.3-beta.8 (2026-04-30)
+- **变更** 配置存储路径迁移 - 从 `~/.mcporter/` 迁移到 `~/.chaimi-keep/`，避免与其他 MCP 工具冲突
+- **优化** 安全权限 - 新增目录权限控制（0700），敏感文件权限控制（0600）
+
+### v3.3.3-beta.7 (2026-04-29)
+- **优化** 回复模板 - 新增"请确认信息"提示，时间移到核心数据区，添加类型变量
+- **优化** 空值处理 - 商家为空时不显示，timeNote 仅异常时显示
+- **修复** save_income - 添加 date 兜底逻辑，不传时间时使用当前时间
+- **修复** save_expense - 优化 timeNote 显示逻辑
+
+### v3.3.3-beta.6 (2026-04-29)
+- **优化** 品牌统一 - 所有"柴米记账"改为"柴米AI记账"
+- **优化** 工具描述 - 重写三个记账工具描述，包含完整调用示例和格式要求
+
+### v3.3.3-beta.4 (2026-04-29)
+- **优化** 收入记账时间解析统一 - save_income 同样使用 time_description，修复 AI 计算时间戳错误
+
+### v3.3.3-beta.3 (2026-04-29)
+- **优化** 文本记账时间解析 - 使用 time_description 替代直接计算时间戳，解决 AI 计算时间错误的问题
+
+### v3.3.3-beta.2 (2026-04-29)
+- **修复** 时间入库错误 - 解决消费时间被错误替换为当前时间的问题
+
 ### v3.3.1-beta.0 (2026-04-27)
 - **优化** 简化工具描述 - save_expense/save_receipt/save_income 描述更简洁，不暴露业务逻辑
 - **优化** 参数类型自动转换 - 支持 CLI 工具的字符串传参自动转为数字

package/SKILL.md

@@ -9,7 +9,7 @@ updated: "2026-04-27"
 
 # 柴米AI记账 Skill
 
-> ✨ 柴米记账超级美学版 - 让记账变成享受
+> ✨ 柴米AI记账超级美学版 - 让记账变成享受
 
 ---
 
@@ -67,7 +67,7 @@ updated: "2026-04-27"
 ## 三、文档引用关系
 
 ```
-用户使用柴米记账
+用户使用柴米AI记账
     ↓
 chaimi-keep-mcp ⭐ 本Skill
     ├── 记账成功 → 使用回复模板(见七、回复规范)
@@ -154,6 +154,17 @@ chaimi-keep-mcp ⭐ 本Skill
 - ✅ 返回 `_templateHint` 提示使用哪个模板
 - ✅ 返回 `_templateVariables` 提供模板变量数据
 
+**回复简洁原则（重要）**：
+- ❌ **不要输出记账过程** - 不要告诉用户"第1步确认信息、第2步解析时间..."等流程细节
+- ❌ **不要刷屏** - 记账是高频操作，简洁回复是对用户的尊重
+- ✅ **只输出最终结果** - 直接使用模板渲染记账成功信息
+- ✅ **除非用户要求** - 仅当用户主动询问"你是怎么记账的"时才说明流程
+
+**空值处理原则**：
+- 模板变量中，如果某个维度的值为空（null/undefined/空字符串），Agent 应跳过该行不显示
+- 必填字段（金额、类型、商品、分类）必须显示
+- 可选字段（商家、时间、洞察）为空时不显示
+
 ### 7.2 模板文件位置
 
 **主模板文件**: `references/response-templates.md`
@@ -175,14 +186,16 @@ references/
 | `get_receipt_list` | `references/response-templates.md` | 2.5 查询结果模板 | 小票列表查询 |
 | `get_statistics` | `references/response-templates.md` | 2.6 统计结果模板 | 消费统计分析 |
 
-### 7.4 回复模板使用流程
+### 7.4 回复模板使用流程（Agent 内部操作，不要告诉用户）
+
+> ⚠️ **注意**：这是 Agent 内部的处理流程，**不要输出给用户看**，只输出第 5 步的渲染结果。
 
 ```
 1. 调用工具 → 返回原始数据 + _templateLocation + _templateHint + _templateVariables
 2. 读取 _templateLocation 指定的模板文件
 3. 根据 _templateHint 选择对应模板章节
 4. 使用 _templateVariables 填充模板变量
-5. 渲染最终回复给用户
+5. 渲染最终回复给用户（只展示这一步的结果）
 ```
 
 ### 7.5 5层视觉结构
@@ -191,6 +204,8 @@ references/
 【第1层：成功标识】✅ 「Agent名称」已帮您记账成功
 【第2层：分隔强调】═══════════════
 【第3层：核心数据】💰 金额：¥xx.xx
+                      📊 类型：支出/收入
+═══════════════
 【第4层：详细信息】
     📦 商品：xxx
     🏷️ 分类：xxx
@@ -207,23 +222,37 @@ references/
 
 ### 7.6 标准成功模板
 
+> 📄 **完整模板定义** → 见 `references/response-templates.md` 第 2.1 节
+> 
+> **模板要点：**
+> - 第1层：成功标识 `✅ 「{agentName}」已帮您记账成功`
+> - 第2层：分隔线 `═══════════════`
+> - 第3层：核心数据（金额、类型、时间 + 🔴🔴确认提示）
+> - 第4层：分隔线
+> - 第5层：详细信息（商品、分类、商家）
+> - 第6层：消费洞察（可选）
+> - 第7层：底部祝福 + 品牌信息
+
+**渲染示例：**
 ```markdown
-✅ 「{agentName}」已帮您记账成功
+✅ 「你的小可爱」已帮您记账成功
 ═══════════════
-💰 金额：¥{金额}
+🔴🔴 请确认以下信息是否正确
+💰 金额：¥35.00
+📊 类型：支出
+🕐 时间：2026-04-24 12:30
 ═══════════════
 
-📦 商品：{商品名}
-🏷️ 分类：{分类}
-🏪 商家：{商家}
-🕐 时间：{日期时间}
+📦 商品：午餐
+🏷️ 分类：餐饮
+🏪 商家：麦当劳
 
-💡 消费洞察：{洞察内容}（可选）
+💡 消费洞察：本月餐饮支出占比30%，建议控制
 
 ───────────────
-🎉 {正能量情绪词}！
+🎉 美食为梦想充电，继续向前冲！🍚
   柴米AI记账
-  chaimi-keep-mcp v{版本号}
+  chaimi-keep-mcp v3.2.0
 ───────────────
 ```
 
@@ -234,6 +263,7 @@ references/
 | {agentName} | Agent显示名称 | 「你的小可爱」 |
 | {商品名} | 商品或商家名称 | 午餐、麦当劳 |
 | {金额} | 金额（带¥符号） | ¥35.00 |
+| {类型} | 支出/收入类型 | 支出、收入 |
 | {分类} | 消费分类 | 餐饮 |
 | {商家} | 商家名称（可选） | 麦当劳 |
 | {日期时间} | 格式化时间 | 2026-04-24 12:30 |
@@ -249,7 +279,7 @@ references/
 
 ## 八、记忆口诀
 
-> **柴米记账超美学，五层结构要牢记。**
+> **柴米AI记账超美学，五层结构要牢记。**
 > **成功标识在顶部，金额分隔最醒目。**
 > **商品分类商家时，底部祝福加品牌。**
 > **场景路由先匹配，工具速查再执行。**
@@ -263,7 +293,7 @@ references/
 
 | 错误 | 现象 | 解决方案 | 参考文档 |
 |:-----|:-----|:---------|:---------|
-| **授权失败** | "未找到有效授权" | 执行 `mcporter auth 柴米记账` 重新授权 | troubleshooting.md |
+| **授权失败** | "未找到有效授权" | 执行 `mcporter auth 柴米AI记账` 重新授权 | troubleshooting.md |
 | **分类不明** | "无法识别分类" | 明确说分类："午餐35元餐饮" | api-reference.md |
 | **网络超时** | "请求超时" | 检查网络，稍后重试 | troubleshooting.md |
 

package/bin/cli.js

@@ -161,8 +161,8 @@ function installToAgent(agent) {
       config.mcpServers = {};
     }
 
-    // 检查是否已存在柴米记账配置
-    if (config.mcpServers['柴米记账']) {
+    // 检查是否已存在柴米AI记账配置
+    if (config.mcpServers['柴米AI记账']) {
       return { 
         success: true, 
         action: 'skipped', 
@@ -171,8 +171,8 @@ function installToAgent(agent) {
       };
     }
 
-    // 添加柴米记账配置
-    config.mcpServers['柴米记账'] = JSON.parse(JSON.stringify(DEFAULT_CHAIMI_CONFIG));
+    // 添加柴米AI记账配置
+    config.mcpServers['柴米AI记账'] = JSON.parse(JSON.stringify(DEFAULT_CHAIMI_CONFIG));
 
     // 写入配置
     writeJSON(agent.configPath, config);

package/bin/get-auth-code.js

@@ -20,8 +20,9 @@ const MCP_OAUTH_URL = process.env.MCP_OAUTH_URL || 'https://cloud1-2gfe5jhjef06b
 
 // 检查是否已有有效 Token
 async function checkExistingToken() {
+  // 使用新的配置路径 ~/.chaimi-keep/
   const tokenStorage = new FileTokenStorage(
-    path.join(os.homedir(), '.mcporter', 'oauth-token.json')
+    path.join(os.homedir(), '.chaimi-keep', 'oauth-token.json')
   );
   
   try {
@@ -37,8 +38,9 @@ async function checkExistingToken() {
 
 // 获取新的授权码
 async function getAuthCode() {
+  // 使用新的配置路径 ~/.chaimi-keep/
   const tokenStorage = new FileTokenStorage(
-    path.join(os.homedir(), '.mcporter', 'oauth-token.json')
+    path.join(os.homedir(), '.chaimi-keep', 'oauth-token.json')
   );
 
   const oauthManager = new OAuthManager({

package/oauth.js

@@ -311,10 +311,14 @@ class OAuthManager {
     try {
       const fs = require('fs').promises;
       const path = require('path');
-      const stateFile = path.join(require('os').homedir(), '.mcporter', 'auth-state.json');
+      const os = require('os');
+      // 使用新的配置路径 ~/.chaimi-keep/
+      const stateFile = path.join(os.homedir(), '.chaimi-keep', 'auth-state.json');
       
       const dir = path.dirname(stateFile);
       await fs.mkdir(dir, { recursive: true });
+      // 设置目录权限 0700
+      await fs.chmod(dir, 0o700).catch(() => {});
       
       await fs.writeFile(
         stateFile,
@@ -329,7 +333,9 @@ class OAuthManager {
     try {
       const fs = require('fs').promises;
       const path = require('path');
-      const stateFile = path.join(require('os').homedir(), '.mcporter', 'auth-state.json');
+      const os = require('os');
+      // 使用新的配置路径 ~/.chaimi-keep/
+      const stateFile = path.join(os.homedir(), '.chaimi-keep', 'auth-state.json');
       
       const data = await fs.readFile(stateFile, 'utf8');
       return JSON.parse(data);
@@ -345,7 +351,9 @@ class OAuthManager {
     try {
       const fs = require('fs').promises;
       const path = require('path');
-      const stateFile = path.join(require('os').homedir(), '.mcporter', 'auth-state.json');
+      const os = require('os');
+      // 使用新的配置路径 ~/.chaimi-keep/
+      const stateFile = path.join(os.homedir(), '.chaimi-keep', 'auth-state.json');
       await fs.unlink(stateFile);
     } catch (err) {
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.3.3-beta.1",
+  "version": "3.3.3-beta.11",
   "description": "柴米AI记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {
@@ -40,7 +40,7 @@
     "AI记账",
     "model-context-protocol"
   ],
-  "author": "柴米记账团队,songyangx@gmail.com",
+  "author": "柴米AI记账团队,songyangx@gmail.com",
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",

package/references/authentication.md

@@ -1,8 +1,8 @@
 ---
 name: "chaimi-keep-authentication"
 description: 柴米AI记账授权流程详解
-version: "1.0.0"
-updated: "2026-04-25"
+version: "1.0.1"
+updated: "2026-04-30"
 ---
 
 # 柴米AI记账授权流程
@@ -58,7 +58,7 @@ updated: "2026-04-25"
 
 1. **启动授权流程**
    ```bash
-   mcporter auth 柴米记账
+   mcporter auth 柴米AI记账
    ```
    或
    ```bash
@@ -68,14 +68,14 @@ updated: "2026-04-25"
 2. **查看验证码**
    终端会显示：
    ```
-   🔐 柴米记账授权
+   🔐 柴米AI记账授权
    ═══════════════════════════
    📱 验证码：GGCY-AC84
    ⏰ 有效期：5分钟
    ```
 
 3. **小程序确认**
-   - 打开"柴米记账"小程序
+   - 打开"柴米AI记账"小程序
    - 点击"我的" → "AI 助手绑定"
    - 输入验证码
    - 点击确认
@@ -90,15 +90,15 @@ updated: "2026-04-25"
 
 ```bash
 # 重新授权
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 
 # 强制清除缓存后重新授权
-mcporter auth 柴米记账 --reset
+mcporter auth 柴米AI记账 --reset
 ```
 
 **然后：**
 1. 查看终端显示的验证码
-2. 打开"柴米记账"小程序
+2. 打开"柴米AI记账"小程序
 3. 进入"我的" → "AI 助手绑定"
 4. 输入验证码完成授权
 
@@ -124,7 +124,7 @@ mcporter auth 柴米记账 --reset
    ```
    或
    ```bash
-   mcporter auth 柴米记账
+   mcporter auth 柴米AI记账
    ```
 2. 查看终端显示的验证码
 3. 在小程序"我的"→"AI 助手绑定"中输入验证码
@@ -134,12 +134,12 @@ mcporter auth 柴米记账 --reset
 
 **macOS/Linux:**
 ```bash
-rm ~/.mcporter/oauth-token.json
+rm ~/.chaimi-keep/oauth-token.json
 ```
 
 **Windows:**
 ```cmd
-del %USERPROFILE%\.mcporter\oauth-token.json
+del %USERPROFILE%\.chaimi-keep\oauth-token.json
 ```
 
 然后完全退出并重新启动 Claude/Cursor
@@ -157,22 +157,22 @@ del %USERPROFILE%\.mcporter\oauth-token.json
 
 ```bash
 # 查看 Token 文件是否存在
-cat ~/.mcporter/oauth-token.json
+cat ~/.chaimi-keep/oauth-token.json
 
 # 或尝试调用工具测试
-mcporter call 柴米记账.get_skill
+mcporter call 柴米AI记账.get_skill
 ```
 
 **Token 文件位置：**
 ```
-~/.mcporter/oauth-token.json
+~/.chaimi-keep/oauth-token.json
 ```
 
 ### 3.2 Token刷新
 
 Token 过期后需要重新授权：
 ```bash
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 ```
 
 ---
@@ -192,7 +192,7 @@ mcporter auth 柴米记账
 
 ```bash
 # 强制清除缓存后重新授权
-mcporter auth 柴米记账 --reset
+mcporter auth 柴米AI记账 --reset
 ```
 
 **场景：**

package/references/response-templates.md

@@ -47,6 +47,7 @@ updated: "2026-04-25"
 |:-----|:------|:-----|
 | 成功标识 | ✅ | 操作成功 |
 | 金额 | 💰 | 核心数据 |
+| 类型 | 📊 | 支出/收入 |
 | 商品 | 📦 | 物品 |
 | 分类 | 🏷️ | 标签分类 |
 | 商家 | 🏪 | 商店 |
@@ -54,6 +55,63 @@ updated: "2026-04-25"
 | 祝福 | 🎉 | 庆祝 |
 | 警示 | ⚠️ | 需要关注 |
 
+### 1.4 空值处理规范（重要）
+
+**规则**：详细信息区（第4层）的维度，如果值为空，则不展示该行。
+
+**处理逻辑**：
+```
+渲染前检查每个字段：
+- 如果字段值存在且不为空 → 显示该行
+- 如果字段值为空/null/undefined → 跳过该行
+```
+
+**示例**：
+```markdown
+// 完整数据
+📦 商品：午餐
+🏷️ 分类：餐饮
+🏪 商家：麦当劳
+🕐 时间：2026-04-24 12:30
+
+// 商家为空时
+📦 商品：午餐
+🏷️ 分类：餐饮
+🕐 时间：2026-04-24 12:30
+（🏪 商家：这一行不显示）
+
+// 只有商品和金额时
+📦 商品：午餐
+（其他维度为空，都不显示）
+```
+
+**必填 vs 可选字段**：
+| 字段 | 是否必填 | 为空时处理 |
+|:-----|:---------|:-----------|
+| 商品名 | ✅ 必填 | 必须显示 |
+| 分类 | ✅ 必填 | 必须显示 |
+| 类型 | ✅ 必填 | 必须显示 |
+| 金额 | ✅ 必填 | 必须显示 |
+| 商家 | ❌ 可选 | 为空不显示 |
+| 时间 | ❌ 可选 | 为空不显示 |
+| 洞察 | ❌ 可选 | 为空不显示 |
+
+**规则2：避免重复显示**
+- 如果商品名和分类相同 → 只显示分类行（避免重复）
+- 如果商品名和分类不同 → 两行都显示
+
+**示例**：
+```markdown
+// 用户说"交通 12"（商品名=分类）
+🏷️ 分类：交通
+（📦 商品：交通 不显示，避免重复）
+
+// 用户说"午餐 35"（商品名=午餐，分类=餐饮）
+📦 商品：午餐
+🏷️ 分类：餐饮
+（两行都显示）
+```
+
 ---
 
 ## 二、标准模板
@@ -65,18 +123,20 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「{agentName}」已帮您记账成功
 ═══════════════
+🔴🔴 请确认以下信息是否正确
 💰 金额：¥{金额}
+📊 类型：{类型}
+🕐 时间：{日期时间}
 ═══════════════
 
 📦 商品：{商品名}
 🏷️ 分类：{分类}
 🏪 商家：{商家}
-🕐 时间：{日期时间}
-
-💡 消费洞察：{洞察内容}（可选）
+💡 消费洞察：{洞察内容}
+⏰ 时间说明：{timeNote}
 
 ───────────────
-🎉 {正能量祝福语}！
+🎉 {正能量情绪词}！
   柴米AI记账
   chaimi-keep-mcp v{版本号}
 ───────────────
@@ -87,14 +147,15 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「你的小可爱」已帮您记账成功
 ═══════════════
+🔴🔴 请确认以下信息是否正确
 💰 金额：¥35.00
+📊 类型：支出
+🕐 时间：2026-04-24 12:30
 ═══════════════
 
 📦 商品：午餐
 🏷️ 分类：餐饮
 🏪 商家：麦当劳
-🕐 时间：2026-04-24 12:30
-
 💡 消费洞察：本月餐饮支出占比30%，建议控制
 
 ───────────────

package/references/troubleshooting.md

@@ -38,7 +38,7 @@ updated: "2026-04-25"
 - 授权被撤销
 
 **解决方案：**
-1. 执行 `mcporter auth 柴米记账`
+1. 执行 `mcporter auth 柴米AI记账`
 2. 查看终端显示的验证码
 3. 在小程序"我的"→"AI 助手绑定"中输入验证码
 4. 重新尝试记账
@@ -58,10 +58,10 @@ updated: "2026-04-25"
 **解决方案：**
 ```bash
 # 重新授权
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 
 # 或强制清除缓存后重新授权
-mcporter auth 柴米记账 --reset
+mcporter auth 柴米AI记账 --reset
 ```
 
 ### 1.3 验证码错误
@@ -76,7 +76,7 @@ mcporter auth 柴米记账 --reset
 - 验证码超过5分钟有效期
 
 **解决方案：**
-1. 重新执行 `mcporter auth 柴米记账` 生成新验证码
+1. 重新执行 `mcporter auth 柴米AI记账` 生成新验证码
 2. 在5分钟内在小程序"我的"→"AI 助手绑定"中输入
 3. 注意区分大小写
 
@@ -218,7 +218,7 @@ mcporter auth 柴米记账 --reset
 
 **解决方案：**
 1. 等待几分钟后重试
-2. 检查柴米记账官方公告
+2. 检查柴米AI记账官方公告
 3. 提交反馈：调用 `submit_feedback`
 
 ---
@@ -269,7 +269,7 @@ cat /mcp-server-local/references/response-templates.md
 chaimi-keep-mcp --version
 
 # 重新授权
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 
 # 测试记账连接
 curl -X POST https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpHub-mcp \

package/server.js

@@ -5,6 +5,9 @@
  * 支持 Claude Desktop、Cursor、WorkBuddy、OpenClaw
  */
 
+// 设置 stdout 编码为 UTF-8，确保中文字符正确输出
+process.stdout.setEncoding('utf8');
+
 // 加载 .env 文件
 try {
   require('dotenv').config();
@@ -39,6 +42,9 @@ const MCP_VERSION = getVersion();
 // 导入 OAuth 模块
 const { OAuthManager, FileTokenStorage } = require('./oauth.js');
 
+// 导入配置管理工具
+const { configManager } = require('./utils/config.js');
+
 // 导入校验工具
 const { validateDate } = require('./utils/validators.js');
 
@@ -167,9 +173,9 @@ let oauthManager = null;
 
 // 初始化 OAuth 管理器
 async function initOAuthManager() {
-  const tokenStorage = new FileTokenStorage(
-    path.join(os.homedir(), '.mcporter', 'oauth-token.json')
-  );
+  // 使用新的配置路径 ~/.chaimi-keep/
+  const tokenPath = configManager.getPath('oauth-token.json');
+  const tokenStorage = new FileTokenStorage(tokenPath);
 
   oauthManager = new OAuthManager({
     mcpOAuthUrl: MCP_OAUTH_URL,
@@ -243,7 +249,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     tools: [
       {
         name: 'get_skill',
-        description: '【记账前必须调用】获取柴米记账最新 Skill 定义。每次记账前必须先调用此工具，获取当前版本的完整 Skill 文档，然后严格按照 Skill 定义执行。如果不调用此工具直接记账，操作将被拒绝',
+        description: '【记账前必须调用】获取柴米AI记账最新 Skill 定义。每次记账前必须先调用此工具，获取当前版本的完整 Skill 文档，然后严格按照 Skill 定义执行。如果不调用此工具直接记账，操作将被拒绝',
         inputSchema: {
           type: 'object',
           properties: {
@@ -253,7 +259,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_expense',
-        description: '【强制验证Token】保存单商品消费记录。前置要求：先调用 get_skill 和 get_text_parse_prompt。字段列表见 get_text_parse_prompt 返回的模板。',
+        description: '【文本记账-支出】用户提及支出/消费时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_expense _requestToken="RT..." name="午餐" amount=35 category="餐饮" rawInput="午餐35元"。注意：上传图片请用save_receipt',
         inputSchema: {
           type: 'object',
           properties: {
@@ -275,7 +281,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_receipt',
-        description: '【强制验证Token】【必须上传图片】保存购物小票/发票/收据图片。⚠️ 注意：必须是图片才能使用此工具记账，文字描述请用 save_expense。前置要求：先调用 get_skill 和 get_parse_prompt。items为商品数组，字段列表见 get_parse_prompt 返回的模板.',
+        description: '【图片记账-小票】用户上传小票/发票/收据图片时用此工具。前置：必须先调用get_skill获取规范，再调用get_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_receipt _requestToken="RT..." store="超市" totalAmount=156.5 items="[...]"。注意：文字描述请用save_expense/save_income',
         inputSchema: {
           type: 'object',
           properties: {
@@ -403,7 +409,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_income',
-        description: '【强制验证Token】保存收入记录。前置要求：先调用 get_skill 和 get_text_parse_prompt。字段列表见 get_text_parse_prompt 返回的模板.',
+        description: '【文本记账-收入】用户提及收入关键词（工资、红包、转账、退款等）时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_income _requestToken="RT..." name="红包" amount=100 category="礼金" rawInput="收红包100元"',
         inputSchema: {
           type: 'object',
           properties: {
@@ -667,8 +673,15 @@ async function callMcpHubWithLogging(tool, params, token, traceId, startTime, os
   //   logSource: 'mcp'
   // });
 
+  // 添加 agentType 和 apiProvider 到 params，确保传递到云函数
+  const paramsWithMeta = {
+    ...params,
+    agentType: agentType || '',
+    apiProvider: apiProvider || '',
+  };
+
   try {
-    const result = await callMcpHub(tool, params, token, traceId, osInfo);
+    const result = await callMcpHub(tool, paramsWithMeta, token, traceId, osInfo);
 
     // 记录云函数调用成功（已停用：MCP调用日志待迁移到独立云函数）
     // logMcpCall({
@@ -977,7 +990,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             success: false,
             error: `必填字段缺失：${missingFields.join(', ')}`,
             code: 400,
-            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米记账 --schema 查看完整参数结构',
+            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米AI记账 --schema 查看完整参数结构',
             debug: {
               missing: missingFields,
               received: Object.keys(processedArgs),
@@ -999,6 +1012,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
         
+        // 【新增】处理 time_description（文本记账新时间格式）
+        let timeNote = null;
+        if (processedArgs.time_description) {
+          const parsedDate = parseTimeDescription(processedArgs.time_description, Date.now());
+          processedArgs.date = parsedDate;
+          // 正常解析时不显示 timeNote，只有兜底或异常时才显示
+          console.log(`[save_expense] 时间描述解析: ${processedArgs.time_description} → ${parsedDate} (${new Date(parsedDate).toLocaleString('zh-CN')})`);
+        }
+        
         // P1: 日期合理性检查
         if (processedArgs.date) {
           const validation = validateDate(processedArgs.date, '消费日期');
@@ -1011,8 +1033,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             userMessage = validation.message;
             break;
           }
+          
+          // 【新增】校验时间是否在合理范围内（±1年）
+          const dateObj = new Date(processedArgs.date);
+          const now = new Date();
+          const oneYearAgo = new Date(now.getFullYear() - 1, 0, 1);
+          const oneYearLater = new Date(now.getFullYear() + 1, 11, 31);
+          
+          if (dateObj < oneYearAgo || dateObj > oneYearLater) {
+            console.warn(`[save_expense] 时间异常：${processedArgs.date} (${dateObj.toLocaleString('zh-CN')})，使用当前时间`);
+            processedArgs.date = Date.now();
+            timeNote = '⏰ 时间说明：检测到时间异常，已使用当前时间';
+          }
         }
         
+        // 添加 agentType 和 apiProvider 到 processedArgs，确保 convertParams 能获取到
+        processedArgs.agentType = agentType || '';
+        processedArgs.apiProvider = apiProvider || '';
+        
         const mcpParams = convertParams('save_expense', processedArgs);
         result = await callMcpHubWithLogging('addExpense', mcpParams, token, traceId, startTime, osInfo, agentType, apiProvider);
         
@@ -1050,14 +1088,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           result._templateHint = '请使用references/response-templates.md中的2.1标准成功模板渲染回复';
           result._templateVariables = {
             agentName: await getAgentName(),
+            类型: '支出',
             商品名: displayName,
-            商家: displayStore || '',
+            商家: displayStore || null,
             金额: displayAmount,
             分类: result.data?.categoryName || displayCategory,
-            日期: result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN'),
+            日期: result.data?.date ? new Date(result.data.date).toLocaleString('zh-CN') : new Date().toLocaleString('zh-CN'),
             正能量祝福语: friendlyEnding,
             insightsText,
-            achievementsText
+            achievementsText,
+            timeNote: timeNote || null
           };
         }
         break;
@@ -1079,7 +1119,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             success: false,
             error: `必填字段缺失：${missingFields.join(', ')}`,
             code: 400,
-            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米记账 --schema 查看完整参数结构',
+            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米AI记账 --schema 查看完整参数结构',
             debug: {
               missing: missingFields,
               received: Object.keys(processedArgs),
@@ -1147,7 +1187,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             error: `商品数据不完整：${invalidItems.join('; ')}。每个商品必须包含：name, amount, price, quantity, category`,
             code: 400
           };
-          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米记账 MCP Skill\n2. 确保每个商品包含完整的5个字段：name, amount, price, quantity, category\n3. category 是记账的基本信息，不能为空`;
+          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米AI记账 MCP Skill\n2. 确保每个商品包含完整的5个字段：name, amount, price, quantity, category\n3. category 是记账的基本信息，不能为空`;
           break;
         }
         
@@ -1290,6 +1330,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           };
         }
         
+        // 添加 agentType 和 apiProvider 到 processedArgs，确保 convertParams 能获取到
+        processedArgs.agentType = agentType || '';
+        processedArgs.apiProvider = apiProvider || '';
+        
         const mcpParams = convertParams('save_receipt', processedArgs);
         result = await callMcpHubWithLogging('addReceipt', mcpParams, token, traceId, startTime, osInfo, agentType, apiProvider);
         
@@ -1459,8 +1503,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       case 'save_income': {
-        // P0: 数据完整性检查 - 必填字段验证
-        const requiredFields = ['name', 'amount', 'category', 'date', 'rawInput'];
+        // P0: 数据完整性检查 - 必填字段验证（date 改为 time_description，不强制检查）
+        const requiredFields = ['name', 'amount', 'category', 'rawInput'];
         const missingFields = [];
 
         for (const field of requiredFields) {
@@ -1474,14 +1518,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             success: false,
             error: `必填字段缺失：${missingFields.join(', ')}`,
             code: 400,
-            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米记账 --schema 查看完整参数结构',
+            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米AI记账 --schema 查看完整参数结构',
             debug: {
               missing: missingFields,
               received: Object.keys(processedArgs),
               docs: '调用 get_skill() 获取详细使用指南'
             }
           };
-          userMessage = `❌ 收入记录失败\n\n错误：缺少必填字段：${missingFields.join(', ')}\n\n💡 解决方案：\n1. 请检查是否从用户输入中提取了所有信息\n2. 确保传递以下字段：name（收入来源）、amount（金额）、category（分类）、date（日期）、rawInput（原始输入）\n3. 参考 SKILL.md 中的"调用前检查清单"`;
+          userMessage = `❌ 收入记录失败\n\n错误：缺少必填字段：${missingFields.join(', ')}\n\n💡 解决方案：\n1. 请检查是否从用户输入中提取了所有信息\n2. 确保传递以下字段：name（收入来源）、amount（金额）、category（分类）、rawInput（原始输入）\n3. 参考 SKILL.md 中的"调用前检查清单"`;
           break;
         }
 
@@ -1496,6 +1540,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
 
+        // 【新增】处理 time_description（收入记账新时间格式）
+        let timeNote = null;
+        if (processedArgs.time_description) {
+          const parsedDate = parseTimeDescription(processedArgs.time_description, Date.now());
+          processedArgs.date = parsedDate;
+          // 正常解析时不显示 timeNote，只有兜底或异常时才显示
+          console.log(`[save_income] 时间描述解析: ${processedArgs.time_description} → ${parsedDate} (${new Date(parsedDate).toLocaleString('zh-CN')})`);
+        }
+        // 【新增】兜底：如果既没传 time_description 也没传 date，使用当前时间
+        else if (!processedArgs.date) {
+          processedArgs.date = Date.now();
+          timeNote = '⏰ 时间说明：未指定时间，使用当前时间';
+          console.log(`[save_income] 未传时间参数，使用当前时间: ${processedArgs.date}`);
+        }
+        
         // P1: 日期合理性检查
         if (processedArgs.date) {
           const validation = validateDate(processedArgs.date, '收入日期');
@@ -1508,8 +1567,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             userMessage = validation.message;
             break;
           }
+          
+          // 【新增】校验时间是否在合理范围内（±1年）
+          const dateObj = new Date(processedArgs.date);
+          const now = new Date();
+          const oneYearAgo = new Date(now.getFullYear() - 1, 0, 1);
+          const oneYearLater = new Date(now.getFullYear() + 1, 11, 31);
+          
+          if (dateObj < oneYearAgo || dateObj > oneYearLater) {
+            console.warn(`[save_income] 时间异常：${processedArgs.date} (${dateObj.toLocaleString('zh-CN')})，使用当前时间`);
+            processedArgs.date = Date.now();
+            timeNote = '⏰ 时间说明：检测到时间异常，已使用当前时间';
+          }
         }
 
+        // 添加 agentType 和 apiProvider 到 processedArgs，确保 convertParams 能获取到
+        processedArgs.agentType = agentType || '';
+        processedArgs.apiProvider = apiProvider || '';
+
         const mcpParams = convertParams('save_income', processedArgs);
         result = await callMcpHubWithLogging('addIncome', mcpParams, token, traceId, startTime, osInfo, agentType, apiProvider);
 
@@ -1524,12 +1599,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           result._templateHint = '请使用references/response-templates.md中的2.1标准成功模板渲染回复';
           result._templateVariables = {
             agentName: await getAgentName(),
+            类型: '收入',
             商品名: displayName,
-            商家: displayStore,
+            商家: displayStore || null,
             金额: displayAmount,
             分类: result.data?.categoryName || displayCategory,
-            日期: result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN'),
-            正能量祝福语: '入账顺利！💰'
+            日期: result.data?.date ? new Date(result.data.date).toLocaleString('zh-CN') : new Date().toLocaleString('zh-CN'),
+            正能量祝福语: '入账顺利！💰',
+            timeNote: timeNote || null
           };
         }
         break;
@@ -1659,7 +1736,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       content: [
         {
           type: 'text',
-          text: `⚠️ 【注意】Server 只返回原始数据，不返回格式化消息。\n请使用 _templateLocation 指定的模板自行渲染回复。\n\n---\n📦 柴米记账 MCP v${MCP_VERSION}\n\n## 完整数据\n\`\`\`json\n${safeStringify(responseData)}\n\`\`\``,
+          text: `⚠️ 【注意】Server 只返回原始数据，不返回格式化消息。\n请使用 _templateLocation 指定的模板自行渲染回复。\n\n---\n📦 柴米AI记账 MCP v${MCP_VERSION}\n\n## 完整数据\n\`\`\`json\n${safeStringify(responseData)}\n\`\`\``,
         },
       ],
     };
@@ -1855,13 +1932,7 @@ function formatDateWithTimezone(dateInput) {
       timestamp = parseInt(dateInput, 10);
     }
 
-    // 检测是否是假的时间戳（秒级转毫秒级，结尾是000）
-    if (timestamp && timestamp % 1000 === 0 && String(timestamp).length === 13) {
-      console.error(`⚠️ 警告：检测到可能错误的时间戳（秒级转毫秒级）：${timestamp}，使用当前时间替代`);
-      return Date.now();
-    }
-
-    // 如果是数字时间戳且没问题，直接返回
+    // 如果是数字时间戳，直接返回
     if (timestamp) {
       return timestamp;
     }
@@ -1899,6 +1970,89 @@ function formatDateWithTimezone(dateInput) {
   }
 }
 
+/**
+ * 解析时间描述为时间戳
+ * @param {string} timeDesc - 时间描述（如 'yesterday', 'today'）
+ * @param {number} currentTimestamp - 当前时间戳
+ * @returns {number} 时间戳
+ */
+function parseTimeDescription(timeDesc, currentTimestamp) {
+  const now = new Date(currentTimestamp);
+  const year = now.getFullYear();
+  const month = now.getMonth();
+  const day = now.getDate();
+  
+  switch(timeDesc) {
+    case 'just_now':
+    case 'today':
+      return currentTimestamp;
+      
+    case 'yesterday':
+      return new Date(year, month, day - 1, 12, 0, 0).getTime();
+      
+    case 'yesterday_evening':
+      return new Date(year, month, day - 1, 19, 0, 0).getTime();
+      
+    case 'this_morning':
+      return new Date(year, month, day, 8, 0, 0).getTime();
+      
+    case 'this_noon':
+      return new Date(year, month, day, 12, 0, 0).getTime();
+      
+    case 'this_afternoon':
+      return new Date(year, month, day, 14, 0, 0).getTime();
+      
+    case 'this_evening':
+      return new Date(year, month, day, 19, 0, 0).getTime();
+      
+    default:
+      // 尝试解析具体日期格式：2026-03-15 或 2026-03-15T15:00
+      if (/^\d{4}-\d{2}-\d{2}$/.test(timeDesc)) {
+        const [y, m, d] = timeDesc.split('-').map(Number);
+        return new Date(y, m - 1, d, 12, 0, 0).getTime();
+      }
+      
+      if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/.test(timeDesc)) {
+        return new Date(timeDesc).getTime();
+      }
+      
+      // 兜底：返回当前时间
+      return currentTimestamp;
+  }
+}
+
+/**
+ * 获取时间说明文本
+ * @param {string} timeDesc - 时间描述
+ * @returns {string} 时间说明
+ */
+function getTimeNote(timeDesc) {
+  const descMap = {
+    'just_now': '刚刚',
+    'today': '今天',
+    'yesterday': '昨天',
+    'yesterday_evening': '昨晚',
+    'this_morning': '今早',
+    'this_noon': '今天中午',
+    'this_afternoon': '今天下午',
+    'this_evening': '今晚'
+  };
+  
+  if (descMap[timeDesc]) {
+    return `⏰ 时间说明：系统使用"${descMap[timeDesc]}"作为默认时间`;
+  }
+  
+  if (timeDesc && timeDesc.match(/^\d{4}-\d{2}-\d{2}$/)) {
+    return `⏰ 时间说明：记录日期为 ${timeDesc}`;
+  }
+  
+  if (timeDesc && timeDesc.match(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/)) {
+    return `⏰ 时间说明：记录精确时间为 ${timeDesc}`;
+  }
+  
+  return '';
+}
+
 function extractWeightInGrams(weightStr) {
   if (!weightStr || typeof weightStr !== 'string') return 0;
   

package/utils/config.js

@@ -0,0 +1,229 @@
+/**
+ * 柴米记账 MCP 配置管理工具
+ * 统一管理配置文件存储路径，支持从旧路径迁移
+ * 
+ * 存储位置：~/.chaimi-keep/
+ * 旧位置：~/.mcporter/（兼容迁移）
+ */
+
+const path = require('path');
+const os = require('os');
+const fs = require('fs').promises;
+
+// 配置目录名称
+const CONFIG_DIR_NAME = '.chaimi-keep';
+const LEGACY_DIR_NAME = '.mcporter';
+
+class ConfigManager {
+  constructor() {
+    this.configDir = path.join(os.homedir(), CONFIG_DIR_NAME);
+    this.legacyDir = path.join(os.homedir(), LEGACY_DIR_NAME);
+    this.migrationChecked = false;
+  }
+
+  /**
+   * 获取配置文件路径
+   * @param {string} filename - 文件名
+   * @returns {string} 完整路径
+   */
+  getPath(filename) {
+    return path.join(this.configDir, filename);
+  }
+
+  /**
+   * 获取旧配置文件路径
+   * @param {string} filename - 文件名
+   * @returns {string} 完整路径
+   */
+  getLegacyPath(filename) {
+    return path.join(this.legacyDir, filename);
+  }
+
+  /**
+   * 确保配置目录存在，并设置正确权限
+   */
+  async ensureDir() {
+    try {
+      await fs.mkdir(this.configDir, { recursive: true });
+      // 设置目录权限 0700（仅用户可读写执行）
+      await fs.chmod(this.configDir, 0o700);
+    } catch (err) {
+      // 如果权限设置失败，继续执行
+      if (err.code !== 'EEXIST') {
+        console.error('创建配置目录失败:', err.message);
+      }
+    }
+  }
+
+  /**
+   * 检查文件是否存在于新位置
+   * @param {string} filename - 文件名
+   * @returns {boolean}
+   */
+  async exists(filename) {
+    try {
+      await fs.access(this.getPath(filename));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 检查文件是否存在于旧位置
+   * @param {string} filename - 文件名
+   * @returns {boolean}
+   */
+  async existsInLegacy(filename) {
+    try {
+      await fs.access(this.getLegacyPath(filename));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 从旧位置迁移文件到新位置
+   * @param {string} filename - 文件名
+   * @returns {boolean} 是否成功迁移
+   */
+  async migrateFile(filename) {
+    const legacyPath = this.getLegacyPath(filename);
+    const newPath = this.getPath(filename);
+
+    try {
+      // 检查旧文件是否存在
+      await fs.access(legacyPath);
+      
+      // 确保新目录存在
+      await this.ensureDir();
+      
+      // 读取旧文件
+      const data = await fs.readFile(legacyPath, 'utf8');
+      
+      // 写入新位置，设置权限 0600
+      await fs.writeFile(newPath, data, { mode: 0o600 });
+      
+      // 删除旧文件
+      await fs.unlink(legacyPath);
+      
+      console.error(`✅ 已迁移 ${filename} 到新位置`);
+      return true;
+    } catch (err) {
+      if (err.code !== 'ENOENT') {
+        console.error(`迁移 ${filename} 失败:`, err.message);
+      }
+      return false;
+    }
+  }
+
+  /**
+   * 读取配置文件（自动处理迁移）
+   * @param {string} filename - 文件名
+   * @returns {any} 文件内容（JSON 解析后）或 null
+   */
+  async read(filename) {
+    // 确保目录存在
+    await this.ensureDir();
+
+    // 优先从新位置读取
+    const newPath = this.getPath(filename);
+    try {
+      const data = await fs.readFile(newPath, 'utf8');
+      return JSON.parse(data);
+    } catch (err) {
+      if (err.code !== 'ENOENT') {
+        console.error(`读取 ${filename} 失败:`, err.message);
+      }
+    }
+
+    // 新位置不存在，尝试从旧位置迁移
+    const migrated = await this.migrateFile(filename);
+    if (migrated) {
+      try {
+        const data = await fs.readFile(newPath, 'utf8');
+        return JSON.parse(data);
+      } catch (err) {
+        console.error(`读取迁移后的 ${filename} 失败:`, err.message);
+      }
+    }
+
+    return null;
+  }
+
+  /**
+   * 写入配置文件
+   * @param {string} filename - 文件名
+   * @param {any} data - 数据（会被 JSON 序列化）
+   * @param {boolean} isSensitive - 是否为敏感文件（设置 0600 权限）
+   */
+  async write(filename, data, isSensitive = true) {
+    await this.ensureDir();
+    const filePath = this.getPath(filename);
+    
+    const options = isSensitive ? { mode: 0o600 } : {};
+    await fs.writeFile(filePath, JSON.stringify(data, null, 2), options);
+  }
+
+  /**
+   * 删除配置文件
+   * @param {string} filename - 文件名
+   */
+  async delete(filename) {
+    const filePath = this.getPath(filename);
+    try {
+      await fs.unlink(filePath);
+    } catch (err) {
+      if (err.code !== 'ENOENT') {
+        throw err;
+      }
+    }
+  }
+
+  /**
+   * 删除旧位置的文件（清理用）
+   * @param {string} filename - 文件名
+   */
+  async deleteLegacy(filename) {
+    const legacyPath = this.getLegacyPath(filename);
+    try {
+      await fs.unlink(legacyPath);
+    } catch (err) {
+      // 忽略不存在的错误
+    }
+  }
+
+  /**
+   * 获取所有相关文件的路径信息
+   * @returns {Object} 路径映射
+   */
+  getPaths() {
+    const files = [
+      'oauth-token.json',
+      'auth-state.json',
+      'agent-name.json',
+      'device-code.json',
+      'machine-id'
+    ];
+
+    const result = {};
+    for (const file of files) {
+      result[file] = {
+        new: this.getPath(file),
+        legacy: this.getLegacyPath(file)
+      };
+    }
+    return result;
+  }
+}
+
+// 导出单例实例
+const configManager = new ConfigManager();
+
+module.exports = {
+  ConfigManager,
+  configManager,
+  CONFIG_DIR_NAME,
+  LEGACY_DIR_NAME
+};

package/utils/machine-id.js

@@ -2,7 +2,7 @@
  * 机器ID和设备指纹管理模块
  * 
  * 功能：
- * 1. 生成并管理机器唯一ID（存储在 ~/.mcporter/machine-id）
+ * 1. 生成并管理机器唯一ID（存储在 ~/.chaimi-keep/machine-id）
  * 2. 生成设备指纹（hash(machineId + agentType)）
  * 
  * 特点：
@@ -16,9 +16,16 @@ const path = require('path');
 const os = require('os');
 const crypto = require('crypto');
 
-// 机器ID文件路径
+// 机器ID文件路径（新位置 ~/.chaimi-keep/）
 const MACHINE_ID_FILE = path.join(
-  process.env.HOME || process.env.USERPROFILE,
+  os.homedir(),
+  '.chaimi-keep',
+  'machine-id'
+);
+
+// 旧机器ID文件路径（用于迁移）
+const LEGACY_MACHINE_ID_FILE = path.join(
+  os.homedir(),
   '.mcporter',
   'machine-id'
 );