chaimi-keep-mcp 3.2.0 → 3.2.1-beta.1

package/README.md

@@ -148,6 +148,12 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v3.2.1-beta.0 (2026-04-26)
+- **新增** 设备指纹机制，防止同一设备重复授权
+  - 基于机器ID + Agent类型生成唯一设备指纹
+  - 同一设备重复授权时复用已有记录，避免生成多个agentName
+  - 支持设备指纹查重，自动识别已授权设备
+
 ### v3.1.49-beta.2 (2026-04-24)
 - **新增** period 参数支持
   - getStatistics: 支持 this_week/last_week/this_month/last_month 周期筛选

package/oauth.js

@@ -146,7 +146,7 @@ class OAuthManager {
     await execPromise(command);
   }
 
-  async requestDeviceCode(useUrlScheme = false) {
+  async requestDeviceCode(useUrlScheme = false, extraParams = {}) {
     const response = await fetch(this.mcpOAuthUrl, {
       method: 'POST',
       headers: {
@@ -156,7 +156,8 @@ class OAuthManager {
         tool: 'deviceCode',
         params: {
           clientId: 'chaihuo-mcp-client',
-          useUrlScheme: useUrlScheme
+          useUrlScheme: useUrlScheme,
+          ...extraParams
         }
       })
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.2.0",
+  "version": "3.2.1-beta.1",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {

package/references/response-templates-test.md

@@ -0,0 +1,243 @@
+---
+name: "chaimi-keep-response-templates-test"
+description: 记账回复模板测试方案 - 供Agent测试不同格式的显示效果
+version: "1.1.0"
+updated: "2026-04-26"
+---
+
+# 记账回复模板测试方案
+
+> 用于测试不同分隔符和排版在手机/PC端的显示效果
+
+---
+
+## 测试说明
+
+将以下各方案的模板复制到Agent的skill中使用，观察：
+1. 换行是否正常
+2. 分隔线显示效果
+3. 底部三行对齐效果
+4. 整体美观度
+
+---
+
+## 方案1：双分隔线短版（15字符）
+
+```
+✅ 「{agentName}」已帮您记账成功
+═══════════════
+💰 金额：¥{金额}
+═══════════════
+
+📦 商品：{商品名}
+🏷️ 分类：{分类}
+🏪 商家：{商家}
+🕐 时间：{日期时间}
+
+───────────────
+🎉 {正能量祝福语}！
+  柴米AI记账
+  chaimi-keep-mcp v{版本号}
+───────────────
+```
+
+**填充示例：**
+```
+✅ 「你的小可爱」已帮您记账成功
+═══════════════
+💰 金额：¥35.00
+═══════════════
+
+📦 商品：午餐
+🏷️ 分类：餐饮
+🏪 商家：麦当劳
+🕐 时间：2026-04-24 12:30
+
+───────────────
+🎉 美食为梦想充电，继续向前冲！🍚
+  柴米AI记账
+  chaimi-keep-mcp v3.2.0
+───────────────
+```
+
+---
+
+## 方案2：单分隔线极简版
+
+```
+✅ 「{agentName}」已帮您记账成功
+
+💰 金额：¥{金额}
+
+📦 商品：{商品名}
+🏷️ 分类：{分类}
+🏪 商家：{商家}
+🕐 时间：{日期时间}
+
+---
+🎉 {正能量祝福语}！
+  柴米AI记账
+  chaimi-keep-mcp v{版本号}
+```
+
+**填充示例：**
+```
+✅ 「你的小可爱」已帮您记账成功
+
+💰 金额：¥35.00
+
+📦 商品：午餐
+🏷️ 分类：餐饮
+🏪 商家：麦当劳
+🕐 时间：2026-04-24 12:30
+
+---
+🎉 美食为梦想充电，继续向前冲！🍚
+  柴米AI记账
+  chaimi-keep-mcp v3.2.0
+```
+
+---
+
+## 方案3：信息紧凑单行版（已优化）
+
+```
+✅ 「{agentName}」已帮您记账成功 💰¥{金额}
+
+📦{商品名} · 🏷️{分类} · 🏪{商家} · 🕐{日期时间}
+
+═══════════════
+🎉 {正能量祝福语}！
+  柴米AI记账
+  chaimi-keep-mcp v{版本号}
+═══════════════
+```
+
+**填充示例：**
+```
+✅ 「你的小可爱」已帮您记账成功 💰¥35.00
+
+📦午餐 · 🏷️餐饮 · 🏪麦当劳 · 🕐12:30
+
+═══════════════
+🎉 祝您用餐愉快！
+  柴米AI记账
+  chaimi-keep-mcp v3.2.0
+═══════════════
+```
+
+---
+
+## 测试记录表
+
+| 方案 | 手机端效果 | PC端效果 | 推荐场景 |
+|:-----|:-----------|:---------|:---------|
+| 方案1：双分隔线短版 | 待测试 | 待测试 | 默认推荐 |
+| 方案2：单分隔线极简版 | 待测试 | 待测试 | 快速记账 |
+| 方案3：信息紧凑单行版 | 待测试 | 待测试 | 空间受限 |
+
+---
+
+## 关键检查点
+
+### 1. 分隔线显示
+- [ ] 方案1/5的 `═` 符号是否正常显示
+- [ ] 方案2的 `---` 是否被识别为分隔线
+
+### 2. 底部对齐
+- [ ] 底部三行文字是否左对齐（🎉 不占对齐位）
+- [ ] "祝"、"柴"、"c" 三字符是否在同一列
+
+### 3. 换行效果
+- [ ] 空行是否被正确保留
+- [ ] 信息项之间是否有适当间距
+
+### 4. Emoji显示
+- [ ] ✅ 💰 📦 🏷️ 🏪 🕐 🎉 是否正常显示
+- [ ] 是否有乱码或方框
+
+### 5. 方案5特殊检查
+- [ ] 单行信息是否可读
+- [ ] 分隔符 `·` 是否正常显示
+
+---
+
+## 正能量情绪词库
+
+根据消费分类自动匹配正能量结束语：
+
+### 餐饮类
+| 场景 | 结束语 |
+|:-----|:-------|
+| 早餐 | 早餐吃得香，元气满满迎朝阳！☀️ |
+| 午餐 | 美食为梦想充电，继续向前冲！🍚 |
+| 晚餐 | 晚餐后放松身心，明天更精彩！🌙 |
+| 零食 | 生活要有仪式感，小确幸也是幸福！😋 |
+| 外卖 | 再忙也要爱自己，好好吃饭！💕 |
+| 聚餐 | 朋友相聚是福气，友谊地久天长！🎉 |
+| 咖啡 | 一杯咖啡提神醒脑，效率倍增！☕ |
+| 奶茶 | 甜蜜相伴，工作生活都精彩！🧋 |
+
+### 交通类
+| 场景 | 结束语 |
+|:-----|:-------|
+| 地铁 | 城市动脉连接梦想，未来可期！🚇 |
+| 打车 | 一路顺风，事事顺心！🚗 |
+| 加油 | 加满油向梦想出发，勇往直前！⛽ |
+| 停车 | 车位到手，好运相伴！🅿️ |
+| 公交 | 绿色出行低碳环保，为地球助力！🚌 |
+| 高铁 | 速度与梦想同行，前程似锦！🚄 |
+
+### 购物类
+| 场景 | 结束语 |
+|:-----|:-------|
+| 日用品 | 精明消费品质生活，越买越聪明！✨ |
+| 服装 | 新衣新气象，自信每一天！👗 |
+| 电子产品 | 科技赋能，效率翻倍！💻 |
+| 超市 | 满载而归，生活美满！🛒 |
+| 网购 | 好物即将到家，期待美好！📦 |
+| 美妆 | 美丽自信，由内而外散发光彩！💄 |
+
+### 居住类
+| 场景 | 结束语 |
+|:-----|:-------|
+| 房租 | 投资未来，房子是温馨的港湾！🏠 |
+| 水电 | 节约环保，绿色生活从我做起！💡 |
+| 物业 | 安心居住，幸福生活有保障！🏢 |
+| 装修 | 亲手打造温馨小窝，成就感满满！🔨 |
+| 家具 | 新家具新生活，每一天都舒心！🛋️ |
+
+### 娱乐类
+| 场景 | 结束语 |
+|:-----|:-------|
+| 电影 | 光影世界丰富心灵，生活更精彩！🎬 |
+| 游戏 | 适度娱乐放松身心，工作生活两不误！🎮 |
+| 旅游 | 读万卷书行万里路，拓宽人生视野！✈️ |
+| 健身 | 投资健康是最大的财富，活力满满！💪 |
+| 书籍 | 知识改变命运，智慧点亮人生！📚 |
+
+### 收入类
+| 场景 | 结束语 |
+|:-----|:-------|
+| 工资 | 劳动创造价值，努力终有回报！🎉 |
+| 奖金 | 努力被看见，未来更辉煌！💪 |
+| 兼职 | 多元化发展，人生更多精彩！✨ |
+| 理财 | 钱生钱利滚利，财富自由更进一步！📈 |
+| 红包 | 好运连连，福气满满！🧧 |
+
+### 通用类
+| 情绪 | 结束语 |
+|:-----|:-------|
+| 鼓励 | 今天的你特别棒，继续发光发热！👍 |
+| 温暖 | 记录生活点滴，美好永留存！📝 |
+| 正能量 | 每一笔记录都是对生活的热爱！💕 |
+| 轻松 | 记账完成，又是充实的一天！✨ |
+| 感恩 | 感恩生活，感恩有你！🙏 |
+| 期待 | 未来可期，一起加油！🌟 |
+
+---
+
+**测试完成后的最佳方案将更新到 response-templates.md 正式文档中**
+
+文档版本：v1.2.0
+最后更新：2026-04-26

package/references/response-templates.md

@@ -75,8 +75,8 @@ updated: "2026-04-25"
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━
 🎉 {情绪祝福语}！
-   柴米AI记账
-   chaimi-keep-mcp v{版本号}
+柴米AI记账
+chaimi-keep-mcp v{版本号}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -95,8 +95,8 @@ updated: "2026-04-25"
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━
 🎉 祝您用餐愉快！
-   柴米AI记账
-   chaimi-keep-mcp v3.2.0
+柴米AI记账
+chaimi-keep-mcp v3.2.0
 ━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 

package/server.js

@@ -33,6 +33,9 @@ const { OAuthManager, FileTokenStorage } = require('./oauth.js');
 // 导入校验工具
 const { validateDate } = require('./utils/validators.js');
 
+// 导入设备指纹模块
+const { getDeviceFingerprint, getAgentType, saveAgentType, getMacAddresses } = require('./utils/machine-id.js');
+
 // API 签名密钥（用于验证请求来自合法 MCP Server）
 const CHAIMI_API_SECRET = 'chaimi-mcp-secret-2024';
 
@@ -487,6 +490,7 @@ async function getToken() {
             authState.isAuthorized = true;
             await oauthManager.tokenStorage.save(token);
             // 【新增】保存默认 Agent 名称和 deviceCode
+            // 【修复】使用实际授权的 deviceCode
             await oauthManager.tokenStorage.saveAgentName('柴米AI助手');
             await oauthManager.tokenStorage.saveDeviceCode(savedAuthState.deviceCode);
             await oauthManager.clearAuthState();
@@ -976,7 +980,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           // 按 SKILL 规范格式：新的回复模板
           const displayStoreText = displayStore ? `【${displayStore}】` : '';
           const dateStr = result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN');
-          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n    · 商品/店名：${displayName}${displayStoreText} 💰¥${displayAmount}\n    · 收支类型： 支出\n    · 分类：${result.data?.categoryName || displayCategory}\n    · 时间：${dateStr}\n✅ ${friendlyEnding}${insightsText}${achievementsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
+          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n\n商品：${displayName}${displayStoreText}\n金额：¥${displayAmount}\n类型：支出\n分类：${result.data?.categoryName || displayCategory}\n时间：${dateStr}\n\n${friendlyEnding}${insightsText}${achievementsText}\n\n---\n柴米AI记账 v${MCP_VERSION}`;
           
           if (!processedArgs.agentType || !processedArgs.apiProvider) {
             userMessage += '\n\n💡 提示：传递agentType和apiProvider参数可解锁小程序记录来源统计功能，示例：agentType="openclaw", apiProvider="doubao"';
@@ -1220,7 +1224,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           
           // 按 SKILL 规范格式：新的回复模板
           const dateStr = result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN');
-          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n    · 商品/店名：${storeName} 💰¥${totalAmount}\n    · 收支类型： 支出\n    · 分类：${result.data?.storeCategory || category}\n    · 商品数量：${itemCount}件\n    · 时间：${dateStr}\n✅ ${friendlyEnding}${insightsText}${achievementsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
+          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n\n店名：${storeName}\n金额：¥${totalAmount}\n类型：支出\n分类：${result.data?.storeCategory || category}\n商品：${itemCount}件\n时间：${dateStr}\n\n${friendlyEnding}${insightsText}${achievementsText}\n\n---\n柴米AI记账 v${MCP_VERSION}`;
           
           if (!processedArgs.agentType || !processedArgs.apiProvider) {
             userMessage += '\n\n💡 提示：传递agentType和apiProvider参数可解锁小程序记录来源统计功能，示例：agentType="openclaw", apiProvider="doubao"';
@@ -1450,7 +1454,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           
           // 按 SKILL 规范格式：新的回复模板
           const dateStr = result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN');
-          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n    · 商品/店名：${displayName}${displayStoreText} 💰¥${displayAmount}\n    · 收支类型： 收入\n    · 分类：${result.data?.categoryName || displayCategory}\n    · 时间：${dateStr}\n✅ 入账顺利！💰\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
+          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n\n商品：${displayName}${displayStoreText}\n金额：¥${displayAmount}\n类型：收入\n分类：${result.data?.categoryName || displayCategory}\n时间：${dateStr}\n\n入账顺利！💰\n\n---\n柴米AI记账 v${MCP_VERSION}`;
         }
         break;
       }
@@ -2111,8 +2115,28 @@ async function startAuthFlow() {
       }
     }
 
-    // 获取新的设备码
-    const deviceCodeRes = await oauthManager.requestDeviceCode(false);
+    // 【新增】获取或设置Agent类型
+    let agentType = await getAgentType();
+    if (!agentType) {
+      // 首次使用，尝试从记账参数中获取，或使用默认值
+      agentType = process.env.AGENT_TYPE || 'unknown';
+      await saveAgentType(agentType);
+      console.error(`[Auth] 首次使用，设置Agent类型: ${agentType}`);
+    }
+
+    // 【新增】生成设备指纹
+    const deviceFingerprint = await getDeviceFingerprint(agentType);
+    const macAddresses = await getMacAddresses();
+    console.error(`[Auth] 设备指纹: ${deviceFingerprint}`);
+    console.error(`[Auth] MAC地址: ${macAddresses.join(', ') || 'unknown'}`);
+
+    // 获取新的设备码（带上设备指纹）
+    const deviceCodeRes = await oauthManager.requestDeviceCode(false, {
+      deviceFingerprint,
+      agentType,
+      macAddress: macAddresses[0] || 'unknown'
+    });
+    
     authState.deviceCode = deviceCodeRes.deviceCode;
     authState.userCode = deviceCodeRes.userCode;
     authState.isWaiting = true;
@@ -2163,8 +2187,9 @@ async function pollForAuthInBackground(deviceCode, interval) {
         await oauthManager.tokenStorage.save(token);
         
         // 【新增】保存默认 Agent 名称和 deviceCode（首次记账时会获取真实名称）
+        // 【修复】使用传入的 deviceCode，而不是 authState.deviceCode（可能不一致）
         await oauthManager.tokenStorage.saveAgentName('柴米AI助手');
-        await oauthManager.tokenStorage.saveDeviceCode(authState.deviceCode);
+        await oauthManager.tokenStorage.saveDeviceCode(deviceCode);
         
         // 清除授权状态
         await oauthManager.clearAuthState();

package/utils/machine-id.js

@@ -0,0 +1,165 @@
+/**
+ * 机器ID和设备指纹管理模块
+ * 
+ * 功能：
+ * 1. 生成并管理机器唯一ID（存储在 ~/.mcporter/machine-id）
+ * 2. 生成设备指纹（hash(machineId + agentType)）
+ * 
+ * 特点：
+ * - 首次运行时生成机器ID，后续复用
+ * - 网卡切换不影响（所有MAC参与计算）
+ * - 重装系统会重新生成（视为新设备）
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+
+// 机器ID文件路径
+const MACHINE_ID_FILE = path.join(
+  process.env.HOME || process.env.USERPROFILE,
+  '.mcporter',
+  'machine-id'
+);
+
+// Agent类型文件路径
+const AGENT_TYPE_FILE = path.join(
+  process.env.HOME || process.env.USERPROFILE,
+  '.mcporter',
+  'agent-type.json'
+);
+
+/**
+ * 获取或生成机器ID
+ * @returns {Promise<string>} 16位机器ID
+ */
+async function getMachineId() {
+  try {
+    // 1. 尝试读取已有ID
+    const existing = await fs.readFile(MACHINE_ID_FILE, 'utf8');
+    if (existing.trim()) {
+      console.error('[MachineId] 使用已有机器ID:', existing.trim());
+      return existing.trim();
+    }
+  } catch (err) {
+    // 文件不存在，继续生成
+    console.error('[MachineId] 首次使用，生成新机器ID');
+  }
+
+  // 2. 生成新ID
+  const networkInterfaces = os.networkInterfaces();
+  const macAddresses = [];
+
+  for (const name in networkInterfaces) {
+    for (const iface of networkInterfaces[name]) {
+      if (!iface.internal && iface.mac && iface.mac !== '00:00:00:00:00:00') {
+        macAddresses.push(iface.mac);
+      }
+    }
+  }
+
+  // 排序后合并（避免网卡顺序影响）
+  macAddresses.sort();
+  const machineId = crypto
+    .createHash('sha256')
+    .update(macAddresses.join(':') + os.hostname())
+    .digest('hex')
+    .substring(0, 16);
+
+  console.error('[MachineId] 生成新机器ID:', machineId);
+
+  // 3. 保存到文件
+  try {
+    await fs.mkdir(path.dirname(MACHINE_ID_FILE), { recursive: true });
+    await fs.writeFile(MACHINE_ID_FILE, machineId, { mode: 0o600 });
+    console.error('[MachineId] 机器ID已保存到:', MACHINE_ID_FILE);
+  } catch (err) {
+    console.error('[MachineId] 保存机器ID失败:', err.message);
+  }
+
+  return machineId;
+}
+
+/**
+ * 获取设备指纹
+ * @param {string} agentType - Agent类型（claude/cursor等）
+ * @returns {Promise<string>} 16位设备指纹
+ */
+async function getDeviceFingerprint(agentType) {
+  const machineId = await getMachineId();
+  const fingerprint = crypto
+    .createHash('sha256')
+    .update(`${machineId}:${agentType}`)
+    .digest('hex')
+    .substring(0, 16);
+
+  console.error('[MachineId] 设备指纹:', fingerprint, '(agentType:', agentType + ')');
+  return fingerprint;
+}
+
+/**
+ * 获取Agent类型
+ * @returns {Promise<string|null>} Agent类型，首次返回null
+ */
+async function getAgentType() {
+  try {
+    const data = await fs.readFile(AGENT_TYPE_FILE, 'utf8');
+    const parsed = JSON.parse(data);
+    if (parsed.agentType) {
+      console.error('[MachineId] 使用已有Agent类型:', parsed.agentType);
+      return parsed.agentType;
+    }
+  } catch (err) {
+    console.error('[MachineId] 首次使用，需要设置Agent类型');
+  }
+  return null;
+}
+
+/**
+ * 保存Agent类型
+ * @param {string} agentType - Agent类型
+ */
+async function saveAgentType(agentType) {
+  try {
+    await fs.mkdir(path.dirname(AGENT_TYPE_FILE), { recursive: true });
+    await fs.writeFile(
+      AGENT_TYPE_FILE,
+      JSON.stringify({
+        agentType,
+        updatedAt: new Date().toISOString()
+      }),
+      { mode: 0o600 }
+    );
+    console.error('[MachineId] Agent类型已保存:', agentType);
+  } catch (err) {
+    console.error('[MachineId] 保存Agent类型失败:', err.message);
+  }
+}
+
+/**
+ * 获取MAC地址列表（用于调试）
+ * @returns {Promise<string[]>} MAC地址列表
+ */
+async function getMacAddresses() {
+  const networkInterfaces = os.networkInterfaces();
+  const macAddresses = [];
+
+  for (const name in networkInterfaces) {
+    for (const iface of networkInterfaces[name]) {
+      if (!iface.internal && iface.mac && iface.mac !== '00:00:00:00:00:00') {
+        macAddresses.push(iface.mac);
+      }
+    }
+  }
+
+  return macAddresses.sort();
+}
+
+module.exports = {
+  getMachineId,
+  getDeviceFingerprint,
+  getAgentType,
+  saveAgentType,
+  getMacAddresses
+};