@microi.net/cli 5.6.2 → 5.6.3

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 (40) hide show
  1. package/.codebuddy-plugin/marketplace.json +2 -2
  2. package/.codebuddy-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +2 -2
  4. package/.workbuddy-plugin/marketplace.json +2 -2
  5. package/.workbuddy-plugin/plugin.json +1 -1
  6. package/README.md +2 -2
  7. package/assets/build-meta.json +7 -6
  8. package/assets/feature-matrix.json +138 -129
  9. package/cordis.patch.yml +2 -2
  10. package/package.json +1 -1
  11. package/scripts/mcp-server.js +2 -2
  12. package/scripts/microi-cli.js +34 -34
  13. package/scripts/microi-skills.meta.json +217 -217
  14. package/skills/.microi-skills-version.json +3 -3
  15. package/skills/.progressive-disclosure-manifest.json +58 -58
  16. package/skills/app-store/SKILL.md +6 -0
  17. package/skills/email-engine/SKILL.md +3 -2
  18. package/skills/job-engine/SKILL.md +10 -3
  19. package/skills/microi-client-frontend/SKILL.md +5 -2
  20. package/skills/microi-codex/SKILL.md +57 -48
  21. package/skills/microi-codex-installer/SKILL.md +12 -3
  22. package/skills/microi-deployment/SKILL.md +2 -0
  23. package/skills/microi-form-engine/SKILL.md +2 -0
  24. package/skills/playwright-e2e/SKILL.md +8 -8
  25. package/skills/playwright-e2e/references/progressive-01-/345/205/250/350/207/252/345/212/250/347/231/273/345/275/225-/345/205/215/351/252/214/350/257/201/347/240/201-/344/275/206/344/270/215/345/205/215/345/257/206/347/240/201-/345/277/205/350/257/273.md +3 -3
  26. package/skills/playwright-e2e/references/progressive-02-/346/226/207/345/255/227/345/257/271/346/257/224/345/272/246/344/270/216/345/217/257/350/257/273/346/200/247/350/207/252/345/212/250/345/214/226/346/243/200/346/237/245-/345/277/205/345/201/232.md +2 -2
  27. package/skills/playwright-e2e/references/progressive-03-microi-helper-/346/250/241/346/235/277.md +3 -3
  28. package/skills/playwright-e2e/references/progressive-04-ci-/345/273/272/350/256/256.md +3 -3
  29. package/skills/system-observability/SKILL.md +62 -8
  30. package/skills/v8-explorer-tree/SKILL.md +228 -226
  31. package/skills/v8-file-upload/SKILL.md +18 -1
  32. package/skills/v8-file-upload/references/progressive-01-/345/205/254/346/234/211/346/241/266-vs-/347/247/201/346/234/211/346/241/266.md +1 -1
  33. package/skills/v8-file-upload/references/progressive-02-office-/346/226/207/344/273/266/345/234/250/347/272/277/347/274/226/350/276/221/347/211/210/346/234/254/345/217/267/350/247/204/345/210/231.md +3 -3
  34. package/skills/v8-sql-query/SKILL.md +141 -133
  35. package/skills/v8-tcp-integration/SKILL.md +2 -2
  36. package/skills/v8-workflow/SKILL.md +12 -4
  37. package/skills/workspace-conventions/SKILL.md +8 -6
  38. package/skills/workspace-conventions/references/progressive-01-/347/211/210/346/234/254/346/233/264/346/226/260/346/227/245/345/277/227/344/277/235/346/212/244/350/247/204/345/210/231-/345/274/272/345/210/266.md +6 -6
  39. package/skills/workspace-conventions/references/progressive-02-microi-net-api-/346/234/254/345/234/260/345/220/257/345/212/250/347/272/246/345/256/232.md +21 -21
  40. package/skills/workspace-conventions/references/progressive-03-cli-/344/270/216-ide-/346/217/222/344/273/266/351/224/231/347/211/210/345/205/261/345/255/230/347/272/246/345/256/232.md +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": 1,
3
- "generatedAt": "2026-09-10T05:27:45.745Z",
3
+ "generatedAt": "2026-09-13T06:14:49.229Z",
4
4
  "policy": {
5
5
  "maxEntryLines": 285,
6
6
  "referenceBudgetLines": 245,
@@ -169,11 +169,11 @@
169
169
  ]
170
170
  },
171
171
  "microi-client-frontend": {
172
- "originalSha256": "2e1ec87d7b959340805edf023e3a8ef9b1ddec4a9c74344475731bb66c2c9fa3",
173
- "originalLines": 678,
172
+ "originalSha256": "341cd39dbe7904e65bc9b37362c7e22da9fc6f66093cea74a2399f12e5ce4291",
173
+ "originalLines": 681,
174
174
  "prefixSha256": "87ada6841f976552d9f5b88477fa91a92e4cd9cd040a8a725267d9fa2e4635c2",
175
175
  "prefixBytes": 782,
176
- "entryLines": 220,
176
+ "entryLines": 223,
177
177
  "chunks": [
178
178
  {
179
179
  "id": "microi-client-frontend-000",
@@ -211,8 +211,8 @@
211
211
  "id": "microi-client-frontend-004",
212
212
  "ordinal": 7,
213
213
  "destination": "microi-client-frontend/SKILL.md",
214
- "sha256": "53d475c7c494a5b6e9e2436c986c458ee539807426978fd99a27a1d7eb967881",
215
- "lines": 37,
214
+ "sha256": "174028eca01dc0987236803041ab5ac1bf18705a6609a4ba640df0c553533c1e",
215
+ "lines": 40,
216
216
  "heading": "7. 验证建议"
217
217
  },
218
218
  {
@@ -1344,9 +1344,9 @@
1344
1344
  ]
1345
1345
  },
1346
1346
  "playwright-e2e": {
1347
- "originalSha256": "ba0d85ed668e479a307f5e7dbd0f040bf8a8bdad2903fafdbabea3c7fea45662",
1347
+ "originalSha256": "1ee0cf4fcc016a832c2284c8a4026cf6b1e28723dc6493312027ae9baa35368d",
1348
1348
  "originalLines": 806,
1349
- "prefixSha256": "4a1dca656797241fbd27b7b6c8022f01ff40229394928f3418ad0b8263da11f7",
1349
+ "prefixSha256": "591796768f9d5287450d844d149c6be25e915801fc01b57a7aa80af3c2efe440",
1350
1350
  "prefixBytes": 1777,
1351
1351
  "entryLines": 198,
1352
1352
  "chunks": [
@@ -1370,7 +1370,7 @@
1370
1370
  "id": "playwright-e2e-002",
1371
1371
  "ordinal": 2,
1372
1372
  "destination": "playwright-e2e/SKILL.md",
1373
- "sha256": "a2524636727c51268a2daefdd617e5b90e105e245143b652bc095ac857ad4995",
1373
+ "sha256": "639b5a0f2a7ced30cf682c71b260cbdeac2628bd939a33ea372e6834b7990874",
1374
1374
  "lines": 19,
1375
1375
  "heading": "临时文件与产物放置规则(必须遵守)"
1376
1376
  },
@@ -1386,7 +1386,7 @@
1386
1386
  "id": "playwright-e2e-004",
1387
1387
  "ordinal": 4,
1388
1388
  "destination": "playwright-e2e/SKILL.md",
1389
- "sha256": "2f145cd29044043fb84cefd07fde14c86a4d0f4757443d56e75f5494516453cb",
1389
+ "sha256": "4f5e11baf4651c11b5f9819a0b4f33ce2590db1733d4db72814bd1a25daf56ff",
1390
1390
  "lines": 21,
1391
1391
  "heading": "必备环境变量"
1392
1392
  },
@@ -1394,7 +1394,7 @@
1394
1394
  "id": "playwright-e2e-005",
1395
1395
  "ordinal": 5,
1396
1396
  "destination": "playwright-e2e/SKILL.md",
1397
- "sha256": "a66696c3263f060d0b7be309a527fca6a9bad95dd534eabbe84f1b6539770d8e",
1397
+ "sha256": "51567cea5fca434f9b031fef0871454100cf4715dfb65695dc1722bd275399be",
1398
1398
  "lines": 24,
1399
1399
  "heading": "本地测试账号自动发现"
1400
1400
  },
@@ -1402,7 +1402,7 @@
1402
1402
  "id": "playwright-e2e-006",
1403
1403
  "ordinal": 6,
1404
1404
  "destination": "playwright-e2e/SKILL.md",
1405
- "sha256": "6aeefebda3a9e598564c53c2f8028a4ccefe2291c4c7c7ae4781ca15fb5d0697",
1405
+ "sha256": "88e1002cae934acd2de5af2f77f371a9ea152a525eecf11b49fe182b16a56044",
1406
1406
  "lines": 12,
1407
1407
  "heading": "后端改动后的 E2E 前置动作"
1408
1408
  },
@@ -1410,7 +1410,7 @@
1410
1410
  "id": "playwright-e2e-007",
1411
1411
  "ordinal": 8,
1412
1412
  "destination": "playwright-e2e/SKILL.md",
1413
- "sha256": "8776ce89491f11cbf6c6e6e9ef0cd430aa21efc60c1dbe1559ec9e905c5d0a9e",
1413
+ "sha256": "73298ff43e319b3e1a86a7d369c284595383f5d0b1e5fbc7e0d483d8fd68003a",
1414
1414
  "lines": 42,
1415
1415
  "heading": "服务自启动纪律(必做)"
1416
1416
  },
@@ -1418,7 +1418,7 @@
1418
1418
  "id": "playwright-e2e-008",
1419
1419
  "ordinal": 7,
1420
1420
  "destination": "playwright-e2e/references/progressive-01-全自动登录-免验证码-但不免密码-必读.md",
1421
- "sha256": "353b1e7ec1d3e93d1fac92c8e9d6e520bf77b628a4141524a09404814f7affb7",
1421
+ "sha256": "cd1cc086cbbabd4083f7037e64b4f1951b284f70392e6fc5d729b322a161c39d",
1422
1422
  "lines": 63,
1423
1423
  "heading": "全自动登录(免验证码,但不免密码)——必读"
1424
1424
  },
@@ -1426,7 +1426,7 @@
1426
1426
  "id": "playwright-e2e-009",
1427
1427
  "ordinal": 9,
1428
1428
  "destination": "playwright-e2e/references/progressive-01-全自动登录-免验证码-但不免密码-必读.md",
1429
- "sha256": "f864be2aee2ce2490d2a8e241e5852fbd0777590f771397fd3c7973017889ae7",
1429
+ "sha256": "bd153761389635cb99ac6d3e2809f1e49ca78926176a05ad555dc83702837790",
1430
1430
  "lines": 54,
1431
1431
  "heading": "表单引擎卡死/递归更新全自动化诊断"
1432
1432
  },
@@ -1450,7 +1450,7 @@
1450
1450
  "id": "playwright-e2e-012",
1451
1451
  "ordinal": 12,
1452
1452
  "destination": "playwright-e2e/references/progressive-01-全自动登录-免验证码-但不免密码-必读.md",
1453
- "sha256": "1fcd0a28af8226af4f1e4608645c74bf2fe503ce195f05ffd115c590fafabd06",
1453
+ "sha256": "a6ed859419114f601d611534e3d07bbfce0055ea6b7809daea9200da962391b6",
1454
1454
  "lines": 25,
1455
1455
  "heading": "移动端/H5 回归纪律"
1456
1456
  },
@@ -1466,7 +1466,7 @@
1466
1466
  "id": "playwright-e2e-014",
1467
1467
  "ordinal": 14,
1468
1468
  "destination": "playwright-e2e/references/progressive-02-文字对比度与可读性自动化检查-必做.md",
1469
- "sha256": "e5858cce6f743573d699ed7d2d07f958d15be96c28028a91163e841f6d3c016a",
1469
+ "sha256": "3eea01cf70e67d545fede1724b049ed852da60cf0a4ea0bda6b2e1d6de84400d",
1470
1470
  "lines": 49,
1471
1471
  "heading": "安装"
1472
1472
  },
@@ -1474,7 +1474,7 @@
1474
1474
  "id": "playwright-e2e-015",
1475
1475
  "ordinal": 15,
1476
1476
  "destination": "playwright-e2e/references/progressive-02-文字对比度与可读性自动化检查-必做.md",
1477
- "sha256": "b9adf7af700e045fd919bdfde321b10df89660561dd8ab476a12cba310855875",
1477
+ "sha256": "9b937381fb4cda1a8a010c5a0f803d48861c9dbcf503774a4b1dba4c0d33985a",
1478
1478
  "lines": 58,
1479
1479
  "heading": "playwright.config.js 模板"
1480
1480
  },
@@ -1482,7 +1482,7 @@
1482
1482
  "id": "playwright-e2e-016",
1483
1483
  "ordinal": 16,
1484
1484
  "destination": "playwright-e2e/references/progressive-03-microi-helper-模板.md",
1485
- "sha256": "63d4ded296636335a96cbdd5a9ada0ec8b42ad9cc616b621c88bd6e45904f7fa",
1485
+ "sha256": "9fa2a956427cf2c1c6a6f37cc2c960e58ac09ab43aff037ab762d447eadf912a",
1486
1486
  "lines": 70,
1487
1487
  "heading": "Microi helper 模板"
1488
1488
  },
@@ -1514,7 +1514,7 @@
1514
1514
  "id": "playwright-e2e-020",
1515
1515
  "ordinal": 20,
1516
1516
  "destination": "playwright-e2e/references/progressive-03-microi-helper-模板.md",
1517
- "sha256": "3ae1a183eefdcdcbc5924d3205802eb7594da02074cadfbdfb85d88b2005f192",
1517
+ "sha256": "7c8cc732cd5d460b6bde2c7e151d55f51aa0f853995492946aedbe781da01a9a",
1518
1518
  "lines": 48,
1519
1519
  "heading": "完整业务验收门槛"
1520
1520
  },
@@ -1522,7 +1522,7 @@
1522
1522
  "id": "playwright-e2e-021",
1523
1523
  "ordinal": 21,
1524
1524
  "destination": "playwright-e2e/references/progressive-03-microi-helper-模板.md",
1525
- "sha256": "48af1507276053c301e489b5b261b92657ce79ed2045933d4a462d7c71eb96a8",
1525
+ "sha256": "50a36935911be6a6201c9406e89b5e8470b65d87f6d8cd0a57effedf146082b2",
1526
1526
  "lines": 9,
1527
1527
  "heading": "与 MCP 的配合"
1528
1528
  },
@@ -1546,7 +1546,7 @@
1546
1546
  "id": "playwright-e2e-024",
1547
1547
  "ordinal": 24,
1548
1548
  "destination": "playwright-e2e/references/progressive-04-ci-建议.md",
1549
- "sha256": "b939c97eef28fab71caa54d134ea524d7ed7c8381deec09e38a7d694b15f53c0",
1549
+ "sha256": "a2897a35d5fd0c4bd944fae8bf15e8d52648e916a5453d0bb6012574f97af12a",
1550
1550
  "lines": 61,
1551
1551
  "heading": "常见问题"
1552
1552
  },
@@ -1554,7 +1554,7 @@
1554
1554
  "id": "playwright-e2e-025",
1555
1555
  "ordinal": 25,
1556
1556
  "destination": "playwright-e2e/references/progressive-04-ci-建议.md",
1557
- "sha256": "be071153d695081b7c20d34cb5e9563480e3f09d9cd0292f2ca4b0245438787b",
1557
+ "sha256": "fb26231352e397437331ab5255b908ecaa100129bd365779dad7aaf944062584",
1558
1558
  "lines": 11,
1559
1559
  "heading": "前端微服务 E2E 必测点"
1560
1560
  },
@@ -1562,7 +1562,7 @@
1562
1562
  "id": "playwright-e2e-026",
1563
1563
  "ordinal": 26,
1564
1564
  "destination": "playwright-e2e/references/progressive-04-ci-建议.md",
1565
- "sha256": "3c8a1e8bbe281064f30f406703230d8df213f1f1e1d124edb8f9fc8a1df782ea",
1565
+ "sha256": "591700cfd4b78c63d7f69db5c5d4a5f57c48d85c8508112d2bccbaae06b24192",
1566
1566
  "lines": 10,
1567
1567
  "heading": "动态模块按钮验收"
1568
1568
  }
@@ -2221,11 +2221,11 @@
2221
2221
  ]
2222
2222
  },
2223
2223
  "v8-file-upload": {
2224
- "originalSha256": "acc9619e305fbb555253598d0904a2c3da5a71e4faf23941f18ee9cca2f343ae",
2225
- "originalLines": 574,
2226
- "prefixSha256": "796e8308ae21c36dde1b9268ae71ccb8c2afe9f393d7f9865b6648d2f7f0f22e",
2227
- "prefixBytes": 8923,
2228
- "entryLines": 229,
2224
+ "originalSha256": "23adfa4920e71ae3648a151a1f9691836665c3e5a9420d154e4bcdbdb4396926",
2225
+ "originalLines": 594,
2226
+ "prefixSha256": "9dfdf2f5b8d3b9f28c5e32276b0d6911fbd0470eb2115351f0e2179875608edd",
2227
+ "prefixBytes": 12461,
2228
+ "entryLines": 249,
2229
2229
  "chunks": [
2230
2230
  {
2231
2231
  "id": "v8-file-upload-000",
@@ -2247,7 +2247,7 @@
2247
2247
  "id": "v8-file-upload-002",
2248
2248
  "ordinal": 2,
2249
2249
  "destination": "v8-file-upload/SKILL.md",
2250
- "sha256": "ed7e727c51bd2416ae1f38cf3c4bd09491e616df08473a610372e0ca648e1298",
2250
+ "sha256": "d55c1a7fce715bf15224a74a2ae3006f38bab04bfe876ad88d9cc064fbe7cb9a",
2251
2251
  "lines": 101,
2252
2252
  "heading": "接收前端上传的文件"
2253
2253
  },
@@ -2271,7 +2271,7 @@
2271
2271
  "id": "v8-file-upload-005",
2272
2272
  "ordinal": 3,
2273
2273
  "destination": "v8-file-upload/references/progressive-01-公有桶-vs-私有桶.md",
2274
- "sha256": "b09a96f25aef20eb8cbb204bd785cce370dcd2c9a28563c6f6d720fbdaa5218f",
2274
+ "sha256": "9efd186d8af26854bbed4d675b31fff57202a0139094798d9a41c3e4769fd092",
2275
2275
  "lines": 150,
2276
2276
  "heading": "公有桶 vs 私有桶"
2277
2277
  },
@@ -2295,7 +2295,7 @@
2295
2295
  "id": "v8-file-upload-008",
2296
2296
  "ordinal": 8,
2297
2297
  "destination": "v8-file-upload/references/progressive-02-office-文件在线编辑版本号规则.md",
2298
- "sha256": "5e3b59486745d3c54bd8ad25c43cbe2396e6d614394340b93d93794b6df56292",
2298
+ "sha256": "7cda0fe7bb978e7219cb3c1ba30813e1a5e777f1272410f85d4c7ecc1882cc3d",
2299
2299
  "lines": 36,
2300
2300
  "heading": "Office 文件在线编辑版本号规则"
2301
2301
  },
@@ -2303,7 +2303,7 @@
2303
2303
  "id": "v8-file-upload-009",
2304
2304
  "ordinal": 9,
2305
2305
  "destination": "v8-file-upload/references/progressive-02-office-文件在线编辑版本号规则.md",
2306
- "sha256": "50fba71370f45de3dd677f5731f3956c328a8d3b1ca2125b853128067f9af40a",
2306
+ "sha256": "e01219d4f1a8f8c535e0b5aa5620120c37bd5e79af27dbbd63babda8d887cd13",
2307
2307
  "lines": 80,
2308
2308
  "heading": "ImgUpload / FileUpload 字段值兼容规则"
2309
2309
  },
@@ -2311,7 +2311,7 @@
2311
2311
  "id": "v8-file-upload-010",
2312
2312
  "ordinal": 10,
2313
2313
  "destination": "v8-file-upload/references/progressive-02-office-文件在线编辑版本号规则.md",
2314
- "sha256": "f34d476435c3a8321df017b481771d757f580c8d75f7648fdd54ee1c624d116c",
2314
+ "sha256": "229294a07a8db953219c35292db5558430addb576505695b9ce88a275eb46232",
2315
2315
  "lines": 26,
2316
2316
  "heading": "安全注意"
2317
2317
  }
@@ -3196,11 +3196,11 @@
3196
3196
  ]
3197
3197
  },
3198
3198
  "workspace-conventions": {
3199
- "originalSha256": "6be7d157a1e5cbdada7086e1385d80556059fc9ca38806e057b1eb7d23d99aff",
3200
- "originalLines": 592,
3199
+ "originalSha256": "c0277de2fba08cdf2d265855032e058e37431b5b80be89920de01373c228324a",
3200
+ "originalLines": 594,
3201
3201
  "prefixSha256": "b2c13c455cf052093f78881170151d3fb56c25cda2f837c9f6abc0c29e67fd30",
3202
3202
  "prefixBytes": 310,
3203
- "entryLines": 258,
3203
+ "entryLines": 262,
3204
3204
  "chunks": [
3205
3205
  {
3206
3206
  "id": "workspace-conventions-000",
@@ -3238,7 +3238,7 @@
3238
3238
  "id": "workspace-conventions-004",
3239
3239
  "ordinal": 4,
3240
3240
  "destination": "workspace-conventions/SKILL.md",
3241
- "sha256": "aec3b6a1666c1f57d8fb208eb29c3d3f91bef5d4d502ed08aee9040168a7e9ec",
3241
+ "sha256": "533d4a6d674f5980fdf6e9ae376b240af20e3191126a20eae3d6235897f45a88",
3242
3242
  "lines": 25,
3243
3243
  "heading": "临时文件与 AI 产物放置规则(强制)"
3244
3244
  },
@@ -3246,8 +3246,8 @@
3246
3246
  "id": "workspace-conventions-005",
3247
3247
  "ordinal": 5,
3248
3248
  "destination": "workspace-conventions/SKILL.md",
3249
- "sha256": "ac8e3c7085af4cbde3a5784f65ecb3f8cafa961a2a0e13f5103fa259852773e7",
3250
- "lines": 30,
3249
+ "sha256": "c48d857c8e3086b29f99ab14d362f99c60d7dd00f9617709ea4f4dcad370611e",
3250
+ "lines": 32,
3251
3251
  "heading": "Microi 源码路径速查(工作区根相对路径)"
3252
3252
  },
3253
3253
  {
@@ -3366,7 +3366,7 @@
3366
3366
  "id": "workspace-conventions-020",
3367
3367
  "ordinal": 20,
3368
3368
  "destination": "workspace-conventions/references/progressive-01-版本更新日志保护规则-强制.md",
3369
- "sha256": "4d3aef6042f7e43be7c2bf61430ce461bfb75bfb853b1ca000b0f5c5836eff7f",
3369
+ "sha256": "64ab3dbde08488e8cf9f320bf74d97c938507170723022efeb6ab4f96380f9ca",
3370
3370
  "lines": 11,
3371
3371
  "heading": "VS Code 插件空目录生成规则"
3372
3372
  },
@@ -3374,7 +3374,7 @@
3374
3374
  "id": "workspace-conventions-021",
3375
3375
  "ordinal": 21,
3376
3376
  "destination": "workspace-conventions/references/progressive-01-版本更新日志保护规则-强制.md",
3377
- "sha256": "d6da1a47b1f8ed4b1ea863b052c5e1fa7767e2809c39abe4813ea000d9a30db6",
3377
+ "sha256": "cee19f2fffffce3b4bcd9347a50ecf27add4be0c919e1cf5d00df98d487d29b8",
3378
3378
  "lines": 11,
3379
3379
  "heading": "Microi 版本号规则"
3380
3380
  },
@@ -3390,7 +3390,7 @@
3390
3390
  "id": "workspace-conventions-023",
3391
3391
  "ordinal": 23,
3392
3392
  "destination": "workspace-conventions/references/progressive-01-版本更新日志保护规则-强制.md",
3393
- "sha256": "3ebfed66fbaabf345188326688f195186d6f33f72252e2ce19041b33a5eef403",
3393
+ "sha256": "1dfe4286cfee04571a3d24a32af15365b9da6abffe9acfd92a75539e6160f2bd",
3394
3394
  "lines": 20,
3395
3395
  "heading": "根目录保留文件说明"
3396
3396
  },
@@ -3398,7 +3398,7 @@
3398
3398
  "id": "workspace-conventions-024",
3399
3399
  "ordinal": 24,
3400
3400
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3401
- "sha256": "4e97c278d0a813e23c2c56b11aec8b157b2b100ed6f46ea07d45dbe9954ca5aa",
3401
+ "sha256": "be9b3561d67f0b5489ce4b9f8c8775b563707adb9b75214807bd9c4d4fe226d4",
3402
3402
  "lines": 17,
3403
3403
  "heading": "Microi.net.Api 本地启动约定"
3404
3404
  },
@@ -3406,7 +3406,7 @@
3406
3406
  "id": "workspace-conventions-025",
3407
3407
  "ordinal": 25,
3408
3408
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3409
- "sha256": "07c3d729c8f1e9a2bf93ff00937e5d6eae4602d346e4f9254b03a33211ac4848",
3409
+ "sha256": "f9b654a451871b2759c42dc0cfe532f41d71f1e57a7ebe566abe4b0eafec50a9",
3410
3410
  "lines": 31,
3411
3411
  "heading": "多 AI 对话共享本地服务与发布互斥(强制)"
3412
3412
  },
@@ -3414,7 +3414,7 @@
3414
3414
  "id": "workspace-conventions-026",
3415
3415
  "ordinal": 26,
3416
3416
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3417
- "sha256": "73207c0cfcc442a177c47c36503dd6145fc826e23e79df3913861f65d8d16df3",
3417
+ "sha256": "7886b082424673965ce27622424be52d392a3868ebedff8c949b5d8d5e6c4caa",
3418
3418
  "lines": 11,
3419
3419
  "heading": "本地租户与测试凭据读取约定"
3420
3420
  },
@@ -3422,7 +3422,7 @@
3422
3422
  "id": "workspace-conventions-027",
3423
3423
  "ordinal": 27,
3424
3424
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3425
- "sha256": "84988eac9cf7543a192b3e829b879afb7b35ef92798dc9ea69243f173a8ab674",
3425
+ "sha256": "5ab58f345dcff9caea31d07d7598792ddaa8a301f3527d4121a7548d32107df3",
3426
3426
  "lines": 5,
3427
3427
  "heading": "自动化登录约定"
3428
3428
  },
@@ -3430,7 +3430,7 @@
3430
3430
  "id": "workspace-conventions-028",
3431
3431
  "ordinal": 28,
3432
3432
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3433
- "sha256": "544ab4d52c661e65fb2b0364a3a2107815af366d719f0b1d1cde7b4837226458",
3433
+ "sha256": "5b3ff231c7fd6266c7cff45b48707bf9053da596eaf574fc0490fe6a6fe1fca6",
3434
3434
  "lines": 24,
3435
3435
  "heading": "V8 远端/本地同步收尾约定"
3436
3436
  },
@@ -3438,7 +3438,7 @@
3438
3438
  "id": "workspace-conventions-029",
3439
3439
  "ordinal": 29,
3440
3440
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3441
- "sha256": "e90e532f9448b67f98f28a68fd4ea45b79868cf25fc14c5283b9074e91559f27",
3441
+ "sha256": "d18db7dd385b3e691a2fdfce5cc7c32ea09f30beb6ebe19ea2193d2e98b8f7ac",
3442
3442
  "lines": 5,
3443
3443
  "heading": "V8 缓存刷新约定"
3444
3444
  },
@@ -3446,7 +3446,7 @@
3446
3446
  "id": "workspace-conventions-030",
3447
3447
  "ordinal": 30,
3448
3448
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3449
- "sha256": "c25d0aaffec64d8a66cda36acd9ec337eda99a4411fddb0e966e45247ba574de",
3449
+ "sha256": "cb93afa9d5cddef627d561b4b46c56715486ebad8be78dc13b72e1065ff89bb5",
3450
3450
  "lines": 9,
3451
3451
  "heading": "MCP 元数据更新验收约定"
3452
3452
  },
@@ -3454,7 +3454,7 @@
3454
3454
  "id": "workspace-conventions-031",
3455
3455
  "ordinal": 31,
3456
3456
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3457
- "sha256": "3c25a4f5f2571612f6b441e88f4865f916aab0aed3cfe5d06a3be51a736dde0f",
3457
+ "sha256": "51e7e4c9e28a6547613068b7758411b934c30c8d19ebfdf64569c079d05346ed",
3458
3458
  "lines": 15,
3459
3459
  "heading": "MCP 可用性排查约定"
3460
3460
  },
@@ -3462,7 +3462,7 @@
3462
3462
  "id": "workspace-conventions-032",
3463
3463
  "ordinal": 32,
3464
3464
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3465
- "sha256": "230c8683389d2b1ee4f5ba88dc4e51cb4dc4eb6a89b76a142b07f479ff5be1c8",
3465
+ "sha256": "147cbc7a3870a1bc41c6e0b5ec317cf27e0e99e51eb71a1c540ebffde9507f10",
3466
3466
  "lines": 15,
3467
3467
  "heading": "MCP 写入超时与降级约定"
3468
3468
  },
@@ -3470,7 +3470,7 @@
3470
3470
  "id": "workspace-conventions-033",
3471
3471
  "ordinal": 33,
3472
3472
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3473
- "sha256": "b642bb516a42b50e8b459e5237588e85d71c9715970779e155b88d7c0e8c6536",
3473
+ "sha256": "dfa4fbba6af537dfc5b4128f15652474dbbd492cdf8be1b4397cc293953b71f1",
3474
3474
  "lines": 10,
3475
3475
  "heading": "Codex MCP 单入口约定"
3476
3476
  },
@@ -3478,7 +3478,7 @@
3478
3478
  "id": "workspace-conventions-034",
3479
3479
  "ordinal": 34,
3480
3480
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3481
- "sha256": "6ffac2793dea9b1d5953d624103d7aea7800b12deaaf71b3b0f5e3cb5b39ac06",
3481
+ "sha256": "c47c938ab74b167fbaa6947adf58ac17d538b6736224132933328cd53b1283cc",
3482
3482
  "lines": 10,
3483
3483
  "heading": ".venv Python 环境说明"
3484
3484
  },
@@ -3486,7 +3486,7 @@
3486
3486
  "id": "workspace-conventions-035",
3487
3487
  "ordinal": 35,
3488
3488
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3489
- "sha256": "c114dffea6978f289601a8f71aa83a0466f3d934e96e45bb871af179d319a1e3",
3489
+ "sha256": "811550d457030f1571c957b9d38ed706610467752d03cc1498f52bb9a8656c17",
3490
3490
  "lines": 19,
3491
3491
  "heading": "后端代码改动后的重启验收"
3492
3492
  },
@@ -3494,7 +3494,7 @@
3494
3494
  "id": "workspace-conventions-036",
3495
3495
  "ordinal": 36,
3496
3496
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3497
- "sha256": "db96c39a15f4b5637ce37555797858320256dda22daf7ac5cdaae2a436fd214c",
3497
+ "sha256": "90694dd1a4df791de2965274c56791d4d06d131a91b472e8765dfc8a2f8f263a",
3498
3498
  "lines": 13,
3499
3499
  "heading": "MCP 可调用性诊断补充"
3500
3500
  },
@@ -3502,7 +3502,7 @@
3502
3502
  "id": "workspace-conventions-037",
3503
3503
  "ordinal": 37,
3504
3504
  "destination": "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md",
3505
- "sha256": "e8ddd5ad53787087f8e50a13618ee5626686cc72b0b21c1b12b0dc60ea515713",
3505
+ "sha256": "8906aca9ab0a621ffc8f50c4909e6a858543acd803e427880dbdf5932a52ec8f",
3506
3506
  "lines": 14,
3507
3507
  "heading": "Windows MCP 控制台闪窗复盘"
3508
3508
  },
@@ -3510,7 +3510,7 @@
3510
3510
  "id": "workspace-conventions-038",
3511
3511
  "ordinal": 38,
3512
3512
  "destination": "workspace-conventions/references/progressive-03-cli-与-ide-插件错版共存约定.md",
3513
- "sha256": "57098466d31d0636bf330fde545daff8cb8e4116ac6ea2efff8abc729fdcef77",
3513
+ "sha256": "0f36b907aab83c32be0403ce9152d1cf6ce3da23c31d6ec337643236212e77fb",
3514
3514
  "lines": 22,
3515
3515
  "heading": "CLI 与 IDE 插件错版共存约定"
3516
3516
  }
@@ -39,6 +39,12 @@ description: Microi 应用商城开发、打包、安装和升级规范。用于
39
39
 
40
40
  ## 包内容
41
41
 
42
+ ### 空库清理与开发期应用
43
+
44
+ 安装包应显式登记菜单、表、接口、工作流、任务和微服务的完整归属,供导出、升级和空库制作共同使用。开发期只发布运行资产而尚未制包时,不能假定商城选集已经覆盖新建业务表;应通过现有空库规则接口预览,逐项核对实际物理表、DIY元数据、菜单后代与接口Key。缺失时在责任清理器补充有限、明确的业务归属识别,保留平台核心白名单,读取失败停止制作。只生成SQL与在隔离临时库执行清理是不同动作,禁止在源主库执行脱敏SQL。
45
+
46
+ 清理业务应用时同时按StoreId移除其HDFS包索引,再删除商城主记录,保留平台包索引;历史库缺少索引表时兼容跳过。数据库清理不等于删除HDFS对象,禁止借制作空库清除正式已发布文件。
47
+
42
48
  旧布局字段的退役使用可选 `DiyFieldRetirements` 数组,声明 `TableName / Name / ExpectedComponent`,按需用 `ExpectedConfig` 限定组件路径。安装器只允许退役当前包声明表中的 `DevComponent / Divider / Tabs / CollapseGroup`;核心字段、仍在包内声明的字段或控件配置不匹配必须拒绝。先安装支持此协议的商城,再安装声明退役的业务包。退役只软删字段元数据并回读、刷新缓存,不删除物理列或业务数据;已经退役或尚未安装的字段重复执行不产生副作用。
43
49
 
44
50
  - Manifest:应用 Key、版本、兼容平台版本、依赖和资源清单。
@@ -43,8 +43,9 @@ description: 开发、安装和使用吾码邮箱系统 mci-email。用于 QQ、
43
43
 
44
44
  目录路径作为服务商的不透明值保存,不能自行翻译或改写。
45
45
  去重键必须包含账号、目录、UIDVALIDITY 和 UID;UIDVALIDITY 改变时只重建该目录缓存。
46
- 同步锁使用接口引擎分布式锁,检查点进入数据库;进程重启后继续执行。
47
- 邮件正文按需读取,默认阻止脚本、表单提交与外部图片;不能直接在宿主使用 `v-html`。
46
+ 同步锁使用接口引擎分布式锁,检查点进入数据库;进程重启后继续执行。
47
+ 每批状态核对和近期摘要刷新都要先比较缓存,只更新实际变化的字段;未变化的 100 封邮件不能逐封重写。查询仅投影需要比较的标记/摘要字段,不加载正文或附件。跳过无变化写入仍须推进 UID 游标,保留远端删除、软删除恢复和已发送副本关联,并用同步回归测试验证。
48
+ 邮件正文按需读取,默认阻止脚本、表单提交与外部图片;不能直接在宿主使用 `v-html`。
48
49
 
49
50
  ## MCP 使用
50
51
 
@@ -22,9 +22,16 @@ Quartz 管理能力包含查询、添加、更新、暂停、恢复、删除任
22
22
 
23
23
  任务通常调用稳定的 `ApiEngineKey`。接口引擎返回 `Code=1` 只表示本次执行成功,不代表调度系统可忽略重试与幂等。
24
24
 
25
- ## 多节点设计
26
-
27
- ### 新旧平台共库过渡:停用新版调度
25
+ ## 多节点设计
26
+
27
+ ### 运行时间刷新与配置版本分离
28
+
29
+ - Quartz 周期同步 `LastTime/NextTime` 是运行状态投影,不能调用通用 `UptFormData` 生成配置版本或数据日志;用户保存名称、Cron、代码等配置仍走原表单事件和版本链路。
30
+ - 只读取 Id、任务名和两个时间列;时间未变化时不写入。变化时由可信调度内核向同一租户主库执行固定两列参数化 CAS,匹配原时间、任务名、正常状态与未删除条件;并发/陈旧结果命中 0 行时不重放。
31
+ - 历史版本保留不自动删除。持续高 CPU 时核对 `mic_data_version` 实际物理索引,不以应用包已声明索引推断旧库已安装;用 MCP 回读 `(TableId,TableRowId,CreateTime)`,并比较 MySQL digest 两次采样的执行数、扫描行数与耗时差值。
32
+ - 此修复要求更新调度后端;既有 `platform-schedule-job`、任务元数据及 MCP 查询/保存协议保持兼容。验收覆盖两租户同名任务、两连接竞争、未变化、暂停/软删除/重命名后陈旧写入、主库选择和配置字段不变。
33
+
34
+ ### 新旧平台共库过渡:停用新版调度
28
35
 
29
36
  - 系统设置“开发配置”的 `DisableTaskScheduling`(停用任务调度)默认 `0`,缺字段、空值也按正常调度处理;只有已实现此能力的新版后端识别它。字段由“系统设置”应用和 SaaS 空库基础包交付,不写租户配置值,不逐条 Pause/修改任务状态。
30
37
  - 开启时在 Quartz 领取触发器、处理 Misfire 之前按租户过滤;领取后、真正触发前重新读取系统设置缓存。禁止仅在 `IJob.Execute`、Listener veto 或业务 V8 入口 return:共享 Quartz 可能已经推进 NextFireTime,造成旧版漏执行。
@@ -171,10 +171,13 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
171
171
  ---
172
172
 
173
173
  <!-- /microi-progressive:chunk -->
174
- <!-- microi-progressive:chunk id=microi-client-frontend-004 sha256=53d475c7c494a5b6e9e2436c986c458ee539807426978fd99a27a1d7eb967881 -->
174
+ <!-- microi-progressive:chunk id=microi-client-frontend-004 sha256=174028eca01dc0987236803041ab5ac1bf18705a6609a4ba640df0c553533c1e -->
175
175
  ## 7. 验证建议
176
176
 
177
- ### 本地 ApiBase 与 OsClient 解析(强制)
177
+ ### 本地 ApiBase 与 OsClient 解析(强制)
178
+
179
+ - 域名发现先于租户确定,固定 `platform-os-client-by-domain` 请求不能自动注入默认或缓存租户,也不能携带旧 Token;显式调用租户仍保持。没有 URL/index.html 租户时,每次冷启动重新发现域名,成功后更新缓存,失败立即停止,不写入 `iTdos` 继续请求配置。配置业务失败不是连接故障,健康检查成功不能触发循环重载;只有确认连接故障后的恢复才重载失败启动页。回归覆盖无缓存、错误缓存、显式租户及失败不重载,使用 `domain-tenant-bootstrap.spec.mjs`。
180
+ - 登录回跳使用 Vue Router 解析完整深链接后合并 query/hash;对象式 `push({path, query})` 的 query 会覆盖 path 中原有参数,不能直接传空对象导致记录 Id 丢失。使用 `login-deep-link-query.spec.mjs` 验证编号、编码参数、重复参数和锚点。
178
181
 
179
182
  - `app.use(router)` 会立即触发首个路由守卫。守卫中的 SSO、认证、菜单请求必须等待 `initApp()` 完成真实租户和系统配置初始化;初始化失败时取消导航并保留启动错误界面。释放初始化等待必须早于 `router.isReady()`,避免彼此等待;禁止将缓存尚未建立时的 `GetOsClient()` 默认值 `iTdos` 发给客户服务器。
180
183
 
@@ -1,48 +1,57 @@
1
- ---
2
- name: microi-codex
3
- description: 在 Codex 或 DeepSeek Harness 中完成 Microi吾码 VS Code 扩展的等价工作流,包括连接与登录、AI/MCP 初始化、V8/表单/模块/工作流同步、远程执行与诊断、性能测试、微应用、Playwright 和发布回读。用户提到吾码、Microi、V8引擎、Microi-V8-Engine 或要求使用吾码 AI 插件时使用。
4
- ---
5
-
6
- # Microi吾码 Codex / DeepSeek Harness Plugin
7
-
8
- 本插件与 `Microi.VSCode`、`@microi.net/cli` 共用配置、Token、MCP Server 和 Microi Skills。不要另写原生 HTTP、SQL 或第二套认证实现。
9
-
10
- 每次 Microi 对话先完整读取工作区 `microi.skills/workspace-conventions/SKILL.md`;工作区尚未初始化时读取本插件同级 `../workspace-conventions/SKILL.md`。按其中首部完成创始人身份识别及平台功能四项同步检查,再进入专项流程;完整规则只维护该基础入口,不复制到本路由。
11
-
12
- ## 非阻塞自动更新(强制)
13
-
14
- Codex Router 启动后会异步调用 bundled CLI 的 `microi update --background`。需要了解完整安装/诊断机制时读取同级 `microi-codex-installer/SKILL.md`;更新检查不得发生在用户工作之前,也不得让任务等待。
15
-
16
- 自动更新会从 npm 官方 registry 升级 CLI,更新 Codex/DeepSeek Harness 插件并重新初始化工作区 AI/MCP。当前 Router、DSH 会话和已经启动的 MCP 继续使用旧版本,不被杀死或强制重载;新版供后续新进程使用。自动更新失败、被占用或用户暂不重载时,只记录/提示并继续当前、正在进行和新建任务;不得要求升级授权,也不得把版本状态当作业务门禁。
17
-
18
- ## 先确认工作区连接
19
-
20
- 1. 调用 `microi_codex`,传 `{ "action": "profiles" }`。
21
- 2. 只有一个已登录连接时,后续可以省略 `profile`;存在多个连接时,始终传 `profiles` 返回的稳定 `name`。
22
- 3. 尚未初始化时,插件根目录是本文件向上两级;使用其中的 `scripts/microi-cli.js`:
23
- - `node <plugin-root>/scripts/microi-cli.js init --workspace <workspace>`
24
- - 多连接:`profile list|add|remove`
25
- - 登录:`auth login|status|logout --profile <name>`
26
- - 诊断:`doctor --json`
27
- 4. 登录会在真实终端中隐式输入密码;不要把密码写入命令、日志、Skill、MCP 参数或工作区文件。Token 继续写入 `Microi-V8-Engine/.microi-mcp-tokens.json`,并按 API、OsClient、Type、Network 四段身份隔离。
28
-
29
- ## 功能路由
30
-
31
- - 连接、登录、拉取、推送、差异和 AI 初始化:使用 bundled CLI 的 `profile`、`auth`、`pull`、`push`、`sync status`、`ai init`、`mcp init`、`doctor`。
32
- - 接口引擎、表单事件、模块、字段、工作流和数据库结构:先用 `action="list_tools"` / `describe_tool`,再调用对应原始 `microi_*` 工具。写工具必须保留确认口令、审计与回读。
33
- - 远程执行与调试:读取 `v8-debugging/SKILL.md`。Codex 用“获取源码 → 远程执行 → 定位堆栈/日志 → 最小补丁 → 再执行”的结构化循环代替 VS Code DAP 的可视化逐行面板;不得把未执行的源码检查称为真机调试成功。
34
- - 性能测试:读取 `performance-testing/SKILL.md`,限制并发并输出样本、P95/P99、错误率和停止条件。
35
- - 系统日志、内存吃满、OOM 与接口/V8 异常分配:读取 `system-observability/SKILL.md` 及其内存事故手册,使用专用 MCP 的 `Capabilities` → `Memory` → 事故历史/详情 → `Trace`,先查采集质量再归因。
36
- - 微应用:读取 `microi-microservice/SKILL.md`,使用 scaffold、source sync、stream publish 和发布回读原工具;本地构建前遵守内存保护。
37
- - Playwright:读取 `playwright-e2e/SKILL.md`,使用当前已登录浏览器或受控 Playwright;报告必须来自实际页面执行。
38
- - 其他领域:从本插件同级 Skills 里选择最小相关 Skill,并完整读取后执行。
39
-
40
- ## 同步与安全边界
41
-
42
- - `Microi-V8-Engine/.microi-config.json` 是三端连接配置事实源;未知字段必须保留。
43
- - CLI、VS Code、Codex 与 DeepSeek Harness 插件可以在同一工作区并存;各端必须复用同一配置/Token/MCP 协议,带版本写入实行较新 provider 优先,禁止旧入口回写降级。`doctor.coexistence` 未通过时准确报告兼容风险并后台修复,但不得因此停止无关工作。
44
- - 推送前先做远端差异检查。写请求超时只表示结果不确定,使用对应 get 工具短超时回读,禁止盲目重复创建或覆盖。
45
- - 配置和 Token 文件使用现有原子写与锁协议;不要手工拼接或清空用户已有 MCP 配置。
46
- - Codex Plugin 路由器只选择连接,业务行为必须继续走原 MCP bundle。
47
-
48
- 完整 VS Code 命令覆盖关系见插件根目录 `assets/feature-matrix.json`。
1
+ ---
2
+ name: microi-codex
3
+ description: 在 Microi Code、Codex 或 DeepSeek Harness 中完成 Microi吾码 VS Code 扩展的等价工作流,包括连接与登录、AI/MCP 初始化、V8/表单/模块/工作流同步、远程执行与诊断、性能测试、微应用、Playwright 和发布回读。用户提到吾码、Microi、V8引擎、Microi-V8-Engine 或要求使用吾码 AI 插件时使用。
4
+ ---
5
+
6
+ # Microi吾码 Codex / DeepSeek Harness Plugin
7
+
8
+ 本插件与 `Microi.Code`、`@microi.net/cli` 共用配置、Token、MCP Server 和 Microi Skills。不要另写原生 HTTP、SQL 或第二套认证实现。
9
+
10
+ 每次 Microi 对话先完整读取工作区 `microi.skills/workspace-conventions/SKILL.md`;工作区尚未初始化时读取本插件同级 `../workspace-conventions/SKILL.md`。按其中首部完成创始人身份识别及平台功能四项同步检查,再进入专项流程;完整规则只维护该基础入口,不复制到本路由。
11
+
12
+ ## Microi Code 桌面宿主
13
+
14
+ - Microi Code 是同仓独立桌面发行物,内置固定版本的 DeepSeek Harness SDK、Node.js、MCP / CLI / Skills;不是需要额外 Agent Token 的 CLI 别名。
15
+ - 官方 AI 登录只走桌面账号窗口,固定 `https://api.itdos.com`、`OsClient=iTdos`,使用当前用户的中转 Key 和额度。不要让用户把密码或 AI Key 写入对话、命令行、MCP 参数或模型配置。
16
+ - 业务连接在「服务器连接」中单独添加、登录;官方 AI 账号不授予业务租户权限。项目初始化和资源同步优先使用桌面「项目资源」;其余业务继续调用同源 MCP 的原工具。
17
+ - macOS 登录凭据通过桌面 Keychain/受限 IPC 管理;不要在 macOS 改跑当前只支持 Windows 凭据恢复的 `microi auth login`。不要手改 Token 文件。
18
+ - 桌面安装包中的 Harness、Node 和同源资产随桌面版本升级;不运行 npm 自更新去改写正在使用或已签名的安装目录。外部 Codex / WorkBuddy / CLI 的后台更新规则保持不变。
19
+ - 首次为浅色玻璃水纹,支持深色和自选主题色。停止或退出后的任务保留历史,当前 SDK 的跨进程历史仅供查看,需新建任务引用继续。
20
+
21
+ ## 非阻塞自动更新(强制)
22
+
23
+ Codex Router 启动后会异步调用 bundled CLI 的 `microi update --background`。需要了解完整安装/诊断机制时读取同级 `microi-codex-installer/SKILL.md`;更新检查不得发生在用户工作之前,也不得让任务等待。
24
+
25
+ 自动更新会从 npm 官方 registry 升级 CLI,更新 Codex/DeepSeek Harness 插件并重新初始化工作区 AI/MCP。当前 Router、DSH 会话和已经启动的 MCP 继续使用旧版本,不被杀死或强制重载;新版供后续新进程使用。自动更新失败、被占用或用户暂不重载时,只记录/提示并继续当前、正在进行和新建任务;不得要求升级授权,也不得把版本状态当作业务门禁。
26
+
27
+ ## 先确认工作区连接
28
+
29
+ 1. 调用 `microi_codex`,传 `{ "action": "profiles" }`。
30
+ 2. 只有一个已登录连接时,后续可以省略 `profile`;存在多个连接时,始终传 `profiles` 返回的稳定 `name`。
31
+ 3. 尚未初始化时,插件根目录是本文件向上两级;使用其中的 `scripts/microi-cli.js`:
32
+ - `node <plugin-root>/scripts/microi-cli.js init --workspace <workspace>`
33
+ - 多连接:`profile list|add|remove`
34
+ - 登录:`auth login|status|logout --profile <name>`
35
+ - 诊断:`doctor --json`
36
+ 4. 登录会在真实终端中隐式输入密码;不要把密码写入命令、日志、Skill、MCP 参数或工作区文件。Token 继续写入 `Microi-V8-Engine/.microi-mcp-tokens.json`,并按 API、OsClient、Type、Network 四段身份隔离。
37
+
38
+ ## 功能路由
39
+
40
+ - 连接、登录、拉取、推送、差异和 AI 初始化:使用 bundled CLI 的 `profile`、`auth`、`pull`、`push`、`sync status`、`ai init`、`mcp init`、`doctor`。
41
+ - 接口引擎、表单事件、模块、字段、工作流和数据库结构:先用 `action="list_tools"` / `describe_tool`,再调用对应原始 `microi_*` 工具。写工具必须保留确认口令、审计与回读。
42
+ - 远程执行与调试:读取 `v8-debugging/SKILL.md`。Codex 用“获取源码 → 远程执行 → 定位堆栈/日志 → 最小补丁 → 再执行”的结构化循环代替 VS Code DAP 的可视化逐行面板;不得把未执行的源码检查称为真机调试成功。
43
+ - 性能测试:读取 `performance-testing/SKILL.md`,限制并发并输出样本、P95/P99、错误率和停止条件。
44
+ - 系统日志、内存吃满、OOM 与接口/V8 异常分配:读取 `system-observability/SKILL.md` 及其内存事故手册,使用专用 MCP 的 `Capabilities` → `Memory` → 事故历史/详情 → `Trace`,先查采集质量再归因。
45
+ - 微应用:读取 `microi-microservice/SKILL.md`,使用 scaffold、source sync、stream publish 和发布回读原工具;本地构建前遵守内存保护。
46
+ - Playwright:读取 `playwright-e2e/SKILL.md`,使用当前已登录浏览器或受控 Playwright;报告必须来自实际页面执行。
47
+ - 其他领域:从本插件同级 Skills 里选择最小相关 Skill,并完整读取后执行。
48
+
49
+ ## 同步与安全边界
50
+
51
+ - `Microi-V8-Engine/.microi-config.json` 是三端连接配置事实源;未知字段必须保留。
52
+ - CLI、VS Code、Codex 与 DeepSeek Harness 插件可以在同一工作区并存;各端必须复用同一配置/Token/MCP 协议,带版本写入实行较新 provider 优先,禁止旧入口回写降级。`doctor.coexistence` 未通过时准确报告兼容风险并后台修复,但不得因此停止无关工作。
53
+ - 推送前先做远端差异检查。写请求超时只表示结果不确定,使用对应 get 工具短超时回读,禁止盲目重复创建或覆盖。
54
+ - 配置和 Token 文件使用现有原子写与锁协议;不要手工拼接或清空用户已有 MCP 配置。
55
+ - Codex Plugin 路由器只选择连接,业务行为必须继续走原 MCP bundle。
56
+
57
+ 完整 VS Code 命令覆盖关系见插件根目录 `assets/feature-matrix.json`。