前言¶
在 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 中的工具表与示例如下。
| 工具 | 用途 |
|---|---|
domain_manager_list |
按注册商、分组、自动续费、dueWithinDays 等筛选列表 |
domain_manager_report |
年度成本、ICANN 费用、按注册商汇总、即将到期 |
domain_manager_add / domain_manager_update / domain_manager_remove |
本地组合增改删 |
domain_manager_sync |
从 namecheap / cloudflare / all 同步，支持 dryRun |
domain_manager_check_availability |
批量可用性，provider 可选 auto、mcp、cloudflare、namecheap、rdap |
domain_manager_search |
Cloudflare 关键词搜索 |
domain_manager_import_markdown / domain_manager_export_markdown |
Markdown 导入导出 |
在与智能体对话时，可直接用自然语言触发上述能力，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 为准。
