chaimi-keep-mcp 3.3.3-beta.7 → 3.3.3-beta.9

package/README.md

@@ -89,6 +89,10 @@ 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 仅异常时显示

package/SKILL.md

@@ -154,6 +154,12 @@ chaimi-keep-mcp ⭐ 本Skill
 - ✅ 返回 `_templateHint` 提示使用哪个模板
 - ✅ 返回 `_templateVariables` 提供模板变量数据
 
+**回复简洁原则（重要）**：
+- ❌ **不要输出记账过程** - 不要告诉用户"第1步确认信息、第2步解析时间..."等流程细节
+- ❌ **不要刷屏** - 记账是高频操作，简洁回复是对用户的尊重
+- ✅ **只输出最终结果** - 直接使用模板渲染记账成功信息
+- ✅ **除非用户要求** - 仅当用户主动询问"你是怎么记账的"时才说明流程
+
 **空值处理原则**：
 - 模板变量中，如果某个维度的值为空（null/undefined/空字符串），Agent 应跳过该行不显示
 - 必填字段（金额、类型、商品、分类）必须显示
@@ -180,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层视觉结构
@@ -214,24 +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
 ───────────────
 ```
 

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.7",
+  "version": "3.3.3-beta.9",
   "description": "柴米AI记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {

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记账授权流程
@@ -134,12 +134,12 @@ mcporter auth 柴米AI记账 --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,7 +157,7 @@ del %USERPROFILE%\.mcporter\oauth-token.json
 
 ```bash
 # 查看 Token 文件是否存在
-cat ~/.mcporter/oauth-token.json
+cat ~/.chaimi-keep/oauth-token.json
 
 # 或尝试调用工具测试
 mcporter call 柴米AI记账.get_skill
@@ -165,7 +165,7 @@ mcporter call 柴米AI记账.get_skill
 
 **Token 文件位置：**
 ```
-~/.mcporter/oauth-token.json
+~/.chaimi-keep/oauth-token.json
 ```
 
 ### 3.2 Token刷新

package/server.js

@@ -39,6 +39,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 +170,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,
@@ -1000,11 +1003,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
         
         // 【新增】处理 time_description（文本记账新时间格式）
-        let timeNote = '';
+        let timeNote = null;
         if (processedArgs.time_description) {
           const parsedDate = parseTimeDescription(processedArgs.time_description, Date.now());
           processedArgs.date = parsedDate;
-          timeNote = getTimeNote(processedArgs.time_description);
+          // 正常解析时不显示 timeNote，只有兜底或异常时才显示
           console.log(`[save_expense] 时间描述解析: ${processedArgs.time_description} → ${parsedDate} (${new Date(parsedDate).toLocaleString('zh-CN')})`);
         }
         
@@ -1520,11 +1523,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
 
         // 【新增】处理 time_description（收入记账新时间格式）
-        let timeNote = '';
+        let timeNote = null;
         if (processedArgs.time_description) {
           const parsedDate = parseTimeDescription(processedArgs.time_description, Date.now());
           processedArgs.date = parsedDate;
-          timeNote = getTimeNote(processedArgs.time_description);
+          // 正常解析时不显示 timeNote，只有兜底或异常时才显示
           console.log(`[save_income] 时间描述解析: ${processedArgs.time_description} → ${parsedDate} (${new Date(parsedDate).toLocaleString('zh-CN')})`);
         }
         // 【新增】兜底：如果既没传 time_description 也没传 date，使用当前时间

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'
 );