pi-multi-viewers 0.8.3 → 0.9.0

package/AGENTS.md

@@ -68,7 +68,7 @@ tests/               测试（unittest discover tests）
 
 | 档 | 唤醒命令 | 用途 |
 |---|---|---|
-| **mc-tools**（默认） | 四个 `--no-*` + `-e <MC 的 subagent-entry.js>` | 给 agents **按需检索项目背景**（`ctx_search`）——背景蒸馏机制已移除，这是其补充通道。**允许而非要求 MC**：找不到 MC → 降级为零扩展 + 一行可见说明（`ctx_search` 本次不可用）|
+| **mc-tools**（默认） | 四个 `--no-*` + `-e <MC 的 subagent-entry.js>` + `-e <pi-mcp-adapter 入口>` | 给 agents **按需检索项目背景**（`ctx_search`）——背景蒸馏机制已移除，这是其补充通道。**允许而非要求 MC**：找不到 MC → 降级为零扩展 + 一行可见说明（`ctx_search` 本次不可用）|
 | **none** | 四个 `--no-*` | 零扩展、**零依赖**（无 MC 的机器/CI 用这档）|
 | **all** | 不加任何 `--no-*`（pi 默认发现）| A/B 实验与显式 opt-in |
 
@@ -85,7 +85,7 @@ tests/               测试（unittest discover tests）
 生产基线：本场 strict=1、n=19，唤醒启动段中位 **0.68s**、收尾中位 0.04s ✓）。
 **入口解析 fail-fast**（`meeting_fs.resolve_mc_tools_entry`：从 pi 的 packages 找 MC 包 →
 读它声明的扩展入口 → 取同目录的 subagent-entry.js）；缺 MC 时**可见降级**为零扩展。
-**依赖边界**：mc-tools 档**允许而非要求** MC——缺 MC 时降级为零扩展，且**可见**
+**依赖边界**：mc-tools 档的**两份入口各自独立**（MC 的 ctx_search、MCP adapter 的 web_search 等）——**允许而非要求**，缺谁少谁、都**可见**
 （打印一行"本次按零扩展运行：ctx_search 不可用"；无静默铁律）；`none` 档零依赖
 （无 MC 的机器/CI 显式选它）。**测试/探针保真**：设 `MV_MC_TOOLS_STRICT=1` →
 缺 MC 即报错退出（否则测试可能在"没装 MC"下通过而 ctx_search 从未生效）。

package/README.md

@@ -1,12 +1,30 @@
 # pi-multi-viewers
 
-多视角协同分析（Pi 插件）：把主 pi session **fork** 成 N 个视角 agent，
-各带一份视角任务书（效率/简单/铁律/……），在 meeting 协议下交锋、
-修正、收敛，产出一份共识结果。
+**多视角协同分析（Pi 插件）**：把当前 pi 会话 fork 成 N 个视角 agent，让它们带着你的真实上下文互相交锋，产出共识与分歧。
 
-与 [pi-agents-helper](https://github.com/maxdai/pi-agents-helper)（多方
-讨论达成共识，agent 无主上下文）平行演化；共享 meeting 协议核心
-（core/fs/engine），差异在初始化层。
+## 它想解决什么问题
+
+需要考虑多种因素或者准则时，LLM 容易出现**逐渐忽略其中一部分因素**的问题。
+
+对策是**给每个因素一条独立的会话**：一个视角 agent 只关注一个因素（效率 / 简单 / 铁律 / …），
+各带一份视角任务书与独立发言配额，并且必须对其它视角的观点表态（认同或反驳，都要用自己的论据）。
+这样**只要这些会话存在，对应因素就不会被忽略**——关注不靠提醒模型"别忘了 X"，
+而是让每个 X 有一个独立的载体。
+
+讨论由代码驱动的 meeting 协议推进（发言配额 → 冻结 → 轮转表态 → 共识收束），
+最终产出 `result.md`：**共识结论 + 明确否决项（含理由与重估触发条件）+ 各自保留的分歧**。
+
+## 什么时候值得跑
+
+**当一个问题需要长思考、并且需要在长思考过程中保持若干个视角的关注时**，可以尝试使用。
+
+（反过来说：查一个事实、跑一条命令、一两分钟能自己确认的问题，直接问 pi 更快。）
+
+## 代价
+
+一次分析通常 **12–35 分钟**（3 视角、20–50 次唤醒，正常情况）。这个区间**不含**异常外溢：
+provider 连续失败或扩展异常时可能显著更久（历史场次里出现过 55 分钟与 73 分钟）。
+它换来的不是"更快"，而是"多几个独立立场 + 一份可复查的分歧记录"。
 
 ## 核心机制（2026-09-09/10 实测验证，见 docs/examples/first-experiment）
 
@@ -67,16 +85,20 @@ ls ~/.pi/agent/npm/node_modules/pi-multi-viewers/scripts/mv.sh
 
 ## 用法
 
-```
-/multi-viewers-setup          # ① 建视角（首次使用先跑这个；prompt：先建议 → 你定 → 落盘 → 给你审）
-/multi-viewers "<主题>"        # ② 分析（extension：生成 spec → 弹窗门禁 → 启动 → 预填观看命令）
-/multi-viewers-say "<文本>"    # ③ 插话（分析进行中；extension：零 LLM 直接写入 human 消息）
-/multi-viewers-finish         # ④ 收尾（extension：查状态 → 确认 → 清理，报告随清理打印）
-```
+**接口总表**（pi 内 1 个 prompt + 3 个命令；终端侧另有等价 CLI）：
 
-四个 pi 命令入口，按使用顺序排列。**②③④ 是 extension**（流程完全由代码执行、
-零 LLM：跑命令、门禁弹窗、观看命令预填、状态判据都走退出码/机器标记行，
-不靠 LLM 转述）；**① 是 prompt**——写视角是内容工作，本就需要 LLM 参与。
+| 入口 | 形态 | 作用 |
+|---|---|---|
+| `/multi-viewers-setup` | prompt | 建视角（建议 → 你定 → `--set-viewer` 落盘 → 给你审） |
+| `/multi-viewers "<主题>"` | extension | 分析：prepare → **暂停点弹窗** → start → 交付观看命令 |
+| `/multi-viewers-finish` | extension | 收尾：status → 确认 → cleanup（报告随清理打印并落盘） |
+| `/multi-viewers-say "<文本>"` | extension | 插话（human 消息，各视角可见可回应） |
+| `scripts/mv.sh <子命令>` | CLI | 终端侧等价入口（`--prepare` / `--start` / `--status` / `--view` / `--say` / `--report` / `--wait` / `--cleanup` / `--viewers` / `--set-viewer`）——pi 内命令内部也走它 |
+
+按使用顺序：先 `/multi-viewers-setup` 建视角（一次就够），之后 `/multi-viewers "<主题>"` 跑分析，
+分析进行中用 `/multi-viewers-say` 插话，结束后 `/multi-viewers-finish` 收尾。
+**后三个是 extension**（流程完全由代码执行、零 LLM：跑命令、门禁弹窗、观看命令交付、状态判据
+都走退出码/机器标记行，不靠 LLM 转述）；**`setup` 是 prompt**——写视角是内容工作，本就需要 LLM 参与。
 
 **目录可以省略**：`--view`/`--say`/`--status`/`--report`/`--wait`/`--cleanup`
 不带目录时自动定位"本 session 当前分析"（只匹配 `mv-<sessionId>-*` 最新；**未匹配
@@ -98,8 +120,9 @@ scripts/mv.sh --start <spec目录>              # 启动（自动挂载主 sessi
 #  可选：--fork-mode compaction|budget|full（见上表；一般不调）
 #  可选：--max-meeting 15 --max-rr 7 --stall-timeout 600
 #        （配额：建环境时固化进 protocol.json，之后不可改；meeting 配额是"每 agent"）
-#  可选：--extension-policy mc-tools|none|all（默认 mc-tools = agents 带 MC 的只读检索工具
-#        ctx_search；none = 零扩展、零依赖；all = 走 pi 默认发现。缺 MC 时 mc-tools 可见降级）
+#  可选：--extension-policy mc-tools|none|all（默认 mc-tools = 零扩展 + 两份只读工具入口：
+#        MC 的 ctx_search 与 MCP adapter 的 web 检索等；none = 零扩展、零依赖；
+#        all = 走 pi 默认发现。两份入口各自独立，缺谁少谁且可见降级）
 #  高级：--agents "a,b" 起一次性视角（不建 viewers/ 时用；prompt 入口不传它）
 
 # 观看：--start 会输出可直接执行的 !! 流式观看命令（复制执行）
@@ -156,6 +179,9 @@ frontmatter 字段、写文件路径、独立参与者纪律。
 | 完全一次性（项目还没建 viewers/） | `mv.sh --prepare "<主题>" --agents "a,b"`（wrapper 高级用法） |
 
 ## 架构
+与 [pi-agents-helper](https://github.com/maxdai/pi-agents-helper)（多方
+讨论达成共识，agent 无主上下文）平行演化；共享 meeting 协议核心
+（core/fs/engine），差异在初始化层。
 
 ```
 meeting_core.py     纯判定（冻结级联/RR/聚合 + 状态机词汇常量）

package/docs/design.md

@@ -495,7 +495,7 @@ commit 是溯源记录、本节是长期引用点——不并存两份权威值
 
     | 档 | 唤醒命令 | 语义 |
     |---|---|---|
-    | `mc-tools`（默认） | 四个 `--no-*` + `-e <MC subagent-entry.js>`（找不到 MC 时退化为四个 `--no-*`）| 只要 MC 的**只读检索工具**（`ctx_search`）；**允许而非要求** MC |
+    | `mc-tools`（默认） | 四个 `--no-*` + `-e <MC subagent-entry.js>` + `-e <pi-mcp-adapter 入口>`（任一份入口缺失即**部分降级**：缺谁少谁、都可见；全缺 = 等价 none）
     | `none` | 四个 `--no-*` | 零扩展：最快、**零依赖** |
     | `all` | 不加任何 `--no-*` | pi 默认发现（A/B 与显式 opt-in）|
 
@@ -517,6 +517,7 @@ commit 是溯源记录、本节是长期引用点——不并存两份权威值
     spawn cwd 全截断（"无 MC 的机器"上产出残缺命令）。**登记行**：首唤打
     `扩展策略: 声明=X 生效=Y strict=0|1 [降级原因=…]`——报告据此给"声明 vs 生效"
     （E2；与"档位"同型），否则降级只在 loop log 里、产品面看不见。
+    **两份入口（2026-09-25 用户裁决 B）**：`mc-tools` 除 MC 的只读检索工具外，再显式 `-e` 加载 **pi-mcp-adapter**（web_search / web_reader / zread 等 MCP 工具）——`--no-extensions` 关的是**扩展发现**，显式路径照常生效（pi `--help` 原文），不加载就等于 agents 完全失去联网检索能力。两份入口**各自独立降级**（缺谁少谁、都可见），不新增档位（保持简单）。
 
     **依赖边界（用户 2026-09-14 定）**：mc-tools **允许而非要求** MC——缺 MC 时
     **降级为零扩展并按 none 运行**，但**必须可见**（打印一行"mc-tools 档未生效
@@ -591,7 +592,7 @@ commit 是溯源记录、本节是长期引用点——不并存两份权威值
     |---|---|---|---|
     | `setEditorText` 预填 | 仅 TUI | 0 | TUI 便利（能直接回车跑） |
     | `notify` | 全模式 | 0 | 即时反馈（pi-web 关掉弹窗即消失） |
-    | `pi.sendMessage`（custom_message） | 全模式 | ~百 token（主 session）+ 随 fork 进每场分析 | 持久留痕（pi-web 渲染为折叠块） |
+    | `pi.sendMessage`（custom_message） | 全模式 | ~百 token（主 session）+ 随 fork 进每场分析 | 持久留痕（pi-web 渲染为折叠块、需点击；起 0.5.19 实时出现） |
     | `ctx.ui.setWidget` | 全模式 | 0（纯 UI） | 运行期常驻可见（一眼看到、不需点击） |
     三条注记：① `sendMessage` 的 custom_message **会随 fork 进每场分析各视角的上下文**
     （fork 源在首唤由主 session 条目构建，不做类型过滤）——~2 行/场，有界；不为它加

package/extensions/multi-viewers/index.ts

@@ -20,7 +20,8 @@
  * ① `ctx.ui.setEditorText` 预填输入框——TUI 便利（能直接回车跑）；pi-web 忽略
  * ② `notify`——即时反馈；pi-web 上关掉弹窗即消失
  * ③ `pi.sendMessage`（custom_message）——**持久留痕**，跨重启仍在；但 pi-web 渲染为
- *    **折叠的** `multi-viewers (click to expand)`，且随 fork 进入每场分析上下文
+ *    **折叠的** `multi-viewers (click to expand)`，需点击展开（pi-web 0.5.19 起**实时出现**，
+ *    此前只在重载后可见）；且随 fork 进入每场分析上下文
  * ④ `ctx.ui.setWidget`——**运行期常驻可见**（一眼看到、不需点击；MC 待办用的同一通道）
  */
 
@@ -104,8 +105,8 @@ export default function register(pi: any) {
         content: `多视角分析已启动：${dir}\n观看命令（复制执行，不进 LLM）：\n${watch}`,
         display: true,
       });
-      // 常驻面板：pi-web 实测把 custom_message 渲染成折叠的 `multi-viewers (click to expand)`，
-      // 且历史条目未必实时刷新 → 观看命令还需要一条**一眼可见、不需点击**的常驻出口。
+      // 常驻面板：custom_message 在 pi-web 是**折叠块**（要点击才展开；0.5.19 起实时出现）
+      // → 观看命令还需要一条**一眼可见、不需点击**的常驻出口。
       // setWidget 正是这个语义（pi-web 注释："Persistent widget panel … Not a popup"；
       // 主 pi 的 magic-context 待办面板用的就是它）。
       ctx.ui.setWidget("multi-viewers", [

package/meeting_fs.py

@@ -126,32 +126,24 @@ def _package_dir(source, agent_dir):
     return cand if os.path.isdir(cand) else None
 
 
-def resolve_mc_tools_entry(agent_dir=None):
-    """解析 MC 的**只读工具入口**（`dist/subagent-entry.js`）——"mc-tools" 档用。
-
-    为什么这样解析而不硬编码路径：MC 自己就是用"主入口的**兄弟文件**"
-    （其源码 `resolveSiblingEntryPath("subagent-entry.js")`）定位它。我们的
-    等价做法 = 从 pi 的注册表（settings.json.packages）找到 MC 包目录 → 读它
-    package.json 声明的扩展入口（`pi.extensions[0]`）→ 取同目录下的
-    subagent-entry.js。
+def _packages_of(pkg_name, agent_dir=None):
+    """在 pi 的 packages 里找声明了 `pkg_name` 的包：返回 (candidates, err)。
 
-    **失败语义**：任一步缺失返回 `(None, 原因)`——**由调用方按策略决定**：
-    loop 在生产态做**可见降级**（打印一行说明后按零扩展运行 ✓ 无静默），
-    在严格态（`MV_MC_TOOLS_STRICT=1`，测试/探针保真）直接报错。
+    candidates = [(source, pkg_dir)]，按注册顺序（可能有多个候选——包名相同但
+    来源不同）；err = 读注册表失败的原因（此时 candidates 为空）。
 
-    依赖边界（决策 20）：mc-tools **允许而非要求** MC——缺 MC 即降级为零扩展；
-    `none` 档零依赖（无 MC 的机器/CI 显式选它）。
+    **匹配按裸包名精确相等**（F5）：不能用子串——`in` 会把
+    `@cortexkit/pi-magic-context-legacy` 也命中。npm 源直接比裸名；路径源读
+    它的 package.json.name。**遍历全部候选**（F6：首个匹配不可解析时继续看
+    后面的候选，否则"装着也报没装"，文案误导）。
     """
     agent_dir = agent_dir or pi_agent_dir()
     try:
         with open(os.path.join(agent_dir, "settings.json"), encoding="utf-8") as f:
             pkgs = json.load(f).get("packages") or []
     except (OSError, ValueError) as e:
-        return None, f"读不到 pi 的 packages（{agent_dir}/settings.json）: {e}"
-    # F5：按**裸包名精确相等**识别（npm 源直接比；路径源读其 package.json.name）；
-    # F6：遍历**全部**候选、取首个可解析（此前首个匹配失败即停，装着 MC 也会
-    #     报"没装"，文案误导）
-    seen = []          # 候选（source 字符串）——用于错误文案，说明"试过哪些"
+        return [], f"读不到 pi 的 packages（{agent_dir}/settings.json）: {e}"
+    out = []
     for entry in pkgs:
         source = _entry_source(entry)
         if not source:
@@ -167,32 +159,80 @@ def resolve_mc_tools_entry(agent_dir=None):
                     name = json.load(f).get("name") or ""
             except (OSError, ValueError):
                 name = ""
-        if name != MC_PACKAGE:
-            continue
-        seen.append(source)
+        if name == pkg_name:
+            out.append((source, pkg_dir))
+    return out, ""
+
+
+def _declared_extensions(pkg_name, agent_dir=None):
+    """包名 → (pkg_dir, exts, err)：包目录 + 它自己声明的扩展入口（已归一为列表）。
+
+    exts 来自包 package.json 的 `pi.extensions`（判据**由上游声明**，不硬编码布局）；
+    字符串形态归一为单元素列表（F7：直接取首字符会解析出错误路径）。
+    """
+    cands, err = _packages_of(pkg_name, agent_dir)
+    if err:
+        return None, [], err
+    if not cands:
+        return None, [], f"packages 里没有 {pkg_name}（pi install npm:{pkg_name}）"
+    last = ""
+    for source, pkg_dir in cands:
         try:
             with open(os.path.join(pkg_dir, "package.json"), encoding="utf-8") as f:
                 man = json.load(f)
         except (OSError, ValueError) as e:
-            return None, f"读不到 {MC_PACKAGE} 的 package.json: {e}"
+            last = f"读不到 {pkg_name} 的 package.json: {e}"
+            continue
         exts = (man.get("pi") or {}).get("extensions")
-        if isinstance(exts, str):          # F7：字符串形态（取首字符会解析错路径）
+        if isinstance(exts, str):
             exts = [exts]
         if not isinstance(exts, list) or not exts or not all(
                 isinstance(x, str) and x for x in exts):
-            return None, f"{MC_PACKAGE} 的 pi.extensions 形态不可用（版本不兼容？）"
-        cand = os.path.normpath(
-            os.path.join(pkg_dir, os.path.dirname(exts[0]), "subagent-entry.js"))
-        if os.path.isfile(cand):
-            return cand, ""
-        # 该候选不可解析 → 继续看后面的候选（F6）
-        last_missing = os.path.relpath(cand, pkg_dir)
-    if seen:
-        return None, (f"{MC_PACKAGE} 的只读工具入口不存在（{last_missing}）"
-                      f"——上游版本可能改了布局")
-    return None, (f"packages 里没有可解析的 {MC_PACKAGE}——装它"
-                  f"（pi install npm:{MC_PACKAGE}），或改用零扩展档："
-                  f"--extension-policy none")
+            last = f"{pkg_name} 的 pi.extensions 形态不可用（版本不兼容？）"
+            continue
+        return pkg_dir, exts, ""
+    return None, [], (last or f"{pkg_name} 的扩展入口不可用")
+
+
+def resolve_mc_tools_entry(agent_dir=None):
+    """解析 MC 的**只读工具入口**（`dist/subagent-entry.js`）——"mc-tools" 档用。
+
+    路径推理：MC 自己就是用"主入口的**兄弟文件**"（其源码
+    `resolveSiblingEntryPath("subagent-entry.js")`）定位它；我们等价地读它声明的
+    扩展入口（`pi.extensions[0]`），再取同目录下的 subagent-entry.js。
+
+    失败语义（与 resolve_mcp_adapter_entry 同）：任一步缺失返回 `(None, 原因)`
+    ——**由调用方按策略决定**：loop 生产态做**可见降级**，严格态
+    （`MV_MC_TOOLS_STRICT=1`）直接报错。
+    """
+    pkg_dir, exts, err = _declared_extensions(MC_PACKAGE, agent_dir)
+    if err:
+        return None, err
+    cand = os.path.normpath(
+        os.path.join(pkg_dir, os.path.dirname(exts[0]), "subagent-entry.js"))
+    if os.path.isfile(cand):
+        return cand, ""
+    return None, (f"{MC_PACKAGE} 的只读工具入口不存在"
+                  f"（{os.path.relpath(cand, pkg_dir)}）——上游版本可能改了布局")
+
+
+def resolve_mcp_adapter_entry(agent_dir=None):
+    """解析 MCP adapter 的扩展入口（它声明的 `pi.extensions[0]`）——mc-tools 第二份。
+
+    为什么需要：MCP 工具（web_search / web_reader / zread…）由 pi-mcp-adapter
+    提供，而 `--no-extensions` 关掉的是**扩展发现**——显式 `-e` 路径照常生效
+    （pi --help 原文）。不显式加载 = agents 完全没有联网检索能力。
+
+    与 MC 的差别：这里要的**就是主入口本身**（它注册 MCP 工具），不取兄弟文件。
+    """
+    pkg_dir, exts, err = _declared_extensions(MCP_ADAPTER_PACKAGE, agent_dir)
+    if err:
+        return None, err
+    cand = os.path.normpath(os.path.join(pkg_dir, exts[0]))
+    if os.path.isfile(cand):
+        return cand, ""
+    return None, (f"{MCP_ADAPTER_PACKAGE} 声明的入口不存在"
+                  f"（{os.path.relpath(cand, pkg_dir)}）")
 
 
 def pi_agent_dir():
@@ -778,6 +818,10 @@ def mc_tools_strict():
 # 入口是它的内部文件，路径解析见 resolve_mc_tools_entry 的 docstring）
 MC_PACKAGE = "@cortexkit/pi-magic-context"
 
+# MCP 工具（web_search / web_reader / zread…）的提供者——mc-tools 档的第二份入口。
+# 名字**由 pi 的注册表给**（settings.json.packages），这里只做精确匹配用。
+MCP_ADAPTER_PACKAGE = "pi-mcp-adapter"
+
 FORK_MODES = ("budget", "compaction", "full")
 DEFAULT_FORK_MODE = "budget"
 #

package/meeting_loop.py

@@ -330,19 +330,36 @@ def _build_wake_cmd(workdir, agent, sid, cfg, fork_source, fork_cwd,
     if extension_policy == "none":
         cmd += no_ext
     elif extension_policy == "mc-tools":
-        entry, err = meeting_fs.resolve_mc_tools_entry()
-        if entry:
-            cmd += no_ext + ["-e", entry]
-        elif meeting_fs.mc_tools_strict():
-            # 严格模式（测试/探针保真）：缺 MC 即响，不降级——否则测试可能在
-            # "没装 MC"的环境里通过，而 ctx_search 从未生效
-            log(agent, f"[fatal] mc-tools 档入口解析失败（严格模式）：{err}")
-            raise RuntimeError(f"mc-tools 档不可用: {err}")
-        else:
-            # mc-tools **允许**而非要求 MC：缺 MC → 降级零扩展，但**可见**
-            effective_policy = "none"
-            downgrade_reason = err
-            cmd += no_ext
+        # mc-tools = 零扩展 + 显式加载**两份只读工具入口**（2026-09-25 用户裁定 B：
+        # 并入默认档，不再新增档位——保持简单）：
+        #   ① MC 的 subagent-entry（只注册工具、不装 hook）→ ctx_search
+        #   ② MCP adapter（web_search / web_reader / zread 等 MCP 工具）
+        # 为什么必须显式 -e：`--no-extensions` 关的是**发现**，显式路径照常生效
+        # （pi --help 原文）；MCP 工具此前因发现被关而对 agents 完全不可用。
+        # 两份入口**各自独立**降级（允许而非要求）——缺哪个就少哪个，都**可见**。
+        resolved = []          # [(label, entry)]
+        missing = []           # [(label, err)]
+        for label, resolver in (
+                ("ctx_search（MC 只读检索）", meeting_fs.resolve_mc_tools_entry),
+                ("MCP 工具（web_search 等）", meeting_fs.resolve_mcp_adapter_entry)):
+            entry, err = resolver()
+            if entry:
+                resolved.append((label, entry))
+            else:
+                missing.append((label, err))
+        cmd += no_ext
+        for _label, entry in resolved:
+            cmd += ["-e", entry]
+        if missing:
+            reason = "；".join(f"{label} 不可用（{err}）" for label, err in missing)
+            if meeting_fs.mc_tools_strict():
+                # 严格模式（测试/探针保真）：缺入口即响，不降级——否则测试可能在
+                # "没装某入口"的环境里通过，而该工具从未生效
+                log(agent, f"[fatal] mc-tools 档入口解析失败（严格模式）：{reason}")
+                raise RuntimeError(f"mc-tools 档不可用: {reason}")
+            # 允许而非要求：缺入口 → 少一份 -e，但**可见**
+            downgrade_reason = reason
+            effective_policy = ("mc-tools" if resolved else "none")
     # "all"：不加任何 --no-*（走 pi 默认发现）
     if first_wake:
         # 登记行（观测面的稳定字段；报告据此给"声明 vs 生效"）。只在首唤打：
@@ -351,8 +368,10 @@ def _build_wake_cmd(workdir, agent, sid, cfg, fork_source, fork_cwd,
                    f" strict={int(meeting_fs.mc_tools_strict())}"
                    + (f" 降级原因={downgrade_reason}" if downgrade_reason else ""))
         if downgrade_reason:
-            log(agent, f"mc-tools 档未生效（{downgrade_reason}）——本次按零扩展"
-                       f"运行：ctx_search 不可用")
+              log(agent, f"mc-tools 档{'部分' if resolved else '完全'}未生效"
+                         f"（{downgrade_reason}）——本次按"
+                         f"{'已解析的入口' if resolved else '零扩展'}运行："
+                         f"缺失的工具在本次分析中不可用")
     model = cfg.get("model") or ""
     if model:
         cmd += ["--model", model]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-multi-viewers",
-  "version": "0.8.3",
+  "version": "0.9.0",
   "description": "Multi-perspective analysis for Pi: fork the main session into N perspective agents over the meeting protocol.",
   "type": "module",
   "private": false,