fix: 提醒 Hook 始终成功退出并升级至 0.1.6

Author: hiwepy@gmail.com

.agents/plugins/marketplace.json

@@ -9,20 +9,20 @@
       "source": {
         "source": "url",
         "url": "https://github.com/full-stack-plugins/codegraph-plugin.git",
-        "ref": "v0.1.5"
+        "ref": "v0.1.6"
       },
       "policy": {
         "installation": "AVAILABLE",
         "authentication": "ON_USE"
       },
       "category": "Developer Tools",
-      "version": "0.1.5",
+      "version": "0.1.6",
       "description": "Inject the official CodeGraph prompt at session start (only when a `.codegraph/` directory exists) and expose all 20 codegraph CLI commands as slash commands for Codex/ZCode/Kimi/Claude Code. Pure Python stdlib.",
-      "icon": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codegraph-plugin@v0.1.5/assets/official-logo.png",
+      "icon": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codegraph-plugin@v0.1.6/assets/official-logo.png",
       "interface": {
         "displayName": "CodeGraph",
         "shortDescription": "Discoverable codegraph — official prompt + all CLI commands",
-        "logo": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codegraph-plugin@v0.1.5/assets/official-logo.png"
+        "logo": "https://cdn.jsdelivr.net/gh/full-stack-plugins/codegraph-plugin@v0.1.6/assets/official-logo.png"
       }
     }
   ]

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codegraph",
-  "version": "0.1.5+codex.20260924",
+  "version": "0.1.6+codex.20261003",
   "description": "Inject the official CodeGraph prompt at session start (only when a `.codegraph/` directory exists) and expose all 20 codegraph CLI commands as slash commands for Codex/ZCode/Kimi/Claude Code. Pure Python stdlib.",
   "author": {
     "name": "Full Stack Plugins",

.zcode-plugin/plugin.json

@@ -5,7 +5,7 @@
     "en": "CodeGraph",
     "zh-CN": "CodeGraph 代码智能"
   },
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Inject the official CodeGraph prompt at session start (only when a `.codegraph/` directory exists) and expose all 20 codegraph CLI commands as slash commands for Codex/ZCode/Kimi/Claude Code. Pure Python stdlib.",
   "description_i18n": {
     "en": "At SessionStart, when a `.codegraph/` directory exists, this plugin writes the official CodeGraph prompt block to `<cwd>/.claude/CLAUDE.md` or `<cwd>/AGENTS.md`, and injects the same block as SessionStart additionalContext. Exposes all 20 codegraph CLI commands as slash commands.",

AGENTS.md

@@ -11,7 +11,7 @@
 
 ## 版本
 
-- 当前: v0.1.5
+- 当前: v0.1.6
 - 同步自 codegraph v1.5.0 的 `instructions-template.ts`
 - Codex 后缀: `<version>+codex.YYYYMMDD`
 
@@ -34,4 +34,4 @@
 - 不暴露 `codegraph prompt-hook` / `codegraph serve --mcp`（codegraph 自家隐藏命令）
 - 不挂 PreToolUse/PostToolUse/UserPromptSubmit/Stop 钩子（避免与 codeguard-plugin 抢触发器）
 - 不自动跑 `codegraph install`（那是用户的一次性 wiring 决策，插件不能越权）
-- 不读取或上传任何源代码到外部
+- 不读取或上传任何源代码到外部

README.md

@@ -87,7 +87,7 @@ Check `<cwd>/.codegraph/` exists?
               with the full CodeGraph prompt block
 ```
 
-All exceptions fail-open (exit 0) — the host agent never sees a SessionStart error from this plugin.
+The reminder launcher tries `python`, then `python3`, with UTF-8 enabled. If neither interpreter starts, it exits 0. Library-loading and injection errors also fail open; failure to write the instruction file still permits session-context injection. Host-enforced timeouts or process termination remain outside this guarantee.
 
 ## Coexistence with `codegraph install`
 
@@ -118,4 +118,4 @@ Apache-2.0. See [LICENSE](LICENSE). The official CodeGraph prompt block in `scri
 
 ## Privacy
 
-See [PRIVACY.md](PRIVACY.md). The plugin is client-side only, makes no network calls, reads no user source code, and writes only to host instruction files using marker-fenced replacement.
+See [PRIVACY.md](PRIVACY.md). The plugin is client-side only, makes no network calls, reads no user source code, and writes only to host instruction files using marker-fenced replacement.

README.zh-CN.md

@@ -91,7 +91,7 @@
               内容为完整 CodeGraph 提示词块
 ```
 
-所有异常都 fail-open（exit 0）——宿主代理不会看到本插件的任何 SessionStart 错误。
+提醒启动器依次尝试 `python`、`python3`，并开启 UTF-8；两个解释器都不能启动时仍 exit 0。库加载与注入异常同样 fail-open，指令文件写入失败仍继续注入会话提醒。宿主强制超时或终止进程不在此保证范围内。
 
 ## 与 `codegraph install` 的共存
 
@@ -125,4 +125,4 @@ Apache-2.0。详见 [LICENSE](LICENSE)。`scripts/codegraph_lib/prompt.py` 中
 
 ## 隐私
 
-详见 [PRIVACY.md](PRIVACY.md)。本插件纯客户端，不联网，不读取用户源代码，仅用标记区间替换写宿主指令文件。
+详见 [PRIVACY.md](PRIVACY.md)。本插件纯客户端，不联网，不读取用户源代码，仅用标记区间替换写宿主指令文件。

com.github.copilot/hooks/hooks.json

@@ -6,12 +6,12 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/inject_codegraph_prompt.py\"",
+            "command": "python -X utf8 \"${CLAUDE_PLUGIN_ROOT}/hooks/inject_codegraph_prompt.py\" || python3 -X utf8 \"${CLAUDE_PLUGIN_ROOT}/hooks/inject_codegraph_prompt.py\" || exit 0",
             "timeout": 10,
             "statusMessage": "codegraph-plugin: 检测 .codegraph/ 并注入官方提示词…"
           }
         ]
       }
     ]
   }
-}
+}

com.github.copilot/hooks/inject_codegraph_prompt.py

@@ -15,19 +15,6 @@
 import sys
 from pathlib import Path
 
-PLUGIN_ROOT = next((c for c in Path(__file__).resolve().parents if (c / "plugin.json").is_file()), Path(__file__).resolve().parents[1])
-sys.path.insert(0, str(PLUGIN_ROOT / "scripts"))
-
-from codegraph_lib import (  # noqa: E402
-    CODEGRAPH_INSTRUCTIONS_BLOCK,
-    CODEGRAPH_SECTION_END,
-    CODEGRAPH_SECTION_START,
-    is_indexed,
-    replace_or_append_marked_section,
-    resolve_instructions_path,
-)
-
-
 def read_payload() -> dict:
     """从 stdin 读 SessionStart JSON payload.
 
@@ -46,6 +33,21 @@ def read_payload() -> dict:
 
 def main() -> int:
     try:
+        # 安装包定位与库加载也属于提醒的 fail-open 边界。
+        plugin_root = next(
+            (c for c in Path(__file__).resolve().parents if (c / "plugin.json").is_file()),
+            Path(__file__).resolve().parents[1],
+        )
+        sys.path.insert(0, str(plugin_root / "scripts"))
+        from codegraph_lib import (
+            CODEGRAPH_INSTRUCTIONS_BLOCK,
+            CODEGRAPH_SECTION_END,
+            CODEGRAPH_SECTION_START,
+            is_indexed,
+            replace_or_append_marked_section,
+            resolve_instructions_path,
+        )
+
         payload = read_payload()
         cwd_str = payload.get("cwd") if isinstance(payload, dict) else None
         cwd = Path(cwd_str) if cwd_str else Path(os.getcwd())

dev.openhands/hooks/hooks.json

@@ -6,12 +6,12 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/inject_codegraph_prompt.py\"",
+            "command": "python -X utf8 \"${CLAUDE_PLUGIN_ROOT}/hooks/inject_codegraph_prompt.py\" || python3 -X utf8 \"${CLAUDE_PLUGIN_ROOT}/hooks/inject_codegraph_prompt.py\" || exit 0",
             "timeout": 10,
             "statusMessage": "codegraph-plugin: 检测 .codegraph/ 并注入官方提示词…"
           }
         ]
       }
     ]
   }
-}
+}

dev.openhands/hooks/inject_codegraph_prompt.py

@@ -15,19 +15,6 @@
 import sys
 from pathlib import Path
 
-PLUGIN_ROOT = next((c for c in Path(__file__).resolve().parents if (c / "plugin.json").is_file()), Path(__file__).resolve().parents[1])
-sys.path.insert(0, str(PLUGIN_ROOT / "scripts"))
-
-from codegraph_lib import (  # noqa: E402
-    CODEGRAPH_INSTRUCTIONS_BLOCK,
-    CODEGRAPH_SECTION_END,
-    CODEGRAPH_SECTION_START,
-    is_indexed,
-    replace_or_append_marked_section,
-    resolve_instructions_path,
-)
-
-
 def read_payload() -> dict:
     """从 stdin 读 SessionStart JSON payload.
 
@@ -46,6 +33,21 @@ def read_payload() -> dict:
 
 def main() -> int:
     try:
+        # 安装包定位与库加载也属于提醒的 fail-open 边界。
+        plugin_root = next(
+            (c for c in Path(__file__).resolve().parents if (c / "plugin.json").is_file()),
+            Path(__file__).resolve().parents[1],
+        )
+        sys.path.insert(0, str(plugin_root / "scripts"))
+        from codegraph_lib import (
+            CODEGRAPH_INSTRUCTIONS_BLOCK,
+            CODEGRAPH_SECTION_END,
+            CODEGRAPH_SECTION_START,
+            is_indexed,
+            replace_or_append_marked_section,
+            resolve_instructions_path,
+        )
+
         payload = read_payload()
         cwd_str = payload.get("cwd") if isinstance(payload, dict) else None
         cwd = Path(cwd_str) if cwd_str else Path(os.getcwd())