@fangcuntai/fangcuntai-mcp 1.6.0 → 1.6.1
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 +2 -2
- package/dist/tools/ledger.js +13 -5
- package/package.json +1 -1
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` |
|
|
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/tools/ledger.js
CHANGED
|
@@ -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", "
|
|
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", "
|
|
141
|
-
month: z
|
|
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"),
|