cs-bots 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cs-bots contributors
+
+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

@@ -1,3 +1,165 @@
-# Temporary Holding Version
+# cs-bots
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**DSH 多智能体协作平台**——一个自足的插件：装上它，你就有了跨会话任务板、房间群聊、分层记忆、可独立工作目录的 Bot 注册表。
+
+> **零第三方运行时依赖**：不依赖 `my-free-model` / `dsh-memory-evolve` / `cs-bot-bea` / `ds-bot` 等任何其他插件。
+> 只依赖 DSH 本体自带的官方包（随 DSH 安装，不算第三方）。
+
+---
+
+## 安装
+
+### 通道 1：npm（推荐，稳定）
+
+```bash
+dsh plugin --profile web add cs-bots
+```
+
+### 通道 2：git（github）
+
+```bash
+dsh plugin --profile web add github:7358716/cs-bots#v0.1.0
+```
+
+> ⚠️ **已知环境事实**：`github.com:443` 在某些网络下**间歇不可达**（DNS 正常、TCP 超时）。
+> 若 git 通道失败：先重试一次，仍失败则改用 npm 通道。
+
+### 一条命令装 + 自检（强烈建议）
+
+```bash
+bash install.sh --channel npm      # 或 --channel git
+```
+
+**自检为什么必要**：`link:` 断链或 bundle 未进 `dsh.profile.bundles` 时，DSH **只打一行
+`skipping profile bundle` 就静默跳过**——页面照常 HTTP 200，功能全失效。
+`install.sh` 用 `dsh --profile <p> --dump-config` 验证**装配树里真有本插件的行**，
+并检查 `agent-team.maxMembers` 是否已解封、状态目录是否可写。
+
+退出码：`0`=装好且自检通过；`1`=安装失败；**`2`=装了但自检不通过**（最危险，必须处理）。
+
+#### ⚠️ 一个必踩的坑：**bundle 层序**
+
+`dsh plugin add` 只往 `dsh.profile.bundles` **末尾追加**。而 bundle patch 按 **bundles 顺序**依次应用，
+之后才是 profile 自己的 patch。
+
+⇒ **本插件必须排在 `@deepseek-ai/dsh-experimental-agent-team-profile` 之后**，
+否则我们对 `agent-team.maxMembers` 的**覆盖会在目标行还不存在时执行 → 被静默跳过**（`entry not found`）。
+
+**实测复现**（2026-11-02）：先装 `cs-bots`、后装 `agent-team-profile` → `maxMembers` 仍是 `8`。
+
+`install.sh` 会**检测并自动重排**（备份为 `package.json.bak-cs-bots-order`），
+然后以 **exit=2** 提示「需重启 DSH 后重跑自检」。
+
+手动安装时请**先启用 agent-team，再装本插件**；或装完跑一次 `install.sh --check-only` 让它修正。
+
+#### 另一个坑：**不要用 npm 装 agent-team-profile**
+
+`dsh plugin add @deepseek-ai/dsh-experimental-agent-team-profile` 会从 registry 拉到**另一个版本**
+（实测拉到 `0.1.5-alpha.2`，而 dsh 自带的是 `0.2.1-rc.2`）。
+正确做法：**只在 `dsh.profile.bundles` 里按名引用**（不装包），它会从 dsh 安装目录解析，版本天然对齐。
+
+---
+
+## 装好后你得到什么
+
+**16 个模型可见工具**（`bot_` 前缀，避免与其他插件撞名）：
+
+### 任务板（跨会话）
+| 工具 | 用途 |
+|---|---|
+| `bot_task_create` | 建任务（支持依赖 DAG、优先级、`sourceSeq` 幂等） |
+| `bot_task_list` | 列任务 |
+| `bot_task_ready` | **就绪任务**（依赖全完成的 pending），领活用 |
+| `bot_task_update` | CAS 推进：`claim`/`heartbeat`/`release`/`complete`/`reopen`/`block`/`unblock`/`delete`/`set` |
+| `bot_task_accept` | 验收（`pass`/`reject`）——官方**没有**这个动作 |
+
+### 唤醒桥
+| 工具 | 用途 |
+|---|---|
+| `bot_wake` | 定向唤醒会话（`dedupKey` 去重，防唤醒风暴） |
+
+### Bot 注册表（**独立工作目录**）
+| 工具 | 用途 |
+|---|---|
+| `bot_roster_create` | 建持久 Bot（`cwd` 独立，**cwd 同时是它的写入边界**） |
+| `bot_roster_list` | 列出（可选含已退役） |
+| `bot_roster_manage` | `rename`/`retire`/`setCwd`/`claim`/`release`/`heartbeat` |
+
+### 房间群聊
+| 工具 | 用途 |
+|---|---|
+| `bot_room_create` | 建房间 |
+| `bot_room_post` | 发言（**确定性写入**：直接落盘，不经模型转手） |
+| `bot_room_read` | 读消息（带 `seq` 游标，可断点续传） |
+| `bot_room_body` | 取长正文全文（长消息自动落旁路文件） |
+
+### 分层记忆
+| 工具 | 用途 |
+|---|---|
+| `bot_memory_add` | 写入（L0–L5 六层；`explicit:true` 受保护） |
+| `bot_memory_search` | 检索（FTS5 trigram，缺则退化字面匹配） |
+| `bot_memory_context` | 取常驻注入文本（L0–L3） |
+
+---
+
+## 设计要点（为什么这样）
+
+### 1. 为什么持久 Bot 不走官方 `spawn_teammate`
+
+**实测硬事实**：官方 `SpawnTeammateRequest` 只有 6 个字段（`name`/`description`/`prompt`/`context`/`provider`/`signal`）——**没有 `cwd`**；
+子会话由 `childSessionMeta()` 强制继承父会话 cwd；而 **cwd 同时就是 fs 写入边界**。
+⇒ 一支官方 Team 的全体成员共享同一目录、会互相覆盖文件。
+
+**本平台的解法**：持久 Bot 走 `ctx.agents.create({ meta: { cwd } })`（官方唯一能指定目录的路径），
+拿独立写入边界；`spawnTeammate` 只用于同目录的轻量分工。
+
+### 2. 为什么自建任务板
+
+官方 Agent Teams 的任务板 **`TeamId = SessionId`**（每会话一块），且 roster 是 **flat immutable**
+（无改名、无删除、名字永不复用）。⇒ 跨会话统一任务板与可维护的 Bot 注册表都必须自建。
+
+### 3. 为什么禁 `ask_user_question`
+
+在多智能体结构里，**同步等用户的提问工具会堵死整条投递链**
+（依据：`ds-bot` 源码注释 —— *"every message from another Bot or a group round queues behind it"*）。
+本平台对 Bot 会话双层移除：`tools.guard` 同步闸门 + `agent/created` 时 `restrict({deny})`。
+
+---
+
+## 开发
+
+```bash
+bash test/run-all.sh       # 单入口：零依赖 CI + 全部单测，任一失败退出码非 0
+bash test/ci-zero-dep.sh   # 只跑零依赖 CI（4 项机械检查）
+```
+
+**零依赖 CI 四项检查**（防止依赖悄悄长回来）：
+1. `src/` 下除 `kernel.js` 外，任何文件不得**真实 import** `@deepseek-ai/*`（注释里的字面量不算）
+2. `package.json` 的 `dependencies` 必须不存在或为空
+3. `cordis.patch.yml` 每个 `name` 只能是本包或官方包
+4. 覆盖官方行时必须列全 `config` 字段（漏字段会让整个 profile 起不来）
+
+---
+
+## 状态目录
+
+```
+$DSH_HOME/cs-bots/
+├── board.jsonl         任务板事件流（真相源）
+├── board.snap.json     任务板快照
+├── roster.jsonl        Bot 注册表事件流
+├── roster.snap.json
+├── wakes.jsonl         唤醒审计（终态记录）
+├── rooms/<roomId>/log.jsonl     房间消息（不截断）
+├── rooms/<roomId>/bodies/*.txt  长正文旁路
+├── memory.jsonl        记忆事件流
+├── memory.snap.json
+└── memory-fts.db       FTS5 检索索引（派生缓存，可重建）
+```
+
+---
+
+## 许可
+
+MIT。设计上借鉴了 `ds-bot`（Apache-2.0）的 work 树/投递漏斗、`cs-bot-bea`（MIT）的惰性获取/
+原子写/ErrorBoundary 等工程做法，均为**思路与模式借鉴**，未复制其运行时代码。

package/cordis.patch.agent-team.yml

@@ -0,0 +1,31 @@
+# cs-bots 可选增强 patch —— 解除官方 Agent Teams 的 8 人上限
+#
+# ⚠️ **本文件默认不生效**。它不在 `dsh.bundle.patch` 里，需要显式并入 profile 的
+#    cordis.patch.yml（或由 install.sh --with-agent-team-override 自动并入）。
+#
+# 为什么单独拆出来：覆盖官方行的 `config` 是**整体替换**（逐 key），必须重述全部
+# 4 个字段。若目标 DSH 版本 schema 少任何一个字段 → config 校验失败 →
+# **整个 profile 起不来**（"重启报错、必须禁用插件"的典型故障）。
+# 我们在 0.2.1-rc.2 上验证过；rc1/rc5 未验证，故默认不启用。
+#
+# 前置条件（三条缺一不可）：
+#   1. profile 已启用 @deepseek-ai/dsh-experimental-agent-team-profile
+#   2. 本 bundle（cs-bots）在 dsh.profile.bundles 中**排在 agent-team-profile 之后**
+#      （bundle patch 按 bundles 顺序应用；排在前面时目标行还不存在 → 被静默跳过）
+#   3. 目标版本的 agent-team config **确实**是这 4 个字段
+#
+# 用法：
+#   bash install.sh --check-only     # 会检查层序并自动修正
+#
+# 官方依据（0.2.1-rc.2 实测）：
+#   · dsh-experimental-agent-team/lib/index.js:1420  const DEFAULT_MAX_MEMBERS = 16
+#   · 同文件 :1439  maxMembers: z.number().step(1).min(1).default(DEFAULT_MAX_MEMBERS)
+#     → 默认 16、无上限；本机看到 8 是 agent-team-profile 的 patch 主动压下去的
+
+- id: agent-team
+  name: '@deepseek-ai/dsh-experimental-agent-team'
+  config:
+    maxMembers: 32
+    maxTasks: 256
+    maxMessageBytes: 65536
+    disposalTimeoutMs: 5000

package/cordis.patch.yml

@@ -0,0 +1,30 @@
+# cs-bots bundle patch —— **只 insert 自己，绝不动官方行**（默认最安全）。
+#
+# 安装：dsh plugin --profile web add git+ssh://git@github.com/7358716/cs-bots.git#v0.1.1
+# 本 patch 由 bundle 机制自动应用，**不要**再往 profile 的 cordis.patch.yml 手动
+# insert 同一 id（重复 loader entry id 会让加载失败）。
+#
+# ─────────────────────────────────────────────────────────────────────────────
+# 【2026-11-03 重要变更】原来的「覆盖 agent-team.maxMembers」已**移出默认 patch**
+#
+# 原因（真实风险，非理论）：覆盖官方行的 `config` 是**整体替换**（逐 key），
+# 所以我们必须重述 agent-team 的全部 4 个字段（maxMembers / maxTasks /
+# maxMessageBytes / disposalTimeoutMs）。**若目标 DSH 版本的 schema 少了其中任何
+# 一个字段 → config 校验失败 → 整个 profile 起不来** ——
+# 这正是「重启 DSH 报错、必须禁用插件才能打开」那一类故障。
+#
+# 我们在 0.2.1-rc.2 上实测过该 schema，但主管环境是 rc1（可升 rc5），
+# 版本面不同 → 为不拿宿主启动冒险，**默认不覆盖**。
+#
+# ⇒ 想要「解除官方 Team 的 8 人上限」，用显式开关：
+#      bash install.sh --channel git --with-agent-team-override
+#    或手动把同目录的 `cordis.patch.agent-team.yml` 内容并入 profile 的
+#    cordis.patch.yml（并确认本 bundle 排在 agent-team-profile **之后**）。
+#
+# 注：**不覆盖也不影响本平台核心能力** —— 本平台的 Bot 注册表（RosterService）
+# 走 root agent + 独立 cwd，**不受官方 maxMembers 约束**。覆盖只是让"官方 Team
+# 也能超过 8 人"，属锦上添花。
+
+- insert:
+    - id: cs-bots
+      name: 'cs-bots'

package/install.sh

@@ -0,0 +1,218 @@
+#!/usr/bin/env bash
+# cs-bots 安装器 —— 装 + **自检**（一条命令完成）。
+#
+# 为什么必须有自检（硬约束 E4'）：
+#   `link:` 断链 / 版本错位 / bundle 未进 `dsh.profile.bundles` 时，DSH **只打一行
+#   `skipping profile bundle` 就静默跳过** —— 页面照常 HTTP 200，功能全失效。
+#   ⇒ 「页面能打开」不等于「插件装好了」。本脚本用 `--dump-config` 验证**装配树里真有我们的行**。
+#
+# 用法：
+#   bash install.sh                      # 默认：npm 通道，profile=web
+#   bash install.sh --channel git        # github:7358716/cs-bots#<ref>
+#   bash install.sh --profile desktop    # 换 profile
+#   bash install.sh --check-only         # 只自检，不安装
+#   bash install.sh --ref v0.1.0         # 指定 git tag（默认 main）
+#   bash install.sh --with-agent-team-override   # 可选：解除官方 Team 8 人上限
+#                                                （会改 agent-team 的 config，旧版本有 schema 风险）
+#
+# 退出码：0 = 安装且自检通过；1 = 安装失败；2 = 装了但**自检不通过**（最危险，必须显式暴露）
+set -uo pipefail
+
+PKG_NAME="cs-bots"
+BUNDLE_ID="cs-bots"
+REPO="7358716/cs-bots"
+
+CHANNEL="npm"
+PROFILE="web"
+REF="main"
+CHECK_ONLY=0
+NEED_RESTART=0
+WITH_TEAM_OVERRIDE=0
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --channel) CHANNEL="${2:-}"; shift 2 ;;
+    --profile) PROFILE="${2:-}"; shift 2 ;;
+    --ref) REF="${2:-}"; shift 2 ;;
+    --check-only) CHECK_ONLY=1; shift ;;
+    --with-agent-team-override) WITH_TEAM_OVERRIDE=1; shift ;;
+    -h|--help) sed -n '2,20p' "$0"; exit 0 ;;
+    *) echo "未知参数: $1" >&2; exit 1 ;;
+  esac
+done
+
+say() { printf '%s\n' "$*"; }
+die() { printf '❌ %s\n' "$*" >&2; exit 1; }
+
+# ── 0. 前置检查 ──────────────────────────────────────────────────────────────
+say "════════ cs-bots 安装器 ════════"
+say "  通道    : $CHANNEL"
+say "  profile : $PROFILE"
+[ "$CHECK_ONLY" -eq 1 ] || say "  版本    : $REF"
+
+command -v dsh >/dev/null 2>&1 || die "找不到 dsh 命令（请先装 DeepSeek Harness 并在 PATH 里）"
+
+# ── 1. 安装 ──────────────────────────────────────────────────────────────────
+if [ "$CHECK_ONLY" -eq 0 ]; then
+  case "$CHANNEL" in
+    npm)
+      # 首选通道：npmmirror 稳定（实测 200）。dsh plugin 转发 pnpm。
+      say ""
+      say "▶ 安装（npm）..."
+      if ! dsh plugin --profile "$PROFILE" add "$PKG_NAME"; then
+        die "npm 安装失败。兜底：改用 --channel git（需 github.com 可达）或本地 tarball。"
+      fi
+      ;;
+    git)
+      # 次选：github.com **间歇可达**（实测曾 3/3 成功、也曾 0/5 超时）
+      say ""
+      say "▶ 安装（git: github:$REPO#$REF）..."
+      if ! dsh plugin --profile "$PROFILE" add "github:$REPO#$REF"; then
+        cat >&2 <<'EOF'
+❌ git 通道失败。
+
+   已知事实（本机实测）：github.com:443 **间歇不可达**（DNS 正常、TCP 超时），
+   而 api.github.com / codeload.github.com 稳定；本机**无私钥**故 SSH 必失败。
+
+   处置顺序：
+     1) 重试一次（间歇性）
+     2) 换 npm 通道：bash install.sh --channel npm
+     3) 走 tarball：先下载再 add ./cs-bots-<ver>.tgz
+EOF
+        exit 1
+      fi
+      ;;
+    *) die "未知通道: $CHANNEL（支持 npm | git）" ;;
+  esac
+fi
+
+# ── 1.5 可选：并入 agent-team 覆盖（默认不做，见 cordis.patch.yml 顶部说明）──
+if [ "$WITH_TEAM_OVERRIDE" -eq 1 ]; then
+  say ""
+  say "▶ 启用可选覆盖：解除官方 Team 8 人上限"
+  PROFILE="$PROFILE" BUNDLE_ID="$BUNDLE_ID" python3 - <<'PY2'
+import json, os, shutil
+prof = os.path.expanduser(f"~/.dsh/profiles/{os.environ['PROFILE']}")
+pkg = os.path.join(prof, "package.json")
+shutil.copyfile(pkg, pkg + ".bak-cs-bots-override")
+d = json.load(open(pkg, encoding="utf-8"))
+b = d.get("dsh", {}).get("profile", {}).get("bundles", [])
+me = os.environ["BUNDLE_ID"]
+if me in b:  # 确保本包最后（覆盖要在 agent-team 行之后执行）
+    b[:] = [x for x in b if x != me] + [me]
+json.dump(d, open(pkg, "w", encoding="utf-8"), indent=2, ensure_ascii=False)
+open(pkg, "a", encoding="utf-8").write("\n")
+print("  已确保层序：", b)
+print("  提示：请把 cordis.patch.agent-team.yml 的内容并入 profile 的 cordis.patch.yml")
+print("        （profile 自己的 patch 在所有 bundle 之后应用，能确保覆盖到 agent-team 行）")
+PY2
+  NEED_RESTART=1
+fi
+
+# ── 2. 自检（**这一步才是关键**）─────────────────────────────────────────────
+say ""
+say "▶ 自检：验证装配树里真有我们的行（不是只看页面能不能打开）..."
+
+DUMP="$(dsh --profile "$PROFILE" --dump-config 2>/dev/null)"
+if [ -z "$DUMP" ]; then
+  say "⚠️  --dump-config 无输出 → 无法自检（DSH 版本过旧？）"
+  say "    手工确认：dsh --profile $PROFILE --dump-config | grep -n '$BUNDLE_ID'"
+  exit 2
+fi
+
+# 判据 1：我们的 bundle 行在装配树里
+if printf '%s\n' "$DUMP" | grep -qE "id:[[:space:]]*$BUNDLE_ID\b"; then
+  say "  ✅ bundle 行已进入装配树（id: $BUNDLE_ID）"
+else
+  say "  ❌ **装配树里没有 $BUNDLE_ID** —— 插件没真正挂上"
+  say "     常见原因：只在 dependencies、没进 dsh.profile.bundles（DSH 会静默跳过）"
+  exit 2
+fi
+
+# 判据 2：**层序** —— 本包必须在 agent-team-profile 之后（否则覆盖静默失效）
+# 实测（2026-11-02）：`dsh plugin add` 只往 bundles **末尾追加**；若先装本插件、
+# 后装 agent-team-profile，本包的覆盖 patch 会在 agent-team 行还不存在时执行 →
+# 被 warn 跳过 → maxMembers 仍是 8。
+ORDER_OK="$(PROFILE="$PROFILE" BUNDLE_ID="$BUNDLE_ID" python3 - <<'PY'
+import json, os
+p = os.path.expanduser(f"~/.dsh/profiles/{os.environ['PROFILE']}/package.json")
+try:
+    d = json.load(open(p, encoding="utf-8"))
+except Exception:
+    print("UNKNOWN"); raise SystemExit(0)
+b = d.get("dsh", {}).get("profile", {}).get("bundles", [])
+me = os.environ["BUNDLE_ID"]
+tm = "@deepseek-ai/dsh-experimental-agent-team-profile"
+if me not in b or tm not in b:
+    print("SKIP"); raise SystemExit(0)
+print("OK" if b.index(me) > b.index(tm) else "REORDER")
+PY
+)"
+
+case "$ORDER_OK" in
+  OK)
+    say "  ✅ 层序正确（$BUNDLE_ID 在 agent-team-profile 之后）"
+    ;;
+  REORDER)
+    say "  ⚠️  层序错误：$BUNDLE_ID 排在 agent-team-profile **之前** → 覆盖会静默失效"
+    say "     正在自动修正（把 $BUNDLE_ID 移到 bundles 末尾）..."
+    PROFILE="$PROFILE" BUNDLE_ID="$BUNDLE_ID" python3 - <<'PY'
+import json, os, shutil
+p = os.path.expanduser(f"~/.dsh/profiles/{os.environ['PROFILE']}/package.json")
+shutil.copyfile(p, p + ".bak-cs-bots-order")
+d = json.load(open(p, encoding="utf-8"))
+b = d["dsh"]["profile"]["bundles"]
+me = os.environ["BUNDLE_ID"]
+b[:] = [x for x in b if x != me] + [me]
+json.dump(d, open(p, "w", encoding="utf-8"), indent=2, ensure_ascii=False)
+open(p, "a", encoding="utf-8").write("\n")
+print(f"     已重排：{b}")
+PY
+    say "     （原文件已备份为 package.json.bak-cs-bots-order）"
+    NEED_RESTART=1
+    ;;
+  SKIP)
+    say "  ⚠️  目标 profile 未启用 agent-team-profile → 层序无关（平台降级运行）"
+    ;;
+  *)
+    say "  ⚠️  无法判定层序（profile package.json 读取失败）"
+    ;;
+esac
+
+# 判据 3：我们覆盖的 maxMembers 真的生效（P1 路径 A 的验收点）
+MM="$(printf '%s\n' "$DUMP" | grep -A 12 "id:[[:space:]]*agent-team$" | grep -oE "maxMembers:[[:space:]]*[0-9]+" | head -1 | grep -oE '[0-9]+')"
+if [ -n "$MM" ]; then
+  if [ "$MM" -ge 32 ]; then
+    say "  ✅ agent-team.maxMembers = $MM（可选覆盖已生效，官方默认 16）"
+  else
+    say "  ℹ️  agent-team.maxMembers = $MM（未覆盖 —— **这是默认状态，不影响平台核心能力**）"
+    say "     本平台的 Bot 注册表走 root agent + 独立 cwd，不受官方上限约束。"
+    say "     想让官方 Team 也超过 8 人：bash install.sh --with-agent-team-override"
+  fi
+else
+  say "  ⚠️  未找到 agent-team 行 → 目标 profile 未启用实验性 Agent Teams"
+  say "     平台将降级为「仅内建域服务」（符合缺服务不阻塞的纪律）"
+fi
+
+# 判据 3：状态目录可写（不然任务板/记忆全是内存态，重启即丢）
+DSH_HOME_DIR="${DSH_HOME:-$HOME/.dsh}"
+STATE_DIR="$DSH_HOME_DIR/$BUNDLE_ID"
+if mkdir -p "$STATE_DIR" 2>/dev/null && [ -w "$STATE_DIR" ]; then
+  say "  ✅ 状态目录可写：$STATE_DIR"
+else
+  say "  ❌ 状态目录不可写：$STATE_DIR（任务板/记忆无法落盘）"
+  exit 2
+fi
+
+say ""
+if [ "$NEED_RESTART" -eq 1 ]; then
+  say "⚠️  已安装，但**层序刚被修正，需重启 DSH 才生效**。"
+  say "    请：① 重启 DSH  ② 重跑 bash install.sh --check-only --profile $PROFILE"
+  say "    在此之前 agent-team.maxMembers 仍是旧值（平台可用，但官方 Team 仍受旧上限约束）。"
+  exit 2
+fi
+
+say "✅ 安装并自检通过。"
+say "   下一步：重启 DSH 后，在会话里应能看到 bot_* 工具（bot_task_create 等）。"
+say "   若看不到工具：检查 tools 服务是否可用（本平台缺它时只 warn 不崩）。"
+exit 0

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "cs-bots",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "cs-bots — DSH 多智能体协作平台：跨会话任务板 / 房间群聊 / 分层记忆 / Bot 注册表（独立工作目录），零第三方运行时依赖",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./client": "./src/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "cordis.patch.yml",
+    "cordis.patch.agent-team.yml",
+    "install.sh",
+    "README.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "engines": {
+    "node": ">=22.5"
+  },
+  "scripts": {
+    "test": "bash test/run-all.sh",
+    "ci": "bash test/ci-zero-dep.sh",
+    "install:check": "bash install.sh --check-only"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh",
+    "multi-agent",
+    "agents",
+    "agent-teams",
+    "task-board",
+    "collaboration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/7358716/cs-bots.git"
+  },
+  "homepage": "https://github.com/7358716/cs-bots#readme",
+  "bugs": {
+    "url": "https://github.com/7358716/cs-bots/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}