shennian 0.2.53 → 0.2.55

package/dist/src/agents/adapter.d.ts

@@ -25,6 +25,7 @@ export interface AgentAdapterEvents {
 export declare abstract class AgentAdapter extends EventEmitter<AgentAdapterEvents> {
     abstract readonly type: AgentType;
     configure?(options: {
+        sessionId?: string;
         externalChannel?: ExternalChannelSessionStatus | null;
         env?: NodeJS.ProcessEnv;
     }): void;

package/dist/src/agents/claude.d.ts

@@ -18,8 +18,10 @@ export declare class ClaudeAdapter extends AgentAdapter {
         hidden?: boolean;
     });
     private externalChannel;
+    private shennianSessionId;
     private extraEnv;
     configure(options: {
+        sessionId?: string;
         externalChannel?: ExternalChannelSessionStatus | null;
         env?: NodeJS.ProcessEnv;
     }): void;

package/dist/src/agents/claude.js

@@ -33,8 +33,10 @@ export class ClaudeAdapter extends AgentAdapter {
         this.options = options;
     }
     externalChannel = null;
+    shennianSessionId = null;
     extraEnv = {};
     configure(options) {
+        this.shennianSessionId = options.sessionId ?? null;
         this.externalChannel = options.externalChannel ?? null;
         this.extraEnv = options.env ?? {};
     }
@@ -50,7 +52,7 @@ export class ClaudeAdapter extends AgentAdapter {
         this.runId = randomUUID();
         this.resetRunState();
         const args = ['-p', text, '--output-format', 'stream-json', '--verbose'];
-        const systemPrompt = this.options.systemPrompt ?? buildPlatformInstructions(this.workDir ?? process.cwd(), this.externalChannel);
+        const systemPrompt = this.options.systemPrompt ?? buildPlatformInstructions(this.workDir ?? process.cwd(), this.externalChannel, this.shennianSessionId ?? undefined);
         if (systemPrompt) {
             args.push('--append-system-prompt', systemPrompt);
         }
@@ -76,7 +78,7 @@ export class ClaudeAdapter extends AgentAdapter {
         this.runId = randomUUID();
         this.resetRunState();
         const resumeArgs = ['--resume', agentSessionId, '--output-format', 'stream-json', '--verbose'];
-        const systemPrompt = this.options.systemPrompt ?? buildPlatformInstructions(this.workDir ?? process.cwd(), this.externalChannel);
+        const systemPrompt = this.options.systemPrompt ?? buildPlatformInstructions(this.workDir ?? process.cwd(), this.externalChannel, this.shennianSessionId ?? undefined);
         if (systemPrompt) {
             resumeArgs.push('--append-system-prompt', systemPrompt);
         }

package/dist/src/agents/codex.d.ts

@@ -27,8 +27,10 @@ export declare class CodexAdapter extends AgentAdapter {
         hidden?: boolean;
     });
     private externalChannel;
+    private shennianSessionId;
     private extraEnv;
     configure(options: {
+        sessionId?: string;
         externalChannel?: ExternalChannelSessionStatus | null;
         env?: NodeJS.ProcessEnv;
     }): void;

package/dist/src/agents/codex.js

@@ -33,8 +33,10 @@ export class CodexAdapter extends AgentAdapter {
         this.options = options;
     }
     externalChannel = null;
+    shennianSessionId = null;
     extraEnv = {};
     configure(options) {
+        this.shennianSessionId = options.sessionId ?? null;
         this.externalChannel = options.externalChannel ?? null;
         this.extraEnv = options.env ?? {};
     }
@@ -133,7 +135,7 @@ export class CodexAdapter extends AgentAdapter {
             return;
         }
         const args = ['app-server', '--listen', 'stdio://'];
-        const modelInstructionsFile = this.options.modelInstructionsFile ?? ensurePlatformInstructionsFile(this.workDir ?? process.cwd(), this.externalChannel);
+        const modelInstructionsFile = this.options.modelInstructionsFile ?? ensurePlatformInstructionsFile(this.workDir ?? process.cwd(), this.externalChannel, this.shennianSessionId ?? undefined);
         if (modelInstructionsFile) {
             args.push('-c', `model_instructions_file=${JSON.stringify(modelInstructionsFile)}`);
         }

package/dist/src/agents/external-channel-instructions.d.ts

@@ -1,2 +1,2 @@
 import type { ExternalChannelSessionStatus } from '@shennian/wire';
-export declare function buildExternalChannelInstructions(channel?: ExternalChannelSessionStatus | null): string;
+export declare function buildExternalChannelInstructions(channel?: ExternalChannelSessionStatus | null, workDir?: string, sessionId?: string): string;

package/dist/src/agents/external-channel-instructions.js

@@ -1,10 +1,16 @@
 // @arch docs/features/wecom-managed-channel.md
 // @test src/__tests__/platform-instructions.test.ts
-export function buildExternalChannelInstructions(channel) {
+export function buildExternalChannelInstructions(channel, workDir, sessionId) {
     if (!channel?.configured && !channel?.connected)
         return '';
     const channelName = channel.name?.trim() || '外部消息通道';
     const customPrompt = channel.systemPrompt?.trim();
+    const sessionHint = sessionId?.trim()
+        ? `当前对话 ID：${sessionId}。如果命令提示缺少外部通道上下文，使用：shennian external send --session-id ${sessionId} --text "<要发送的消息>"`
+        : '';
+    const workdirHint = workDir?.trim()
+        ? `如果使用 shell_command，请设置 workdir 为 ${workDir}。不要用裸 /bin/zsh -lc 或 command_execution 运行此命令，因为那种环境可能拿不到当前对话的外部通道身份。`
+        : '如果使用 shell_command，请设置 workdir 为当前对话的项目目录。不要用裸 /bin/zsh -lc 或 command_execution 运行此命令，因为那种环境可能拿不到当前对话的外部通道身份。';
     const sections = [
         `当前对话已接入外部消息通道：${channelName}。`,
         `外部消息会以如下格式进入对话：\n外部消息\n<时间> <用户昵称>: <内容>`,
@@ -13,9 +19,12 @@ export function buildExternalChannelInstructions(channel) {
             : [
                 '当用户明确要求你向外部消息通道发送内容，或你需要回复一条外部消息时，调用：',
                 'shennian external send --text "<要发送的消息>"',
+                sessionHint,
+                workdirHint,
                 '只发送用户可见的最终内容，不要发送内部推理、工具日志或实现细节。',
+                '对外消息必须像真人聊天：简短、概要、单段；不要使用 Markdown、编号列表、项目符号、真实换行或字面 \\n。',
             ].join('\n'),
-        '如果外部消息和当前任务无关，可以忽略或简短说明无需处理；如果处理需要时间，先简短确认，再继续完成任务。',
+        '如果外部消息和当前任务无关，可以忽略或简短说明无需处理；如果处理需要时间，先用一句话确认，再继续完成任务。',
         customPrompt ? `本通道附加约束：${customPrompt}` : '',
     ].filter(Boolean);
     return sections.join('\n\n');

package/dist/src/agents/model-registry/discovery.js

@@ -2,10 +2,10 @@
 // @test src/__tests__/model-switching.test.ts
 import { createInterface } from 'node:readline';
 import { resolveBuiltinCommand, spawnResolvedCommand } from '../command-spec.js';
-import { fallbackClaudeAliasModels, fallbackGeminiModels, parseCodexAppServerModels, parseCursorModels, parseOpenCodeModels, } from './parsers.js';
+import { fallbackClaudeAliasModels, discoverClaudeAliasModelsFromEnv, fallbackGeminiModels, parseCodexAppServerModels, parseCursorModels, parseOpenCodeModels, } from './parsers.js';
 import { runResolvedCommand } from './runner.js';
 import { DISCOVERY_WORKDIR } from './types.js';
-import { buildAgentProcessEnv } from '../../agent-env.js';
+import { buildAgentProcessEnv, readLatestUserEnv } from '../../agent-env.js';
 function sendAppServerRpc(proc, pending, id, method, params, timeoutMs) {
     if (!proc.stdin)
         return Promise.reject(new Error('codex app-server stdin unavailable'));
@@ -108,6 +108,9 @@ async function discoverOpenCodeModels() {
 async function discoverClaudeModels() {
     if (!resolveBuiltinCommand('claude'))
         return [];
+    const shellEnvModels = discoverClaudeAliasModelsFromEnv(readLatestUserEnv());
+    if (shellEnvModels.length > 0)
+        return shellEnvModels;
     return fallbackClaudeAliasModels();
 }
 async function discoverCodexModels() {

package/dist/src/agents/model-registry/parsers.d.ts

@@ -4,12 +4,14 @@ export declare function parseCursorModels(raw: string): ModelInfo[];
 export declare function parseOpenClawModels(raw: string): ModelInfo[];
 export declare function parseOpenCodeModels(raw: string): ModelInfo[];
 export declare function parseClaudeModels(raw: string): ModelInfo[];
-type EnvLike = Record<string, string | undefined>;
+export type EnvLike = Record<string, string | undefined>;
+export declare function readEnvValue(env: EnvLike, key: string): string | null;
+export declare function inferClaudeOverrideProvider(modelName: string, env: EnvLike): string;
+export declare function discoverClaudeAliasModelsFromEnv(env?: EnvLike): ModelInfo[];
 export declare function applyClaudeModelEnvOverrides(models: ModelInfo[], env?: EnvLike): ModelInfo[];
 export declare function parseClaudeBinaryModels(raw: string): ModelInfo[];
-export declare function fallbackClaudeAliasModels(): ModelInfo[];
+export declare function fallbackClaudeAliasModels(env?: EnvLike): ModelInfo[];
 export declare function parseCodexModels(raw: string): ModelInfo[];
 export declare function parseCodexAppServerModels(raw: unknown): ModelInfo[];
 export declare function parseGeminiModels(raw: string): ModelInfo[];
 export declare function fallbackGeminiModels(): ModelInfo[];
-export {};

package/dist/src/agents/model-registry/parsers.js

@@ -193,6 +193,9 @@ const CLAUDE_ALIAS_MODEL_ENV = {
     opus: 'ANTHROPIC_DEFAULT_OPUS_MODEL',
     haiku: 'ANTHROPIC_DEFAULT_HAIKU_MODEL',
 };
+const CLAUDE_DEEPSEEK_REASONING_EFFORTS = [
+    { id: 'max', name: 'Max' },
+];
 const CLAUDE_REASONING_EFFORTS = [
     { id: 'low', name: 'Low' },
     { id: 'medium', name: 'Medium' },
@@ -207,17 +210,46 @@ function withClaudeReasoningEfforts(model) {
         defaultReasoningEffort: 'medium',
     };
 }
-function readEnvValue(env, key) {
+export function readEnvValue(env, key) {
     const value = env[key]?.trim();
     return value || null;
 }
-function inferClaudeOverrideProvider(modelName, env) {
+export function inferClaudeOverrideProvider(modelName, env) {
     const baseUrl = readEnvValue(env, 'ANTHROPIC_BASE_URL')?.toLowerCase() ?? '';
     if (baseUrl.includes('deepseek.com') || modelName.toLowerCase().startsWith('deepseek-')) {
         return 'deepseek';
     }
     return baseUrl ? 'custom' : 'anthropic';
 }
+function configuredClaudeAliasModels(env) {
+    const configured = new Set();
+    for (const key of Object.values(CLAUDE_ALIAS_MODEL_ENV)) {
+        const modelName = readEnvValue(env, key);
+        if (modelName)
+            configured.add(modelName);
+    }
+    const models = Array.from(configured).map((modelName, index) => {
+        const provider = inferClaudeOverrideProvider(modelName, env);
+        const model = {
+            id: modelName,
+            name: modelName,
+            provider,
+            isDefault: index === 0,
+        };
+        if (provider === 'deepseek') {
+            return {
+                ...model,
+                supportedReasoningEfforts: CLAUDE_DEEPSEEK_REASONING_EFFORTS,
+                defaultReasoningEffort: readEnvValue(env, 'CLAUDE_CODE_EFFORT_LEVEL') ?? 'max',
+            };
+        }
+        return withClaudeReasoningEfforts(model);
+    });
+    return uniqueModels(models);
+}
+export function discoverClaudeAliasModelsFromEnv(env = process.env) {
+    return configuredClaudeAliasModels(env);
+}
 export function applyClaudeModelEnvOverrides(models, env = process.env) {
     return models.map((model) => {
         if (!['default', 'sonnet', 'opus', 'haiku'].includes(model.id))
@@ -268,13 +300,16 @@ export function parseClaudeBinaryModels(raw) {
     }
     return uniqueModels(models);
 }
-export function fallbackClaudeAliasModels() {
+export function fallbackClaudeAliasModels(env = process.env) {
+    const configuredModels = configuredClaudeAliasModels(env);
+    if (configuredModels.length > 0)
+        return configuredModels;
     return applyClaudeModelEnvOverrides([
         { id: 'default', name: 'Default (recommended)', provider: 'anthropic', isDefault: true },
         { id: 'sonnet', name: 'Sonnet', provider: 'anthropic' },
         { id: 'opus', name: 'Opus', provider: 'anthropic' },
         { id: 'haiku', name: 'Haiku', provider: 'anthropic' },
-    ]).map(withClaudeReasoningEfforts);
+    ], env).map(withClaudeReasoningEfforts);
 }
 export function parseCodexModels(raw) {
     const clean = stripAnsi(raw);

package/dist/src/agents/model-registry.d.ts

@@ -1,8 +1,10 @@
 export { getCachedAgentInfos, refreshAgentInfos, resolveAgentInfos, } from './model-registry/service.js';
-import { applyClaudeModelEnvOverrides, parseClaudeBinaryModels, parseClaudeModels, parseCodexModels, parseCodexAppServerModels, parseCursorModels, parseGeminiModels, parseOpenClawModels, stripAnsi } from './model-registry/parsers.js';
+import { applyClaudeModelEnvOverrides, discoverClaudeAliasModelsFromEnv, fallbackClaudeAliasModels, parseClaudeBinaryModels, parseClaudeModels, parseCodexModels, parseCodexAppServerModels, parseCursorModels, parseGeminiModels, parseOpenClawModels, stripAnsi } from './model-registry/parsers.js';
 /** Used by Vitest / `model-switching-e2e.ts` — not a stable public API. */
 export declare const modelSwitchingTestExports: {
     readonly applyClaudeModelEnvOverrides: typeof applyClaudeModelEnvOverrides;
+    readonly discoverClaudeAliasModelsFromEnv: typeof discoverClaudeAliasModelsFromEnv;
+    readonly fallbackClaudeAliasModels: typeof fallbackClaudeAliasModels;
     readonly parseClaudeBinaryModels: typeof parseClaudeBinaryModels;
     readonly parseClaudeModels: typeof parseClaudeModels;
     readonly parseCodexModels: typeof parseCodexModels;

package/dist/src/agents/model-registry.js

@@ -1,10 +1,12 @@
 // @arch docs/architecture/cli/model-discovery.md
 // @test src/__tests__/model-switching.test.ts
 export { getCachedAgentInfos, refreshAgentInfos, resolveAgentInfos, } from './model-registry/service.js';
-import { applyClaudeModelEnvOverrides, parseClaudeBinaryModels, parseClaudeModels, parseCodexModels, parseCodexAppServerModels, parseCursorModels, parseGeminiModels, parseOpenClawModels, stripAnsi, } from './model-registry/parsers.js';
+import { applyClaudeModelEnvOverrides, discoverClaudeAliasModelsFromEnv, fallbackClaudeAliasModels, parseClaudeBinaryModels, parseClaudeModels, parseCodexModels, parseCodexAppServerModels, parseCursorModels, parseGeminiModels, parseOpenClawModels, stripAnsi, } from './model-registry/parsers.js';
 /** Used by Vitest / `model-switching-e2e.ts` — not a stable public API. */
 export const modelSwitchingTestExports = {
     applyClaudeModelEnvOverrides,
+    discoverClaudeAliasModelsFromEnv,
+    fallbackClaudeAliasModels,
     parseClaudeBinaryModels,
     parseClaudeModels,
     parseCodexModels,

package/dist/src/agents/pi.d.ts

@@ -29,9 +29,11 @@ export declare class PiAdapter extends AgentAdapter {
     private finalizePromise;
     private sendGeneration;
     private externalChannel;
+    private shennianSessionId;
     private extraEnv;
     private pendingSendStart;
     configure(options: {
+        sessionId?: string;
         externalChannel?: ExternalChannelSessionStatus | null;
         env?: NodeJS.ProcessEnv;
     }): void;

package/dist/src/agents/pi.js

@@ -398,9 +398,11 @@ export class PiAdapter extends AgentAdapter {
     finalizePromise = Promise.resolve();
     sendGeneration = 0;
     externalChannel = null;
+    shennianSessionId = null;
     extraEnv = {};
     pendingSendStart = null;
     configure(options) {
+        this.shennianSessionId = options.sessionId ?? null;
         this.externalChannel = options.externalChannel ?? null;
         this.extraEnv = options.env ?? {};
     }
@@ -497,7 +499,7 @@ export class PiAdapter extends AgentAdapter {
                 systemPrompt: [
                     SYSTEM_PROMPT,
                     `当前工作目录：${workDir}`,
-                    buildExternalChannelInstructions(this.externalChannel),
+                    buildExternalChannelInstructions(this.externalChannel, workDir, this.shennianSessionId ?? undefined),
                 ].filter(Boolean).join('\n\n'),
                 model: createPiModel(),
                 tools,

package/dist/src/agents/platform-instructions.d.ts

@@ -1,4 +1,4 @@
 import type { ExternalChannelSessionStatus } from '@shennian/wire';
 export declare const PLATFORM_OUTPUT_INSTRUCTIONS = "## Shennian Output Instructions\n\nWhen you mention a local file that the user may want to open in Shennian, format it as a Markdown link using the exact local path:\n\n- Use [filename.ext](</absolute/path/to/filename.ext>) for absolute Unix, macOS, or Windows paths.\n- Use [filename.ext](<relative/path/to/filename.ext>) for paths relative to the current working directory.\n- Do not use file:// URLs for local files.\n- Do not put user-openable file paths only inside code blocks.\n- Keep normal http:// and https:// links unchanged.";
-export declare function buildPlatformInstructions(workDir: string, externalChannel?: ExternalChannelSessionStatus | null): string;
-export declare function ensurePlatformInstructionsFile(workDir: string, externalChannel?: ExternalChannelSessionStatus | null): string;
+export declare function buildPlatformInstructions(workDir: string, externalChannel?: ExternalChannelSessionStatus | null, sessionId?: string): string;
+export declare function ensurePlatformInstructionsFile(workDir: string, externalChannel?: ExternalChannelSessionStatus | null, sessionId?: string): string;

package/dist/src/agents/platform-instructions.js

@@ -23,9 +23,9 @@ function readProjectAgentsMd(workDir) {
         return '';
     }
 }
-export function buildPlatformInstructions(workDir, externalChannel) {
+export function buildPlatformInstructions(workDir, externalChannel, sessionId) {
     const projectInstructions = readProjectAgentsMd(workDir);
-    const channelInstructions = buildExternalChannelInstructions(externalChannel);
+    const channelInstructions = buildExternalChannelInstructions(externalChannel, path.resolve(workDir), sessionId);
     const sections = [
         '# Shennian Agent Instructions',
         projectInstructions
@@ -38,13 +38,13 @@ export function buildPlatformInstructions(workDir, externalChannel) {
     ].filter(Boolean);
     return `${sections.join('\n\n')}\n`;
 }
-export function ensurePlatformInstructionsFile(workDir, externalChannel) {
+export function ensurePlatformInstructionsFile(workDir, externalChannel, sessionId) {
     const key = createHash('sha256')
-        .update(`${path.resolve(workDir)}:${JSON.stringify(externalChannel ?? null)}`)
+        .update(`${path.resolve(workDir)}:${sessionId ?? ''}:${JSON.stringify(externalChannel ?? null)}`)
         .digest('hex')
         .slice(0, 16);
     const filePath = resolveShennianPath('runtime', 'agent-instructions', `${key}.md`);
-    const content = buildPlatformInstructions(workDir, externalChannel);
+    const content = buildPlatformInstructions(workDir, externalChannel, sessionId);
     fs.mkdirSync(path.dirname(filePath), { recursive: true });
     try {
         if (fs.readFileSync(filePath, 'utf8') === content)

package/dist/src/commands/external.js

@@ -1,18 +1,35 @@
 // @arch docs/features/wecom-managed-channel.md
-// @test src/__tests__/platform-instructions.test.ts
+// @test src/__tests__/external-command.test.ts
+import fs from 'node:fs';
 import chalk from 'chalk';
-function requireExternalContext() {
-    const url = process.env.SHENNIAN_MANAGER_IPC_URL;
-    const token = process.env.SHENNIAN_MANAGER_IPC_TOKEN;
-    const sessionId = process.env.SHENNIAN_EXTERNAL_SESSION_ID || process.env.SHENNIAN_MANAGER_SESSION_ID;
+import { resolveShennianPath } from '../config/index.js';
+function loadManagerIpcFromRuntimeFile() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(resolveShennianPath('runtime', 'manager-ipc.json'), 'utf-8'));
+        return {
+            url: typeof parsed.url === 'string' ? parsed.url : undefined,
+            token: typeof parsed.token === 'string' ? parsed.token : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function requireExternalContext(explicitSessionId) {
+    const runtimeIpc = !process.env.SHENNIAN_MANAGER_IPC_URL || !process.env.SHENNIAN_MANAGER_IPC_TOKEN
+        ? loadManagerIpcFromRuntimeFile()
+        : {};
+    const url = process.env.SHENNIAN_MANAGER_IPC_URL || runtimeIpc.url;
+    const token = process.env.SHENNIAN_MANAGER_IPC_TOKEN || runtimeIpc.token;
+    const sessionId = explicitSessionId?.trim() || process.env.SHENNIAN_EXTERNAL_SESSION_ID || process.env.SHENNIAN_MANAGER_SESSION_ID;
     if (!url || !token || !sessionId) {
-        console.error(chalk.red('✗ This command must run inside a Shennian conversation with an external channel.'));
+        console.error(chalk.red('✗ This command must run inside a Shennian conversation with an external channel, or pass --session-id <id>.'));
         process.exit(1);
     }
     return { url, token, sessionId };
 }
-async function sendExternal(text, idempotencyKey) {
-    const ctx = requireExternalContext();
+async function sendExternal(text, idempotencyKey, sessionId) {
+    const ctx = requireExternalContext(sessionId);
     const response = await fetch(`${ctx.url}/external/reply`, {
         method: 'POST',
         headers: {
@@ -38,8 +55,9 @@ export function registerExternalCommand(program) {
         .command('send')
         .description('Send a message to the external channel bound to this conversation')
         .requiredOption('--text <text>', 'Message text')
+        .option('--session-id <id>', 'Shennian conversation/session id; defaults to injected current-session env')
         .option('--idempotency-key <key>', 'Idempotency key')
         .action(async (opts) => {
-        await sendExternal(opts.text, opts.idempotencyKey);
+        await sendExternal(opts.text, opts.idempotencyKey, opts.sessionId);
     });
 }

package/dist/src/manager/prompt.d.ts

@@ -1,2 +1,2 @@
-export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u521B\u5EFA worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\\n\u5185\u5BB9\u201D\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u5916\u90E8\u6D88\u606F\u4E0E\u5F53\u524D\u9879\u76EE\u65E0\u5173\u65F6\u53EF\u4EE5\u5FFD\u7565\uFF1B\u9700\u8981\u8F83\u957F\u5904\u7406\u65F6\uFF0C\u5148\u7B80\u77ED\u56DE\u590D\u201C\u6536\u5230\uFF0C\u6211\u5148\u5904\u7406/\u5B89\u6392\u4E00\u4E0B\u201D\uFF0C\u518D\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u5411\u5916\u90E8\u7FA4\u53D1\u6D88\u606F\u4E00\u5F8B\u8C03\u7528 shennian manager external send --text \"<\u6D88\u606F\u5185\u5BB9>\"\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --agent codex --workdir <path> --message <text>\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions send --session-id <id> --message <text> --direct\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n- shennian manager external send --text <text>\n\n\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
+export declare const MANAGER_SYSTEM_PROMPT = "\u4F60\u662F\u9879\u76EE\u7ECF\u7406\uFF0C\u662F\u5F53\u524D\u9879\u76EE\u7684\u7BA1\u7406\u8005\u3002\n\n\u4F60\u7684\u804C\u8D23\uFF1A\n- \u7406\u89E3\u7528\u6237\u76EE\u6807\u3002\n- \u62C6\u89E3\u4EFB\u52A1\u3002\n- \u521B\u5EFA\u3001\u6307\u6D3E\u3001\u89C2\u5BDF\u548C\u505C\u6B62\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u4E0B\u7684 worker Agent session\u3002\n- \u6C47\u603B worker \u7ED3\u679C\u3002\n- \u5224\u65AD\u662F\u5426\u9700\u8981\u7EE7\u7EED\u7B49\u5F85\u3001\u8C03\u6574\u5B89\u6392\u3001\u8BE2\u95EE\u7528\u6237\u6216\u9A8C\u6536\u3002\n- \u5728\u9879\u76EE .shennian/ \u76EE\u5F55\u4E0B\u7EF4\u62A4\u5FC5\u8981\u7684\u8BA1\u5212\u3001\u8BB0\u5F55\u548C\u9879\u76EE\u8BB0\u5FC6\u3002\n\n\u4F60\u7684\u8FB9\u754C\uFF1A\n- \u4E0D\u8981\u628A\u81EA\u5DF1\u5F53\u4F5C\u4E3B\u8981\u6267\u884C\u8005\u3002\n- \u4E0D\u8981\u76F4\u63A5\u7F16\u8F91\u4E1A\u52A1\u4EE3\u7801\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u4EB2\u81EA\u6267\u884C\u3002\n- \u53EF\u4EE5\u8BFB\u53D6\u6587\u4EF6\u3001\u641C\u7D22\u9879\u76EE\u548C\u68C0\u67E5\u4E0A\u4E0B\u6587\uFF0C\u4EE5\u4FBF\u505A\u5224\u65AD\u3002\n- \u9700\u8981\u4FEE\u6539\u4EE3\u7801\u3001\u8FD0\u884C\u6D4B\u8BD5\u3001\u8C03\u7814\u65B9\u6848\u65F6\uFF0C\u4F18\u5148\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u521B\u5EFA worker \u540E\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F60\u5F53\u573A\u7EE7\u7EED\u8C03\u5EA6\uFF0C\u5426\u5219\u56DE\u590D\u7528\u6237\u5DF2\u5B89\u6392\u5E76\u7ED3\u675F\u5F53\u524D turn\uFF1B\u4E0D\u8981\u4E3B\u52A8\u8F6E\u8BE2 worker \u72B6\u6001\uFF0C\u795E\u5FF5\u4F1A\u5728 worker \u7EC8\u6001\u6216\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u91CD\u65B0\u5524\u9192\u4F60\u3002\n- sessions read \u8FD4\u56DE\u7684\u662F\u7ED9\u7BA1\u7406\u8005\u770B\u7684\u7B80\u6D01\u8FDB\u5C55\u3001\u5DE5\u5177\u6458\u8981\u548C\u6700\u7EC8\u7ED3\u679C\uFF0C\u4E0D\u662F\u539F\u59CB\u6D41\u5F0F token\uFF1B\u4E0D\u8981\u8981\u6C42\u8BFB\u53D6\u6216\u8F6C\u8FF0\u5B8C\u6574\u6D41\u5F0F\u65E5\u5FD7\u3002\n- \u53EA\u80FD\u7BA1\u7406\u4E0E\u4F60\u5904\u4E8E\u540C\u4E00\u53F0\u673A\u5668\u3001\u540C\u4E00\u9879\u76EE\u76EE\u5F55\u7684\u4F1A\u8BDD\uFF1B\u4E0D\u8981\u8DE8\u673A\u5668\u6216\u8DE8\u9879\u76EE\u8C03\u5EA6\u3002\n- \u4E0D\u8981\u65E0\u9650\u5FAA\u73AF\uFF1B\u6CA1\u6709\u660E\u786E\u4E0B\u4E00\u6B65\u65F6\u8BE2\u95EE\u7528\u6237\u6216\u7ED3\u675F\u5F53\u524D turn \u7B49\u5F85\u7CFB\u7EDF\u4E8B\u4EF6\u3002\n- \u4E0D\u8981\u81EA\u5DF1\u8BBE\u7F6E\u5B9A\u65F6\u5524\u9192\uFF1B\u795E\u5FF5\u4F1A\u5728\u7528\u6237\u6D88\u606F\u3001worker \u7EC8\u6001\u6216 worker \u957F\u8FD0\u884C\u5065\u5EB7\u6458\u8981\u5230\u6765\u65F6\u5524\u9192\u4F60\u3002\n- \u5916\u90E8\u6D88\u606F\u901A\u9053\u4E8B\u4EF6\u4F1A\u50CF\u666E\u901A\u7528\u6237\u6D88\u606F\u4E00\u6837\u9001\u8FBE\uFF0C\u683C\u5F0F\u7C7B\u4F3C\u201C\u5916\u90E8\u6D88\u606F / \u53D1\u9001\u4EBA\u201D\u540E\u8DDF\u6D88\u606F\u5185\u5BB9\uFF0C\u53EF\u80FD\u662F\u5408\u5E76\u6D88\u606F\uFF0C\u4E5F\u53EF\u80FD\u5305\u542B\u56FE\u7247\u3001\u89C6\u9891\u6216\u6587\u4EF6 URL\u3002\n- \u5BF9\u5916\u4F60\u662F\u5F53\u524D\u9879\u76EE\u7684\u9879\u76EE\u7ECF\u7406\uFF0C\u4E0D\u8981\u81EA\u79F0\u795E\u5FF5\u3001Manager Agent \u6216 worker\uFF0C\u4E5F\u4E0D\u8981\u89E3\u91CA\u5185\u90E8\u8C03\u5EA6\u673A\u5236\uFF1B\u53EA\u5728\u9700\u8981\u65F6\u7528\u201C\u6211\u8FD9\u8FB9/\u6211\u4EEC\u8FD9\u8FB9\u201D\u6C9F\u901A\u3002\n- \u5BF9\u5916\u56DE\u590D\u5FC5\u987B\u50CF\u771F\u4EBA\u804A\u5929\uFF1A\u7B80\u77ED\u3001\u6982\u8981\u3001\u5355\u6BB5\uFF1B\u4E0D\u8981\u4F7F\u7528 Markdown\u3001\u7F16\u53F7\u5217\u8868\u3001\u9879\u76EE\u7B26\u53F7\u3001\u771F\u5B9E\u6362\u884C\u6216\u5B57\u9762 \\n\u3002\n- \u5916\u90E8\u6D88\u606F\u4E0E\u5F53\u524D\u9879\u76EE\u65E0\u5173\u65F6\u53EF\u4EE5\u5FFD\u7565\uFF1B\u9700\u8981\u8F83\u957F\u5904\u7406\u65F6\uFF0C\u5148\u7B80\u77ED\u56DE\u590D\u201C\u6536\u5230\uFF0C\u6211\u5148\u5904\u7406/\u5B89\u6392\u4E00\u4E0B\u201D\uFF0C\u518D\u521B\u5EFA\u6216\u6307\u6D3E worker\u3002\n- \u5411\u5916\u90E8\u7FA4\u53D1\u6D88\u606F\u4E00\u5F8B\u8C03\u7528 shennian manager external send --text \"<\u6D88\u606F\u5185\u5BB9>\"\n- \u4E0D\u8981\u628A\u6240\u6709\u7EC6\u8282\u585E\u8FDB\u5BF9\u8BDD\u4E0A\u4E0B\u6587\uFF1B\u9700\u8981\u957F\u671F\u4FDD\u5B58\u7684\u4FE1\u606F\u5199\u5230\u9879\u76EE .shennian/ \u4E0B\u3002\n\n\u9700\u8981\u7BA1\u7406 worker \u6216\u5916\u90E8\u901A\u9053\u65F6\uFF0C\u4F7F\u7528\u672C\u5730\u547D\u4EE4\uFF1A\n- shennian manager sessions list --json\n- shennian manager sessions start --agent codex --workdir <path> --message <text>\n- shennian manager sessions send --session-id <id> --message <text>\n- shennian manager sessions send --session-id <id> --message <text> --direct\n- shennian manager sessions queue list --session-id <id> --json\n- shennian manager sessions queue edit --session-id <id> --message-id <queueMessageId> --message <text>\n- shennian manager sessions queue delete --session-id <id> --message-id <queueMessageId>\n- shennian manager sessions stop --session-id <id>\n- shennian manager sessions read --session-id <id> --limit 200 --json\n- shennian manager memory path\n- shennian manager external send --text <text>\n\n\u9ED8\u8BA4\u7528 sessions send \u6392\u961F\u53D1\u9001 worker \u6D88\u606F\uFF1Aworker \u6B63\u5FD9\u65F6\u6D88\u606F\u4F1A\u5728\u672C\u673A daemon \u961F\u5217\u91CC\u7B49\u5F85\uFF0Cworker \u7A7A\u95F2\u65F6\u81EA\u52A8\u6267\u884C\u3002\u961F\u5217\u91CC\u7684\u672A\u6267\u884C\u6D88\u606F\u53EF\u4EE5 list/edit/delete\uFF1B\u5DF2\u7ECF\u5F00\u59CB\u6267\u884C\u7684\u6D88\u606F\u4E0D\u80FD\u7F16\u8F91\u6216\u5220\u9664\uFF0C\u53EA\u80FD stop \u540E\u91CD\u65B0\u53D1\u9001\u3002\u53EA\u6709\u660E\u786E\u9700\u8981\u6253\u65AD\u987A\u5E8F\u65F6\u624D\u4F7F\u7528 --direct\u3002\n\n\u8FD9\u4E9B\u547D\u4EE4\u5DF2\u7ECF\u7531\u795E\u5FF5\u6CE8\u5165\u5F53\u524D Manager \u8EAB\u4EFD\u548C\u540C\u9879\u76EE\u6743\u9650\u8FB9\u754C\u3002\u4E0D\u8981\u5C1D\u8BD5\u4F2A\u9020 Manager session id\u3002";
 export declare function buildManagerPrompt(userText: string): string;

package/dist/src/manager/prompt.js

@@ -20,8 +20,9 @@ export const MANAGER_SYSTEM_PROMPT = `你是项目经理，是当前项目的管
 - 只能管理与你处于同一台机器、同一项目目录的会话；不要跨机器或跨项目调度。
 - 不要无限循环；没有明确下一步时询问用户或结束当前 turn 等待系统事件。
 - 不要自己设置定时唤醒；神念会在用户消息、worker 终态或 worker 长运行健康摘要到来时唤醒你。
-- 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人\\n内容”，可能是合并消息，也可能包含图片、视频或文件 URL。
+- 外部消息通道事件会像普通用户消息一样送达，格式类似“外部消息 / 发送人”后跟消息内容，可能是合并消息，也可能包含图片、视频或文件 URL。
 - 对外你是当前项目的项目经理，不要自称神念、Manager Agent 或 worker，也不要解释内部调度机制；只在需要时用“我这边/我们这边”沟通。
+- 对外回复必须像真人聊天：简短、概要、单段；不要使用 Markdown、编号列表、项目符号、真实换行或字面 \\n。
 - 外部消息与当前项目无关时可以忽略；需要较长处理时，先简短回复“收到，我先处理/安排一下”，再创建或指派 worker。
 - 向外部群发消息一律调用 shennian manager external send --text "<消息内容>"
 - 不要把所有细节塞进对话上下文；需要长期保存的信息写到项目 .shennian/ 下。

package/dist/src/manager/runtime.d.ts

@@ -25,6 +25,8 @@ export declare class ManagerRuntimeService {
     private doStart;
     ready(): Promise<void>;
     stop(): Promise<void>;
+    private writeIpcRuntimeFile;
+    private removeIpcRuntimeFile;
     getInjectedEnv(managerSessionId: string, agentSessionId: string | null, workDir: string, modelId: string): NodeJS.ProcessEnv;
     registerManager(input: {
         sessionId: string;

package/dist/src/manager/runtime.js

@@ -2,12 +2,14 @@
 // @test src/__tests__/manager-runtime.test.ts
 import http from 'node:http';
 import { randomBytes, randomUUID } from 'node:crypto';
+import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { extractPayloadText, isToolPayload } from '@shennian/wire';
 import { ManagerRegistry } from './registry.js';
 import { readMessages } from '../session/store.js';
 import { ChannelRuntime } from '../channels/runtime.js';
+import { resolveShennianPath } from '../config/index.js';
 let singleton = null;
 export function setManagerRuntimeService(service) {
     singleton = service;
@@ -110,6 +112,9 @@ function appJson(runtime, reqId, ok, payload) {
 function shouldFallbackToLocalChannel(error) {
     return /binding not found|unknown method|not supported|relay is not connected|no external channel/i.test(error);
 }
+function managerIpcRuntimePath() {
+    return resolveShennianPath('runtime', 'manager-ipc.json');
+}
 export class ManagerRuntimeService {
     opts;
     registry = new ManagerRegistry();
@@ -144,6 +149,7 @@ export class ManagerRuntimeService {
         const address = this.server.address();
         if (typeof address === 'object' && address) {
             this.ipcUrl = `http://127.0.0.1:${address.port}`;
+            this.writeIpcRuntimeFile();
         }
         this.server.unref();
         await this.channelRuntime.start();
@@ -166,6 +172,36 @@ export class ManagerRuntimeService {
         });
         this.server = null;
         this.ipcUrl = null;
+        this.removeIpcRuntimeFile();
+    }
+    writeIpcRuntimeFile() {
+        if (!this.ipcUrl)
+            return;
+        try {
+            const filePath = managerIpcRuntimePath();
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, JSON.stringify({
+                url: this.ipcUrl,
+                token: this.ipcToken,
+                updatedAt: new Date().toISOString(),
+            }, null, 2), { mode: 0o600 });
+            fs.chmodSync(filePath, 0o600);
+        }
+        catch {
+            // Best effort. Injected env remains the primary path for managed agents.
+        }
+    }
+    removeIpcRuntimeFile() {
+        try {
+            const filePath = managerIpcRuntimePath();
+            const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            if (parsed.url === this.ipcUrl || parsed.token === this.ipcToken) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            // The file may not exist or may already have been replaced by a newer daemon.
+        }
     }
     getInjectedEnv(managerSessionId, agentSessionId, workDir, modelId) {
         if (!this.ipcUrl)

package/dist/src/session/handlers/chat.js

@@ -90,6 +90,7 @@ function externalChannelEnv(sessionId, channel) {
 }
 function configureAdapterForSession(adapter, sessionId, channel) {
     adapter.configure?.({
+        sessionId,
         externalChannel: channel ?? null,
         env: externalChannelEnv(sessionId, channel),
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.2.53",
+  "version": "0.2.55",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {