@quecue/dev-notify 0.1.0-alpha.1 → 0.1.0

package/dist/setup.js

@@ -1,10 +1,11 @@
 import { readFile, mkdir, open, rename, unlink } from 'node:fs/promises';
 import path from 'node:path';
 import { randomBytes } from 'node:crypto';
-import { ConfigError, decodeUtf8, example, parseConfig } from './config.js';
+import { ConfigError, decodeUtf8, example, parseConfig, ready } from './config.js';
 import { encodeBundle, nativeStore } from './credentials.js';
 import { terminalPrompts } from './prompts.js';
 const yes = (text) => /^(y|yes)$/i.test(text.trim());
+const defaultYes = (text) => !text.trim() || yes(text);
 export async function snapshot(file) {
     try {
         return await readFile(file);
@@ -12,7 +13,7 @@ export async function snapshot(file) {
     catch (error) {
         if (error.code === 'ENOENT')
             return null;
-        throw new ConfigError('无法读取现有配置，未修改');
+        throw new ConfigError('无法读取现有配置，这次没有做任何修改。');
     }
 }
 function same(left, right) { return left === null ? right === null : right !== null && left.equals(right); }
@@ -24,7 +25,7 @@ export function readRaw(raw) {
         data = JSON.parse(decodeUtf8(raw));
     }
     catch {
-        throw new ConfigError('现有配置损坏，未覆盖；请先修复 JSON');
+        throw new ConfigError('现有配置无法解析，这次没有覆盖它。请先修复 JSON。');
     }
     parseConfig(data, {}, () => ({}));
     return data;
@@ -59,20 +60,20 @@ export async function commitConfig(file, data, expected, store, values, options
         lock = await open(lockPath, 'wx', 0o600);
     }
     catch {
-        throw new ConfigError('配置写入锁不可用；请检查权限，或确认没有运行中的向导后处理残留 .setup.lock');
+        throw new ConfigError('配置写入锁不可用。请检查权限；如果确认没有向导在运行，可以删除残留的 .setup.lock。');
     }
     const temporary = path.join(path.dirname(file), `.config-${id}.tmp`);
     let created = false, committed = false, tempCreated = false;
     try {
         await lock.close();
         if (!same(await snapshot(file), expected))
-            throw new ConfigError('配置在向导期间已变化，未覆盖，请重试');
+            throw new ConfigError('配置在向导期间发生了变化，这次没有覆盖它。请重试。');
         if (values !== null) {
             store.create(id, values);
             created = true;
             const check = store.read(id);
             if (check === null || JSON.stringify(check) !== JSON.stringify(values))
-                throw new ConfigError('凭据写入校验失败，未切换配置');
+                throw new ConfigError('凭据写入后校验失败，配置没有切换。');
         }
         const stream = await open(temporary, 'wx', 0o600);
         tempCreated = true;
@@ -84,7 +85,7 @@ export async function commitConfig(file, data, expected, store, values, options
             await stream.close();
         }
         if (!same(await snapshot(file), expected))
-            throw new ConfigError('配置在保存期间已变化，未覆盖，请重试');
+            throw new ConfigError('配置在保存期间发生了变化，这次没有覆盖它。请重试。');
         await (options.replace ?? rename)(temporary, file);
         committed = true;
     }
@@ -94,7 +95,7 @@ export async function commitConfig(file, data, expected, store, values, options
                 await removeFile(temporary);
             }
             catch {
-                warn(`临时配置清理失败：${path.basename(temporary)}`);
+                warn(`临时配置没有清理掉：${path.basename(temporary)}`);
             }
         }
         if (created && !committed) {
@@ -102,14 +103,14 @@ export async function commitConfig(file, data, expected, store, values, options
                 store.remove(id);
             }
             catch {
-                warn(`配置未切换，但新凭据清理失败；引用 ID：${id}`);
+                warn(`配置没有切换，新凭据也未能清理。引用 ID：${id}`);
             }
         }
         try {
             await removeFile(lockPath);
         }
         catch {
-            warn('配置写入锁清理失败，请确认没有向导运行后处理 .setup.lock');
+            warn('配置写入锁没有清理掉。请确认没有向导在运行，再删除 .setup.lock。');
         }
     }
     if (old?.backend === 'keyring') {
@@ -117,11 +118,11 @@ export async function commitConfig(file, data, expected, store, values, options
             store.remove(old.id);
         }
         catch {
-            warn(`配置已保存，但旧凭据清理失败；引用 ID：${old.id}`);
+            warn(`配置已保存，但旧凭据没有清理掉。引用 ID：${old.id}`);
         }
     }
     else if (old?.backend === 'system') {
-        warn('Python 原型旧凭据未删除；仍由原型管理，避免跨实现误删');
+        warn('旧版原型的旧凭据仍然保留，由旧版工具继续管理，避免两个实现互相误删。');
     }
 }
 export async function wizard(file, options = {}) {
@@ -129,11 +130,14 @@ export async function wizard(file, options = {}) {
     const before = await snapshot(file), data = readRaw(before);
     const { out } = prompts;
     out(`配置路径：${file}`);
-    out('密钥隐藏输入并存入 Windows Credential Manager / macOS Keychain；JSON 只保存引用。');
-    out('不安装 hooks，不启用远程控制；只有额外同意测试时才发送消息。');
-    if (before && !yes(await prompts.text('已有配置，继续编辑？[y/N] ')))
-        return false;
-    const selection = await prompts.text('选择渠道：1 Telegram，2 飞书，3 两者；其他输入取消：');
+    out('Token、webhook 和签名密钥都不会回显，将保存到 Windows Credential Manager / macOS Keychain；配置文件只保留引用。');
+    const telegramEnabled = data.telegram?.enabled !== false;
+    const feishuEnabled = data.feishu?.enabled !== false;
+    const current = before === null ? ''
+        : telegramEnabled && feishuEnabled ? '3'
+            : telegramEnabled ? '1' : feishuEnabled ? '2' : '';
+    const entered = await prompts.text(`选择通知渠道：1 Telegram，2 飞书，3 两者${current ? ` [${current}]` : ''}（输入其他内容取消）：`);
+    const selection = entered || current;
     if (!['1', '2', '3'].includes(selection))
         return false;
     const store = options.store ?? nativeStore();
@@ -147,13 +151,13 @@ export async function wizard(file, options = {}) {
             previous = existing;
         }
         catch {
-            out('原凭据无法读取，可能缺失、锁定或权限不足。');
-            if (!yes(await prompts.text('放弃旧值，重新输入所选渠道凭据？[y/N] ')))
+            out('当前凭据暂时读不到，可能是条目缺失、凭据库锁定或权限不足。');
+            if (!yes(await prompts.text('要重新输入所选渠道的凭据吗？[y/N] ')))
                 return false;
         }
     }
     else if (reference?.backend === 'system')
-        out('检测到 Python 原型凭据；本次重新输入保存，旧凭据不读取、不删除。');
+        out('检测到旧版原型保存的凭据。本次会重新输入并保存为 Node 版凭据，旧凭据保持不变。');
     data.telegram ??= {};
     data.feishu ??= {};
     data.telegram.enabled = selection !== '2';
@@ -161,11 +165,12 @@ export async function wizard(file, options = {}) {
     const values = {};
     const readValue = async (label, key, required) => {
         while (true) {
-            const hint = previous[key] ? '留空保留已存值' : '不从环境变量自动复制';
-            const answer = await prompts.secret(`${label}（${hint}${required ? '' : '；输入 - 清除'}）：`);
+            const hint = previous[key] ? '留空保留当前值' : '不会从环境变量自动填充';
+            const optional = required ? '' : '可选；';
+            const answer = await prompts.secret(`${label}（隐藏输入，不回显；${optional}${hint}${required ? '' : '；输入 - 清除'}）：`);
             const value = !required && answer === '-' ? '' : answer || previous[key] || '';
             if (required && !value) {
-                out('此项不能为空，请重试，或 Ctrl+C 取消。');
+                out('这一项不能为空，请重新输入；按 Ctrl+C 可退出。');
                 continue;
             }
             try {
@@ -175,15 +180,15 @@ export async function wizard(file, options = {}) {
                 return value;
             }
             catch {
-                out('格式不正确，请检查后重新输入；不会显示秘密。');
+                out('格式不正确，请重新输入（输入内容不会显示）。');
             }
         }
     };
     if (data.telegram.enabled) {
         values.telegram_token = await readValue('Telegram Bot Token', 'telegram_token', true);
-        out('接收人需要先启动 Bot；本轮手动填写数字 chat_id，不启动 getUpdates 或自动配对。');
+        out('请先让接收人给 Bot 发一条消息，然后填写数字 chat_id；这里不会自动获取或配对接收人。');
         while (true) {
-            const entered = await prompts.text('接收人 chat_id，多个用逗号分隔（留空保留原名单）：');
+            const entered = await prompts.text('接收人 chat_id，多个用逗号分隔（留空保留现有名单）：');
             const ids = entered ? entered.split(',').map(item => item.trim()) : data.telegram.chat_ids ?? [];
             try {
                 if (!ids.length)
@@ -193,58 +198,84 @@ export async function wizard(file, options = {}) {
                 break;
             }
             catch {
-                out('请填写至少一个有效数字 chat_id，或 Ctrl+C 取消。');
+                out('请填写至少一个有效的数字 chat_id；按 Ctrl+C 可退出。');
             }
         }
     }
     if (data.feishu.enabled) {
         values.feishu_webhook = await readValue('飞书 webhook', 'feishu_webhook', true);
-        values.feishu_secret = await readValue('飞书签名密钥（可选）', 'feishu_secret', false);
+        values.feishu_secret = await readValue('飞书签名密钥', 'feishu_secret', false);
     }
     encodeBundle(values);
     const preview = { ...data, credentials: { backend: 'keyring', id: '0'.repeat(32) } };
     parseConfig(preview, {}, () => values);
     const env = options.env ?? process.env;
-    out(`将启用：${data.telegram.enabled ? `Telegram（${data.telegram.chat_ids.length} 个接收人）` : ''}${data.feishu.enabled ? ' 飞书' : ''}`);
-    out('环境变量仍优先（含显式空值）；测试通知会使用最终生效的配置，不一定是刚输入的值。');
+    const channels = [];
+    if (data.telegram.enabled)
+        channels.push(`Telegram（${data.telegram.chat_ids.length} 个接收人）`);
+    if (data.feishu.enabled)
+        channels.push('飞书');
+    out(`将启用：${channels.join('、')}`);
+    out('环境变量的优先级更高，空值也会覆盖这里的设置；测试通知使用最终生效的配置。');
     const overrides = [data.telegram.token_env ?? 'TELEGRAM_BOT_TOKEN', data.feishu.webhook_env ?? 'FEISHU_WEBHOOK',
         data.feishu.secret_env ?? 'FEISHU_SECRET', 'TELEGRAM_CHAT_ID', 'TELEGRAM_CHAT_IDS'].filter(name => Object.hasOwn(env, name));
     if (overrides.length)
-        out('当前存在环境覆盖：' + overrides.join('、'));
+        out('以下环境变量正在覆盖配置：' + overrides.join('、'));
     if (reference?.backend === 'keyring')
-        out('保存成功后删除旧凭据；共享旧引用 ID 的配置副本也需更新。');
-    out('未选中的渠道会禁用；新条目只保存所选渠道凭据。');
-    if (!yes(await prompts.text('确认保存配置和系统凭据？[y/N] ')))
+        out('保存成功后会删除旧凭据；如果其他配置也引用了同一个凭据，需要一并更新。');
+    out('没有选中的渠道会被停用；新凭据只用于本次选中的渠道。');
+    for (const line of options.notes ?? [])
+        out(line);
+    const actions = ['保存配置和系统凭据'];
+    if (options.testSend)
+        actions.push('发送固定内容的测试通知');
+    if (options.afterSave)
+        actions.push('安装 Claude Code 通知 hooks');
+    if (!defaultYes(await prompts.text(`将${actions.join('、')}。继续？[Y/n] `)))
         return false;
     await commitConfig(file, data, before, store, values, { warn: out });
     out('配置和系统凭据已保存。');
-    if (options.testSend && yes(await prompts.text('发送固定内容的测试通知到生效的接收目标？[y/N] '))) {
+    if (options.testSend) {
         try {
             const effective = parseConfig(preview, env, () => values);
             const ok = await options.testSend(effective);
-            out(ok ? '测试通知发送成功。' : '配置已保存，但测试通知失败或没有可用渠道；请运行 doctor 检查。');
+            out(ok ? '测试通知发送成功。' : '配置已保存。测试通知没有发送成功，请运行 dev-notify doctor 检查。');
         }
         catch {
-            out('配置已保存，但环境覆盖或网络导致测试失败；请运行 doctor 检查。');
+            out('配置已保存。测试通知没有发送成功，可能是环境变量覆盖或网络问题；请运行 dev-notify doctor 检查。');
         }
     }
     else
-        out('未发送测试通知。');
+        out('已跳过测试通知。');
+    if (options.afterSave) {
+        try {
+            await options.afterSave();
+        }
+        catch (error) {
+            out(`配置已保存。Claude Code hooks 没有安装完成：${error instanceof ConfigError ? error.message : '请运行 integration claude-code status 检查'}`);
+        }
+    }
+    try {
+        if (ready(parseConfig(preview, env, () => values), 'telegram')) {
+            out('如需在 Telegram 中回复 Claude，请运行：dev-notify reply setup');
+        }
+    }
+    catch { /* 环境覆盖无效时上方测试分支已报告。 */ }
     return true;
 }
 export async function clearCredentials(file, prompts, store) {
     const before = await snapshot(file), data = readRaw(before);
     const reference = data.credentials;
     if (!reference) {
-        prompts.out('此配置没有系统凭据引用，未修改。');
+        prompts.out('当前配置没有系统凭据引用，无需清理。');
         return true;
     }
     if (reference.backend !== 'keyring')
-        throw new ConfigError('这是 Python 原型的凭据，Node 不执行跨实现删除');
-    prompts.out('将移除当前配置的系统凭据引用并删除其条目；环境变量不变，共享引用的配置副本将失效。');
-    if (!yes(await prompts.text('确认清除？[y/N] ')))
+        throw new ConfigError('这是旧版原型保存的凭据；Node 版不会跨实现删除，请用原工具处理。');
+    prompts.out('将删除当前配置引用的系统凭据，并从配置中移除引用。环境变量不受影响；如果其他配置共享同一个凭据，它们也会失效。');
+    if (!yes(await prompts.text('确认清除吗？[y/N] ')))
         return false;
     await commitConfig(file, data, before, store ?? nativeStore(), null, { warn: prompts.out });
-    prompts.out('凭据引用已移除；如删除条目失败，上方会显示警告。');
+    prompts.out('凭据引用已移除。如果系统条目删除失败，上方会显示提示。');
     return true;
 }

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@quecue/dev-notify",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0",
   "description": "跨平台开发任务通知工具，支持 Telegram 与飞书",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/QueCue/dev-notify.git"
+  },
+  "homepage": "https://github.com/QueCue/dev-notify#readme",
+  "bugs": {
+    "url": "https://github.com/QueCue/dev-notify/issues"
+  },
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -14,6 +22,7 @@
     "dist/*.js",
     "README.md",
     "SECURITY.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {