huhaa-myskills 0.3.4 → 0.3.5

package/bin/huhaa-myskills.mjs

@@ -385,6 +385,23 @@ async function cmdStart() {
   await ensureConfigOrInit();
   const isForeground = process.argv.includes('--foreground') || process.argv.includes('-f');
   const preferred = parseInt(process.env.PORT || '11520', 10);
+
+  // 后台模式下先做幂等检查：已有实例在运行则直接返回，
+  // 避免 pickPort 误判端口被占用而打印"改用其它端口"的误导信息。
+  if (!isForeground) {
+    try {
+      const stateData = JSON.parse(fs.readFileSync(stateFile(), 'utf8'));
+      if (stateData.pid && isProcessRunning(stateData.pid)) {
+        const logFile = path.join(homeDir(), 'huhaa.log');
+        console.log(`✓ HuHaa-MySkills 已在运行: http://localhost:${stateData.port}`);
+        console.log(`📝 日志: ${logFile}`);
+        return;
+      }
+    } catch {
+      // 状态文件不存在或无效，继续正常启动流程
+    }
+  }
+
   const port = await pickPort(preferred, 10);
   if (!port) {
     console.error(`[start] ${preferred}..${preferred + 10} 范围内无空闲端口，已中止。`);

package/docs/Frontend-Spec.md

@@ -1134,6 +1134,53 @@ HuHaa-MySkills/
 
 ---
 
+## VI.7 发布流程（npm 发布，唯一权威方式）
+
+**发布完全由 GitHub Actions 自动完成，本地不执行 `npm publish`。**
+
+### 触发方式
+
+```bash
+# 1. 在 main 分支 bump 版本号并推送（脚本已封装）
+npm run release          # = npm version patch && git push
+
+# 2. 推送到 main 后，.github/workflows/release.yml 自动：
+#    读 package.json 版本 → 若远程无对应 tag → 构建 → npm publish → 打 tag → 建 GitHub Release
+```
+
+### 关键设计（release.yml）
+
+- **触发条件**：`push` 到 `main` 分支（不是 tag 触发）
+- **幂等**：先检查远程是否已存在 `v<version>` tag，存在则整体跳过，重复推送 main 不会重复发布
+- **顺序**：`npm publish` 成功 **之后** 才创建 tag。publish 失败不会遗留僵尸 tag，修复后重推即可重试
+- **发布说明**：`generate_release_notes: true` 自动生成，不依赖 CHANGELOG.md
+
+### 凭证配置（NPM_TOKEN，一次性）
+
+发布身份由 GitHub 仓库 Secret `NPM_TOKEN` 提供，对应 npm 账号 `huhaaonline`（包 owner）。
+
+```bash
+# token 失效/轮换时，用有 publish 权限的 Automation token 更新 secret：
+gh secret set NPM_TOKEN --body '<npm token>'
+
+# 验证 token 有效且身份正确：
+printf '//registry.npmjs.org/:_authToken=%s\n' '<token>' > /tmp/v.npmrc
+npm whoami --userconfig /tmp/v.npmrc      # 应输出 huhaaonline
+rm -f /tmp/v.npmrc
+```
+
+**故障对照**：CI 中 `npm publish` 报 `E404 PUT .../huhaa-myskills` = token 已注入但身份无该包写权限（npm 用 404 伪装 403），即 `NPM_TOKEN` 失效或非 owner，需按上面重配。
+
+### 发布后验证
+
+```bash
+gh run watch                                    # CI 全绿
+npm view huhaa-myskills version                 # 应为新版本
+npm install -g huhaa-myskills@latest && huhaa-myskills -v
+```
+
+---
+
 # 七、相关资源
 
 - **[Vite 官方文档](https://vite.dev)**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "huhaa-myskills",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "private": false,
   "description": "Local skill / plugin / MCP aggregation hub. Browse all your AI agent skills at http://localhost:11520.",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "init": "node bin/huhaa-myskills.mjs init",
     "purge": "node bin/huhaa-myskills.mjs purge",
     "uninstall": "node bin/huhaa-myskills.mjs uninstall",
-    "dev": "cd packages/web && npm run dev",
+    "dev": "node bin/huhaa-myskills.mjs start && cd packages/web && npm run dev",
     "dev-bg": "bash scripts/start-dev.sh",
     "sync": "node bin/huhaa-myskills.mjs sync",
     "build:web": "node build/build-web.mjs",

package/packages/server/test/server.test.mjs

@@ -6,6 +6,11 @@ import test from 'node:test';
 
 import { startServer } from '../src/index.mjs';
 
+// 动态读取根 package.json 的版本号，避免每次升版本导致断言失效
+const PKG_VERSION = JSON.parse(
+  fs.readFileSync(new URL('../../../package.json', import.meta.url), 'utf8')
+).version;
+
 function makeTempHome() {
   const root = fs.mkdtempSync(path.join(os.tmpdir(), 'huhaa-server-test-'));
   const home = path.join(root, 'home');
@@ -54,7 +59,7 @@ test('server exposes health, list, detail, stats, and reload state without raw i
     ok: true,
     port: 0,
     items: 1,
-    version: '0.3.2',
+    version: PKG_VERSION,
     phase: 'P6',
   });