前言¶

在 DeepSeek Harness（DSH）里做项目规划时，域名往往分散在多家注册商后台：到期日、是否自动续费、年续费价格和用途备注各记各的。智能体可以查公开 WHOIS/RDAP，却通常拿不到你账户下的注册列表和 Namecheap 账户级续费报价。若把域名表放在笔记里，和注册商事实也容易脱节。

@beings-labs/dsh-domain-manager 是 beings-labs 维护的 DSH 插件：在本地 JSON 里维护域名组合（portfolio），可选从 Cloudflare Registrar、Namecheap 只读同步，并提供续费成本汇总、可用性查询和 Markdown 导入导出。插件不会代你注册、转移或续费。社区目录 SkillHub 将其归类为「模型推理」；就功能而言，它面向的是域名与注册商数据的管理，而非模型服务本身。

这是什么¶

一句话定位：面向 DeepSeek Harness 的域名组合管理插件，数据默认落在本机 domains.json，注册商侧均为只读访问。

维护者与来源：GitHub 仓库 beings-labs/dsh-domain-manager，npm 包名 @beings-labs/dsh-domain-manager，当前 package.json 版本为 0.1.0，许可证 MIT。运行要求包括 Node >=20，DSH >=0.2.0 <0.3.0。

核心功能¶

下面按 README 已写明的能力归纳，不展开未在文档出现的行为。

本地组合存储¶

支持增删改域名记录，字段涵盖注册商、到期日、自动续费、续费价、促销价、用途、分组、备注等。未配置任何注册商凭据时，仍可手工维护本地库，并用公开 RDAP 做可用性查询。

成本与到期报表¶

domain_manager_report 可汇总年度续费成本，区分自动续费开/关两部分，按注册商分子合计，并列出即将到期的域名。报表与 Markdown 导出会在同步数据超过 staleAfterDays 未刷新时给出陈旧警告（仅针对曾从注册商同步过的记录）。

注册商只读同步¶

domain_manager_sync 可从 Namecheap、Cloudflare 拉取注册列表并写回本地，同时保留你手工填写的 purpose/group/notes。默认 providers.namecheap 与 providers.cloudflare 均为 auto：Namecheap 优先使用 API 凭据，否则可走 MCP；Cloudflare 的 auto 等价于 API。仅 Namecheap API 模式会通过 namecheap.users.getPricing 刷新账户级续费价、促销价与 ICANN 年费；MCP 模式只能列域名与查可用性，无法更新已持有域名的价格字段。

可用性、搜索与 Markdown¶

• domain_manager_check_availability：单次 1–20 个域名，按 provider 选择 Cloudflare、Namecheap、MCP 或 RDAP（无凭据亦可）。
• domain_manager_search：通过 Cloudflare Registrar 搜索 API 发现候选域名。
• domain_manager_import_markdown / domain_manager_export_markdown：与 Markdown 表格互操作，导出可按注册商分组。

安装与启用¶

先从 npm 安装（将 <profile> 换成你的 DSH profile 名）：

dsh plugin --profile <profile> add @beings-labs/dsh-domain-manager

也可直接从 GitHub 添加：

dsh plugin --profile <profile> add github:beings-labs/dsh-domain-manager

本地开发检出路径安装：

dsh plugin --profile <profile> add /path/to/dsh-domain-manager

重启 Harness 应用后，确认插件层已加载：

dsh --profile <profile> --dump-config | grep dsh-domain-manager

卸载：

dsh plugin --profile <profile> remove @beings-labs/dsh-domain-manager

配置要点¶

全部配置项均为可选；不设注册商凭据时，本地存储与 RDAP 可用性检查仍可工作。在 profile 的 cordis.patch.yml 中可写入例如：

- id: dsh-domain-manager
  config:
    dataFile: /absolute/path/domains.json
    dueWithinDays: 90
    staleAfterDays: 14
    currency: USD
    namecheap:
      apiUser: your-api-user
      apiKey: your-api-key
      userName: your-namecheap-username
      clientIp: 203.0.113.10
      sandbox: false
    cloudflare:
      apiToken: your-api-token
      accountId: your-account-id
    providers:
      namecheap: auto
      cloudflare: auto

未在 YAML 中填写的字段，可退回到环境变量：NAMECHEAP_API_USER、NAMECHEAP_API_KEY、NAMECHEAP_USERNAME、NAMECHEAP_CLIENT_IP、CLOUDFLARE_API_TOKEN、CLOUDFLARE_ACCOUNT_ID。

Cloudflare 需在控制台创建 API Token；列出已注册域名需要 Registrar 读权限，可用性/搜索相关端点属于 Registrar API beta，需要 Registrar 写权限。Namecheap API 需在账户中开通 API、生成密钥，并将 clientIp 对应公网 IP 加入白名单。

若不想配置 Namecheap API，可安装连接器 dsh-namecheap-mcp 并通过浏览器 OAuth 登录（密码不经过 DSH）：

dsh plugin --profile <profile> add github:2000lla/dsh-namecheap-mcp

将 providers.namecheap 设为 mcp 可强制走浏览器登录；auto 在无 API 凭据时会尝试已连接的 MCP。令牌缓存在 ~/.mcp-auth/。

默认数据文件路径为 $DSH_HOME/dsh-domain-manager/domains.json（未设置 DSH_HOME 时一般为 ~/.dsh 下相应路径）。

典型用法¶

插件向 DSH 暴露一组以 domain_manager_ 为前缀的工具。README 中的工具表与示例如下。

在与智能体对话时，可直接用自然语言触发上述能力，README 给出的提示示例包括：

• “Show my domains that expire in the next 90 days and don’t auto-renew.”
• “Sync my Cloudflare registrations, then report the yearly cost.”
• “Is example.dev available, and what does Cloudflare charge for it?”
• “Export my portfolio to ~/domains.md.”

典型操作顺序可以是：配置（或省略）注册商凭据 → 调用 domain_manager_sync 拉取最新事实 → 用 domain_manager_report 或 domain_manager_list 查续费与到期 → 需要新域名时用 domain_manager_check_availability 或 domain_manager_search。

适用场景与注意¶

适合在 DSH 工作流中统一查看多注册商域名、估算年度续费、在 agent 对话里查可用性并导出 Markdown 备档的开发者。若你主要需要自动续费或购买域名，本插件对注册商侧为只读设计，不能代替注册商控制台操作。

安装与运行前建议自行阅读仓库源码与 MIT 许可证。插件在当前 DSH 进程权限下运行，会读取你配置的 API Token 或环境变量，并将组合数据写入本机 JSON；MCP 模式下 OAuth 令牌由连接器保存在 ~/.mcp-auth/。插件本身不持久化注册商密码；错误信息会对凭据形态字段做脱敏。SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系，DSH 生态理念是「一切皆插件」，安装来源以 npm、GitHub 或你信任的路径为准。

结尾¶

@beings-labs/dsh-domain-manager 把域名组合、只读同步、续费报表和可用性检查收敛到 DSH 工具层，本地 JSON 存储，注册商侧不写操作。若要查看目录简介或 Stars 等信息，可打开 SkillHub 插件页；安装命令、配置字段与工具列表以 GitHub README 为准。