@quecue/dev-notify 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 更新记录
 
+## 0.1.3 — 2026-11-03
+
+### 改进
+
+- `dev-notify update` 即使已经是最新版本也会执行 hooks 和桥接维护，方便从旧版升级后用同一条命令完成收尾；`--check` 仍然只检查，`--no-post` 跳过维护。
+
+## 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
 
 ### 新增

package/README.md

@@ -2,7 +2,7 @@
 
 跨平台开发任务通知工具，使用 **TypeScript / Node.js**，通过 npm 分发，不需要独立可执行文件或其他脚本运行时。通用通知不依赖 Claude Code、Unity 或项目目录。
 
-**npm 包名为 `@quecue/dev-notify`。`0.1.1` 提供 Claude Code 回复、原生 PC 与 Telegram 双端答题及结果反馈。** 版本变更与升级说明见 [CHANGELOG.md](CHANGELOG.md)；公开版本以 npm registry 为准。
+**npm 包名为 `@quecue/dev-notify`。`0.1.3` 提供 Claude Code 回复、原生 PC 与 Telegram 双端答题及结果反馈。** 版本变更与升级说明见 [CHANGELOG.md](CHANGELOG.md)；公开版本以 npm registry 为准。
 
 ## 安装与使用
 
@@ -46,9 +46,10 @@ node dist/cli.js send --title "分段预览" --content-file result.txt --dry-run
 dev-notify update           # 检查并在确认后运行 npm install -g
 dev-notify update --check   # 只检查，不安装
 dev-notify update --yes     # 跳过确认（适合脚本）
+dev-notify update --no-post # 只更新包，不执行 hooks/桥接维护
 ```
 
-实际的完整性校验、registry 配置、权限处理和原生依赖解析仍由 npm 完成。更新后请重新运行 `dev-notify integration claude-code install`；如使用远程回复，还需重启桥接。
+实际的完整性校验、registry 配置、权限处理和原生依赖解析仍由 npm 完成。安装成功后，`update` 会自动重新安装绑定当前配置的 Claude Code hooks（已存在且配置匹配时），并重启正在运行的回复桥接；不需要时可用 `--no-post` 跳过。在 0.1.3 及以后，即使已经是最新版本，`update` 也会执行同样的维护，因此可以用同一条命令完成升级后的收尾。
 
 ## 已提供的功能
 
@@ -102,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.1`，npm 包名为 `@quecue/dev-notify`；发布版本以 npm registry 为准，源码更新不等同于已发布。本项目尚未完成安全审计或双平台实机验收。
+当前源码为 `0.1.3`，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

@@ -14,7 +14,8 @@ import { dispatchClaudeHook, readHookInput } from './claude-hook.js';
 import { accessReplies, configureReplies, disableReplies } from './reply-state.js';
 import { startBridge, stopBridge, bridgeStatus, runBridge } from './reply-bridge.js';
 import { updatePackage } from './update.js';
-export const VERSION = '0.1.1';
+import { postUpdate } from './maintenance.js';
+export const VERSION = '0.1.3';
 const HELP = `dev-notify ${VERSION} — 跨平台开发任务通知
 
 命令：
@@ -28,10 +29,11 @@ const HELP = `dev-notify ${VERSION} — 跨平台开发任务通知
   credentials clear         移除当前 Node 凭据引用和条目（需要确认）
   paths                     显示配置路径（不会写入文件）
   doctor / status           离线检查（不会发送消息）
-  update [--check] [--yes]  检查并更新到 npm 最新版本（确认后调用 npm）
+  update [--check] [--yes] [--no-post]
+                            检查并更新到 npm 最新版本，并维护 hooks 和桥接
   integration list          列出可用集成
   integration claude-code install / status / remove
-                            单独安装、查询或移除用户级 hooks
+                            单独安装、查询或移除用户级 hooks（install/remove 可用 --yes）
   reply setup               授权可信的 Telegram 私聊用户
   reply start / status / stop
                             启动、查询或停止回复桥接
@@ -67,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' }, check: { type: 'boolean' },
+                    'no-test': { type: 'boolean' }, 'no-hooks': { type: 'boolean' }, check: { type: 'boolean' }, 'no-post': { type: 'boolean' },
                 } });
         }
         catch {
@@ -85,7 +87,7 @@ export async function main(argv = process.argv.slice(2), overrides = {}) {
         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: [], update: ['check', 'yes'],
+            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)))
@@ -100,6 +102,8 @@ export async function main(argv = process.argv.slice(2), overrides = {}) {
             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') {
@@ -121,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

@@ -63,6 +63,20 @@ async function confirmUpdate(latest, options) {
     const prompts = options.prompts ?? terminalPrompts();
     return /^(y|yes)$/i.test(await prompts.text(`更新到 ${latest}？[y/N] `));
 }
+async function runMaintenance(options, updated) {
+    if (!options.post) {
+        if (updated)
+            options.out('如有 Claude Code hooks，请运行 dev-notify integration claude-code install；如使用远程回复，请重启桥接。');
+        return 0;
+    }
+    const code = await options.post();
+    if (code !== 0) {
+        options.out(updated ? '更新已完成，但后续维护步骤没有全部成功；请按上面的提示检查。' : '维护步骤没有全部成功；请按上面的提示检查。');
+        return code;
+    }
+    options.out(updated ? '更新后的维护步骤已完成。' : '维护步骤已完成。');
+    return 0;
+}
 export async function updatePackage(current, options) {
     if (!VERSION.test(current))
         throw new ConfigError('当前版本号格式不受支持，无法检查更新。');
@@ -71,13 +85,19 @@ export async function updatePackage(current, options) {
         throw new ConfigError('npm registry 返回的版本号格式不受支持。');
     if (compareVersions(latest, current) <= 0) {
         options.out(`已是最新版本 ${current}。`);
-        return 0;
+        if (options.check)
+            return 0;
+        if (options.post)
+            options.out('将执行 Claude Code hooks 和回复桥接维护。');
+        return await runMaintenance(options, false);
     }
     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;
@@ -87,6 +107,5 @@ export async function updatePackage(current, options) {
     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;
+    return await runMaintenance(options, true);
 }

package/package.json

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