@code2rich/jpage 1.5.0 → 1.5.1

package/skills/jpage-presentation/assets/themes/creative.css

@@ -0,0 +1,81 @@
+/**
+ * jpage-presentation · 创意主题 (creative)
+ * 高饱和渐变 + 几何无衬线，适合产品发布、创意提案、活动 keynote。
+ */
+:root {
+  --r-background-color: #0f0e17;
+  --r-main-font: "Inter", -apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", sans-serif;
+  --r-main-color: #fffffe;
+  --r-heading-font: "Inter", -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;
+  --r-heading-color: #fffffe;
+  --r-heading-text-transform: none;
+  --r-heading-font-weight: 800;
+  --r-heading-letter-spacing: -0.02em;
+  --r-link-color: #ff8906;
+  --r-link-color-hover: #f25f4c;
+  --r-selection-background-color: #e53170;
+  --r-selection-color: #fff;
+  --r-code-font: "JetBrains Mono", "SF Mono", Menlo, monospace;
+  --r-section-number-color: #ff8906;
+}
+
+.reveal {
+  font-size: 32px;
+  font-weight: 400;
+  background: linear-gradient(135deg, #0f0e17 0%, #1a1830 50%, #232946 100%);
+  background-attachment: fixed;
+}
+.reveal h1, .reveal h2, .reveal h3, .reveal h4 {
+  letter-spacing: -0.02em;
+}
+.reveal h1 {
+  font-size: 2.4em;
+  background: linear-gradient(90deg, #ff8906, #e53170);
+  -webkit-background-clip: text;
+  background-clip: text;
+  -webkit-text-fill-color: transparent;
+}
+.reveal h2 { font-size: 1.7em; color: #ff8906; }
+.reveal h3 { font-size: 1.2em; color: #e53170; }
+.reveal .slides section.cover h1 {
+  font-size: 3em;
+}
+.reveal .slides section.cover .subtitle {
+  color: #a7a9be;
+  font-size: 0.85em;
+  margin-top: 0.5em;
+}
+.reveal .slides section.divider {
+  text-align: center;
+}
+.reveal .slides section.divider h2 {
+  font-size: 2.2em;
+  background: linear-gradient(90deg, #ff8906, #e53170);
+  -webkit-background-clip: text;
+  background-clip: text;
+  -webkit-text-fill-color: transparent;
+}
+.reveal ul li::marker { color: #ff8906; }
+.reveal ol li::marker { color: #e53170; font-weight: 700; }
+.reveal strong { color: #ff8906; }
+.reveal em { color: #e53170; }
+.reveal blockquote {
+  border-left: 4px solid #e53170;
+  background: rgba(229, 49, 112, 0.1);
+  color: #fffffe;
+  padding: 0.5em 1em;
+  border-radius: 0 8px 8px 0;
+}
+.reveal pre {
+  background: rgba(255, 255, 255, 0.05);
+  border: 1px solid rgba(255, 137, 6, 0.3);
+  font-size: 0.55em;
+  border-radius: 8px;
+}
+.reveal code { color: #ff8906; }
+.reveal a { text-decoration: underline; text-decoration-color: #e53170; }
+.reveal table th {
+  background: rgba(229, 49, 112, 0.2);
+  border-bottom: 2px solid #e53170;
+}
+.reveal table td { border-bottom: 1px solid rgba(255, 255, 255, 0.1); }

package/skills/jpage-presentation/assets/themes/minimal.css

@@ -0,0 +1,117 @@
+/**
+ * jpage-presentation · 极简主题 (minimal)
+ * 黑白 + 一个强调色 + 大字号留白，keynote/苹果风，适合极简主义、产品哲学分享。
+ */
+:root {
+  --r-background-color: #ffffff;
+  --r-main-font: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
+  --r-main-color: #1d1d1f;
+  --r-heading-font: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
+  --r-heading-color: #1d1d1f;
+  --r-heading-text-transform: none;
+  --r-heading-font-weight: 600;
+  --r-heading-letter-spacing: -0.03em;
+  --r-link-color: #0071e3;
+  --r-link-color-hover: #0058b9;
+  --r-selection-background-color: #0071e3;
+  --r-selection-color: #fff;
+  --r-code-font: "SF Mono", Menlo, Consolas, monospace;
+  --r-section-number-color: #86868b;
+}
+
+.reveal {
+  font-size: 34px;
+  font-weight: 400;
+  letter-spacing: -0.01em;
+}
+.reveal h1, .reveal h2, .reveal h3, .reveal h4 {
+  letter-spacing: -0.03em;
+}
+.reveal h1 { font-size: 2.6em; font-weight: 700; }
+.reveal h2 { font-size: 1.8em; font-weight: 600; }
+.reveal h3 { font-size: 1.25em; font-weight: 600; }
+.reveal .slides section {
+  text-align: left;
+  padding: 0 0.5em;
+}
+.reveal .slides section.cover {
+  text-align: center;
+}
+.reveal .slides section.cover h1 {
+  font-size: 3.2em;
+  font-weight: 700;
+  margin-bottom: 0.2em;
+}
+.reveal .slides section.cover .subtitle {
+  color: #86868b;
+  font-size: 0.8em;
+  font-weight: 400;
+}
+.reveal .slides section.divider {
+  text-align: center;
+}
+.reveal .slides section.divider h2 {
+  font-size: 2.4em;
+  font-weight: 700;
+}
+.reveal ul, .reveal ol {
+  margin-left: 0;
+  list-style: none;
+}
+.reveal ul li {
+  position: relative;
+  padding-left: 1.2em;
+  margin-bottom: 0.5em;
+}
+.reveal ul li::before {
+  content: "";
+  position: absolute;
+  left: 0;
+  top: 0.55em;
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: #0071e3;
+}
+.reveal ol { counter-reset: item; }
+.reveal ol li {
+  counter-increment: item;
+  padding-left: 1.8em;
+  position: relative;
+  margin-bottom: 0.5em;
+}
+.reveal ol li::before {
+  content: counter(item, decimal-leading-zero);
+  position: absolute;
+  left: 0;
+  color: #0071e3;
+  font-weight: 600;
+  font-size: 0.8em;
+  top: 0.15em;
+}
+.reveal strong { color: #0071e3; font-weight: 600; }
+.reveal blockquote {
+  border-left: none;
+  font-size: 1.2em;
+  font-weight: 300;
+  color: #1d1d1f;
+  text-align: center;
+  padding: 0;
+  width: 100%;
+}
+.reveal pre {
+  background: #f5f5f7;
+  border: none;
+  border-radius: 12px;
+  font-size: 0.5em;
+  padding: 1em 1.2em;
+}
+.reveal code { color: #1d1d1f; }
+.reveal table { font-size: 0.65em; border-collapse: collapse; }
+.reveal th, .reveal td {
+  border: none;
+  border-bottom: 1px solid #d2d2d7;
+  padding: 0.6em 0.8em;
+}
+.reveal th { color: #86868b; font-weight: 600; font-size: 0.85em; }
+.reveal .progress { color: #0071e3; }

package/skills-registry.js

@@ -53,12 +53,6 @@ function parseFrontmatter(text) {
   return { meta, body: m[2] };
 }
 
-function dirSize(root) {
-  let total = 0;
-  for (const f of walkFiles(root)) total += f.size;
-  return total;
-}
-
 function readSkillMeta(skillName) {
   const skillRoot = path.join(SKILLS_DIR, skillName);
   if (!fs.existsSync(skillRoot) || !fs.statSync(skillRoot).isDirectory()) return null;

package/test/dispatch-bench.js

@@ -8,7 +8,6 @@ process.env.ADMIN_USER = 'admin';
 process.env.ADMIN_PASSWORD = 'testpassword123';
 process.env.MCP_TOKEN = 'bench-mcp-token';
 
-const path = require('path');
 const fs = require('fs');
 // 清理临时目录
 fs.rmSync(process.env.JPAGE_DATA_DIR, { recursive: true, force: true });
@@ -22,7 +21,6 @@ const express = require('express');
 async function main() {
   const app = express();
   app.use(express.json());
-  let calls = 0;
   // 模拟 requireAuth：解析 Bearer token（模拟一次 DB 查询的延迟 ~真实场景）
   app.use((req, res, next) => {
     // 模拟鉴权开销（DB token 查询）：真实场景约 0.3-0.8ms，这里用同步 CPU 占用近似
@@ -30,7 +28,6 @@ async function main() {
     next();
   });
   app.get('/api/files', (req, res) => {
-    calls++;
     res.json({ files: [{ id: 1, name: 'a' }, { id: 2, name: 'b' }], pagination: { total: 2 } });
   });
 

package/test/integration/cli.test.js

@@ -308,3 +308,96 @@ test('CLI: --help 打印帮助', async () => {
   assert.match(s.out(), /jpage —— 即页命令行/);
   assert.match(s.out(), /upload/);
 });
+
+// --- update ---
+// update 纯本地操作（npm 自更新），不调后端 API，用注入的 npmExec 假执行器，
+// 避免测试真的跑 npm。默认让 view 返回一个比当前版本更高的版本号。
+function makeFakeNpmExec(calls, { latestVersion } = {}) {
+  const current = require('../../package.json').version;
+  const latest = latestVersion !== undefined ? latestVersion : bumpVersion(current);
+  return (args) => {
+    calls.push(args);
+    if (args[0] === 'view') return latest + '\n';
+    return ''; // install 不输出
+  };
+}
+
+// 给 x.y.z 的 patch 位 +1，造一个"比当前新"的版本号（保证不等）。
+function bumpVersion(v) {
+  const [a, b, c] = v.split('.').map(Number);
+  return `${a}.${b}.${c + 1}`;
+}
+
+test('CLI update: 发现新版本 → 自动更新', async () => {
+  const s = makeSinks();
+  const calls = [];
+  await run(['update'], ctx(s, {
+    env: {}, cwd: os.tmpdir(), npmExec: makeFakeNpmExec(calls),
+  }));
+  assert.strictEqual(s.code(), 0);
+  assert.match(s.out(), /发现新版本/);
+  assert.match(s.out(), /已更新/);
+  // 第二次调用是 install，应含 -g 和 @latest
+  const installCall = calls.find((a) => a[0] === 'install');
+  assert.ok(installCall, '应触发 npm install');
+  assert.ok(installCall.includes('-g'), '应全局安装');
+  assert.ok(installCall.includes('@code2rich/jpage@latest'), '应装 latest');
+});
+
+test('CLI update: --check 只查不更新', async () => {
+  const s = makeSinks();
+  const calls = [];
+  await run(['update', '--check'], ctx(s, {
+    env: {}, cwd: os.tmpdir(), npmExec: makeFakeNpmExec(calls),
+  }));
+  assert.strictEqual(s.code(), 0);
+  assert.match(s.out(), /发现新版本/);
+  assert.doesNotMatch(s.out(), /已更新/);
+  // 只应有一次 view，不应有 install
+  assert.ok(calls.find((a) => a[0] === 'view'), '应查版本');
+  assert.ok(!calls.find((a) => a[0] === 'install'), '--check 不应触发 install');
+});
+
+test('CLI update: 已是最新版', async () => {
+  const s = makeSinks();
+  const calls = [];
+  const current = require('../../package.json').version;
+  await run(['update'], ctx(s, {
+    env: {}, cwd: os.tmpdir(), npmExec: makeFakeNpmExec(calls, { latestVersion: current }),
+  }));
+  assert.strictEqual(s.code(), 0);
+  assert.match(s.out(), /已是最新版/);
+  assert.ok(!calls.find((a) => a[0] === 'install'), '无需 install');
+});
+
+test('CLI update: --registry 透传给 npm', async () => {
+  const s = makeSinks();
+  const calls = [];
+  await run(['update', '--check', '--registry', 'https://registry.npmmirror.com'], ctx(s, {
+    env: {}, cwd: os.tmpdir(), npmExec: makeFakeNpmExec(calls),
+  }));
+  const viewCall = calls.find((a) => a[0] === 'view');
+  assert.ok(viewCall.includes('--registry'), 'view 应带 --registry');
+  assert.ok(viewCall.includes('https://registry.npmmirror.com'), 'registry 值应透传');
+});
+
+test('CLI update: --registry 缺值 → UsageError 退出 2', async () => {
+  const s = makeSinks();
+  const calls = [];
+  await run(['update', '--registry'], ctx(s, {
+    env: {}, cwd: os.tmpdir(), npmExec: makeFakeNpmExec(calls),
+  }));
+  assert.strictEqual(s.code(), 2);
+  assert.match(s.err(), /用法/);
+});
+
+test('CLI update: 不需要 token（无 token 也能跑）', async () => {
+  const s = makeSinks();
+  const calls = [];
+  // 故意不传 token、cwd 指向 /tmp（排除 .env 的 MCP_TOKEN）
+  await run(['update', '--check'], ctx(s, {
+    env: {}, cwd: os.tmpdir(), npmExec: makeFakeNpmExec(calls),
+  }));
+  assert.strictEqual(s.code(), 0);
+  assert.doesNotMatch(s.err(), /token/);
+});

package/test/integration/skills.test.js

@@ -1,5 +1,5 @@
-// Skills 集成测试：列表 / 详情 / 下载 zip / mcp/config 结构。全部 requireAuth。
-// 挂载点 /api（/skills、/skills/:name、/skills/:name/download、/mcp/config）。
+// Skills 集成测试：列表 / 详情 / 下载 zip / mcp/config 结构 / cli 指南。全部 requireAuth。
+// 挂载点 /api（/skills、/skills/:name、/skills/:name/download、/mcp/config、/cli/guide）。
 // 依赖仓库内 skills/jpage-upload/SKILL.md（内置 skill）。
 const test = require('node:test');
 const assert = require('node:assert');
@@ -85,20 +85,42 @@ test('GET /api/mcp/config → 200，含 config.mcpServers.jpage', async () => {
   assert.ok(Array.isArray(res.body.tokens));
 });
 
-test('GET /api/mcp/config → 200，含多客户端 configs 数组', async () => {
+test('GET /api/mcp/config → 200，含多客户端 configs 数组（仅 MCP 客户端）', async () => {
   const res = await agent.get('/api/mcp/config');
   assert.strictEqual(res.status, 200);
   assert.ok(Array.isArray(res.body.configs));
-  // 5 个客户端：claude-code / claude-desktop / cursor / zcode / generic
+  // 5 项：全部为 MCP 客户端（CLI 走独立的 /api/cli/guide，不再混入此处）
   assert.strictEqual(res.body.configs.length, 5);
   const ids = res.body.configs.map(c => c.id);
   for (const id of ['claude-code', 'claude-desktop', 'cursor', 'zcode', 'generic']) {
     assert.ok(ids.includes(id), `configs 应包含 ${id}`);
   }
-  // 每项含 label / path / config.mcpServers.jpage
+  // CLI 不应再出现在 MCP 配置里
+  assert.ok(!ids.includes('cli'), 'configs 不应再包含 cli（已独立为 /api/cli/guide）');
+  // 每项含 label / path
   res.body.configs.forEach(c => {
     assert.ok(c.label, `${c.id} 应有 label`);
     assert.ok('path' in c, `${c.id} 应有 path`);
+  });
+  // 每项都是 MCP 客户端，config.mcpServers.jpage 必有
+  res.body.configs.forEach(c => {
     assert.ok(c.config && c.config.mcpServers && c.config.mcpServers.jpage, `${c.id} config 应含 mcpServers.jpage`);
   });
 });
+
+test('GET /api/cli/guide → 200，返回 CLI 用法指南（与 MCP 并列的独立入口）', async () => {
+  const res = await agent.get('/api/cli/guide');
+  assert.strictEqual(res.status, 200);
+  assert.strictEqual(res.body.enabled, true);
+  assert.ok(typeof res.body.baseUrl === 'string' && res.body.baseUrl.length > 0, 'baseUrl 应为非空');
+  assert.ok(typeof res.body.guideHtml === 'string' && res.body.guideHtml.length > 0, 'guideHtml 应为非空 HTML');
+  assert.ok(res.body.guideHtml.includes('jpage'), 'guideHtml 应含 jpage 说明');
+  assert.ok(typeof res.body.guideText === 'string' && res.body.guideText.length > 0, 'guideText 应为非空文档');
+  // guideText 里 baseUrl 应已被替换为实际服务地址（不含 <baseUrl> 占位）
+  assert.ok(!res.body.guideText.includes('<baseUrl>'), 'guideText 不应残留 baseUrl 占位符');
+});
+
+test('未登录 GET /api/cli/guide → 401', async () => {
+  const res = await request(env.app).get('/api/cli/guide');
+  assert.strictEqual(res.status, 401);
+});

package/test/perf-harness.js

@@ -2,7 +2,6 @@
 // 用法: node test/perf-harness.js [PORT]
 // 退出码 0 = 全部通过, 非 0 = 有失败
 const http = require('http');
-const crypto = require('crypto');
 
 const PORT = parseInt(process.argv[2] || process.env.PORT || '8890', 10);
 const HOST = '127.0.0.1';
@@ -40,14 +39,6 @@ function req(method, path, { body, headers = {}, raw, formData } = {}) {
 }
 
 // 多部分表单：单字段 file
-function multipart(boundary, field) {
-  const CRLF = '\r\n';
-  const pre = `--${boundary}${CRLF}Content-Disposition: form-data; name="file"; filename="${field.filename}"${CRLF}Content-Type: ${field.type || 'text/markdown'}${CRLF}${CRLF}`;
-  const post = `${CRLF}--${boundary}--${CRLF}`;
-  const body = Buffer.concat([Buffer.from(pre, 'utf8'), Buffer.from(field.content, 'utf8'), Buffer.from(post, 'utf8')]);
-  return { body, headers: { 'Content-Type': `multipart/form-data; boundary=${boundary}` } };
-}
-
 async function run() {
   console.log(`\n=== jpage 验证套件 (port ${PORT}) ===\n`);
 

package/test/unit/fts.test.js

@@ -1,7 +1,6 @@
 // lib/fts.js 单元测试
 const test = require('node:test');
 const assert = require('node:assert');
-const path = require('path');
 const { escapeFtsQuery, isFtsIndexable } = require('../../lib/fts');
 
 test('isFtsIndexable：可索引扩展名', () => {

package/.claude/settings.local.json

@@ -1,68 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(docker-compose up *)",
-      "Bash(docker compose up *)",
-      "Bash(lsof -ti:8858)",
-      "Bash(xargs kill -9)",
-      "Bash(ssh *)",
-      "Bash(docker compose ps *)",
-      "Bash(git add *)",
-      "Bash(git commit -m ' *)",
-      "Bash(git push *)",
-      "Bash(systemctl list-units *)",
-      "Bash(/snap/bin/docker ps *)",
-      "Bash(snap run *)",
-      "Bash(docker network *)",
-      "Bash(curl -s -o /dev/null -w \"HTTP %{http_code} in %{time_total}s\\\\n\" http://127.0.0.1:8858/ --max-time 5)",
-      "Bash(curl -s http://127.0.0.1:8858/ --max-time 5)",
-      "Bash(pm2 list *)",
-      "Bash(DOCKER_HOST=unix:///var/run/docker.sock docker ps -a --format '{{.ID}} {{.Names}} {{.Status}}')",
-      "Bash(tmux ls *)",
-      "Bash(screen -ls)",
-      "Bash(systemctl is-active *)",
-      "Read(//app/**)",
-      "Bash(set -e)",
-      "Bash(useradd -m -s /bin/bash jpage)",
-      "Bash(chpasswd)",
-      "Read(//home/**)",
-      "Bash(getent passwd *)",
-      "Bash(python3 *)",
-      "Bash(mkdir -p /home/jpage/jpage)",
-      "Bash(rsync -a /root/prod/jpage/ /home/jpage/jpage/)",
-      "Bash(sed -i -E 's/^[[:space:]]+//; s/[[:space:]]+#.*$//' /home/jpage/jpage/.env)",
-      "Bash(grep -nE '\\\\$' /home/jpage/jpage/.env)",
-      "Bash(sed -E 's/\\(ADMIN_PASSWORD|SESSION_SECRET|MCP_TOKEN|SMTP_PASS\\)=.*/\\\\1=<SECRET>/' /home/jpage/jpage/.env)",
-      "Bash(git commit *)",
-      "Bash(git config *)",
-      "Bash(git ls-remote *)",
-      "Bash(echo \"exit=$?\")",
-      "Bash(git remote *)",
-      "Bash(git *)",
-      "Bash(npm run *)",
-      "Bash(npm start *)",
-      "Bash(npm install *)",
-      "Bash(curl -s http://localhost:8858/)",
-      "Bash(curl -s -o /dev/null -w 'GET / -> %{http_code}  \\(%{size_download} bytes, %{time_total}s\\)\\\\n' http://localhost:8858/)",
-      "Bash(curl -s -o /dev/null -w 'GET /api/auth/me -> %{http_code}\\\\n' http://localhost:8858/api/auth/me)",
-      "Bash(curl -s -o /dev/null -w 'GET /dist/app-DVM5JB4N.js -> %{http_code}\\\\n' http://localhost:8858/dist/app-DVM5JB4N.js)",
-      "Bash(curl -s -o /dev/null -w 'GET /dist/style-360db6ef.css -> %{http_code}\\\\n' http://localhost:8858/dist/style-360db6ef.css)",
-      "Bash(curl -s -o /dev/null -w 'GET /dist/app-HVUECAAZ.js -> %{http_code}\\\\n' http://localhost:8858/dist/app-HVUECAAZ.js)",
-      "Bash(curl -sS -m 4 -o /dev/null -w \"HTTP: %{http_code}\\\\n\" http://127.0.0.1:8858/)",
-      "Bash(ps -eo pid,etime,comm,args)",
-      "Bash(awk '$3==\"node\"')",
-      "Bash(bash -n .env)",
-      "Bash(curl -sS -m 5 -o /dev/null -w \"HTTP %{http_code}\\\\n\" http://127.0.0.1:8858/)",
-      "Bash(curl -sS -m 5 -o /dev/null -w \"HTTP %{http_code}\\\\n\" http://127.0.0.1:8858/api/auth/me)",
-      "Bash(curl -sS -m 5 http://127.0.0.1:8858/api/auth/registration-status)",
-      "Bash(ps -eo pid,ppid,etime,comm,args)",
-      "Bash(awk '$4==\"node\" && /server\\\\.js/')",
-      "Read(//tmp/**)",
-      "Bash(xargs -I{} echo \"警告出现次数: {}（应为 0）\")"
-    ]
-  },
-  "enableAllProjectMcpServers": true,
-  "enabledMcpjsonServers": [
-    "task-master-ai"
-  ]
-}