@bolloon/bolloon-agent 0.1.24 → 0.1.25

package/dist/web/client.js

@@ -623,6 +623,11 @@ async function selectChannel(channelId, targetSessionId = null) {
   currentChannelId = channelId;
   reconnectAttempts.set(channelId, 0);
 
+  // v3: 盾牌弹窗打开时, 切 channel 要刷列表 (tab 标题 + 已绑/未绑 分组)
+  if (typeof judgmentsModal !== 'undefined' && judgmentsModal && judgmentsModal.classList.contains('active')) {
+    if (typeof lastJudgmentsCache !== 'undefined') renderJudgments(lastJudgmentsCache);
+  }
+
   // 找到当前频道和 session
   const channel = channels.find(c => c.id === channelId);
   if (channel) {
@@ -1996,6 +2001,18 @@ let judgmentsLoaded = false;
 function showJudgmentsModal() {
   if (judgmentsModal) judgmentsModal.classList.add('active');
   if (!judgmentsLoaded) loadJudgments();
+  else renderJudgments(lastJudgmentsCache); // 打开时按当前 channel / tab 重渲
+}
+
+function switchJudgmentTab(tab) {
+  currentJudgmentTab = tab;
+  document.querySelectorAll('.judgment-tab').forEach(btn => {
+    const active = btn.dataset.tab === tab;
+    btn.classList.toggle('active', active);
+    btn.style.borderBottomColor = active ? '#2563eb' : 'transparent';
+    btn.style.color = active ? '#2563eb' : '#6b7280';
+  });
+  renderJudgments(lastJudgmentsCache);
 }
 
 function hideJudgmentsModal() {
@@ -2008,16 +2025,83 @@ function escapeHtml(s) {
   }[c]));
 }
 
+let currentJudgmentTab = 'channel'; // 'channel' | 'global'
+let lastJudgmentsCache = []; // 最近一次 loadJudgments 拿到的原始列表, 切 tab / 切 channel 时复用
+
+/**
+ * v3 重做: 渲染判断力列表 (受 tab + 当前 channel 影响)
+ *   tab = 'channel': 拆为"已绑定" + "未绑定"两组, 每条带 + / × 按钮
+ *   tab = 'global':  全部 judgment 列表, 无 + / × 按钮
+ * 如果没选 channel, 'channel' tab 自动显示提示 + 全部 judgment
+ */
 function renderJudgments(items) {
   if (!judgmentsList) return;
-  if (!items || items.length === 0) {
+  const all = items || [];
+  const titleEl = document.getElementById('judgments-list-title');
+  const chNameEl = document.getElementById('judgments-tab-channel-name');
+  const currentCh = currentChannelId
+    ? channels.find(c => c.id === currentChannelId)
+    : null;
+
+  if (chNameEl) {
+    chNameEl.textContent = currentCh ? `(${currentCh.name})` : '(未选)';
+  }
+
+  if (all.length === 0) {
     judgmentsList.innerHTML = '<div class="task-empty">还没有判断, 在上面记录第一条吧</div>';
+    if (titleEl) titleEl.textContent = '本 channel 的判断力';
+    return;
+  }
+
+  if (currentJudgmentTab === 'global') {
+    // 全局 tab: 全部 judgment, 简单列表
+    if (titleEl) titleEl.textContent = `全局判断力 (${all.length} 条)`;
+    judgmentsList.innerHTML = renderJudgmentItems(all, { showBindToggle: false });
     return;
   }
-  const html = items.map(j => {
+
+  // channel tab: 必须有 channel
+  if (!currentCh) {
+    if (titleEl) titleEl.textContent = '本 channel 的判断力';
+    judgmentsList.innerHTML = `
+      <div style="padding:24px 12px;text-align:center;color:#6b7280;font-size:13px;">
+        请先在左侧选中一个 channel,<br>然后这里会显示已绑定和可加入的判断力。
+      </div>
+    `;
+    return;
+  }
+
+  const boundIds = new Set(
+    Array.isArray(currentCh.bound_judgment_ids) ? currentCh.bound_judgment_ids : []
+  );
+  const bound = all.filter(j => boundIds.has(j.id));
+  const unbound = all.filter(j => !boundIds.has(j.id));
+
+  if (titleEl) titleEl.textContent = `${currentCh.name} 的判断力 (已绑 ${bound.length} / 共 ${all.length})`;
+
+  let html = '';
+  if (bound.length > 0) {
+    html += `<div style="font-size:11px;color:#6b7280;text-transform:uppercase;letter-spacing:0.5px;padding:8px 4px 4px;">已绑定 (${bound.length})</div>`;
+    html += renderJudgmentItems(bound, { showBindToggle: true, isBound: true });
+  }
+  if (unbound.length > 0) {
+    html += `<div style="font-size:11px;color:#6b7280;text-transform:uppercase;letter-spacing:0.5px;padding:14px 4px 4px;">未绑定 (${unbound.length})</div>`;
+    html += renderJudgmentItems(unbound, { showBindToggle: true, isBound: false });
+  }
+  judgmentsList.innerHTML = html;
+}
+
+function renderJudgmentItems(items, opts) {
+  const { showBindToggle, isBound } = opts || {};
+  return items.map(j => {
     const reason = (j.reasons && j.reasons[0]) ? escapeHtml(j.reasons[0]) : '';
     const domain = (j.context && j.context.domain) ? escapeHtml(j.context.domain) : 'general';
     const stakes = (j.context && j.context.stakes) ? escapeHtml(j.context.stakes) : 'medium';
+    const bindBtn = showBindToggle
+      ? isBound
+        ? `<button class="judgment-toggle-btn" data-id="${escapeHtml(j.id)}" data-action="unbind" title="从当前 channel 移除" style="background:none;border:1px solid #fca5a5;color:#b91c1c;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">× 移除</button>`
+        : `<button class="judgment-toggle-btn" data-id="${escapeHtml(j.id)}" data-action="bind" title="加进当前 channel" style="background:none;border:1px solid #6b7280;color:#6b7280;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">+ 加入</button>`
+      : '';
     return `
       <div class="task-item completed judgment-row"
            data-judgment-id="${escapeHtml(j.id)}"
@@ -2037,6 +2121,7 @@ function renderJudgments(items) {
         <div class="task-item-meta" style="color:#999;font-size:11px;margin-top:4px;display:flex;justify-content:space-between;align-items:center;">
           <span>${domain} · ${escapeHtml(j.timestamp)} · ${escapeHtml(j.id)}</span>
           <span style="display:flex;gap:4px;">
+            ${bindBtn}
             <button class="judgment-edit-btn" data-id="${escapeHtml(j.id)}" title="编辑判断" style="background:none;border:1px solid #d1d5db;color:#374151;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">编辑</button>
             <button class="judgment-del-btn" data-id="${escapeHtml(j.id)}" title="删除判断" style="background:none;border:1px solid #fca5a5;color:#b91c1c;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">删除</button>
           </span>
@@ -2044,7 +2129,6 @@ function renderJudgments(items) {
       </div>
     `;
   }).join('');
-  judgmentsList.innerHTML = html;
 }
 
 async function loadJudgments() {
@@ -2053,7 +2137,8 @@ async function loadJudgments() {
     const res = await fetch('/api/judgments');
     if (!res.ok) throw new Error('HTTP ' + res.status);
     const data = await res.json();
-    renderJudgments(data.judgments);
+    lastJudgmentsCache = data.judgments || [];
+    renderJudgments(lastJudgmentsCache);
     if (judgmentsBadge) {
       if (data.count > 0) {
         judgmentsBadge.textContent = data.count;
@@ -2068,11 +2153,46 @@ async function loadJudgments() {
   }
 }
 
+/** 把 judgment id 加进 / 移出当前 channel.bound_judgment_ids, 然后刷新两边 UI */
+async function toggleChannelJudgment(judgmentId, action) {
+  if (!currentChannelId) {
+    showJudgmentError('请先选中一个 channel');
+    return;
+  }
+  const ch = channels.find(c => c.id === currentChannelId);
+  if (!ch) return;
+  const set = new Set(Array.isArray(ch.bound_judgment_ids) ? ch.bound_judgment_ids : []);
+  if (action === 'bind') set.add(judgmentId);
+  else set.delete(judgmentId);
+  const next = Array.from(set);
+  try {
+    const res = await fetch(`/channels/${currentChannelId}`, {
+      method: 'PATCH',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ bound_judgment_ids: next })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(err.error || `HTTP ${res.status}`);
+    }
+    const updated = await res.json();
+    const idx = channels.findIndex(c => c.id === currentChannelId);
+    if (idx >= 0) channels[idx] = updated;
+    // 弹窗开着就刷新, 关着就跳过
+    if (judgmentsModal && judgmentsModal.classList.contains('active')) {
+      renderJudgments(lastJudgmentsCache);
+    }
+  } catch (err) {
+    showJudgmentError('绑定失败: ' + err.message);
+  }
+}
+
 // 列表内编辑/删除 + 拖拽 — 事件委托
 if (judgmentsList) {
   judgmentsList.addEventListener('click', async (e) => {
     const editBtn = e.target.closest && e.target.closest('.judgment-edit-btn');
     const delBtn = e.target.closest && e.target.closest('.judgment-del-btn');
+    const toggleBtn = e.target.closest && e.target.closest('.judgment-toggle-btn');
     if (editBtn) {
       const id = editBtn.getAttribute('data-id');
       await editJudgment(id);
@@ -2087,9 +2207,18 @@ if (judgmentsList) {
       } catch (err) {
         showJudgmentError('删除失败: ' + err.message);
       }
+    } else if (toggleBtn) {
+      const id = toggleBtn.getAttribute('data-id');
+      const action = toggleBtn.getAttribute('data-action');
+      await toggleChannelJudgment(id, action);
     }
   });
 
+  // tab 切换
+  document.querySelectorAll('.judgment-tab').forEach(btn => {
+    btn.addEventListener('click', () => switchJudgmentTab(btn.dataset.tab));
+  });
+
   // 拖拽: 每条 judgment 是 drag source, dataTransfer 装 decision text
   judgmentsList.addEventListener('dragstart', (e) => {
     const row = e.target.closest && e.target.closest('.judgment-row');
@@ -2831,7 +2960,10 @@ if (agentAddConfirmBtn) {
         const res = await fetch(`/channels/${channelId}`, {
           method: 'PATCH',
           headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ walletAddress: walletAddress || null, autoInvokeTools })
+          body: JSON.stringify({
+            walletAddress: walletAddress || null,
+            autoInvokeTools
+          })
         });
         if (!res.ok) throw new Error('update failed');
         const updated = await res.json();
@@ -2846,4 +2978,3 @@ if (agentAddConfirmBtn) {
     }
   });
 }
-

package/dist/web/index.html

@@ -236,8 +236,19 @@
               <input type="file" id="judgment-import-file" accept=".json,.yaml,.yml,.md,.txt,.html,.htm" style="display:none">
             </div>
             <div id="judgment-error" class="form-info" style="display:none;color:#b91c1c;"></div>
-            <h3 style="margin-top:24px;font-size:14px;font-weight:600;display:flex;align-items:center;gap:12px;flex-wrap:wrap;">
-              <span>已记录的判断</span>
+            <!-- v3 重做: tab 切换 — 默认显示当前 channel 的 judgment 上下文, 切换后才是全部 -->
+            <div id="judgments-tabs" style="display:flex;border-bottom:1px solid #e5e7eb;margin-top:20px;">
+              <button class="judgment-tab active" data-tab="channel"
+                      style="flex:1;padding:10px 12px;background:none;border:none;border-bottom:2px solid #2563eb;color:#2563eb;font-size:13px;font-weight:600;cursor:pointer;">
+                本 channel <span id="judgments-tab-channel-name" style="font-weight:normal;color:#6b7280;"></span>
+              </button>
+              <button class="judgment-tab" data-tab="global"
+                      style="flex:1;padding:10px 12px;background:none;border:none;border-bottom:2px solid transparent;color:#6b7280;font-size:13px;font-weight:600;cursor:pointer;">
+                全局
+              </button>
+            </div>
+            <h3 style="margin-top:16px;font-size:14px;font-weight:600;display:flex;align-items:center;gap:12px;flex-wrap:wrap;">
+              <span id="judgments-list-title">本 channel 的判断力</span>
               <span style="display:flex;align-items:center;gap:6px;margin-left:auto;font-size:12px;font-weight:normal;">
                 <label style="display:flex;align-items:center;gap:4px;cursor:pointer;color:#6b7280;">
                   <input type="checkbox" id="judgment-select-all" style="cursor:pointer;"> 全选

package/dist/web/server.js

@@ -256,6 +256,54 @@ async function executeTask(task, channelId) {
 let sseClients = new Set();
 let channelSessions = new Map(); // key: channelId
 let sessionMessages = new Map(); // key: channelId + sessionId
+/**
+ * v3 重做: 构造 channel 的两路 judgment prompt 片段
+ *   路 1: 用户在盾牌里手动绑定的 judgment (channel.bound_judgment_ids)
+ *   路 2: 全局 judgment 列表 (供 LLM 在主调用中按需挑选, 写入回复)
+ * 返回 "" 表示完全没数据; 否则返回完整 "[系统上下文] ..." 块 (含尾部换行)
+ * 失败非致命 — 任何异常都返回空串, 保证 LLM 调用不被阻塞
+ */
+async function buildJudgmentHint(channel, channelIdForLog) {
+    try {
+        const { loadAllJudgments, initializeValueStore } = await import('../pi-ecosystem-judgment/human-value-store.js');
+        await initializeValueStore();
+        const allJudgments = await loadAllJudgments();
+        if (allJudgments.length === 0)
+            return '';
+        const boundIds = new Set(channel && Array.isArray(channel.bound_judgment_ids) ? channel.bound_judgment_ids : []);
+        const bound = allJudgments.filter(j => j.id !== undefined && boundIds.has(j.id));
+        const others = allJudgments.filter(j => j.id !== undefined && !boundIds.has(j.id));
+        let hint = '';
+        // 路 1: 用户手动绑定的 judgment — 硬约束, 必须遵循
+        if (bound.length > 0) {
+            hint += `[系统上下文] 此 channel 用户绑定了 ${bound.length} 条判断力, 必须严格遵循:\n`;
+            for (const j of bound) {
+                const decision = (j.decision || '').toString().slice(0, 200);
+                const reasonList = Array.isArray(j.reasons) ? j.reasons : [];
+                const reasonText = reasonList.length > 0
+                    ? ` (理由: ${reasonList.join('; ').slice(0, 100)})`
+                    : '';
+                hint += `- ${decision}${reasonText}\n`;
+            }
+            hint += '\n';
+        }
+        // 路 2: 全局 judgment 候选池 — 软参考, LLM 自己挑
+        if (others.length > 0) {
+            hint += `[系统上下文] 候选判断力 (用户未明确绑定, 你可以按相关性自主选择参考):\n`;
+            for (const j of others) {
+                const decision = (j.decision || '').toString().slice(0, 120);
+                hint += `- [id=${j.id}] ${decision}\n`;
+            }
+            hint += `\n[系统上下文] 如果你的回复参考了某条候选判断力, 请在回复中自然提及 "我参考了你的判断: <decision 简述>" 即可, 无需复述 id.\n\n`;
+        }
+        console.log(`[v3] channel ${channelIdForLog} 注入: 绑定 ${bound.length} 条, 候选 ${others.length} 条`);
+        return hint;
+    }
+    catch (err) {
+        console.error(`[v3] 加载判断力失败 (非致命):`, err.message);
+        return '';
+    }
+}
 async function getAgentForChannel(channelId, channelDid, channelName, channelDidDoc) {
     // 获取当前 channel 的 currentSessionId
     const channels = await loadChannels();
@@ -468,6 +516,8 @@ export async function createWebServer(port = 3000, options = {}) {
         // (line ~638) 与这里外层的 const channel 形成 shadowing 让 TS 误报"使用前未声明"
         const boundWalletAddress = channel?.walletAddress;
         const autoToolsEnabled = channel?.autoInvokeTools !== false; // 默认开启
+        // 捕获外层 channel 到独立变量, 避免被 try 块内 (line 740+) 的 const channel 遮蔽
+        const channelForJudgment = channel;
         try {
             const agent = await getAgentForChannel(channelId, realChannelDid, realChannelName, realChannelDidDoc);
             let fullResponse = '';
@@ -503,6 +553,11 @@ export async function createWebServer(port = 3000, options = {}) {
             else {
                 contextHint += `[系统上下文] 自动工具调用已关闭: 每次执行工具前必须先与用户确认。\n`;
             }
+            // v3: 注入 channel 绑定的判断力 (judgment_ids)
+            // 这是 v3 的核心 — channel 跑 LLM 时, 它的判断力 = 绑定的 judgment 列表
+            const judgmentHint = await buildJudgmentHint(channelForJudgment, channelId);
+            if (judgmentHint)
+                contextHint += judgmentHint;
             if (contextHint)
                 contextHint += '\n';
             fullResponse = await agent.promptStream(contextHint + text, streamCallback);
@@ -661,8 +716,8 @@ export async function createWebServer(port = 3000, options = {}) {
     });
     app.post('/channels', async (req, res) => {
         try {
-            const { name, agentId, walletAddress, autoInvokeTools } = req.body;
-            console.log(`[创建频道] 收到请求: name=${name}, agentId=${agentId}, wallet=${walletAddress ? 'yes' : 'no'}`);
+            const { name, agentId, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
+            console.log(`[创建频道] 收到请求: name=${name}, agentId=${agentId}, wallet=${walletAddress ? 'yes' : 'no'}, boundJudgments=${Array.isArray(bound_judgment_ids) ? bound_judgment_ids.length : 0}`);
             if (!name || !agentId) {
                 return res.status(400).json({ error: 'name and agentId required' });
             }
@@ -670,6 +725,10 @@ export async function createWebServer(port = 3000, options = {}) {
             const id = `ch_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
             // 校验钱包地址格式 (粗校验: 0x + 40 hex / Solana base58 / Sui 0x+64)
             const validWallet = isValidWalletAddress(walletAddress);
+            // 过滤 bound_judgment_ids: 只保留 string
+            const safeBoundIds = Array.isArray(bound_judgment_ids)
+                ? bound_judgment_ids.filter((x) => typeof x === 'string' && x.length > 0)
+                : [];
             // 先创建频道（不阻塞等待 DID 生成）
             const channel = {
                 id,
@@ -681,6 +740,7 @@ export async function createWebServer(port = 3000, options = {}) {
                 walletAddress: validWallet || undefined,
                 walletRegisteredAt: validWallet ? new Date().toISOString() : undefined,
                 autoInvokeTools: autoInvokeTools !== false, // 默认 true
+                bound_judgment_ids: safeBoundIds,
                 sessions: [{
                         id: `sess_${Date.now()}`,
                         createdAt: new Date().toISOString(),
@@ -839,7 +899,7 @@ export async function createWebServer(port = 3000, options = {}) {
     app.patch('/channels/:channelId', async (req, res) => {
         try {
             const { channelId } = req.params;
-            const { name, walletAddress, autoInvokeTools } = req.body;
+            const { name, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
             const channels = await loadChannels();
             const channel = channels.find(c => c.id === channelId);
             if (!channel) {
@@ -866,6 +926,19 @@ export async function createWebServer(port = 3000, options = {}) {
             if (typeof autoInvokeTools === 'boolean') {
                 channel.autoInvokeTools = autoInvokeTools;
             }
+            // bound_judgment_ids: 允许数组(替换)/null(清空)/undefined(不改)
+            if (bound_judgment_ids !== undefined) {
+                if (bound_judgment_ids === null) {
+                    channel.bound_judgment_ids = [];
+                }
+                else if (Array.isArray(bound_judgment_ids)) {
+                    channel.bound_judgment_ids = bound_judgment_ids.filter((x) => typeof x === 'string' && x.length > 0);
+                }
+                else {
+                    return res.status(400).json({ error: 'bound_judgment_ids must be array or null' });
+                }
+                console.log(`[Channel ${channelId}] 绑定判断力: ${channel.bound_judgment_ids.length} 条`);
+            }
             channel.updatedAt = new Date().toISOString();
             await saveChannels(channels);
             res.json(channel);
@@ -1027,8 +1100,9 @@ export async function createWebServer(port = 3000, options = {}) {
                     broadcast({ type: 'error', content: event.content }, channelId);
                 }
             };
-            // 重新生成时只发送用户消息
-            fullResponse = await agent.promptStream(userMessage, streamCallback);
+            // 重新生成时只发送用户消息 (v3: 同时注入 channel 绑定的判断力)
+            const regenHint = await buildJudgmentHint(channel, channelId);
+            fullResponse = await agent.promptStream(regenHint + userMessage, streamCallback);
             broadcast({ type: 'ai', content: fullResponse }, channelId);
             // 更新 session
             const existingSession = await loadSession(channelId, currentSessionId);
@@ -2140,7 +2214,8 @@ export async function createWebServer(port = 3000, options = {}) {
     try {
         const { createHealthMonitor, createWatchdog } = await import('../heartbeat/index.js');
         healthMonitor = createHealthMonitor();
-        watchdog = createWatchdog();
+        // 把 watchdog 静默阈值拉到 30 分钟, 避免开发期 / 用户空闲时被误杀
+        watchdog = createWatchdog({ silentThresholdMs: 30 * 60 * 1000 });
         console.log('[24h] Heartbeat modules loaded');
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli.js",

package/src/web/client.js

@@ -623,6 +623,11 @@ async function selectChannel(channelId, targetSessionId = null) {
   currentChannelId = channelId;
   reconnectAttempts.set(channelId, 0);
 
+  // v3: 盾牌弹窗打开时, 切 channel 要刷列表 (tab 标题 + 已绑/未绑 分组)
+  if (typeof judgmentsModal !== 'undefined' && judgmentsModal && judgmentsModal.classList.contains('active')) {
+    if (typeof lastJudgmentsCache !== 'undefined') renderJudgments(lastJudgmentsCache);
+  }
+
   // 找到当前频道和 session
   const channel = channels.find(c => c.id === channelId);
   if (channel) {
@@ -1996,6 +2001,18 @@ let judgmentsLoaded = false;
 function showJudgmentsModal() {
   if (judgmentsModal) judgmentsModal.classList.add('active');
   if (!judgmentsLoaded) loadJudgments();
+  else renderJudgments(lastJudgmentsCache); // 打开时按当前 channel / tab 重渲
+}
+
+function switchJudgmentTab(tab) {
+  currentJudgmentTab = tab;
+  document.querySelectorAll('.judgment-tab').forEach(btn => {
+    const active = btn.dataset.tab === tab;
+    btn.classList.toggle('active', active);
+    btn.style.borderBottomColor = active ? '#2563eb' : 'transparent';
+    btn.style.color = active ? '#2563eb' : '#6b7280';
+  });
+  renderJudgments(lastJudgmentsCache);
 }
 
 function hideJudgmentsModal() {
@@ -2008,16 +2025,83 @@ function escapeHtml(s) {
   }[c]));
 }
 
+let currentJudgmentTab = 'channel'; // 'channel' | 'global'
+let lastJudgmentsCache = []; // 最近一次 loadJudgments 拿到的原始列表, 切 tab / 切 channel 时复用
+
+/**
+ * v3 重做: 渲染判断力列表 (受 tab + 当前 channel 影响)
+ *   tab = 'channel': 拆为"已绑定" + "未绑定"两组, 每条带 + / × 按钮
+ *   tab = 'global':  全部 judgment 列表, 无 + / × 按钮
+ * 如果没选 channel, 'channel' tab 自动显示提示 + 全部 judgment
+ */
 function renderJudgments(items) {
   if (!judgmentsList) return;
-  if (!items || items.length === 0) {
+  const all = items || [];
+  const titleEl = document.getElementById('judgments-list-title');
+  const chNameEl = document.getElementById('judgments-tab-channel-name');
+  const currentCh = currentChannelId
+    ? channels.find(c => c.id === currentChannelId)
+    : null;
+
+  if (chNameEl) {
+    chNameEl.textContent = currentCh ? `(${currentCh.name})` : '(未选)';
+  }
+
+  if (all.length === 0) {
     judgmentsList.innerHTML = '<div class="task-empty">还没有判断, 在上面记录第一条吧</div>';
+    if (titleEl) titleEl.textContent = '本 channel 的判断力';
+    return;
+  }
+
+  if (currentJudgmentTab === 'global') {
+    // 全局 tab: 全部 judgment, 简单列表
+    if (titleEl) titleEl.textContent = `全局判断力 (${all.length} 条)`;
+    judgmentsList.innerHTML = renderJudgmentItems(all, { showBindToggle: false });
     return;
   }
-  const html = items.map(j => {
+
+  // channel tab: 必须有 channel
+  if (!currentCh) {
+    if (titleEl) titleEl.textContent = '本 channel 的判断力';
+    judgmentsList.innerHTML = `
+      <div style="padding:24px 12px;text-align:center;color:#6b7280;font-size:13px;">
+        请先在左侧选中一个 channel,<br>然后这里会显示已绑定和可加入的判断力。
+      </div>
+    `;
+    return;
+  }
+
+  const boundIds = new Set(
+    Array.isArray(currentCh.bound_judgment_ids) ? currentCh.bound_judgment_ids : []
+  );
+  const bound = all.filter(j => boundIds.has(j.id));
+  const unbound = all.filter(j => !boundIds.has(j.id));
+
+  if (titleEl) titleEl.textContent = `${currentCh.name} 的判断力 (已绑 ${bound.length} / 共 ${all.length})`;
+
+  let html = '';
+  if (bound.length > 0) {
+    html += `<div style="font-size:11px;color:#6b7280;text-transform:uppercase;letter-spacing:0.5px;padding:8px 4px 4px;">已绑定 (${bound.length})</div>`;
+    html += renderJudgmentItems(bound, { showBindToggle: true, isBound: true });
+  }
+  if (unbound.length > 0) {
+    html += `<div style="font-size:11px;color:#6b7280;text-transform:uppercase;letter-spacing:0.5px;padding:14px 4px 4px;">未绑定 (${unbound.length})</div>`;
+    html += renderJudgmentItems(unbound, { showBindToggle: true, isBound: false });
+  }
+  judgmentsList.innerHTML = html;
+}
+
+function renderJudgmentItems(items, opts) {
+  const { showBindToggle, isBound } = opts || {};
+  return items.map(j => {
     const reason = (j.reasons && j.reasons[0]) ? escapeHtml(j.reasons[0]) : '';
     const domain = (j.context && j.context.domain) ? escapeHtml(j.context.domain) : 'general';
     const stakes = (j.context && j.context.stakes) ? escapeHtml(j.context.stakes) : 'medium';
+    const bindBtn = showBindToggle
+      ? isBound
+        ? `<button class="judgment-toggle-btn" data-id="${escapeHtml(j.id)}" data-action="unbind" title="从当前 channel 移除" style="background:none;border:1px solid #fca5a5;color:#b91c1c;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">× 移除</button>`
+        : `<button class="judgment-toggle-btn" data-id="${escapeHtml(j.id)}" data-action="bind" title="加进当前 channel" style="background:none;border:1px solid #6b7280;color:#6b7280;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">+ 加入</button>`
+      : '';
     return `
       <div class="task-item completed judgment-row"
            data-judgment-id="${escapeHtml(j.id)}"
@@ -2037,6 +2121,7 @@ function renderJudgments(items) {
         <div class="task-item-meta" style="color:#999;font-size:11px;margin-top:4px;display:flex;justify-content:space-between;align-items:center;">
           <span>${domain} · ${escapeHtml(j.timestamp)} · ${escapeHtml(j.id)}</span>
           <span style="display:flex;gap:4px;">
+            ${bindBtn}
             <button class="judgment-edit-btn" data-id="${escapeHtml(j.id)}" title="编辑判断" style="background:none;border:1px solid #d1d5db;color:#374151;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">编辑</button>
             <button class="judgment-del-btn" data-id="${escapeHtml(j.id)}" title="删除判断" style="background:none;border:1px solid #fca5a5;color:#b91c1c;padding:1px 8px;border-radius:3px;cursor:pointer;font-size:11px;">删除</button>
           </span>
@@ -2044,7 +2129,6 @@ function renderJudgments(items) {
       </div>
     `;
   }).join('');
-  judgmentsList.innerHTML = html;
 }
 
 async function loadJudgments() {
@@ -2053,7 +2137,8 @@ async function loadJudgments() {
     const res = await fetch('/api/judgments');
     if (!res.ok) throw new Error('HTTP ' + res.status);
     const data = await res.json();
-    renderJudgments(data.judgments);
+    lastJudgmentsCache = data.judgments || [];
+    renderJudgments(lastJudgmentsCache);
     if (judgmentsBadge) {
       if (data.count > 0) {
         judgmentsBadge.textContent = data.count;
@@ -2068,11 +2153,46 @@ async function loadJudgments() {
   }
 }
 
+/** 把 judgment id 加进 / 移出当前 channel.bound_judgment_ids, 然后刷新两边 UI */
+async function toggleChannelJudgment(judgmentId, action) {
+  if (!currentChannelId) {
+    showJudgmentError('请先选中一个 channel');
+    return;
+  }
+  const ch = channels.find(c => c.id === currentChannelId);
+  if (!ch) return;
+  const set = new Set(Array.isArray(ch.bound_judgment_ids) ? ch.bound_judgment_ids : []);
+  if (action === 'bind') set.add(judgmentId);
+  else set.delete(judgmentId);
+  const next = Array.from(set);
+  try {
+    const res = await fetch(`/channels/${currentChannelId}`, {
+      method: 'PATCH',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ bound_judgment_ids: next })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(err.error || `HTTP ${res.status}`);
+    }
+    const updated = await res.json();
+    const idx = channels.findIndex(c => c.id === currentChannelId);
+    if (idx >= 0) channels[idx] = updated;
+    // 弹窗开着就刷新, 关着就跳过
+    if (judgmentsModal && judgmentsModal.classList.contains('active')) {
+      renderJudgments(lastJudgmentsCache);
+    }
+  } catch (err) {
+    showJudgmentError('绑定失败: ' + err.message);
+  }
+}
+
 // 列表内编辑/删除 + 拖拽 — 事件委托
 if (judgmentsList) {
   judgmentsList.addEventListener('click', async (e) => {
     const editBtn = e.target.closest && e.target.closest('.judgment-edit-btn');
     const delBtn = e.target.closest && e.target.closest('.judgment-del-btn');
+    const toggleBtn = e.target.closest && e.target.closest('.judgment-toggle-btn');
     if (editBtn) {
       const id = editBtn.getAttribute('data-id');
       await editJudgment(id);
@@ -2087,9 +2207,18 @@ if (judgmentsList) {
       } catch (err) {
         showJudgmentError('删除失败: ' + err.message);
       }
+    } else if (toggleBtn) {
+      const id = toggleBtn.getAttribute('data-id');
+      const action = toggleBtn.getAttribute('data-action');
+      await toggleChannelJudgment(id, action);
     }
   });
 
+  // tab 切换
+  document.querySelectorAll('.judgment-tab').forEach(btn => {
+    btn.addEventListener('click', () => switchJudgmentTab(btn.dataset.tab));
+  });
+
   // 拖拽: 每条 judgment 是 drag source, dataTransfer 装 decision text
   judgmentsList.addEventListener('dragstart', (e) => {
     const row = e.target.closest && e.target.closest('.judgment-row');
@@ -2831,7 +2960,10 @@ if (agentAddConfirmBtn) {
         const res = await fetch(`/channels/${channelId}`, {
           method: 'PATCH',
           headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ walletAddress: walletAddress || null, autoInvokeTools })
+          body: JSON.stringify({
+            walletAddress: walletAddress || null,
+            autoInvokeTools
+          })
         });
         if (!res.ok) throw new Error('update failed');
         const updated = await res.json();
@@ -2846,4 +2978,3 @@ if (agentAddConfirmBtn) {
     }
   });
 }
-

package/src/web/index.html

@@ -236,8 +236,19 @@
               <input type="file" id="judgment-import-file" accept=".json,.yaml,.yml,.md,.txt,.html,.htm" style="display:none">
             </div>
             <div id="judgment-error" class="form-info" style="display:none;color:#b91c1c;"></div>
-            <h3 style="margin-top:24px;font-size:14px;font-weight:600;display:flex;align-items:center;gap:12px;flex-wrap:wrap;">
-              <span>已记录的判断</span>
+            <!-- v3 重做: tab 切换 — 默认显示当前 channel 的 judgment 上下文, 切换后才是全部 -->
+            <div id="judgments-tabs" style="display:flex;border-bottom:1px solid #e5e7eb;margin-top:20px;">
+              <button class="judgment-tab active" data-tab="channel"
+                      style="flex:1;padding:10px 12px;background:none;border:none;border-bottom:2px solid #2563eb;color:#2563eb;font-size:13px;font-weight:600;cursor:pointer;">
+                本 channel <span id="judgments-tab-channel-name" style="font-weight:normal;color:#6b7280;"></span>
+              </button>
+              <button class="judgment-tab" data-tab="global"
+                      style="flex:1;padding:10px 12px;background:none;border:none;border-bottom:2px solid transparent;color:#6b7280;font-size:13px;font-weight:600;cursor:pointer;">
+                全局
+              </button>
+            </div>
+            <h3 style="margin-top:16px;font-size:14px;font-weight:600;display:flex;align-items:center;gap:12px;flex-wrap:wrap;">
+              <span id="judgments-list-title">本 channel 的判断力</span>
               <span style="display:flex;align-items:center;gap:6px;margin-left:auto;font-size:12px;font-weight:normal;">
                 <label style="display:flex;align-items:center;gap:4px;cursor:pointer;color:#6b7280;">
                   <input type="checkbox" id="judgment-select-all" style="cursor:pointer;"> 全选

package/src/web/server.ts

@@ -72,6 +72,8 @@ interface Channel {
   updatedAt: string;
   currentSessionId?: string;
   sessions?: SessionSummary[];
+  /** 用户在盾牌里手动绑定的判断力 (LLM 跑 channel 时会注入). 默认 []. */
+  bound_judgment_ids?: string[];
 }
 
 interface SessionSummary {
@@ -383,6 +385,67 @@ let sseClients: Set<SSEClient> = new Set();
 let channelSessions: Map<string, AgentSession> = new Map(); // key: channelId
 let sessionMessages: Map<string, any[]> = new Map(); // key: channelId + sessionId
 
+/**
+ * v3 重做: 构造 channel 的两路 judgment prompt 片段
+ *   路 1: 用户在盾牌里手动绑定的 judgment (channel.bound_judgment_ids)
+ *   路 2: 全局 judgment 列表 (供 LLM 在主调用中按需挑选, 写入回复)
+ * 返回 "" 表示完全没数据; 否则返回完整 "[系统上下文] ..." 块 (含尾部换行)
+ * 失败非致命 — 任何异常都返回空串, 保证 LLM 调用不被阻塞
+ */
+async function buildJudgmentHint(
+  channel: Channel | undefined | null,
+  channelIdForLog: string
+): Promise<string> {
+  try {
+    const { loadAllJudgments, initializeValueStore } = await import(
+      '../pi-ecosystem-judgment/human-value-store.js'
+    );
+    await initializeValueStore();
+    const allJudgments = await loadAllJudgments();
+    if (allJudgments.length === 0) return '';
+
+    const boundIds = new Set(
+      channel && Array.isArray(channel.bound_judgment_ids) ? channel.bound_judgment_ids : []
+    );
+    const bound = allJudgments.filter(j => j.id !== undefined && boundIds.has(j.id));
+    const others = allJudgments.filter(j => j.id !== undefined && !boundIds.has(j.id));
+
+    let hint = '';
+
+    // 路 1: 用户手动绑定的 judgment — 硬约束, 必须遵循
+    if (bound.length > 0) {
+      hint += `[系统上下文] 此 channel 用户绑定了 ${bound.length} 条判断力, 必须严格遵循:\n`;
+      for (const j of bound) {
+        const decision = (j.decision || '').toString().slice(0, 200);
+        const reasonList = Array.isArray(j.reasons) ? j.reasons : [];
+        const reasonText = reasonList.length > 0
+          ? ` (理由: ${reasonList.join('; ').slice(0, 100)})`
+          : '';
+        hint += `- ${decision}${reasonText}\n`;
+      }
+      hint += '\n';
+    }
+
+    // 路 2: 全局 judgment 候选池 — 软参考, LLM 自己挑
+    if (others.length > 0) {
+      hint += `[系统上下文] 候选判断力 (用户未明确绑定, 你可以按相关性自主选择参考):\n`;
+      for (const j of others) {
+        const decision = (j.decision || '').toString().slice(0, 120);
+        hint += `- [id=${j.id}] ${decision}\n`;
+      }
+      hint += `\n[系统上下文] 如果你的回复参考了某条候选判断力, 请在回复中自然提及 "我参考了你的判断: <decision 简述>" 即可, 无需复述 id.\n\n`;
+    }
+
+    console.log(
+      `[v3] channel ${channelIdForLog} 注入: 绑定 ${bound.length} 条, 候选 ${others.length} 条`
+    );
+    return hint;
+  } catch (err) {
+    console.error(`[v3] 加载判断力失败 (非致命):`, (err as Error).message);
+    return '';
+  }
+}
+
 async function getAgentForChannel(
   channelId: string,
   channelDid?: string,
@@ -640,6 +703,8 @@ export async function createWebServer(port: number = 3000, options: CreateWebSer
     // (line ~638) 与这里外层的 const channel 形成 shadowing 让 TS 误报"使用前未声明"
     const boundWalletAddress = channel?.walletAddress;
     const autoToolsEnabled = channel?.autoInvokeTools !== false; // 默认开启
+    // 捕获外层 channel 到独立变量, 避免被 try 块内 (line 740+) 的 const channel 遮蔽
+    const channelForJudgment = channel;
 
     try {
       const agent = await getAgentForChannel(channelId, realChannelDid, realChannelName, realChannelDidDoc);
@@ -675,6 +740,12 @@ export async function createWebServer(port: number = 3000, options: CreateWebSer
       } else {
         contextHint += `[系统上下文] 自动工具调用已关闭: 每次执行工具前必须先与用户确认。\n`;
       }
+
+      // v3: 注入 channel 绑定的判断力 (judgment_ids)
+      // 这是 v3 的核心 — channel 跑 LLM 时, 它的判断力 = 绑定的 judgment 列表
+      const judgmentHint = await buildJudgmentHint(channelForJudgment, channelId);
+      if (judgmentHint) contextHint += judgmentHint;
+
       if (contextHint) contextHint += '\n';
       fullResponse = await agent.promptStream(contextHint + text, streamCallback);
 
@@ -835,8 +906,8 @@ app.get('/channels', async (_req, res) => {
 
   app.post('/channels', async (req, res) => {
     try {
-      const { name, agentId, walletAddress, autoInvokeTools } = req.body;
-      console.log(`[创建频道] 收到请求: name=${name}, agentId=${agentId}, wallet=${walletAddress ? 'yes' : 'no'}`);
+      const { name, agentId, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
+      console.log(`[创建频道] 收到请求: name=${name}, agentId=${agentId}, wallet=${walletAddress ? 'yes' : 'no'}, boundJudgments=${Array.isArray(bound_judgment_ids) ? bound_judgment_ids.length : 0}`);
       if (!name || !agentId) {
         return res.status(400).json({ error: 'name and agentId required' });
       }
@@ -846,6 +917,11 @@ app.get('/channels', async (_req, res) => {
       // 校验钱包地址格式 (粗校验: 0x + 40 hex / Solana base58 / Sui 0x+64)
       const validWallet = isValidWalletAddress(walletAddress);
 
+      // 过滤 bound_judgment_ids: 只保留 string
+      const safeBoundIds = Array.isArray(bound_judgment_ids)
+        ? bound_judgment_ids.filter((x: unknown) => typeof x === 'string' && (x as string).length > 0)
+        : [];
+
       // 先创建频道（不阻塞等待 DID 生成）
       const channel: Channel = {
         id,
@@ -857,6 +933,7 @@ app.get('/channels', async (_req, res) => {
         walletAddress: validWallet || undefined,
         walletRegisteredAt: validWallet ? new Date().toISOString() : undefined,
         autoInvokeTools: autoInvokeTools !== false, // 默认 true
+        bound_judgment_ids: safeBoundIds,
         sessions: [{
           id: `sess_${Date.now()}`,
           createdAt: new Date().toISOString(),
@@ -1035,7 +1112,7 @@ app.get('/channels', async (_req, res) => {
   app.patch('/channels/:channelId', async (req, res) => {
     try {
       const { channelId } = req.params;
-      const { name, walletAddress, autoInvokeTools } = req.body;
+      const { name, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
       const channels = await loadChannels();
       const channel = channels.find(c => c.id === channelId);
       if (!channel) {
@@ -1061,6 +1138,19 @@ app.get('/channels', async (_req, res) => {
       if (typeof autoInvokeTools === 'boolean') {
         channel.autoInvokeTools = autoInvokeTools;
       }
+      // bound_judgment_ids: 允许数组(替换)/null(清空)/undefined(不改)
+      if (bound_judgment_ids !== undefined) {
+        if (bound_judgment_ids === null) {
+          channel.bound_judgment_ids = [];
+        } else if (Array.isArray(bound_judgment_ids)) {
+          channel.bound_judgment_ids = bound_judgment_ids.filter(
+            (x: unknown) => typeof x === 'string' && (x as string).length > 0
+          );
+        } else {
+          return res.status(400).json({ error: 'bound_judgment_ids must be array or null' });
+        }
+        console.log(`[Channel ${channelId}] 绑定判断力: ${channel.bound_judgment_ids.length} 条`);
+      }
       channel.updatedAt = new Date().toISOString();
       await saveChannels(channels);
       res.json(channel);
@@ -1225,8 +1315,9 @@ app.get('/channels', async (_req, res) => {
         }
       };
 
-      // 重新生成时只发送用户消息
-      fullResponse = await agent.promptStream(userMessage, streamCallback);
+      // 重新生成时只发送用户消息 (v3: 同时注入 channel 绑定的判断力)
+      const regenHint = await buildJudgmentHint(channel, channelId);
+      fullResponse = await agent.promptStream(regenHint + userMessage, streamCallback);
 
       broadcast({ type: 'ai', content: fullResponse }, channelId);
 
@@ -2451,7 +2542,8 @@ app.get('/channels', async (_req, res) => {
   try {
     const { createHealthMonitor, createWatchdog } = await import('../heartbeat/index.js');
     healthMonitor = createHealthMonitor();
-    watchdog = createWatchdog();
+    // 把 watchdog 静默阈值拉到 30 分钟, 避免开发期 / 用户空闲时被误杀
+    watchdog = createWatchdog({ silentThresholdMs: 30 * 60 * 1000 });
 
     console.log('[24h] Heartbeat modules loaded');
   } catch (err) {