@quecue/dev-notify 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 更新记录
 
+## 0.1.1 — 2026-11-03
+
+### 新增
+
+- 新增 `dev-notify update`：检查 npm 最新版本，确认后调用 npm 全局安装；`--check` 只检查不安装，`--yes` 跳过确认。实际的完整性校验、registry 配置和原生依赖解析仍由 npm 完成。
+
 ## 0.1.0 — 2026-11-03
 
 ### 改进

package/README.md

@@ -2,7 +2,7 @@
 
 跨平台开发任务通知工具，使用 **TypeScript / Node.js**，通过 npm 分发，不需要独立可执行文件或其他脚本运行时。通用通知不依赖 Claude Code、Unity 或项目目录。
 
-**npm 包名为 `@quecue/dev-notify`。`0.1.0` 提供 Claude Code 回复、原生 PC 与 Telegram 双端答题及结果反馈。** 版本变更与升级说明见 [CHANGELOG.md](CHANGELOG.md)；公开版本以 npm registry 为准。
+**npm 包名为 `@quecue/dev-notify`。`0.1.1` 提供 Claude Code 回复、原生 PC 与 Telegram 双端答题及结果反馈。** 版本变更与升级说明见 [CHANGELOG.md](CHANGELOG.md)；公开版本以 npm registry 为准。
 
 ## 安装与使用
 
@@ -40,6 +40,16 @@ node dist/cli.js send --title "分段预览" --content-file result.txt --dry-run
 
 正式包的安装、升级和卸载由 npm 负责。**卸载前建议先清理凭据**：npm 卸载不会自动删除用户凭据。请先交互执行 `dev-notify credentials clear`，再卸载。该命令只删除当前配置引用的 Node 凭据，不会动其他账号、其他配置或旧版原型凭据。
 
+已安装的版本可以用 `update` 升级；它只负责检查版本并调用 npm，不会自己下载或替换文件：
+
+```sh
+dev-notify update           # 检查并在确认后运行 npm install -g
+dev-notify update --check   # 只检查，不安装
+dev-notify update --yes     # 跳过确认（适合脚本）
+```
+
+实际的完整性校验、registry 配置、权限处理和原生依赖解析仍由 npm 完成。更新后请重新运行 `dev-notify integration claude-code install`；如使用远程回复，还需重启桥接。
+
 ## 已提供的功能
 
 - Telegram、飞书双渠道通知，按渲染后的长度分段，不会悄悄截断内容。

package/SECURITY.md

@@ -1,6 +1,6 @@
 # 安全边界（Node/npm）
 
-当前源码为 `0.1.0`，npm 包名为 `@quecue/dev-notify`；发布版本以 npm registry 为准，源码更新不等同于已发布。本项目尚未完成安全审计或双平台实机验收。
+当前源码为 `0.1.1`，npm 包名为 `@quecue/dev-notify`；发布版本以 npm registry 为准，源码更新不等同于已发布。本项目尚未完成安全审计或双平台实机验收。
 
 ## 凭据与权限
 

package/dist/cli.js

@@ -13,7 +13,9 @@ import { claudeCodeStatus, claudeSettingsPath, configureClaudeCode } from './cla
 import { dispatchClaudeHook, readHookInput } from './claude-hook.js';
 import { accessReplies, configureReplies, disableReplies } from './reply-state.js';
 import { startBridge, stopBridge, bridgeStatus, runBridge } from './reply-bridge.js';
-const HELP = `dev-notify 0.1.0 — 跨平台开发任务通知
+import { updatePackage } from './update.js';
+export const VERSION = '0.1.1';
+const HELP = `dev-notify ${VERSION} — 跨平台开发任务通知
 
 命令：
   send --title 标题 [--content 正文 | --content-file 文件 | --stdin]
@@ -26,6 +28,7 @@ const HELP = `dev-notify 0.1.0 — 跨平台开发任务通知
   credentials clear         移除当前 Node 凭据引用和条目（需要确认）
   paths                     显示配置路径（不会写入文件）
   doctor / status           离线检查（不会发送消息）
+  update [--check] [--yes]  检查并更新到 npm 最新版本（确认后调用 npm）
   integration list          列出可用集成
   integration claude-code install / status / remove
                             单独安装、查询或移除用户级 hooks
@@ -64,7 +67,7 @@ export async function main(argv = process.argv.slice(2), overrides = {}) {
                     title: { type: 'string' }, content: { type: 'string' }, 'content-file': { type: 'string' }, stdin: { type: 'boolean' },
                     channel: { type: 'string' }, level: { type: 'string' }, footer: { type: 'string' }, 'dry-run': { type: 'boolean' },
                     template: { type: 'boolean' }, yes: { type: 'boolean' },
-                    'no-test': { type: 'boolean' }, 'no-hooks': { type: 'boolean' },
+                    'no-test': { type: 'boolean' }, 'no-hooks': { type: 'boolean' }, check: { type: 'boolean' },
                 } });
         }
         catch {
@@ -76,13 +79,13 @@ export async function main(argv = process.argv.slice(2), overrides = {}) {
             return 0;
         }
         if (values.version) {
-            context.out('dev-notify 0.1.0');
+            context.out(`dev-notify ${VERSION}`);
             return 0;
         }
         const [command, action, integrationAction] = positionals;
         const allowed = {
             send: ['title', 'content', 'content-file', 'stdin', 'channel', 'level', 'footer', 'dry-run'],
-            setup: ['template', 'yes', 'no-test', 'no-hooks'], paths: [], doctor: [], status: [], integration: [], credentials: [], reply: [],
+            setup: ['template', 'yes', 'no-test', 'no-hooks'], paths: [], doctor: [], status: [], integration: [], credentials: [], reply: [], update: ['check', 'yes'],
         };
         if (!command || !Object.hasOwn(allowed, command) || positionals.length > (command === 'integration' ? 3 : command === 'credentials' || command === 'reply' ? 2 : 1)
             || Object.keys(values).some(key => key !== 'config' && !allowed[command].includes(key)))
@@ -93,6 +96,12 @@ export async function main(argv = process.argv.slice(2), overrides = {}) {
             context.out(JSON.stringify({ config: file, data: paths.data }, null, 2));
             return 0;
         }
+        if (command === 'update') {
+            return await updatePackage(VERSION, {
+                out: context.out, prompts: context.prompts,
+                check: !!values.check, yes: !!values.yes,
+            });
+        }
         if (command === 'integration') {
             if (action === 'list' && !integrationAction) {
                 context.out('claude-code：支持通知、Telegram 回复和结构化问题交互。通知 hooks 与回复权限分开，默认只发送通知，不接收远程输入。');

package/dist/update.js

@@ -0,0 +1,92 @@
+import { spawnSync } from 'node:child_process';
+import { ConfigError } from './config.js';
+import { terminalPrompts } from './prompts.js';
+const NAME = '@quecue/dev-notify';
+const VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-(alpha|beta|rc)\.(0|[1-9]\d*))?$/;
+function npmRunner(args, capture) {
+    // Windows 的 npm 是 .cmd；Node 不能直接 spawn，需要经过 shell。参数均为固定值。
+    const result = spawnSync('npm', args, {
+        encoding: 'utf8',
+        stdio: capture ? 'pipe' : 'inherit',
+        timeout: capture ? 30000 : 300000,
+        shell: process.platform === 'win32',
+    });
+    if (result.error)
+        throw new ConfigError('无法运行 npm。请确认已安装 npm，并且它在 PATH 中。');
+    return { status: result.status, stdout: result.stdout ?? '', stderr: result.stderr ?? '' };
+}
+async function fetchLatest() {
+    let response;
+    try {
+        response = await fetch(`https://registry.npmjs.org/${NAME.replace('/', '%2F')}/latest?t=${Date.now()}`, {
+            redirect: 'error',
+            signal: AbortSignal.timeout(10000),
+            headers: { 'Cache-Control': 'no-cache, no-store', Accept: 'application/json' },
+        });
+    }
+    catch {
+        throw new ConfigError('无法检查最新版本。请检查网络后重试。');
+    }
+    if (!response.ok)
+        throw new ConfigError(`无法检查最新版本（HTTP ${response.status}）。请检查网络后重试。`);
+    let version;
+    try {
+        version = (await response.json())?.version;
+    }
+    catch {
+        throw new ConfigError('npm registry 返回的版本信息无法解析。');
+    }
+    if (typeof version !== 'string' || !VERSION.test(version))
+        throw new ConfigError('npm registry 返回的版本号格式不受支持。');
+    return version;
+}
+function parts(version) {
+    const match = VERSION.exec(version);
+    if (!match)
+        throw new ConfigError('版本号格式不受支持。');
+    const rank = match[4] === 'alpha' ? 1 : match[4] === 'beta' ? 2 : match[4] === 'rc' ? 3 : 4;
+    return [Number(match[1]), Number(match[2]), Number(match[3]), rank, Number(match[5] ?? 0)];
+}
+export function compareVersions(left, right) {
+    const a = parts(left), b = parts(right);
+    for (let i = 0; i < a.length; i++)
+        if (a[i] !== b[i])
+            return a[i] > b[i] ? 1 : -1;
+    return 0;
+}
+async function confirmUpdate(latest, options) {
+    if (options.yes)
+        return true;
+    if (!options.prompts && (!process.stdin.isTTY || !process.stdout.isTTY)) {
+        throw new ConfigError('更新需要在交互终端中确认；非交互场景请使用 dev-notify update --yes。');
+    }
+    const prompts = options.prompts ?? terminalPrompts();
+    return /^(y|yes)$/i.test(await prompts.text(`更新到 ${latest}？[y/N] `));
+}
+export async function updatePackage(current, options) {
+    if (!VERSION.test(current))
+        throw new ConfigError('当前版本号格式不受支持，无法检查更新。');
+    const latest = await (options.latest ?? fetchLatest)();
+    if (!VERSION.test(latest))
+        throw new ConfigError('npm registry 返回的版本号格式不受支持。');
+    if (compareVersions(latest, current) <= 0) {
+        options.out(`已是最新版本 ${current}。`);
+        return 0;
+    }
+    options.out(`当前版本 ${current}，npm 最新版本 ${latest}。`);
+    if (options.check) {
+        options.out('运行 dev-notify update 更新。');
+        return 0;
+    }
+    if (!await confirmUpdate(latest, options)) {
+        options.out('已取消，没有更新。');
+        return 130;
+    }
+    options.out(`运行 npm install -g ${NAME}@${latest} ...`);
+    const result = (options.runner ?? npmRunner)(['install', '-g', `${NAME}@${latest}`], false);
+    if (result.status !== 0)
+        throw new ConfigError(`更新没有完成。请检查 npm 权限，或手动运行 npm install -g ${NAME}@latest。`);
+    options.out(`已更新到 ${latest}。请重新打开终端后运行 dev-notify --version 确认。`);
+    options.out('如有 Claude Code hooks，请运行 dev-notify integration claude-code install；如使用远程回复，请重启桥接。');
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quecue/dev-notify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "跨平台开发任务通知工具，支持 Telegram 与飞书",
   "license": "MIT",
   "repository": {