dsh-erpbot 0.1.0 → 0.1.1

package/docs/mcp-inventory-analysis.md

@@ -0,0 +1,58 @@
+# MCP 清单方向分析（基座 · MCP 与数据）
+
+> 状态：v1（2026-11-13）— 面向「基座要看到连接了哪些 MCP、每个 MCP 有哪些接口和内容」这一方向的事实核验与方案选型。
+> 依据：DSH 安装版 `@deepseek-ai/dsh-mcp-client` / `dsh-mcp-manager` / `dsh-mcp-resources` / `dsh-api-remotes` 源码与 README，以及 `dsh-web-app/cordis.patch.yml` 的 mcp-manager 挂载事实。
+
+## 0. 一句话结论
+
+**连接了哪些 MCP + 连接状态 + 每个 MCP 有哪些 tools** 三件事 DSH 都已提供权威 API（`ctx.mcpManager`），基座只需做「Host 路由桥接 → 客户端 fetch 渲染」，不写任何 MCP 协议代码。**「每个 MCP 有哪些内容(resources)」是真实缺口**：DSH 把 resources 设计成模型按需读（`list_mcp_resources` 工具），manager/probe 都不列资源目录，且 probe 属于 DSH 内部包不可改；这部分要么接受「只列 tools、资源走工具按需读」，要么 dsh-erpbot 自起 MCP client（引入 `@modelcontextprotocol/client`，风险高）。
+
+---
+
+## 1. 三个子需求逐一核验
+
+| 基座要什么 | DSH 权威 API | 现状 |
+|---|---|---|
+| 连接了哪些 MCP + 连接状态 | `ctx.mcpManager.list()` → `[{name, configured, status}]` | ✅ 现成；`connected` 态含 `toolCount` / `connectedAt` |
+| 每个 MCP 有哪些接口(tools) | `ctx.mcpManager.probe(name, opts)` → `toolNames[]`（连接+列工具后立即关闭，不注册工具） | ✅ 现成；但要主动 probe 拿快照 |
+| 每个 MCP 有哪些内容(resources) | 无 Host 侧 API | ❌ 缺口；probe 只做 `tools/list`，不做 `resources/list` |
+
+## 2. 关键 API 事实（读源码核实）
+
+- `dsh-mcp-manager` 已随 `dsh-web-app` 挂载为 `mcp-manager` 行（web 与 desktop profile 都有），注入 `credentials`。基座**不需要**自己装 manager，直接注入 `mcpManager` 即可。
+- `ctx.mcpManager.list()` 返回 `McpManagedServerView[]`：`{ name, configured, status }`。`status` 是 `McpConnectionStatus` 扩展，含 `connected{state,toolCount,connectedAt}`、`reconnecting{attempt,maxAttempts,nextRetryAtMs,lastError}`、`failed{reason}`、`disabled`、`waiting-credentials` 等。
+- `ctx.mcpManager.probe(name, {maxPages, maxToolNames})` 是**一次性探测**：连接→读 `serverInfo{name,version}`→列 `toolNames[]`→关闭，不注册工具、不占 serverName 命名空间。默认 16 页 / 512 个工具名上限。这是拿「接口清单」的权威入口。
+- `restart(name)`、`watch(signal)` 也在 manager 上：`watch` 首次全量 + 每次状态/条目变更推送，浏览器侧经 `ctx.remote.mcpManager` 可达。
+- `dsh-mcp-resources` 提供三个共享工具 `list_mcp_resources` / `list_mcp_resource_templates` / `read_mcp_resource`，**给模型按需读**，不是给管理面列目录。resources 不在 manager/probe 的返回里。
+- 浏览器侧拿清单有两条路：`ctx.remote.mcpManager`（`dsh-api-remotes` 已挂载，含 `mcpManager` remote），或像现有 erpbot 一样走自建 Host 路由 `hostJson()`。
+
+## 3. 三个备选方案（含取舍）
+
+| 方案 | 数据通道 | 改动量 | 实时性 | 风险 |
+|---|---|---|---|---|
+| **A（推荐）** Host 路由桥接 `/erp/mcp/*`，客户端用现有 `hostJson()` fetch | 小：index.js 加路由（注入 `mcpManager`），workbench 加渲染 | 中 | 中等（手动刷新/轮询） | 低：沿用现有 fenced 路由 + hostJson 模式 |
+| B 浏览器直连 `ctx.remote.mcpManager`（`watch` 实时推送） | 大：改 client 的 `mount`/inject 接线 + 订阅 stream | 高 | 高（实时） | 高：remote 面没在 erpbot 现有接线里，改动面大、类型依赖 `dsh-api-remotes` |
+| C 只读 `list()` 显示 toolCount，不展开接口名 | 最小：只加一个路由返回 list | 最低 | — | 最低：但不满足「有哪些接口」 |
+
+**推荐 A + C 组合落地**：先用 C 把「连接了哪些 MCP + 状态 + 工具数」做实，再用 A 的 probe 在用户点开某个通道时按需拉接口清单（`toolNames[]`），避免每次进底座都 probe 所有 server（probe 有 10s 预算 + 每 server 一次连接开销）。
+
+## 4. resources 缺口的两个出路
+
+1. **接受「只列 tools，资源按需读」**（推荐先做）：底座清单列「server → 状态 → toolCount → 工具名列表」，资源能力用一行说明「有 resources 能力，用 list_mcp_resources 读」，不预列资源目录。理由：资源目录可能很大、且 DSH 的设计意图就是按需读，预列会引入大量一次性 token 与连接开销。
+2. **自起 MCP client 读 `resources/list`**（后做，需评估）：dsh-erpbot 在 Host 半注入 `mcpManager`，但读 resources 要直接 import `@modelcontextprotocol/client`（probe.ts 就是这么干的，但那是 DSH 内部包，erpbot 独立包依赖树里没有）。要额外声明依赖，且要自己处理分页、凭证模板、关闭清理——风险高、收益只在「预列资源目录」这一件事上。
+
+## 5. 结论与建议落地顺序
+
+1. 先做 C：`GET /erp/mcp/list` → 复用 `ctx.mcpManager.list()`，底座「MCP 通道与服务」项从静态 payload 换成实时列表（name / configured / status / toolCount）。
+2. 再做 A：`GET /erp/mcp/probe?name=<id>` → `ctx.mcpManager.probe(name)`，用户点开某通道时拉接口清单 `toolNames[]`，渲染成通道展开视图。
+3. resources 先不预列，保持 DSH 的「按需读」语义；若用户明确要「预列资源目录」，再评估自起 client 的成本。
+
+## 6. 与现有 `/erp/mcp/status` 路由的关系
+
+上一轮已加的 `GET /erp/mcp/status` 目前返回**静态** `MCP_CHANNELS` 数组。本方向落地后应把它替换为「`ctx.mcpManager.list()` 的真实快照」，删除静态数组，让底座 MCP 状态点真正反映 DSH 已连接的 MCP。
+
+## 7. 变更记录
+
+| 日期 | 变更 |
+|---|---|
+| 2026-11-13 | 初版，核验 DSH MCP 三件套 API 并给出方案选型 |

package/docs/requirements.md

@@ -0,0 +1,234 @@
+# dsh-erpbot 需求规格（PRD）
+
+> 状态：v1（2026-11-12）— 基于当前已实现功能架构逆向整理的权威需求。
+> 适用范围：`dsh-erpbot` 插件（Aurora 风格财务 / ERP 面板）。
+> 用途：评估现有实现是否达标，以及未来开发的唯一需求基线。
+
+---
+
+## 1. 目标与定位
+
+### 1.1 一句话
+
+**Erp = Harness + ERP，做的是 AI + ERP 的财务智能化自动化**，不是一套 ERP，也不是一张财务看板。它以 DSH 为入口，让 AI 去连数据（MCP 通道）、算口径（数据蒸馏 + 指标）、跑技能（自动对账 / 关账 / 勾选 / 申报 / 预测）、留审计（回执 + 审计链 + 幂等），人只做确认与例外。
+
+### 1.2 目标（Goals）
+
+- **G1 AI 自动化执行**：财务核心作业（凭证识别、银行对账、进项勾选、纳税申报、关账、现金流预测、催收、资金日报）由 AI 技能 / 场景自动完成，人只复核与处理例外。
+- **G2 结果可信呈现**：AI 干完活的产物以「KPI 卡 + 工作台」两级结构呈现，第一屏看大数、点开看明细；每个数可回口径、回时点、回数据集、回审计回执。
+- **G3 内嵌助手（人机协作）**：在不跳转工作区的前提下，人问「为什么 / 怎么办」，AI 去查数、执行、回执；弹窗 / 停靠 / 折叠。
+- **G4 双语**：所有用户可见文案支持中文 / English，切换即时生效且不丢失页面状态。
+- **G5 自适应**：面板尺寸由 DSH 分配，布局与图表必须跟随槽位盒子（非窗口）分级重排、降级而不溢出。
+- **G6 可维护**：数据与渲染分离，加页面 / 加渲染器是「改数据 + 改少量渲染」而非「重写」。
+
+### 1.3 非目标（Non-goals，明确不做）
+
+- 不做一套 ERP：不手工记账、不替代 ERP 原始记账；对 ERP 的写入走 MCP 受控写通道（`direction=controlled_write`），不直连、不裸写。
+- 不做静态报表：各页数字是「AI 执行结果的呈现」，不是给人逐格填的账表；不做纯展示层的看板。
+- 不做第三种语言：只做 `中文 / EN` 两种。
+- 不做多套视觉主题：只保留 Aurora 一种风格（跟随 DSH 明暗，不做本地主题切换器）。
+- 不做全局快捷键、不做左栏新增 AI 图标（AI 入口只来自总览页卡片与右上角）。
+
+---
+
+## 2. 范围（Scope）
+
+### 2.1 页面体系
+
+| 页面 id | 名称 | 定位 |
+|---|---|---|
+| `overview` | 总览 | 全局 KPI + 核心块轮播 + 收支趋势 + 支出构成 + 账龄 + 最近动态 |
+| `cai` | 财 · 过去 | 凭证、账簿、期末关账、报表、核对底稿 |
+| `zi` | 资 · 现在 | 账户余额、收付待办、对账未达、资金计划、票据授信 |
+| `tui` | 推 · 未来 | 预算编制、滚动预测、情景模拟、假设版本、成本分摊、管报 |
+| `shui` | 税 · 税务 | 销项 / 进项发票、纳税申报、报送缴款、税负风险 |
+| `base` | 底座 · MCP 与数据 | MCP 通道与服务、技能与场景、数据源、蒸馏批次、主数据映射、指标与口径、质量与对账、回执与审计（单页，页内无 tab） |
+
+页面状态写进 URL hash（`#/erp/<id>`），刷新后停在原页；`#/erp/shu`、`#/erp/guan` 是落到 `base` 的深链别名。
+
+### 2.2 功能模块
+
+1. 导航（左栏 rail + 页面路由）
+2. 概览页（卡片矩阵 + 图表）
+3. 工作台页（四 Bot + 底座：KPI 卡 + 段工作台）
+4. 双语（i18n）
+5. 主题（明暗跟随 DSH）
+6. 内嵌 AI 助手
+7. 响应式布局（三层容器查询）
+
+---
+
+## 3. 功能需求（FR）
+
+> 每条 FR 形如 `FR-<模块>-<序号>`，用于验收与回归追踪。标注 `[已实现]` / `[待实现]` 表示当前状态。
+
+### 3.1 导航（FR-NAV）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-NAV-1 | 左侧导航图标列表顶部（`plugins` 之上）显示 Erp 图标 | 已实现 |
+| FR-NAV-2 | 点击图标切换到 Erp 主面板，再次点击/切走可回到会话 | 已实现 |
+| FR-NAV-3 | 左栏包含 6 个页面条目（总览 + 四 Bot + 底座），当前页高亮 | 已实现 |
+| FR-NAV-4 | 页面 id 写进 `#/erp/<id>`，刷新保持原页 | 已实现 |
+| FR-NAV-5 | 页面 id 必须全小写字母（`readHashPage` 用 `([a-z]+)` 解析） | 已实现 |
+| FR-NAV-6 | 左栏底部固定「设置 + 语言」组，矮面板不随图标滚动挤走 | 已实现 |
+
+### 3.2 概览页（FR-OV）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-OV-1 | 顶部 4 张 KPI 统计卡（含迷你折线 + 环比） | 已实现 |
+| FR-OV-2 | 核心块轮播（账 / 资 / 推 / 税），左右箭头 + 圆点 + 自动轮播 + 悬停暂停 | 已实现 |
+| FR-OV-3 | 收支趋势图（SVG，含 tooltip、峰值高亮） | 已实现 |
+| FR-OV-4 | 支出构成环形图（含图例 + 增长徽标） | 已实现 |
+| FR-OV-5 | 应收账款账龄卡（分段占比条） | 已实现 |
+| FR-OV-6 | 最近动态时间线 | 已实现 |
+| FR-OV-7 | AI 助手卡（入口 + 状态点 + 建议 chip） | 已实现 |
+
+### 3.3 KPI 卡（FR-KPI）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-KPI-1 | 每张卡只保留三件事：主数字（带单位）、一行口径（cardSub）、一个微型图 | 已实现 |
+| FR-KPI-2 | 支持 7 种变体：`value` `split` `stack` `gauge` `countdown` `status` `delta` | 已实现 |
+| FR-KPI-3 | 点开卡片进入 `MetricDetailModal`，展示精确金额 + 完整口径 + 构成明细 + 统计口径 + 更新时点 | 已实现 |
+| FR-KPI-4 | 金额单位在渲染层换算（精确元 → 万/亿/K/M/B），payload 永远存精确元 | 已实现 |
+| FR-KPI-5 | 构成明细占比可显式给（`row.pct`）或按金额自动推算 | 已实现 |
+
+### 3.4 工作台渲染器（FR-WB）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-WB-1 | 支持 12 种渲染器：`list` `table` `flow` `cards` `steps` `checks` `bars` `chart` `donut` `timeline` `scenarios` `empty` | 已实现 |
+| FR-WB-2 | 左栏条目可带 `pill`（数量徽标），右栏顶部可带 1–3 个 `summary` 摘要块 | 已实现 |
+| FR-WB-3 | `chart` / `donut` / `bars` 支持「图表 / 清单」双视图（`alt` 字段） | 已实现 |
+| FR-WB-4 | 切段时自动回到图表视图 | 已实现 |
+| FR-WB-5 | 右栏底部可带 `foot` 口径落款 | 已实现 |
+
+### 3.5 双语（FR-I18N）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-I18N-1 | 支持 `中文` / `EN`，默认中文 | 已实现 |
+| FR-I18N-2 | 切换控件是左栏底部一颗圆按钮，只显示当前语言（`中` / `EN`），点击即切 | 已实现 |
+| FR-I18N-3 | 语言是插件内自持状态，不跟随、不改写宿主界面语言 | 已实现 |
+| FR-I18N-4 | 所有用户可见文案走 `t(key)` 或 `L({zh,en})`，禁止组件内裸写 | 已实现 |
+| FR-I18N-5 | `zh` / `en` 字典 key 集合必须成对一致 | 已实现 |
+
+### 3.6 主题（FR-THEME）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-THEME-1 | 跟随 DSH 明暗外观（`theme/change`），不做本地主题切换器 | 已实现 |
+| FR-THEME-2 | 明暗两套主题 token 内置于 CSS，切换后满足 WCAG AA 对比度 | 已实现 |
+| FR-THEME-3 | 样式全部 `.erp-app` 前缀作用域化，不触碰宿主 UI | 已实现 |
+
+### 3.7 内嵌 AI 助手（FR-AI）
+
+> 详细交互规格（状态机、弹窗 / 停靠 / 窄条规格、会话管理、降级）见本文 [附录 A](#附录-a-ai-助手交互规格)。
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-AI-1 | 入口：右上角 spark 图标 + 总览页 AI 卡 | 已实现 |
+| FR-AI-2 | 弹窗内嵌官方会话（`conversation.content`，`variant:'embedded'`，固定 Chat），不跳转 | 已实现 |
+| FR-AI-3 | 专属工作区 `Documents/deepseek-harness/erpbot-assistant`，会话自动创建并持久化 | 已实现 |
+| FR-AI-4 | 四态机：`closed` / `modal` / `dock` / `rail`，`modal` 记住上一非弹窗状态 | 已实现 |
+| FR-AI-5 | 停靠 / 折叠状态持久化，面板重开自动恢复 | 已实现 |
+| FR-AI-6 | 会话列表抽屉 + 新建 + 切换 + 相对时间 + 状态点 | 已实现 |
+| FR-AI-7 | 内嵌契约缺失时降级为「打开对话页」，不白屏 | 已实现 |
+
+### 3.8 响应式（FR-RESP）
+
+| 编号 | 需求 | 状态 |
+|---|---|---|
+| FR-RESP-1 | 面板尺寸跟随 DSH 分配的槽位盒子 | 已实现 |
+| FR-RESP-2 | 宽度用容器查询 `@container erp` 分级（1180/900/720/560），不用 `@media` | 已实现 |
+| FR-RESP-3 | 高度用容器查询 `@container board` 分级（820/680/560/460） | 已实现 |
+| FR-RESP-4 | 支出卡 / 环形图 / 卡片自身是二级容器（`exp` / `donut` / `visa-wrap`） | 已实现 |
+| FR-RESP-5 | 放不下的信息靠卡片内部降级消化，绝不把布局顶出去 | 已实现 |
+| FR-RESP-6 | 图表有 `tight` 模式，矮盒仍绘图不空白 | 已实现 |
+
+---
+
+## 4. 非功能需求（NFR）
+
+| 编号 | 需求 | 度量 |
+|---|---|---|
+| NFR-1 | 无障碍：弹窗 `role=dialog`、焦点圈、Esc 关闭、卡片 `role=button` + Enter/Space | 键盘可全程操作 |
+| NFR-2 | 对比度：明暗两套满足 WCAG AA | 主题切换后文字可读 |
+| NFR-3 | 性能：图表动画在弹窗打开期间暂停，SVG 由 ResizeObserver 重绘 | 无布局抖动 |
+| NFR-4 | 可靠性：任意内部服务缺失时降级不白屏（catch + 空态） | 无 uncaught 崩溃 |
+| NFR-5 | 可维护性：加一页只需改 `NAV` + `ZH/EN` 各一条 + `PAGES` 一条 | 单人可完成 |
+| NFR-6 | 构建确定性：`client.js` 由 `build.mjs` 纯拼接生成，可 sha256 自证 | 产物可复现 |
+| NFR-7 | 语言完整性：英文无中文泄漏，key 成对 | 切换后无乱码/漏译 |
+
+---
+
+## 5. 术语表
+
+| 术语 | 含义 |
+|---|---|
+| KPI 卡 | 工作台顶排的单指标卡片，7 种变体按 `kpi.kind` 渲染 |
+| 段工作台 | 工作台页下方「左栏清单 + 右侧主内容」的大组件；底座合并后为单页 8 项 |
+| 渲染器 | 段工作台右侧按 `section.kind` 分发的 12 种内容视图 |
+| 口径（cardSub / sub） | 指标的计算定义；cardSub 是卡上一行短口径，sub 是弹窗完整口径 |
+| 构成明细（breakdown） | 弹窗内按行展示的拆分（含占比条） |
+| 主题桥 | 把 DSH 明暗外观同步到 Erp 面板的机制 |
+| 专属工作区 | AI 助手会话落地的独立工作区目录 |
+
+---
+
+## 6. 演进路线（Roadmap）
+
+> 现状基线为 v1；以下为未来评估/开发的方向，非本轮承诺。
+
+1. **数据真实性**：当前 PAGES 是静态演示数据，未来接真实 ERP 数据源。
+2. **AI 助手增强**：会话搜索、30+ 分页、归档恢复、多窗口草稿提示（原方案 §16/§17 未决项）。
+3. **工作台交互**：段的增删改（当前只读）、表格排序 / 筛选。
+4. **可配置化**：KPI 卡与渲染器的用户自定义（当前硬编码）。
+5. **测试覆盖**：`check.cjs` / `validate-page.js` 工具链的落地（README 引用但未入库）。
+
+---
+
+## 7. 需求变更记录
+
+| 日期 | 变更 | 来源 |
+|---|---|---|
+| 2026-11-12 | 初版，逆向整理当前实现为权威需求基线 | 用户请求 |
+
+---
+
+## 附录 A：AI 助手交互规格
+
+> 来源：原根仓库 `docs/erpbot-assistant-interaction.md`（标「待实现」，实际代码已实现）。
+> 本附录为 AI 助手的权威交互需求，`FR-AI-*` 据此验收。
+
+### A.1 状态模型
+
+| 状态 | 说明 | 进入 | 退出 |
+|---|---|---|---|
+| `closed` | 只有总览 AI 卡作入口 | 关闭停靠 / 弹窗 | 点卡 / chip / 窄条 |
+| `modal` | 居中弹窗，遮罩，覆盖面板 | 点 AI 卡 / chip / 窄条「打开弹窗」 | Esc / 点遮罩 / 关闭 / 固定到侧边 |
+| `dock` | 右侧停靠列 | 弹窗内「固定到侧边」/ 窄条展开 | 折叠（→rail）/ 关闭（→closed） |
+| `rail` | 停靠折叠后的右侧窄条 | dock 点折叠 | 点窄条展开回 dock |
+
+规则：`modal` 打开时记住上一非弹窗状态，关闭后回到该状态；`dock`/`rail` 与「是否启用过助手」绑定；`presentation ∈ {closed,dock,rail}` 持久化，`modal` 不持久化。
+
+### A.2 会话管理
+
+- 专属工作区 `Documents/deepseek-harness/erpbot-assistant`，标题「Erp 助手」，首次使用自动创建并注册（Host 半路由 `POST /erp/workspace`）。
+- 会话自动创建，id 持久化 `localStorage dsh-erpbot.assistant.session.v1`；停靠状态持久化 `dsh-erpbot.assistant.present.v1`。
+- 弹窗头部：`[列表] Erp 助手 ·状态点 … [新建] [固定] [关闭]`。
+- 会话列表抽屉：切换 / 新建 / 相对时间 / 状态点；空白会话只列当前一条；30+ 分页（未来）。
+
+### A.3 降级
+
+内嵌契约（`SessionProvider` / `renderFactorySlot`）缺失时，降级为「打开对话页」，不白屏。
+
+### A.4 边界
+
+| 场景 | 处理 |
+|---|---|
+| 专属工作区被删 | 下次打开自动重建并提示一次 |
+| 当前会话被归档 | 下次打开新建一条 |
+| 多窗口 | 各自维护当前会话 id，共享历史与草稿 |

package/index.js

@@ -5,10 +5,10 @@
  * things the browser cannot do:
  *
  *  1. Per-bot workspace directories + registry entries
- *       cai  → D:\erpBot\cai     (fallback: <Documents>/deepseek-harness/erpbot-cai)
- *       zi   → D:\erpBot\zi
- *       tui  → D:\erpBot\tui
- *       shui → D:\erpBot\shui
+ *       finance  → D:\erpBot\finance     (fallback: <Documents>/deepseek-harness/erpbot-finance)
+ *       funds   → D:\erpBot\funds
+ *       forecast  → D:\erpBot\forecast
+ *       tax → D:\erpBot\tax
  *  2. The bot config file and the bot identity memory
  *       <workspace>\bot.json     added skills + timestamps
  *       <workspace>\AGENTS.md    identity, scene prompt and the skill list that
@@ -29,21 +29,42 @@ import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
+import {
+  AGENTS_SCHEMA,
+  BOT_IDENTITY,
+  BOT_TITLES,
+  buildAgentsDoc,
+} from './bot-identity.js'
 
-/** Host services: the web server, request fencing, and the workspace registry. */
-export const inject = ['webServer', 'connection', 'workspaceRegistry']
+/** Host services: the web server, request fencing, the workspace registry, the MCP server manager, and the subagent seam (for pre-building the four bot teammates). */
+export const inject = ['webServer', 'connection', 'workspaceRegistry', 'mcpManager', 'subagents']
 
 /** Bot id → workspace display title. This whitelist is the whole API surface. */
-const BOTS = {
-  cai: 'erpBot · 财 Bot',
-  zi: 'erpBot · 资 Bot',
-  tui: 'erpBot · 推 Bot',
-  shui: 'erpBot · 税 Bot',
-}
+const BOTS = BOT_TITLES
 
 /** Preferred root on the D: drive (one subfolder per bot). */
 const D_ROOT = 'D:\\erpBot'
 
+/** The team workspace: a shared checkout the four bots collaborate in, separate
+ *  from the per-bot directories so team work never mixes with a single bot's
+ *  session files. */
+const TEAM_DIR = 'team'
+
+/** Bot id → agent preset id + teammate name + initial prompt. The preset ids
+ *  mirror the four `preset-erp-*` rows in cordis.patch.yml; the teammate names
+ *  are what `send_message` / `list_agents` show.
+ *
+ *  The prompt is ONLY a formation-time role announcement — it names who this
+ *  teammate is, nothing about how to collaborate. How the lead and teammates
+ *  divide, delegate, and relay work belongs to DSH's own team/subagent
+ *  runtime, so a future DSH upgrade keeps working without touching this. */
+const TEAM_BOTS = [
+  { id: 'finance', preset: 'erp-finance', name: 'finance', prompt: '你是财务团队的一员，角色是「账房」，负责账务与报表。' },
+  { id: 'funds', preset: 'erp-funds', name: 'funds', prompt: '你是财务团队的一员，角色是「司库」，负责资金与收付。' },
+  { id: 'forecast', preset: 'erp-forecast', name: 'forecast', prompt: '你是财务团队的一员，角色是「军师」，负责预算与预测。' },
+  { id: 'tax', preset: 'erp-tax', name: 'tax', prompt: '你是财务团队的一员，角色是「税官」，负责税务与申报。' },
+]
+
 /** Fallback root when D: is unavailable, beside DSH's default workspace. */
 const FALLBACK_ROOT = join(homedir(), 'Documents', 'deepseek-harness')
 
@@ -268,6 +289,89 @@ async function ensureWorkspace(ctx, bot) {
   }
 }
 
+/**
+ * Scaffold one bot's standard files when they are absent.
+ *
+ * A freshly mounted plugin has four empty bot directories: without this step
+ * the identity files only appear after someone opens that bot's page in the
+ * browser, so `D:\erpBot\<bot>` looks unconfigured until then. Missing files are
+ * created; an AGENTS.md that exists but carries no current schema marker is
+ * rewritten (the pre-v2 format had five sections instead of eight); a file that
+ * is present and current is left untouched so user edits survive.
+ *
+ * @param bot - whitelisted bot id.
+ * @returns `{ bot, directory, created: string[], migrated: boolean }`.
+ */
+async function scaffoldBotFiles(bot) {
+  const { directory } = await ensureDirectory(bot)
+  const configPath = join(directory, 'bot.json')
+  const agentsPath = join(directory, 'AGENTS.md')
+  const created = []
+
+  /* bot.json: skills list + timestamp. Read first so a rewritten AGENTS.md
+     reflects the skills the user already bound. */
+  let skills = []
+  let configExists = false
+  if (existsSync(configPath)) {
+    configExists = true
+    try {
+      const parsed = JSON.parse(await readFile(configPath, 'utf8'))
+      if (parsed !== null && typeof parsed === 'object' && Array.isArray(parsed.skills)) {
+        skills = parsed.skills.filter((name) => typeof name === 'string')
+      }
+    } catch (error) {
+      /* a corrupt config is rewritten from the empty default */
+    }
+  }
+  if (!configExists) {
+    const config = { bot, skills, updatedAt: new Date().toISOString() }
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8')
+    created.push('bot.json')
+  }
+
+  /* AGENTS.md: create when missing, rewrite when the schema is stale. */
+  let agents = null
+  if (existsSync(agentsPath)) {
+    try {
+      agents = await readFile(agentsPath, 'utf8')
+    } catch (error) {
+      agents = null
+    }
+  }
+  let migrated = false
+  if (agents === null) {
+    await writeFile(agentsPath, buildAgentsDoc(bot, skills, {}) + '\n', 'utf8')
+    created.push('AGENTS.md')
+  } else if (agents.indexOf(AGENTS_SCHEMA) < 0) {
+    await writeFile(agentsPath, buildAgentsDoc(bot, skills, {}) + '\n', 'utf8')
+    migrated = true
+  }
+
+  return { bot, directory, created, migrated }
+}
+
+/**
+ * Scaffold every bot's standard files. One bot's failure must not stop the
+ * others, so each is settled independently and reported.
+ * @param ctx - Host context, for logging.
+ * @returns `[{ bot, directory, created, migrated, error? }]`.
+ */
+async function scaffoldAllBots(ctx) {
+  const results = []
+  for (const bot of Object.keys(BOT_IDENTITY)) {
+    try {
+      results.push(await scaffoldBotFiles(bot))
+    } catch (error) {
+      const message = String((error && error.message) || error)
+      results.push({ bot, directory: '', created: [], migrated: false, error: message })
+      if (ctx !== undefined && ctx.logger !== undefined) {
+        ctx.logger.warn('erpBot: could not scaffold ' + bot + ' — ' + message)
+      }
+    }
+  }
+  return results
+}
+
 /**
  * Mount the Host half.
  * @param ctx - Host context.
@@ -275,6 +379,66 @@ async function ensureWorkspace(ctx, bot) {
 export function apply(ctx) {
   const fenced = (req) => ctx.connection.requestRejection(req) === undefined
 
+  /* 0) Scaffold the four bot workspaces at mount: bot.json + AGENTS.md appear
+     as soon as the plugin loads, instead of only after the user opens that bot's
+     page. Idempotent — existing current files are kept. */
+  void scaffoldAllBots(ctx).then((results) => {
+    for (const result of results) {
+      if (result.created.length > 0) {
+        ctx.logger.info('erpBot: scaffolded ' + result.bot + ' → ' + result.created.join(', '))
+      }
+      if (result.migrated) {
+        ctx.logger.info('erpBot: migrated AGENTS.md to the current schema for ' + result.bot)
+      }
+    }
+  }).catch((error) => {
+    ctx.logger.error('erpBot: workspace scaffolding failed')
+    ctx.logger.error(error)
+  })
+
+  /* 0b) Team formation: when the team root session goes live, pre-build the four
+     bot teammates through the standard subagent seam. erpbot's job ends once the
+     team is formed — `delivery: 'parent'` returns every child's result to the
+     lead (root), so division, delegation, and result relay all run inside DSH's
+     own team/subagent runtime, never through erpbot. */
+  const teamPath = join(D_ROOT, TEAM_DIR)
+  const formedRoots = new Set()
+
+  ctx.on('agent/created', async ({ agent, source }) => {
+    /* Only fresh (startup) ordinary roots in the team directory. */
+    const header = agent.session && agent.session.header ? agent.session.header : null
+    const cwd = header ? header.cwd : undefined
+    if (source !== 'startup') return
+    if (header !== null && header.origin === 'subagent') return
+    if (cwd !== teamPath) return
+    const sessionId = agent.id
+    if (formedRoots.has(sessionId)) return
+    formedRoots.add(sessionId)
+
+    ctx.logger.info('erpBot: team root live (' + String(sessionId) + '), pre-building ' + TEAM_BOTS.length + ' teammates')
+    for (const bot of TEAM_BOTS) {
+      try {
+        const activation = await ctx.subagents.startActivation({
+          provider: 'spawn',
+          parent: agent,
+          agentPreset: bot.preset,
+          name: bot.name,
+          label: bot.name,
+          /* Each bot works from its own directory so dsh-agent-instructions
+             loads ITS AGENTS.md — identity (roles/boundaries), bound skills,
+             and discipline all come from that file, not from a hardcoded tool
+             list in the preset. */
+          cwd: join(D_ROOT, bot.id),
+          delivery: 'parent',
+          prompt: [{ type: 'text', text: bot.prompt }],
+        })
+        ctx.logger.info('erpBot: teammate ' + bot.name + ' ready (' + String(activation.childId) + ')')
+      } catch (error) {
+        ctx.logger.warn('erpBot: failed to build teammate ' + bot.name + ' — ' + String((error && error.message) || error))
+      }
+    }
+  })
+
   // 1) Workspace directory + registry entry.
   ctx.effect(() => ctx.webServer.register({
     kind: 'prefix',
@@ -297,7 +461,7 @@ export function apply(ctx) {
       }
       const bot = typeof body.bot === 'string' ? body.bot : ''
       if (!Object.prototype.hasOwnProperty.call(BOTS, bot)) {
-        respond(res, 400, { ok: false, error: { code: 'invalid-bot', message: 'bot must be one of cai, zi, tui, shui' } })
+        respond(res, 400, { ok: false, error: { code: 'invalid-bot', message: 'bot must be one of finance, funds, forecast, tax' } })
         return
       }
       try {
@@ -311,6 +475,40 @@ export function apply(ctx) {
     },
   }), 'erpBot: /erp/workspace route')
 
+  // 1b) Team workspace: a single shared checkout under D:\erpBot\team, separate
+  //     from the four per-bot directories. The team's root session and every
+  //     delegated bot child read/write this one directory.
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'prefix',
+    path: '/erp/team/workspace',
+    handler: async (req, res) => {
+      if (!fenced(req)) {
+        respond(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } })
+        return
+      }
+      if (req.method !== 'POST') {
+        respond(res, 405, { ok: false, error: { code: 'method-error', message: 'method not allowed' } })
+        return
+      }
+      try {
+        const directory = join(D_ROOT, TEAM_DIR)
+        await mkdir(directory, { recursive: true })
+        const workspace = await ctx.workspaceRegistry.create(directory, 'erpBot · 团队协作')
+        respond(res, 200, {
+          ok: true,
+          workspaceId: workspace.id,
+          path: workspace.path ?? directory,
+          title: workspace.title ?? 'erpBot · 团队协作',
+        })
+      } catch (error) {
+        respond(res, 500, {
+          ok: false,
+          error: { code: 'team-workspace-failed', message: String((error && error.message) || error) },
+        })
+      }
+    },
+  }), 'erpBot: /erp/team/workspace route')
+
   // 2) DSH skills available to add.
   ctx.effect(() => ctx.webServer.register({
     kind: 'prefix',
@@ -344,10 +542,14 @@ export function apply(ctx) {
       if (req.method === 'GET') {
         const bot = String((req.url || '').split('bot=')[1] || '').split('&')[0]
         if (!Object.prototype.hasOwnProperty.call(BOTS, bot)) {
-          respond(res, 400, { ok: false, error: { code: 'invalid-bot', message: 'bot must be one of cai, zi, tui, shui' } })
+          respond(res, 400, { ok: false, error: { code: 'invalid-bot', message: 'bot must be one of finance, funds, forecast, tax' } })
           return
         }
         try {
+          /* Read touches a workspace that may have been emptied or never
+             scaffolded (the mount-time pass is fire-and-forget); fill in any
+             missing standard file before serving the state. */
+          await scaffoldBotFiles(bot)
           const state = await readBotConfig(bot)
           respond(res, 200, { ok: true, ...state })
         } catch (error) {
@@ -368,7 +570,7 @@ export function apply(ctx) {
       }
       const bot = typeof body.bot === 'string' ? body.bot : ''
       if (!Object.prototype.hasOwnProperty.call(BOTS, bot)) {
-        respond(res, 400, { ok: false, error: { code: 'invalid-bot', message: 'bot must be one of cai, zi, tui, shui' } })
+        respond(res, 400, { ok: false, error: { code: 'invalid-bot', message: 'bot must be one of finance, funds, forecast, tax' } })
         return
       }
       try {
@@ -383,4 +585,57 @@ export function apply(ctx) {
       }
     },
   }), 'erpBot: /erp/bot route')
+
+  // 4) MCP server fleet: live list + per-server tool inventory via ctx.mcpManager.
+  //    The manager is mounted by dsh-web-app; this host half only bridges it to
+  //    the browser, so the base page shows the DSH-configured MCP servers and
+  //    their discovered tools without any MCP protocol code here.
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'prefix',
+    path: '/erp/mcp/list',
+    handler: async (req, res) => {
+      if (!fenced(req)) {
+        respond(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } })
+        return
+      }
+      if (req.method !== 'GET') {
+        respond(res, 405, { ok: false, error: { code: 'method-error', message: 'method not allowed' } })
+        return
+      }
+      try {
+        const views = (ctx.mcpManager ? ctx.mcpManager.list() : [])
+        respond(res, 200, { ok: true, servers: views })
+      } catch (error) {
+        respond(res, 500, { ok: false, error: { code: 'mcp-list-failed', message: String((error && error.message) || error) } })
+      }
+    },
+  }), 'erpBot: /erp/mcp/list route')
+
+  // 5) Probe one server: connect, read identity, list tools, close. No tools
+  //    are registered and the live instance is untouched.
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'prefix',
+    path: '/erp/mcp/probe',
+    handler: async (req, res) => {
+      if (!fenced(req)) {
+        respond(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } })
+        return
+      }
+      if (req.method !== 'GET') {
+        respond(res, 405, { ok: false, error: { code: 'method-error', message: 'method not allowed' } })
+        return
+      }
+      const name = String((req.url || '').split('name=')[1] || '').split('&')[0]
+      if (!name || !ctx.mcpManager) {
+        respond(res, 400, { ok: false, error: { code: 'invalid-server', message: 'name is required' } })
+        return
+      }
+      try {
+        const result = await ctx.mcpManager.probe(name, { timeoutMs: 10000 })
+        respond(res, 200, { ok: true, name, probe: result })
+      } catch (error) {
+        respond(res, 500, { ok: false, error: { code: 'mcp-probe-failed', message: String((error && error.message) || error) } })
+      }
+    },
+  }), 'erpBot: /erp/mcp/probe route')
 }