knowly 6.12.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ygs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,282 @@
+# knas (Knowledge Async)
+
+🚀 让每一次复制，都成为知识复利。
+
+Knas (Knowledge Async) 不是另一个剪贴板工具。它是你的 私有知识管道。
+
+你在 Mac 上复制一段文字、一张截图、一个链接——Knas 在后台静默捕获，通过 SSH 安全地存入你的私有 NAS，按日期归档为 Markdown。你手机上的灵感，也能通过公网中继自动汇入。
+
+捕获时零摩擦，沉淀时零丢失。 从此，每一次 Cmd+C 都是在为你的第二大脑添砖加瓦。配合内置的 Blog/Podcast/IMA 发布引擎，一次输入，三重输出。
+
+对抗遗忘，积累复利。让知识管理，从“复制”这一步开始。
+
+📖 什么是 K.N.A.S.？
+
+从“Knowledge Async”出发，knas 这个名字完全可以生长出一组丰富的内涵。以下是根据项目核心理念，为 K.N.A.S. 四个字母赋予的多重联想，每一个都对应着 knas 的一个侧面：
+
+🧠 官方正解（原名）
+
+· Knowledge Async
+  知识的异步传输。这是名字的起点，强调了“不打断心流、后台静默运行”的核心特征。
+
+🏛️ 哲学层（对抗熵增）
+
+· Keep Notions Always Saved
+  让一切念头永不丢失。对抗遗忘，对抗数字熵增，这是 knas 的终极使命。
+· Knowledge Never Accidentally Sinks
+  知识永不意外沉没。每一条碎片都被打捞，放进你的私人知识方舟。
+
+⚙️ 架构层（技术本质）
+
+· Kernel for Networked Archival Sync
+  网络归档同步的内核。一个轻量、专注的守护进程，像操作系统内核一样可靠。
+· Kapture, Normalize, Archive, Syndicate
+  捕获、标准化、归档、分发。这是 knas 数据流四部曲的精确描述。
+
+🌊 产品层（用户体验）
+
+· Kindle Notes Auto Sync
+  灵感笔记自动同步。这里的“Kindle”作动词，意为“点燃灵感”，每次复制都是一次火花的捕捉。
+· Knowledge Nirvana Automation System
+  知识涅槃自动化系统。有点中二，但精准表达了从碎片到复利的质变过程。
+
+🔒 价值观层（数据主权）
+
+· Keep Nas As Sanctuary
+  让 NAS 成为知识圣殿。强调私有化、自主可控的存储哲学。
+
+🎁 彩蛋（趣味向）
+
+· Kitchen Never Asks Silly
+  厨房从不多问。把 knas 比作一个沉默的厨房帮工，你扔进去食材（碎片），它默默处理成菜肴（知识），从不抱怨。
+· Knowledge Not Another Silo
+  知识不再是孤岛。打破 App 之间的壁垒，让剪贴板成为统一入口。
+
+---
+
+
+剪切板自动同步工具 - 在 Mac 本机监听剪切板并同步到 Ubuntu 服务器。
+
+## 功能特点
+
+- 🔔 **实时监听**: 500ms 轮询剪切板变化，CPU 占用极低
+- 🖼️ **多模态支持**: 自动识别并归档截图（PNG），实现图文同档
+- 🔒 **安全传输**: 通过 SSH 协议加密传输，无需在服务器安装接收端
+- 🧠 **智能识别**: 自动识别 URL 并抓取网页标题
+- 🎯 **智能过滤**: 支持敏感词过滤，避免同步密码等敏感信息
+- 📁 **自动归档**: 按日期自动归档到 `YYYY/MM/DD/` 目录结构
+- 🔄 **高韧性重试**: 指数退避重试机制（Exponential Backoff + Jitter），网络抖动自动抚平
+- ⏪ **历史回溯**: `knas history` 查看最近同步记录，`knas restore <id>` 一键找回被覆盖的内容
+- 🚀 **后台运行**: 支持 macOS LaunchAgent，开机自启动
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g knas
+
+# 或从源码安装
+git clone https://github.com/yuanguangshan/knas.git
+cd knas
+npm install
+npm run build
+npm link
+```
+
+## 快速开始
+
+### 1. 初始化配置
+
+```bash
+knas init
+```
+
+交互式配置：
+- SSH 服务器地址
+- SSH 端口（默认 22）
+- SSH 用户名（默认 root）
+- SSH 密钥路径（默认 ~/.ssh/id_rsa）
+- 远程存储路径（默认 ~/knas_archive）
+- 最小同步长度（默认 100 字符）
+
+### 2. 启动守护进程
+
+```bash
+knas start
+```
+
+### 3. 查看状态
+
+```bash
+knas status
+```
+
+### 4. 查看日志
+
+```bash
+knas log          # 查看日志
+knas log -f       # 实时跟踪日志
+```
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `knas init` | 初始化配置 |
+| `knas start` | 启动守护进程 |
+| `knas stop` | 停止守护进程 |
+| `knas status` | 查看运行状态 |
+| `knas log` | 查看日志 |
+| `knas config` | 查看/编辑配置 |
+| `knas history [n]` | 查看最近 n 条同步记录（默认 20） |
+| `knas restore <id>` | 将指定记录回填到剪贴板 |
+| `knas service install` | 安装为 macOS 系统服务 |
+
+## macOS 系统服务
+
+安装为 LaunchAgent 后，knas 会在登录时自动启动，崩溃自动重启：
+
+```bash
+# 停止服务
+launchctl unload ~/Library/LaunchAgents/com.knas.daemon.plist
+
+# 启动服务
+launchctl load ~/Library/LaunchAgents/com.knas.daemon.plist
+
+# 查看状态
+launchctl list | grep knas
+
+# 卸载服务（不再开机自启）
+launchctl unload ~/Library/LaunchAgents/com.knas.daemon.plist
+rm ~/Library/LaunchAgents/com.knas.daemon.plist
+```
+
+## 配置文件
+
+配置文件位于 `~/.knas/config.json`：
+
+```json
+{
+  "ssh": {
+    "host": "your-server.com",
+    "port": "22",
+    "user": "root",
+    "key_path": "~/.ssh/id_rsa",
+    "base_path": "~/knas_archive"
+  },
+  "clipboard": {
+    "min_length": 100,
+    "poll_interval_ms": 500,
+    "exclude_words": ["password", "密码", "token"]
+  },
+  "sync": {
+    "enabled": true,
+    "max_retries": 3,
+    "retry_delay_ms": 5000
+  }
+}
+```
+
+## 远程文件结构
+
+同步的文件按以下结构存储：
+
+```~/knas_archive/
+├── 2026/
+│   ├── 04/
+│   │   ├── 18/
+│   │   │   ├── 133119_knas_已成功运行.md  <-- 语义化后缀
+│   │   │   ├── 142545_关于量化交易的思.md
+│   │   │   ├── 150405_image.png          <-- 自动归档的截图
+│   │   │   └── ...
+
+```
+
+每个文件包含：
+
+```markdown
+---
+sync_time: 2026-04-18 14:20:30
+source: clipboard
+---
+
+[剪切板内容]
+```
+
+## 架构
+
+```
+┌─────────────────┐
+│   Mac 本机      │
+│                 │
+│  ┌───────────┐  │    SSH    ┌─────────────┐
+│  │ 剪切板监听 │  │ ────────> │  Ubuntu     │
+│  │   (Go)    │  │            │  服务器     │
+│  └───────────┘  │            └─────────────┘
+│       ↓         │                  │
+│  内容处理       │                  ↓
+│  (URL标题抓取)  │          文件存储
+│       ↓         │          (按日期归档)
+│  ┌───────────┐  │
+│  │ SSH 同步  │  │
+│  └───────────┘  │
+└─────────────────┘
+```
+
+## 技术栈
+
+- **剪切板监听**: Go + `golang.design/x/clipboard` (原生支持 Text + Image)
+- **重试机制**: Go + `internal/retry` (指数退避 + Full Jitter)
+- **SSH 传输**: Go + `golang.org/x/crypto/ssh`
+- **CLI 工具**: Go (纯原生编译，无 Node.js 依赖)
+- **系统服务**: macOS LaunchAgent
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/yuanguangshan/knas.git
+cd knas
+
+# 安装 Go 依赖
+go mod tidy
+
+# 构建二进制文件
+go build -o knas ./cmd/knas
+
+# 运行
+./knas init
+./knas start
+```
+
+## 注意事项
+
+1. **SSH 密钥**: 确保 Mac 的 SSH 公钥已添加到服务器的 `~/.ssh/authorized_keys`
+2. **网络连接**: 确保能访问远程服务器
+3. **权限**: 确保远程路径有写入权限
+4. **敏感信息**: 默认排除包含 "password"、"密码"、"token" 的内容
+
+## 许可证
+
+MIT
+
+---
+
+## v1.7.0 新增：历史回溯与找回
+
+### 使用场景
+1. **手滑覆盖**：复制了新内容，想找回上一条被覆盖的长文本。
+2. **截图归档**：确认截图是否已成功同步到 NAS。
+
+### 示例
+```bash
+# 查看最近 20 条同步记录
+$ knas history
+[20260418184501_a1b2c3d4] (text) 关于量化交易的思考...
+[20260418184430_e5f6g7h8] (image) [IMAGE] 102400 bytes
+[20260418184315_i9j0k1l2] (text) https://github.com/yuanguangshan/knas
+
+# 找回被覆盖的文本
+$ knas restore 20260418184501_a1b2c3d4
+✓ 已将记录 20260418184501_a1b2c3d4 恢复到剪贴板
+```

package/bin/knowly.js

@@ -0,0 +1,396 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const fs = require('fs');
+const path = require('path');
+const { spawn, execSync } = require('child_process');
+const os = require('os');
+
+program
+  .name('knowly')
+  .description('Knowledge Async - Clipboard to NAS sync tool')
+  .version(require('../package.json').version);
+
+const CONFIG_DIR = path.join(os.homedir(), '.knowly');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const LOG_FILE = path.join(CONFIG_DIR, 'knowly.log');
+const PID_FILE = path.join(CONFIG_DIR, 'knowly.pid');
+
+// 获取平台对应的二进制文件名
+function getBinaryPath() {
+  const platform = os.platform();
+  const arch = os.arch();
+  const binDir = path.join(__dirname, '..', 'bin');
+
+  let binaryName;
+  if (platform === 'darwin' && arch === 'arm64') {
+    binaryName = 'knowly-darwin-arm64';
+  } else if (platform === 'darwin') {
+    binaryName = 'knowly-darwin';
+  } else if (platform === 'linux') {
+    binaryName = 'knowly-linux';
+  } else {
+    throw new Error(`Unsupported platform: ${platform}-${arch}`);
+  }
+
+  return path.join(binDir, binaryName);
+}
+
+// 检查配置是否存在
+function isConfigured() {
+  return fs.existsSync(CONFIG_FILE);
+}
+
+// 读取配置
+function loadConfig() {
+  if (!isConfigured()) {
+    return null;
+  }
+  return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+}
+
+// 保存配置
+function saveConfig(config) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+// 检查是否在运行
+function isRunning() {
+  if (!fs.existsSync(PID_FILE)) {
+    return false;
+  }
+
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf8'));
+    process.kill(pid, 0); // 检查进程是否存在
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// 执行二进制文件
+function execBinary(args = [], detached = false) {
+  const binary = getBinaryPath();
+
+  if (!fs.existsSync(binary)) {
+    console.error(chalk.red(`Error: Binary not found at ${binary}`));
+    console.error(chalk.yellow('Please run: npm run build'));
+    process.exit(1);
+  }
+
+  const options = { stdio: 'inherit' };
+  if (detached) {
+    const logFd = fs.openSync(LOG_FILE, 'a');
+    options.stdio = ['ignore', logFd, logFd];
+    options.detached = true;
+    options.windowsHide = true;
+  }
+
+  const child = spawn(binary, args, options);
+
+  if (detached) {
+    child.unref();
+  }
+
+  return child;
+}
+
+// 初始化命令
+program
+  .command('init')
+  .description('Initialize knowly configuration')
+  .action(async () => {
+    console.log(chalk.cyan('Welcome to knowly (Knowledge Async)!\n'));
+
+    const defaultConfig = {
+      ssh: {
+        host: '',
+        port: '22',
+        user: 'root',
+        key_path: path.join(os.homedir(), '.ssh', 'id_rsa'),
+        base_path: '~/knowly_archive'
+      },
+      clipboard: {
+        min_length: 100,
+        max_length: 1048576,
+        poll_interval_ms: 500,
+        exclude_words: ['password', '密码', 'token']
+      },
+      sync: {
+        enabled: true,
+        max_retries: 3,
+        retry_delay_ms: 5000
+      }
+    };
+
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'host',
+        message: 'SSH host address:',
+        validate: input => input.length > 0 || 'Host is required'
+      },
+      {
+        type: 'input',
+        name: 'port',
+        message: 'SSH port:',
+        default: '22'
+      },
+      {
+        type: 'input',
+        name: 'user',
+        message: 'SSH user:',
+        default: 'root'
+      },
+      {
+        type: 'input',
+        name: 'key_path',
+        message: 'SSH private key path:',
+        default: path.join(os.homedir(), '.ssh', 'id_rsa'),
+        validate: input => fs.existsSync(input) || 'Key file does not exist'
+      },
+      {
+        type: 'input',
+        name: 'base_path',
+        message: 'Remote base path:',
+        default: '~/knowly_archive'
+      },
+      {
+        type: 'number',
+        name: 'min_length',
+        message: 'Minimum clipboard length to sync:',
+        default: 100
+      }
+    ]);
+
+    defaultConfig.ssh.host = answers.host;
+    defaultConfig.ssh.port = answers.port;
+    defaultConfig.ssh.user = answers.user;
+    defaultConfig.ssh.key_path = answers.key_path;
+    defaultConfig.ssh.base_path = answers.base_path;
+    defaultConfig.clipboard.min_length = answers.min_length;
+
+    saveConfig(defaultConfig);
+
+    console.log(chalk.green('\n✓ Configuration saved to'), CONFIG_FILE);
+    console.log(chalk.cyan('\nYou can now start the daemon with: knowly start'));
+  });
+
+// 启动命令
+program
+  .command('start')
+  .description('Start knowly daemon')
+  .action(() => {
+    if (!isConfigured()) {
+      console.error(chalk.red('Error: knowly is not configured'));
+      console.error(chalk.yellow('Run "knowly init" to configure'));
+      process.exit(1);
+    }
+
+    if (isRunning()) {
+      console.log(chalk.yellow('knowly daemon is already running'));
+      return;
+    }
+
+    console.log(chalk.cyan('Starting knowly daemon...'));
+    execBinary(['--daemon'], true);
+    console.log(chalk.green('✓ knowly daemon started'));
+    console.log(chalk.gray(`Log file: ${LOG_FILE}`));
+  });
+
+// 停止命令
+program
+  .command('stop')
+  .description('Stop knowly daemon')
+  .action(() => {
+    if (!isRunning()) {
+      console.log(chalk.yellow('knowly daemon is not running'));
+      return;
+    }
+
+    console.log(chalk.cyan('Stopping knowly daemon...'));
+    execBinary(['--stop']);
+    console.log(chalk.green('✓ knowly daemon stopped'));
+  });
+
+// 状态命令
+program
+  .command('status')
+  .description('Show knowly daemon status')
+  .action(() => {
+    execBinary(['--status']);
+  });
+
+// 日志命令
+program
+  .command('log')
+  .description('Show knowly logs')
+  .option('-f, --follow', 'Follow log output')
+  .action((options) => {
+    if (!fs.existsSync(LOG_FILE)) {
+      console.log(chalk.yellow('No log file found'));
+      return;
+    }
+
+    if (options.follow) {
+      const tail = spawn('tail', ['-f', LOG_FILE], { stdio: 'inherit' });
+      tail.on('error', () => {
+        console.log(chalk.yellow('Log file not found or cannot be read'));
+      });
+    } else {
+      const logContent = fs.readFileSync(LOG_FILE, 'utf8');
+      console.log(logContent);
+    }
+  });
+
+// 服务安装命令
+program
+  .command('service install')
+  .description('Install knowly as macOS Login Item (auto-start on login)')
+  .action(() => {
+    if (!isConfigured()) {
+      console.error(chalk.red('Error: knowly is not configured'));
+      console.error(chalk.yellow('Run "knowly init" to configure'));
+      process.exit(1);
+    }
+
+    // 清理旧的 LaunchAgent（如果存在）
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.knowly.daemon.plist');
+    if (fs.existsSync(plistPath)) {
+      try {
+        execSync('launchctl unload ~/Library/LaunchAgents/com.knowly.daemon.plist 2>/dev/null');
+      } catch (e) { /* ignore */ }
+      fs.unlinkSync(plistPath);
+      console.log(chalk.gray('Removed old LaunchAgent'));
+    }
+
+    // 创建 AppleScript Helper App
+    const helperAppPath = path.join(CONFIG_DIR, 'KnowlyHelper.app');
+    const scriptContent = `on run\ndo shell script "nohup ${getBinaryPath()} --daemon >> ${LOG_FILE} 2>&1 &"\nend run`;
+
+    try {
+      // 写入临时 .scpt 文件
+      const tmpScript = path.join(os.tmpdir(), 'knowly_helper.scpt');
+      fs.writeFileSync(tmpScript, scriptContent);
+      execSync(`osacompile -o "${helperAppPath}" "${tmpScript}"`, { stdio: 'pipe' });
+      fs.unlinkSync(tmpScript);
+
+      // 添加到登录项
+      try {
+        execSync(`osascript -e 'tell application "System Events" to delete login item "KnowlyHelper"' 2>/dev/null`, { stdio: 'pipe' });
+      } catch (e) { /* not existing, ignore */ }
+      execSync(`osascript -e 'tell application "System Events" to make login item at end with properties {path:"${helperAppPath}", hidden:true}'`, { stdio: 'pipe' });
+
+      console.log(chalk.green('✓ KnowlyHelper installed as Login Item'));
+      console.log(chalk.gray(`  App: ${helperAppPath}`));
+      console.log(chalk.cyan('\nKnowly will auto-start on login.'));
+      console.log(chalk.gray('Run "knowly service uninstall" to remove.'));
+    } catch (e) {
+      console.error(chalk.red('Error installing service:'), e.message);
+      process.exit(1);
+    }
+  });
+
+// 服务卸载命令
+program
+  .command('service uninstall')
+  .description('Uninstall knowly auto-start service')
+  .action(() => {
+    const helperAppPath = path.join(CONFIG_DIR, 'KnowlyHelper.app');
+
+    try {
+      // 从登录项移除
+      try {
+        execSync(`osascript -e 'tell application "System Events" to delete login item "KnowlyHelper"'`, { stdio: 'pipe' });
+        console.log(chalk.green('✓ Removed from Login Items'));
+      } catch (e) {
+        console.log(chalk.yellow('KnowlyHelper not found in Login Items'));
+      }
+
+      // 删除 Helper App
+      if (fs.existsSync(helperAppPath)) {
+        fs.rmSync(helperAppPath, { recursive: true });
+        console.log(chalk.green('✓ Removed KnowlyHelper.app'));
+      }
+
+      // 清理旧的 LaunchAgent（如果存在）
+      const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.knowly.daemon.plist');
+      if (fs.existsSync(plistPath)) {
+        try { execSync('launchctl unload ~/Library/LaunchAgents/com.knowly.daemon.plist 2>/dev/null'); } catch (e) { /* ignore */ }
+        fs.unlinkSync(plistPath);
+        console.log(chalk.green('✓ Removed old LaunchAgent'));
+      }
+    } catch (e) {
+      console.error(chalk.red('Error uninstalling service:'), e.message);
+      process.exit(1);
+    }
+  });
+
+// 配置命令
+program
+  .command('config')
+  .description('Show or edit configuration')
+  .option('-e, --edit', 'Edit configuration')
+  .action((options) => {
+    if (!isConfigured()) {
+      console.error(chalk.red('Error: knowly is not configured'));
+      console.error(chalk.yellow('Run "knowly init" to configure'));
+      process.exit(1);
+    }
+
+    const cfg = loadConfig();
+
+    if (options.edit) {
+      const editor = process.env.EDITOR || 'vim';
+      spawn(editor, [CONFIG_FILE], { stdio: 'inherit' });
+    } else {
+      console.log(JSON.stringify(cfg, null, 2));
+    }
+  });
+
+// 历史命令
+program
+  .command('history [n]')
+  .description('Show recent history entries (default: 20)')
+  .action((n) => {
+    const args = ['history'];
+    if (n) args.push(String(n));
+    execBinary(args);
+  });
+
+// 恢复命令
+program
+  .command('restore <id>')
+  .description('Restore a history entry to clipboard')
+  .action((id) => {
+    execBinary(['restore', id]);
+  });
+
+// Web UI 命令
+program
+  .command('web [port]')
+  .description('启动 Web 管理界面 (默认端口: 8090)')
+  .action((port) => {
+    const args = ['web'];
+    if (port) args.push(port.startsWith(':') ? port : ':' + port);
+    const child = execBinary(args);
+    child.on('exit', (code) => process.exit(code));
+  });
+
+// 版本命令
+program
+  .command('version')
+  .description('Show version information')
+  .action(() => {
+    const pkg = require('../package.json');
+    console.log(`knowly v${pkg.version}`);
+  });
+
+// 解析命令行参数
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "knowly",
+  "version": "6.12.0",
+  "description": "Knowledge Async - Clipboard monitor and sync to remote server via SSH",
+  "main": "index.js",
+  "bin": {
+    "knowly": "./bin/knowly.js"
+  },
+  "scripts": {
+    "install": "node scripts/install.js",
+    "postinstall": "node scripts/postinstall.js",
+    "preuninstall": "node scripts/preuninstall.js",
+    "build": "node scripts/build.js",
+    "start": "node bin/knowly.js start",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "keywords": [
+    "clipboard",
+    "sync",
+    "ssh",
+    "knowledge",
+    "automation",
+    "productivity",
+    "backup",
+    "macos"
+  ],
+  "author": "yuanguangshan <苑广山>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yuanguangshan/knas.git"
+  },
+  "homepage": "https://github.com/yuanguangshan/knas#readme",
+  "bugs": {
+    "url": "https://github.com/yuanguangshan/knas/issues"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^9.2.12",
+    "ora": "^5.4.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ]
+}

package/scripts/build.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+console.log('Building knowly...\n');
+
+// 确保 bin 目录存在
+const binDir = path.join(__dirname, '..', 'bin');
+if (!fs.existsSync(binDir)) {
+  fs.mkdirSync(binDir, { recursive: true });
+}
+
+// 定义构建目标
+const targets = [
+  { goos: 'darwin', goarch: 'amd64', output: 'knowly-darwin' },
+  { goos: 'darwin', goarch: 'arm64', output: 'knowly-darwin-arm64' },
+  { goos: 'linux', goarch: 'amd64', output: 'knowly-linux' },
+];
+
+// 构建每个目标
+targets.forEach(target => {
+  console.log(`Building for ${target.goos}-${target.goarch}...`);
+
+  const env = {
+    ...process.env,
+    GOOS: target.goos,
+    GOARCH: target.goarch,
+    CGO_ENABLED: target.goos === 'darwin' ? '1' : '0'
+  };
+
+  if (target.goos === 'darwin') {
+    try {
+      env.SDKROOT = execSync('xcrun --sdk macosx --show-sdk-path', { encoding: 'utf8' }).trim();
+    } catch (_) {}
+  }
+
+  const outputPath = path.join(binDir, target.output);
+
+  try {
+    execSync(`go build -o ${outputPath} -ldflags="-s -w" ./cmd/knowly`, {
+      env,
+      stdio: 'inherit'
+    });
+
+    // 设置可执行权限
+    fs.chmodSync(outputPath, '755');
+
+    console.log(`✓ Built ${target.output}`);
+  } catch (e) {
+    console.error(`✗ Failed to build ${target.output}`);
+    process.exit(1);
+  }
+});
+
+console.log('\n✓ Build complete!');
+console.log('\nBinaries:');
+targets.forEach(target => {
+  const size = fs.statSync(path.join(binDir, target.output)).size;
+  console.log(`  ${target.output}: ${(size / 1024).toFixed(2)} KB`);
+});

package/scripts/install.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// CI 环境中跳过编译，由 prepublishOnly 负责构建
+if (process.env.CI === 'true') {
+  console.log('CI environment detected, skipping binary compilation');
+  process.exit(0);
+}
+
+console.log('Installing knowly...\n');
+
+// 检查二进制文件是否已存在
+const binDir = path.join(__dirname, '../bin');
+const platform = process.platform;
+const arch = process.arch;
+const binaryName = platform === 'darwin' && arch === 'arm64'
+  ? 'knowly-darwin-arm64'
+  : platform === 'darwin'
+  ? 'knowly-darwin'
+  : platform === 'linux'
+  ? 'knowly-linux'
+  : null;
+
+const binaryPath = binaryName ? path.join(binDir, binaryName) : null;
+const binaryExists = binaryPath && fs.existsSync(binaryPath);
+
+if (binaryExists) {
+  console.log('✓ Pre-built binary found');
+} else {
+  // 检查 Go 环境
+  try {
+    execSync('go version', { stdio: 'pipe' });
+    console.log('✓ Go environment found');
+  } catch (e) {
+    console.error('✗ Go is not installed and no pre-built binary found');
+    console.error('Please install Go from https://golang.org/dl/');
+    process.exit(1);
+  }
+
+  // 运行构建
+  console.log('\nBuilding binaries...');
+  try {
+    execSync('node scripts/build.js', { stdio: 'inherit' });
+  } catch (e) {
+    console.error('✗ Build failed');
+    process.exit(1);
+  }
+}
+
+console.log('\n✓ Installation complete!');
+console.log('\nRun "knowly init" to configure.');

package/scripts/postinstall.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+// postinstall 脚本 - 安装后检查
+const fs = require('fs');
+const path = require('path');
+
+const binDir = path.join(__dirname, '..', 'bin');
+const requiredBinaries = ['knowly-darwin', 'knowly-darwin-arm64', 'knowly-linux'];
+
+let allExist = true;
+requiredBinaries.forEach(bin => {
+  const binPath = path.join(binDir, bin);
+  if (!fs.existsSync(binPath)) {
+    allExist = false;
+  }
+});
+
+if (!allExist) {
+  console.warn('Warning: Some binaries are missing. Run "npm run build" to build them.');
+}

package/scripts/preuninstall.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+// preuninstall 脚本 - 卸载前清理
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const pidFile = path.join(require('os').homedir(), '.knowly', 'knowly.pid');
+
+// 尝试停止运行中的守护进程
+if (fs.existsSync(pidFile)) {
+  try {
+    const pid = fs.readFileSync(pidFile, 'utf8').trim();
+    execSync(`kill ${pid} 2>/dev/null`);
+    console.log('Stopped knowly daemon');
+  } catch (e) {
+    // 忽略错误
+  }
+}