@downcity/agent 1.1.175 → 1.1.178

package/src/config/AgentInitializer.ts

@@ -3,8 +3,8 @@
  *
  * 职责说明（中文）
  * - CLI `downcity agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
- * - 负责创建项目骨架、静态 prompt、默认 `downcity.json`、基础目录与 schema 文件。
- * - 负责把用户在创建阶段提供的最小执行配置与渠道配置写入项目。
+ * - 负责创建项目骨架、静态 prompt、基础目录与 schema 文件。
+ * - CLI 侧运行配置应写入宿主配置存储，不再由 SDK 初始化器写项目配置文件。
  *
  * 边界说明（中文）
  * - 这里只处理“初始化一个新项目”所需的静态文件与目录，不处理 downcity 托管进程启停。
@@ -22,20 +22,14 @@ import {
   getDowncityDataDirPath,
   getDowncityDebugDirPath,
   getDowncityDirPath,
-  getDowncityJsonPath,
   getDowncityProfileDirPath,
   getDowncityProfileOtherPath,
   getDowncityProfilePrimaryPath,
   getDowncityPublicDirPath,
   getDowncityResourcesDirPath,
-  getDowncitySchemaPath,
   getDowncityTasksDirPath,
   getSoulMdPath,
 } from "@/config/Paths.js";
-import { DEFAULT_DOWNCITY_JSON } from "@/config/Defaults.js";
-import { DOWNCITY_JSON_SCHEMA } from "@/config/DowncitySchema.js";
-import type { DowncityConfig } from "@/config/Config.js";
-import type { DowncityChatPluginChannelsConfig } from "@/types/config/DowncityConfig.js";
 import {
   DEFAULT_PROFILE_MD_TEMPLATE,
   DEFAULT_SOUL_MD_TEMPLATE,
@@ -44,14 +38,14 @@ import type { EnvFileEntry } from "@/types/common/EnvFile.js";
 import { appendMissingEnvEntries } from "@/config/EnvFile.js";
 import { ensureGitignoreEntry } from "@/config/Gitignore.js";
 import { renderTemplateVariables } from "@/utils/Template.js";
-import { ensureDir, saveJson } from "@/utils/storage/index.js";
+import { ensureDir } from "@/utils/storage/index.js";
 import type {
   AgentProjectChannel,
   AgentProjectInitializationInput,
   AgentProjectInitializationResult,
 } from "@/types/config/AgentProject.js";
-import { assertProjectExecutionTarget } from "@/config/ExecutionBinding.js";
 import type { ExecutionBindingConfig } from "@/types/config/ExecutionBinding.js";
+import { assertProjectExecutionTarget } from "@/config/ExecutionBinding.js";
 
 /**
  * 规范化默认 Agent ID。
@@ -92,21 +86,20 @@ function normalizeChannels(input: AgentProjectChannel[] | undefined): AgentProje
  * 判断项目是否已经具备最小初始化文件。
  *
  * 关键点（中文）
- * - 当前只检查 `PROFILE.md` 与 `downcity.json`，用于快速判断是否已初始化过。
+ * - 当前只检查 `PROFILE.md`，用于快速判断项目行为资产是否已初始化过。
  * - 不把 `.downcity/` 目录作为硬性条件，避免用户手动清理缓存后被误判为未初始化。
  */
 export async function isAgentProjectInitialized(projectRoot: string): Promise<boolean> {
   const normalizedRoot = path.resolve(String(projectRoot || "").trim() || ".");
   const profileReady = await fs.pathExists(getProfileMdPath(normalizedRoot));
-  const shipReady = await fs.pathExists(getDowncityJsonPath(normalizedRoot));
-  return profileReady && shipReady;
+  return profileReady;
 }
 
 /**
  * 初始化 agent 项目骨架。
  *
  * 关键点（中文）
- * - 会创建 prompt 文件、配置文件、`.downcity` 目录结构以及 schema 快照。
+ * - 会创建 prompt 文件、`.downcity` 目录结构以及 schema 快照。
  * - 对已存在文件采取“能跳过就跳过、明确冲突则报错”的策略，降低误覆盖风险。
  * - 返回结果只描述本次初始化写入摘要，方便 CLI 与控制台直接展示。
  */
@@ -135,12 +128,6 @@ export async function initializeAgentProject(
 
   const profileMdPath = getProfileMdPath(projectRoot);
   const soulMdPath = getSoulMdPath(projectRoot);
-  const shipJsonPath = getDowncityJsonPath(projectRoot);
-  const existingShipJson = await fs.pathExists(shipJsonPath);
-  if (existingShipJson && input.forceOverwriteShipJson !== true) {
-    throw new Error(`downcity.json already exists: ${shipJsonPath}`);
-  }
-
   const initTemplateVariables = {
     agent_id,
   };
@@ -166,37 +153,6 @@ export async function initializeAgentProject(
     createdFiles.push(file.filename);
   }
 
-  const channelsConfig: DowncityChatPluginChannelsConfig = {};
-  if (channels.includes("telegram")) {
-    channelsConfig.telegram = { enabled: true };
-  }
-  if (channels.includes("feishu")) {
-    channelsConfig.feishu = { enabled: true };
-  }
-  if (channels.includes("qq")) {
-    channelsConfig.qq = { enabled: true };
-  }
-
-  const shipConfig: DowncityConfig = {
-    $schema: DEFAULT_DOWNCITY_JSON.$schema,
-    id: agent_id,
-    version: "1.0.0",
-    execution,
-    plugins: {
-      ...(input.plugins || {}),
-      ...(Object.keys(channelsConfig).length > 0
-        ? {
-            chat: {
-              ...input.plugins?.chat,
-              channels: channelsConfig,
-            },
-          }
-        : {}),
-    },
-  };
-  await saveJson(shipJsonPath, shipConfig);
-  createdFiles.push("downcity.json");
-
   await appendMissingEnvEntries(
     dotEnvPath,
     "Downcity Create",
@@ -227,18 +183,12 @@ export async function initializeAgentProject(
     getDowncityResourcesDirPath(projectRoot),
     getDowncityConfigDirPath(projectRoot),
     path.join(projectRoot, ".agents", "skills"),
-    path.join(getDowncityDirPath(projectRoot), "schema"),
     getDowncityDebugDirPath(projectRoot),
   ];
   for (const dir of dirs) {
     await ensureDir(dir);
   }
 
-  const shipSchemaPath = getDowncitySchemaPath(projectRoot);
-  await ensureDir(path.dirname(shipSchemaPath));
-  await saveJson(shipSchemaPath, DOWNCITY_JSON_SCHEMA);
-  createdFiles.push(".downcity/schema/downcity.schema.json");
-
   try {
     await ensureDir(getDowncityProfileDirPath(projectRoot));
     await fs.ensureFile(getDowncityProfilePrimaryPath(projectRoot));

package/src/config/DowncitySchema.ts

@@ -2,8 +2,8 @@
  * `downcity.json` Schema 定义模块。
  *
  * 职责说明（中文）
- * - 提供项目初始化时写入本地的 JSON Schema 常量。
- * - 统一维护用户可编辑配置的结构约束、字段说明与编辑器联想元数据。
+ * - 提供旧版 `downcity.json` 的 JSON Schema 常量。
+ * - 保留给迁移场景与编辑器辅助，不再作为新 Agent 项目的默认配置入口。
  *
  * 边界说明（中文）
  * - 这里是静态 schema 常量，不负责运行时配置装配或业务校验逻辑。
@@ -15,8 +15,7 @@ import type { JsonObject } from "@/types/common/Json.js";
  * `downcity.json` 的本地 Schema 常量。
  *
  * 关键点（中文）
- * - 初始化流程会把该常量写入 `.downcity/schema/downcity.schema.json`。
- * - 该结构主要面向 IDE 校验与用户编辑体验，不替代运行时断言。
+ * - 该结构主要面向 legacy 文件的 IDE 校验与用户编辑体验，不替代运行时断言。
  */
 export const DOWNCITY_JSON_SCHEMA: JsonObject = {
   $schema: "https://json-schema.org/draft/2020-12/schema",

package/src/executor/composer/system/default/SystemDomain.ts

@@ -8,7 +8,6 @@
 
 import type { SystemModelMessage } from "ai";
 import { transformPromptsIntoSystemMessages } from "@executor/composer/system/default/PromptRenderer.js";
-import { isPluginEnabled } from "@/plugin/core/Activation.js";
 import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 import { buildRuntimeClockSystemPrompt } from "@executor/composer/system/default/variables/VariableReplacer.js";
 import {
@@ -177,7 +176,7 @@ export async function loadManagedPluginSystemPrompts(input: {
     if (disabledPluginNames.has(plugin.name)) continue;
     if (typeof plugin.system !== "function") continue;
     try {
-      if (!isPluginEnabled({ plugin, context: input.context })) continue;
+      if (input.context.plugins.status(plugin.name)?.status !== "ready") continue;
       if (typeof plugin.availability === "function") {
         const availability = await plugin.availability(input.context);
         if (!availability.available) continue;

package/src/executor/composer/system/default/assets/core.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/core.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，Agent HTTP gateway 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（托管进程 pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n   - `.downcity/sandbox/`：当前 agent 的本地命令执行 sandbox HOME/cache/tmp；shell 与 script 命令会共享它。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 向 unrestricted shell session 使用 `shell_write` 时，每一次写入都必须提供清楚的 `reason`，并等待用户确认；`shell_start` 的审批只授权启动进程，不授权后续 stdin 写入。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n- shell 命令默认在 Safe Sandbox 中执行：项目目录可读写，网络可用，HOME 指向 `.downcity/sandbox/`，真实用户 HOME 与系统目录不可写。\n- 安装 Python 依赖时优先使用项目内 `.venv`，不要使用 `pip install --user`。\n- 需要全局安装、写宿主目录、访问宿主级能力时，可以请求 `sandbox: \"unrestricted\"`；必须提供清楚的 `reason`，等待用户确认后才能执行。\n- 不要尝试 `sudo`、Xcode Command Line Tools 安装、修改 SSH/keychain/shell profile，或执行明显破坏性命令；这些请求即使使用 unrestricted sandbox 也会被拒绝。\n- 用户拒绝 unrestricted sandbox 请求后，不要反复请求同一命令，应解释影响并给出项目内替代方案。\n- 下载模型、工具缓存、临时状态应自然落在 `.downcity/sandbox/` 或项目目录中，不要假设可复用真实用户缓存。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- 密钥列表能力只能返回已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试获取明文。\n";
+const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，Agent HTTP gateway 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（托管进程 pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n   - `.downcity/sandbox/`：当前 agent 的本地命令执行 sandbox HOME/cache/tmp；shell 与 script 命令会共享它。\n2. PROFILE.md + SOUL.md 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 向 unrestricted shell session 使用 `shell_write` 时，每一次写入都必须提供清楚的 `reason`，并等待用户确认；`shell_start` 的审批只授权启动进程，不授权后续 stdin 写入。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n- shell 命令默认在 Safe Sandbox 中执行：项目目录可读写，网络可用，HOME 指向 `.downcity/sandbox/`，真实用户 HOME 与系统目录不可写。\n- 安装 Python 依赖时优先使用项目内 `.venv`，不要使用 `pip install --user`。\n- 需要全局安装、写宿主目录、访问宿主级能力时，可以请求 `sandbox: \"unrestricted\"`；必须提供清楚的 `reason`，等待用户确认后才能执行。\n- 不要尝试 `sudo`、Xcode Command Line Tools 安装、修改 SSH/keychain/shell profile，或执行明显破坏性命令；这些请求即使使用 unrestricted sandbox 也会被拒绝。\n- 用户拒绝 unrestricted sandbox 请求后，不要反复请求同一命令，应解释影响并给出项目内替代方案。\n- 下载模型、工具缓存、临时状态应自然落在 `.downcity/sandbox/` 或项目目录中，不要假设可复用真实用户缓存。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- 密钥列表能力只能返回已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试获取明文。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/core.prompt.ts.txt

@@ -10,7 +10,7 @@
    - `.downcity/data/`：小型持久化数据（预留）。
    - `.downcity/task/`：Task 目录。
    - `.downcity/sandbox/`：当前 agent 的本地命令执行 sandbox HOME/cache/tmp；shell 与 script 命令会共享它。
-2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。
+2. PROFILE.md + SOUL.md 是你的一些配置文件，你不需要读取。
 
 # 最重要
 【关于命令执行工具】（重要）

package/src/index.ts

@@ -139,11 +139,7 @@ export {
   registerPluginActionCommandsForCli,
 } from "./plugin/core/PluginCommand.js";
 
-// Runtime plugin 运行集成
-export {
-  startAllPlugins,
-  stopAllPlugins,
-} from "./plugin/core/Manager.js";
+// Runtime plugin 调度集成
 export { ActionScheduleStore } from "./plugin/core/ActionScheduleStore.js";
 export { parseActionScheduleRunAtMsOrThrow } from "./plugin/core/ActionScheduleTime.js";
 export {
@@ -151,9 +147,6 @@ export {
   resolveAssistantMessageForPersistence,
 } from "./executor/messages/UserVisibleText.js";
 
-// Plugin 与权限配置集成
-export { persistProjectPluginConfig } from "./plugin/core/ProjectConfigStore.js";
-
 // 项目与配置集成
 export {
   initializeAgentProject,

package/src/plugin/core/Activation.ts

@@ -1,26 +1,26 @@
 /**
- * Plugin 激活判定工具。
+ * Plugin 激活兼容工具。
  *
  * 关键点（中文）
- * - 统一收敛“某个 plugin 在当前项目配置下是否启用”的规则。
- * - plugin 启用态直接来自项目 `downcity.json` 的 `plugins.<name>.enabled`。
+ * - 新模型不再读取 `downcity.json.plugins.<name>.enabled`。
+ * - 传入 plugin 本身就表示调用方希望它可见；Agent runtime 以注册表作为真实边界。
+ * - 该函数仅为旧内部集成保留，后续应优先使用 `context.plugins.has/status`。
  */
 
-import { readProjectPluginEnabled } from "@/plugin/core/ProjectConfigStore.js";
 import type { Plugin } from "@/plugin/types/Plugin.js";
 import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
 
 /**
- * 读取当前项目配置下的 plugin 启用态。
+ * 判断当前 plugin 是否可被视为启用。
  */
 export function isPluginEnabled(params: {
   plugin: Plugin;
-  context?: Pick<AgentContext, "config">;
+  context?: Pick<AgentContext, "plugins">;
 }): boolean {
   const pluginName = String(params.plugin.name || "").trim();
   if (!pluginName) return false;
-  return readProjectPluginEnabled({
-    pluginName,
-    config: params.context?.config,
-  });
+  if (params.context?.plugins) {
+    return params.context.plugins.status(pluginName)?.status === "ready";
+  }
+  return true;
 }

package/src/plugin/core/BasePlugin.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 主动运行型能力与被动扩展型能力统一收敛到 plugin 概念。
  * - plugin 的长期状态归属于实例本身，而不是模块级单例。
- * - 旧生命周期模型暂时通过 `lifecycle` 兼容，后续可逐步收敛到 `start/stop/command`。
+ * - Agent 注册 plugin 时自动启动 lifecycle；卸载时自动停止 lifecycle。
  */
 
 import type { AgentContext } from "@/types/runtime/agent/AgentContext.js";
@@ -19,9 +19,9 @@ import type {
   PluginLifecycle,
   PluginResolves,
   PluginSetupDefinition,
-  PluginStateRecord,
   PluginUsageDefinition,
 } from "@/plugin/types/Plugin.js";
+import type { PluginRuntimeRecord } from "@/types/plugin/PluginState.js";
 import type { StructuredConfig } from "@/types/runtime/agent/AgentContext.js";
 
 /**
@@ -29,12 +29,15 @@ import type { StructuredConfig } from "@/types/runtime/agent/AgentContext.js";
  */
 export abstract class BasePlugin implements Plugin {
   /**
-   * 当前实例持有的通用 plugin 运行状态记录。
+   * 当前实例持有的 plugin 注册状态记录。
    */
-  public readonly pluginStateRecord: PluginStateRecord = {
-    state: "stopped",
-    updatedAt: Date.now(),
+  public readonly pluginStateRecord: PluginRuntimeRecord = {
+    plugin: this,
+    state: "ready",
+    registered_at: Date.now(),
+    updated_at: Date.now(),
     chain: Promise.resolve(),
+    lifecycle_started: false,
   };
 
   /**

package/src/plugin/core/HookRegistry.ts

@@ -145,6 +145,47 @@ export class HookRegistry {
     });
   }
 
+  /**
+   * 移除指定 plugin 注册的全部扩展点。
+   */
+  unregisterPlugin(pluginName: string): void {
+    const key = String(pluginName || "").trim();
+    if (!key) return;
+
+    for (const [pointName, bucket] of this.pipelineHooks.entries()) {
+      const next = bucket.filter((item) => item.pluginName !== key);
+      if (next.length > 0) {
+        this.pipelineHooks.set(pointName, next);
+      } else {
+        this.pipelineHooks.delete(pointName);
+      }
+    }
+
+    for (const [pointName, bucket] of this.guardHooks.entries()) {
+      const next = bucket.filter((item) => item.pluginName !== key);
+      if (next.length > 0) {
+        this.guardHooks.set(pointName, next);
+      } else {
+        this.guardHooks.delete(pointName);
+      }
+    }
+
+    for (const [pointName, bucket] of this.effectHooks.entries()) {
+      const next = bucket.filter((item) => item.pluginName !== key);
+      if (next.length > 0) {
+        this.effectHooks.set(pointName, next);
+      } else {
+        this.effectHooks.delete(pointName);
+      }
+    }
+
+    for (const [pointName, record] of this.resolveHooks.entries()) {
+      if (record.pluginName === key) {
+        this.resolveHooks.delete(pointName);
+      }
+    }
+  }
+
   /**
    * 列出所有已注册扩展点。
    */

package/src/plugin/core/Manager.ts

@@ -11,8 +11,6 @@ export {
   controlPluginState,
   isPluginRunning,
   listPluginStates,
-  startAllPlugins,
-  stopAllPlugins,
 } from "@/plugin/core/PluginStateController.js";
 export {
   runPluginCommand,