@fgbg/mdocs 0.8.24 → 0.8.25
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
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
面向个人开发者与小团队：产品内 **智能助手 + 帮写**，外部 **CLI / Skills** 接入 Cursor / Claude；SQLite + 本地文件，**无账户**即可协作。
|
|
6
6
|
|
|
7
|
-
[文档站点](https://xuhuafeifei.github.io/mdocs-site/) · [GitHub](https://github.com/xuhuafeifei/mdocs) · [npm `@fgbg/mdocs`](https://www.npmjs.com/package/@fgbg/mdocs) · 当前版本 **0.8.
|
|
7
|
+
[文档站点](https://xuhuafeifei.github.io/mdocs-site/) · [GitHub](https://github.com/xuhuafeifei/mdocs) · [npm `@fgbg/mdocs`](https://www.npmjs.com/package/@fgbg/mdocs) · 当前版本 **0.8.25**
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
10
10
|
<img src="image/site主页.png" alt="mdocs 文档站点首页" width="860" />
|
|
@@ -1,13 +1,17 @@
|
|
|
1
1
|
---
|
|
2
2
|
id: changelog
|
|
3
3
|
name: "更新日志"
|
|
4
|
-
description: "-
|
|
4
|
+
description: "- **`mdocs update` 抗缓存**：查最新版本与 `npm pack` 使用临时空 `--cache`，不再被本机 `~/.npm` 里旧的 packument 钉死（`--prefer-online` 仍可能读到缓存）"
|
|
5
5
|
keywords: []
|
|
6
6
|
source: changelog.md
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# 更新日志
|
|
10
10
|
|
|
11
|
+
## v0.8.25
|
|
12
|
+
|
|
13
|
+
- **`mdocs update` 抗缓存**：查最新版本与 `npm pack` 使用临时空 `--cache`，不再被本机 `~/.npm` 里旧的 packument 钉死（`--prefer-online` 仍可能读到缓存）
|
|
14
|
+
|
|
11
15
|
## v0.8.24
|
|
12
16
|
|
|
13
17
|
- **手机正文顶满**：窄屏文档左右留白改为约 5px（PC 仍为 50px）
|
package/agent-skills/index.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
{
|
|
3
3
|
"id": "changelog",
|
|
4
4
|
"name": "更新日志",
|
|
5
|
-
"description": "-
|
|
5
|
+
"description": "- **`mdocs update` 抗缓存**：查最新版本与 `npm pack` 使用临时空 `--cache`，不再被本机 `~/.npm` 里旧的 packument 钉死（`--prefer-online` 仍可能读到缓存）",
|
|
6
6
|
"keywords": [],
|
|
7
7
|
"source": "changelog.md"
|
|
8
8
|
},
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* 全局安装原地升级：淘宝 npmmirror 拉最新包，保留 node_modules，npm --prefer-offline 补差量。
|
|
3
|
+
*
|
|
4
|
+
* 查版本 / pack 必须绕开本机 npm cache：`--prefer-online` 仍可能命中旧 packument，
|
|
5
|
+
* 因此这两步使用临时空 `--cache` 目录。
|
|
3
6
|
*/
|
|
4
7
|
import { spawnSync } from "node:child_process";
|
|
5
8
|
import fs from "node:fs";
|
|
@@ -51,42 +54,57 @@ function npm(args, cwd) {
|
|
|
51
54
|
stderr: (r.stderr ?? "").trim(),
|
|
52
55
|
};
|
|
53
56
|
}
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
`--registry=${MDOCS_UPDATE_REGISTRY}`,
|
|
60
|
-
// 避免本机 npm cache 把 latest 钉在旧版（镜像已同步仍报「已是最新」）
|
|
61
|
-
"--prefer-online",
|
|
62
|
-
"--fetch-retries=2",
|
|
63
|
-
]);
|
|
64
|
-
if (r.status !== 0 || !r.stdout) {
|
|
65
|
-
fail(`无法从 ${MDOCS_UPDATE_REGISTRY} 查询版本：${r.stderr || r.stdout || "empty"}`);
|
|
57
|
+
/** 空 cache 目录：避免全局 ~/.npm 把 latest 钉在旧版 */
|
|
58
|
+
function withFreshNpmCache(fn) {
|
|
59
|
+
const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "mdocs-npm-cache-"));
|
|
60
|
+
try {
|
|
61
|
+
return fn(cacheDir);
|
|
66
62
|
}
|
|
67
|
-
|
|
63
|
+
finally {
|
|
64
|
+
fs.rmSync(cacheDir, { recursive: true, force: true });
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
function fetchLatestVersion() {
|
|
68
|
+
return withFreshNpmCache((cacheDir) => {
|
|
69
|
+
const r = npm([
|
|
70
|
+
"view",
|
|
71
|
+
MDOCS_UPDATE_PACKAGE,
|
|
72
|
+
"version",
|
|
73
|
+
`--registry=${MDOCS_UPDATE_REGISTRY}`,
|
|
74
|
+
`--cache=${cacheDir}`,
|
|
75
|
+
"--prefer-online",
|
|
76
|
+
"--fetch-retries=2",
|
|
77
|
+
]);
|
|
78
|
+
if (r.status !== 0 || !r.stdout) {
|
|
79
|
+
fail(`无法从 ${MDOCS_UPDATE_REGISTRY} 查询版本：${r.stderr || r.stdout || "empty"}`);
|
|
80
|
+
}
|
|
81
|
+
return r.stdout.split("\n").pop().trim();
|
|
82
|
+
});
|
|
68
83
|
}
|
|
69
84
|
function packTo(destDir, version) {
|
|
70
85
|
fs.mkdirSync(destDir, { recursive: true });
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
86
|
+
return withFreshNpmCache((cacheDir) => {
|
|
87
|
+
const r = npm([
|
|
88
|
+
"pack",
|
|
89
|
+
`${MDOCS_UPDATE_PACKAGE}@${version}`,
|
|
90
|
+
`--registry=${MDOCS_UPDATE_REGISTRY}`,
|
|
91
|
+
`--pack-destination=${destDir}`,
|
|
92
|
+
`--cache=${cacheDir}`,
|
|
93
|
+
"--prefer-online",
|
|
94
|
+
], destDir);
|
|
95
|
+
if (r.status !== 0) {
|
|
96
|
+
fail(`npm pack 失败：${r.stderr || r.stdout}`);
|
|
97
|
+
}
|
|
98
|
+
const lines = r.stdout.split("\n").map((l) => l.trim()).filter(Boolean);
|
|
99
|
+
const tgzName = lines[lines.length - 1];
|
|
100
|
+
if (!tgzName?.endsWith(".tgz")) {
|
|
101
|
+
fail(`npm pack 未产出 tgz：${r.stdout}`);
|
|
102
|
+
}
|
|
103
|
+
const tgzPath = path.isAbsolute(tgzName) ? tgzName : path.join(destDir, tgzName);
|
|
104
|
+
if (!fs.existsSync(tgzPath))
|
|
105
|
+
fail(`找不到 pack 产物 ${tgzPath}`);
|
|
106
|
+
return tgzPath;
|
|
107
|
+
});
|
|
90
108
|
}
|
|
91
109
|
/** 保留 node_modules，其余用新包覆盖 */
|
|
92
110
|
function overlayPackage(pkgRoot, extractedPackageDir) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../../../src/server/cli/self-update.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../../../src/server/cli/self-update.ts"],"names":[],"mappings":"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"}
|