@wkgeo/cli 0.0.0-stage → 1.1.0

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.
Files changed (54) hide show
  1. package/CHANGELOG.md +223 -0
  2. package/LICENSE +21 -0
  3. package/README.md +1042 -3
  4. package/SKILL.md +927 -0
  5. package/lib/ai/client.mjs +161 -0
  6. package/lib/ai/config.mjs +221 -0
  7. package/lib/ai/context.mjs +468 -0
  8. package/lib/ai/log.mjs +53 -0
  9. package/lib/api.mjs +339 -0
  10. package/lib/args.mjs +235 -0
  11. package/lib/cli.mjs +168 -0
  12. package/lib/cms.mjs +330 -0
  13. package/lib/commands/ai.mjs +392 -0
  14. package/lib/commands/apps.mjs +116 -0
  15. package/lib/commands/auth.mjs +1288 -0
  16. package/lib/commands/billing.mjs +666 -0
  17. package/lib/commands/cms.mjs +2533 -0
  18. package/lib/commands/config-auth.mjs +621 -0
  19. package/lib/commands/config.mjs +434 -0
  20. package/lib/commands/dnscred.mjs +428 -0
  21. package/lib/commands/domainops.mjs +546 -0
  22. package/lib/commands/domainorder.mjs +439 -0
  23. package/lib/commands/import.mjs +164 -0
  24. package/lib/commands/index.mjs +541 -0
  25. package/lib/commands/logs.mjs +141 -0
  26. package/lib/commands/orders.mjs +444 -0
  27. package/lib/commands/overview.mjs +394 -0
  28. package/lib/commands/plugins.mjs +678 -0
  29. package/lib/commands/site.mjs +435 -0
  30. package/lib/commands/siteops.mjs +1012 -0
  31. package/lib/commands/sites.mjs +905 -0
  32. package/lib/commands/skill.mjs +119 -0
  33. package/lib/commands/template.mjs +258 -0
  34. package/lib/config.mjs +351 -0
  35. package/lib/credentials.mjs +160 -0
  36. package/lib/device-store.mjs +132 -0
  37. package/lib/device.mjs +464 -0
  38. package/lib/errors.mjs +299 -0
  39. package/lib/format.mjs +339 -0
  40. package/lib/http.mjs +71 -0
  41. package/lib/index.mjs +44 -0
  42. package/lib/local-import.mjs +185 -0
  43. package/lib/login.mjs +1638 -0
  44. package/lib/oauth-urls.mjs +163 -0
  45. package/lib/page.mjs +393 -0
  46. package/lib/pkce.mjs +48 -0
  47. package/lib/proxy.mjs +454 -0
  48. package/lib/qr.mjs +31 -0
  49. package/lib/runtime.mjs +650 -0
  50. package/lib/site-state.mjs +137 -0
  51. package/lib/tar.mjs +207 -0
  52. package/lib/template-package.mjs +522 -0
  53. package/package.json +53 -4
  54. package/wkgeo.mjs +17 -0
@@ -0,0 +1,468 @@
1
+ /**
2
+ * 「本地模型能读到什么」的**白名单**,以及按域取数的实现(`wkgeo ai ask` / `wkgeo context export` 共用)。
3
+ *
4
+ * 这是整个本地模型接入的**唯一数据入口**:
5
+ * * 只有 `CONTEXT_DOMAINS` 里列出的域能取;
6
+ * * `--context` 传了表外的名字 → `UsageError`(不做"猜一下");
7
+ * * 订单/钱包/用户明细默认禁止(`orders` 要 `--context orders` **且** `ai.allowOrders=true`;
8
+ * `wallet` / `users` 是**硬禁用**);
9
+ * * 取到的每一份数据都过 `maskPiiDeep()`(手机/邮箱/IP/浏览器标识/订单号/密钥/OSS 签名)。
10
+ *
11
+ * 加新域的顺序:先在这里登记(含权限、默认开关、脱敏方式),再写 `collect*`,
12
+ * 最后同步 `docs/CLI-本地大模型接入.md` 的表格 —— 三处必须一致。
13
+ */
14
+
15
+ import { CliError, UsageError } from '../errors.mjs';
16
+ import { maskPii, maskPiiDeep } from '../format.mjs';
17
+
18
+ /**
19
+ * @typedef {object} DomainSpec
20
+ * @property {string} label 人话名称(表头/日志里用)
21
+ * @property {string} cli CLI 命令(文档里"这个域对应哪条命令")
22
+ * @property {string} action 后端动作(或"无(纯本地拼)")
23
+ * @property {string} permission 需要的权限
24
+ * @property {boolean} defaultOn 不写 `--context` 时是否默认带上
25
+ * @property {string} mask 脱敏方式(人话)
26
+ * @property {boolean} [gated] 需要额外配置才放行
27
+ * @property {string} [gate] 放行它的配置键
28
+ * @property {boolean} [blocked] 硬禁用(任何配置都不放)
29
+ */
30
+
31
+ /** @type {Record<string, DomainSpec>} */
32
+ export const CONTEXT_DOMAINS = {
33
+ site: {
34
+ label: '站点信息',
35
+ cli: 'wkgeo sites list',
36
+ action: 'listSites(平台面)',
37
+ permission: 'site:read',
38
+ defaultOn: true,
39
+ mask: '名称/域名保留(业务数据),创建人等账号信息不给',
40
+ },
41
+ overview: {
42
+ label: '数据概览',
43
+ cli: 'wkgeo contents list',
44
+ action: 'overview',
45
+ permission: '站点成员',
46
+ defaultOn: true,
47
+ mask: '只有计数(栏目数/内容数/素材数),没有明细',
48
+ },
49
+ categories: {
50
+ label: '栏目树',
51
+ cli: 'wkgeo categories list',
52
+ action: 'categoryList',
53
+ permission: '站点成员',
54
+ defaultOn: true,
55
+ mask: '名称/路径/类型/状态保留;不给 id',
56
+ },
57
+ contents: {
58
+ label: '内容列表',
59
+ cli: 'wkgeo contents list',
60
+ action: 'contentList',
61
+ permission: '站点成员',
62
+ defaultOn: true,
63
+ mask: '只给标题/栏目/状态/摘要前 120 字;**不给正文**(要正文用 context export --with-body)',
64
+ },
65
+ plugins: {
66
+ label: '插件',
67
+ cli: 'wkgeo plugins list',
68
+ action: 'pluginList',
69
+ permission: '站点成员',
70
+ defaultOn: true,
71
+ mask: 'key/名称/分类/开关状态保留;settings 一律不给',
72
+ },
73
+ forms: {
74
+ label: '表单结构',
75
+ cli: 'wkgeo forms list',
76
+ action: '/form formList(插件函数)',
77
+ permission: '站点成员 + CMS 会话',
78
+ defaultOn: true,
79
+ mask: '只给表单名/字段名,**不给留言内容**;拿不到就跳过并注明',
80
+ },
81
+ publish: {
82
+ label: '发布状态',
83
+ cli: 'wkgeo publish status',
84
+ action: 'cmsSitePublishStatus',
85
+ permission: '站点成员',
86
+ defaultOn: true,
87
+ mask: '只有任务状态与计数',
88
+ },
89
+ orders: {
90
+ label: '订单(仅聚合)',
91
+ cli: 'wkgeo orders list',
92
+ action: 'listMyOrders(平台面)',
93
+ permission: 'billing:self',
94
+ defaultOn: false,
95
+ mask: '只给条数与状态分布,**不给订单号/金额明细**',
96
+ gated: true,
97
+ gate: 'ai.allowOrders',
98
+ },
99
+ wallet: {
100
+ label: '钱包流水(禁止)',
101
+ cli: '-',
102
+ action: '-',
103
+ permission: '-',
104
+ defaultOn: false,
105
+ mask: '硬禁用',
106
+ blocked: true,
107
+ },
108
+ users: {
109
+ label: '用户明细(禁止)',
110
+ cli: '-',
111
+ action: '-',
112
+ permission: '-',
113
+ defaultOn: false,
114
+ mask: '硬禁用',
115
+ blocked: true,
116
+ },
117
+ };
118
+
119
+ /** 不写 `--context` 时带的域(顺序 = prompt 里的顺序) */
120
+ export const DEFAULT_CONTEXT_DOMAINS = Object.keys(CONTEXT_DOMAINS).filter((k) => CONTEXT_DOMAINS[k].defaultOn);
121
+
122
+ /** 给 `--context` 的用法提示(错误里列全,省得用户去翻文档) */
123
+ export function contextNames() {
124
+ return Object.keys(CONTEXT_DOMAINS).join(' / ');
125
+ }
126
+
127
+ /**
128
+ * 解析 `--context a,b`,做**白名单 + 闸门**校验。
129
+ *
130
+ * @param {string|string[]|undefined} raw
131
+ * @param {{config?:object}} [opts] `config` = `resolveAiConfig()` 的结果(用到 allowOrders/allowData/denyData)
132
+ * @returns {string[]}
133
+ */
134
+ export function parseContextDomains(raw, { config = {} } = {}) {
135
+ if (raw === undefined || raw === null || raw === '') return [...DEFAULT_CONTEXT_DOMAINS];
136
+ const list = (Array.isArray(raw) ? raw : String(raw).split(','))
137
+ .map((one) => String(one || '').trim().toLowerCase())
138
+ .filter(Boolean);
139
+ if (!list.length) return [...DEFAULT_CONTEXT_DOMAINS];
140
+
141
+ const out = [];
142
+ for (const name of list) {
143
+ const spec = CONTEXT_DOMAINS[name];
144
+ if (!spec) {
145
+ throw new UsageError(`未知的数据域「${name}」\n可用:${contextNames()}`, {
146
+ hint: '数据域是白名单:只能从上面这些里选(`--context site,overview,categories`)',
147
+ });
148
+ }
149
+ if (spec.blocked || (Array.isArray(config.denyData) && config.denyData.includes(name))) {
150
+ throw new UsageError(`数据域「${name}」被硬禁用(${spec.label})`, {
151
+ hint:
152
+ '订单明细 / 钱包流水 / 用户明细**不提供给本地模型**(这是设计约束,配置里也打不开)。' +
153
+ '要看这些数据请用 CLI 自己的命令(`wkgeo orders list` 等)。',
154
+ });
155
+ }
156
+ if (spec.gated && config[spec.gate.replace(/^ai\./, '')] !== true) {
157
+ throw new UsageError(`数据域「${name}」需要先开启 ${spec.gate}`, {
158
+ hint: `在 ~/.wkongai/config.json 的 ai 段里加 "${spec.gate.replace(/^ai\./, '')}": true,并显式传 --context ${name}`,
159
+ });
160
+ }
161
+ const extraAllowed = Array.isArray(config.allowData) && config.allowData.includes(name);
162
+ if (!spec.defaultOn && !extraAllowed && !spec.gated) {
163
+ throw new UsageError(`数据域「${name}」默认关闭`, { hint: '在配置 ai.allowData 里放行它' });
164
+ }
165
+ if (!out.includes(name)) out.push(name);
166
+ }
167
+ return out;
168
+ }
169
+
170
+ /** 把一棵栏目树压平成 `[depth, node]`(prompt 里用缩进表达层级,比 JSON 省 token) */
171
+ function flattenTree(rows, parentId = null, depth = 0, out = []) {
172
+ for (const row of rows) {
173
+ if (String(row.parent_id || '') !== String(parentId || '')) continue;
174
+ out.push({ depth, row });
175
+ flattenTree(rows, row.id, depth + 1, out);
176
+ }
177
+ return out;
178
+ }
179
+
180
+ /** 栏目行 → 只留业务字段(**不给 id**,省 token 也少一个能被拼回接口的把手) */
181
+ function categoryNode(row) {
182
+ const node = {
183
+ name: String(row.name || ''),
184
+ slug: String(row.slug || ''),
185
+ path: String(row.path || ''),
186
+ kind: String(row.kind || ''),
187
+ status: String(row.status || ''),
188
+ };
189
+ if (row.template_path) node.template = String(row.template_path);
190
+ if (row.link_plugin_key) node.link_plugin = String(row.link_plugin_key);
191
+ return node;
192
+ }
193
+
194
+ /** 精简一段摘要(给模型看的"这是什么内容",不该把整段正文塞进去) */
195
+ function briefText(text, max = 120) {
196
+ const s = String(text || '').replace(/\s+/g, ' ').trim();
197
+ if (!s) return '';
198
+ return s.length > max ? `${s.slice(0, max)}…` : s;
199
+ }
200
+
201
+ /**
202
+ * 按域取数。**单个域失败不影响其它域**:失败写进 `notes`,命令照常往下走
203
+ * (典型场景:`/form` 还没接 Bearer 桥,表单域永远是"不可用")。
204
+ *
205
+ * @param {object} ctx CLI runtime
206
+ * @param {{domains?:string[], withBody?:boolean, maxContents?:number}} [opts]
207
+ * @returns {Promise<{siteId:string, site:{id:string,name:string}|null, domains:object, notes:string[], chars:number}>}
208
+ */
209
+ export async function collectContext(ctx, { domains = DEFAULT_CONTEXT_DOMAINS, withBody = false, maxContents = 50 } = {}) {
210
+ const site = ctx.cmsSite();
211
+ if (!site || !site.id) {
212
+ throw new UsageError('还不知道要读哪个站', {
213
+ hint: '先 `wkgeo site use <站点ID>` 选一次,或这次显式传 `--site <站点ID>`',
214
+ });
215
+ }
216
+ const siteId = site.id;
217
+ const data = {};
218
+ const notes = [];
219
+
220
+ /** 统一收口:单个域炸了 → 记一条人话 note(脱敏后),不抛 */
221
+ const guard = async (name, fn) => {
222
+ try {
223
+ const value = await fn();
224
+ data[name] = maskPiiDeep(value);
225
+ } catch (e) {
226
+ notes.push(`${CONTEXT_DOMAINS[name].label}不可用:${maskPii(e && e.message ? e.message : String(e))}`);
227
+ }
228
+ };
229
+
230
+ for (const name of domains) {
231
+ if (name === 'site') {
232
+ await guard('site', async () => {
233
+ const res = await ctx.callData('listSites', { limit: 200 });
234
+ const rows = (Array.isArray(res) ? res : (res && (res.rows || res.list || res.sites)) || []).map((one) => one || {});
235
+ const hit = rows.find((one) => String(one.id) === siteId);
236
+ if (!hit) return { id: siteId, name: site.label || '', domain: '', note: '这个站不在"我拥有/协作"的列表里(协作站),只有 ID' };
237
+ return {
238
+ id: siteId,
239
+ name: String(hit.name || ''),
240
+ domain: String(hit.domain || hit.prefix_host || ''),
241
+ domains: Array.isArray(hit.domains) ? hit.domains.map(String).slice(0, 5) : [],
242
+ status: String(hit.status || ''),
243
+ };
244
+ });
245
+ } else if (name === 'overview') {
246
+ await guard('overview', async () => {
247
+ const res = await ctx.cmsCall('overview');
248
+ return {
249
+ siteName: String((res && res.siteName) || ''),
250
+ categories: Number((res && res.categories) || 0),
251
+ contents: Number((res && res.contents) || 0),
252
+ published: Number((res && res.published) || 0),
253
+ drafts: Number((res && res.drafts) || 0),
254
+ assets: Number((res && res.assets) || 0),
255
+ };
256
+ });
257
+ } else if (name === 'categories') {
258
+ await guard('categories', async () => {
259
+ const res = await ctx.cmsCall('categoryList');
260
+ const rows = Array.isArray(res) ? res : (res && (res.rows || res.list)) || [];
261
+ const flat = flattenTree(rows);
262
+ return flat.map(({ depth, row }) => ({ ...categoryNode(row), depth }));
263
+ });
264
+ } else if (name === 'contents') {
265
+ await guard('contents', async () => {
266
+ const res = await ctx.cmsCall('contentList', { page: 1, pageSize: Math.min(100, Math.max(1, maxContents)) });
267
+ const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((one) => one || {});
268
+ return {
269
+ total: Number((res && res.total) || rows.length),
270
+ sampleSize: rows.length,
271
+ rows: rows.map((row) => ({
272
+ title: String(row.title || ''),
273
+ category: String(row.category_name || ''),
274
+ status: String(row.status || ''),
275
+ updatedAt: String(row.updated_at || ''),
276
+ summary: briefText(row.summary || row.description || ''),
277
+ })),
278
+ };
279
+ });
280
+ if (withBody && data.contents && Array.isArray(data.contents.rows)) {
281
+ for (const row of data.contents.rows.slice(0, 10)) {
282
+ const id = row.id;
283
+ if (!id) continue;
284
+ try {
285
+ const one = await ctx.cmsCall('contentGet', { id });
286
+ const body = String((one && (one.body || one.content || one.rich_text)) || '').replace(/<[^>]+>/g, ' ');
287
+ row.body = briefText(body, 1500);
288
+ } catch (e) {
289
+ notes.push(`部分正文读不到:${maskPii(e && e.message ? e.message : String(e))}`);
290
+ break;
291
+ }
292
+ }
293
+ }
294
+ } else if (name === 'plugins') {
295
+ await guard('plugins', async () => {
296
+ const res = await ctx.cmsCall('pluginList');
297
+ const rows = (res && (res.rows || res.plugins)) || (Array.isArray(res) ? res : []);
298
+ return rows.map((one) => ({
299
+ key: String(one.key || ''),
300
+ name: String(one.name || ''),
301
+ category: String(one.category || ''),
302
+ enabled: one.enabled === true || one.enabled === 'true',
303
+ }));
304
+ });
305
+ } else if (name === 'forms') {
306
+ await guard('forms', async () => {
307
+ /**
308
+ * 插件函数(`/form`)的管理动作**只认 CMS 会话 Cookie**,不认 Bearer ——
309
+ * 这里如实调用、如实失败(`guard` 会记成"表单结构不可用"),
310
+ * 后端补桥后这段代码不用改。`x-cms-site` 与 `Origin` 先带上,桥一上线就能用。
311
+ */
312
+ const res = await ctx.callData('formList', {}, {
313
+ prefix: 'form',
314
+ headers: { 'x-cms-site': siteId, Origin: 'https://wkgeo.com' },
315
+ });
316
+ const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((one) => one || {});
317
+ return rows.map((row) => ({
318
+ key: String(row.key || ''),
319
+ name: String(row.name || ''),
320
+ status: String(row.status || ''),
321
+ fields: (Array.isArray(row.fields) ? row.fields : []).map((f) => ({
322
+ label: String(f.label || ''),
323
+ type: String(f.type || ''),
324
+ })),
325
+ entries: Number(row.entryCount || 0),
326
+ }));
327
+ });
328
+ } else if (name === 'publish') {
329
+ await guard('publish', async () => {
330
+ const res = await ctx.cmsCall('cmsSitePublishStatus', {});
331
+ const summary = (res && res.summary) || {};
332
+ return {
333
+ status: String((res && res.status) || 'idle'),
334
+ total: Number((res && res.total) || 0),
335
+ done: Number((res && res.done) || 0),
336
+ percent: Number((res && res.percent) || 0),
337
+ pagesFailed: Number(summary.pagesFailed || 0),
338
+ finalizeOk: summary.finalizeOk === undefined ? null : summary.finalizeOk === true,
339
+ finishedAt: String((res && res.finishedAt) || ''),
340
+ };
341
+ });
342
+ } else if (name === 'orders') {
343
+ await guard('orders', async () => {
344
+ const res = await ctx.callData('listMyOrders', { limit: 50 });
345
+ const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((one) => one || {});
346
+ const byStatus = {};
347
+ for (const row of rows) {
348
+ const key = String(row.status || 'unknown');
349
+ byStatus[key] = (byStatus[key] || 0) + 1;
350
+ }
351
+ /** ★ 只给条数与状态分布:订单号、金额、商品名一律不出现在 prompt 里 */
352
+ return { count: Number((res && res.total) || rows.length), byStatus };
353
+ });
354
+ }
355
+ }
356
+
357
+ let chars = 0;
358
+ try {
359
+ chars = JSON.stringify(data).length;
360
+ } catch {
361
+ chars = 0;
362
+ }
363
+ return { siteId, site: { id: siteId, name: site.label || '' }, domains: data, notes, chars };
364
+ }
365
+
366
+ /** 数据域 → prompt 里的小标题 */
367
+ const SECTION_TITLE = {
368
+ site: '站点信息',
369
+ overview: '数据概览',
370
+ categories: '栏目结构(缩进 = 层级)',
371
+ contents: '内容列表(最多 50 条样例)',
372
+ plugins: '插件开关',
373
+ forms: '表单结构',
374
+ publish: '最近一次发布',
375
+ orders: '订单(仅聚合)',
376
+ };
377
+
378
+ /**
379
+ * 把收集到的数据拼成给模型的纯文本(**不塞 JSON**:同样信息少一半 token,小模型也更稳)。
380
+ *
381
+ * @param {Awaited<ReturnType<typeof collectContext>>} collected
382
+ * @returns {string}
383
+ */
384
+ export function contextToText(collected) {
385
+ const out = [];
386
+ for (const [name, value] of Object.entries(collected.domains || {})) {
387
+ const title = SECTION_TITLE[name] || name;
388
+ out.push(`## ${title}`);
389
+ if (name === 'site') {
390
+ out.push(`- 名称:${value.name || '(未命名)'}`);
391
+ if (value.domain) out.push(`- 主域名:${value.domain}`);
392
+ if (Array.isArray(value.domains) && value.domains.length) out.push(`- 其它域名:${value.domains.join('、')}`);
393
+ if (value.status) out.push(`- 状态:${value.status}`);
394
+ } else if (name === 'overview') {
395
+ out.push(
396
+ `- 栏目 ${value.categories} 个,内容 ${value.contents} 条(已发布 ${value.published} / 草稿 ${value.drafts}),素材 ${value.assets} 个`,
397
+ );
398
+ } else if (name === 'categories') {
399
+ if (!value.length) out.push('- (没有栏目)');
400
+ for (const one of value) {
401
+ const indent = ' '.repeat(Number(one.depth || 0));
402
+ const extra = one.link_plugin ? ` → 插件页 ${one.link_plugin}` : '';
403
+ out.push(`${indent}- ${one.name}(/${String(one.slug || '').replace(/^\/+/, '')},${one.kind},${one.status})${extra}`);
404
+ }
405
+ } else if (name === 'contents') {
406
+ out.push(`- 共 ${value.total} 条,下面是 ${value.sampleSize} 条样例(不含正文)`);
407
+ for (const one of value.rows) {
408
+ const bits = [one.category, one.status].filter(Boolean).join(' / ');
409
+ out.push(`- ${one.title}${bits ? `(${bits})` : ''}${one.summary ? `:${one.summary}` : ''}`);
410
+ }
411
+ } else if (name === 'plugins') {
412
+ for (const one of value) out.push(`- ${one.name || one.key}(${one.key},${one.category || '未分类'}):${one.enabled ? '已启用' : '未启用'}`);
413
+ } else if (name === 'forms') {
414
+ if (!value.length) out.push('- (没有表单)');
415
+ for (const one of value) {
416
+ out.push(`- ${one.name}(${one.key}):${one.fields.map((f) => f.label).join('、') || '无字段'};留言 ${one.entries} 条`);
417
+ }
418
+ } else if (name === 'publish') {
419
+ out.push(`- 状态:${value.status};进度 ${value.done}/${value.total}(${value.percent}%)`);
420
+ if (value.pagesFailed) out.push(`- 失败页面:${value.pagesFailed} 个`);
421
+ if (value.finalizeOk === false) out.push('- 收尾未成功(finalizeOk=false)');
422
+ } else if (name === 'orders') {
423
+ out.push(`- 订单共 ${value.count} 条;状态分布:${JSON.stringify(value.byStatus)}`);
424
+ }
425
+ out.push('');
426
+ }
427
+ if (collected.notes && collected.notes.length) {
428
+ out.push('## 取数说明(CLI 自动附加)');
429
+ for (const note of collected.notes) out.push(`- ${note}`);
430
+ out.push('');
431
+ }
432
+ return out.join('\n').trim();
433
+ }
434
+
435
+ /**
436
+ * 导出物的 Markdown 版本(`wkgeo context export --format md`)。
437
+ * @param {Awaited<ReturnType<typeof collectContext>>} collected
438
+ * @param {{generatedAt?:string, withBody?:boolean}} [meta]
439
+ */
440
+ export function contextToMarkdown(collected, { generatedAt = '', withBody = false } = {}) {
441
+ const head = [
442
+ '# 站点上下文导出',
443
+ '',
444
+ `- 站点 ID:${collected.siteId}`,
445
+ `- 生成时间:${generatedAt}`,
446
+ '- 导出内容:栏目树 + 内容列表(标题/摘要/状态)+ 插件 + 表单结构 + 发布状态 + 站点信息',
447
+ `- 正文:${withBody ? '已包含(前 10 条,截断 1500 字)' : '**不含**(要含请加 --with-body)'}`,
448
+ '- 已脱敏:手机号 / 邮箱 / IP / 浏览器标识 / 订单号 / 密钥 / OSS 签名链接',
449
+ '- 本文件只由你保存,CLI 不会上传到任何地方。',
450
+ '',
451
+ ];
452
+ return `${head.join('\n')}${contextToText(collected)}\n`;
453
+ }
454
+
455
+ /** 把"哪些域默认开/需要什么权限"整理成表格行(README/文档/`ai ping` 都用同一份) */
456
+ export function domainTableRows() {
457
+ return Object.entries(CONTEXT_DOMAINS).map(([key, spec]) => ({
458
+ domain: key,
459
+ label: spec.label,
460
+ cli: spec.cli,
461
+ action: spec.action,
462
+ permission: spec.permission,
463
+ defaultOn: spec.blocked ? '禁止' : spec.gated ? `需 ${spec.gate}` : spec.defaultOn ? '是' : '否',
464
+ mask: spec.mask,
465
+ }));
466
+ }
467
+
468
+ export { CliError };
package/lib/ai/log.mjs ADDED
@@ -0,0 +1,53 @@
1
+ /**
2
+ * `wkgeo ai` 的本地日志(**只记元信息,绝不记 prompt / 回答正文**)。
3
+ *
4
+ * 为什么还要记日志:老板要能回答"这周本地模型跑了几次、多慢、哪个模型",
5
+ * 但站点数据一旦写进日志就等于在磁盘上留了一份没脱敏的副本 —— 所以只记:
6
+ * `{ts, cmd, model, ms, promptChars, outputChars, truncated, redactedFields, ok}`
7
+ *
8
+ * 文件:`~/.wkongai/logs/ai-YYYYMMDD.jsonl`(与凭据同目录,`WKONGAI_HOME` 可改)。
9
+ */
10
+
11
+ import fs from 'node:fs';
12
+ import path from 'node:path';
13
+
14
+ /** `20261026` 形式的日期戳(本地时区,跟用户看到的"今天"一致) */
15
+ export function dateStamp(date = new Date()) {
16
+ const y = date.getFullYear();
17
+ const m = String(date.getMonth() + 1).padStart(2, '0');
18
+ const d = String(date.getDate()).padStart(2, '0');
19
+ return `${y}${m}${d}`;
20
+ }
21
+
22
+ /**
23
+ * 日志文件路径。`siteStateFile` 是 CLI 的 `~/.wkongai/config.json`,日志放它旁边的 `logs/`。
24
+ * @param {string} siteStateFile
25
+ * @param {Date} [now]
26
+ */
27
+ export function aiLogFile(siteStateFile, now = new Date()) {
28
+ const dir = path.dirname(String(siteStateFile || ''));
29
+ const home = dir && dir !== '.' ? dir : path.join(process.env.HOME || process.env.USERPROFILE || '.', '.wkongai');
30
+ return path.join(home, 'logs', `ai-${dateStamp(now)}.jsonl`);
31
+ }
32
+
33
+ /**
34
+ * 造一个 logger。**写失败绝不影响命令**(日志是附属品,不能因为它把 `ai ask` 弄失败)。
35
+ *
36
+ * @param {object} opts
37
+ * @param {string} [opts.file] 日志文件(默认见 `aiLogFile`)
38
+ * @param {Function} [opts.now] 时钟注入(单测)
39
+ */
40
+ export function createAiLogger({ file, now = () => new Date() } = {}) {
41
+ const target = file || '';
42
+ function log(entry = {}) {
43
+ if (!target) return;
44
+ try {
45
+ fs.mkdirSync(path.dirname(target), { recursive: true });
46
+ const line = JSON.stringify({ ts: now().toISOString(), ...entry });
47
+ fs.appendFileSync(target, `${line}\n`, 'utf8');
48
+ } catch {
49
+ /* 日志写不进去就算了:命令本身已经成功/失败,别在这里再抛 */
50
+ }
51
+ }
52
+ return { file: target, log };
53
+ }