前言¶
在 DeepSeek Harness（DSH）的開發與調試中，評估數據資產的價值往往是一個難題。文件大小或下載次數本身並不能直接反映數據的價值，真正能體現數據資產價值的信號是它在實際場景中的使用情況。
DataTally 是一個 DSH 插件，它的核心作用是將數據資產的公開使用信號（如下載量、引用數、Star 數）聚合到一個單一的、可驗證的資料中。它不進行價值計算或排名，只負責記錄和呈現事實。
插件介紹¶
- 插件名稱：
daamaao/datatally - 維護者：DAAMAAO
- 所屬分類：記憶
- 開源協議：MIT
DataTally 將分散在公共源頭的使用數據整合，爲 AI 代理提供查詢和對比數據資產使用情況的工具。
核心功能¶
該插件提供三個主要工具，用於讀取側的數據分析：
search_assets：通過關鍵詞或域名搜索數據資產資料。get_asset_profile：獲取單個資產的完整使用資料，包括各來源指標、時間線和引用信息。compare_assets：在同一個信號層級下對比兩個資產。
安裝與啓用¶
安裝前請確保 DeepSeek Harness 已安裝（dsh 在 PATH 中）且 Node.js 版本不低於 22.19。
執行以下命令安裝插件：
dsh plugin --profile web add datatally
安裝完成後，插件即可通過 DSH 的 Web 上下文加載使用。
典型用法¶
在使用時，你可以通過自然語言指令讓代理調用上述工具。例如：
“Find datasets for sentiment analysis and compare the two most used ones.”
代理會執行 search_assets，找到相關數據集，然後調用 compare_assets 進行對比。
輸出示例（僅展示記錄，不提供主觀評價）：
Agent（調用 search_assets("sentiment")）：
- imdb (stanfordnlp/imdb) | domain: nlp | deep: downloads 195,669 | shallow: likes 725 | fetched_at: 2026-09-08T14:35:50Z
- glue (nyu-mll/glue) | domain: nlp | deep: downloads 826,859 ...
Agent（調用 compare_assets("nyu-mll/glue", "stanfordnlp/imdb")）：
- downloads [deep]: 791,429 vs 197,595 | same_source: true | same_access: true
- forks [deep]: 178 vs 0 | same_source: false | same_access: true
- likes [shallow]: 741 vs 722 | same_source: true | same_access: true
note: cross-source metrics are not directly comparable
Agent 的回答僅陳述記錄數據（引用次數、來源、抓取時間），不做「哪個更好」的結論。
適用場景與限制¶
適用場景：需要驗證數據資產在公開渠道的實際流行度、引用情況或使用頻率時。
注意事項：
* 插件提供的 CLI 爲只讀模式，不包含數據刷新管道。
* 插件不會計算資產價值、加權信號或進行排名。
* 插件不會推薦「哪個更好」，也不會出售數據或僞造數字。
* 缺失的來源會被明確標記；缺失的許可證會顯示爲 null。
總結¶
DataTally 專注於數據的「來源與事實」記錄，而非價值判斷。它爲 DSH 生態提供了一個透明的數據資產使用信號查詢層，適合需要客觀評估數據資產活躍度的開發者。
