@studyllm/resume-preview 3.1.0 → 3.2.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.
package/README.en.md CHANGED
@@ -15,7 +15,7 @@ MIT licensed, works with any MCP client.
15
15
  - 🔤 **Plain Text, Always** - Content is escaped; HTML tags and scripts in it are never interpreted
16
16
  - 🗂️ **Multiple Resumes** - One `resume_id` per resume, each with its own tab and its own slug
17
17
  - 💾 **Persistent Working Files** - Resumes are stored under `~/.config/resume-preview/resumes`
18
- - 🖥️ **Standalone Gallery** - `resume-preview --serve` opens a browser gallery of every stored resume, with search and delete
18
+ - 🖥️ **Standalone Resume Library** - `resume-preview --serve` opens a browser library of every stored resume, with search and delete
19
19
  - 🌍 **Two Independent Languages** - The page chrome follows the browser's language; the resume's own language is set per resume and decides the section headings and the exported document
20
20
  - 🔎 **Review Tools** - Zoom, pan and export straight from the preview page, with a live connection indicator and a "last updated" stamp
21
21
  - 🤖 **Built-in Skill** - The plugin ships a `resume` skill with the content model and wording guidance
@@ -33,11 +33,11 @@ The module and interface inventory lives in [`docs/api-list.md`](docs/api-list.m
33
33
 
34
34
  ## 🚀 Quick Start
35
35
 
36
- > **Release status**: the npm package `@studyllm/resume-preview` is **not published yet**
37
- > (`npm view @studyllm/resume-preview` returns 404), so neither `npm install -g @studyllm/resume-preview` nor the
38
- > plugin's `npx` launcher works at the moment. The GitHub repository
39
- > `studyllm/resume-preview` does exist — clone it, run `npm install && npm run build`, and wire it
40
- > up with the `.mcp.json` below.
36
+ > **Release status**: the npm package `@studyllm/resume-preview` is **published**.
37
+ > Install it globally with `npm install -g @studyllm/resume-preview`; the plugin's `npx`
38
+ > launcher is `npx -y @studyllm/resume-preview`. You can also clone the repository
39
+ > `studyllm/resume-preview`, run `npm install && npm run build`, and wire it up with
40
+ > the `.mcp.json` below.
41
41
 
42
42
  **Plugin install (recommended)**
43
43
 
@@ -225,7 +225,7 @@ With the `--serve` flag you can start the preview server without an AI agent:
225
225
  resume-preview --serve
226
226
  ```
227
227
 
228
- It opens the resume gallery in your browser with every resume rendered so far. The gallery shows each resume's last-updated time and file size, lets you **search by id**, and lets you **delete** the ones you no longer need.
228
+ It opens the resume library in your browser with every resume rendered so far. The library shows each resume's last-updated time and file size, lets you **search by id**, and lets you **delete** the ones you no longer need.
229
229
 
230
230
  ## 🛠️ Development
231
231
 
@@ -250,7 +250,7 @@ npm start
250
250
 
251
251
  **Where are resumes stored?** Under `~/.config/resume-preview/resumes/<slug>/` — the directory name is a slug derived from the `resume_id`, so a Chinese id such as `小王的简历` becomes something like `r-3f9a2b`.
252
252
 
253
- **Which languages are supported?** Two, and they are independent of each other. The **page chrome** — the gallery, the toolbar, the dialogs — follows the request: `?lang=en` wins, then the browser's `Accept-Language`, then `zh-CN`. The **resume itself** — the section headings and the exported document — follows the `locale` you pass to `resume_preview`, which is stored with the resume and defaults to `zh-CN`. The export language never depends on the browser, so the same resume always exports the same way.
253
+ **Which languages are supported?** Two, and they are independent of each other. The **page chrome** — the resume library, the toolbar, the dialogs — follows the request: `?lang=en` wins, then the browser's `Accept-Language`, then `zh-CN`. The **resume itself** — the section headings and the exported document — follows the `locale` you pass to `resume_preview`, which is stored with the resume and defaults to `zh-CN`. The export language never depends on the browser, so the same resume always exports the same way.
254
254
 
255
255
  **Can the content contain HTML?** No, and deliberately so. Every value is escaped and printed as text, so markup shows up literally instead of being interpreted. Write plain text — this is the largest XSS surface of the product and it stays closed.
256
256
 
package/README.md CHANGED
@@ -15,7 +15,7 @@ MIT 许可证,兼容任何 MCP 客户端。
15
15
  - 🔤 **始终是纯文本** - 内容被转义,里面的 HTML 标签和脚本永远不会被解释
16
16
  - 🗂️ **多份简历** - 每份简历一个 `resume_id`,各有各的标签页和 slug
17
17
  - 💾 **持久化的工作文件** - 简历存放在 `~/.config/resume-preview/resumes`
18
- - 🖥️ **独立画廊** - `resume-preview --serve` 打开浏览器画廊,列出所有已存简历,支持搜索和删除
18
+ - 🖥️ **独立简历库** - `resume-preview --serve` 打开浏览器简历库,列出所有已存简历,支持搜索和删除
19
19
  - 🌍 **两套彼此独立的语言** - 页面框架跟随浏览器语言;简历自身的语言按份设置,决定分节标题和导出的文档
20
20
  - 🔎 **审阅工具** - 在预览页里缩放、平移、导出,附带连接状态指示和"最后更新"时间戳
21
21
  - 🤖 **内置技能** - 插件自带 `resume` 技能,包含内容模型和措辞建议
@@ -33,10 +33,10 @@ MIT 许可证,兼容任何 MCP 客户端。
33
33
 
34
34
  ## 🚀 快速开始
35
35
 
36
- > **发布状态**:npm 包 `@studyllm/resume-preview` **尚未发布**(`npm view @studyllm/resume-preview` 返回 404),
37
- > 因此 `npm install -g @studyllm/resume-preview` 与插件的 `npx` 启动方式暂时都不可用。GitHub 仓库
38
- > `studyllm/resume-preview` 已创建,请克隆源码后执行 `npm install && npm run build`,
39
- > 再按下面的 `.mcp.json` 接入 MCP 客户端。
36
+ > **发布状态**:npm 包 `@studyllm/resume-preview` **已发布**。
37
+ > 全局安装:`npm install -g @studyllm/resume-preview`;插件的 `npx` 启动方式为
38
+ > `npx -y @studyllm/resume-preview`。也可克隆源码仓库 `studyllm/resume-preview` 后执行
39
+ > `npm install && npm run build`,再按下面的 `.mcp.json` 接入 MCP 客户端。
40
40
 
41
41
  **插件安装(推荐)**
42
42
 
@@ -224,7 +224,7 @@ gemini config mcp add resume-preview --command resume-preview
224
224
  resume-preview --serve
225
225
  ```
226
226
 
227
- 它会在浏览器里打开简历画廊,列出此前渲染过的所有简历。画廊会显示每份简历的最后更新时间和文件大小,可以**按 ID 搜索**,也能**删除**不再需要的。
227
+ 它会在浏览器里打开简历库,列出此前渲染过的所有简历。简历库会显示每份简历的最后更新时间和文件大小,可以**按 ID 搜索**,也能**删除**不再需要的。
228
228
 
229
229
  ## 🛠️ 开发
230
230
 
@@ -249,7 +249,7 @@ npm start
249
249
 
250
250
  **简历存放在哪里?** 在 `~/.config/resume-preview/resumes/<slug>/` 下 —— 目录名是由 `resume_id` 推导出的 slug,所以像 `小王的简历` 这样的中文 ID 会变成类似 `r-3f9a2b` 的东西。
251
251
 
252
- **支持哪些语言?** 两种,而且彼此独立。**页面框架** —— 画廊、工具栏、对话框 —— 跟随请求:`?lang=en` 优先,其次浏览器的 `Accept-Language`,最后 `zh-CN`。**简历本身** —— 分节标题和导出的文档 —— 跟随你传给 `resume_preview` 的 `locale`,它与简历一起存储,默认 `zh-CN`。导出语言永远不依赖浏览器,所以同一份简历每次导出都一样。
252
+ **支持哪些语言?** 两种,而且彼此独立。**页面框架** —— 简历库、工具栏、对话框 —— 跟随请求:`?lang=en` 优先,其次浏览器的 `Accept-Language`,最后 `zh-CN`。**简历本身** —— 分节标题和导出的文档 —— 跟随你传给 `resume_preview` 的 `locale`,它与简历一起存储,默认 `zh-CN`。导出语言永远不依赖浏览器,所以同一份简历每次导出都一样。
253
253
 
254
254
  **内容支持 HTML 吗?** 不支持,而且是刻意的。每个值都会被转义后按文本打印。写纯文本就好;内容里的标记会原样显示 —— 这是本产品最大的 XSS 面,它会一直关着。
255
255
 
@@ -4,7 +4,7 @@
4
4
  "htmlLang": "en"
5
5
  },
6
6
  "gallery": {
7
- "title": "Resume Gallery",
7
+ "title": "Resume Library",
8
8
  "subtitle": "Browse and open your resumes",
9
9
  "searchPlaceholder": "Search resumes by ID…",
10
10
  "loading": "Loading…",
@@ -18,9 +18,9 @@
18
18
  "deleteConfirm": "Are you sure you want to delete resume \"{id}\"?",
19
19
  "deleteFailed": "Failed to delete resume: {message}",
20
20
  "loadFailedTitle": "Failed to load resumes",
21
- "navGallery": "Gallery",
21
+ "navGallery": "Library",
22
22
  "footerText": "Resume Preview",
23
- "pageTitle": "Resume Gallery - Resume Preview"
23
+ "pageTitle": "Resume Library - Resume Preview"
24
24
  },
25
25
  "preview": {
26
26
  "statusLive": "Live Reload Active",
@@ -4,7 +4,7 @@
4
4
  "htmlLang": "zh-CN"
5
5
  },
6
6
  "gallery": {
7
- "title": "简历画廊",
7
+ "title": "简历库",
8
8
  "subtitle": "浏览并打开你的简历",
9
9
  "searchPlaceholder": "按 ID 搜索简历…",
10
10
  "loading": "加载中…",
@@ -18,9 +18,9 @@
18
18
  "deleteConfirm": "确定要删除简历「{id}」吗?",
19
19
  "deleteFailed": "删除失败:{message}",
20
20
  "loadFailedTitle": "简历列表加载失败",
21
- "navGallery": "画廊",
21
+ "navGallery": "简历库",
22
22
  "footerText": "简历预览",
23
- "pageTitle": "简历画廊 - 简历预览"
23
+ "pageTitle": "简历库 - 简历预览"
24
24
  },
25
25
  "preview": {
26
26
  "statusLive": "实时刷新已开启",
@@ -31,8 +31,11 @@ body {
31
31
  font-family: var(--resume-font);
32
32
  }
33
33
 
34
+ /* The standalone HTML export: the A4 sheet sits centered on a neutral desk,
35
+ so the page boundary is visible instead of blending into the white page. */
34
36
  body.resume-export {
35
- background: #ffffff;
37
+ background: #e6e6e6;
38
+ padding: 24px 16px;
36
39
  }
37
40
 
38
41
  /* ===== Preview viewport ===== */
@@ -67,9 +70,12 @@ body.resume-export {
67
70
  }
68
71
 
69
72
  body.resume-export .resume-page {
70
- padding: 0;
71
- margin: 0;
72
- box-shadow: none;
73
+ box-sizing: border-box;
74
+ width: 210mm;
75
+ max-width: 100%;
76
+ margin: 0 auto;
77
+ padding: 15mm;
78
+ box-shadow: 0 2px 14px rgba(0, 0, 0, 0.18);
73
79
  }
74
80
 
75
81
  .resume-header {
@@ -200,6 +206,23 @@ body.resume-export .resume-page {
200
206
  box-shadow: none;
201
207
  }
202
208
 
209
+ /* The standalone export carries its own screen chrome; printing it must
210
+ fall back to the plain page the PDF export produces — the @page rule
211
+ already supplies the margins. */
212
+ body.resume-export {
213
+ background: #ffffff;
214
+ padding: 0;
215
+ }
216
+
217
+ body.resume-export .resume-page {
218
+ box-sizing: content-box;
219
+ width: 180mm;
220
+ max-width: none;
221
+ margin: 0;
222
+ padding: 0;
223
+ box-shadow: none;
224
+ }
225
+
203
226
  body {
204
227
  background: #ffffff;
205
228
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@studyllm/resume-preview",
3
- "version": "3.1.0",
3
+ "version": "3.2.0",
4
4
  "description": "MCP server for previewing and exporting resumes in Claude Code",
5
5
  "main": "build/index.js",
6
6
  "type": "module",