name: navi-office description: NaviOffice OA 辦公系統 MCP 整合技能 - 覆蓋系統管理、人力資源、考勤、財務、CRM、銷售、採購、庫存、專案、生產、計量檢測 11 大模組，支援資料查詢與業務操作。

NaviOffice OA 辦公自動化系統

工具名稱以模組字首開頭，詳細引數查閱 references/ 對應文件。

安裝

clawdhub install navi-office

環境變數與安全說明（必讀）

# 必填
NAVI_OFFICE_API_TOKEN=your_api_token_here

# 可選（預設官方地址）
NAVI_OFFICE_API_URL=https://oa.teredy.com/api

# 可選：是否允許非官方域名，預設 false
NAVI_OFFICE_ALLOW_CUSTOM_DOMAIN=false

• 必填：NAVI_OFFICE_API_TOKEN
• 可選：NAVI_OFFICE_API_URL（預設 https://oa.teredy.com/api）
• 可選：NAVI_OFFICE_ALLOW_CUSTOM_DOMAIN（預設 false）

  小蔥技能站7w4.net發現了升級外掛。

• 請求頭：X-Api-Token: ${NAVI_OFFICE_API_TOKEN}
• 預設僅從技能目錄 .env 讀取憑證，避免誤讀當前工作目錄下無關憑證
• 預設只允許官方域名 oa.teredy.com；若使用自定義地址，需顯式設定 NAVI_OFFICE_ALLOW_CUSTOM_DOMAIN=true
• 若無法確認域名來源，請勿使用生產環境真實令牌

CLI 指令碼

NaviOffice/scripts 目錄包含可呼叫指令碼：

• navioffice.sh（Shell）
• navioffice.py（Python）
• navioffice.js（Node.js）

CLI 呼叫示例

部分工具的引數值本身是 JSON 字串（如 employeeData），CLI 呼叫時需對內層 JSON 轉義：

# 普通引數（值為基本型別）
mcporter call navi-office.hr_queryEmployeeInfo --args '{"employeeName":"張三"}'

# 引數值為 JSON 字串時，內層需轉義引號
mcporter call navi-office.hr_updateEmployee --args '{"employeeId":1051,"employeeData":"{\"employeeStatus\":1}"}'

漸進式工具載入（強制）

為減少 token 消耗，禁止首輪把全量工具塞入上下文，必須按下面流程：

1. 先呼叫 tool_catalog，獲取可用模組目錄和工具數量
2. 根據使用者問題只選擇最相關模組
3. 再呼叫 load_module_tools，引數示例：{"module":"attendance","detailLevel":"brief"}
4. 若 brief 不足以確定引數，再對同一模組使用 detailLevel=full
5. 只有跨模組問題才追加載入其他模組，避免全量載入

呼叫規則

• 名稱→ID：使用者提供名稱時，先調查詢介面獲取 ID 再操作（如客戶名→customerId、部門名→deptId、員工名→employeeId）
• 模糊查詢：employeeName deptName customerName orderName supplierName materialName equipmentName instrumentName 等欄位可直接傳名稱，無需先查 ID
• 查詢條件：能夠精準查詢的引數一定要帶上，儘量不要查詢全量列表
• 分頁：列表預設每頁 10 條，用 page / limit 調整
• 日期格式：yyyy-MM-dd 或 yyyyMM
• 許可權：無許可權時返回明確錯誤提示
• 工具載入策略：預設 brief，僅在必要時 full

這個 Skill 做得相當紮實，11大業務模組全覆蓋，文件結構清晰，環境變數配置有安全保障，還提供了漸進式工具載入策略來節省 token 消耗。唯一可惜的是文件更像引數手冊，缺少實際使用場景的示例，對普通使用者來說上手成本略高。總體質量良好，專業度高，但文件親和力還有提升空間。