scream-code 0.19.3 → 0.19.6

package/dist/main.mjs

@@ -6,7 +6,7 @@ const __dirname = __cjsShimDirname(__filename);
 import "./suppress-sqlite-warning-C2VB0doZ.mjs";
 //#region src/main.ts
 try {
-	(await import("./app-NpW56jQ9.mjs")).main();
+	(await import("./app-CE9aji1S.mjs")).main();
 } catch (error) {
 	process.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
 	process.exit(1);

package/dist/{text-input-dialog-yvsx17gg.mjs → text-input-dialog-BqMy3ifH.mjs}

@@ -8,8 +8,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { arch, hostname, release, type } from "node:os";
 import { execFileSync } from "node:child_process";
-import chalk from "chalk";
 import { Container, Input, Key, matchesKey, truncateToWidth, visibleWidth } from "@liutod-scream/pi-tui";
+import chalk from "chalk";
 //#region ../../packages/config/src/identity.ts
 /**
 * Scream host and device identity header factories.
@@ -140,6 +140,7 @@ const dictionaries = {
 		"status.cron_fired_coalesced": "⏰ 定时任务已触发（合并 {count} 次）：{preview}",
 		"status.cron_once": "⏰ 一次性提醒已触发：{preview}",
 		"status.cron_stale": "⚠️ 定时任务已过期，仍触发：{preview}",
+		"status.cron_empty": "⚠️ 定时任务执行结束但没有输出：{preview}",
 		"status.reconnecting_detail": "⚠️ 重连中 {attempt}/{max}：{reason} · {delay}s",
 		"status.reason_rate_limit": "限流",
 		"status.reason_server": "服务器错误",
@@ -756,10 +757,11 @@ const dictionaries = {
 		"memory.detail_nav_hint": "  Enter/Esc 返回  |  i 注入  |  d 删除  |  e 编辑",
 		"plugin.no_session": "请先创建或恢复一个会话，再使用 Plugin 中心。",
 		"extension.no_session": "请先创建或恢复一个会话，再使用扩展命令。",
-		"extension.usage": "用法：/extension activate|deactivate|status [pluginId]",
+		"extension.usage": "用法：/extension activate|deactivate|reload|status [pluginId]",
 		"extension.missing_id": "缺少扩展 id：/extension {action} <pluginId>",
 		"extension.activated": "扩展 {pluginId} 已激活。",
 		"extension.deactivated": "扩展 {pluginId} 已停用。",
+		"extension.reloaded": "扩展 {pluginId} 已重新加载。",
 		"extension.no_extensions": "没有安装代码插件（entryPoint）。",
 		"plugin.loading": "正在加载 Plugin 中心…",
 		"plugin.center_title": "Plugin 中心",
@@ -1361,6 +1363,9 @@ const dictionaries = {
 		"cron.kind_recurring": "重复",
 		"cron.kind_once": "一次性",
 		"cron.stale": "已过期",
+		"cron.silent": "静默",
+		"cron.mute": "静音",
+		"cron.last_error": "上次失败：{error}",
 		"cron.sched_5m": "每 5 分钟",
 		"cron.sched_hourly": "每小时",
 		"cron.sched_daily9": "每天 09:00",
@@ -1517,6 +1522,7 @@ const dictionaries = {
 		"status.cron_fired_coalesced": "⏰ Scheduled task fired ({count} runs merged): {preview}",
 		"status.cron_once": "⏰ One-time reminder fired: {preview}",
 		"status.cron_stale": "⚠️ Scheduled task expired, fired anyway: {preview}",
+		"status.cron_empty": "⚠️ Scheduled task finished with no output: {preview}",
 		"status.reconnecting_detail": "⚠️ Reconnecting {attempt}/{max}: {reason} · {delay}s",
 		"status.reason_rate_limit": "rate limited",
 		"status.reason_server": "server error",
@@ -2133,10 +2139,11 @@ const dictionaries = {
 		"memory.detail_nav_hint": "  Enter/Esc Back  |  i Inject  |  d Delete  |  e Edit",
 		"plugin.no_session": "Please create or resume a session before using the Plugin center.",
 		"extension.no_session": "Please create or resume a session before using extension commands.",
-		"extension.usage": "Usage: /extension activate|deactivate|status [pluginId]",
+		"extension.usage": "Usage: /extension activate|deactivate|reload|status [pluginId]",
 		"extension.missing_id": "Missing plugin id: /extension {action} <pluginId>",
 		"extension.activated": "Extension {pluginId} activated.",
 		"extension.deactivated": "Extension {pluginId} deactivated.",
+		"extension.reloaded": "Extension {pluginId} reloaded.",
 		"extension.no_extensions": "No code extensions (entryPoint) installed.",
 		"plugin.loading": "Loading Plugin center…",
 		"plugin.center_title": "Plugin Center",
@@ -2738,6 +2745,9 @@ const dictionaries = {
 		"cron.kind_recurring": "repeats",
 		"cron.kind_once": "one-shot",
 		"cron.stale": "expired",
+		"cron.silent": "silent",
+		"cron.mute": "muted",
+		"cron.last_error": "last failed: {error}",
 		"cron.sched_5m": "Every 5 minutes",
 		"cron.sched_hourly": "Hourly",
 		"cron.sched_daily9": "Daily at 09:00",

package/dist/{text-input-dialog-CD4xCwLd.mjs → text-input-dialog-CbYhsAbz.mjs}

@@ -3,5 +3,5 @@ import { fileURLToPath as __cjsShimFileURLToPath } from 'node:url';
 import { dirname as __cjsShimDirname } from 'node:path';
 const __filename = __cjsShimFileURLToPath(import.meta.url);
 const __dirname = __cjsShimDirname(__filename);
-import { t as TextInputDialogComponent } from "./text-input-dialog-yvsx17gg.mjs";
+import { t as TextInputDialogComponent } from "./text-input-dialog-BqMy3ifH.mjs";
 export { TextInputDialogComponent };

package/docs/line.md

@@ -104,11 +104,20 @@
 | `/status` | 当前模型、权限/计划/群狼/RLM 模式、上下文占用与思考级别 |
 | `/model <名称>` | 切换模型；不带参数显示当前模型 |
 | `/compact` | 压缩上下文 |
+| `/stop` | 停止**正在运行**的那一轮，并丢弃该聊天还在排队的消息（IM 版的 ESC；忙时也可用），回执「已停止当前任务。」；若 10 秒内停不下来（工具挂死），会关闭在线会话，下一条消息自动恢复同一会话 |
+| `/cancel` | 停止并开启新会话（等价 `/stop` + `/new`，忙时也可用） |
+| `/cron` | 查看本聊天的定时任务（含「静默/静音」标记与「上次失败」）；`/cron add [--silent\|--mute] <分 时 日 月 周> <要做的事>` 新建；`/cron rm <id>` 删除 |
+
+- `--silent`：触发时不发「⏰ 已触发」，只发结果；`--mute`：什么都不发（纯后台维护任务）。模型侧 `CronCreate` 对应参数 `silent` / `mute`。
+- 任务失败会在 `/cron` 列表里留一行「上次失败：…」，下次成功自动清除。
 | `/new` | 丢弃当前会话，下条消息开新会话 |
 | `/help` | 命令列表（含自定义命令） |
 | `/自定义` | 你自己在配置里定义的命令（`prompt` 型或 `exec` 型） |
 
-- 有任务正在处理时，`/model`、`/compact`、`/new` 会回复「请等这一轮结束」，避免与运行中的回合争用。
+- 有任务正在处理时，`/model`、`/compact`、`/new` 会回复「请等这一轮结束（回复 /stop 可中止）」，避免与运行中的回合争用；`/stop` 本身**不受忙限制**。
+- 消息排在别人后面时，会立刻回一条 `收到，前面还有 N 条在处理中。回复 /stop 可中止当前任务。`——不再静默排队。
+- **定时任务现在能回到聊天**：`cron.fired` 在会话里触发后，守护进程会先发一行 `⏰ 定时任务已触发：…`，等这一轮跑完再把最终内容发到该聊天。投递靠入站时缓存的聊天目标（飞书 chat id / 微信 peer + context_token），因此**微信在守护进程重启后、你再次发消息之前无法主动推送**（与平台限制一致，日志会提示）。触发时若正有你的回合在跑，结果并入那一轮回复，不会重复推送。
+- `/status` 末尾会带上启动时的语音能力探测结果（ffmpeg / AMR-NB 编码器是否可用），缺编码器意味着语音会降级成文件。
 - **自定义命令**：配置项的 `commands` 数组里定义，`prompt` 型会把模板（`{args}` 会被替换，无占位符则把参数附在末尾）作为一轮输入发给模型；`exec` 型在守护进程里执行 shell（macOS/Linux 为 `/bin/sh -c`，Windows 为 `%ComSpec% /d /s /c`；30 s 超时、输出截断 8 KiB、参数通过 `LINE_ARGS` 环境变量传递、`work_dir` 必须位于工作目录内）。Windows 上出于命令注入安全考虑**不支持 `{args}` 占位符**，请在脚本里读 `%LINE_ARGS%`。命令名不能与内置命令重名、不能重复。
 - **未识别的命令照常发给模型**；需要界面交互的命令（`/theme`、`/line` 向导、无参 `/model` 选择器、`/sessions`）会提示「需要桌面端」。
 

package/docs/plugins.md

@@ -0,0 +1,183 @@
+# Plugins — 给自己写插件
+
+Scream 可以给自己写插件：遇到技能和 MCP 都覆盖不了的需求时，直接产出一个代码插件。
+
+插件能贡献四类能力：技能（提示词）、MCP server、shell hooks、以及在进程内运行的工具代码。注册后技能立即生效；MCP server 与 hooks 随激活启动，**代码只在 `activate` 时执行**。
+
+## 快速开始
+
+**先征得同意**：动手写之前用 `AskUserQuestion` 问一句（"要不要我做一个插件来完成这个？"）。审批弹窗在 auto/yolo 下不会出现，所以 yolo 里问句是唯一还会出现的同意步骤（与 `/make-skill` 的确认方式一致）。auto 模式连问句也被禁（`AutoModeAskUserQuestionDenyPermissionPolicy`），因此自产插件属于交互模式的用法，无人值守场景请显式 `install`。manual 模式下 `register_generated` 仍会单独弹一次审批。
+
+目录约定 `<scream home>/plugins/generated/<id>/`（`<scream home>` 默认 `~/.scream-code`）。放在别处的目录也能注册，但任何目录都不会被自动扫描——注册必须显式发生。
+
+`scream.plugin.json` 最小内容：
+
+```json
+{
+  "name": "text-stats",
+  "version": "0.1.0",
+  "description": "Count lines and characters in a file",
+  "entryPoint": "./index.mjs"
+}
+```
+
+入口 `index.mjs` 最小内容：
+
+```js
+import { readFile } from 'node:fs/promises';
+
+export async function activate(context) {
+  context.services.tools.registerUserTool({
+    name: 'text_stats',
+    description: 'Count lines and characters in a file',
+    parameters: {
+      type: 'object',
+      properties: { path: { type: 'string' } },
+      required: ['path'],
+    },
+    execute: async (args) => {
+      const text = await readFile(String(args.path), 'utf8');
+      return { output: `lines=${text.split('\n').length} chars=${text.length}` };
+    },
+  });
+}
+```
+
+两步启用：
+
+1. `ManagePlugin { "action": "register_generated", "source": "<插件目录的绝对路径>" }` —— 登记目录、热应用技能，**不 import 入口**。
+2. `ManagePlugin { "action": "activate", "id": "text-stats" }` —— 单独审批后 import 入口并执行 `activate`，工具此刻才对模型可见。
+
+## 清单字段
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `name` | 是 | 插件 id，须匹配 `^[a-z0-9][a-z0-9_-]{0,63}$` |
+| `version` | 否 | 版本字符串，仅用于展示与检查 |
+| `description` | 否 | 一句话说明 |
+| `skills` | 否 | 技能目录，字符串或字符串数组；每项必须以 `./` 开头且位于插件目录内 |
+| `mcpServers` | 否 | MCP server 配置对象，key 为 server 名；注册不会拉起进程，随 `activate` / `enable` 启动 |
+| `hooks` | 否 | HookDef 数组（`event` / `command` / `matcher` / `timeout`），激活时注入、停用时移除 |
+| `config` | 否 | 任意 JSON 对象，原样作为 `context.config` 交给入口模块 |
+| `entryPoint` | 否 | 代码入口；必须 `./` 开头，且 realpath 后仍位于插件目录内。不满足时清单层丢弃该字段并留下诊断，`register_generated` 会据此报 `entry_point_rejected`，不会静默降级 |
+
+`entryPoint` 指向的文件必须存在：`register_generated` 在登记前会 stat 该路径，缺失时返回 `entry_file_missing`，不会留下半登记记录。
+
+## 入口模块契约
+
+```js
+export async function activate(context) {}
+
+export async function deactivate() {}
+```
+
+- 必须是 ESM。也接受 `export default { activate, deactivate }` 的写法（运行时统一经 `normalizeExtensionModule` 归一化）。
+- `activate(context)` 必须导出；`deactivate()` 可选，且不接收参数——需要清理的东西在 `activate` 里捕获到模块作用域。
+- `activate` 抛错时，本次激活完成一半的 hooks 与事件订阅会被回滚，错误写入插件记录并返回 `activation_failed`。
+- 同一个进程内同一插件不能重复激活；重新激活前先 `deactivate`。
+
+## context API
+
+| 成员 | 说明 |
+|---|---|
+| `pluginId` | 当前插件 id |
+| `config` | 清单 `config` 块；未声明时为 `undefined` |
+| `services.tools.registerUserTool(input)` | 注册进程内工具，立即对当前 agent 可见 |
+| `services.tools.unregisterUserTool(name)` | 注销自己注册的工具 |
+| `services.tools.unregisterToolsByOwner(id)` | 按 owner 批量注销；宿主在停用时也会自动执行 |
+| `events.subscribe(type \| '*', handler)` | 订阅 agent 事件，返回 `unsubscribe`；`deactivate` 时宿主也会统一释放 |
+| `services` | agent 的子系统清单；只应调用这里列出的工具相关成员 |
+
+`registerUserTool` 的入参：
+
+| 字段 | 说明 |
+|---|---|
+| `name` | 工具名，全局唯一 |
+| `description` | 给模型看的一句话说明 |
+| `parameters` | JSON Schema 对象（`type: "object"` 及 `properties` / `required`） |
+| `execute(args, ctx)` | 返回 `{ output, message?, isError? }` 或 Promise；`output` 是模型看到的内容，`message` 只给 UI |
+
+运行时会给注册自动打上 `ownerPluginId`，因此停用、移除、熔断都能精确回收该插件的工具；插件自己声明的 owner 优先。`execute` 抛错会被转成工具错误，不会打断 agent loop，但会计入熔断计数。
+
+## 迭代
+
+改完入口文件后执行 `/extension reload <id>`（等价于 `deactivate` + `activate`），或者在会话里用 `ManagePlugin` 先 `deactivate` 再 `activate`。
+
+注意区分两个动作：`ManagePlugin {action:"reload"}` 只是**重读插件表**，不会重新 import；要重新 import 改过的入口文件，用 `/extension reload <id>` 或 `ManagePlugin {action:"reload_code", id:"<id>"}`。
+
+只调用 `activate` 不会加载新代码：模块按入口路径缓存，`deactivate` 会丢掉该缓存并让下一次 import 走新的 specifier，重新激活才读到新文件。激活失败、import 失败同样会让缓存失效，所以「改错 → 报错 → 改对 → reload」是可行的。
+
+## 已知限制
+
+- **重启进程后需要重新激活**：插件记录仍在插件中心（`/plugin`、`ManagePlugin list` 可见），但激活态只存在于进程内。
+- **激活绑定当前会话的 main agent**：工具注册在那一个 agent 上。同一进程里的另一个会话可能看到 `●` 状态，但拿不到这个工具。
+- **熔断分两种，恢复方式不同**：
+  - **工具连续失败 3 次**：持久禁用（写进插件记录），`check` 的 `circuit` 能看到计数，`ManagePlugin { "action": "reset", "id": "<id>" }` 清除并重新启用。
+  - **事件 handler 连续抛错 3 次**：只在**当前进程内**停用，不改插件记录，`check.circuit` 也不会显示；修好 handler 后重新 `activate` 即可。
+- **`reload` 只重新 import 入口模块**：入口用 `import './lib.mjs'` 引的其它文件仍走进程缓存，多文件插件改完辅助文件不会生效（改放进入口，或重启进程）。
+- **每次 reload 都会在进程里留下一份旧模块实例**：这是「改了立刻生效」的代价，量级等于编辑次数，不影响正确性。
+- 没有目录扫描或自动发现：新插件必须显式 `register_generated` / `install`。
+
+## 完整示例：text-stats
+
+`scream.plugin.json`：
+
+```json
+{
+  "name": "text-stats",
+  "version": "0.1.0",
+  "description": "Count lines and characters in a file",
+  "entryPoint": "./index.mjs"
+}
+```
+
+`index.mjs`：
+
+```js
+import { readFile } from 'node:fs/promises';
+
+// Kept in module scope so deactivate() can unregister without a context arg.
+let tools;
+
+export async function activate(context) {
+  tools = context.services.tools;
+  tools.registerUserTool({
+    name: 'text_stats',
+    description: '统计文件的行数与字符数',
+    parameters: {
+      type: 'object',
+      properties: {
+        path: { type: 'string', description: '要统计的文件路径' },
+      },
+      required: ['path'],
+      additionalProperties: false,
+    },
+    execute: async (args) => {
+      const text = await readFile(String(args.path), 'utf8');
+      return {
+        output: `lines=${text.split('\n').length} chars=${text.length}`,
+        message: `已统计 ${String(args.path)}`,
+      };
+    },
+  });
+}
+
+export async function deactivate() {
+  // The host reclaims owned tools too; this keeps the plugin self-contained.
+  tools?.unregisterUserTool('text_stats');
+  tools = undefined;
+}
+```
+
+启用与迭代：
+
+1. `ManagePlugin { "action": "register_generated", "source": "/Users/me/.scream-code/plugins/generated/text-stats" }`
+2. `ManagePlugin { "action": "activate", "id": "text-stats" }`
+3. 改完代码后 `/extension reload text-stats`
+
+## 安全边界
+
+- 入口只能在插件目录内：清单层强制 `./` 相对路径，并对 realpath 结果做越界检查（见 `resolvePluginPathField`）。越界的 `entryPoint` 会被清单层拒绝，`register_generated` 报 `entry_point_rejected`，不会降级成"看起来注册成功"的纯数据插件。
+- 注册不执行代码：`register_generated` 只解析清单、登记记录；`activate` 是唯一的执行点，且单独要求审批。
+- 审批身份包含目录路径与插件 id：`register_generated` 的审批串带完整 source，`activate` / `deactivate` / `remove` / `enable` / `disable` / `reset` / `rollback` / `set_mcp_enabled` / `reload_code` 带插件 id（如 `ManagePlugin(activate text-stats)`）。会话级授权只能覆盖同名对象，不能挪用到另一个目录或另一个插件。
+- 激活后代码运行在 agent 进程内，可访问 `context.services`。只激活自己写的或完全信任的插件。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scream-code",
-  "version": "0.19.3",
+  "version": "0.19.6",
   "description": "A terminal-native AI agent for builders",
   "license": "MIT",
   "author": "ScreamCli",