PollyReach/pollyreach-dsh-plugin

dsh-pollyreach

一个可分发的 DeepSeek Harness PollyReach 捆绑包。它注册了七个可由模型调用的原生工具以及 PollyReach 技能，并包含用于手动操作的安全 shell CLI。

包含的能力

- 注册并安全持久化 PollyReach 凭据。
- 完成账户激活并获取分配的 phone number。
- 提交外呼电话任务并轮询完整结果。
- 检查信用余额，且不会将零余额视为无效令牌。
- 获取未读的来电数据，且不会扁平化 API 响应。
- 更新来电应答提示词。

要求

- Node.js 22.19 或更高版本。
- 与 dsh-tools 0.0.1-rc.1 兼容的 DeepSeek Harness @deepseek-ai/dsh 开发者预览版。
- 仅在使用可选的 shell 脚本时才需要 curl 和 jq。

安装

将本地检出安装到现有 profile 中：

dsh plugin --profile demo add /absolute/path/to/pollyreach-dsh-plugin
dsh --profile demo --dump-config
dsh --profile demo

安装打包的发布版本：

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 清单。

原生工具

| 工具 | 用途 |
|---|---|
| pollyreach_register | 注册并原子性地保存新凭据 |
| pollyreach_activation_status | 检查/轮询激活状态并保存分配的号码 |
| pollyreach_send_call | 提交一个外呼任务 |
| pollyreach_query_call | 轮询实际的外呼结果 |
| pollyreach_balance | 返回完整的余额响应 |
| pollyreach_inbound_calls | 返回未读的来电数据 |
| pollyreach_update_inbound_prompt | 更改来电行为 |

该插件还通过 ctx.skills 注册了 SKILL.md，因此 Harness 技能目录可以按需加载行为指导。

配置

在 profile 的 cordis.patch.yml 中覆盖默认值。补丁行会替换整个配置对象，因此请包含所有你想保留的值：

- 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。

凭据安全

注册工具会将以下结构存储在 ~/.config/PollyReach/key.json：

{
"token": "redacted",
"agent_name": "my-agent",
"activation_url": "https://agent.pollyreach.ai/auth?code=example",
"ai_virtual_phone": null
}

该目录以限制性权限创建，文件以 0600 模式原子写入。令牌有意从注册工具结果中省略。切勿提交真实文件；examples/key.example.json 仅包含占位符。

可选的 shell CLI

这些脚本可用于模型工具流水线之外的诊断：

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

测试不需要真实的 PollyReach 账户；网络调用均被模拟。发布前，请针对一次性的 dsh 配置文件测试打包后的 tarball：

npm pack
dsh plugin --profile pollyreach-smoke add ./dsh-pollyreach-1.0.3.tgz
dsh --profile pollyreach-smoke --dump-config

兼容性说明

此包面向当前的 DeepSeek Harness 开发者预览版（@deepseek-ai/dsh 0.1.0-rc.7 和 @deepseek-ai/dsh-tools 0.0.1-rc.1）。预览版 API 可能会发生变化；在发布新版本之前，请更新并重新测试所固定的 peer 版本。

许可证

MIT