shennian 0.5.2 → 0.5.4

package/dist/bin/shennian-adapter-host.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import t from"node:path";import{runAdapterRuntimeHost as o}from"../src/adapter-kit/host.js";const s=process.argv[2],e=process.argv.indexOf("--workdir"),a=e>=0?process.argv[e+1]:process.cwd();s||(process.stderr.write(`Usage: shennian-adapter-host <adapter.mjs> [--workdir <path>]
+`),process.exit(1)),o({entryPath:t.resolve(s),workDir:a}).catch(r=>{process.stderr.write(`${r instanceof Error?r.message:String(r)}
+`),process.exitCode=1});

package/dist/publish-build-manifest.json

@@ -2,13 +2,48 @@
   "schemaVersion": 1,
   "jsMinified": true,
   "minifier": "esbuild",
-  "fileCount": 234,
+  "fileCount": 248,
   "files": [
+    {
+      "file": "bin/shennian-adapter-host.js",
+      "beforeBytes": 814,
+      "afterBytes": 456
+    },
     {
       "file": "bin/shennian.js",
       "beforeBytes": 46,
       "afterBytes": 45
     },
+    {
+      "file": "src/adapter-kit/check.js",
+      "beforeBytes": 12684,
+      "afterBytes": 6175
+    },
+    {
+      "file": "src/adapter-kit/host.js",
+      "beforeBytes": 15582,
+      "afterBytes": 6812
+    },
+    {
+      "file": "src/adapter-kit/official-adapters.js",
+      "beforeBytes": 2137,
+      "afterBytes": 996
+    },
+    {
+      "file": "src/adapter-kit/registry.js",
+      "beforeBytes": 3595,
+      "afterBytes": 1606
+    },
+    {
+      "file": "src/adapter-kit/submission-client.js",
+      "beforeBytes": 2231,
+      "afterBytes": 1159
+    },
+    {
+      "file": "src/adapter-kit/types.js",
+      "beforeBytes": 365,
+      "afterBytes": 132
+    },
     {
       "file": "src/agent-env.js",
       "beforeBytes": 11128,
@@ -41,8 +76,8 @@
     },
     {
       "file": "src/agents/acp/client-services.js",
-      "beforeBytes": 6336,
-      "afterBytes": 3535
+      "beforeBytes": 6337,
+      "afterBytes": 3536
     },
     {
       "file": "src/agents/acp/discovery.js",
@@ -71,13 +106,8 @@
     },
     {
       "file": "src/agents/acp/process-client.js",
-      "beforeBytes": 7304,
-      "afterBytes": 4420
-    },
-    {
-      "file": "src/agents/acp/process-tree.js",
-      "beforeBytes": 698,
-      "afterBytes": 371
+      "beforeBytes": 7305,
+      "afterBytes": 4421
     },
     {
       "file": "src/agents/acp/types.js",
@@ -146,8 +176,8 @@
     },
     {
       "file": "src/agents/config-status.js",
-      "beforeBytes": 7976,
-      "afterBytes": 4126
+      "beforeBytes": 7855,
+      "afterBytes": 3923
     },
     {
       "file": "src/agents/cursor-managed-permissions.js",
@@ -171,13 +201,13 @@
     },
     {
       "file": "src/agents/custom.js",
-      "beforeBytes": 18024,
-      "afterBytes": 9595
+      "beforeBytes": 22815,
+      "afterBytes": 12166
     },
     {
       "file": "src/agents/detect.js",
-      "beforeBytes": 4019,
-      "afterBytes": 1827
+      "beforeBytes": 5211,
+      "afterBytes": 2494
     },
     {
       "file": "src/agents/event-terminal-gate.js",
@@ -201,18 +231,18 @@
     },
     {
       "file": "src/agents/model-registry/cache.js",
-      "beforeBytes": 1491,
-      "afterBytes": 640
+      "beforeBytes": 1745,
+      "afterBytes": 673
     },
     {
       "file": "src/agents/model-registry/discovery.js",
-      "beforeBytes": 11107,
-      "afterBytes": 5219
+      "beforeBytes": 11267,
+      "afterBytes": 5313
     },
     {
       "file": "src/agents/model-registry/opencode-api.js",
-      "beforeBytes": 3026,
-      "afterBytes": 1539
+      "beforeBytes": 3259,
+      "afterBytes": 1580
     },
     {
       "file": "src/agents/model-registry/parsers.js",
@@ -226,8 +256,8 @@
     },
     {
       "file": "src/agents/model-registry/service.js",
-      "beforeBytes": 8864,
-      "afterBytes": 3358
+      "beforeBytes": 9489,
+      "afterBytes": 3505
     },
     {
       "file": "src/agents/model-registry/types.js",
@@ -244,6 +274,11 @@
       "beforeBytes": 9705,
       "afterBytes": 4410
     },
+    {
+      "file": "src/agents/node-adapter.js",
+      "beforeBytes": 13949,
+      "afterBytes": 7399
+    },
     {
       "file": "src/agents/openclaw.js",
       "beforeBytes": 11179,
@@ -256,8 +291,8 @@
     },
     {
       "file": "src/agents/opencode.js",
-      "beforeBytes": 13286,
-      "afterBytes": 6985
+      "beforeBytes": 13890,
+      "afterBytes": 7062
     },
     {
       "file": "src/agents/pi-coding-agent-managed-permissions.js",
@@ -266,8 +301,8 @@
     },
     {
       "file": "src/agents/pi-coding-agent.js",
-      "beforeBytes": 22758,
-      "afterBytes": 12494
+      "beforeBytes": 28451,
+      "afterBytes": 15071
     },
     {
       "file": "src/agents/pi-managed-extension.js",
@@ -284,11 +319,26 @@
       "beforeBytes": 2397,
       "afterBytes": 1328
     },
+    {
+      "file": "src/agents/pi-turn-diagnostics.js",
+      "beforeBytes": 7200,
+      "afterBytes": 3920
+    },
     {
       "file": "src/agents/platform-instructions.js",
       "beforeBytes": 2829,
       "afterBytes": 1705
     },
+    {
+      "file": "src/agents/process-tree.js",
+      "beforeBytes": 2647,
+      "afterBytes": 856
+    },
+    {
+      "file": "src/agents/public-agent-client.js",
+      "beforeBytes": 3499,
+      "afterBytes": 2070
+    },
     {
       "file": "src/agents/runtime-compatibility.js",
       "beforeBytes": 1587,
@@ -314,15 +364,25 @@
       "beforeBytes": 18443,
       "afterBytes": 9602
     },
+    {
+      "file": "src/commands/adapter.js",
+      "beforeBytes": 19169,
+      "afterBytes": 13352
+    },
     {
       "file": "src/commands/agent-readiness.js",
-      "beforeBytes": 7032,
-      "afterBytes": 5639
+      "beforeBytes": 8695,
+      "afterBytes": 6674
+    },
+    {
+      "file": "src/commands/agent-workspace.js",
+      "beforeBytes": 10802,
+      "afterBytes": 6752
     },
     {
       "file": "src/commands/agent.js",
-      "beforeBytes": 5283,
-      "afterBytes": 2934
+      "beforeBytes": 6275,
+      "afterBytes": 3292
     },
     {
       "file": "src/commands/daemon-instance-lock.js",
@@ -401,19 +461,24 @@
     },
     {
       "file": "src/commands/room.js",
-      "beforeBytes": 18602,
-      "afterBytes": 10736
+      "beforeBytes": 25537,
+      "afterBytes": 15202
     },
     {
       "file": "src/commands/runtime.js",
-      "beforeBytes": 5624,
-      "afterBytes": 3146
+      "beforeBytes": 5678,
+      "afterBytes": 3203
     },
     {
       "file": "src/commands/schedule.js",
       "beforeBytes": 1288,
       "afterBytes": 936
     },
+    {
+      "file": "src/commands/support.js",
+      "beforeBytes": 4571,
+      "afterBytes": 2964
+    },
     {
       "file": "src/commands/tools.js",
       "beforeBytes": 1572,
@@ -436,8 +501,8 @@
     },
     {
       "file": "src/daemon-ipc/agent-readiness.js",
-      "beforeBytes": 4838,
-      "afterBytes": 2425
+      "beforeBytes": 5102,
+      "afterBytes": 2553
     },
     {
       "file": "src/daemon-ipc/client.js",
@@ -511,8 +576,8 @@
     },
     {
       "file": "src/index.js",
-      "beforeBytes": 42379,
-      "afterBytes": 20999
+      "beforeBytes": 42923,
+      "afterBytes": 21315
     },
     {
       "file": "src/log-redaction.js",
@@ -541,8 +606,8 @@
     },
     {
       "file": "src/manager/runtime.js",
-      "beforeBytes": 35299,
-      "afterBytes": 17196
+      "beforeBytes": 35692,
+      "afterBytes": 17388
     },
     {
       "file": "src/manager/worker-ipc.js",
@@ -696,13 +761,13 @@
     },
     {
       "file": "src/room/activation-policy.js",
-      "beforeBytes": 1566,
-      "afterBytes": 762
+      "beforeBytes": 2397,
+      "afterBytes": 1190
     },
     {
       "file": "src/room/activation-service.js",
-      "beforeBytes": 28566,
-      "afterBytes": 15641
+      "beforeBytes": 28830,
+      "afterBytes": 15852
     },
     {
       "file": "src/room/attachment-cache.js",
@@ -711,8 +776,8 @@
     },
     {
       "file": "src/room/attachment-upload.js",
-      "beforeBytes": 6996,
-      "afterBytes": 3546
+      "beforeBytes": 7283,
+      "afterBytes": 3698
     },
     {
       "file": "src/room/device-authorization-client.js",
@@ -726,8 +791,8 @@
     },
     {
       "file": "src/room/invite-bootstrap.js",
-      "beforeBytes": 6136,
-      "afterBytes": 3363
+      "beforeBytes": 4610,
+      "afterBytes": 2574
     },
     {
       "file": "src/room/invite-qr.js",
@@ -736,8 +801,8 @@
     },
     {
       "file": "src/room/live-delivery.js",
-      "beforeBytes": 1945,
-      "afterBytes": 1123
+      "beforeBytes": 2677,
+      "afterBytes": 1539
     },
     {
       "file": "src/room/managed-context.js",
@@ -746,8 +811,8 @@
     },
     {
       "file": "src/room/managed-prompt-composer.js",
-      "beforeBytes": 10537,
-      "afterBytes": 11365
+      "beforeBytes": 10674,
+      "afterBytes": 11637
     },
     {
       "file": "src/room/managed-room-binding.js",
@@ -756,13 +821,13 @@
     },
     {
       "file": "src/room/managed-room-ipc.js",
-      "beforeBytes": 15469,
-      "afterBytes": 7269
+      "beforeBytes": 15570,
+      "afterBytes": 7327
     },
     {
       "file": "src/room/mirror-sync-service.js",
-      "beforeBytes": 12115,
-      "afterBytes": 5558
+      "beforeBytes": 12375,
+      "afterBytes": 5688
     },
     {
       "file": "src/room/public-attachment-cache.js",
@@ -771,8 +836,8 @@
     },
     {
       "file": "src/room/public-room-client.js",
-      "beforeBytes": 5858,
-      "afterBytes": 3219
+      "beforeBytes": 6945,
+      "afterBytes": 4002
     },
     {
       "file": "src/room/registration-authority.js",
@@ -786,8 +851,8 @@
     },
     {
       "file": "src/room/room-action-client.js",
-      "beforeBytes": 29197,
-      "afterBytes": 14837
+      "beforeBytes": 29942,
+      "afterBytes": 15253
     },
     {
       "file": "src/room/room-binding-client.js",
@@ -891,8 +956,8 @@
     },
     {
       "file": "src/session/handlers/agent-workspace-validation.js",
-      "beforeBytes": 9136,
-      "afterBytes": 4977
+      "beforeBytes": 10525,
+      "afterBytes": 5385
     },
     {
       "file": "src/session/handlers/agents.js",
@@ -916,8 +981,8 @@
     },
     {
       "file": "src/session/handlers/chat-recovery.js",
-      "beforeBytes": 6623,
-      "afterBytes": 3485
+      "beforeBytes": 6918,
+      "afterBytes": 3623
     },
     {
       "file": "src/session/handlers/chat-session-lifecycle.js",
@@ -926,8 +991,8 @@
     },
     {
       "file": "src/session/handlers/chat.js",
-      "beforeBytes": 35005,
-      "afterBytes": 14959
+      "beforeBytes": 35377,
+      "afterBytes": 15049
     },
     {
       "file": "src/session/handlers/control.js",
@@ -996,8 +1061,8 @@
     },
     {
       "file": "src/session/manager.js",
-      "beforeBytes": 40313,
-      "afterBytes": 21179
+      "beforeBytes": 40963,
+      "afterBytes": 21571
     },
     {
       "file": "src/session/native-cleanup-outbox.js",
@@ -1036,8 +1101,8 @@
     },
     {
       "file": "src/session/queue-helpers.js",
-      "beforeBytes": 9055,
-      "afterBytes": 4369
+      "beforeBytes": 9503,
+      "afterBytes": 4628
     },
     {
       "file": "src/session/queue-message.js",
@@ -1061,8 +1126,8 @@
     },
     {
       "file": "src/session/queue.js",
-      "beforeBytes": 40313,
-      "afterBytes": 17923
+      "beforeBytes": 41453,
+      "afterBytes": 18387
     },
     {
       "file": "src/session/queued-chat-dispatch.js",
@@ -1119,6 +1184,11 @@
       "beforeBytes": 164,
       "afterBytes": 1
     },
+    {
+      "file": "src/support/support-client.js",
+      "beforeBytes": 3060,
+      "afterBytes": 1656
+    },
     {
       "file": "src/tools/markdown-to-pdf.js",
       "beforeBytes": 15004,

package/dist/resources/agent-adapters/claude.md

@@ -0,0 +1,33 @@
+# Claude Code
+
+## 神念如何接入
+
+神念通过官方 `claude` CLI 接入本机已经安装并登录的 Claude Code。`packages/cli/src/agents/claude.ts` 用 `resolveBuiltinCommand('claude')` 定位可执行程序，并以子进程方式启动一次会话；不使用未发布的私有 API。
+
+## 模型发现
+
+模型 ID 通过运行时探测得到（`model-registry/discovery.ts`），不是写死在源码里的固定列表；探测失败时不会伪造一个"看起来正常"的模型。
+
+## 会话生命周期
+
+- `start`：拼出 CLI 参数并 spawn 子进程，建立一次新的原生会话。
+- `send`：把当前用户消息传给同一个子进程/会话。
+- `resume`：使用 `--resume <session-id>` 精确恢复对应的原生会话，不猜测"最近一次"。
+- `stop`：终止当前子进程并释放资源。
+
+## 系统提示词
+
+Claude CLI 支持 `--append-system-prompt <text>` 参数；神念把当前会话的完整系统提示词通过这个参数传入，不拼接进第一条用户消息。首次 `start` 与之后的 `--resume` 都会重新带上该参数。
+
+## 登录与环境
+
+依赖用户本机已经完成的 Claude 账号登录状态；神念只刷新并转发当前用户环境（Provider Key、`PATH` 等），不写入或读取任何长期账号凭据的具体值到日志、协议或提交文件中。
+
+## 可用性检查
+
+完整检查覆盖：可执行程序可定位、动态模型非空、真实 `start → send → final`、`--append-system-prompt` 生效、`stop` 正常结束、`--resume` 精确恢复同一原生会话。
+
+## 已知限制与排障
+
+- 未安装或未登录 Claude CLI 时，`start` 会在启动阶段失败；先确认 `claude` 命令本身可以在终端正常工作。
+- 模型探测依赖 CLI 自身的可用模型列表；账号权限变化会改变可选模型集合。

package/dist/resources/agent-adapters/codex.md

@@ -0,0 +1,33 @@
+# Codex
+
+## 神念如何接入
+
+神念通过 Codex 的 app-server 机制接入（`packages/cli/src/agents/codex.ts`、`codex-runtime.ts`、`codex-protocol.ts`），以 JSON-RPC 方式与本机 Codex 会话通信，而不是逐行解析普通终端输出。
+
+## 模型发现
+
+模型通过运行时探测获得；探测失败时使用一份内置的保底模型列表（`fallbackCodexModels()`）而不是直接判定 Agent 不可用，但保底列表仅作为探测失败的兜底展示，不代表已经验证该模型真实可回复。
+
+## 会话生命周期
+
+- `start`：建立一个新的 Codex thread。
+- `send`：向当前 thread 发送一次用户回合。
+- `resume`：通过 `thread/resume` 精确恢复指定 thread；神念内部注释明确标注"精确恢复是真实能力，终端检查 / Turn 重新挂载不是"，即只保证按 ID 恢复这一项。
+- `stop`：结束当前回合并释放子进程/连接。
+
+## 系统提示词
+
+Codex app-server 支持以配置方式声明指令来源（代码中的 `model_instructions_file` 配置项），神念据此把完整系统提示词写入真实的指令通道，而不是拼进用户消息正文。
+
+## 登录与环境
+
+依赖用户本机已经完成的 Codex 账号登录；神念只转发刷新后的当前用户环境，不写入长期账号凭据的具体值。
+
+## 可用性检查
+
+完整检查覆盖：app-server 可连接、动态模型非空、真实 `start → send → final`、指令注入生效、`stop` 正常结束、`thread/resume` 精确恢复同一 thread。
+
+## 已知限制与排障
+
+- 模型探测失败时展示的是保底列表，不代表已验证可用；仍需要一次真实 `check` 才能确认。
+- Codex 的终端检查与 Turn 重新挂载能力有限，恢复能力目前只保证"按精确 ID 恢复"这一项。

package/dist/resources/agent-adapters/cursor.md

@@ -0,0 +1,32 @@
+# Cursor Agent
+
+## 神念如何接入
+
+神念通过 `cursor-agent` CLI 接入（`packages/cli/src/agents/cursor.ts`），以子进程方式启动并解析输出。
+
+## 模型发现
+
+模型通过运行时探测获得（`model-registry/discovery.ts` 中的 Cursor 分支），不是写死在源码里的固定列表。
+
+## 会话生命周期
+
+- `start` / `send`：spawn `cursor-agent` 子进程并发送当前用户回合。
+- `resume`：使用 `--resume <chat-id>` 精确恢复对应的原生会话。
+- `stop`：终止当前子进程。
+
+## 系统提示词
+
+**当前实现不满足 Adapter 协议 V1 的系统提示词要求。** 代码里的系统提示词是通过 `buildInlineChannelPreamble(...)` 拼接在用户正文前面一起发送给 `cursor-agent`（见 `cursor.ts` 的 `send()`），而不是通过 Cursor 的独立 system/instructions 参数注入——因为 Cursor Agent CLI 目前没有暴露这样的参数。这正是协议 V1 明确禁止的"拼入用户正文"，因此 Cursor 目前无法通过完整检查的系统提示词冲突测试。
+
+## 登录与环境
+
+依赖用户本机已经完成的 Cursor 账号登录。Cursor Agent 没有经过验证的、按调用范围移除 Provider 凭据的方式，因此神念不会为它单独下发 Provider 环境变量，而是依赖 Cursor 自身的登录态。
+
+## 可用性检查
+
+模型发现、`start/send/stop` 和精确 `resume` 目前可用；系统提示词检查会失败，因此 Cursor 目前不满足 Adapter V1 的完整检查，不进入正常可选列表。
+
+## 已知限制与排障
+
+- 系统提示词目前是内联拼接，不是真实的 system/instructions 通道；在 Cursor Agent CLI 提供对应参数之前，官方 Adapter 无法通过完整检查。
+- 需要真实通过检查的场景，可以由本地 AI 参考 Adapter V1 尝试其他机器接口（如存在），并把结果提交给神念官方评审。

package/dist/resources/agent-adapters/custom.md

@@ -0,0 +1,40 @@
+# 自定义 Node Adapter
+
+## 神念如何接入
+
+这一项不对应某个具体的第三方 Agent，而是神念自适应接入的入口：当官方 Adapter 无法适应你机器上的实际安装、网关或启动方式时，你的本地 AI 可以用 [神念 Adapter 协议 V1](../../../packages/agent-protocol/PROTOCOL.md) 写一个 `adapter.mjs`，交给独立 Shennian Client 内置的 Adapter Runtime 加载和检查。
+
+```text
+shennian adapter init <目录> --name <名称>
+shennian adapter check <adapter.mjs> --workdir <目录> [--model <模型>]
+shennian adapter add <名称> --entry <adapter.mjs>
+shennian adapter list
+shennian adapter show custom:<名称>
+shennian adapter remove <名称>
+```
+
+## 模型发现
+
+由你自己实现的 `listModels` 决定；必须每次从上游真实、动态发现，且至少返回一个模型。
+
+## 会话生命周期
+
+`start / send / stop / resume` 全部由你自己的 `adapter.mjs` 实现；Runtime 负责 JSON Lines、并发、取消、终态和错误归一，你不需要自己处理这些。
+
+## 系统提示词
+
+`start / resume` 必须接收 `systemPrompt`，并通过上游真实的 system/instructions 参数注入；`send` 不再携带系统提示词。`adapter check` 会用一次真实的冲突测试验证这一点，只把结果写文本代码位置，不要求可再验证的形式化证明。
+
+## 登录与环境
+
+`adapter check` 使用与官方 Agent 相同的、刷新过的当前用户环境，并过滤神念长期账号、机器和登录凭据；你的 Adapter 自己启动的子进程必须继承这份环境，不能用空环境覆盖 Provider Key。
+
+## 可用性检查
+
+见 [神念 Adapter 协议 V1](../../../packages/agent-protocol/PROTOCOL.md) 第 9 节的完整检查清单：模块契约、动态模型、真实 `start`、系统提示词冲突测试、`send` 终态、`stop`、精确 `resume`。全部通过后才能 `adapter add` 注册。
+
+## 已知限制与排障
+
+- `adapter add` 只接受指纹未变化、已经通过 `adapter check` 的文件；修改文件后需要重新 `check`。
+- 检查失败时按返回的 `stage` 和错误码定位问题：`models`、`start`、`systemPrompt`、`send`、`stop`、`resume` 分别对应协议里的对应阶段。
+- 通用实现完整通过检查后，可以在你确认的前提下生成一份脱敏文件提交给神念官方，参考 [Agent 自适应接入](../../features/local-agent-adapters.md) 第四节。

package/dist/resources/agent-adapters/opencode.md

@@ -0,0 +1,31 @@
+# OpenCode
+
+## 神念如何接入
+
+神念通过 OpenCode CLI 接入（`packages/cli/src/agents/opencode.ts`），以子进程方式启动并解析输出；模型清单还可以通过 OpenCode 自身的 API（`model-registry/opencode-api.ts`）查询。
+
+## 模型发现
+
+模型通过运行时探测获得，不是写死在源码里的固定列表。
+
+## 会话生命周期
+
+- `start` / `send`：spawn OpenCode 子进程并发送当前用户回合。
+- `resume`：精确恢复对应原生会话。
+- `stop`：终止当前子进程。
+
+## 系统提示词
+
+**当前实现不满足 Adapter 协议 V1 的系统提示词要求。** 和 Cursor 一样，系统提示词由 `buildInlineChannelPreamble(...)` 拼接在用户正文前一起发送（见 `opencode.ts` 的 `send()`），而不是通过独立的 system/instructions 参数注入。这是协议 V1 明确禁止的做法，OpenCode 目前无法通过完整检查的系统提示词冲突测试。
+
+## 登录与环境
+
+依赖用户本机已经完成的 OpenCode / Provider 登录；神念只转发刷新后的当前用户环境。
+
+## 可用性检查
+
+模型发现、`start/send/stop` 和精确 `resume` 目前可用；系统提示词检查会失败，因此 OpenCode 目前不满足 Adapter V1 的完整检查，不进入正常可选列表。
+
+## 已知限制与排障
+
+- 系统提示词目前是内联拼接，不是真实的 system/instructions 通道；需要确认 OpenCode 是否有等价的独立指令参数后才能补齐这项检查。

package/dist/resources/agent-adapters/pi-coding-agent.md

@@ -0,0 +1,31 @@
+# Pi Coding Agent
+
+## 神念如何接入
+
+神念通过 Pi Coding Agent 的 RPC 客户端接入（`packages/cli/src/agents/pi-coding-agent.ts`、`pi-rpc-client.ts`），以子进程 + RPC 的方式通信。
+
+## 模型发现
+
+模型通过运行时探测获得，不是写死在源码里的固定列表。
+
+## 会话生命周期
+
+- `start` / `send`：spawn 子进程并通过 RPC 发送当前用户回合。
+- `resume`：精确恢复指定原生会话；代码在恢复失败并检测到 RPC 恢复了不同会话时会主动报错（"Pi RPC resumed a different session"），拒绝把错误会话当作恢复成功。
+- `stop`：终止当前子进程。
+
+## 系统提示词
+
+Pi Coding Agent 把完整系统提示词写入一个临时 `instructions.md` 文件，再通过 `--append-system-prompt <file>` 传给上游，属于真实的文件型 system/instructions 通道，不拼接进用户正文。
+
+## 登录与环境
+
+依赖用户本机已经完成的 Pi Coding Agent / Provider 登录；神念只转发刷新后的当前用户环境，并清理 `NO_COLOR` 等无害运行时标记。
+
+## 可用性检查
+
+完整检查覆盖：可执行程序可定位、动态模型非空、真实 `start → send → final`、`instructions.md` 文件注入生效、`stop` 正常结束、精确 `resume`（并拒绝任何非目标会话）。
+
+## 已知限制与排障
+
+- `resume` 明确拒绝"恢复了别的会话"这种情况；遇到此类错误说明上游把请求路由到了错误的原生会话，需要先排查 Pi Coding Agent 自身的会话管理。