前言¶
在做 DeepSeek Harness（DSH）智能體時，如果接入 PollyReach 的電話能力，通常要處理憑據持久化、賬戶激活、外呼任務提交、結果輪詢、餘額查詢和來電數據讀取等步驟。dsh-pollyreach 把這部分流程封裝爲 DSH 插件：它向當前 Harness 註冊 PollyReach 相關工具和一個 skill，也提供一組 shell 腳本用於人工調試。
下面介紹它的定位、能力、安裝方式、配置和安全注意事項。
這是什麼¶
dsh-pollyreach 是一個可分發的 DeepSeek Harness 插件包，包名爲 dsh-pollyreach，版本爲 1.0.3，許可證爲 MIT。
它的主要作用是：
- 註冊並安全持久化 PollyReach 憑據；
- 完成賬戶激活並獲取分配的電話號碼；
- 提交外呼任務並輪詢完整結果；
- 查詢信用餘額，不把零餘額當作無效令牌；
- 獲取未讀來電數據，不展平 API 響應；
- 更新來電應答提示詞。
插件會註冊七個原生模型可調用工具，並註冊 PollyReach skill。倉庫地址爲 https://github.com/PollyReach/pollyreach-dsh-plugin；已覈實資料未提供獨立維護者字段。
核心工具¶
下面列出插件註冊的工具及其用途：
| 工具 | 用途 |
|---|---|
pollyreach_register |
註冊並原子保存新憑據 |
pollyreach_activation_status |
檢查/輪詢激活並保存分配的號碼 |
pollyreach_send_call |
提交一個外呼任務 |
pollyreach_query_call |
輪詢實際外呼結果 |
pollyreach_balance |
返回完整餘額響應 |
pollyreach_inbound_calls |
返回未讀來電數據 |
pollyreach_update_inbound_prompt |
修改來電應答行爲 |
這些工具面向模型調用；腳本部分則適合在模型工具管線之外做診斷。
環境要求¶
使用 dsh-pollyreach 前，先確認運行環境滿足以下條件：
1、Node.js 22.19 或更新版本。
2、DeepSeek Harness 版本爲 @deepseek-ai/dsh 0.1.0-rc.7，並且與 @deepseek-ai/dsh-tools 0.0.1-rc.1 兼容。
3、如果需要使用可選 shell 腳本，還需要 curl 和 jq。
安裝與啓用¶
先說明一點：dsh-pollyreach 會貢獻 cordis.patch.yml，使用方不需要手動編輯生成的 profile manifest。
安裝本地 checkout 時，可以把倉庫絕對路徑加入一個已有 profile：
dsh plugin --profile demo add /absolute/path/to/pollyreach-dsh-plugin
dsh --profile demo --dump-config
dsh --profile demo
安裝打包後的發佈版本時，先打出 tarball，再安裝到 profile：
npm pack
dsh plugin --profile demo add ./dsh-pollyreach-1.0.3.tgz
如果包已經發布到 npm，資料給出的用戶安裝示例是：
dsh plugin --profile demo add dsh-pollyreach@1.0.3
如需移除：
dsh plugin --profile demo remove dsh-pollyreach
配置覆蓋¶
默認配置來自插件自帶的 cordis.patch.yml。如果需要在 profile 中覆蓋默認值，要編輯 profile 的 cordis.patch.yml。這裏有一個細節：patch 行會替換整個 config 對象，所以如果只想改一項，也要把想保留的其他值一起寫全。
例如，配置可寫成：
- id: pollyreach-tools
name: dsh-pollyreach
config:
apiBaseUrl: https://api.pollyreach.ai
credentialsPath: ~/.config/PollyReach/key.json
source: openclaw
requestTimeoutMs: 30000
pollIntervalMs: 2000
activationMaxAttempts: 60
queryMaxAttempts: 300
inboundMaxAttempts: 10
其中 source 默認值爲 openclaw，原因是當前 PollyReach 設備註冊 API 的約定；客戶端運行環境仍是 DeepSeek Harness。
憑據安全¶
註冊工具會把憑據保存爲如下結構：
{
"token": "redacted",
"agent_name": "my-agent",
"activation_url": "https://agent.pollyreach.ai/auth?code=example",
"ai_virtual_phone": null
}
保存路徑爲 ~/.config/PollyReach/key.json。目錄會創建爲受限權限，文件以 0600 原子寫入。註冊工具的結果中會故意省略 token，避免把令牌暴露到對話或日誌裏。
不要提交真實憑據文件。資料中的 examples/key.example.json 只包含佔位符。
手動調試腳本¶
插件包含用於手動使用的 shell CLI。它們適合在模型工具管線之外做診斷，並會自動讀取同一份憑據文件；token 不會作爲命令行參數傳入。
常用腳本如下：
scripts/register.sh "Agent Name" "AI agent powered by DeepSeek Harness"
scripts/activation.sh
scripts/send.sh 'Call +1... and ask ...'
scripts/query.sh
scripts/balance.sh
scripts/inbound.sh
scripts/prompt_update.sh 'Answer professionally and take a detailed message.'
測試時可以通過 POLLYREACH_API_BASE_URL 和 POLLYREACH_CREDENTIALS_FILE 覆蓋端點與路徑。
驗證與打包¶
在提交或發佈前，可以運行檢查和打包校驗：
npm install
npm run check
npm run pack:check
測試使用 mock，不需要真實 PollyReach 賬號。發佈前還可以用一個臨時 dsh profile 驗證打包產物：
npm pack
dsh plugin --profile pollyreach-smoke add ./dsh-pollyreach-1.0.3.tgz
dsh --profile pollyreach-smoke --dump-config
適用場景與注意¶
dsh-pollyreach 適合需要在 DeepSeek Harness 中調用 PollyReach 電話工具、同時保留人工腳本調試入口的場景。
使用前注意：
1、插件會在當前 dsh 進程權限下運行，安裝前應檢查源碼、許可證和依賴版本。
2、本插件面向當前 DeepSeek Harness 開發者預覽版本；預覽 API 可能變化。發佈新版前，應更新並重新測試固定的 peer 版本。
3、憑據文件屬於敏感數據，不要寫入倉庫、日誌或對話記錄。
鏈接¶
GitHub：https://github.com/PollyReach/pollyreach-dsh-plugin
已覈實資料未提供目錄頁 URL，因此這裏不附目錄鏈接。
