dwclaw-cli 1.1.0 → 1.3.0

package/README.md

@@ -1,36 +1,134 @@
-# Quick Start
-1. config enviroment
-   cp .env.example .env
+# Duclaw
 
-2. set up redis server (without password)
+AI Agent 管理框架 — 支持飞书 Channel、团队协作、定时任务、Skill 扩展、Web 管理界面。
 
-3. Register Feishu Bot （https://open.feishu.cn/app） Get im:message 权限
+使用 Anthropic 标准协议（兼容 Claude / GLM / Kimi 等），一行命令启动你的 AI Agent。
 
-   飞书事件与回调，添加事件 im.message.receive_v1 
+## Quick Start
 
-​	订阅方式：使用长连接接收事件
+> **前提**：Node.js >= 18，Redis 运行中（默认 `redis://localhost:6379`）
 
-​	修改后记得发布版本
+```bash
+# 安装
+npm install -g dwclaw-cli
 
-4. pnpm install
+# 初始化项目
+mkdir my-agent && cd my-agent
+duclaw init
 
-5. pnpm start
+# 编辑配置（见下方说明）
+# 启动
+duclaw start
+```
 
-# IMPORTANT
-支持多用户，各种组织顺序参考下面：
-{app} : {module} : {userId} : {scope?} : {id?}
-agent:mem:${userId}:${date?}:${cron_title?}
+## 配置
 
-层级	含义	示例
-app	应用命名空间	agent
-module	功能模块	mem, dedup, task, cron
-userId	用户标识	user_abc123
-scope?	可选 - 子作用域	日期 20260317、分组等
-id?	可选 - 具体标识	cron_title、messageId 等
+`duclaw init` 会生成以下文件：
 
+| 文件 | 说明 |
+|------|------|
+| `duclaw.json` | Channel 配置（飞书 appId / appSecret） |
+| `.env` | LLM API、Redis、OSS 等环境变量 |
+| `skills/` | 自定义技能目录 |
 
-安装腾讯的skillcli 可以让智能体更强大
+### duclaw.json
 
+```json
+{
+    "channels": {
+        "feishu": {
+            "enabled": true,
+            "appId": "YOUR_FEISHU_APP_ID",
+            "appSecret": "YOUR_FEISHU_APP_SECRET"
+        }
+    }
+}
+```
 
-# Todo Plan
-定时，SOUL，和控制浏览器，前端管理界面
+### .env (必填项)
+
+```bash
+# LLM 配置（Anthropic 兼容协议）
+export ANTHROPIC_BASE_URL="https://api.anthropic.com"
+export ANTHROPIC_AUTH_TOKEN="your-api-key"
+export ANTHROPIC_MODEL="claude-sonnet-4-20250514"
+
+# Redis
+export REDIS_URL="redis://localhost:6379"
+```
+
+支持的 LLM 提供商（只要兼容 Anthropic Messages API）：
+
+| 提供商 | BASE_URL | 示例模型 |
+|--------|----------|----------|
+| Anthropic | `https://api.anthropic.com` | `claude-sonnet-4-20250514` |
+| 智谱 GLM | `https://open.bigmodel.cn/api/anthropic` | `glm-5` |
+| Kimi | `https://api.moonshot.cn/anthropic` | `kimi-k2.5` |
+
+> 如果 API 使用 Bearer Token 风格，需额外设置 `ANTHROPIC_AUTH_STYLE="bearer"`
+
+## 飞书机器人配置
+
+1. 前往 [飞书开放平台](https://open.feishu.cn/app) 创建应用
+2. 添加权限：`im:message`（消息读写）
+3. 添加事件订阅：`im.message.receive_v1`，订阅方式选择 **长连接**
+4. 发布应用版本
+5. 将 appId 和 appSecret 填入 `duclaw.json`
+
+## CLI 命令
+
+```bash
+duclaw init [目录]     # 初始化项目
+duclaw start           # 启动服务
+duclaw                 # 等同于 start
+duclaw --help          # 帮助
+duclaw --version       # 版本
+```
+
+## 数据目录
+
+运行时数据默认存储在 `~/.duclaw/`：
+
+| 路径 | 说明 | 环境变量覆盖 |
+|------|------|-------------|
+| `~/.duclaw/cron/jobs.json` | 定时任务配置 | `JOB_PATH` |
+| `~/.duclaw/cron/` | 任务执行历史 | `JOB_HISTORY_DIR` |
+| `~/.duclaw/data/` | 临时文件 | `APP_TEMP_DIR` |
+
+## Docker 部署
+
+```bash
+cd docker
+# 编辑 .env 和 duclaw.json
+docker compose up -d
+```
+
+详见 [docker/README.md](docker/README.md)。
+
+## 开发
+
+```bash
+git clone <repo>
+cd agent-template-ts
+pnpm install
+
+# 复制并编辑配置
+cp .env.example .env
+# 编辑 duclaw.json
+
+# 启动开发
+pnpm start
+
+# 构建
+pnpm build
+```
+
+## 依赖
+
+- Node.js >= 18
+- Redis（无密码）
+- 飞书开放平台应用（用于 Channel 接入）
+
+## License
+
+Private

package/dist/bundle.js

@@ -30122,65 +30122,6 @@ var require_node_cron = __commonJS({
   }
 });
 
-// package.json
-var require_package3 = __commonJS({
-  "package.json"(exports2, module2) {
-    module2.exports = {
-      packageManager: "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39",
-      name: "dwclaw-cli",
-      version: "1.1.0",
-      description: "AI Agent \u7BA1\u7406\u6846\u67B6 - \u652F\u6301\u98DE\u4E66 Channel\u3001\u56E2\u961F\u534F\u4F5C\u3001\u5B9A\u65F6\u4EFB\u52A1\u3001Web \u7BA1\u7406\u754C\u9762",
-      bin: {
-        duclaw: "./dist/main.js"
-      },
-      files: [
-        "dist/",
-        "skills/",
-        ".claude/cron/",
-        "docker/Dockerfile",
-        "docker/docker-compose.yml",
-        "docker/entrypoint.sh",
-        "docker/duclaw.json",
-        "docker/.env"
-      ],
-      scripts: {
-        start: "npx tsx src/main.ts",
-        "dev:web": "cd web && pnpm dev",
-        build: "node build.js",
-        "build:tsc": "tsc",
-        "build:web": "cd web && pnpm build",
-        "build:all": "pnpm build:web && pnpm build"
-      },
-      dependencies: {
-        "@anthropic-ai/sdk": "^0.78.0",
-        "@hono/node-server": "^1.19.11",
-        "@larksuiteoapi/node-sdk": "^1.59.0",
-        "ali-oss": "^6.23.0",
-        "better-sqlite3": "^12.8.0",
-        chokidar: "^5.0.0",
-        dayjs: "^1.11.20",
-        diff: "^8.0.3",
-        dotenv: "^17.3.1",
-        hono: "^4.12.9",
-        "node-cron": "^4.2.1",
-        redis: "^5.11.0"
-      },
-      devDependencies: {
-        "@types/ali-oss": "^6.23.3",
-        "@types/better-sqlite3": "^7.6.13",
-        "@types/diff": "^8.0.0",
-        "@types/node": "^25.3.3",
-        "@types/node-cron": "^3.0.11",
-        esbuild: "^0.27.5",
-        "javascript-obfuscator": "^5.4.1",
-        tsx: "^4.21.0",
-        typescript: "^5.9.3",
-        vitest: "^4.0.18"
-      }
-    };
-  }
-});
-
 // src/cli/index.ts
 var import_fs = require("fs");
 var import_path = require("path");
@@ -30301,14 +30242,7 @@ function printHelp() {
 `);
 }
 function printVersion() {
-  try {
-    const pkgRoot = (0, import_path.resolve)(__dirname_m, "..", "..");
-    const pkgContent = (0, import_fs.readFileSync)((0, import_path.resolve)(pkgRoot, "package.json"), "utf-8");
-    const pkg = JSON.parse(pkgContent);
-    console.log(`duclaw v${pkg.version}`);
-  } catch {
-    console.log(`duclaw (version unknown)`);
-  }
+  console.log(`duclaw v${true ? "1.3.0" : "unknown"}`);
 }
 function getDuclawTemplate() {
   return {
@@ -37801,7 +37735,11 @@ var updateJob = (id, syntax, title, description) => {
   return { ...job };
 };
 var listJobs = () => {
-  const text2 = (0, import_fs5.readFileSync)(getJobPath(), `utf-8`);
+  const jobPath = getJobPath();
+  if (!(0, import_fs5.existsSync)(jobPath)) {
+    return [];
+  }
+  const text2 = (0, import_fs5.readFileSync)(jobPath, `utf-8`);
   if (!text2) {
     return [];
   }
@@ -38684,9 +38622,9 @@ var NodeFsHandler = class {
     if (this.fsw.closed) {
       return;
     }
-    const dirname8 = sp.dirname(file);
+    const dirname7 = sp.dirname(file);
     const basename4 = sp.basename(file);
-    const parent = this.fsw._getWatchedDir(dirname8);
+    const parent = this.fsw._getWatchedDir(dirname7);
     let prevStats = stats;
     if (parent.has(basename4))
       return;
@@ -38713,7 +38651,7 @@ var NodeFsHandler = class {
             prevStats = newStats2;
           }
         } catch (error) {
-          this.fsw._remove(dirname8, basename4);
+          this.fsw._remove(dirname7, basename4);
         }
       } else if (parent.has(basename4)) {
         const at = newStats.atimeMs;
@@ -39877,6 +39815,14 @@ var executeCustomJob = async (job) => {
   return await handler(job);
 };
 var startScheduler = () => {
+  const jobPath = getJobPath();
+  const jobDir = require("path").dirname(jobPath);
+  if (!(0, import_fs6.existsSync)(jobDir)) {
+    (0, import_fs6.mkdirSync)(jobDir, { recursive: true });
+  }
+  if (!(0, import_fs6.existsSync)(jobPath)) {
+    (0, import_fs6.writeFileSync)(jobPath, JSON.stringify({ jobs: [] }, null, "	"), "utf-8");
+  }
   loadAndScheduleJobs();
   watchJobsFile();
 };
@@ -40164,13 +40110,8 @@ var getSkillPaths = () => {
   let currentDir = __dirname_m;
   let projectRoot = "";
   while (currentDir !== "/") {
-    const claudePath = (0, import_path14.join)(currentDir, ".claude");
-    if ((0, import_fs8.existsSync)(claudePath) && (0, import_fs8.statSync)(claudePath).isDirectory()) {
+    if ((0, import_fs8.existsSync)((0, import_path14.join)(currentDir, "duclaw.json"))) {
       projectRoot = currentDir;
-      const skillsPath = (0, import_path14.join)(claudePath, "skills");
-      if ((0, import_fs8.existsSync)(skillsPath)) {
-        paths.push(skillsPath);
-      }
       break;
     }
     const parentDir = (0, import_path14.dirname)(currentDir);
@@ -40183,9 +40124,13 @@ var getSkillPaths = () => {
       paths.push(rootSkillsPath);
     }
   }
-  const globalSkillsPath = (0, import_path14.join)((0, import_os3.homedir)(), ".agents", "skills");
-  if ((0, import_fs8.existsSync)(globalSkillsPath) && (0, import_fs8.statSync)(globalSkillsPath).isDirectory()) {
-    paths.push(globalSkillsPath);
+  const duclawSkillsPath = (0, import_path14.join)((0, import_os3.homedir)(), ".duclaw", "skills");
+  if ((0, import_fs8.existsSync)(duclawSkillsPath) && (0, import_fs8.statSync)(duclawSkillsPath).isDirectory()) {
+    paths.push(duclawSkillsPath);
+  }
+  const agentsSkillsPath = (0, import_path14.join)((0, import_os3.homedir)(), ".agents", "skills");
+  if ((0, import_fs8.existsSync)(agentsSkillsPath) && (0, import_fs8.statSync)(agentsSkillsPath).isDirectory()) {
+    paths.push(agentsSkillsPath);
   }
   return paths;
 };
@@ -41455,7 +41400,7 @@ ${getSkillMeta()}
   const anthropicOptions = {
     baseURL: process.env.ANTHROPIC_BASE_URL,
     model: process.env.ANTHROPIC_MODEL,
-    apiKey: process.env.ANTHROPIC_AUTH_TOKEN || "a4fd749ac2824c55a88946fc13a50e23.VPMAm8nUNaAWWS3E",
+    apiKey: process.env.ANTHROPIC_AUTH_TOKEN,
     authStyle: process.env.ANTHROPIC_AUTH_STYLE || void 0
   };
   const llmClient = createAnthropicAdapter(anthropicOptions);
@@ -46364,9 +46309,8 @@ toolRoutes.get("/skills/:name", (c) => {
 var systemRoutes = new Hono2();
 var startTime = Date.now();
 systemRoutes.get("/system/info", (c) => {
-  const pkg = require_package3();
   return c.json({
-    version: pkg.version || "unknown",
+    version: true ? "1.3.0" : "unknown",
     uptime: Math.floor((Date.now() - startTime) / 1e3),
     env: process.env.NODE_ENV || "development",
     nodeVersion: process.version
@@ -46401,8 +46345,31 @@ var cliResult = handleCliCommand(process.argv.slice(2));
 if (cliResult !== void 0) {
   process.exit(cliResult);
 }
+function validateEnv() {
+  const errors = [];
+  const token = process.env.ANTHROPIC_AUTH_TOKEN;
+  if (!token || token === "your-api-key-here") {
+    errors.push("  - ANTHROPIC_AUTH_TOKEN \u672A\u8BBE\u7F6E\u6216\u4ECD\u4E3A\u5360\u4F4D\u7B26\uFF0C\u8BF7\u5728 .env \u4E2D\u586B\u5199\u6709\u6548\u7684 API Key");
+  }
+  if (!process.env.ANTHROPIC_BASE_URL) {
+    errors.push("  - ANTHROPIC_BASE_URL \u672A\u8BBE\u7F6E\uFF0C\u8BF7\u5728 .env \u4E2D\u586B\u5199 API \u5730\u5740");
+  }
+  if (!process.env.REDIS_URL) {
+    errors.push("  - REDIS_URL \u672A\u8BBE\u7F6E\uFF0C\u8BF7\u5728 .env \u4E2D\u586B\u5199 Redis \u8FDE\u63A5\u5730\u5740\uFF08\u5982 redis://localhost:6379\uFF09");
+  }
+  if (errors.length > 0) {
+    console.error(`
+[\u542F\u52A8\u5931\u8D25] \u73AF\u5883\u53D8\u91CF\u6821\u9A8C\u4E0D\u901A\u8FC7\uFF1A
+${errors.join("\n")}
+`);
+    console.error(`  \u63D0\u793A\uFF1A\u8FD0\u884C duclaw init \u53EF\u751F\u6210 .env \u6A21\u677F
+`);
+    process.exit(1);
+  }
+}
 async function main() {
   loadEnv();
+  validateEnv();
   const cfg = loadConfig();
   const { registry: registry2 } = createDefaultChannels();
   const channels = getAllChannels(registry2);