@fangcuntai/fangcuntai-mcp 1.6.0 → 1.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -98,8 +98,8 @@
98
98
 
99
99
  | Tool | 说明 |
100
100
  |------|------|
101
- | `list_ledger_books` / `select_ledger_book` | 账本 |
102
- | `get_ledger_summary` / `list_ledger_entries` / `get_ledger_trends` | 查账;`list_ledger_entries` 可按 `external_order_id` 精确查找 |
101
+ | `list_ledger_books` / `select_ledger_book` | 账本;列表含用法、状态、说明(最多 50 字) |
102
+ | `get_ledger_summary` / `list_ledger_entries` / `get_ledger_trends` | 查账;时期账本不传 `month` 时 `get_ledger_summary` 返回整件事;`list_ledger_entries` 可按 `external_order_id` 精确查找 |
103
103
  | `list_ledger_categories` | 分类 |
104
104
  | `prepare_create_ledger_entry` / `confirm_create_ledger_entry` | 确认后入账;可传 `external_order_id`,已存在则 `already_exists` |
105
105
  | `prepare_delete_ledger_entry` / `confirm_delete_ledger_entry` | 确认后进回收站 |
package/dist/index.js CHANGED
@@ -9,7 +9,7 @@ async function main() {
9
9
  const client = new FangcuntaiApiClient(config.apiBase, config.token);
10
10
  const server = new McpServer({
11
11
  name: "fangcuntai",
12
- version: "1.5.0",
12
+ version: "1.6.1",
13
13
  });
14
14
  registerTools(server, client);
15
15
  const transport = new StdioServerTransport();
@@ -112,7 +112,7 @@ export async function confirmCreateLedgerEntry(client, confirmToken) {
112
112
  };
113
113
  }
114
114
  export function registerLedgerTools(server, client) {
115
- server.tool("list_ledger_books", "列出当前家庭的账本(含币种、是否默认)。切换账本前先调用,再用 select_ledger_book。", {}, async () => runTool(async () => {
115
+ server.tool("list_ledger_books", "列出当前家庭的账本(含币种、是否默认、usage=daily|period、进行中/已结束、起止、说明最多50字、时期账的全程累计)。问装修/婚礼等大事时优先对上说明和名字。切换账本前先调用,再用 select_ledger_book。本工具只查阅,不能新建或改账本说明。", {}, async () => runTool(async () => {
116
116
  client.setToolName("list_ledger_books");
117
117
  const familyId = await ensureFamilyId(client);
118
118
  await requireEntitlement(client, familyId, "can_use_ledger", "当前角色没有记账权限,无法查看账本");
@@ -137,24 +137,32 @@ export function registerLedgerTools(server, client) {
137
137
  workspace,
138
138
  });
139
139
  }));
140
- server.tool("get_ledger_summary", "查询指定月份记账摘要(收入/支出,单位:元)。month 格式 YYYY-MM,留空为本月。", {
141
- month: z.string().optional().describe("YYYY-MM,留空为本月"),
140
+ server.tool("get_ledger_summary", "查询记账摘要(收入/支出,单位:元)。日常账本:month 为 YYYY-MM,留空为本月。一件大事账本(装修/婚礼等):不传 month 返回整件事累计(scope=lifetime),不要当成这个月。", {
141
+ month: z
142
+ .string()
143
+ .optional()
144
+ .describe("YYYY-MM。日常账本留空=本月;一件大事账本留空=整件事"),
142
145
  ledger_book_id: optionalBookId,
143
146
  }, async ({ month, ledger_book_id }) => runTool(async () => {
144
147
  client.setToolName("get_ledger_summary");
145
148
  await requireTokenScope(client, [TOKEN_SCOPE_READ_STATS]);
146
149
  const familyId = await ensureFamilyId(client);
147
150
  const data = await client.get(familyPath(familyId, "/ledger/summary"), { month, ...ledgerBookQuery(ledger_book_id) });
151
+ const scope = String(data.scope ?? "");
148
152
  const normalized = {
149
153
  ...data,
150
- month: month ?? null,
154
+ month: scope === "lifetime" ? null : (month ?? data.month ?? null),
155
+ scope: scope || "month",
156
+ hint: scope === "lifetime"
157
+ ? "这是一件大事的全程累计,不是某一个月。"
158
+ : undefined,
151
159
  total_income_yuan: fenToYuan(Number(data.total_income ?? 0)),
152
160
  total_expense_yuan: fenToYuan(Number(data.total_expense ?? 0)),
153
161
  workspace: await getWorkspaceContext(client),
154
162
  };
155
163
  return okJson(normalized);
156
164
  }));
157
- server.tool("list_ledger_entries", "列出记账流水。可按月份、类型、外部订单号筛选;金额会附带 amount_yuan(元)。", {
165
+ server.tool("list_ledger_entries", "列出记账流水。可按月份、类型、外部订单号筛选;金额会附带 amount_yuan(元)。不传月份是全程。查已结束的大事账本时不要传 month。", {
158
166
  page: z.number().int().min(1).optional(),
159
167
  page_size: z.number().int().min(1).max(100).optional(),
160
168
  month: z.string().optional().describe("YYYY-MM"),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fangcuntai/fangcuntai-mcp",
3
- "version": "1.6.0",
3
+ "version": "1.6.2",
4
4
  "description": "方寸台桌面助手 MCP — 确认锁 + 来源标记 + 回收站 + 记事文件夹整理,安全地用自然语言管理家庭账本与记事",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -33,11 +33,7 @@
33
33
  "ledger",
34
34
  "desktop-assistant"
35
35
  ],
36
- "repository": {
37
- "type": "git",
38
- "url": "https://github.com/rhinogo/home-man.git",
39
- "directory": "fangcuntai-mcp"
40
- },
36
+ "homepage": "https://www.fangcuntai.com",
41
37
  "dependencies": {
42
38
  "@modelcontextprotocol/sdk": "^1.12.1",
43
39
  "zod": "^3.24.2"