ibill-ai-ledger 1.0.0

package/executa.json

@@ -0,0 +1,15 @@
+{
+  "slug": "ai-ledger",
+  "name": "iBill · AI 记账本",
+  "version": "1.0.0",
+  "executa_type": "tool",
+  "description": "iBill · AI 记账本的本地执行插件：自然语言/语音记账解析、收支记录存储、月度统计与预算管理。Anna Executa stdio JSON-RPC plugin (Node.js, zero dependencies).",
+  "tool_id": "tool-dev-ai-ledger",
+  "type": "node",
+  "enabled": true,
+  "distribution": {
+    "type": "npm",
+    "package_name": "ibill-ai-ledger",
+    "executable_name": "ibill-ai-ledger"
+  }
+}

package/lib/ledger-core.mjs

@@ -0,0 +1,414 @@
+/**
+ * ledger-core.js — 记账领域共享核心（ESM 纯函数，零依赖）
+ * 同时被 Node Executa 插件（动态 import）与 UI（Vite/ESM）使用。
+ * 金额内部一律用「分」(integer cents) 存储，避免浮点误差。
+ */
+
+// ---------------------------------------------------------------------------
+// 分类定义（id / 中文名 / 英文名 / emoji / 规则关键词）
+  // ---------------------------------------------------------------------------
+  const EXPENSE_CATEGORIES = [
+    { id: "food", zh: "餐饮", en: "Food", emoji: "🍜",
+      keywords: ["吃", "饭", "餐", "顿", "火锅", "烧烤", "奶茶", "咖啡", "早餐", "午餐", "晚餐", "夜宵",
+        "零食", "水果", "外卖", "面", "米线", "肯德基", "麦当劳", "星巴克", "饮料", "啤酒", "聚餐",
+        "包子", "饺子", "米饭", "便当", "团购餐", "小吃", "宵夜", "粥", "馍", "饼"] },
+    { id: "transport", zh: "交通", en: "Transport", emoji: "🚕",
+      keywords: ["打车", "滴滴", "出租", "地铁", "公交", "加油", "停车", "高铁", "火车", "机票",
+        "飞机", "车票", "单车", "骑行", "高速", "过路", "油费", "车费", "顺风车", "大巴", "轮渡"] },
+    { id: "shopping", zh: "购物", en: "Shopping", emoji: "🛍️",
+      keywords: ["淘宝", "京东", "拼多多", "衣服", "鞋", "包", "购物", "网购", "快递", "超市",
+        "化妆品", "护肤", "数码", "电子", "家电", "日用品", "商城", "奥莱", "饰品"] },
+    { id: "housing", zh: "居家", en: "Housing", emoji: "🏠",
+      keywords: ["房租", "水电", "电费", "水费", "燃气", "煤气", "物业", "网费", "家具", "家居",
+        "日用", "维修", "租金", "暖气", "宽带"] },
+    { id: "entertainment", zh: "娱乐", en: "Fun", emoji: "🎮",
+      keywords: ["电影", "游戏", "ktv", "唱歌", "演出", "门票", "会员", "视频", "小说", "酒吧",
+        "游乐", "剧本杀", "密室", "直播", "订阅", "动漫", "展览"] },
+    { id: "health", zh: "医疗", en: "Health", emoji: "💊",
+      keywords: ["医院", "药", "体检", "挂号", "看病", "牙医", "诊所", "医保", "手术", "感冒",
+        "输液", "检查"] },
+    { id: "education", zh: "教育", en: "Education", emoji: "📚",
+      keywords: ["书", "课程", "学费", "培训", "考试", "文具", "教育", "网课", "教材", "辅导班"] },
+    { id: "communication", zh: "通讯", en: "Comm", emoji: "📱",
+      keywords: ["话费", "流量", "充值", "手机费", "电话", "sim"] },
+    { id: "travel", zh: "旅行", en: "Travel", emoji: "✈️",
+      keywords: ["酒店", "民宿", "旅行", "旅游", "签证", "度假", "景区", "机票"] },
+    { id: "gifts", zh: "人情", en: "Gifts", emoji: "🎁",
+      keywords: ["发红包", "随礼", "份子", "礼物", "送礼", "捐款", "红包", "请客", "孝敬"] },
+    { id: "other_exp", zh: "其他", en: "Other", emoji: "📦", keywords: [] },
+  ];
+
+  const INCOME_CATEGORIES = [
+    { id: "salary", zh: "工资", en: "Salary", emoji: "💰",
+      keywords: ["工资", "薪水", "发薪", "薪资", "绩效", "奖金"] },
+    { id: "freelance", zh: "兼职", en: "Freelance", emoji: "💻",
+      keywords: ["兼职", "外快", "稿费", "接单", "劳务费"] },
+    { id: "investment", zh: "理财", en: "Invest", emoji: "📈",
+      keywords: ["理财", "利息", "基金", "股票", "分红", "收益"] },
+    { id: "redpacket_in", zh: "红包", en: "Red Packet", emoji: "🧧",
+      keywords: ["抢红包", "收到红包", "红包到账"] },
+    { id: "refund", zh: "退款", en: "Refund", emoji: "↩️",
+      keywords: ["退款", "退货", "报销", "理赔"] },
+    { id: "other_inc", zh: "其他收入", en: "Other", emoji: "🪙", keywords: [] },
+  ];
+
+  const INCOME_HINTS = ["工资", "薪水", "发薪", "薪资", "赚", "收入", "报销", "收款", "收到",
+    "红包", "理财", "利息", "兼职", "外快", "退款", "中奖", "分红", "到账", "入账"];
+  // 强支出信号（用于区分「发红包」支出 vs「收到红包」收入）
+  const EXPENSE_HINTS = ["花", "买", "付", "支出", "消费", "掏", "缴", "交", "扣", "花了", "用了", "发红包"];
+
+  // ---------------------------------------------------------------------------
+  // 金额工具
+  // ---------------------------------------------------------------------------
+  function yuanToCents(yuan) {
+    const n = typeof yuan === "string" ? parseFloat(yuan) : yuan;
+    if (!isFinite(n) || n <= 0) return 0;
+    return Math.round(n * 100);
+  }
+  function centsToYuan(cents) {
+    return Math.round(cents) / 100;
+  }
+  function formatCents(cents) {
+    const yuan = centsToYuan(cents || 0);
+    return yuan.toLocaleString("zh-CN", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+  }
+
+  // ---------------------------------------------------------------------------
+  // 日期工具
+  // ---------------------------------------------------------------------------
+  function pad2(n) { return String(n).padStart(2, "0"); }
+  function dateToStr(d) { return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`; }
+  function monthKeyOf(dateStr) { return (dateStr || "").slice(0, 7); }
+  function shiftDays(base, delta) {
+    const d = new Date(base.getFullYear(), base.getMonth(), base.getDate() + delta);
+    return d;
+  }
+  function todayStr(now) { return dateToStr(now || new Date()); }
+
+  const CN_NUM = { 零: 0, 〇: 0, 一: 1, 二: 2, 两: 2, 三: 3, 四: 4, 五: 5, 六: 6, 七: 7,
+    八: 8, 九: 9, 十: 10, 百: 100, 千: 1000, 万: 10000 };
+
+  /** 解析中文数字，支持 1~99999 的常见口语写法：三十五、一百二、三百五十六、两千三、一万二 */
+  function cnNumber(str) {
+    if (!str) return null;
+    if (!/[零〇一二两三四五六七八九十百千万]/.test(str)) return null;
+    // 省略位口语补全：「两千三」→两千三百、「一百二」→一百二十、「一万二」→一万二千
+    str = str.replace(/([百千万])([一二两三四五六七八九])$/, (m, u, d) =>
+      u + d + ({ 百: "十", 千: "百", 万: "千" }[u] || ""));
+    let total = 0, section = 0, num = 0, hasAny = false;
+    for (const ch of str) {
+      const v = CN_NUM[ch];
+      if (v === undefined) return null;
+      hasAny = true;
+      if (v === 10000) {
+        section = (section + num) * v;
+        total += section;
+        section = 0; num = 0;
+      } else if (v === 1000 || v === 100 || v === 10) {
+        if (num === 0) num = 1; // 一百 / 十
+        section += num * v;
+        num = 0;
+      } else {
+        num = v;
+      }
+    }
+    total += section + num;
+    return hasAny ? total : null;
+  }
+
+  // ---------------------------------------------------------------------------
+  // 规则解析（LLM 不可用时的降级，也是独立演示模式的解析器）
+  // 返回 { drafts: [{type, amountCents, categoryId, date, note, confidence}], engine }
+  // ---------------------------------------------------------------------------
+  function parseRules(rawText, now) {
+    const nowDate = now || new Date();
+    const text = String(rawText || "").trim();
+    if (!text) return { drafts: [], engine: "rules" };
+
+    // 先按标点/连接词切分：「午餐35，打车20」「买衣服399 还有咖啡28」
+    const rough = text
+      .split(/[，,、；;。]|然后|还有|另外|接着|再/)
+      .map((s) => s.trim())
+      .filter(Boolean);
+    // 再按「金额 token」切分无标点连写：「午餐35打车20」「早餐15咖啡28」
+    const segments = rough.flatMap(splitByAmounts);
+
+    const drafts = [];
+    for (const seg of segments) {
+      const draft = parseSegment(seg, nowDate);
+      if (draft && draft.amountCents > 0) drafts.push(draft);
+    }
+    // 切分后一笔都没解析出金额时，整句当一笔尝试
+    if (drafts.length === 0) {
+      const whole = parseSegment(text, nowDate);
+      if (whole && whole.amountCents > 0) drafts.push(whole);
+    }
+    return { drafts, engine: "rules" };
+  }
+
+  // 在一句话里找出所有「金额 token」的位置（用于多笔连写切分）
+  const QUANTIFIERS = "杯个瓶份盒斤条件位人次顿套箱袋包张台本支根片";
+  function findAmountTokens(seg) {
+    const mask = [];
+    const addMask = (re) => {
+      let m;
+      while ((m = re.exec(seg))) mask.push([m.index, m.index + m[0].length]);
+    };
+    addMask(/\d{1,2}\s*月\s*\d{1,2}\s*[号日]/g); // X月X号
+    addMask(/\d{4}\s*年/g);                       // 年份
+    const inMask = (i) => mask.some(([a, b]) => i >= a && i < b);
+
+    const tokens = [];
+    const push = (s, e, nextChar) => {
+      if (inMask(s)) return;
+      if (tokens.some((t) => s < t.e && e > t.s)) return; // 重叠去重
+      if (nextChar && QUANTIFIERS.includes(nextChar)) return; // 「2杯/3个」是数量不是金额
+      tokens.push({ s, e });
+    };
+    let m;
+    const reCompound = /(\d+)\s*块\s*(\d)(?:\s*[毛角分])?/g;   // 35块5 / 35块5毛
+    while ((m = reCompound.exec(seg))) {
+      push(m.index, m.index + m[0].length, seg[m.index + m[0].length]);
+    }
+    const reJiao = /(\d+(?:\.\d+)?)\s*[毛角]/g;
+    while ((m = reJiao.exec(seg))) {
+      push(m.index, m.index + m[0].length, seg[m.index + m[0].length]);
+    }
+    const reArabic = /(\d+(?:\.\d{1,2})?)\s*(?:块钱|元钱|块|元|钱|rmb|RMB|¥|￥)?/g;
+    while ((m = reArabic.exec(seg))) {
+      if (m[0].length === 0) { reArabic.lastIndex++; continue; }
+      push(m.index, m.index + m[0].length, seg[m.index + m[0].length]);
+    }
+    const reCn = /[零〇一二两三四五六七八九十百千]{1,12}\s*(?:块钱|元钱|块|元|钱)/g;
+    while ((m = reCn.exec(seg))) {
+      push(m.index, m.index + m[0].length, seg[m.index + m[0].length]);
+    }
+    tokens.sort((a, b) => a.s - b.s);
+    return tokens;
+  }
+
+  function splitByAmounts(seg) {
+    const tokens = findAmountTokens(seg);
+    if (tokens.length < 2) return [seg];
+    const parts = [];
+    let start = 0;
+    for (const tok of tokens) {
+      parts.push(seg.slice(start, tok.e).trim());
+      start = tok.e;
+    }
+    if (start < seg.length && parts.length > 0) {
+      parts[parts.length - 1] = (parts[parts.length - 1] + " " + seg.slice(start).trim()).trim();
+    }
+    return parts.filter(Boolean);
+  }
+
+  function parseSegment(seg, nowDate) {
+    const text = seg;
+    // 1) 金额
+    let amountCents = 0;
+    let amountHit = null;
+    // 日期区间掩码：「10月5号」里的数字不能当金额
+    const dateMask = [];
+    {
+      const reDate = /\d{1,2}\s*月\s*\d{1,2}\s*[号日]/g;
+      let dm;
+      while ((dm = reDate.exec(text))) dateMask.push([dm.index, dm.index + dm[0].length]);
+    }
+    const inDate = (i) => dateMask.some(([a, b]) => i >= a && i < b);
+    // 1a) 「35块5 / 35块5毛 / 35块5分」特殊形式
+    const mFrac = text.match(/(\d+)\s*块\s*(\d)(?:\s*(毛|角|分))?/);
+    // 1b) 「8毛 / 6.5角」
+    const mJiao = text.match(/(\d+(?:\.\d+)?)\s*[毛角]/);
+    if (mFrac && !inDate(mFrac.index)) {
+      const unit = mFrac[3];
+      const frac = parseInt(mFrac[2], 10); // X块5 = 5角；X块5分 = 5分
+      amountCents = parseInt(mFrac[1], 10) * 100 + (unit === "分" ? frac : frac * 10);
+      amountHit = mFrac[0];
+    } else if (mJiao && !inDate(mJiao.index)) {
+      amountCents = Math.round(parseFloat(mJiao[1]) * 10);
+      amountHit = mJiao[0];
+    } else {
+      // 1c) 普通阿拉伯金额：35.5 / 86块 / 120元 / 399；跳过「2杯/3个」数量词与日期
+      const reAmt = /(\d+(?:\.\d{1,2})?)\s*(块钱|元钱|块|元|钱|rmb|RMB|¥|￥|分)?/g;
+      let mm;
+      while ((mm = reAmt.exec(text))) {
+        if (inDate(mm.index)) continue;
+        const after = text[mm.index + mm[0].length] || "";
+        if (after && QUANTIFIERS.includes(after)) continue; // 「2杯咖啡」「3个人」
+        if (mm[2] === "分" && after === "钟") continue;      // 「20分钟」
+        amountCents = Math.round(parseFloat(mm[1]) * 100);
+        amountHit = mm[0];
+        break;
+      }
+    }
+    // 1b) 中文数字：三十五块 / 一百二元 / 两百
+    if (amountCents === 0) {
+      const cm = text.match(/([零〇一二两三四五六七八九十百千]+)\s*(块|元|块钱|元钱|钱)?/);
+      if (cm) {
+        const v = cnNumber(cm[1]);
+        if (v && v > 0) {
+          // 中文数字后若跟「块X」零头
+          const after = text.slice((cm.index || 0) + cm[0].length);
+          const tail = after.match(/^(\d)\s*(毛|角|分)?/);
+          let extra = 0;
+          if (tail) extra = tail[2] === "分" ? parseInt(tail[1], 10) : parseInt(tail[1], 10) * 10;
+          amountCents = v * 100 + extra;
+          amountHit = cm[0] + (tail ? tail[0] : "");
+        }
+      }
+    }
+    if (amountCents <= 0) return null;
+
+    // 1d) 「每X」倍数：「奶茶两杯每杯20」→40、「两顿每人30」→60（仅当句中有「每」且前文有数量词）
+    if (/每/.test(text)) {
+      const qm = text.match(/([一两二三四五六七八九\d]+)\s*([杯个瓶份盒包箱袋张台本支根片顿人次条件位])/);
+      if (qm) {
+        const n = /^\d+$/.test(qm[1]) ? parseInt(qm[1], 10) : cnNumber(qm[1]);
+        if (n && n > 1) amountCents *= n;
+      }
+    }
+
+    // 2) 收支类型
+    const isIncome = INCOME_HINTS.some((k) => text.includes(k)) &&
+      !(EXPENSE_HINTS.some((k) => text.includes(k)) && !/(工资|薪水|发薪|薪资|报销|退款|红包到账|收到)/.test(text));
+    const type = isIncome ? "income" : "expense";
+
+    // 3) 分类
+    const cats = type === "income" ? INCOME_CATEGORIES : EXPENSE_CATEGORIES;
+    let categoryId = type === "income" ? "other_inc" : "other_exp";
+    let bestScore = 0;
+    for (const c of cats) {
+      for (const kw of c.keywords) {
+        if (kw && text.includes(kw.toLowerCase())) {
+          const score = kw.length; // 更长关键词更具体，优先
+          if (score > bestScore) { bestScore = score; categoryId = c.id; }
+        }
+      }
+    }
+
+    // 4) 日期
+    const date = resolveDate(text, nowDate);
+
+    // 5) 备注：去掉金额、日期词后的剩余短语
+    let note = text
+      .replace(amountHit || "", "")
+      .replace(/(今天|今日|昨天|昨日|前天|大前天|明天)(晚上|上午|下午|早上|中午)?/g, "")
+      .replace(/(上?个?)(星期|周|礼拜)[一二三四五六日天1-7]/g, "")
+      .replace(/\d{1,2}月\d{1,2}[号日]/g, "")
+      .replace(/^(花了|花|用了|用|买了|买|付了|付|支出|收入|收到|赚了|赚)/, "")
+      .replace(/(块钱?|元钱?|元|块|毛|角|分)$/g, "")
+      .trim();
+    if (note.length > 40) note = note.slice(0, 40);
+
+    return {
+      type,
+      amountCents,
+      categoryId,
+      date,
+      note: note || null,
+      confidence: bestScore > 0 ? 0.8 : 0.55,
+    };
+  }
+
+  function resolveDate(text, nowDate) {
+    const base = new Date(nowDate.getFullYear(), nowDate.getMonth(), nowDate.getDate());
+    if (/前天/.test(text)) return dateToStr(shiftDays(base, /大前天/.test(text) ? -3 : -2));
+    if (/昨天|昨日/.test(text)) return dateToStr(shiftDays(base, -1));
+    if (/今天|今日|刚刚|刚才/.test(text)) return dateToStr(base);
+    // X月X号
+    const md = text.match(/(\d{1,2})\s*月\s*(\d{1,2})\s*[号日]/);
+    if (md) {
+      const month = parseInt(md[1], 10), day = parseInt(md[2], 10);
+      let year = base.getFullYear();
+      if (month > base.getMonth() + 1 ||
+        (month === base.getMonth() + 1 && day > base.getDate())) year -= 1;
+      return `${year}-${pad2(month)}-${pad2(day)}`;
+    }
+    // 周X / 上周X
+    const wd = text.match(/(上)?(?:星期|周|礼拜)([一二三四五六日天1-7])/);
+    if (wd) {
+      const map = { 一: 1, 二: 2, 三: 3, 四: 4, 五: 5, 六: 6, 日: 7, 天: 7, "1": 1, "2": 2,
+        "3": 3, "4": 4, "5": 5, "6": 6, "7": 7 };
+      const target = map[wd[2]]; // 1=Mon ... 7=Sun
+      const todayWd = base.getDay() === 0 ? 7 : base.getDay();
+      let delta = target - todayWd;
+      if (wd[1]) delta -= 7;                 // 上周
+      else if (delta > 0) delta -= 7;        // 本周还没到的星期 → 上一周
+      return dateToStr(shiftDays(base, delta));
+    }
+    return dateToStr(base);
+  }
+
+  /** 把 LLM / 工具传入的分类（id 或中文名）归一化为分类 id */
+  function normalizeCategory(input, type) {
+    const cats = type === "income" ? INCOME_CATEGORIES : EXPENSE_CATEGORIES;
+    if (!input) return type === "income" ? "other_inc" : "other_exp";
+    const key = String(input).trim().toLowerCase();
+    const found = cats.find((c) =>
+      c.id === key || c.zh === input || c.en.toLowerCase() === key ||
+      c.keywords.some((k) => k === key));
+    return found ? found.id : (type === "income" ? "other_inc" : "other_exp");
+  }
+
+  function categoryMeta(id) {
+    const all = EXPENSE_CATEGORIES.concat(INCOME_CATEGORIES);
+    return all.find((c) => c.id === id) || { id, zh: id, en: id, emoji: "❓" };
+  }
+
+  /** 汇总计算：给定月份的条目数组 + 预算 → 统计结构（UI 与插件共用） */
+  function summarize(entries, budgets, monthStr) {
+    const month = monthStr || todayStr().slice(0, 7);
+    const inMonth = (entries || []).filter((e) => monthKeyOf(e.date) === month);
+    let expenseCents = 0, incomeCents = 0;
+    const byCatExp = new Map();
+    const dailyMap = new Map();
+    for (const e of inMonth) {
+      if (e.type === "expense") {
+        expenseCents += e.amountCents;
+        byCatExp.set(e.categoryId, (byCatExp.get(e.categoryId) || 0) + e.amountCents);
+        dailyMap.set(e.date, (dailyMap.get(e.date) || 0) + e.amountCents);
+      } else {
+        incomeCents += e.amountCents;
+      }
+    }
+    const byCategory = [...byCatExp.entries()]
+      .map(([categoryId, amountCents]) => {
+        const budgetCents = budgets?.categories?.[categoryId]
+          ? yuanToCents(budgets.categories[categoryId]) : 0;
+        return {
+          categoryId, amountCents,
+          count: inMonth.filter((e) => e.type === "expense" && e.categoryId === categoryId).length,
+          budgetCents,
+        };
+      })
+      .sort((a, b) => b.amountCents - a.amountCents);
+    const daysInMonth = new Date(parseInt(month.slice(0, 4), 10), parseInt(month.slice(5, 7), 10), 0).getDate();
+    const daily = [];
+    for (let d = 1; d <= daysInMonth; d++) {
+      const ds = `${month}-${pad2(d)}`;
+      daily.push({ date: ds, expenseCents: dailyMap.get(ds) || 0 });
+    }
+    const monthlyTotalCents = budgets?.monthly_total ? yuanToCents(budgets.monthly_total)
+      : (budgets?.monthly_total_cents || 0);
+    const budget = {
+      monthlyTotalCents,
+      spentCents: expenseCents,
+      remainingCents: monthlyTotalCents - expenseCents,
+      ratio: monthlyTotalCents > 0 ? expenseCents / monthlyTotalCents : 0,
+      over: monthlyTotalCents > 0 && expenseCents > monthlyTotalCents,
+      warn: monthlyTotalCents > 0 && expenseCents / monthlyTotalCents >= 0.8 &&
+        expenseCents <= monthlyTotalCents,
+    };
+    return {
+      month,
+      expenseCents, incomeCents, balanceCents: incomeCents - expenseCents,
+      byCategory, daily, budget,
+    };
+  }
+
+export {
+  EXPENSE_CATEGORIES, INCOME_CATEGORIES,
+  yuanToCents, centsToYuan, formatCents,
+  dateToStr, monthKeyOf, todayStr, pad2, resolveDate,
+  parseRules, normalizeCategory, categoryMeta, summarize,
+};

package/manifest.json

@@ -0,0 +1,209 @@
+{
+  "display_name": "AI Ledger 记账本",
+  "version": "1.0.0",
+  "description": "AI-native personal bookkeeping: record expenses/income via chat or voice, monthly stats, category budgets, and durable per-user cloud storage. AI 记账工具：聊天/语音记账、月度统计、分类预算，数据云端保存。",
+  "author": "ai-ledger",
+  "tags": [
+    "productivity",
+    "finance",
+    "ledger",
+    "anna-app",
+    "ai-native"
+  ],
+  "host_capabilities": [
+    "aps.kv",
+    "llm.sample"
+  ],
+  "runtime": {
+    "type": "node",
+    "min_version": "18.0.0"
+  },
+  "tools": [
+    {
+      "name": "parse_text",
+      "description": "把用户一句自然语言（中文口语，如“昨天和朋友吃火锅花了238块”“工资发了12000”）解析为一条或多条结构化记账草稿（金额/收支类型/分类/日期/备注）。返回 drafts 供用户确认，不直接入账。Parse a free-text bookkeeping sentence into structured draft entry(s); does NOT save anything.",
+      "parameters": [
+        {
+          "name": "text",
+          "type": "string",
+          "description": "用户的记账描述原文 / the raw sentence",
+          "required": true
+        }
+      ]
+    },
+    {
+      "name": "add_entry",
+      "description": "Save one ledger entry. Amount is in USD dollars. Use after the user confirms a parsed draft or states all details.",
+      "parameters": [
+        {
+          "name": "type",
+          "type": "string",
+          "description": "expense (default) or income",
+          "required": false,
+          "default": "expense"
+        },
+        {
+          "name": "amount",
+          "type": "number",
+          "description": "Amount in USD, e.g. 35 or 86.5",
+          "required": true
+        },
+        {
+          "name": "category",
+          "type": "string",
+          "description": "Category id or name: food/transport/shopping/housing/entertainment/health/education/communication/travel/gifts/other_exp (expense); salary/freelance/investment/redpacket_in/refund/other_inc (income)",
+          "required": false
+        },
+        {
+          "name": "note",
+          "type": "string",
+          "description": "Optional note, ≤ 60 chars",
+          "required": false
+        },
+        {
+          "name": "date",
+          "type": "string",
+          "description": "Date YYYY-MM-DD, default today",
+          "required": false
+        },
+        {
+          "name": "source",
+          "type": "string",
+          "description": "manual/voice/chat, default chat",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "list_entries",
+      "description": "列出指定月份（默认本月）的全部账目，按日期倒序。List entries of a month (YYYY-MM, default current).",
+      "parameters": [
+        {
+          "name": "month",
+          "type": "string",
+          "description": "月份 YYYY-MM，如 2026-09",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "delete_entry",
+      "description": "按 id 删除一条账目。Delete one entry by id.",
+      "parameters": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "条目 id",
+          "required": true
+        },
+        {
+          "name": "month",
+          "type": "string",
+          "description": "条目所在月份 YYYY-MM（可选，不传则在近4个月查找）",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "update_entry",
+      "description": "修改一条已有账目（金额、类型、分类、日期、备注）。可以跨月份移动，插件自动处理旧月/新月的搬迁。Update an existing entry's fields (amount/type/category/date/note). Cross-month moves are handled automatically.",
+      "parameters": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "要修改的条目 id",
+          "required": true
+        },
+        {
+          "name": "type",
+          "type": "string",
+          "description": "expense / income（可选）",
+          "required": false
+        },
+        {
+          "name": "amount",
+          "type": "number",
+          "description": "新金额（美元），如 15 或 8.5（可选）",
+          "required": false
+        },
+        {
+          "name": "categoryId",
+          "type": "string",
+          "description": "新分类 id（可选）",
+          "required": false
+        },
+        {
+          "name": "date",
+          "type": "string",
+          "description": "新日期 YYYY-MM-DD（可选，跨月会自动搬迁）",
+          "required": false
+        },
+        {
+          "name": "note",
+          "type": "string",
+          "description": "新备注，最多 60 字符，传空字符串即清空（可选）",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "get_summary",
+      "description": "获取某月汇总：支出/收入/结余总额、分类占比、每日支出、预算进度与是否超支。Monthly summary for answering questions like “这个月花了多少”.",
+      "parameters": [
+        {
+          "name": "month",
+          "type": "string",
+          "description": "月份 YYYY-MM，默认本月",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "set_budget",
+      "description": "设置月度预算：月总额和/或分类预算（单位元）。Set monthly total budget and/or per-category budgets.",
+      "parameters": [
+        {
+          "name": "monthly_total",
+          "type": "number",
+          "description": "每月总预算（元），如 3000",
+          "required": false
+        },
+        {
+          "name": "categories",
+          "type": "object",
+          "description": "分类预算映射，如 {\"food\":1500,\"transport\":300}",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "get_state",
+      "description": "获取预算与最近3个月的全部账目（App 窗口打开时水合用）。Hydrate the app window state.",
+      "parameters": []
+    },
+    {
+      "name": "archive_year",
+      "description": "将指定年份的12个月度记录归档为1个年度key（紧凑格式），删除原月度key以节省KV存储容量。归档后记录变为只读，可通过 unarchive_year 解档。Archive a year's monthly records into a single compact yearly key, deleting the monthly keys to save KV storage. Archived records become read-only; use unarchive_year to restore.",
+      "parameters": [
+        {
+          "name": "year",
+          "type": "string",
+          "description": "要归档的年份 YYYY，如 2025。不传则默认去年。Year to archive, default last year.",
+          "required": false
+        }
+      ]
+    },
+    {
+      "name": "unarchive_year",
+      "description": "将年度归档还原回月度记录，使其可再次编辑。Unarchive a year: restore monthly records from the yearly archive key, making them editable again.",
+      "parameters": [
+        {
+          "name": "year",
+          "type": "string",
+          "description": "要解档的年份 YYYY，如 2025。Year to unarchive.",
+          "required": true
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "ibill-ai-ledger",
+  "version": "1.0.0",
+  "description": "iBill · AI 记账本 — Anna Executa stdio plugin (Node.js, zero deps): chat/voice bookkeeping with AI parsing, budgets and monthly stats",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "ibill-ai-ledger": "plugin.js",
+    "tool-dev-ai-ledger": "plugin.js"
+  },
+  "files": [
+    "plugin.js",
+    "lib",
+    "executa.json",
+    "manifest.json"
+  ],
+  "main": "plugin.js",
+  "scripts": {
+    "start": "node plugin.js"
+  },
+  "keywords": [
+    "anna",
+    "executa",
+    "ai-ledger",
+    "bookkeeping",
+    "expense-tracker"
+  ]
+}