@dobby.ai/dobby 0.1.0 → 0.1.1

package/.env.example

@@ -1,4 +1,3 @@
-DISCORD_BOT_TOKEN=replace_me
 ANTHROPIC_AUTH_TOKEN=replace_me
 ANTHROPIC_API_KEY=replace_me
 ANTHROPIC_BASE_URL=

package/AGENTS.md

@@ -68,7 +68,7 @@ npm run plugins:setup:local
 - `src/cli/commands/start.ts`
   - 启动网关、创建数据目录、加载扩展、实例化 provider / connector / sandbox、启动 cron 服务、接管优雅退出
 - `src/cli/commands/init.ts`
-  - 首次初始化向导；会先安装所需扩展，再根据扩展 `configSchema` 交互生成配置
+  - 首次初始化向导；会安装所需扩展并生成带占位符的 starter 配置模板
 - `src/cli/commands/config*.ts`
   - `config show|list|edit|schema *` 与 `configure`
 - `src/cli/commands/topology.ts`
@@ -111,8 +111,8 @@ npm run plugins:setup:local
 
 - `providers.default` 必须存在于 `providers.items`
 - `sandboxes.default` 若存在且不是 `host.builtin`，必须存在于 `sandboxes.items`
-- `routes.defaults.provider` 若未设置，运行时回落到 `providers.default`
-- `routes.defaults.sandbox` 若未设置，运行时回落到 `sandboxes.default ?? host.builtin`
+- `routes.default.provider` 若未设置，运行时回落到 `providers.default`
+- `routes.default.sandbox` 若未设置，运行时回落到 `sandboxes.default ?? host.builtin`
 - 每条 route 在加载后都会补全 `provider`、`sandbox`、`tools`、`mentions`
 - `bindings.items[*].connector` 必须指向存在的 `connectors.items`
 - `bindings.items[*].route` 必须指向存在的 `routes.items`
@@ -133,8 +133,8 @@ npm run plugins:setup:local
   - `connectorId + platform + accountId + chatId + messageId`
 - 线程路由规则：
   - Discord 线程消息使用父频道 ID 查 `bindings.items`
-- Discord connector 当前只处理已绑定的 guild channel
-  - DM 在 connector 侧被直接忽略，虽然核心类型保留了 `isDirectMessage`
+- Discord guild channel 仍按显式 binding 匹配
+  - DM 会携带 `isDirectMessage` 进入 gateway，并可通过 `bindings.default` 回落到默认 route
 - mention 策略：
   - `mentions="required"` 时，群聊消息必须 @bot 才会进入 runtime
 - 控制命令：
@@ -159,7 +159,7 @@ npm run plugins:setup:local
 - 运行时加载来源只有 `<data.rootDir>/extensions/node_modules`
 - 宿主不会从自身依赖树、`plugins/*` 源码目录或 `dist` 外路径 fallback
 - `configSchema` 是可选的
-  - `init`、`configure`、`config edit` 会优先按 schema 交互提问
+  - `configure`、`config edit` 会优先按 schema 交互提问
   - `applyAndValidateContributionSchemas` 会用 Ajv 套默认值并验证实例配置
 
 当前仓库内的扩展源码与 contribution：
@@ -172,7 +172,7 @@ npm run plugins:setup:local
 
 注意：
 
-- `dobby init` 当前只内建选择 `provider.pi`、`provider.claude-cli` 和 `connector.discord`
+- `dobby init` 当前只内建选择 `provider.pi`、`provider.claude-cli`、`connector.discord` 和 `connector.feishu`
 - `provider.claude` 与 sandbox 扩展需要手工安装 / 启用 / 配置
 
 ## 7. Cron / 计划任务约束

package/README.md

@@ -17,14 +17,14 @@ Discord-first 本地 Agent Gateway。宿主只负责 CLI、网关主流程、扩
 
 - connector source -> binding -> route -> provider / sandbox
 - Discord 频道 / 线程接入；线程消息继续按父频道命中 binding
-- Feishu 长连接消息接入（self-built app，手工安装/配置）
+- Feishu 长连接消息接入（self-built app）
 - Feishu 出站支持普通文本和 Markdown 卡片；默认群内直发，不走 reply thread
 - conversation 级 runtime 复用与串行化
 - 扩展 store 安装、启用、列举与 schema 驱动配置
 - Discord 流式回复、typing、附件下载与图片输入
 - cron 调度：一次性、固定间隔、cron expression
-- 交互式初始化：`dobby init`
-- 交互式配置：`dobby configure` / `dobby config edit`
+- 交互式初始化：`dobby init`（支持多 provider / 多 connector starter）
+- 配置检查与 schema inspect：`dobby config show|list|schema`
 - 诊断与保守修复：`dobby doctor [--fix]`
 
 ## 架构概览
@@ -76,7 +76,7 @@ npm install
 npm run build
 ```
 
-3. 初始化最小可运行配置
+3. 初始化模板配置
 
 ```bash
 npm run start -- init
@@ -84,21 +84,41 @@ npm run start -- init
 
 `init` 会做这些事情：
 
-- 交互选择 provider 和 connector
+- 交互选择 provider 和 connector（均可多选）
 - 自动安装所选扩展到运行时 extension store
-- 优先使用扩展暴露的 `configSchema` 生成配置
+- 写入一份带占位符的 `gateway.json` 模板
+- 把 `routes.default.projectRoot` 设为当前工作目录
+- 为 direct message 生成 `bindings.default`，回落到默认 route
+- 为每个所选 connector 生成一个默认 binding 到同一条 route
 - 生成 `gateway.json`
-- 选择 `provider.pi` 且缺少 `models.custom.json` 时，自动创建该文件
+- `provider.pi` 默认写入最小 inline 配置，不再依赖 `models.custom.json`
 
-说明：当前 `init` 仍只内建 Discord connector。Feishu connector 需要通过 `extension install` + `config edit/configure` 手工启用。
+说明：当前 `init` 内建这些 starter 选择：
 
-4. 运行诊断
+- provider：`provider.pi`、`provider.claude-cli`
+- connector：`connector.discord`、`connector.feishu`
+
+4. 编辑 `gateway.json`
+
+把 `REPLACE_WITH_*` / `YOUR_*` 占位值替换成你的真实配置，例如：
+
+- `connectors.items[*]` 中的 token / appId / appSecret
+- `bindings.items[*].source.id`
+- `routes.items[*].projectRoot`（如需覆盖默认 project root）
+
+5. 运行诊断
 
 ```bash
 npm run start -- doctor
 ```
 
-5. 启动网关
+`doctor` 会同时检查：
+
+- 配置结构 / 引用关系
+- 缺失的扩展安装
+- `REPLACE_WITH_*` / `YOUR_*` 这类 init 占位值是否还未替换
+
+6. 启动网关
 
 ```bash
 npm run start --
@@ -107,7 +127,9 @@ npm run start --
 说明：
 
 - `dobby` 无子命令时，默认等价于 `dobby start`
+- `dobby --version` 可直接查看当前 CLI 版本
 - 在仓库内直接运行时，CLI 会自动使用 `./config/gateway.json`
+- 在仓库内执行 `init` / `extension install` 时，会优先安装 `plugins/*` 的本地构建产物
 - 也可以通过环境变量覆盖配置路径：
 
 ```bash
@@ -152,33 +174,23 @@ cron 配置路径优先级：
 顶层命令：
 
 ```bash
+dobby --version
 dobby start
 dobby init
-dobby configure
 dobby doctor [--fix]
 ```
 
-配置与拓扑：
+配置检查：
 
 ```bash
 dobby config show [section] [--json]
 dobby config list [section] [--json]
-dobby config edit [--section provider|connector|route|binding]
 dobby config schema list [--json]
 dobby config schema show <contributionId> [--json]
-
-dobby bot list [--json]
-dobby bot set <connectorId> [--name <name>] [--token <token>]
-
-dobby binding list [--connector <id>] [--json]
-dobby binding set <bindingId> --connector <id> --source-type channel|chat --source-id <id> --route <id>
-dobby binding remove <bindingId>
-
-dobby route list [--json]
-dobby route set <routeId> [--project-root <path>] [--tools full|readonly] [--provider <id>] [--sandbox <id>] [--mentions required|optional]
-dobby route remove <routeId> [--cascade-bindings]
 ```
 
+配置变更建议直接编辑 `gateway.json`，再通过 `dobby doctor` 或 `dobby start` 做校验。
+
 扩展管理：
 
 ```bash
@@ -221,15 +233,17 @@ dobby cron remove <jobId>
   - 默认 provider instance ID
 - `providers.items[*].type` / `connectors.items[*].type` / `sandboxes.items[*].type`
   - 指向某个 contribution，实例配置直接内联在对象里
-- `routes.defaults`
-  - 统一提供 route 默认的 `provider`、`sandbox`、`tools`、`mentions`
+- `routes.default`
+  - 统一提供 route 默认的 `projectRoot`、`provider`、`sandbox`、`tools`、`mentions`
 - `routes.items[*]`
-  - route 是可复用的执行 profile，定义 `projectRoot`，并按需覆盖 `provider`、`sandbox`、`tools`、`mentions`、`systemPromptFile`
+  - route 是可复用的执行 profile，可继承默认 `projectRoot`，并按需覆盖 `provider`、`sandbox`、`tools`、`mentions`、`systemPromptFile`
+- `bindings.default`
+  - direct message 未命中显式 binding 时使用的默认 route fallback
 - `bindings.items[*]`
   - `(connector, source.type, source.id) -> route` 的入口绑定
 - `sandboxes.default`
   - 未指定时默认使用 `host.builtin`
-- 未匹配 binding 的入站消息会被直接忽略，不存在 default route fallback
+- 未匹配 binding 的入站消息会被直接忽略；仅 direct message 可回落到 `bindings.default`
 
 当前代码还保留但未真正生效的字段：
 
@@ -239,7 +253,24 @@ dobby cron remove <jobId>
 
 - gateway：[`config/gateway.example.json`](config/gateway.example.json)
 - cron：[`config/cron.example.json`](config/cron.example.json)
-- provider.pi 自定义模型：[`config/models.custom.example.json`](config/models.custom.example.json)
+
+`provider.pi` 现在使用 inline custom provider 配置。最小常用字段是：
+
+- `model`
+- `baseUrl`
+- `apiKey`
+
+这些字段默认自动补齐：
+
+- `provider = "custom-openai"`
+- `api = "openai-completions"`
+- `authHeader = false`
+- `thinkingLevel = "off"`
+- `models = [{ id: model }]`
+
+只有在你需要多模型元数据或覆盖能力参数时，才需要手工展开 `models`。
+
+`apiKey` 支持直接写 literal，也支持写环境变量名，由 `pi` 的 `AuthStorage` / `ModelRegistry` 按上游规则解析。
 
 ## 扩展包与 contribution
 
@@ -255,7 +286,7 @@ dobby cron remove <jobId>
 `dobby init` 当前只内建这些 starter 选择：
 
 - provider：`provider.pi`、`provider.claude-cli`
-- connector：`connector.discord`
+- connector：`connector.discord`、`connector.feishu`
 
 `provider.claude` 与 sandbox 相关扩展需要手工安装和配置，例如：
 
@@ -298,7 +329,8 @@ npm run start -- cron add daily-report \
 
 ## Discord 连接器的当前行为
 
-- 只处理已绑定的 guild channel，DM 目前禁用
+- guild channel 仍按显式 binding 匹配
+- DM 可通过 `bindings.default` 回落到默认 route
 - 线程消息使用父频道 ID 做 binding 查找
 - 会自动下载附件到本地
 - 图片会作为 image input 传给 provider
@@ -372,7 +404,7 @@ npm run plugins:build
 
 - `npm run dev:local` 与 `npm run start:local` 会尝试读取 `.env`
 - 普通 `npm run start -- ...` 不会自动载入 `.env`
-- 配置编辑流优先使用扩展 `configSchema`，无 schema 时退回 JSON 输入
+- `dobby init` 生成的是模板配置；运行前先替换 `gateway.json` 中的 placeholder
 
 ## 相关文档
 

package/config/gateway.example.json

@@ -24,10 +24,9 @@
     "items": {
       "pi.main": {
         "type": "provider.pi",
-        "provider": "custom-openai",
-        "model": "example-model",
-        "thinkingLevel": "off",
-        "modelsFile": "./models.custom.json"
+        "model": "REPLACE_WITH_PROVIDER_MODEL_ID",
+        "baseUrl": "REPLACE_WITH_PROVIDER_BASE_URL",
+        "apiKey": "REPLACE_WITH_PROVIDER_API_KEY_OR_ENV"
       }
     }
   },
@@ -47,19 +46,24 @@
     "items": {}
   },
   "routes": {
-    "defaults": {
+    "default": {
+      "projectRoot": "/Users/you/workspace/dobby",
       "provider": "pi.main",
       "sandbox": "host.builtin",
       "tools": "full",
       "mentions": "required"
     },
     "items": {
+      "main": {},
       "projectA": {
         "projectRoot": "/Users/you/workspace/project-a"
       }
     }
   },
   "bindings": {
+    "default": {
+      "route": "main"
+    },
     "items": {
       "discord.main.projectA": {
         "connector": "discord.main",
@@ -125,4 +129,4 @@
     "rootDir": "./data",
     "dedupTtlMs": 604800000
   }
-}
+}

package/dist/plugins/connector-discord/src/mapper.js

@@ -0,0 +1,75 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+function stripBotMention(text, botUserId) {
+    const mentionRegex = new RegExp(`<@!?${botUserId}>`, "g");
+    return text.replace(mentionRegex, "").trim();
+}
+function sanitizeFileName(value) {
+    return value.replaceAll(/[^a-zA-Z0-9._-]/g, "_");
+}
+async function downloadAttachment(url, targetPath) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download attachment from ${url}: ${response.status}`);
+    }
+    const data = await response.arrayBuffer();
+    await mkdir(dirname(targetPath), { recursive: true });
+    await writeFile(targetPath, Buffer.from(data));
+}
+function mapAttachmentBase(messageAttachment) {
+    return {
+        id: messageAttachment.id,
+        size: messageAttachment.size,
+        remoteUrl: messageAttachment.url,
+        ...(messageAttachment.name ? { fileName: messageAttachment.name } : {}),
+        ...(messageAttachment.contentType ? { mimeType: messageAttachment.contentType } : {}),
+    };
+}
+export async function mapDiscordMessage(message, connectorId, botUserId, sourceId, attachmentsRoot, logger) {
+    if (message.author.bot)
+        return null;
+    const isDirectMessage = message.guildId == null;
+    const mentionedBot = message.mentions.users.has(botUserId);
+    const chatId = message.channelId;
+    const threadId = message.channel.isThread() ? message.channelId : undefined;
+    const cleanedText = stripBotMention(message.content ?? "", botUserId);
+    const attachments = [];
+    for (const attachment of message.attachments.values()) {
+        const base = mapAttachmentBase(attachment);
+        const attachmentDir = join(attachmentsRoot, sourceId, message.id);
+        const fileName = sanitizeFileName(attachment.name ?? attachment.id);
+        const localPath = join(attachmentDir, fileName);
+        try {
+            await downloadAttachment(attachment.url, localPath);
+            attachments.push({
+                ...base,
+                localPath,
+            });
+        }
+        catch (error) {
+            logger.warn({ err: error, attachmentUrl: attachment.url }, "Failed to download Discord attachment; keeping metadata only");
+            attachments.push(base);
+        }
+    }
+    return {
+        connectorId,
+        platform: "discord",
+        accountId: botUserId,
+        source: {
+            type: "channel",
+            id: sourceId,
+        },
+        chatId,
+        messageId: message.id,
+        userId: message.author.id,
+        userName: message.author.username,
+        text: cleanedText,
+        attachments,
+        timestampMs: message.createdTimestamp,
+        raw: message.toJSON(),
+        isDirectMessage,
+        mentionedBot,
+        ...(message.guildId ? { guildId: message.guildId } : {}),
+        ...(threadId ? { threadId } : {}),
+    };
+}

package/dist/src/cli/commands/doctor.js

@@ -7,6 +7,33 @@ import { ensureGatewayConfigShape, setDefaultProviderIfMissingOrInvalid, } from
 import { DISCORD_CONNECTOR_CONTRIBUTION_ID } from "../shared/discord-config.js";
 import { readRawConfig, resolveConfigPath, resolveDataRootDir, writeConfigWithValidation } from "../shared/config-io.js";
 import { createLogger } from "../shared/runtime.js";
+function isPlaceholderValue(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    const normalized = value.trim().toUpperCase();
+    return normalized.includes("REPLACE_WITH_") || normalized.includes("YOUR_");
+}
+function isCredentialLikeKey(key) {
+    return /(?:token|secret|api[-_]?key|appid|appsecret)/i.test(key);
+}
+function walkPlaceholders(value, path) {
+    if (isPlaceholderValue(value)) {
+        return [{ path, value }];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item, index) => walkPlaceholders(item, `${path}[${index}]`));
+    }
+    if (!value || typeof value !== "object") {
+        return [];
+    }
+    return Object.entries(value).flatMap(([key, nested]) => walkPlaceholders(nested, `${path}.${key}`));
+}
+function lastPathSegment(path) {
+    const withoutIndexes = path.replaceAll(/\[\d+\]/g, "");
+    const segments = withoutIndexes.split(".");
+    return segments[segments.length - 1] ?? withoutIndexes;
+}
 function expandHome(value) {
     if (value === "~") {
         return homedir();
@@ -76,6 +103,15 @@ export async function runDoctorCommand(options) {
                 message: `providers.items['${instanceId}'] references missing contribution '${instance.type}'`,
             });
         }
+        for (const hit of walkPlaceholders(instance, `providers.items['${instanceId}']`)) {
+            if (hit.path.endsWith(".type")) {
+                continue;
+            }
+            issues.push({
+                level: isCredentialLikeKey(lastPathSegment(hit.path)) ? "error" : "warning",
+                message: `${hit.path} still uses placeholder value '${hit.value}'`,
+            });
+        }
     }
     for (const [instanceId, instance] of Object.entries(normalized.connectors.items)) {
         if (!availableContributionIds.has(instance.type)) {
@@ -84,6 +120,15 @@ export async function runDoctorCommand(options) {
                 message: `connectors.items['${instanceId}'] references missing contribution '${instance.type}'`,
             });
         }
+        for (const hit of walkPlaceholders(instance, `connectors.items['${instanceId}']`)) {
+            if (hit.path.endsWith(".type")) {
+                continue;
+            }
+            issues.push({
+                level: isCredentialLikeKey(lastPathSegment(hit.path)) ? "error" : "warning",
+                message: `${hit.path} still uses placeholder value '${hit.value}'`,
+            });
+        }
         if (instance.type === DISCORD_CONNECTOR_CONTRIBUTION_ID) {
             const botName = typeof instance.botName === "string" ? instance.botName.trim() : "";
             const botToken = typeof instance.botToken === "string" ? instance.botToken.trim() : "";
@@ -109,18 +154,46 @@ export async function runDoctorCommand(options) {
             });
         }
     }
+    if (normalized.routes.default.projectRoot && isPlaceholderValue(normalized.routes.default.projectRoot)) {
+        issues.push({
+            level: "warning",
+            message: `routes.default.projectRoot still uses placeholder value '${normalized.routes.default.projectRoot}'`,
+        });
+    }
     for (const [routeId, route] of Object.entries(normalized.routes.items)) {
+        const effectiveProjectRoot = route.projectRoot ?? normalized.routes.default.projectRoot;
+        const projectRootSource = route.projectRoot ? `routes.items['${routeId}'].projectRoot` : "routes.default.projectRoot";
+        if (!effectiveProjectRoot) {
+            issues.push({
+                level: "error",
+                message: `routes.items['${routeId}'].projectRoot is required when routes.default.projectRoot is not set`,
+            });
+            continue;
+        }
+        if (isPlaceholderValue(effectiveProjectRoot)) {
+            issues.push({
+                level: "warning",
+                message: `${projectRootSource} still uses placeholder value '${effectiveProjectRoot}'`,
+            });
+            continue;
+        }
         try {
-            const projectRootPath = resolveRouteProjectRoot(configPath, route.projectRoot);
+            const projectRootPath = resolveRouteProjectRoot(configPath, effectiveProjectRoot);
             await access(projectRootPath);
         }
         catch {
             issues.push({
                 level: "warning",
-                message: `routes.items['${routeId}'].projectRoot does not exist: ${route.projectRoot}`,
+                message: `${projectRootSource} does not exist: ${effectiveProjectRoot}`,
             });
         }
     }
+    if (normalized.bindings.default && !normalized.routes.items[normalized.bindings.default.route]) {
+        issues.push({
+            level: "error",
+            message: `bindings.default.route references unknown route '${normalized.bindings.default.route}'`,
+        });
+    }
     const seenBindingSources = new Map();
     for (const [bindingId, binding] of Object.entries(normalized.bindings.items)) {
         if (!normalized.connectors.items[binding.connector]) {
@@ -135,6 +208,12 @@ export async function runDoctorCommand(options) {
                 message: `bindings.items['${bindingId}'].route references unknown route '${binding.route}'`,
             });
         }
+        if (isPlaceholderValue(binding.source.id)) {
+            issues.push({
+                level: "warning",
+                message: `bindings.items['${bindingId}'].source.id still uses placeholder value '${binding.source.id}'`,
+            });
+        }
         const bindingKey = `${binding.connector}:${binding.source.type}:${binding.source.id}`;
         const existingBindingId = seenBindingSources.get(bindingKey);
         if (existingBindingId) {

package/dist/src/cli/commands/extension.js

@@ -3,6 +3,7 @@ import { loadGatewayConfig } from "../../core/routing.js";
 import { ExtensionStoreManager } from "../../extension/manager.js";
 import { applyContributionTemplates, buildContributionTemplates, ensureGatewayConfigShape, listContributionIds, setDefaultProviderIfMissingOrInvalid, upsertAllowListPackage, } from "../shared/config-mutators.js";
 import { readRawConfig, requireRawConfig, resolveConfigPath, resolveDataRootDir, writeConfigWithValidation } from "../shared/config-io.js";
+import { resolveExtensionInstallSpecs } from "../shared/local-extension-specs.js";
 import { createLogger } from "../shared/runtime.js";
 /**
  * Resolves extension store directory from normalized gateway config.
@@ -25,7 +26,8 @@ export async function runExtensionInstallCommand(options) {
     const logger = createLogger();
     const rawConfig = (await readRawConfig(configPath)) ?? {};
     const manager = new ExtensionStoreManager(logger, extensionStoreDirFromRaw(configPath, rawConfig));
-    const installed = await manager.install(options.spec);
+    const [resolvedSpec] = await resolveExtensionInstallSpecs([options.spec]);
+    const installed = await manager.install(resolvedSpec ?? options.spec);
     if (!options.enable) {
         const templates = buildContributionTemplates(installed.manifest.contributions);
         if (options.json) {