前言¶
在 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 爲準。
