argo-search 2.9.7 → 2.9.9

package/sub-skills/local-seek/scripts/seek_rank.py

@@ -82,6 +82,7 @@ _TOPIC_PRIOR_WEIGHT = 1.2
 # 量级与一个中频词元命中相当，够翻二元组的歧义、翻不了多词全覆盖行。
 _PHRASE_BONUS = 3.0
 _PHRASE_BONUS_CAP = 6.0
+_NAME_PHRASE_BONUS = 4.0  # 文件名直接命中查询短语时的定位加成
 
 
 def _split_camel(run: str) -> list[str]:
@@ -178,9 +179,12 @@ def rank_rows(rows: list[tuple[str, int, str]], raw_query: str,
                 total += w * qtf * (sat + _DELTA) * idf
         total += _TOPIC_PRIOR_WEIGHT * math.log1p(file_hits[rows[i][0]])
         if phrases:
-            low = (rows[i][2] or "").lower()
-            hits = sum(1 for ph in phrases if ph in low)
-            total += min(hits, 2) * _PHRASE_BONUS
+            low_line = (rows[i][2] or "").lower()
+            fp_low = (rows[i][0] or "").lower()
+            name_low = fp_low.rpartition("/")[2] or fp_low
+            name_hits = sum(1 for ph in phrases if ph in name_low)
+            line_hits = sum(1 for ph in phrases if ph in low_line)
+            total += min(name_hits, 2) * _NAME_PHRASE_BONUS + min(line_hits, 2) * _PHRASE_BONUS
         if boost_fn is not None:
             try:
                 total += boost_fn(rows[i][0])

package/sub-skills/ego-search/references/browser-runtime.md

@@ -1,43 +0,0 @@
-# ego-search 浏览器运行时参考（低频：复杂交互才需要）
-
-
-## 直接浏览器操作
-
-复杂交互路径用浏览器运行时命令 `ego-browser nodejs` heredoc 直接编排（本子技能继承完整
-运行时）。核心纪律：
-
-```bash
-ego-browser nodejs <<'EOF'
-// 同名任务空间跨轮次复用；同一用户目标不新建空间
-const task = await useOrCreateTaskSpace('竞品调研')
-await openOrReuseTab('https://example.com', { wait: true, timeout: 20 })
-cliLog(await snapshotText())   // 语义快照，带 [ref=N, loc=..., url=...]
-EOF
-```
-
-**Helpers 速查**：
-
-- 任务空间：`useOrCreateTaskSpace` / `listTaskSpaces` / `claimTaskSpace` / `handOffTaskSpace` / `takeOverTaskSpace` / `completeTaskSpace`
-- 导航：`openOrReuseTab` / `gotoAndWait` / `pageInfo` / `listTabs` / `switchTab`
-- 观察：`snapshotText` / `captureScreenshot` / `drainEvents`
-- 动作：`click` / `fillInput` / `typeText` / `pressKey` / `scrollToBottomUntil` / `hover` / `uploadFile`
-- 等待：`wait` / `waitForElement` / `waitForNetworkIdle`
-- 提取：`js`（页面内 JS）/ `cdp`（浏览器协议）
-- 输出：`cliLog`（唯一输出通道；`-e` 模式下输出到 stderr）
-
-**关键纪律**：
-
-1. **任务空间隔离 + 登录态继承**：Agent 在独立空间操作，不抢用户标签页；登录态默认继承，可访问已登录站点。
-2. **跨轮次复用**：Node 运行时每次 heredoc 退出即释放，后续轮次用 `useOrCreateTaskSpace(同名)` 或
-   `takeOverTaskSpace`（用户确认继续后）恢复。
-3. **归属权**：用户接管空间时（"user is controlling"）是硬停——问用户并等待，不重试不抢回；
-   `handOffTaskSpace` 交还用户后，只有用户明确确认（Ask 的 Continue）才 `takeOverTaskSpace`。
-4. **收尾**：任务完成必须 `completeTaskSpace(name, { keep: false })` 关掉空间；
-   仅当用户明确要求保留页面/需人工操作/结果无法用 URL 交付时才 `{ keep: true }`。
-5. **`js()` 用法**：页面内逻辑包成单个 IIFE 一次返回；`js()` 返回求值结果而非 JSON 字符串，
-   不要包 `JSON.parse`；模板字符串里正则反斜杠要双写或 `String.raw`。
-6. **输出通道**：heredoc 模式 `cliLog` 输出到 stdout；`ego-browser nodejs -e "..."` 模式输出到 **stderr**。
-
-**三种工作流**：普通 DOM 页用语义流（`snapshotText` + `@N`/`loc=` 引用）；canvas/富编辑器
-（Google Docs/Notion/Figma 等）用视觉流（截图 + 坐标 + 键盘）；需要浏览器态/紧凑数据提取用
-直接 DOM/CDP 流（`js`/`cdp`）。

package/sub-skills/ego-search/references/install.md

@@ -1,67 +0,0 @@
-# Install ego lite
-
-Read this file only when ego lite isn't installed yet, or when the user asks to install ego lite. For day-to-day browser work, go back to `SKILL.md`.
-
-The ego-browser skill depends on the ego lite browser: the `ego-browser` command is provided by the ego lite app. Once ego lite is installed and you've gone through onboarding once, the environment is ready and there are no further environment issues.
-
-ego lite website: https://lite.ego.app/
-
-## Install steps (macOS only)
-
-The install script lives at `scripts/install.sh` in this skill and supports macOS only. It will:
-
-- Download the ego lite installer (a DMG) for your CPU architecture (arm64 / x64).
-- Install `ego lite.app` to `/Applications` (falling back to `~/Applications` when needed).
-- Strip the quarantine attribute to keep Gatekeeper from blocking the first launch.
-- After installing, launch the `ego lite` app.
-
-Run the script (use the script's actual path under this skill's directory):
-
-```bash
-sh skills/ego-browser/scripts/install.sh
-```
-
-After installing, the script opens the ego lite app directly. If ego lite is already installed, the script skips the download and opens the app directly.
-
-After the script opens the ego lite app, the user completes the first-run onboarding in the app:
-
-- Choose to import data from Chrome or another browser as needed.
-- Onboarding registers the `ego-browser` command on the PATH (usually under `~/.local/bin`).
-
-Onboarding is a step the user completes in the GUI. After the script opens ego lite, wait for the user to confirm they've finished onboarding before continuing.
-
-## After installing: confirm `ego-browser` is available
-
-Once the user has finished onboarding, confirm the command is ready:
-
-```bash
-command -v ego-browser
-```
-
-If it reports that the command isn't found, `~/.local/bin` is most likely not on the current PATH. Fix it temporarily and retry:
-
-```bash
-export PATH="$HOME/.local/bin:$PATH"
-command -v ego-browser
-```
-
-Once the command exists, verify the runtime with a minimal heredoc:
-
-```bash
-ego-browser nodejs <<'EOF'
-cliLog('ego-browser ready')
-EOF
-```
-
-Printing `ego-browser ready` means the environment is ready.
-
-## After that, return to the original task
-
-Once the environment is ready, return to the user's original task and continue with the task space flow in `SKILL.md` — start from `useOrCreateTaskSpace(name)` and proceed as usual.
-
-## Troubleshooting
-
-- **Not macOS**: the script supports macOS only (`uname -s` is `Darwin`). On other platforms, have the user download and install from the ego lite website at https://lite.ego.app/.
-- **Download failed**: the script retries 3 times automatically; if it still fails, it's usually a network issue — have the user check their network and retry.
-- **Gatekeeper still blocks it**: the script already tries to strip quarantine; if the first launch is still blocked, have the user allow ego lite manually under System Settings → Privacy & Security.
-- **Command still unavailable after onboarding**: confirm `~/.local/bin` is on the PATH (see above); or have the user reopen ego lite, finish onboarding, and retry.

package/sub-skills/ego-search/references/original-ego-upgrade.md

@@ -1,51 +0,0 @@
-# 原版 ego 技能升级要点（与本子技能配套）
-
-原版 `ego-browser` skill 仍是**通用浏览器自动化**真源；本文件只补「与登录态专业搜索完全态」对齐的用法，不替换原版 SKILL 正文。
-
-## 与 ego-search 分工
-
-| 场景 | 用谁 |
-|------|------|
-| 搜 SERP / 抓正文 / 已知 API / 登录墙取证 | **ego-search**（双运行时 auto） |
-| 复杂点选、填表、多步、截图工作流 | **原版 ego-browser** heredoc |
-| 无 ego App、只有用户 Chrome | **ego-search --runtime webbridge** |
-
-## 建议启用但常被忽略的能力
-
-在 `ego-browser nodejs` 中（打开目标站后）：
-
-```js
-// 站点经验包（若该站有 learnings）
-const ctx = await learnContext()
-cliLog(JSON.stringify(ctx))
-// 例如 google 搜索抽取（以实际 manifest 为准）
-// await runSiteTool('google', 'search_and_extract', { query: '...' })
-```
-
-站点包通常在应用内 `learnings/`（google / x-com / github 等）。
-
-## 输出建议（与隔离/融合对齐）
-
-原版 heredoc 若产出可并入分析的结果，请在 `cliLog` 的 JSON 中尽量带：
-
-```json
-{
-  "login_state_used": true,
-  "auth_partition": "login",
-  "cache_eligible": false,
-  "search_partition": "login",
-  "merge_with_public_ok": true,
-  "runtime": "ego",
-  "source": "ego-browser"
-}
-```
-
-勿把登录态 body 写入 argo 公共 `SearchCache`。
-
-## 探测
-
-```bash
-python3 sub-skills/ego-search/scripts/ego_search.py status
-```
-
-`runtimes.preferred` / `login_search_ready` 表示登录态专业搜索是否可跑。

package/sub-skills/ego-search/tests/test_query_normalize.py

@@ -1,68 +0,0 @@
-#!/usr/bin/env python3
-"""ego-search query 归一化前处理单测（保持一致 argo 核心 query_enhance）
-
-设计约束：
-  - 只做词形规范化（全角→半角、拆斜杠、压空格）
-  - 必须保留平台结构化语法（from:/site:/filter: …）——ego 是站内通道，剥语法会丢能力
-  - 核心 query_enhance 不可用时降级为原 query（不破坏）
-
-运行：
-  cd ~/.agents/skills/argo
-  python3 -m pytest sub-skills/ego-search/tests/test_query_normalize.py -q
-"""
-
-from __future__ import annotations
-
-import sys
-import unittest
-from pathlib import Path
-
-SCRIPTS = Path(__file__).resolve().parent.parent / "scripts"
-sys.path.insert(0, str(SCRIPTS))
-
-import ego_search as es  # noqa: E402
-
-
-class TestQueryNormalize(unittest.TestCase):
-    def test_full_width_to_half(self):
-        self.assertEqual(es._normalized_query("“GPT-5”，价格"), '"GPT-5",价格')
-
-    def test_slash_split(self):
-        self.assertEqual(es._normalized_query("LongCat-2.0/1.6 万亿"), "LongCat-2.0 1.6 万亿")
-
-    def test_keep_platform_syntax(self):
-        self.assertEqual(
-            es._normalized_query('from:OpenAI "GPT-5" filter:images'),
-            'from:OpenAI "GPT-5" filter:images',
-        )
-
-    def test_plain_unchanged(self):
-        self.assertEqual(es._normalized_query("openai api"), "openai api")
-
-    def test_plain_slash_not_split(self):
-        # 核心规则：只拆「点号版本」斜杠（LongCat-2.0/1.6），普通斜杠可能是
-        # 路径/日期/分数，必须原样保留。本测试曾检查 "a/b c" → "a b c"，
-        # 是旧实现（全斜杠拆分）的遗留，与核心 normalize_query 矛盾，
-        # 且子技能测试不在主检查收集范围，红了一年没人看见。
-        self.assertEqual(es._normalized_query("a/b c"), "a/b c")
-
-    def test_import_fallback(self):
-        # normalize_query 缺失时应回退原 query（真正模拟核心不可用）
-        orig = es.normalize_query
-        try:
-            es.normalize_query = None
-            self.assertEqual(es._normalized_query("a/b c"), "a/b c")
-            self.assertEqual(es._normalized_query("LongCat-2.0/1.6"), "LongCat-2.0/1.6")
-        finally:
-            es.normalize_query = orig
-
-    def test_core_scripts_path_is_argo_root(self):
-        # 回归锚：相对路径必须指向 argo 根/scripts（parents[3]）。
-        # 曾用 parents[2] 指向 sub-skills/scripts（不存在）→ normalize_query
-        # 静默降级为 None，子技能归一化整条失效。
-        self.assertTrue(es._CORE_SCRIPTS.exists(), es._CORE_SCRIPTS)
-        self.assertEqual(es._CORE_SCRIPTS.name, "scripts")
-
-
-if __name__ == "__main__":
-    unittest.main()

package/sub-skills/js-run/tests/fixtures/challenge_like.js

@@ -1,27 +0,0 @@
-// challenge_like.js — 金标考卷 #1：挑战页形态的 JS（离线可复跑）
-// 形态参照真实反爬挑战脚本的三段式：环境探测 → 字符串运算 → 发通行证。
-// 只用 v0 垫片保证过的面：navigator/screen/btoa/document.cookie/定时器。
-(function () {
-  var probe = [
-    navigator.userAgent.length,
-    navigator.platform,
-    navigator.language,
-    screen.width * screen.height,
-    navigator.hardwareConcurrency,
-    Number(!navigator.webdriver),
-  ].join("|");
-
-  // 字符串运算（模拟混淆层的算子链）
-  var salt = "";
-  for (var i = 0; i < probe.length; i += 7) salt += String.fromCharCode(probe.charCodeAt(i) ^ 0x1f);
-  var token = btoa(salt + "|" + probe.length);
-
-  // 定时器：真浏览器里等 3 秒才发 cookie；逻辑时间下瞬间完成
-  var issued = false;
-  setTimeout(function () {
-    document.cookie = "__jsl_clearance=" + token + "; path=/";
-    issued = true;
-  }, 3000);
-
-  return { probe: probe, token: token, issued: issued };
-})();

package/sub-skills/js-run/tests/test_jsrun.py

@@ -1,165 +0,0 @@
-#!/usr/bin/env python3
-"""jsrun 最小核测试（金标考卷驱动）。
-
-直接运行：python3 tests/test_jsrun.py（也可 pytest 收集）。
-依赖：mini-racer（pip install mini-racer）。
-"""
-from __future__ import annotations
-
-import importlib.util
-import sys
-import time
-from pathlib import Path
-
-import pytest
-
-# mini-racer 是 js-run 的可选依赖（V8 沙箱）。没装的机器上这 10 条用例会
-# 全部 RuntimeError，把主套件染红——而缺依赖本应是 skip，不是失败
-# （2026-10-18 实测：主套件 4236 passed / 4 failed，其中 1 条就是这里）。
-# 用模块级 pytestmark 而不是 importorskip：后者会让收集数为 0，旧版 pytest
-# 返回 rc=5（no tests collected），外层 sub-skills 套件门照样红。
-pytestmark = pytest.mark.skipif(
-    importlib.util.find_spec("py_mini_racer") is None,
-    reason="js-run 可选依赖 mini-racer 未安装",
-)
-
-HERE = Path(__file__).parent
-sys.path.insert(0, str(HERE.parent / "scripts"))
-
-from jsrun import JsRun  # noqa: E402
-
-CHALLENGE = (HERE / "fixtures" / "challenge_like.js").read_text(encoding="utf-8")
-
-
-def test_env_probe():
-    with JsRun() as jr:
-        out = jr.run("({ua: navigator.userAgent, p: navigator.platform, wd: navigator.webdriver})")
-        assert out["ua"].startswith("Mozilla/5.0"), out
-        assert out["p"] == "Win32"
-        assert out["wd"] is False
-
-
-def test_challenge_token_and_cookie():
-    with JsRun() as jr:
-        out = jr.run(CHALLENGE)
-        assert out["token"], out
-        assert out["issued"] is False, "advance 前定时器不该触发"
-        jr.advance(3000)
-        assert jr.run("issued_global_check()") if False else True
-        cookie = jr.get_cookie()
-        assert cookie.startswith("__jsl_clearance="), cookie
-        assert out["token"] in cookie
-
-
-def test_initial_state_extraction():
-    # 数据埋在 JS 里的提取场景：window.__INITIAL_STATE__ 直取
-    with JsRun() as jr:
-        jr.run("window.__INITIAL_STATE__ = {list: [1,2,3], meta: {title: 'js 数据'}}")
-        out = jr.run("window.__INITIAL_STATE__")
-        assert out == {"list": [1, 2, 3], "meta": {"title": "js 数据"}}
-
-
-def test_logical_timer_instant():
-    with JsRun() as jr:
-        jr.run("var x = 0; setTimeout(function(){ x = 42; }, 5000);")
-        assert jr.run("x") == 0
-        fired = jr.advance(5000)
-        assert fired == 1
-        assert jr.run("x") == 42
-
-
-def test_entropy_differs_across_contexts():
-    with JsRun() as a, JsRun() as b:
-        va = a.run("Array.from(crypto.getRandomValues(new Uint8Array(8)))")
-        vb = b.run("Array.from(crypto.getRandomValues(new Uint8Array(8)))")
-        assert va != vb, "不同上下文的熵应不同"
-        assert len(va) == 8 and all(isinstance(x, int) and 0 <= x <= 255 for x in va)
-
-
-def test_environment_override():
-    with JsRun(environment={"navigator": {"userAgent": "TestUA/1.0"}}) as jr:
-        assert jr.run("navigator.userAgent") == "TestUA/1.0"
-        assert jr.run("navigator.platform") == "Win32"  # 未覆盖字段保持默认
-
-
-def test_speed_budget():
-    # 量化门：上下文创建 + 环境垫片 + 一次求值 < 100ms（iv8 实测 18ms 为基线）
-    t0 = time.perf_counter()
-    with JsRun() as jr:
-        jr.run("navigator.userAgent")
-    dt_ms = (time.perf_counter() - t0) * 1000
-    assert dt_ms < 100, f"冷启动 {dt_ms:.1f}ms 超预算"
-
-
-def test_atob_rejects_invalid_chars():
-    # 非法 base64 字符应报错，不静默映射
-    with JsRun() as jr:
-        try:
-            jr.run('atob("!!invalid!!")')
-            assert False, "应抛异常"
-        except (RuntimeError, Exception):
-            pass  # 预期行为
-        # 合法 base64 正常
-        out = jr.run('atob("aGVsbG8=")')
-        assert out == "hello", out
-
-
-def test_run_timeout():
-    # 死循环脚本应超时
-    with JsRun() as jr:
-        try:
-            jr.run('while(true){}', timeout_ms=500)
-            assert False, "应超时"
-        except TimeoutError:
-            pass  # 预期行为
-
-
-def test_close_releases():
-    # close 后上下文应不可用
-    jr = JsRun()
-    jr.close()
-    try:
-        jr.run('1+1')
-        assert False, "close 后应不可用"
-    except (AttributeError, RuntimeError, Exception):
-        pass  # 预期行为
-
-
-def test_run_in_worker_thread():
-    # 回归：此前用 signal.SIGALRM，在工作线程（crawl/research/mcp_server）
-    # 必抛 ValueError: signal only works in main thread
-    import threading
-
-    out_box: dict = {}
-
-    def _worker():
-        try:
-            with JsRun() as jr:
-                out_box["val"] = jr.run("navigator.platform + ':' + (20 + 22)")
-                try:
-                    jr.run("while(true){}", timeout_ms=200)
-                    out_box["timeout_ok"] = False
-                except TimeoutError:
-                    out_box["timeout_ok"] = True
-        except BaseException as e:
-            out_box["err"] = e
-
-    t = threading.Thread(target=_worker)
-    t.start()
-    t.join(timeout=5)
-    assert "err" not in out_box, f"工作线程执行失败: {out_box.get('err')!r}"
-    assert out_box.get("val") == "Win32:42"
-    assert out_box.get("timeout_ok") is True
-
-
-if __name__ == "__main__":
-    fails = 0
-    for name, fn in sorted(globals().items()):
-        if name.startswith("test_") and callable(fn):
-            try:
-                fn()
-                print(f"PASS {name}")
-            except AssertionError as e:
-                fails += 1
-                print(f"FAIL {name}: {e}")
-    sys.exit(1 if fails else 0)

package/sub-skills/local-seek/references/auto-behaviors.md

@@ -1,24 +0,0 @@
-# seek.py 自动行为明细（按需读取）
-
-这些行为全部自动生效，无需手动指定；排障或想理解「为什么这么搜」时再读。
-从 SKILL.md 挪入（v1.6.0，触发即注入预算 7KB 的口径）。
-
-- **固定字符串**：查询是纯字面量时自动用 rg -F；含 regex 元字符但解析失败
-  （如 interface{}）自动回退 -F。
-- **中文扩展**：中文查询先按原词精确匹配，没命中再拆成 2 字词（2-gram）放宽
-  （如「数据抓取」放宽到「数据」「抓取」），这样能多搜到一些；--exact 关闭。
-- **PCRE2 检测**：查询含 look-around 时检查本机 rg 是否支持，不支持给出
-  明确提示而非报错。
-- **结构搜索**：--structural 按语义检索代码模式（裸 except、空 catch、
-  装饰函数、函数/类定义），中英文别名都认，零安装（rg -U 多行实现）。
-- **Git 联动**：--git-log / --git-blame 直接回答「这行谁改的、最近动过什么」，
-  文件不在仓库或未跟踪时给出明确区分，不报错。
-- **BM25F 内容重排**：文件名 2.0 / 目录 0.6 / 行文本 1.0 三字段，BM25+ 下界 +
-  逐字短语加成 + 文件级命中数先验；池子按文件轮转配额（每文件 ≤8 行）。
-  `ARGO_SEEK_CONTENT_RERANK=0` 关闭。
-- **fzf V2 文件名评分**：驼峰/边界/gap 惩罚，DP 最优对齐（junegunn/fzf 口径）。
-- **FTS5 索引快路**：`ARGO_LOCAL_FTS=1` 后，无正则元字符的内容查询走
-  SQLite FTS5 倒排索引（unicode61 + CJK 逐字短语），只在索引过期（TTL 120s）
-  时付一次增量刷新（rg --files 清单 + 改动文件重读，预算 1.5s）。rg 永远
-  兜底：索引未建成/查询带正则/零命中语义见 seek_fts.py docstring。大树首次
-  建索引较慢，先跑 `python3 scripts/seek_fts.py rebuild <目录>` 预热。

package/sub-skills/local-seek/references/fd-mdfind-recipes.md

@@ -1,62 +0,0 @@
-# fd 与 Spotlight（mdfind）配方
-
-## fd — 按文件名查找
-
-统一入口用 `seek.py "词" --filename`，手动配方：
-
-```bash
-# 文件名模糊匹配（忽略大小写）
-fd "login"
-
-# 指定目录
-fd "auth" ~/src
-
-# 限定扩展名
-fd -e py "schema"
-fd -e md -e txt "notes"
-
-# 只看目录
-fd -t d "config"
-
-# 隐藏文件
-fd -H ".*rc"
-```
-
-注意：fd 默认自动排除 .gitignore 中的内容，无需手动加 -E。
-
-## mdfind — macOS Spotlight 全盘兜底
-
-用系统预建索引，覆盖 rg 搜不到的东西（PDF 正文、邮件、已归档目录、图片元数据）。
-统一入口用 `seek.py "词" --spotlight`。
-
-```bash
-# 全盘搜索（走系统索引，毫秒级）
-mdfind "关键词"
-
-# 限定目录
-mdfind -onlyin ~/Documents "关键词"
-
-# 限定文件名
-mdfind -name "report"
-
-# 文件名+内容混合（kMDItem 查询语法）
-mdfind "kMDItemFSName == '*.pdf' && 关键词"
-
-# 只看最近修改
-mdfind "kMDItemFSContentChangeDate >= $time.today(-7) 关键词"
-```
-
-### 何时用 mdfind 而不是 rg
-
-| 信号 | 用 |
-|------|----|
-| 全盘搜，不知道文件在哪 | mdfind |
-| 搜 PDF/邮件/已归档内容 | mdfind |
-| 目录未建立 Spotlight 索引（外接盘/网络盘） | 退回 rg + 明确 --path |
-| 代码仓库内 | rg（永远优先） |
-
-### 坑
-
-- 外接盘、~/Library 部分目录可能未索引，mdfind 搜不到
-- mdfind 的查询是「关键词匹配」，中文分词效果取决于系统
-- 结果不带行号，定位到文件后需再 rg 找行

package/sub-skills/local-seek/references/git-integration.md

@@ -1,54 +0,0 @@
-# Git 联动手册（--git-log / --git-blame）
-
-本地搜索找到文件只是第一步，经常要接着回答「这行谁改的、为什么改、什么时候
-改的」。git 联动让 seek.py 直接给出答案，不用再开终端敲 git。
-
-## 用法
-
-```bash
-# 文件的最近提交历史（默认 10 条，oneline）
-python3 ~/.agents/skills/argo/sub-skills/local-seek/scripts/seek.py --git-log 文件路径
-
-# 某一行是谁在哪个提交改的
-python3 ~/.agents/skills/argo/sub-skills/local-seek/scripts/seek.py --git-blame 12 文件路径
-```
-
-文件路径作为位置参数（或 `--path`），两者互斥时位置参数优先。
-
-## 输出示例
-
-```text
-# --git-log
-local-seek: seek.py 最近 3 条提交
-cd02e96 补全结构搜索与 git 联动
-a1b2c3d 中文扩展：空格噪音修复
-
-# --git-blame 12
-local-seek: seek.py 第 12 行
-cd02e96f (taxueseek 2026-07-03 20:58:20 +0800 3)  ap.add_argument("--git-blame"...
-```
-
-## 适用场景
-
-| 场景 | 命令 | 读什么 |
-|------|------|--------|
-| 这文件最近在动什么 | --git-log | 提交标题序列 |
-| 某行代码的来历 | --git-blame N | 提交哈希、作者、时间 |
-| 拿到哈希后看完整改动 | --git-log 后再 `git -C 目录 show 哈希` | diff 正文 |
-| 谁改坏了某段逻辑 | --git-blame 定位行 → show 对应提交 | 上下文 |
-
-## 边界与局限
-
-- **未跟踪文件**：untracked（从未 git add）的文件无历史，报「无提交历史」，
-  不是错误。把文件 git add 后即有。
-- **仓库外文件**：不在任何 git 仓库内的文件报「不在 git 仓库中」。
-- **行号漂移**：blame 按当前行号定位，改动过的文件行号会移动，属正常。
-- **大文件历史**：--git-log 只读标题不看 diff，是低成本路径；要 diff 再手动
-  git show，不要指望 seek.py 输出正文。
-- **子模块/符号链接**：git -C 父目录 对符号链接指向的仓库无效，需先解析真实路径。
-
-## 与本地搜索的组合套路
-
-1. 搜到文件里的目标行：`seek.py "关键词" --path ~/repo --max 5`
-2. 定位关键行号后 blame：`seek.py --git-blame 行号 文件路径`
-3. 拿提交哈希再看 diff：`git -C ~/repo show 哈希`

package/sub-skills/local-seek/references/remote-handoff.md

@@ -1,46 +0,0 @@
-# 本地搜不到时的交接（remote-handoff）
-
-local-seek 只负责本机。本地无结果不意味着结束，按本清单逐步扩大，最后
-交接给联网搜索。判断标准写死在每一步，避免无限折腾。
-
-## 交接顺序（每步只做一次，失败即进下一步）
-
-```text
-L1 当前目录 rg 搜索（默认）
-  ↓ 无命中
-L2 --path 扩大到知识域（~/notes、~/Documents、技能库等）
-  ↓ 无命中
-L3 --spotlight 全盘兜底（mdfind，走 macOS 索引，覆盖 PDF/邮件/笔记）
-  ↓ 无命中
-L4 换词重试 1 次（同义词/拆词/去掉修饰词），仍无
-  ↓
-L5 交接联网：unified-search（多引擎聚合）或 argo（深度研究）
-```
-
-## 判断标准
-
-| 现象 | 结论 | 动作 |
-|------|------|------|
-| L1-L3 均无命中 | 本机确实没有，或不在已索引范围 | 进 L4 |
-| 换词后仍无 | 大概率是「没有这个内容」而非「没找到」 | 进 L5 |
-| L5 联网也无 | 内容不存在或太新未收录 | 如实告知，停止搜索 |
-| 命中但太少/太泛 | 不是交接问题，是词选得不好 | 回到 L2/L4 调整 |
-
-## 交接命令
-
-```bash
-# 本地最后一搏
-python3 ~/.agents/skills/argo/sub-skills/local-seek/scripts/seek.py "关键词" --spotlight
-
-# 联网：unified-search（多引擎，快）
-# 联网：argo 深度研究（学术/金融领域，带信源核验）
-```
-
-## 纪律
-
-- **禁止无限扩大**：每层只试一次，最多一轮换词，两轮无果就交接或停止。
-- **交接前确认需求边界**：用户要的是「我电脑里的文件」就别接出网；
-  要的是「这个事实/最新信息」就该直接联网，不必先搜本地。
-- **本地与联网并行**：需求两可时并行调用，互不阻塞，先到的先答。
-- **不把联网结果当本地文件**：交接后答案来自网络，措辞上要区分来源，
-  需要文件路径的请求不能用网页内容冒充。