@shgroup/dsh-serenity-hooks 1.79.0 → 1.79.1

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-serenity-hooks",
-  "version": "1.79.0",
+  "version": "1.79.1",
   "main": "lib/index.js",
   "description": "宁静号 ACC harness（Native Cordis 插件）：给 DSH 装一个「AI 工作区」——14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹声明 = 轨迹目录下的 trajectory.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档，deepseek-ai/deepseek-harness）。",
   "engines": {

package/lib/im/channels.d.ts

@@ -64,6 +64,16 @@ export interface ImChannel {
     id: string;
     /** 该 CCC 是否启用了本通道（缺省实现：读该通道的 CCC 配置） */
     isEnabled(root: string): boolean;
+    /**
+     * `isEnabled` 为假时**给人看的原因与怎么改**（可选）。
+     *
+     * 🔴 为什么它归通道自己而不归工具面（2026-10-20 Q4 真机验收踩到）：
+     * 工具面先前统一印「enable it in … (weixin.enabled)」，而**只有通道自己知道
+     * "怎样才能启用我"** —— 飞书能否用不取决于 `weixin.enabled`，而取决于有没有
+     * 一条启用中的飞书账号。⇒ 统一文案在第二个渠道上就成了**教一个不生效的改法**。
+     * 缺省（不给）⇒ 用通用文案，说"查该渠道自己的开关／账号表"，不点名任何具体字段。
+     */
+    notEnabledReason?(root: string): string | undefined;
     /** 别名/裸 id → 通道用户；无法解析返回 null */
     resolveUser(root: string, input: string): ImUserEntry | null;
     /** 已配置别名列表（`users` 动作） */

package/lib/index.js

@@ -11168,11 +11168,19 @@ function hasEnabledImChannel(root) {
 	} catch {}
 	return false;
 }
-/** 错误码 → 可行动提示（模型视角：说清怎么改） */
-function remediationFor(code) {
+/**
+* 错误码 → 可行动提示（模型视角：说清怎么改）。
+*
+* 🔴 `CHANNEL_NOT_CONFIGURED` 的提示**不能写死某一个渠道的字段名**（2026-10-20 Q4 真机验收踩到）：
+* 首版逐字写「enable it in … (weixin.enabled)」，而接第二个渠道后，**飞书能不能用不取决于
+* 这个开关**（它取决于有没有一条启用中的飞书账号）⇒ 按那句提示去改 `weixin.enabled`
+* **不会生效**，而错误码又指向"没配置" ⇒ 用户据此改完还是同一句报错。
+* ⇒ 提示按**渠道是否带自己的启用判据**分岔：带 `channelHint` 的就用它自己的说法。
+*/
+function remediationFor(code, channelHint) {
 	switch (code) {
 		case "CHANNEL_UNKNOWN": return "Use a registered channel id (see the tool description)";
-		case "CHANNEL_NOT_CONFIGURED": return "This CCC has not configured that channel — enable it in .opencode/serenity.json (weixin.enabled) or the settings panel";
+		case "CHANNEL_NOT_CONFIGURED": return channelHint ?? "This CCC has not configured that channel — check .opencode/serenity.json (the channel's own enabled flag / accounts) or the settings panel";
 		case "ACTION_UNKNOWN": return "Use send / send-file / users / status";
 		case "ACTION_UNSUPPORTED": return "This channel does not support that action";
 		case "ALIAS_UNKNOWN": return "Use a configured alias (see action=users) or a raw channel user id";
@@ -11252,7 +11260,7 @@ async function runImBridge(root, req) {
 	if (channelId === "") return fail("CHANNEL_REQUIRED", "channel is required", "Provide channel (e.g. \"weixin\")");
 	const channel = channels.get(channelId);
 	if (!channel) return fail("CHANNEL_UNKNOWN", `unknown channel "${channelId}" (registered: ${imChannelIds().join(", ") || "(none)"})`);
-	if (!channel.isEnabled(root)) return fail("CHANNEL_NOT_CONFIGURED", `channel "${channelId}" is not configured for this CCC (${root})`);
+	if (!channel.isEnabled(root)) return fail("CHANNEL_NOT_CONFIGURED", `channel "${channelId}" is not configured for this CCC (${root})`, channel.notEnabledReason?.(root));
 	if (action === "users") return {
 		ok: true,
 		channel: channelId,
@@ -21359,6 +21367,13 @@ const weixinChannel = {
 	isEnabled(root) {
 		return readWeixinSettings(root).enabled === true;
 	},
+	/**
+	* 微信的启用判据**只有总开关这一半**（有 token 的账号是可选的：条数不限、0 条也能开）。
+	* ⇒ 它的提示可以只提这个开关 —— 这与飞书的**两半**不同，别把两家的提示合成一句。
+	*/
+	notEnabledReason() {
+		return "This CCC has no IM bridge enabled — turn on the IM switch in .opencode/serenity.json (im.enabled, or the legacy weixin.enabled) or in the settings panel";
+	},
 	resolveUser(root, input) {
 		const raw = input.trim();
 		if (raw === "") return null;
@@ -21605,6 +21620,16 @@ const feishuChannel = {
 		if (settings.enabled !== true) return false;
 		return (settings.accounts ?? []).some((a) => a.enabled !== false && isFeishuAccount(a));
 	},
+	/**
+	* 启用判据不成立时**说清是哪一半不成立**。
+	*
+	* 🔴 两半的改法完全不同（总开关 vs 加一条账号），合并成一句会让人改错那一半
+	* —— 这正是本轮真机验收暴露出来的形态（旧文案只提 `weixin.enabled`）。
+	*/
+	notEnabledReason(root) {
+		if (readWeixinSettings(root).enabled !== true) return "This CCC has no IM bridge enabled — turn on the IM switch in .opencode/serenity.json (im.enabled, or the legacy weixin.enabled) or in the settings panel";
+		return "The IM bridge is on, but this CCC has no enabled feishu account — add one (App ID + App Secret) in the settings panel, or add a row with channel:\"feishu\" to im.accounts";
+	},
 	resolveUser(root, input) {
 		const raw = input.trim();
 		if (raw === "") return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.79.0",
+  "version": "1.79.1",
   "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：14 个工具（container_fs/cognitive_trajectory/dashboard/container_git/msm/praxis/ontology/serenity-skill-creator/cheap-worker/localstore/container_admin；另三个 im-bridge/acc-diag/diagram 按配置条件出现）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 认知轨迹日志与原地重建 + 网页登录入口/IM 桥/认知轨迹唤醒注册表。轨迹声明 = 轨迹目录下的 trajectory.json（约束面 + 旧标识 uid + CRO 机器绑定 cro.host；旧名 trajectory-constraint.json / skiff.json 仍在读取族里）；轨迹提示词 = 轨迹目录下的 PROMPT.md（一条轨迹「是谁、按什么章程工作」，所有轨迹通用，追加在容器层与质量层之后，不替换它们）。适配 DSH 0.1.7-rc.1 / 0.2.0-rc.1 / 0.2.1-rc.1（三档）。",
   "license": "MIT",
   "repository": {