@downcity/agent 1.1.1 → 1.1.5

package/src/shared/types/Store.ts

@@ -2,7 +2,7 @@
  * 模型存储（SQLite）类型定义。
  *
  * 关键点（中文）
- * - 该类型用于 console 全局模型池（provider/model）的统一读写。
+ * - 该类型用于平台控制面全局模型池（provider/model）的统一读写。
  * - agent 项目只通过 `execution.modelId` 绑定模型 ID，不直接持有 provider 细节。
  */
 import type { LlmProviderType } from "@/shared/types/LlmConfig.js";
@@ -42,6 +42,28 @@ export interface StoredModelProvider {
   updatedAt: string;
 }
 
+/**
+ * provider 元信息。
+ *
+ * 关键点（中文）
+ * - 仅保留同步读取所需的轻量字段。
+ * - 不包含解密后的 API Key，避免在只读展示链路中泄露敏感信息。
+ */
+export interface StoredProviderMeta {
+  /**
+   * provider 主键 ID。
+   */
+  id: string;
+  /**
+   * provider 类型。
+   */
+  type: LlmProviderType;
+  /**
+   * provider 基础地址（可选）。
+   */
+  baseUrl?: string;
+}
+
 /**
  * 模型记录。
  */
@@ -174,14 +196,14 @@ export interface UpsertModelInput {
 export type StoredEnvScope = "global" | "agent";
 
 /**
- * Console Env 记录。
+ * 平台环境变量记录。
  */
 export interface StoredEnvEntry {
   /**
    * Env 作用域。
    *
    * 关键点（中文）
-   * - `global` 表示 Console 全局共享变量。
+   * - `global` 表示平台控制面全局共享变量。
    * - `agent` 表示仅某个 agent 可见的私有变量。
    */
   scope: StoredEnvScope;

package/src/shared/types/TaskService.ts

@@ -6,7 +6,7 @@
  * - 跨模块复用的 task service 类型统一提升到 `shared/types/`，避免散落在具体实现文件中。
  */
 
-import type { ShipTaskStatus } from "@services/task/types/Task.js";
+import type { ShipTaskStatus } from "@/service/builtins/task/types/Task.js";
 
 /**
  * `task.list` action 的输入载荷。

package/src/shared/utils/README.md

@@ -3,7 +3,7 @@
 ## 模块定位
 
 `utils/` 放置可被多模块复用的基础工具实现。  
-当前主要包括日志、ConsoleStore、CLI 与时间等通用基础设施。
+当前主要包括日志、PlatformStore、CLI 与时间等通用基础设施。
 
 ## 实现概览
 
@@ -23,7 +23,7 @@
 6. `logger/FormatResponse.ts`
    - 解析 provider response / SSE payload，提取输出类型与 function call 摘要。
 7. `store/index.ts`
-   - 提供 `ConsoleStore` 门面。
+   - 提供 `PlatformStore` 门面。
    - 对外统一暴露 provider/model、secure settings、env、channel account 存储能力。
 8. `store/StoreSchema.ts`
    - 负责 SQLite 建表与轻量迁移。
@@ -41,7 +41,7 @@
 1. `main/model/CreateModel.ts` 创建模型时注入 `createLlmLoggingFetch`。
 2. `session/SessionRunScope.ts` 在运行期维护 `sessionId/requestId`。
 3. LLM 请求发出时，`utils/logger` 通过注入回调读取上下文并记录结构化日志。
-4. `main/modules/cli/Model*.ts`、`main/modules/console/*` 等控制面模块通过 `ConsoleStore` 访问 SQLite 配置数据。
+4. `main/modules/cli/Model*.ts`、控制面相关模块等通过 `PlatformStore` 访问 SQLite 配置数据。
 
 ## 边界约束
 

package/src/shared/utils/store/StoreChannelAccountRepository.ts

@@ -1,5 +1,5 @@
 /**
- * ConsoleStore 渠道账号仓储。
+ * PlatformStore 渠道账号仓储。
  *
  * 关键点（中文）
  * - 统一管理 `channel_accounts` 表。
@@ -11,7 +11,7 @@ import type {
   UpsertChannelAccountInput,
 } from "@/shared/types/Store.js";
 import { decryptText, decryptTextSync, encryptText } from "./crypto.js";
-import type { ConsoleStoreContext } from "./StoreShared.js";
+import type { PlatformStoreContext } from "./StoreShared.js";
 import {
   normalizeChannelAccountChannel,
   normalizeNonEmptyText,
@@ -23,7 +23,7 @@ import {
  * 同步列出 channel accounts。
  */
 export function listChannelAccountsSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   channelInput?: string,
 ): StoredChannelAccount[] {
   const maybeChannel = optionalTrimmedText(channelInput);
@@ -61,7 +61,7 @@ export function listChannelAccountsSync(
  * 同步按 ID 获取 channel account。
  */
 export function getChannelAccountSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   accountIdInput: string,
 ): StoredChannelAccount | null {
   const accountId = normalizeNonEmptyText(accountIdInput, "channel account id");
@@ -73,7 +73,7 @@ export function getChannelAccountSync(
  * 异步列出 channel accounts。
  */
 export async function listChannelAccounts(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   channelInput?: string,
 ): Promise<StoredChannelAccount[]> {
   const maybeChannel = optionalTrimmedText(channelInput);
@@ -111,7 +111,7 @@ export async function listChannelAccounts(
  * 异步按 ID 获取 channel account。
  */
 export async function getChannelAccount(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   accountIdInput: string,
 ): Promise<StoredChannelAccount | null> {
   const accountId = normalizeNonEmptyText(accountIdInput, "channel account id");
@@ -123,7 +123,7 @@ export async function getChannelAccount(
  * 新增或更新 channel account。
  */
 export async function upsertChannelAccount(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: UpsertChannelAccountInput,
 ): Promise<void> {
   const id = normalizeNonEmptyText(input.id, "channel account id");
@@ -191,7 +191,7 @@ export async function upsertChannelAccount(
  * 删除 channel account。
  */
 export function removeChannelAccount(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   accountIdInput: string,
 ): void {
   const accountId = normalizeNonEmptyText(accountIdInput, "channel account id");

package/src/shared/utils/store/StoreEnvRepository.ts

@@ -1,5 +1,5 @@
 /**
- * ConsoleStore 环境变量仓储。
+ * PlatformStore 环境变量仓储。
  *
  * 关键点（中文）
  * - 统一管理 `env_entries` 单表。
@@ -16,7 +16,7 @@ import type {
   UpsertGlobalEnvEntryInput,
 } from "@/shared/types/Store.js";
 import { decryptText, decryptTextSync, encryptText } from "./crypto.js";
-import type { ConsoleStoreContext } from "./StoreShared.js";
+import type { PlatformStoreContext } from "./StoreShared.js";
 import { normalizeNonEmptyText, nowIso } from "./StoreShared.js";
 
 /**
@@ -99,7 +99,7 @@ async function buildEnvEntryFromRow(row: {
  * 同步列出 env 条目。
  */
 export function listEnvEntriesSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   scopeInput?: StoredEnvScope,
   agentIdInput?: string,
 ): StoredEnvEntry[] {
@@ -155,7 +155,7 @@ export function listEnvEntriesSync(
  * 异步列出 env 条目。
  */
 export async function listEnvEntries(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   scopeInput?: StoredEnvScope,
   agentIdInput?: string,
 ): Promise<StoredEnvEntry[]> {
@@ -211,7 +211,7 @@ export async function listEnvEntries(
  * 新增或更新 env 条目。
  */
 export async function upsertEnvEntry(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: UpsertEnvEntryInput,
 ): Promise<void> {
   const scope = normalizeEnvScope(input.scope);
@@ -258,7 +258,7 @@ export async function upsertEnvEntry(
  * 删除单个 env 条目。
  */
 export function removeEnvEntry(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: { scope: StoredEnvScope; agentId?: string; key: string },
 ): void {
   const scope = normalizeEnvScope(input.scope);
@@ -273,7 +273,7 @@ export function removeEnvEntry(
  * 同步列出全局环境变量。
  */
 export function listGlobalEnvEntriesSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): StoredGlobalEnvEntry[] {
   return listEnvEntriesSync(context, "global");
 }
@@ -282,7 +282,7 @@ export function listGlobalEnvEntriesSync(
  * 同步读取全局环境变量映射。
  */
 export function getGlobalEnvMapSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): Record<string, string> {
   const entries = listGlobalEnvEntriesSync(context);
   const map: Record<string, string> = {};
@@ -296,7 +296,7 @@ export function getGlobalEnvMapSync(
  * 异步列出全局环境变量。
  */
 export async function listGlobalEnvEntries(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): Promise<StoredGlobalEnvEntry[]> {
   return listEnvEntries(context, "global");
 }
@@ -305,7 +305,7 @@ export async function listGlobalEnvEntries(
  * 异步读取全局环境变量映射。
  */
 export async function getGlobalEnvMap(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): Promise<Record<string, string>> {
   const entries = await listGlobalEnvEntries(context);
   const map: Record<string, string> = {};
@@ -319,7 +319,7 @@ export async function getGlobalEnvMap(
  * 新增或更新全局环境变量。
  */
 export async function upsertGlobalEnvEntry(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: UpsertGlobalEnvEntryInput,
 ): Promise<void> {
   await upsertEnvEntry(context, {
@@ -333,7 +333,7 @@ export async function upsertGlobalEnvEntry(
  * 删除单个全局环境变量。
  */
 export function removeGlobalEnvEntry(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   keyInput: string,
 ): void {
   removeEnvEntry(context, {
@@ -345,7 +345,7 @@ export function removeGlobalEnvEntry(
 /**
  * 清空全局环境变量。
  */
-export function clearGlobalEnvEntries(context: ConsoleStoreContext): void {
+export function clearGlobalEnvEntries(context: PlatformStoreContext): void {
   context.sqlite.prepare("DELETE FROM env_entries WHERE scope = 'global';").run();
 }
 
@@ -353,7 +353,7 @@ export function clearGlobalEnvEntries(context: ConsoleStoreContext): void {
  * 同步列出指定 agent 的私有环境变量。
  */
 export function listAgentEnvEntriesSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   agentIdInput: string,
 ): StoredAgentEnvEntry[] {
   return listEnvEntriesSync(context, "agent", agentIdInput);
@@ -363,7 +363,7 @@ export function listAgentEnvEntriesSync(
  * 同步读取 agent 环境变量映射。
  */
 export function getAgentEnvMapSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   agentIdInput: string,
 ): Record<string, string> {
   const entries = listAgentEnvEntriesSync(context, agentIdInput);
@@ -378,7 +378,7 @@ export function getAgentEnvMapSync(
  * 异步列出指定 agent 的私有环境变量。
  */
 export async function listAgentEnvEntries(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   agentIdInput: string,
 ): Promise<StoredAgentEnvEntry[]> {
   return listEnvEntries(context, "agent", agentIdInput);
@@ -388,7 +388,7 @@ export async function listAgentEnvEntries(
  * 异步列出全部 agent 私有环境变量。
  */
 export async function listAllAgentEnvEntries(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): Promise<StoredAgentEnvEntry[]> {
   return listEnvEntries(context, "agent");
 }
@@ -397,7 +397,7 @@ export async function listAllAgentEnvEntries(
  * 异步读取 agent 环境变量映射。
  */
 export async function getAgentEnvMap(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   agentIdInput: string,
 ): Promise<Record<string, string>> {
   const entries = await listAgentEnvEntries(context, agentIdInput);
@@ -412,7 +412,7 @@ export async function getAgentEnvMap(
  * 新增或更新 agent 私有环境变量。
  */
 export async function upsertAgentEnvEntry(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: UpsertAgentEnvEntryInput,
 ): Promise<void> {
   await upsertEnvEntry(context, {
@@ -427,7 +427,7 @@ export async function upsertAgentEnvEntry(
  * 删除指定 agent 的单个环境变量。
  */
 export function removeAgentEnvEntry(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   agentIdInput: string,
   keyInput: string,
 ): void {
@@ -442,7 +442,7 @@ export function removeAgentEnvEntry(
  * 清空指定 agent 的私有环境变量。
  */
 export function clearAgentEnvEntries(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   agentIdInput: string,
 ): void {
   const agentId = normalizeNonEmptyText(agentIdInput, "agentId");

package/src/shared/utils/store/StoreModelRepository.ts

@@ -1,28 +1,29 @@
 /**
- * ConsoleStore 模型与 Provider 仓储。
+ * PlatformStore 模型与 Provider 仓储。
  *
  * 关键点（中文）
  * - 只负责 model/provider 相关读写，不处理 env、channel account、secure settings。
- * - 对外暴露纯函数，`ConsoleStore` 作为门面调用。
+ * - 对外暴露纯函数，`PlatformStore` 作为门面调用。
  */
 
 import { eq } from "drizzle-orm";
 import type {
   StoredModel,
   StoredModelProvider,
+  StoredProviderMeta,
   UpsertModelInput,
   UpsertModelProviderInput,
 } from "@/shared/types/Store.js";
 import { decryptText, encryptText } from "./crypto.js";
 import { modelProvidersTable, modelsTable } from "./schema.js";
-import type { ConsoleStoreContext } from "./StoreShared.js";
+import type { PlatformStoreContext } from "./StoreShared.js";
 import { nowIso } from "./StoreShared.js";
 
 /**
  * 列出 providers。
  */
 export async function listStoredProviders(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): Promise<StoredModelProvider[]> {
   const rows = context.db.select().from(modelProvidersTable).all();
   const result: StoredModelProvider[] = [];
@@ -43,11 +44,25 @@ export async function listStoredProviders(
   return result;
 }
 
+/**
+ * 同步列出 provider 元信息（不含 API Key）。
+ */
+export function listStoredProviderMetas(
+  context: PlatformStoreContext,
+): StoredProviderMeta[] {
+  const rows = context.db.select().from(modelProvidersTable).all();
+  return rows.map((row) => ({
+    id: row.id,
+    type: row.type as StoredProviderMeta["type"],
+    baseUrl: row.baseUrl || undefined,
+  }));
+}
+
 /**
  * 获取单个 provider。
  */
 export async function getStoredProvider(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   providerId: string,
 ): Promise<StoredModelProvider | null> {
   const row = context.db
@@ -74,7 +89,7 @@ export async function getStoredProvider(
  * 新增或更新 provider。
  */
 export async function upsertStoredProvider(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: UpsertModelProviderInput,
 ): Promise<void> {
   const id = String(input.id || "").trim();
@@ -123,7 +138,7 @@ export async function upsertStoredProvider(
  * 删除 provider。
  */
 export function removeStoredProvider(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   providerId: string,
 ): void {
   const refs = context.db
@@ -145,7 +160,7 @@ export function removeStoredProvider(
 /**
  * 列出 models。
  */
-export function listStoredModels(context: ConsoleStoreContext): StoredModel[] {
+export function listStoredModels(context: PlatformStoreContext): StoredModel[] {
   const rows = context.db.select().from(modelsTable).all();
   return rows.map((row) => ({
     id: row.id,
@@ -167,7 +182,7 @@ export function listStoredModels(context: ConsoleStoreContext): StoredModel[] {
  * 获取单个 model。
  */
 export function getStoredModel(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   modelId: string,
 ): StoredModel | null {
   const row = context.db
@@ -196,7 +211,7 @@ export function getStoredModel(
  * 新增或更新 model。
  */
 export function upsertStoredModel(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   input: UpsertModelInput,
 ): void {
   const id = String(input.id || "").trim();
@@ -256,7 +271,7 @@ export function upsertStoredModel(
  * 切换 model 暂停状态。
  */
 export function setStoredModelPaused(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   modelId: string,
   paused: boolean,
 ): void {
@@ -278,7 +293,7 @@ export function setStoredModelPaused(
  * 删除 model。
  */
 export function removeStoredModel(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   modelId: string,
 ): void {
   context.db.delete(modelsTable).where(eq(modelsTable.id, modelId)).run();
@@ -288,7 +303,7 @@ export function removeStoredModel(
  * 获取“model + provider”聚合信息。
  */
 export async function getResolvedStoredModel(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   modelId: string,
 ): Promise<{ model: StoredModel; provider: StoredModelProvider } | null> {
   const model = getStoredModel(context, modelId);
@@ -302,7 +317,7 @@ export async function getResolvedStoredModel(
  * 清空模型相关表。
  */
 export function clearStoredModelsAndProviders(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
 ): void {
   context.sqlite.exec("DELETE FROM models;");
   context.sqlite.exec("DELETE FROM model_providers;");

package/src/shared/utils/store/StoreSchema.ts

@@ -1,17 +1,17 @@
 /**
- * ConsoleStore Schema 管理。
+ * PlatformStore Schema 管理。
  *
  * 关键点（中文）
- * - 负责 `ConsoleStore` 的建表与轻量迁移。
+ * - 负责 `PlatformStore` 的建表与轻量迁移。
  * - 启动时执行，不承担任何查询写入业务逻辑。
  */
 
-import type { ConsoleStoreContext } from "./StoreShared.js";
+import type { PlatformStoreContext } from "./StoreShared.js";
 
 /**
- * 初始化 ConsoleStore 所需表结构。
+ * 初始化 PlatformStore 所需表结构。
  */
-export function ensureConsoleStoreSchema(context: ConsoleStoreContext): void {
+export function ensurePlatformStoreSchema(context: PlatformStoreContext): void {
   context.sqlite.exec(`
     CREATE TABLE IF NOT EXISTS model_providers (
       id TEXT PRIMARY KEY NOT NULL,
@@ -44,7 +44,7 @@ export function ensureConsoleStoreSchema(context: ConsoleStoreContext): void {
     ON models(provider_id);
   `);
   context.sqlite.exec(`
-    CREATE TABLE IF NOT EXISTS console_secure_settings (
+    CREATE TABLE IF NOT EXISTS platform_secure_settings (
       key TEXT PRIMARY KEY NOT NULL,
       value_encrypted TEXT NOT NULL,
       created_at TEXT NOT NULL,
@@ -98,13 +98,13 @@ export function ensureConsoleStoreSchema(context: ConsoleStoreContext): void {
 }
 
 /**
- * 初始化 Console 认证与授权表结构。
+ * 初始化平台认证与授权表结构。
  *
  * 关键点（中文）
- * - 该 schema 属于 console 级全局能力，不依赖任何单个 agent 项目。
+ * - 该 schema 属于平台级全局能力，不依赖任何单个 agent 项目。
  * - V1 只建表与索引，不在这里写入默认数据，默认数据由 auth bootstrap 负责。
  */
-function ensureAuthSchema(context: ConsoleStoreContext): void {
+function ensureAuthSchema(context: PlatformStoreContext): void {
   context.sqlite.exec(`
     CREATE TABLE IF NOT EXISTS auth_users (
       id TEXT PRIMARY KEY NOT NULL,
@@ -250,7 +250,7 @@ function ensureAuthSchema(context: ConsoleStoreContext): void {
 /**
  * 补齐 models 表的增量列。
  */
-function ensureModelsTableColumns(context: ConsoleStoreContext): void {
+function ensureModelsTableColumns(context: PlatformStoreContext): void {
   const rows = context.sqlite
     .prepare("PRAGMA table_info(models)")
     .all() as Array<{ name?: unknown }>;
@@ -267,7 +267,7 @@ function ensureModelsTableColumns(context: ConsoleStoreContext): void {
 /**
  * 补齐 channel_accounts 表的增量列。
  */
-function ensureChannelAccountsTableColumns(context: ConsoleStoreContext): void {
+function ensureChannelAccountsTableColumns(context: PlatformStoreContext): void {
   const rows = context.sqlite
     .prepare("PRAGMA table_info(channel_accounts)")
     .all() as Array<{ name?: unknown }>;
@@ -285,7 +285,7 @@ function ensureChannelAccountsTableColumns(context: ConsoleStoreContext): void {
 /**
  * 迁移历史 env 双表到统一单表。
  */
-function ensureEnvEntriesMigration(context: ConsoleStoreContext): void {
+function ensureEnvEntriesMigration(context: PlatformStoreContext): void {
   const envEntryColumns = context.sqlite
     .prepare("PRAGMA table_info(env_entries)")
     .all() as Array<{ name?: unknown }>;

package/src/shared/utils/store/StoreSecureSettings.ts

@@ -1,26 +1,26 @@
 /**
- * ConsoleStore 加密配置仓储。
+ * PlatformStore 加密配置仓储。
  *
  * 关键点（中文）
- * - 管理 `console_secure_settings` 表。
- * - console 级与 agent 级敏感配置都复用这套存储。
+ * - 管理 `platform_secure_settings` 表。
+ * - 平台级与 agent 级敏感配置都复用这套存储。
  */
 
 import { decryptText, decryptTextSync, encryptText, encryptTextSync } from "./crypto.js";
-import type { ConsoleStoreContext } from "./StoreShared.js";
+import type { PlatformStoreContext } from "./StoreShared.js";
 import { normalizeNonEmptyText, nowIso } from "./StoreShared.js";
 
 /**
  * 同步读取加密 JSON 配置。
  */
 export function getSecureSettingJsonSync<T>(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   key: string,
 ): T | null {
   const settingKey = normalizeNonEmptyText(key, "setting key");
   const row = context.sqlite
     .prepare(
-      "SELECT value_encrypted FROM console_secure_settings WHERE key = ? LIMIT 1;",
+      "SELECT value_encrypted FROM platform_secure_settings WHERE key = ? LIMIT 1;",
     )
     .get(settingKey) as { value_encrypted?: unknown } | undefined;
   if (!row || typeof row.value_encrypted !== "string" || !row.value_encrypted) {
@@ -34,7 +34,7 @@ export function getSecureSettingJsonSync<T>(
  * 同步写入加密 JSON 配置。
  */
 export function setSecureSettingJsonSync(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   key: string,
   value: unknown,
 ): void {
@@ -45,7 +45,7 @@ export function setSecureSettingJsonSync(
   context.sqlite
     .prepare(
       `
-      INSERT INTO console_secure_settings (key, value_encrypted, created_at, updated_at)
+      INSERT INTO platform_secure_settings (key, value_encrypted, created_at, updated_at)
       VALUES (?, ?, ?, ?)
       ON CONFLICT(key) DO UPDATE SET
         value_encrypted = excluded.value_encrypted,
@@ -59,12 +59,12 @@ export function setSecureSettingJsonSync(
  * 删除加密配置。
  */
 export function removeSecureSetting(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   key: string,
 ): void {
   const settingKey = normalizeNonEmptyText(key, "setting key");
   context.sqlite
-    .prepare("DELETE FROM console_secure_settings WHERE key = ?;")
+    .prepare("DELETE FROM platform_secure_settings WHERE key = ?;")
     .run(settingKey);
 }
 
@@ -72,13 +72,13 @@ export function removeSecureSetting(
  * 异步读取加密 JSON 配置。
  */
 export async function getSecureSettingJson<T>(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   key: string,
 ): Promise<T | null> {
   const settingKey = normalizeNonEmptyText(key, "setting key");
   const row = context.sqlite
     .prepare(
-      "SELECT value_encrypted FROM console_secure_settings WHERE key = ? LIMIT 1;",
+      "SELECT value_encrypted FROM platform_secure_settings WHERE key = ? LIMIT 1;",
     )
     .get(settingKey) as { value_encrypted?: unknown } | undefined;
   if (!row || typeof row.value_encrypted !== "string" || !row.value_encrypted) {
@@ -92,7 +92,7 @@ export async function getSecureSettingJson<T>(
  * 异步写入加密 JSON 配置。
  */
 export async function setSecureSettingJson(
-  context: ConsoleStoreContext,
+  context: PlatformStoreContext,
   key: string,
   value: unknown,
 ): Promise<void> {
@@ -103,7 +103,7 @@ export async function setSecureSettingJson(
   context.sqlite
     .prepare(
       `
-      INSERT INTO console_secure_settings (key, value_encrypted, created_at, updated_at)
+      INSERT INTO platform_secure_settings (key, value_encrypted, created_at, updated_at)
       VALUES (?, ?, ?, ?)
       ON CONFLICT(key) DO UPDATE SET
         value_encrypted = excluded.value_encrypted,

package/src/shared/utils/store/StoreShared.ts

@@ -1,8 +1,8 @@
 /**
- * ConsoleStore 共享内部工具。
+ * PlatformStore 共享内部工具。
  *
  * 关键点（中文）
- * - 这里只放 `ConsoleStore` 内部多个子模块共用的类型与纯函数。
+ * - 这里只放 `PlatformStore` 内部多个子模块共用的类型与纯函数。
  * - 对外不暴露业务语义，只服务 `utils/store/*` 内部实现。
  */
 
@@ -13,12 +13,12 @@ import type { StoredChannelAccountChannel } from "@/shared/types/Store.js";
 /**
  * Drizzle SQLite 实例类型。
  */
-export type ConsoleDrizzleDb = ReturnType<typeof drizzle>;
+export type PlatformDrizzleDb = ReturnType<typeof drizzle>;
 
 /**
- * ConsoleStore 子模块上下文。
+ * PlatformStore 子模块上下文。
  */
-export interface ConsoleStoreContext {
+export interface PlatformStoreContext {
   /**
    * 原始 SQLite 连接。
    */
@@ -26,7 +26,7 @@ export interface ConsoleStoreContext {
   /**
    * Drizzle 查询实例。
    */
-  db: ConsoleDrizzleDb;
+  db: PlatformDrizzleDb;
 }
 
 /**