@dobby.ai/dobby 0.1.0

package/.env.example

@@ -0,0 +1,9 @@
+DISCORD_BOT_TOKEN=replace_me
+ANTHROPIC_AUTH_TOKEN=replace_me
+ANTHROPIC_API_KEY=replace_me
+ANTHROPIC_BASE_URL=
+ANTHROPIC_MODEL=
+API_TIMEOUT_MS=600000
+CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+CUSTOM_PROVIDER_AUTH_TOKEN=replace_me
+LOG_LEVEL=info

package/AGENTS.md

@@ -0,0 +1,267 @@
+# AGENTS Guide (dobby)
+
+本文件给在本仓库内工作的 AI / 自动化代理使用。目标是让文档、代码和配置改动都以当前实现为准，而不是沿用已经过时的假设。
+
+## 1. 项目定位
+
+- 项目名：`dobby`
+- 形态：Discord-first 本地 Agent Gateway，宿主负责 CLI、网关主流程、扩展加载、计划任务调度
+- 扩展模型：Provider / Connector / Sandbox 全部通过扩展 contribution 接入
+- 运行时扩展目录固定：`<data.rootDir>/extensions`
+- 启用模型：`extensions.allowList` 只声明“允许加载”，安装与卸载由 `dobby extension *` 管理
+- 当前仓库内维护的扩展包 scope 是 `@dobby.ai/*`
+- 代码事实优先级：
+  - 第一优先级：`src/*`
+  - 第二优先级：`config/gateway.example.json`、`config/cron.example.json`
+  - 第三优先级：`docs/*`
+  - 不要把仓库中的 `config/gateway.json` 当作通用示例，它可能包含本地机器路径、私有包名或敏感 token
+
+## 2. 技术栈与常用命令
+
+- Node.js `>=20`
+- TypeScript + ESM（`module: NodeNext`，`strict: true`）
+- 宿主核心依赖：`commander`、`pino`、`zod`、`ajv`、`@mariozechner/pi-ai`、`cron-parser`
+
+仓库根目录常用命令：
+
+```bash
+npm install
+npm run check
+npm run build
+npm run test:cli
+npm run start --
+npm run start -- doctor
+DOBBY_CONFIG_PATH=./config/gateway.json npm run start --
+```
+
+本地开发辅助命令：
+
+```bash
+npm run dev
+npm run dev:local
+npm run start:local
+```
+
+插件开发命令（由 `scripts/local-extensions.mjs` 驱动）：
+
+```bash
+npm run plugins:install
+npm run plugins:check
+npm run plugins:build
+npm run extensions:install:local
+npm run extensions:list:local
+npm run plugins:setup:local
+```
+
+注意：
+
+- 普通运行路径不会自动读取 `.env`
+- 只有 `npm run dev:local` 和 `npm run start:local` 使用 `--env-file-if-exists=.env`
+- Discord connector 仍以显式 `botToken` 配置为主
+
+## 3. 代码结构与职责
+
+- `src/main.ts`
+  - CLI 入口，仅调用 `runCli`
+- `src/cli/program.ts`
+  - 注册全部顶层命令：`start`、`init`、`configure`、`config`、`bot`、`channel`、`route`、`extension`、`doctor`、`cron`
+- `src/cli/commands/start.ts`
+  - 启动网关、创建数据目录、加载扩展、实例化 provider / connector / sandbox、启动 cron 服务、接管优雅退出
+- `src/cli/commands/init.ts`
+  - 首次初始化向导；会先安装所需扩展，再根据扩展 `configSchema` 交互生成配置
+- `src/cli/commands/config*.ts`
+  - `config show|list|edit|schema *` 与 `configure`
+- `src/cli/commands/topology.ts`
+  - `bot/channel/route` 管理命令
+- `src/cli/commands/extension.ts`
+  - 运行时扩展 store 的安装、卸载、列举，以及 `--enable` 自动写入 allowList / 模板实例
+- `src/cli/commands/cron.ts`
+  - 计划任务 CRUD、状态查看、手动触发
+- `src/core/gateway.ts`
+  - 入站消息与计划任务的统一执行入口：去重、控制命令、路由解析、mention 策略、runtime 获取、事件转发、错误回写
+- `src/core/runtime-registry.ts`
+  - conversation 级 runtime 复用、串行队列、取消、reset、closeAll
+- `src/core/control-command.ts`
+  - 控制命令解析：`stop` / `/stop` / `/cancel` / `/new` / `/reset`
+- `src/core/routing.ts`
+  - `gateway.json` 的 zod 校验、相对路径归一化、legacy 字段拒绝、引用关系校验
+- `src/core/dedup-store.ts`
+  - 去重 TTL 持久化，文件位置：`data/state/dedup.json`
+- `src/agent/event-forwarder.ts`
+  - 统一处理流式增量、tool 事件、不同 connector `updateStrategy`
+- `src/extension/manager.ts`
+  - 初始化扩展 store、调用 npm 安装 / 卸载、列出已安装扩展
+- `src/extension/loader.ts`
+  - 只从 `<data.rootDir>/extensions/node_modules` 解析 allowList 包并加载 contribution
+- `src/extension/registry.ts`
+  - 注册 contribution，暴露实例创建与 `configSchema` catalog
+- `src/cron/*`
+  - cron 配置解析、状态存储、调度与失败退避
+- `src/sandbox/*`
+  - 宿主执行器接口和内置 `HostExecutor`
+- `plugins/*`
+  - 本地维护的扩展源码：`connector-discord`、`provider-pi`、`provider-claude-cli`、`provider-claude`、`sandbox-core`、`plugin-sdk`
+  - 运行时不会从这里 fallback 加载
+
+## 4. 配置模型不变量
+
+配置入口是 `gateway.json`，结构以 `src/core/routing.ts` 为准。
+
+必须保持以下事实成立：
+
+- `providers.default` 必须存在于 `providers.items`
+- `sandboxes.default` 若存在且不是 `host.builtin`，必须存在于 `sandboxes.items`
+- `routes.defaults.provider` 若未设置，运行时回落到 `providers.default`
+- `routes.defaults.sandbox` 若未设置，运行时回落到 `sandboxes.default ?? host.builtin`
+- 每条 route 在加载后都会补全 `provider`、`sandbox`、`tools`、`mentions`
+- `bindings.items[*].connector` 必须指向存在的 `connectors.items`
+- `bindings.items[*].route` 必须指向存在的 `routes.items`
+- 同一个 `(connector, source.type, source.id)` 只能出现一次
+- `providers/connectors/sandboxes.items[*].type` 必须能在“已安装且已启用的扩展 contribution”里找到
+- `data.rootDir`、`projectRoot`、`systemPromptFile` 都会在加载时转成绝对路径
+- `data.rootDir` 的相对路径有一条特殊规则：
+  - 如果配置文件位于 `.../config/gateway.json` 且父目录是 dobby 仓库根目录，则相对仓库根目录解析
+  - 否则相对配置文件所在目录解析
+- `projectRoot`、`systemPromptFile` 等其他相对路径统一相对配置文件所在目录解析
+- connector 私有 config 不能再承载入口映射；入口绑定统一写在 `bindings.items`
+
+## 5. 运行时行为不变量
+
+- 会话串行粒度：
+  - `connectorId + platform + accountId + chatId + threadId(root)`
+- 去重键：
+  - `connectorId + platform + accountId + chatId + messageId`
+- 线程路由规则：
+  - Discord 线程消息使用父频道 ID 查 `bindings.items`
+- Discord connector 当前只处理已绑定的 guild channel
+  - DM 在 connector 侧被直接忽略，虽然核心类型保留了 `isDirectMessage`
+- mention 策略：
+  - `mentions="required"` 时，群聊消息必须 @bot 才会进入 runtime
+- 控制命令：
+  - `stop`、`/stop`、`/cancel` 会取消当前与排队中的该会话任务
+  - `/new`、`/reset` 会 reset runtime，并在 provider 支持时归档历史 session
+- 附件处理：
+  - Discord / Feishu 附件优先下载到 `data/attachments/<connectorId>/<source.id>/<messageId>/...`
+  - 图片转为 `session.prompt(..., { images })`
+  - 非图片附件路径或远程 URL 以 `<attachments>...</attachments>` 注入 prompt
+- 流式输出：
+  - 行为受 connector `updateStrategy` 控制，当前 Discord 是 `edit`
+- 错误策略：
+  - 主流程异常会向 connector 写回 `Error: ...`
+  - 流式更新、typing、tool 状态发送失败只记 warning，不应打崩进程
+
+## 6. 扩展系统约束
+
+- 扩展包必须包含 `dobby.manifest.json`
+- `manifest.contributions[*].entry` 必须指向包内已构建的 `.js/.mjs/.cjs`
+- entry 必须位于包根目录内部，禁止路径越界
+- 模块导出必须提供有效 contribution，对应 `kind` 必须和 manifest 一致
+- 运行时加载来源只有 `<data.rootDir>/extensions/node_modules`
+- 宿主不会从自身依赖树、`plugins/*` 源码目录或 `dist` 外路径 fallback
+- `configSchema` 是可选的
+  - `init`、`configure`、`config edit` 会优先按 schema 交互提问
+  - `applyAndValidateContributionSchemas` 会用 Ajv 套默认值并验证实例配置
+
+当前仓库内的扩展源码与 contribution：
+
+- `@dobby.ai/connector-discord` -> `connector.discord`
+- `@dobby.ai/provider-pi` -> `provider.pi`
+- `@dobby.ai/provider-claude-cli` -> `provider.claude-cli`
+- `@dobby.ai/provider-claude` -> `provider.claude`
+- `@dobby.ai/sandbox-core` -> `sandbox.boxlite`、`sandbox.docker`
+
+注意：
+
+- `dobby init` 当前只内建选择 `provider.pi`、`provider.claude-cli` 和 `connector.discord`
+- `provider.claude` 与 sandbox 扩展需要手工安装 / 启用 / 配置
+
+## 7. Cron / 计划任务约束
+
+- 启动时总会加载 cron 配置，并在缺失时自动创建默认文件
+- cron 配置路径优先级：
+  - `--cron-config`
+  - `DOBBY_CRON_CONFIG_PATH`
+  - 与 gateway 配置同目录下的 `cron.json`
+  - fallback 到 `<data.rootDir>/state/cron.config.json`
+- job 支持三种 schedule：
+  - `at`
+  - `every`
+  - `cron`
+- 状态存储：
+  - job store：`cron-jobs.json`
+  - run log：`cron-runs.jsonl`
+- 调度器支持：
+  - `maxConcurrentRuns`
+  - 启动时补跑 `runMissedOnStartup`
+  - 连续失败退避重试
+- 当前真实运行语义：
+  - 所有 scheduled run 都走 `Gateway.handleScheduled`
+  - conversation key 固定为 `cron:<runId>`
+  - runtime 始终按 `stateless + ephemeral` 执行
+  - `cron` CLI / store 虽然有 `sessionPolicy` 字段，但当前调度路径没有把它传到运行时
+
+## 8. 文档和代码改动建议
+
+- 改配置模型时，同步检查：
+  - `src/core/types.ts`
+  - `src/core/routing.ts`
+  - `src/cli/shared/config-types.ts`
+  - `src/cli/shared/config-mutators.ts`
+  - `src/cli/shared/configure-sections.ts`
+  - `config/gateway.example.json`
+  - `README.md`
+- 改 CLI 时，同步检查：
+  - `src/cli/program.ts`
+  - 对应 `src/cli/commands/*.ts`
+  - `README.md`
+- 改扩展加载链路时，同步检查：
+  - `src/extension/manager.ts`
+  - `src/extension/loader.ts`
+  - `src/extension/registry.ts`
+  - `docs/EXTENSION_SYSTEM_ARCHITECTURE.md`
+- 改计划任务时，同步检查：
+  - `src/cron/config.ts`
+  - `src/cron/store.ts`
+  - `src/cron/service.ts`
+  - `src/cli/commands/cron.ts`
+  - `config/cron.example.json`
+  - `docs/CRON_SCHEDULER_DESIGN.md`
+- 涉及执行器和路径边界时优先保守，避免放宽 `projectRoot` / `workspaceRoot` 约束
+
+## 9. 提交前最小校验
+
+默认最小校验：
+
+```bash
+npm run check
+npm run build
+npm run test:cli
+```
+
+如果改了插件实现，额外执行：
+
+```bash
+npm run plugins:check
+npm run plugins:build
+```
+
+如果改了扩展安装 / 加载链路，建议再执行：
+
+```bash
+npm run extensions:list:local
+```
+
+手工冒烟建议：
+
+1. 启动后确认日志包含 `Extension packages loaded`、`Discord connector ready`、`Cron scheduler started`（若启用）以及 `Gateway started`
+2. 在映射频道 @bot 发消息，确认流式更新与 typing
+3. 发送 `stop` 或 `/cancel`，确认能取消当前会话
+4. 发送 `/new` 或 `/reset`，确认会话被重置且 provider 归档成功
+5. 若启用 cron，执行 `dobby cron run <jobId>` 并确认正在运行的 gateway 会在下一次 scheduler tick 执行任务
+
+## 10. 当前已知边界
+
+- 有一批 focused tests，但仍缺少端到端自动化测试
+- cron job 的 `sessionPolicy` 目前是 schema / CLI 字段，调度执行时未生效
+- Discord connector 仍不处理 DM
+- `extension uninstall` 不会自动清理 `gateway.json` 中的 allowList 和实例引用

package/README.md

@@ -0,0 +1,382 @@
+# dobby
+
+Discord-first 本地 Agent Gateway。宿主只负责 CLI、网关主流程、扩展加载和计划任务调度；Provider / Connector / Sandbox 通过扩展 contribution 接入。
+
+当前仓库内维护的扩展包：
+
+- `@dobby.ai/connector-discord`
+- `@dobby.ai/connector-feishu`
+- `@dobby.ai/provider-pi`
+- `@dobby.ai/provider-claude-cli`
+- `@dobby.ai/provider-claude`
+- `@dobby.ai/sandbox-core`
+
+文档默认以 `@dobby.ai/*` 为准，不再把旧 `@dobby/*` 作为推荐配置。
+
+## 核心能力
+
+- connector source -> binding -> route -> provider / sandbox
+- Discord 频道 / 线程接入；线程消息继续按父频道命中 binding
+- 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 doctor [--fix]`
+
+## 架构概览
+
+```text
+Discord / Cron
+    -> Connector
+    -> Gateway
+       -> Dedup / Control Commands / Binding Resolver / Route Resolver
+       -> Runtime Registry
+       -> Provider Runtime
+       -> Sandbox Executor
+    -> Event Forwarder
+    -> Connector Reply
+```
+
+主要目录：
+
+- `src/cli`：CLI 程序和各子命令
+- `src/core`：gateway 主流程、路由、去重、runtime registry
+- `src/extension`：扩展 store、manifest 解析、扩展加载与实例化
+- `src/cron`：计划任务配置、持久化与调度
+- `src/sandbox`：宿主执行器接口与 `HostExecutor`
+- `plugins/*`：本地维护的扩展源码
+- `config/*.example.json`：示例配置
+
+注意：运行时只从 `<data.rootDir>/extensions/node_modules` 加载扩展，不会从 `plugins/*` 源码目录 fallback。
+
+## 环境要求
+
+- Node.js `>=20`
+- npm
+- 对应 provider / connector 的外部运行条件
+  - 例如 Discord bot token
+  - Claude CLI 或 Claude Agent SDK 所需认证
+  - 可选的 Docker / Boxlite 运行环境
+
+## 快速开始
+
+1. 安装依赖
+
+```bash
+npm install
+```
+
+2. 构建
+
+```bash
+npm run build
+```
+
+3. 初始化最小可运行配置
+
+```bash
+npm run start -- init
+```
+
+`init` 会做这些事情：
+
+- 交互选择 provider 和 connector
+- 自动安装所选扩展到运行时 extension store
+- 优先使用扩展暴露的 `configSchema` 生成配置
+- 生成 `gateway.json`
+- 选择 `provider.pi` 且缺少 `models.custom.json` 时，自动创建该文件
+
+说明：当前 `init` 仍只内建 Discord connector。Feishu connector 需要通过 `extension install` + `config edit/configure` 手工启用。
+
+4. 运行诊断
+
+```bash
+npm run start -- doctor
+```
+
+5. 启动网关
+
+```bash
+npm run start --
+```
+
+说明：
+
+- `dobby` 无子命令时，默认等价于 `dobby start`
+- 在仓库内直接运行时，CLI 会自动使用 `./config/gateway.json`
+- 也可以通过环境变量覆盖配置路径：
+
+```bash
+DOBBY_CONFIG_PATH=./config/gateway.json npm run start --
+```
+
+## 配置文件路径
+
+gateway 配置路径优先级：
+
+1. `DOBBY_CONFIG_PATH`
+2. 当前目录向上查找 dobby 仓库时的 `./config/gateway.json`
+3. 默认 `~/.dobby/gateway.json`
+
+cron 配置路径优先级：
+
+1. `--cron-config`
+2. `DOBBY_CRON_CONFIG_PATH`
+3. 与 gateway 配置同目录的 `cron.json`
+4. `<data.rootDir>/state/cron.config.json`
+
+如果 cron 配置文件不存在，启动时会自动生成默认文件。
+
+## 运行时目录
+
+`data.rootDir` 默认是 `./data`。如果配置文件是仓库内的 `./config/gateway.json`，它会相对仓库根目录解析；否则相对配置文件所在目录解析。加载后会生成这些目录：
+
+- `sessions/`
+- `attachments/`
+- `logs/`
+- `state/`
+- `extensions/`
+
+扩展 store 实际路径是：
+
+```text
+<data.rootDir>/extensions/node_modules/*
+```
+
+## CLI 概览
+
+顶层命令：
+
+```bash
+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]
+```
+
+扩展管理：
+
+```bash
+dobby extension install <packageSpec>
+dobby extension install <packageSpec> --enable
+dobby extension uninstall <packageName>
+dobby extension list [--json]
+```
+
+计划任务：
+
+```bash
+dobby cron add <name> --prompt <text> --connector <id> --route <id> --channel <id> [--thread <id>] [--at <iso> | --every-ms <ms> | --cron <expr>] [--tz <tz>]
+dobby cron list [--json]
+dobby cron status [jobId] [--json]
+dobby cron run <jobId>
+dobby cron update <jobId> ...
+dobby cron pause <jobId>
+dobby cron resume <jobId>
+dobby cron remove <jobId>
+```
+
+## Gateway 配置模型
+
+顶层结构：
+
+- `extensions`
+- `providers`
+- `connectors`
+- `sandboxes`
+- `routes`
+- `bindings`
+- `data`
+
+关键语义：
+
+- `extensions.allowList`
+  - 只声明启用状态，不负责安装
+- `providers.default`
+  - 默认 provider instance ID
+- `providers.items[*].type` / `connectors.items[*].type` / `sandboxes.items[*].type`
+  - 指向某个 contribution，实例配置直接内联在对象里
+- `routes.defaults`
+  - 统一提供 route 默认的 `provider`、`sandbox`、`tools`、`mentions`
+- `routes.items[*]`
+  - route 是可复用的执行 profile，定义 `projectRoot`，并按需覆盖 `provider`、`sandbox`、`tools`、`mentions`、`systemPromptFile`
+- `bindings.items[*]`
+  - `(connector, source.type, source.id) -> route` 的入口绑定
+- `sandboxes.default`
+  - 未指定时默认使用 `host.builtin`
+- 未匹配 binding 的入站消息会被直接忽略，不存在 default route fallback
+
+当前代码还保留但未真正生效的字段：
+
+- cron job 的 `sessionPolicy`
+
+示例配置：
+
+- 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)
+
+## 扩展包与 contribution
+
+仓库内现有 contribution：
+
+- `connector.discord`
+- `provider.pi`
+- `provider.claude-cli`
+- `provider.claude`
+- `sandbox.boxlite`
+- `sandbox.docker`
+
+`dobby init` 当前只内建这些 starter 选择：
+
+- provider：`provider.pi`、`provider.claude-cli`
+- connector：`connector.discord`
+
+`provider.claude` 与 sandbox 相关扩展需要手工安装和配置，例如：
+
+```bash
+npm run start -- extension install @dobby.ai/provider-claude --enable
+npm run start -- extension install @dobby.ai/sandbox-core --enable
+```
+
+`--enable` 的行为：
+
+- 把包写入 `extensions.allowList`
+- 按 manifest contribution 生成默认实例模板
+- 在需要时补默认 provider
+
+## 计划任务 / Cron
+
+job 支持三种调度方式：
+
+- `--at <ISO timestamp>`
+- `--every-ms <ms>`
+- `--cron "<expr>" [--tz <timezone>]`
+
+示例：
+
+```bash
+npm run start -- cron add daily-report \
+  --prompt "Summarize open issues in this repo" \
+  --connector discord.main \
+  --route projectA \
+  --channel 1234567890 \
+  --cron "0 9 * * 1-5" \
+  --tz "Asia/Shanghai"
+```
+
+说明：
+
+- `cron run <jobId>` 只是把 job 标记为“下一次 scheduler tick 执行”
+- 需要已有一个正在运行的 `dobby start`
+- 当前 scheduled run 一律按 stateless / ephemeral 执行
+
+## Discord 连接器的当前行为
+
+- 只处理已绑定的 guild channel，DM 目前禁用
+- 线程消息使用父频道 ID 做 binding 查找
+- 会自动下载附件到本地
+- 图片会作为 image input 传给 provider
+- 非图片附件会把路径注入 prompt
+- 内置 reconnect watchdog
+  - `reconnectStaleMs` 默认 `60000`
+  - `reconnectCheckIntervalMs` 默认 `10000`
+
+## 会话控制命令
+
+在 Discord 频道内可用：
+
+- `stop`
+- `/stop`
+- `/cancel`
+- `/new`
+- `/reset`
+
+当前语义：
+
+- `stop` / `/cancel`：取消该会话当前和排队中的任务
+- `/new` / `/reset`：重置当前会话，并在 provider 支持时归档旧 session
+
+## 本地插件开发
+
+开发流程：
+
+```bash
+npm run plugins:install
+npm run plugins:check
+npm run plugins:build
+npm run extensions:install:local
+```
+
+或一步完成：
+
+```bash
+npm run plugins:setup:local
+```
+
+补充说明：
+
+- `plugins/*` 是扩展源码，不是运行时加载入口
+- 本地扩展安装到 extension store 后，才会被宿主识别
+- `@dobby.ai/plugin-sdk` 在插件里按 `peerDependencies` 暴露，开发期通过 `file:../plugin-sdk` 提供
+
+## 检查与测试
+
+最小校验：
+
+```bash
+npm run check
+npm run build
+npm run test:cli
+```
+
+如果改了插件代码，建议再执行：
+
+```bash
+npm run plugins:check
+npm run plugins:build
+```
+
+当前测试现状：
+
+- 已有 CLI / core 的 focused tests
+- 暂无完整的 e2e 自动化
+- 仍建议做一次手工 Discord 冒烟
+
+## 本地运行小提示
+
+- `npm run dev:local` 与 `npm run start:local` 会尝试读取 `.env`
+- 普通 `npm run start -- ...` 不会自动载入 `.env`
+- 配置编辑流优先使用扩展 `configSchema`，无 schema 时退回 JSON 输入
+
+## 相关文档
+
+- 扩展系统：[`docs/EXTENSION_SYSTEM_ARCHITECTURE.md`](docs/EXTENSION_SYSTEM_ARCHITECTURE.md)
+- cron 设计：[`docs/CRON_SCHEDULER_DESIGN.md`](docs/CRON_SCHEDULER_DESIGN.md)
+- 运行与排障：[`docs/RUNBOOK.md`](docs/RUNBOOK.md)
+- Teamwork handoff：[`docs/TEAMWORK_HANDOFF_DESIGN.md`](docs/TEAMWORK_HANDOFF_DESIGN.md)

package/ROADMAP.md

@@ -0,0 +1,34 @@
+# ROADMAP
+
+Work In Progress
+
+下面列出一些个人觉得比较有意思的功能
+
+## session 管理
+
+如何手动结束当前会话，场景：会话轮数太多，用户想要手动结束会话，开启新话题
+
+“用户打断”时怎么处理当前运行，非常贴近真实聊天场景
+
+## 配置功能
+
+如何让用户配置的更加简便
+
+## skills
+
+这个好像直接用 claude code 和 pi-mono 就可以实现，需要找到一些比较好用的 skills
+
+- X 上的热点追踪 social listening 功能
+- 机票价格助手 trip Google Flights
+
+## agents 协同
+
+如何让多个 agent 协同工作，handoff 等等
+
+## 调度
+
+如何让 agent 定时工作
+
+## 插件
+
+- codex cli

package/config/cron.example.json

@@ -0,0 +1,9 @@
+{
+  "enabled": true,
+  "storeFile": "./data/state/cron-jobs.json",
+  "runLogFile": "./data/state/cron-runs.jsonl",
+  "pollIntervalMs": 10000,
+  "maxConcurrentRuns": 1,
+  "runMissedOnStartup": true,
+  "jobTimeoutMs": 600000
+}