@quecue/dev-notify 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 更新记录
 
+## 0.1.2 — 2026-11-03
+
+### 改进
+
+- `dev-notify update` 安装成功后自动重新安装绑定当前配置的 Claude Code hooks，并重启正在运行的回复桥接；新增 `--no-post` 跳过这些维护步骤。
+- `integration claude-code install` / `remove` 支持 `--yes`，供自动化或 `update` 的维护流程使用。
+
+## 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.2` 提供 Claude Code 回复、原生 PC 与 Telegram 双端答题及结果反馈。** 版本变更与升级说明见 [CHANGELOG.md](CHANGELOG.md)；公开版本以 npm registry 为准。
 
 ## 安装与使用
 
@@ -40,6 +40,17 @@ 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     # 跳过确认（适合脚本）
+dev-notify update --no-post # 只更新包，不执行 hooks/桥接维护
+```
+
+实际的完整性校验、registry 配置、权限处理和原生依赖解析仍由 npm 完成。安装成功后，`update` 会自动重新安装绑定当前配置的 Claude Code hooks（已存在且配置匹配时），并重启正在运行的回复桥接；不需要时可用 `--no-post` 跳过。
+
 ## 已提供的功能
 
 - Telegram、飞书双渠道通知，按渲染后的长度分段，不会悄悄截断内容。
@@ -92,6 +103,8 @@ dev-notify integration claude-code status
 dev-notify integration claude-code remove
 ```
 
+`install` / `remove` 可加 `--yes` 跳过确认，供自动化或 `update` 的维护流程使用。
+
 源码验证时将上述 `dev-notify` 替换为 `node dist/cli.js`。安装可用 `--config <绝对或相对路径>` 绑定指定通知配置；执行时将其解析为绝对路径并保存到 hook 参数。自定义 `DEV_NOTIFY_HOME` 的使用者应在安装时设置该变量。
 
 - **配置范围**：默认用户级 `~/.claude/settings.json`，设置 `CLAUDE_CONFIG_DIR` 时使用该绝对目录下的 `settings.json`，覆盖该 Claude Code 配置目录下的全部项目。不会扫描或修改每个项目的设置。

package/SECURITY.md

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

package/dist/claude-code.js

@@ -61,11 +61,13 @@ function owned(hook) {
         && hook.args[4] === '--config' && typeof hook.args[5] === 'string';
 }
 function describe(file, data) {
-    const result = { file, stop: 0, notification: 0, lifecycle: 0, interaction: 0, others: 0, disabled: data.disableAllHooks === true };
+    const result = { file, stop: 0, notification: 0, lifecycle: 0, interaction: 0, others: 0, disabled: data.disableAllHooks === true, configs: [] };
     for (const event of EVENTS)
         for (const group of data.hooks?.[event] ?? [])
             for (const hook of group.hooks) {
                 if (owned(hook)) {
+                    if (!result.configs.includes(hook.args[5]))
+                        result.configs.push(hook.args[5]);
                     if (event === 'Stop')
                         result.stop++;
                     else if (event === 'Notification')

package/dist/cli.js

@@ -13,7 +13,10 @@ 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';
+import { postUpdate } from './maintenance.js';
+export const VERSION = '0.1.2';
+const HELP = `dev-notify ${VERSION} — 跨平台开发任务通知
 
 命令：
   send --title 标题 [--content 正文 | --content-file 文件 | --stdin]
@@ -26,9 +29,11 @@ const HELP = `dev-notify 0.1.0 — 跨平台开发任务通知
   credentials clear         移除当前 Node 凭据引用和条目（需要确认）
   paths                     显示配置路径（不会写入文件）
   doctor / status           离线检查（不会发送消息）
+  update [--check] [--yes] [--no-post]
+                            检查并更新到 npm 最新版本（确认后调用 npm）
   integration list          列出可用集成
   integration claude-code install / status / remove
-                            单独安装、查询或移除用户级 hooks
+                            单独安装、查询或移除用户级 hooks（install/remove 可用 --yes）
   reply setup               授权可信的 Telegram 私聊用户
   reply start / status / stop
                             启动、查询或停止回复桥接
@@ -64,7 +69,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' }, 'no-post': { type: 'boolean' },
                 } });
         }
         catch {
@@ -76,13 +81,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: ['yes'], credentials: [], reply: [], update: ['check', 'yes', 'no-post'],
         };
         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 +98,14 @@ 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,
+                post: values['no-post'] ? undefined
+                    : () => postUpdate({ config: file, env: context.env, out: context.out, err: context.err }),
+            });
+        }
         if (command === 'integration') {
             if (action === 'list' && !integrationAction) {
                 context.out('claude-code：支持通知、Telegram 回复和结构化问题交互。通知 hooks 与回复权限分开，默认只发送通知，不接收远程输入。');
@@ -112,13 +125,15 @@ export async function main(argv = process.argv.slice(2), overrides = {}) {
                     : '这里只检查用户级文件。是否实际加载还受项目和托管策略影响，请在 Claude Code 的 /hooks 中确认。');
                 return status.stop === 1 && status.notification === 1 && status.lifecycle === 3 && status.interaction === 5 && !status.disabled ? 0 : 1;
             }
-            const prompts = context.prompts ?? terminalPrompts();
+            const prompts = context.prompts ?? (values.yes
+                ? { out: context.out, text: async () => '', secret: async () => '' }
+                : terminalPrompts());
             if (integrationAction === 'install') {
                 const config = await loadConfig(file, true, context.env);
                 if (!ready(config, 'telegram') && !ready(config, 'feishu'))
                     throw new ConfigError('请先运行 setup 配置至少一个通知渠道，再安装 Claude Code hooks。');
             }
-            return await configureClaudeCode(file, integrationAction, prompts, { env: context.env }) ? 0 : 130;
+            return await configureClaudeCode(file, integrationAction, prompts, { env: context.env, confirm: values.yes ? false : undefined }) ? 0 : 130;
         }
         if (command === 'reply') {
             if (!['setup', 'start', 'status', 'stop', 'disable', 'run'].includes(action))

package/dist/maintenance.js

@@ -0,0 +1,100 @@
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { ConfigError } from './config.js';
+import { claudeCodeStatus } from './claude-code.js';
+import { bridgeStatus } from './reply-bridge.js';
+function runCli(args) {
+    const cli = fileURLToPath(new URL('./cli.js', import.meta.url));
+    const result = spawnSync(process.execPath, [cli, ...args], { stdio: 'inherit', timeout: 300000 });
+    if (result.error)
+        throw new ConfigError('无法运行更新后的 dev-notify。请重新打开终端后运行 dev-notify --version 检查。');
+    return result.status ?? 1;
+}
+function reason(error) {
+    return error instanceof ConfigError ? error.message : '请运行 dev-notify integration claude-code status 或 dev-notify reply status 检查。';
+}
+const normalize = (file) => process.platform === 'win32' ? path.resolve(file).toLowerCase() : path.resolve(file);
+export async function postUpdate(options) {
+    const run = options.run ?? runCli;
+    const hooks = options.hooks ?? (() => claudeCodeStatus({ env: options.env }));
+    const bridge = options.bridge ?? (() => bridgeStatus(options.config));
+    const wait = options.wait ?? delay;
+    let failed = false;
+    let hooksStatus = null;
+    try {
+        hooksStatus = await hooks();
+    }
+    catch (error) {
+        options.err(`无法检查 Claude Code hooks：${reason(error)}`);
+        failed = true;
+    }
+    if (hooksStatus) {
+        const count = hooksStatus.stop + hooksStatus.notification + hooksStatus.lifecycle + hooksStatus.interaction;
+        if (!count)
+            options.out('未检测到本工具的 Claude Code hooks，跳过。');
+        else if (!hooksStatus.configs.some(file => normalize(file) === normalize(options.config))) {
+            options.out('Claude Code hooks 绑定的是其他通知配置，跳过自动更新；如需更新，请用原来的 --config 运行 integration claude-code install。');
+        }
+        else {
+            options.out('更新 Claude Code hooks ...');
+            try {
+                if (run(['integration', 'claude-code', 'install', '--yes', '--config', options.config]) === 0)
+                    options.out('Claude Code hooks 已更新。');
+                else {
+                    options.err('Claude Code hooks 更新失败。');
+                    failed = true;
+                }
+            }
+            catch (error) {
+                options.err(`Claude Code hooks 更新失败：${reason(error)}`);
+                failed = true;
+            }
+        }
+    }
+    let bridgeState = null;
+    try {
+        bridgeState = await bridge();
+    }
+    catch (error) {
+        options.err(`无法检查回复桥接：${reason(error)}`);
+        failed = true;
+    }
+    if (bridgeState?.running) {
+        options.out('重启回复桥接 ...');
+        try {
+            // 0 表示已停止或本来未运行；1 表示停止请求已登记，下面等待进程释放锁。
+            run(['reply', 'stop', '--config', options.config]);
+            let stillRunning = true;
+            for (let i = 0; i < 20; i++) {
+                try {
+                    stillRunning = (await bridge()).running;
+                }
+                catch {
+                    break;
+                }
+                if (!stillRunning)
+                    break;
+                await wait(500);
+            }
+            if (stillRunning) {
+                options.err('回复桥接仍在退出，请稍后运行 dev-notify reply start。');
+                failed = true;
+            }
+            else if (run(['reply', 'start', '--config', options.config]) === 0)
+                options.out('回复桥接已重启。');
+            else {
+                options.err('回复桥接启动失败。');
+                failed = true;
+            }
+        }
+        catch (error) {
+            options.err(`回复桥接重启失败：${reason(error)}`);
+            failed = true;
+        }
+    }
+    else if (bridgeState)
+        options.out('未检测到运行中的回复桥接，跳过。');
+    return failed ? 1 : 0;
+}

package/dist/update.js

@@ -0,0 +1,104 @@
+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 (options.post)
+        options.out('更新完成后会自动重新安装绑定当前配置的 Claude Code hooks，并重启正在运行的回复桥接；可用 --no-post 跳过。');
+    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 确认。`);
+    if (options.post) {
+        const code = await options.post();
+        if (code !== 0) {
+            options.out('更新已完成，但后续维护步骤没有全部成功；请按上面的提示检查。');
+            return code;
+        }
+        options.out('更新后的维护步骤已完成。');
+    }
+    else {
+        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.2",
   "description": "跨平台开发任务通知工具，支持 Telegram 与飞书",
   "license": "MIT",
   "repository": {