fix: soften native websearch authenticity guidance

Author: hellowind777

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "hello2cc",
       "description": "Silent, native-first plugin for third-party models on Claude Code, with Claude-style tool, agent, task, team, and MCP routing.",
-      "version": "0.2.7",
+      "version": "0.2.8",
       "source": "./",
       "author": {
         "name": "hello2cc"

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "hello2cc",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Silent, native-first Claude Code plugin that steers third-party models toward Claude-style native tools, agents, tasks, teams, MCP workflows, and concise output.",
   "author": {
     "name": "hello2cc"

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.8 - 2026-04-02
+
+- Added softer native `WebSearch` guidance for real-time / latest-information questions so hello2cc encourages the host's built-in search path without pretending the plugin itself can create missing network capability
+- Added authenticity-focused proxy guidance: custom `ANTHROPIC_BASE_URL` sessions are still encouraged to try native `WebSearch`, but the model is reminded to treat `Did 0 searches`, missing links, or missing search hits as “not actually searched” instead of presenting memory as a real web result
+- Added regression coverage to keep this boundary stable: hello2cc should not hard-disable `WebSearch` just because a custom proxy is present, but it should keep result-truthfulness guidance intact
+
 ## 0.2.7 - 2026-04-02
 
 - Added a true `default_agent_model` option so users can define one native-safe default agent model preference without having to overuse per-agent overrides

README.md

@@ -6,7 +6,7 @@
 
 **当你已经把外部模型接进 Claude Code 后，让它更像原生 Claude Code 一样使用工具、Agent、计划、任务、MCP 和团队能力。**
 
-当前版本：`0.2.7`
+当前版本：`0.2.8`
 
 ---
 
@@ -66,6 +66,12 @@
 - 强迫你进入一套插件专属工作流
 - 覆盖高优先级的 `CLAUDE.md` / `AGENTS.md` / 项目规则 / 用户明确要求
 
+对于 `WebSearch` 也是同样的边界：
+
+- 不会因为你用了自定义代理 / gateway 就直接替你禁用 `WebSearch`
+- 不会替宿主凭空创造本来不存在的联网能力
+- 只会尽量提醒模型：**只有拿到真实搜索条目 / 来源时，才把结果当成已经联网搜索**
+
 它追求的是：
 
 **静默增强原生感，而不是接管 Claude Code。**
@@ -329,6 +335,18 @@ claude plugin install hello2cc@hello2cc-local
 
 只要更高优先级规则已经定义了格式、流程、命令路由或输出习惯，hello2cc 会尽量让位。
 
+### 如果我后面用 helloswitch 增强代理，让第三方模型真正支持 Claude Code 的 WebSearch / tools，会不会和 hello2cc 冲突？
+
+不会。
+
+`hello2cc` 不会因为你使用了代理就硬禁用 `WebSearch` 或普通工具调用。  
+它做的是更轻的“真实性保护”：
+
+- 如果真实拿到了搜索条目 / 来源，就正常按联网结果组织回答
+- 如果界面出现 `Did 0 searches`、没有来源、没有真实搜索结果，就不要把记忆包装成“已经搜过”
+
+所以如果你的代理后续真的被增强到能正确支持 Claude Code 的工具协议，`hello2cc` 不会挡住这条路径。
+
 ---
 
 ## 本地验证

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hello2cc",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "type": "module",
   "description": "Silent, native-first Claude Code plugin that steers third-party models toward Claude-style tools, agents, tasks, teams, MCP workflows, and concise native output.",
   "license": "Apache-2.0",

scripts/lib/api-topology.mjs

@@ -0,0 +1,62 @@
+import { envValue } from './config.mjs';
+
+function envTruthy(name) {
+  return ['1', 'true', 'yes', 'on'].includes(envValue(name).toLowerCase());
+}
+
+export function getApiProvider() {
+  if (envTruthy('CLAUDE_CODE_USE_BEDROCK')) return 'bedrock';
+  if (envTruthy('CLAUDE_CODE_USE_VERTEX')) return 'vertex';
+  if (envTruthy('CLAUDE_CODE_USE_FOUNDRY')) return 'foundry';
+  return 'firstParty';
+}
+
+export function isFirstPartyAnthropicBaseUrl() {
+  const baseUrl = envValue('ANTHROPIC_BASE_URL');
+  if (!baseUrl) return true;
+
+  try {
+    const host = new URL(baseUrl).host;
+    const allowedHosts = ['api.anthropic.com'];
+
+    if (envValue('USER_TYPE') === 'ant') {
+      allowedHosts.push('api-staging.anthropic.com');
+    }
+
+    return allowedHosts.includes(host);
+  } catch {
+    return false;
+  }
+}
+
+export function usesCustomAnthropicProxy() {
+  return getApiProvider() === 'firstParty' && !isFirstPartyAnthropicBaseUrl();
+}
+
+export function hasObservedTools(sessionContext = {}) {
+  return Array.isArray(sessionContext?.toolNames) && sessionContext.toolNames.length > 0;
+}
+
+export function resolveWebSearchGuidanceMode(sessionContext = {}) {
+  const observedTools = hasObservedTools(sessionContext);
+  const webSearchAvailable = Boolean(sessionContext?.webSearchAvailable);
+  const customAnthropicProxy = usesCustomAnthropicProxy();
+
+  if (webSearchAvailable && customAnthropicProxy) {
+    return 'proxy-conditional';
+  }
+
+  if (webSearchAvailable) {
+    return 'available';
+  }
+
+  if (observedTools) {
+    return 'not-exposed';
+  }
+
+  if (customAnthropicProxy) {
+    return 'proxy-unknown';
+  }
+
+  return 'generic';
+}

scripts/lib/prompt-signals.mjs

@@ -72,6 +72,29 @@ const RESEARCH_PATTERNS = [
   /支持/,
 ];
 
+const CURRENT_INFO_PATTERNS = [
+  /\b(latest|recent|recently|current|today|tonight|this week|this month|breaking)\b/,
+  /\b(news|headline|headlines|weather|forecast|price|pricing|stock|stocks|score|scores|release notes|changelog)\b/,
+  /最新/,
+  /最近/,
+  /近期/,
+  /当前/,
+  /今天/,
+  /今晚/,
+  /本周/,
+  /本月/,
+  /实时/,
+  /新闻/,
+  /头条/,
+  /天气/,
+  /价格/,
+  /股价/,
+  /比分/,
+  /汇率/,
+  /更新日志/,
+  /发布动态/,
+];
+
 const SWARM_PATTERNS = [
   /parallel/,
   /in parallel/,
@@ -352,6 +375,7 @@ export function isSubagentPrompt(prompt) {
 export function classifyPrompt(prompt) {
   const text = normalizePrompt(prompt);
   const research = hasAny(text, RESEARCH_PATTERNS);
+  const currentInfo = hasAny(text, CURRENT_INFO_PATTERNS);
   const explicitHostFeature = hasAny(text, HOST_FEATURE_PATTERNS);
   const claudeGuide = hasQuestionIntent(text) && hasAny(text, GUIDE_PATTERNS);
   const implement = hasAny(text, IMPLEMENT_PATTERNS);
@@ -394,6 +418,7 @@ export function classifyPrompt(prompt) {
   return {
     diagram: hasAny(text, DIAGRAM_PATTERNS),
     research,
+    currentInfo,
     swarm,
     teamWorkflow,
     verify,

scripts/lib/route-guidance.mjs

@@ -1,4 +1,5 @@
 import { configuredModels } from './config.mjs';
+import { resolveWebSearchGuidanceMode } from './api-topology.mjs';
 
 function buildTaskPlanningStep() {
   return '这是非 trivial 实现：先 `EnterPlanMode()`；只有真的需要任务盘时再用 `TaskCreate` / `TaskList` / `TaskUpdate`。';
@@ -55,6 +56,28 @@ function buildResearchStep(signals) {
   return '这是研究 / 对比 / 文档任务：先做定向搜索与证据收集，再在需要扩大搜索面时转原生 `Explore` 或 `Plan`。';
 }
 
+function buildCurrentInfoStep(signals, sessionContext = {}) {
+  if (!signals.currentInfo) {
+    return '';
+  }
+
+  const mode = resolveWebSearchGuidanceMode(sessionContext);
+
+  if (mode === 'available') {
+    return '这是最新/实时信息任务：优先原生 `WebSearch` 获取当下来源，再组织答案；不要只凭记忆回答这类问题。';
+  }
+
+  if (mode === 'proxy-conditional') {
+    return '这是最新/实时信息任务：优先尝试原生 `WebSearch`；只有当它真实返回搜索条目或来源链接时，才按联网结果回答。若界面出现 `Did 0 searches`、无来源或无搜索结果，必须明确说明未完成真实搜索。';
+  }
+
+  if (mode === 'not-exposed') {
+    return '这是最新/实时信息任务：当前未显式看到原生 `WebSearch`；不要把记忆包装成最新联网信息，必要时先说明当前边界。';
+  }
+
+  return '这是最新/实时信息任务：若宿主暴露原生 `WebSearch`，优先用它获取实时来源；如果没有真实搜索结果或来源，就明确说明边界，不要假装已经联网。';
+}
+
 export function buildRouteStepsFromSignals(signals, sessionContext = {}) {
   const config = configuredModels(sessionContext);
   const steps = [];
@@ -74,6 +97,11 @@ export function buildRouteStepsFromSignals(signals, sessionContext = {}) {
     steps.push(researchStep);
   }
 
+  const currentInfoStep = buildCurrentInfoStep(signals, sessionContext);
+  if (currentInfoStep) {
+    steps.push(currentInfoStep);
+  }
+
   if (signals.boundedImplementation) {
     steps.push('这是边界清晰的实现 / 修复 / 验证子任务：优先使用原生 `Agent` 的 `General-Purpose` 承接单一切片，而不是把探索、规划和实现都混在主线程。');
   }

scripts/lib/session-guidance.mjs

@@ -1,4 +1,5 @@
 import { FORCED_OUTPUT_STYLE_NAME, configuredModels } from './config.mjs';
+import { resolveWebSearchGuidanceMode } from './api-topology.mjs';
 
 function formatNames(values) {
   return values.map((value) => `\`${value}\``).join(', ');
@@ -86,6 +87,52 @@ function buildToolSearchLines() {
   ];
 }
 
+function buildWebSearchLines(sessionContext = {}) {
+  const mode = resolveWebSearchGuidanceMode(sessionContext);
+
+  if (mode === 'available') {
+    return [
+      '## 实时信息与 WebSearch',
+      '- 当前会话已暴露原生 `WebSearch`；遇到最新/今天/新闻/价格/天气/发布动态等问题时，优先先拿到实时来源，再组织回答。',
+      '- 如果 `WebSearch` 没有给出真实来源或搜索条目，就不要把记忆包装成联网结果。',
+      '- `WebSearch` 只负责实时来源；代码执行、文件读写、MCP 与 agent 协作仍优先走各自原生工具。',
+    ];
+  }
+
+  if (mode === 'proxy-conditional') {
+    return [
+      '## 实时信息与 WebSearch',
+      '- 当前会话已暴露原生 `WebSearch`，但链路看起来是自定义 `ANTHROPIC_BASE_URL` 代理；有些代理会转发真实搜索，有些不会。',
+      '- 仍然优先尝试原生 `WebSearch`；hello2cc 不会因为使用自定义代理就直接阻断这条路径。',
+      '- 只有当 `WebSearch` 真正返回搜索条目或来源链接时，才把它当成联网成功；如果界面出现 `Did 0 searches`、无来源或无搜索结果，必须明确说明未完成真实搜索。',
+      '- `WebSearch` 只负责实时来源；代码执行、文件读写、MCP 与 agent 协作仍优先走各自原生工具。',
+    ];
+  }
+
+  if (mode === 'not-exposed') {
+    return [
+      '## 实时信息与 WebSearch',
+      '- 当前会话未显式暴露原生 `WebSearch`；不要声称自己已经联网搜索了最新信息。',
+      '- 如果用户要求最新/实时信息，优先查找宿主真实暴露的联网工具；没有就明确说明边界。',
+    ];
+  }
+
+  if (mode === 'proxy-unknown') {
+    return [
+      '## 实时信息与 WebSearch',
+      '- 当前链路看起来是自定义 `ANTHROPIC_BASE_URL` 代理；若宿主暴露原生 `WebSearch`，优先用它获取实时来源。',
+      '- hello2cc 不会因为你使用代理就自动禁用 `WebSearch`；它只要求在没有真实搜索结果时诚实表达边界。',
+      '- 只有拿到真实搜索条目或来源链接时，才按联网结果回答；否则必须明确说明边界，不要把记忆当成实时搜索。',
+    ];
+  }
+
+  return [
+    '## 实时信息与 WebSearch',
+    '- 遇到最新/实时信息任务时，若宿主暴露原生 `WebSearch`，优先用它获取来源；不要只凭记忆回答这类问题。',
+    '- 如果没有真实搜索条目或来源，就明确说明当前边界，不要假装已经联网。',
+  ];
+}
+
 export function buildSessionStartContext(sessionContext = {}) {
   return [
     '# hello2cc',
@@ -104,6 +151,8 @@ export function buildSessionStartContext(sessionContext = {}) {
     '',
     ...buildToolSearchLines(),
     '',
+    ...buildWebSearchLines(sessionContext),
+    '',
     '## 输出风格',
     `- 当前插件输出风格：\`${FORCED_OUTPUT_STYLE_NAME}\`。`,
     '- 如果更高优先级规则没有指定格式，保持 Claude Code 原生、简洁、结果导向的表达。',

tests/orchestrator.test.mjs

@@ -152,6 +152,37 @@ test('session-start surfaces advanced native capabilities when the host exposes
   assert.match(context, /PowerShell/);
 });
 
+test('session-start explains how to use native WebSearch for real-time questions', () => {
+  const env = isolatedEnv();
+  const output = run('session-start', {
+    session_id: 'session-websearch',
+    model: 'opus',
+    tools: ['WebSearch'],
+  }, env);
+  const context = output.hookSpecificOutput.additionalContext;
+
+  assert.match(context, /实时信息与 WebSearch/);
+  assert.match(context, /已暴露原生 `WebSearch`/);
+  assert.match(context, /不要把记忆包装成联网结果/);
+});
+
+test('session-start keeps WebSearch guidance honest on proxy-like sessions', () => {
+  const env = isolatedEnv({
+    ANTHROPIC_BASE_URL: 'https://proxy.example.com/v1',
+  });
+  const output = run('session-start', {
+    session_id: 'session-websearch-proxy',
+    model: 'opus',
+    tools: ['WebSearch'],
+  }, env);
+  const context = output.hookSpecificOutput.additionalContext;
+
+  assert.match(context, /自定义 `ANTHROPIC_BASE_URL` 代理/);
+  assert.match(context, /不会因为使用自定义代理就直接阻断这条路径/);
+  assert.match(context, /Did 0 searches/);
+  assert.match(context, /未完成真实搜索/);
+});
+
 test('route promotes native guide flow without skill references', () => {
   const env = isolatedEnv();
   run('session-start', {
@@ -257,6 +288,35 @@ test('route prefers MCP resource tools', () => {
   assert.match(context, /ReadMcpResource/);
 });
 
+test('route prefers native WebSearch for real-time questions when the host exposes it', () => {
+  const env = isolatedEnv();
+  const output = run('route', {
+    session_id: 'route-websearch',
+    tools: ['WebSearch'],
+    prompt: '帮我查一下 OpenAI Codex 最近的新闻',
+  }, env);
+  const context = output.hookSpecificOutput.additionalContext;
+
+  assert.match(context, /最新\/实时信息任务/);
+  assert.match(context, /优先原生 `WebSearch`/);
+});
+
+test('route keeps proxy WebSearch guidance focused on authenticity rather than blocking', () => {
+  const env = isolatedEnv({
+    ANTHROPIC_BASE_URL: 'https://proxy.example.com/v1',
+  });
+  const output = run('route', {
+    session_id: 'route-websearch-proxy',
+    tools: ['WebSearch'],
+    prompt: '帮我查下今天 AI 新闻',
+  }, env);
+  const context = output.hookSpecificOutput.additionalContext;
+
+  assert.match(context, /优先尝试原生 `WebSearch`/);
+  assert.match(context, /Did 0 searches/);
+  assert.match(context, /未完成真实搜索/);
+});
+
 test('route keeps ToolSearch-first intent optimistic on proxy sessions without host proof either way', () => {
   const env = isolatedEnv({
     ANTHROPIC_BASE_URL: 'https://proxy.example.com/v1',