前言¶
在 DSH 這類強調「一切皆插件」的智能體宿主裏，研究類插件很容易停留在“生成一段看起來完整的分析”上。對投研來說，更難的問題不是文字夠不夠完整，而是證據是否足夠、推斷邊界在哪裏、結論是否還能被後續事實更新。
Resanity 是面向散戶投研的證據搜索、經濟暴露鏈梳理與承重主張審計 Skill。它把投資決策判斷拆成“觀察到什麼、可以推出什麼、不能推出什麼、對決策有什麼影響”，並圍繞這個框架提供 DSH 插件、錨體檢、可選數據憑據等機械能力。
這是什麼¶
Resanity 當前正式代碼版本是 0.2.1，由 Thhoho 維護，許可證爲 MIT。GitHub 地址爲：https://github.com/Thhoho/reSanity。
它解決的典型問題是：
- 一條消息到底是官方口徑、市場轉述，還是繼續推斷？
- 政策、訂單或產能變化，是否已經走到交付、收入、毛利和回款？
- 市場價格已經計入了哪些預期？
- 自己之前的判斷，需要被哪個事實更新？
Resanity 不是薦股工具，不是行情軟件，也不替用戶下單、設倉位或承諾收益。它關注的是研究過程中的證據邊界和判斷更新。
核心功能¶
投資決策拆成四個問題¶
Resanity 把會改變投資決策的判斷拆成：
1、觀察到什麼
2、可以推出什麼
3、不能推出什麼
4、對決策有什麼影響
這個拆法的重點，是把“看起來相關的信息”和“足以支持結論的證據”分開。
投資研究是默認目標場景¶
投資研究是 Resanity 的默認目標場景，主要能力包括：
- 查一手資料；
- 拆經濟暴露鏈；
- 標註證據與推斷邊界；
- 用承重主張審計結論強度。
證據不足時，WATCH_ONLY、NOT_EVALUABLE，或“暫不動作，等待某項驗證”都是有效結論。
非投資實驗必須由用戶明確調用，不自動觸發。醫療診斷和法律判斷需要獨立協議，不屬於當前通用實驗範圍。
認知錨生命週期¶
Resanity 使用認知錨保留可更新、可複覈的判斷。錨的生命週期爲：
active / refuted / realized / archived
提醒器只讀 active 錨的日期觸發器。也就是說，系統層面主要做的是提醒和只讀檢查，不替用戶自動改寫判斷。
DSH 插件能力¶
DSH 插件提供：
bundled Skill provider；/resanity-check錨體檢；- 可選
Tushare憑據命令。
配置中的 systemNotifications 默認 false，只有用戶顯式開啓時才調用操作系統通知。
Tushare 不進入核心研究協議，但在憑據與依賴可用時，是 A 股日線自動採集的默認最高優先級來源；採集失敗不會隱藏回退到其他來源。
0.3 開發中能力¶
資料中標註的 0.3 開發中能力包括：
- 配置門控
anchorTimer/commands/dataTools/webFetch； - 模型數據工具；
webFetch提供方；- 六段研究紀律；
- 公告工具緊湊輸出；
- 錨到期預採集；
- 失效追蹤；
- 交付編譯閘門；
- 輕量單臂評估套件；
- 新命令
/resanity-audit與/resanity-init； - 預設迴歸閘門。
這些能力已實現並通過測試，但需要重啓 DSH 才生效，且未進入 0.2.1 發佈樹。
安裝與啓用¶
從本地 tarball 安裝到指定 profile：
dsh plugin --profile headless add /absolute/path/resanity-0.2.1.tgz
安裝前建議先檢查源碼與 MIT 許可證。DSH 插件以當前 dsh 進程權限運行，因此安裝前應確認命令來源、包版本和本地目錄路徑。
典型用法¶
投資研究可以直接問：
這家公司和熱門題材之間，是概念映射，還是已經形成可歸屬的收入和現金？
截至今天，這家公司從產品驗證到收入和現金的哪一段已經被一手證據閉合？
這個行業真正稀缺的環節和利潤池在哪裏？市場價格已經計入了哪些預期？
非投資場景必須由用戶明確調用，例如：
請使用 Resanity，爲這個產品方案畫可能性地圖，並審計三條承重主張。
這類調用是實驗性泛化，不應被理解爲已經驗證的通用能力。
適用場景與注意¶
適合：
- 需要把投研過程拆成證據、推斷和決策影響的開發者；
- 需要在 DSH 中掛載投研 Skill 的用戶；
- 希望用錨提醒、只讀體檢和機械檢查輔助判斷流程的人。
不適合：
- 要求直接薦股；
- 要求自動下單、設倉位；
- 要求承諾收益或判斷 Alpha；
- 把一次輸出當成已驗證的市場結論。
當前版本已通過工程與機械驗證，但尚無同版本、獨立完成的研究有效性基準測試；這些檢查不證明 Alpha、收益或 PMF。
0.3 開發中能力尚未進入 0.2.1 發佈樹，且需要重啓 DSH 才生效。使用時應區分當前正式版能力與倉庫內開發中能力。
結尾¶
Resanity 的價值在於把投研中容易混在一起的“信息、推斷、結論”拆開，並用證據邊界、承重主張和認知錨提醒判斷何時需要複覈。它不替用戶做投資決策，而是讓研究過程更容易被檢查和更新。
GitHub：https://github.com/Thhoho/reSanity
社區目錄頁：已覈實資料未提供可確認的 URL。
