@ai_mind/ade-plugin-sdk 0.1.0 → 0.2.0

package/index.d.ts

@@ -3,7 +3,8 @@ import type * as ReactDOM from 'react-dom'
 import type { AdeApi } from './types/api.js'
 import type { PluginContext, SessionContext, ChatSession, ChatAdapter } from './types/adapter.js'
 import type {
-  PluginCommandContext, PluginConfig, PluginDisposer, PluginSlotName, PluginViewInfo
+  PluginCommandContext, PluginConfig, PluginDisposer, PluginFileMenuRegistration,
+  PluginSlotName, PluginUiApi, PluginViewInfo, PluginWorkspaceApi
 } from './types/plugins.js'
 
 export type * from './types/plugins.js'
@@ -35,6 +36,8 @@ export interface RendererPluginContext {
   React: typeof React
   ReactDOM: typeof ReactDOM
   api: AdeApi
+  workspace: PluginWorkspaceApi
+  ui: PluginUiApi
   subscriptions: PluginDisposer[]
   getContext(): PluginCommandContext
   useContext(): PluginCommandContext
@@ -44,6 +47,7 @@ export interface RendererPluginContext {
   onConfigChanged(listener: (config: PluginConfig) => void): PluginDisposer
   registerView(view: PluginViewRegistration): PluginDisposer
   registerSlot(name: PluginSlotName, contribution: PluginSlotRegistration): PluginDisposer
+  registerFileMenu(contribution: PluginFileMenuRegistration): PluginDisposer
   registerCommand(id: string, handler: (args: unknown, context: PluginCommandContext) => unknown | Promise<unknown>): PluginDisposer
   /** 优先执行本插件 renderer 命令，其次执行本插件 main 命令；跨插件使用 plugin:ID:command。 */
   executeCommand(id: string, args?: unknown): Promise<unknown>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai_mind/ade-plugin-sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "ADE 可信插件 SDK、类型与 React 插件构建工具",
   "license": "MIT",
   "author": "sepmini",

package/types/ade-types.d.ts

@@ -279,7 +279,7 @@ export interface WorktreeTabState {
     /** 各文件在该 worktree 下的滚动位置（px），用于切回时恢复浏览位置 */
     scrolls: Record<string, number>;
 }
-export type AreaKey = 'project' | 'worktree' | 'files' | 'editor' | 'chat' | 'dingtalk' | 'aone';
+export type AreaKey = 'project' | 'worktree' | 'files' | 'editor' | 'chat' | 'aone';
 export type AoneCategory = 'req' | 'bug' | 'task';
 /** a1 CLI 可用性与 BUC 登录状态。 */
 export interface AoneStatus {
@@ -481,19 +481,10 @@ export interface AgentSettings {
      */
     yolo: string[];
 }
-export interface DingTalkSettings {
-    cli: 'dws' | 'dwsx';
-    dwsxPath: string;
-    /** 留空使用 DWSX_DATA_DIR 或 ~/.local/share/dwsx，与终端共用登录态 */
-    dwsxDataDir?: string;
-    /** dws CLI 路径；留空时自动从 PATH 与常见目录探测 */
-    dwsPath: string;
-}
 export interface AppSettings {
     appearance: AppearanceSettings;
     editor: EditorSettings;
     agents: AgentSettings;
-    dingtalk: DingTalkSettings;
 }
 /** 应用状态（原 state.json + localStorage ade-areas 的统一归宿） */
 export interface AdeState {
@@ -515,7 +506,6 @@ export interface SettingsPatch {
         appearance?: Partial<AppearanceSettings>;
         editor?: Partial<EditorSettings>;
         agents?: Partial<AgentSettings>;
-        dingtalk?: Partial<DingTalkSettings>;
     };
     state?: Partial<AdeState>;
 }
@@ -523,155 +513,6 @@ export interface SettingsPatch {
 export interface AgentSettingInfo extends ChatAdapterInfo {
     hidden: boolean;
 }
-/** dws / 钉钉集成状态（设置页与钉钉面板共用） */
-export interface DingTalkStatus {
-    cliKind?: 'dws' | 'dwsx';
-    dataDirectory?: string;
-    available: boolean;
-    authenticated: boolean;
-    version?: string;
-    /** dws 0.x 旧版接口线：上传走 doc create 而非 doc import */
-    legacy?: boolean;
-    message: string;
-    executable?: string;
-}
-/** 钉钉在线文档搜索结果条目 */
-export interface DingTalkDocItem {
-    nodeId: string;
-    name: string;
-    docType?: string;
-    url?: string;
-    createTime?: number | string;
-    modifiedTime?: number | string;
-    creatorUid?: string;
-    creatorName?: string;
-    creatorNick?: string;
-    workspaceId?: string;
-    workspaceName?: string;
-}
-export type DingTalkDocDownloadFormat = 'dingdoc' | 'markdown';
-/** 钉钉听记列表条目 */
-export interface DingTalkMinutesItem {
-    taskUuid: string;
-    title: string;
-    url?: string;
-    startTime?: number | string;
-    status?: string;
-    creatorUid?: string;
-    creatorName?: string;
-    creatorNick?: string;
-}
-/** 下载到本地的结果 */
-export interface DingTalkDownloadResult {
-    kind: 'doc' | 'minutes';
-    path: string;
-    title?: string;
-    url?: string;
-    taskUuid?: string;
-    /** dingdoc / dingmin 文件夹等场景下应打开的首选文件 */
-    entryPath?: string;
-    /** 钉钉文档/听记下载格式 */
-    format?: 'dingdoc' | 'dingmin' | 'markdown';
-}
-/** 可作为上传目标的钉钉知识库 / 个人空间 */
-export interface DingTalkUploadWorkspace {
-    workspaceId: string;
-    name: string;
-    /** org = 组织知识库；mine = 「我的文档」个人空间 */
-    type: 'org' | 'mine';
-}
-/** 知识库内的文件夹节点（上传目标位置选择） */
-export interface DingTalkUploadFolderNode {
-    nodeId: string;
-    name: string;
-}
-/** 粘贴钉钉链接后解析出的上传目标 */
-export interface DingTalkUploadTarget {
-    /** 知识库 ID / URL */
-    workspace: string;
-    /** 文件夹 ID / URL */
-    folder: string;
-    /** 给人看的位置描述 */
-    label: string;
-    /** 链接指向文档本身时：可作为覆盖上传目标 */
-    document?: {
-        nodeId: string;
-        name: string;
-    };
-}
-/** 上传本地 Markdown 为钉钉文档的结果 */
-export interface DingTalkUploadResult {
-    success: boolean;
-    documentUrl?: string;
-    nodeId?: string;
-    documentName?: string;
-    taskId?: string;
-    message?: string;
-    /** 随文档上传的本地图片（含 SVG）统计；无本地图片时不存在 */
-    images?: {
-        total: number;
-        inserted: number;
-        /** 上传失败的本地图片文件名 */
-        missing: string[];
-        /** 未能清理的占位块数量 */
-        leftoverPlaceholders: number;
-    };
-}
-/**
- * dwsx JSONML 读取范围。不传 scope = 整篇 canonical body（root）；
- * outline 只取标题大纲（fragment，heading 带 uuid，可当块 ID）。
- */
-export type DingTalkJsonmlScope = 'outline' | 'tags' | 'section' | 'range';
-/** dwsx doc read --content-format jsonml 的读取选项 */
-export interface DingTalkJsonmlReadOptions {
-    scope?: DingTalkJsonmlScope;
-    /** scope=tags：只取指定标签的块 */
-    tags?: string[];
-    /** scope=range：起始块 ID（可从块列表 / outline 的 uuid 取） */
-    startBlockId?: string;
-    /** scope=range：结束块 ID */
-    endBlockId?: string;
-    /** scope=section/outline：最大层级 */
-    maxDepth?: number;
-    /** 指定文档历史版本 */
-    version?: number | string;
-    /** 落盘路径；留空写入 ADE 钉钉缓存目录，读回文件即覆盖前的备份 */
-    outputPath?: string;
-}
-/** JSONML canonical body（["root"|"fragment", attrs, ...blocks]）读取结果 */
-export interface DingTalkJsonmlDocument {
-    nodeId: string;
-    jsonml: unknown[];
-    contentFormat: 'jsonml';
-    /** 落盘备份路径，可直接作为 overwriteDocJsonml 的 filePath 回写 */
-    savedPath?: string;
-    bytes?: number;
-    revision?: string;
-    scope?: DingTalkJsonmlScope;
-}
-/**
- * JSONML 覆盖输入：裸数组 / { jsonml: [...] } / { jsonml: "…" } / 读回落盘的信封。
- * filePath 与对象形态都接受，ADE 与 dwsx 一样逐层解包。
- */
-export type DingTalkJsonmlInput = unknown[] | {
-    jsonml: unknown;
-} | {
-    filePath: string;
-};
-/** JSONML 整篇覆盖结果 */
-export interface DingTalkJsonmlWriteResult {
-    success: boolean;
-    message?: string;
-    nodeId?: string;
-    documentUrl?: string;
-    documentName?: string;
-    chunksWritten?: number;
-}
-/** 块 element 写入结果（dwsx doc block update / insert） */
-export interface DingTalkBlockWriteResult {
-    success: boolean;
-    message?: string;
-}
 /** 日志等级：error > warn > info > debug */
 export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
 /** 单条日志 */
@@ -694,19 +535,3 @@ export interface LogFilter {
     query?: string;
     limit?: number;
 }
-/** 可恢复的钉钉上传任务，正文与图片分别记录完成状态。 */
-export interface DingTalkUploadJob {
-    filePath: string;
-    title?: string;
-    folder?: string;
-    workspace?: string;
-    nodeId?: string;
-    status: 'running' | 'failed' | 'completed';
-    step: string;
-    error?: string;
-    result?: DingTalkUploadResult;
-    steps: {
-        label: string;
-        status: 'running' | 'completed' | 'failed';
-    }[];
-}

package/types/api.d.ts

@@ -1,6 +1,6 @@
 // 由 sdk/scripts/sync-types.mjs 从 ADE 宿主生成，请勿手工修改。
 import type { PluginCommandContext, PluginConfig, PluginInstallRequest } from './plugins.js';
-import type { AdeSettingsFile, AgentSettingInfo, AoneBoardData, AoneBoardRequest, AoneCreateField, AoneCreateRequest, AoneStatus, AoneUpdateRequest, AoneWorkItem, AoneWorkItemDetail, ChatApprovalResponse, ChatAdapterInfo, ChatAttachment, ChatAttachmentKind, ChatSessionInfo, ChatSessionRecord, CliModelOption, CliOption, CopiedEntry, DingTalkBlockWriteResult, DingTalkDocDownloadFormat, DingTalkDocItem, DingTalkDownloadResult, DingTalkJsonmlDocument, DingTalkJsonmlInput, DingTalkJsonmlReadOptions, DingTalkJsonmlWriteResult, DingTalkMinutesItem, DingTalkStatus, DingTalkUploadFolderNode, DingTalkUploadResult, DingTalkUploadJob, DingTalkUploadTarget, DingTalkUploadWorkspace, FileNode, FileStat, LogEntry, LogFilter, PluginInfo, Project, SettingsPatch, StructuredEvent, Worktree } from './ade-types.js';
+import type { AdeSettingsFile, AgentSettingInfo, AoneBoardData, AoneBoardRequest, AoneCreateField, AoneCreateRequest, AoneStatus, AoneUpdateRequest, AoneWorkItem, AoneWorkItemDetail, ChatApprovalResponse, ChatAdapterInfo, ChatAttachment, ChatAttachmentKind, ChatSessionInfo, ChatSessionRecord, CliModelOption, CliOption, CopiedEntry, FileNode, FileStat, LogEntry, LogFilter, PluginInfo, Project, SettingsPatch, StructuredEvent, Worktree } from './ade-types.js';
 export interface ChatEvent {
     id: string;
     data?: string;
@@ -140,47 +140,6 @@ declare const api: {
         listAgents: () => Promise<AgentSettingInfo[]>;
         onChanged: (cb: (file: AdeSettingsFile) => void) => (() => void);
     };
-    dingtalk: {
-        getUploadJob: (filePath: string) => Promise<DingTalkUploadJob | null>;
-        runUploadJob: (request: {
-            filePath: string;
-            title?: string;
-            folder?: string;
-            workspace?: string;
-            nodeId?: string;
-        }, retry?: boolean) => Promise<DingTalkUploadJob>;
-        getStatus: () => Promise<DingTalkStatus>;
-        login: () => Promise<{
-            started: boolean;
-        }>;
-        restartWukong: () => Promise<{
-            restarted: boolean;
-            message: string;
-        }>;
-        searchDocs: (query: string, source?: "recent" | "mine") => Promise<DingTalkDocItem[]>;
-        listMinutes: (query: string) => Promise<DingTalkMinutesItem[]>;
-        previewDoc: (node: string, preferredName?: string) => Promise<DingTalkDownloadResult>;
-        downloadDoc: (node: string, targetDir: string, format?: DingTalkDocDownloadFormat, preferredName?: string) => Promise<DingTalkDownloadResult>;
-        downloadMinutes: (taskUuid: string, targetDir: string, outputName?: string, format?: "dingmin" | "markdown") => Promise<DingTalkDownloadResult>;
-        uploadMarkdown: (filePath: string, title: string, folder: string, workspace: string) => Promise<DingTalkUploadResult>;
-        listUploadWorkspaces: () => Promise<DingTalkUploadWorkspace[]>;
-        listUploadFolders: (workspaceId: string, parentNodeId?: string) => Promise<DingTalkUploadFolderNode[]>;
-        resolveUploadTarget: (input: string) => Promise<DingTalkUploadTarget>;
-        listUploadDocs: (workspaceId: string, parentNodeId?: string) => Promise<DingTalkUploadFolderNode[]>;
-        overwriteDoc: (nodeId: string, filePath: string) => Promise<DingTalkUploadResult>;
-        readDocJsonml: (nodeId: string, options?: DingTalkJsonmlReadOptions) => Promise<DingTalkJsonmlDocument>;
-        overwriteDocJsonml: (nodeId: string, input: DingTalkJsonmlInput) => Promise<DingTalkJsonmlWriteResult>;
-        createDocWithJsonml: (name: string, input: DingTalkJsonmlInput, location?: {
-            folder?: string;
-            workspace?: string;
-        }) => Promise<DingTalkJsonmlWriteResult>;
-        listDocBlockElements: (nodeId: string, options?: {
-            startIndex?: number;
-            contentFormat?: "element" | "jsonml";
-        }) => Promise<unknown[]>;
-        updateDocBlock: (nodeId: string, blockId: string, element: unknown) => Promise<DingTalkBlockWriteResult>;
-        insertDocBlock: (nodeId: string, index: number, element: unknown) => Promise<DingTalkBlockWriteResult>;
-    };
     aone: {
         getStatus: () => Promise<AoneStatus>;
         loadBoard: (request: AoneBoardRequest) => Promise<AoneBoardData>;

package/types/plugins.d.ts

@@ -69,6 +69,37 @@ export interface PluginCommandContext {
   filePath: string | null
 }
 
+/** 文件树菜单捕获的节点与选择；不暴露宿主 store 或 DOM。 */
+export interface PluginFileMenuNode {
+  name: string
+  path: string
+  type: 'file' | 'dir'
+}
+export interface PluginFileMenuContext extends PluginCommandContext {
+  node: PluginFileMenuNode
+  isRoot: boolean
+  selection: PluginFileMenuNode[]
+}
+export interface PluginFileMenuRegistration {
+  id: string
+  label: string
+  order?: number
+  when?: (context: PluginFileMenuContext) => boolean
+  enabled?: (context: PluginFileMenuContext) => boolean
+  onSelect(context: PluginFileMenuContext): void | Promise<void>
+}
+export interface PluginWorkspaceApi {
+  /** 仅打开真实普通文件；不存在、目录或过期操作返回 false。 */
+  openFile(path: string): Promise<boolean>
+  /** 刷新当前 worktree 的目录；其他路径及过期结果不改动文件树。 */
+  refreshTree(directory?: string): Promise<void>
+  /** 查询当前未保存标记，不包含编辑器正文。 */
+  isFileDirty(path: string): boolean
+}
+export interface PluginUiApi {
+  showToast(message: string, url?: string): void
+}
+
 export interface PluginViewInfo {
   id: string
   title: string