@luoyi-dsh/instagram-mcp 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 瑞米
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,213 @@
-# Temporary Holding Version
+# DSH Instagram FastMCP 核心服務插件 (`dsh-instagram-mcp`)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> DeepSeek Harness (DSH) 官方底層 Instagram 核心服務外掛。
+> 負責管理獨立的 Python FastMCP 子進程、維持登入 Session 憑證，並向 DSH Tools 與其他外掛提供標準 Model Context Protocol (MCP) 操作介面。
+
+---
+
+## 🌟 核心職責
+
+1. **Python 虛擬環境自動維護**：
+   - 自動檢測系統 Python / `uv` 環境。
+   - 自動於插件目錄建立獨立 `.venv` 並安裝 `vendor/instagram-mcp/requirements.txt` (`instagrapi`, `mcp<2`, `pydantic` 等)。
+2. **FastMCP Stdio 子進程生命週期**：
+   - 以 MCP 標準 Stdio 通訊協定管理 `vendor/instagram-mcp/server.py`。
+   - 支援優雅重啟、斷線重連與進程清理。
+3. **Instagram Session 持久化與雙重驗證**：
+   - 支援帳號密碼登入、Session 快取載入 (`data/ig_session.json`) 與 2FA 驗證碼挑戰。
+4. **全域單例共享服務 (Zero-Error Singleton)**：
+   - 導出 `getSharedMcpService()` 與 `getSharedMcpClient()`，供業務層插件 (`dsh-instagram-plugin`、`dsh-instagram-scroll`) 安全共享底層連線與登入狀態，完全免除 Cordis 的屬性存取拋錯。
+5. **標準 MCP Tools 註冊**：
+   - 向 DSH `ctx.tools` 註冊 9 項 Instagram 核心底層工具，供 AI 主模型直接調用。
+
+---
+
+## 📁 模組目錄架構
+
+```text
+dsh-instagram-mcp/
+├── cordis.patch.yml               # DSH bundle patch 宣告
+├── package.json                   # 模組定義與依賴宣告
+├── tsconfig.json                  # TypeScript 編譯設定
+├── data/
+│   ├── config.json                # 本地持久化設定檔
+│   └── ig_session.json            # Instagram 登入憑證與 Session 狀態
+├── vendor/
+│   └── instagram-mcp/             # 獨立 Python FastMCP 核心模組
+│       ├── requirements.txt       # Python 依賴清單 (instagrapi 等)
+│       ├── server.py              # FastMCP Stdio 伺服器入口
+│       ├── auth.py                # 帳號認證、Session 復原與 2FA 挑戰
+│       └── core.py                # 核心操作 (貼文、留言、私訊、標籤搜尋)
+└── src/
+    ├── index.ts                   # Cordis 外掛入口與單例服務掛載
+    ├── service.ts                 # InstagramMcpService 服務狀態管理器
+    ├── config.ts                  # Schemastery 設定模型定義
+    ├── types.ts                   # 型別與資料結構宣告
+    ├── lib/
+    │   ├── env.ts                 # Python 虛擬環境檢查與依賴安裝
+    │   ├── mcp.ts                 # FastMCP Client 子進程通訊封裝
+    │   └── hostdeps.ts            # DSH 宿主相容層
+    └── tools/
+        └── mcpTools.ts            # 向 DSH Tools 註冊之 9 項核心工具
+```
+
+---
+
+## 🛠️ 提供之 9 項標準 MCP 工具
+
+| 工具名稱 | 說明 | 參數 |
+| :--- | :--- | :--- |
+| **`ig_check_status`** | 檢查 FastMCP 服務狀態與當前 Instagram 登入情形 | 無 |
+| **`ig_login`** | 登入 Instagram 帳號或重新驗證 Session 快取 | `username`, `password`, `two_factor_code`, `proxy_url` |
+| **`ig_search_hashtag`** | 搜尋指定 Hashtag 標籤之精選/最新貼文清單 | `hashtag` (string), `limit` (number) |
+| **`ig_get_post_context`**| 抓取指定貼文之完整內文、發布者資訊與相鄰留言上下文 | `media_pk` (string), `comment_limit` (number) |
+| **`ig_post_comment`** | 於指定貼文發表新留言，或對特定留言進行巢狀回覆 | `media_pk` (string), `text` (string), `reply_to_comment_pk` (可選) |
+| **`ig_get_unread_dms`** | 讀取最新或未讀之 Instagram 私訊對話線程 | `limit` (number) |
+| **`ig_send_dm`** | 發送 Instagram Direct Message 私訊給特定線程 | `thread_id` (string), `text` (string) |
+| **`ig_get_timeline_feed`**| 抓取使用者首頁動態牆 (Timeline Feed) 貼文清單 | `limit` (number) |
+| **`ig_like_media`** | 對指定的 Instagram 貼文按讚 | `media_pk` (string) |
+
+---
+
+## 💻 如何調用工具 (How to Call Tools)
+
+### 方式一：在 DSH 對話中由主模型自然語言調用
+
+只要在 DSH 介面以日常中文提問，AI 即會自動分析意圖並調用相應工具：
+
+```text
+💬 範例 1：搜尋標籤貼文
+「幫我搜尋 Instagram 上關於 #deepseek 標籤的最新 5 則貼文」
+-> AI 將調用：ig_search_hashtag(hashtag="deepseek", limit=5)
+
+💬 範例 2：獲取貼文上下文與留言
+「這篇貼文 PK 是 3123456789012345678，幫我看完整內文與底下留言」
+-> AI 將調用：ig_get_post_context(media_pk="3123456789012345678", comment_limit=10)
+
+💬 範例 3：發表留言或巢狀回覆
+「在貼文 3123456789012345678 下留言：『很實用的架構分享，收藏了！』」
+-> AI 將調用：ig_post_comment(media_pk="3123456789012345678", text="很實用的架構分享，收藏了！")
+
+💬 範例 4：查看未讀私訊
+「查看我目前有沒有未讀的 Instagram 私訊？」
+-> AI 將調用：ig_get_unread_dms(limit=5)
+
+💬 範例 5：發送私訊
+「發送私訊給線程 17841400000000000 說：『您好，已收到您的諮詢，稍後聯絡！』」
+-> AI 將調用：ig_send_dm(thread_id="17841400000000000", text="您好，已收到您的諮詢，稍後聯絡！")
+```
+
+---
+
+### 方式二：MCP 標準協議 (JSON-RPC) 調用範例
+
+#### 1. 搜尋標籤 (`ig_search_hashtag`)
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "tools/call",
+  "params": {
+    "name": "ig_search_hashtag",
+    "arguments": {
+      "hashtag": "coding",
+      "limit": 8
+    }
+  }
+}
+```
+
+#### 2. 發布貼文留言 (`ig_post_comment`)
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "method": "tools/call",
+  "params": {
+    "name": "ig_post_comment",
+    "arguments": {
+      "media_pk": "3123456789012345678",
+      "text": "寫得很詳盡！謝謝分享。"
+    }
+  }
+}
+```
+
+#### 3. 貼文點讚 (`ig_like_media`)
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 3,
+  "method": "tools/call",
+  "params": {
+    "name": "ig_like_media",
+    "arguments": {
+      "media_pk": "3123456789012345678"
+    }
+  }
+}
+```
+
+---
+
+### 方式三：在 TypeScript / Node.js 程式碼中跨插件調用
+
+任何其他 DSH 外掛（如 `dsh-instagram-plugin`、`dsh-instagram-scroll`）皆可直接透過單例匯入調用底層客戶端：
+
+```typescript
+import { getSharedMcpClient } from 'dsh-instagram-mcp'
+
+const mcpClient = getSharedMcpClient()
+if (mcpClient && mcpClient.ready) {
+  // 1. 搜尋標籤
+  const posts = await mcpClient.igSearchHashtag('tech', 10)
+  console.log('搜尋結果:', posts)
+
+  // 2. 抓取貼文脈絡
+  const context = await mcpClient.igGetPostContext('3123456789012345678', 5)
+
+  // 3. 發送私訊
+  await mcpClient.igSendDm({
+    thread_id: '17841400000000000',
+    text: '感謝您的來訊！'
+  })
+}
+```
+
+---
+
+## ⚙️ 設定參數說明
+
+> 💡 **提示**：DSH Web 預設埠為 **3080**（`http://127.0.0.1:3080`），不是 5173。若啟動時帶了 `--port` 參數，請改用實際埠號。
+
+可於 DSH 設定面板或 `data/config.json` 中配置：
+
+- **`username`**：Instagram 使用者名稱。
+- **`password`**：Instagram 登入密碼（存在有效 Session 時可留空）。
+- **`twoFactorCode`**：2FA 雙步驟驗證碼。
+- **`sessionPath`**：Session 檔案路徑（預設 `data/ig_session.json`）。
+- **`proxyUrl`**：代理伺服器 URL（例如 `http://127.0.0.1:7890`，選填）。
+- **`pythonPath`**：自訂 Python 可執行檔路徑（留空則自動探測系統 Python / uv）。
+- **`autoStart`**：啟動 DSH 時是否自動啟動 FastMCP 子進程並嘗試登入（預設 `true`）。
+
+---
+
+## 🚀 編譯與安裝方式
+
+### 1. 手動編譯
+```powershell
+cd c:\Users\asiat\Downloads\dsh\dsh-instagram-mcp
+npm install
+npm run build
+```
+
+### 2. 註冊至 DSH Profile
+```powershell
+dsh plugin --profile web add link:c:\Users\asiat\Downloads\dsh\dsh-instagram-mcp
+```
+
+### 3. 一鍵全自動安裝腳本
+執行根目錄下的自動化更新腳本（包含全部 Instagram 外掛）：
+```powershell
+powershell -ExecutionPolicy Bypass -File .\Updata_Plugin_Instagram.ps1
+```

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# ============================================================================
+# dsh-instagram-mcp —— DSH bundle patch（插件掛載宣告）
+# ============================================================================
+
+- insert:
+    - id: instagram-mcp
+      name: dsh-instagram-mcp
+      config:
+        enabled: true

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * src/config.ts —— Instagram MCP Plugin 配置定義
+ */
+export interface InstagramMcpConfig {
+    pythonPath?: string;
+    sessionPath?: string;
+    username?: string;
+    password?: string;
+    twoFactorCode?: string;
+    proxyUrl?: string;
+    autoStart?: boolean;
+}
+export declare const defaultMcpConfig: InstagramMcpConfig;
+export declare function unwrapMcpValue<T>(val: any, fallback: T): T;
+export declare function sanitizeMcpConfig(raw: any): InstagramMcpConfig;
+export declare function buildMcpConfigSchema(z: any): any;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAG9B,CAAA;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAW1D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAW9D;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,GAAG,OAe1C"}

package/dist/config.js

@@ -0,0 +1,50 @@
+/**
+ * src/config.ts —— Instagram MCP Plugin 配置定義
+ */
+export const defaultMcpConfig = {
+    sessionPath: 'data/ig_session.json',
+    autoStart: true,
+};
+export function unwrapMcpValue(val, fallback) {
+    if (val === null || val === undefined)
+        return fallback;
+    if (val === '[object Object]')
+        return fallback;
+    if (typeof val === 'object' && typeof val.get === 'function') {
+        const v = val.get();
+        return (v !== undefined && v !== null && typeof v !== 'object') ? v : fallback;
+    }
+    if (typeof val === 'object' && !Array.isArray(val)) {
+        return fallback;
+    }
+    return val;
+}
+export function sanitizeMcpConfig(raw) {
+    const c = raw || {};
+    return {
+        pythonPath: unwrapMcpValue(c.pythonPath, ''),
+        sessionPath: unwrapMcpValue(c.sessionPath, defaultMcpConfig.sessionPath) || 'data/ig_session.json',
+        username: unwrapMcpValue(c.username, ''),
+        password: unwrapMcpValue(c.password, ''),
+        twoFactorCode: unwrapMcpValue(c.twoFactorCode, ''),
+        proxyUrl: unwrapMcpValue(c.proxyUrl, ''),
+        autoStart: unwrapMcpValue(c.autoStart, true),
+    };
+}
+export function buildMcpConfigSchema(z) {
+    return z.object({
+        pythonPath: z
+            .string()
+            .description('指定 Python 3 執行檔路徑 (留空則使用自動偵測或內建虛擬環境)'),
+        sessionPath: z
+            .string()
+            .default('data/ig_session.json')
+            .description('Instagram Session 快取持久化檔案相對路徑'),
+        username: z.string().description('Instagram 使用者帳號 (登入用)'),
+        password: z.string().description('Instagram 密碼 (已有 Session 時可留空)'),
+        twoFactorCode: z.string().description('2FA 雙步驟驗證代碼 (遇到挑戰時填入)'),
+        proxyUrl: z.string().description('HTTP/SOCKS5 代理伺服器 URL (防風控)'),
+        autoStart: z.boolean().default(true).description('是否在插件載入時自動啟動 FastMCP 子進程'),
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,CAAC,MAAM,gBAAgB,GAAuB;IAClD,WAAW,EAAE,sBAAsB;IACnC,SAAS,EAAE,IAAI;CAChB,CAAA;AAED,MAAM,UAAU,cAAc,CAAI,GAAQ,EAAE,QAAW;IACrD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IACtD,IAAI,GAAG,KAAK,iBAAiB;QAAE,OAAO,QAAQ,CAAA;IAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAA;QACnB,OAAO,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IAChF,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,GAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,CAAA;IACnB,OAAO;QACL,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5C,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC,IAAI,sBAAsB;QAClG,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;QACxC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;QACxC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC;QAClD,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;QACxC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC;KAC7C,CAAA;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAM;IACzC,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,WAAW,CAAC,sCAAsC,CAAC;QACtD,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,OAAO,CAAC,sBAAsB,CAAC;aAC/B,WAAW,CAAC,+BAA+B,CAAC;QAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,uBAAuB,CAAC;QACzD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,gCAAgC,CAAC;QAClE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,uBAAuB,CAAC;QAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,6BAA6B,CAAC;QAC/D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC;KAC7E,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * src/index.ts —— DSH Instagram FastMCP 核心服務插件入口
+ * ============================================================================
+ * 職責：
+ * 1. 導出標準 Cordis 插件結構 (name, inject, Config, apply)。
+ * 2. 註冊與維護 Instagram FastMCP 服務單例 (getSharedMcpService / getSharedMcpClient)，
+ *    供其他外掛 (dsh-instagram-plugin, dsh-instagram-scroll 等) 安全共享底層 FastMCP 連線與 Session，
+ *    完全免除 Cordis 的 property access 拋錯。
+ * 3. 立即向 DSH Tools 註冊標準 Instagram 工具集 (ig_login, ig_search_hashtag, 等)。
+ * 4. 管理 Python 獨立虛擬環境與 FastMCP 子進程生命週期。
+ * ============================================================================
+ */
+import { InstagramMcpConfig } from './config.js';
+import { InstagramMcpClient } from './lib/mcp.js';
+import { InstagramMcpService } from './service.js';
+export * from './types.js';
+export * from './config.js';
+export * from './lib/mcp.js';
+export * from './lib/env.js';
+export * from './service.js';
+export declare function getSharedMcpService(): InstagramMcpService | null;
+export declare function setSharedMcpService(svc: InstagramMcpService | null): void;
+export declare function getSharedMcpClient(): InstagramMcpClient | null;
+export declare const name = "instagram-mcp";
+export declare const inject: string[];
+export declare const Config: any;
+export declare function apply(ctx: any, userConfig?: Partial<InstagramMcpConfig>): void;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: any;
+    apply: typeof apply;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAA0C,kBAAkB,EAAqB,MAAM,aAAa,CAAA;AAG3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAK5B,wBAAgB,mBAAmB,IAAI,mBAAmB,GAAG,IAAI,CAGhE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,QAGlE;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,GAAG,IAAI,CAE9D;AAED,eAAO,MAAM,IAAI,kBAAkB,CAAA;AACnC,eAAO,MAAM,MAAM,UAAY,CAAA;AAI/B,eAAO,MAAM,MAAM,KAAkC,CAAA;AAErD,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,GAAE,OAAO,CAAC,kBAAkB,CAAM,QAwJ3E;;;;;;;AAED,wBAKC"}

package/dist/index.js

@@ -0,0 +1,188 @@
+/**
+ * src/index.ts —— DSH Instagram FastMCP 核心服務插件入口
+ * ============================================================================
+ * 職責：
+ * 1. 導出標準 Cordis 插件結構 (name, inject, Config, apply)。
+ * 2. 註冊與維護 Instagram FastMCP 服務單例 (getSharedMcpService / getSharedMcpClient)，
+ *    供其他外掛 (dsh-instagram-plugin, dsh-instagram-scroll 等) 安全共享底層 FastMCP 連線與 Session，
+ *    完全免除 Cordis 的 property access 拋錯。
+ * 3. 立即向 DSH Tools 註冊標準 Instagram 工具集 (ig_login, ig_search_hashtag, 等)。
+ * 4. 管理 Python 獨立虛擬環境與 FastMCP 子進程生命週期。
+ * ============================================================================
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildMcpConfigSchema, defaultMcpConfig, sanitizeMcpConfig } from './config.js';
+import { loadSchemastery } from './lib/hostdeps.js';
+import { ensurePythonEnv } from './lib/env.js';
+import { InstagramMcpClient } from './lib/mcp.js';
+import { registerMcpTools } from './tools/mcpTools.js';
+import { InstagramMcpService } from './service.js';
+export * from './types.js';
+export * from './config.js';
+export * from './lib/mcp.js';
+export * from './lib/env.js';
+export * from './service.js';
+// 全局單例共享機制 (跨模組與全域保證零拋錯存取)
+let sharedService = null;
+export function getSharedMcpService() {
+    if (sharedService)
+        return sharedService;
+    return globalThis.__DSH_INSTAGRAM_MCP__ || null;
+}
+export function setSharedMcpService(svc) {
+    sharedService = svc;
+    globalThis.__DSH_INSTAGRAM_MCP__ = svc;
+}
+export function getSharedMcpClient() {
+    return getSharedMcpService()?.client || null;
+}
+export const name = 'instagram-mcp';
+export const inject = ['tools'];
+// 載入 schemastery
+const zInstance = await loadSchemastery();
+export const Config = buildMcpConfigSchema(zInstance);
+export function apply(ctx, userConfig = {}) {
+    const pluginRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+    const dataDir = join(pluginRoot, 'data');
+    if (!existsSync(dataDir)) {
+        mkdirSync(dataDir, { recursive: true });
+    }
+    const configFile = join(dataDir, 'config.json');
+    const localSavedConfig = (() => {
+        try {
+            if (existsSync(configFile)) {
+                return JSON.parse(readFileSync(configFile, 'utf-8'));
+            }
+        }
+        catch { }
+        return {};
+    })();
+    const activeConfig = sanitizeMcpConfig({
+        ...defaultMcpConfig,
+        ...userConfig,
+        ...localSavedConfig,
+    });
+    // 若 config.json 尚不存在，動態創建初始配置檔
+    if (!existsSync(configFile)) {
+        try {
+            writeFileSync(configFile, JSON.stringify(activeConfig, null, 2), 'utf-8');
+        }
+        catch { }
+    }
+    // 確保 sessionPath 所在資料夾與 session 初始檔案動態建立
+    const sessionAbsPath = join(pluginRoot, activeConfig.sessionPath || 'data/ig_session.json');
+    const sessionDir = dirname(sessionAbsPath);
+    if (!existsSync(sessionDir)) {
+        try {
+            mkdirSync(sessionDir, { recursive: true });
+        }
+        catch { }
+    }
+    if (!existsSync(sessionAbsPath)) {
+        try {
+            writeFileSync(sessionAbsPath, '{}', 'utf-8');
+        }
+        catch { }
+    }
+    const log = (msg) => {
+        console.log(`[IG-MCP] ${msg}`);
+    };
+    log(`Instagram FastMCP 插件初始化中... (路徑: ${pluginRoot})`);
+    // 1. 初始化並綁定單例服務
+    const service = new InstagramMcpService(activeConfig);
+    setSharedMcpService(service);
+    try {
+        if (typeof ctx?.provide === 'function') {
+            ctx.provide('instagramMcp');
+        }
+    }
+    catch { }
+    let mcpClient = null;
+    let isDisposed = false;
+    // 2. 立即註冊 Tools 給主模型與其他插件
+    registerMcpTools(ctx, activeConfig, () => mcpClient, () => service.loginStatus, log);
+    // 3. 異步啟動 Python 子進程與 FastMCP 伺服器
+    const initEngine = async () => {
+        try {
+            log('檢查 Python 虛擬環境...');
+            const envRes = await ensurePythonEnv(pluginRoot, activeConfig.pythonPath, log);
+            if (!envRes.ok) {
+                service.setLoginStatus({
+                    ok: false,
+                    message: `Python 虛擬環境未就緒: ${envRes.error}`,
+                });
+                log(`❌ ${service.loginStatus.message}`);
+                return;
+            }
+            if (isDisposed)
+                return;
+            const serverScript = join(pluginRoot, 'vendor', 'instagram-mcp', 'server.py');
+            mcpClient = new InstagramMcpClient({
+                pythonPath: envRes.pythonPath,
+                serverScriptPath: serverScript,
+                cwd: join(pluginRoot, 'vendor', 'instagram-mcp'),
+                log: (m) => log(`[Engine] ${m}`),
+            });
+            await mcpClient.start();
+            service.setClient(mcpClient);
+            log('✅ Python FastMCP 伺服器握手成功！');
+            // 4. 若已配置登入資訊或存在 Session 快取，嘗試登入
+            const sessionAbsPath = join(pluginRoot, activeConfig.sessionPath || 'data/ig_session.json');
+            const loginRes = await mcpClient.igLogin({
+                username: activeConfig.username,
+                password: activeConfig.password,
+                session_path: sessionAbsPath,
+                two_factor_code: activeConfig.twoFactorCode,
+                proxy_url: activeConfig.proxyUrl,
+            });
+            if (loginRes?.ok) {
+                service.setLoginStatus({
+                    ok: true,
+                    method: loginRes.method,
+                    message: `已登入 (${loginRes.method === 'session' ? 'Session 快取' : '帳號密碼'}) - @${loginRes.username || activeConfig.username}`,
+                });
+                log(`🎉 Instagram 登入就緒！${service.loginStatus.message}`);
+            }
+            else {
+                service.setLoginStatus({
+                    ok: false,
+                    message: loginRes?.message || '等待登入或驗證憑證',
+                });
+                log(`ℹ️ ${service.loginStatus.message}`);
+            }
+        }
+        catch (err) {
+            service.setLoginStatus({
+                ok: false,
+                message: `FastMCP 啟動異常: ${err.message}`,
+            });
+            log(`❌ FastMCP 異常: ${err.message}`);
+        }
+    };
+    if (activeConfig.autoStart !== false) {
+        initEngine().catch((e) => log(`initEngine unhandled error: ${e.message}`));
+    }
+    // 4. 優雅卸載清理
+    const dispose = async () => {
+        isDisposed = true;
+        if (mcpClient) {
+            await mcpClient.stop().catch(() => { });
+            mcpClient = null;
+            service.setClient(null);
+        }
+        setSharedMcpService(null);
+        log('插件已成功卸載。');
+    };
+    if (typeof ctx?.on === 'function') {
+        ctx.on('dispose', dispose);
+    }
+}
+export default {
+    name,
+    inject,
+    Config,
+    apply,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAsB,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC3G,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAE5B,2BAA2B;AAC3B,IAAI,aAAa,GAA+B,IAAI,CAAA;AAEpD,MAAM,UAAU,mBAAmB;IACjC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAA;IACvC,OAAQ,UAAkB,CAAC,qBAAqB,IAAI,IAAI,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAA+B;IACjE,aAAa,GAAG,GAAG,CAClB;IAAC,UAAkB,CAAC,qBAAqB,GAAG,GAAG,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,mBAAmB,EAAE,EAAE,MAAM,IAAI,IAAI,CAAA;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,eAAe,CAAA;AACnC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;AAE/B,iBAAiB;AACjB,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE,CAAA;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAA;AAErD,MAAM,UAAU,KAAK,CAAC,GAAQ,EAAE,aAA0C,EAAE;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACnE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACzC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;IAC/C,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,OAAO,EAAE,CAAA;IACX,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,YAAY,GAAuB,iBAAiB,CAAC;QACzD,GAAG,gBAAgB;QACnB,GAAG,UAAU;QACb,GAAG,gBAAgB;KACpB,CAAC,CAAA;IAEF,+BAA+B;IAC/B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAC3E,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,yCAAyC;IACzC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,WAAW,IAAI,sBAAsB,CAAC,CAAA;IAC3F,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,aAAa,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC,CAAA;IAChC,CAAC,CAAA;IAED,GAAG,CAAC,oCAAoC,UAAU,GAAG,CAAC,CAAA;IAEtD,gBAAgB;IAChB,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAA;IACrD,mBAAmB,CAAC,OAAO,CAAC,CAAA;IAE5B,IAAI,CAAC;QACH,IAAI,OAAO,GAAG,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;YACvC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,IAAI,SAAS,GAA8B,IAAI,CAAA;IAC/C,IAAI,UAAU,GAAG,KAAK,CAAA;IAEtB,0BAA0B;IAC1B,gBAAgB,CACd,GAAG,EACH,YAAY,EACZ,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EACzB,GAAG,CACJ,CAAA;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;QAC5B,IAAI,CAAC;YACH,GAAG,CAAC,mBAAmB,CAAC,CAAA;YACxB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;YAC9E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,OAAO,CAAC,cAAc,CAAC;oBACrB,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,mBAAmB,MAAM,CAAC,KAAK,EAAE;iBAC3C,CAAC,CAAA;gBACF,GAAG,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;gBACvC,OAAM;YACR,CAAC;YAED,IAAI,UAAU;gBAAE,OAAM;YAEtB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,CAAA;YAC7E,SAAS,GAAG,IAAI,kBAAkB,CAAC;gBACjC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,gBAAgB,EAAE,YAAY;gBAC9B,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,eAAe,CAAC;gBAChD,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;aACjC,CAAC,CAAA;YAEF,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;YACvB,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;YAC5B,GAAG,CAAC,2BAA2B,CAAC,CAAA;YAEhC,iCAAiC;YACjC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,WAAW,IAAI,sBAAsB,CAAC,CAAA;YAC3F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC;gBACvC,QAAQ,EAAE,YAAY,CAAC,QAAQ;gBAC/B,QAAQ,EAAE,YAAY,CAAC,QAAQ;gBAC/B,YAAY,EAAE,cAAc;gBAC5B,eAAe,EAAE,YAAY,CAAC,aAAa;gBAC3C,SAAS,EAAE,YAAY,CAAC,QAAQ;aACjC,CAAC,CAAA;YAEF,IAAI,QAAQ,EAAE,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,cAAc,CAAC;oBACrB,EAAE,EAAE,IAAI;oBACR,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,OAAO,EAAE,QAAQ,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,QAAQ,QAAQ,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,EAAE;iBAC3H,CAAC,CAAA;gBACF,GAAG,CAAC,qBAAqB,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;YACzD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,cAAc,CAAC;oBACrB,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW;iBAC1C,CAAC,CAAA;gBACF,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;YAC1C,CAAC;QACH,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC;gBACrB,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,iBAAiB,GAAG,CAAC,OAAO,EAAE;aACxC,CAAC,CAAA;YACF,GAAG,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC,CAAA;IAED,IAAI,YAAY,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QACrC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC5E,CAAC;IAED,YAAY;IACZ,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,UAAU,GAAG,IAAI,CAAA;QACjB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACtC,SAAS,GAAG,IAAI,CAAA;YAChB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QACD,mBAAmB,CAAC,IAAI,CAAC,CAAA;QACzB,GAAG,CAAC,UAAU,CAAC,CAAA;IACjB,CAAC,CAAA;IAED,IAAI,OAAO,GAAG,EAAE,EAAE,KAAK,UAAU,EAAE,CAAC;QAClC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC;AAED,eAAe;IACb,IAAI;IACJ,MAAM;IACN,MAAM;IACN,KAAK;CACN,CAAA"}

package/dist/lib/env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * src/lib/env.ts —— Python 虛擬環境自檢與依賴確保
+ */
+export interface PythonEnvResult {
+    ok: boolean;
+    pythonPath: string;
+    error?: string;
+}
+export declare function ensurePythonEnv(packageRoot: string, userConfigPythonPath?: string, log?: (msg: string) => void): Promise<PythonEnvResult>;
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAkB,GACvC,OAAO,CAAC,eAAe,CAAC,CAuG1B"}