Thhoho/reSanity

reSanity 散修 — 面向散户投研的证据搜索与逻辑梳理 Skill:核查一手资料,拆解题材到收入、利润和现金的传导链,标注证据与推断边界。

Project Overview项目介绍

Resanity is an agent skill designed originally for retail investment research, that helps structure research process, verify evidence boundaries, and track updateable cognitive anchors for investment judgments. It works across multiple agent platforms, including Claude Code, Codex, and DeepSeek Harness (DSH). To install, users place the repository in the respective skill directory of their agent host, and run a Python identity check script to confirm the loaded skill matches the canonical version before first use. For DSH users, it also provides an optional bundled native plugin that enables command-line access to extra features.

This skill is built for retail investors who conduct their own independent investment research. When a user asks a research question, Resanity guides the agent to break down the economic exposure chain from the initial demand or policy to final cash revenue, record each key claim with its evidence boundary and inference limit, remind the user to update the cognitive anchor on the scheduled verification date, and output a final research conclusion with clear next steps. It never recommends stocks or promises returns, and it focuses solely on improving the rigor of the user's research process.

Resanity is released under the open source MIT license, and currently only requires Python 3 to run its built-in check tools. The current stable version is 0.2.1, which has passed engineering and mechanical validation, but has not completed independent benchmark testing for research effectiveness. Mechanical checks only confirm structural compliance, not the correctness of the final investment conclusion. All user data, including cognitive anchors and research reports, is stored locally as plain text in the user's working directory, with no cloud database involved. Users without a Tushare API token can still use the core features normally, as data collection requests will fall back to other available local sources.

Resanity(散修)是一个面向散户投资者设计的投资研究Agent技能,核心能力是帮助用户拆分投资判断的逻辑链条,梳理证据与推断的边界,记录可更新的认知锚,完成投资研究过程的机械校验。它既可以作为通用Agent技能在Claude Code、Codex上使用,也提供可选的DSH原生插件绑定,支持通过DSH命令调用锚检查、报告审计等功能。

该工具面向自主进行投资研究的散户投资者,核心使用流程是:用户提出具体研究问题后,该技能会引导模型拆分主题对应的经济暴露链,用原子主张卡记录观察、推断边界和决策影响,提醒用户在验证日更新认知锚,最终输出包含明确结论和下一验证步骤的研究报告。它不荐股、不承诺收益,只专注于梳理研究过程的逻辑与证据。

该项目采用MIT许可协议免费开源,当前正式版本为0.2.1,安装后需要运行Python脚本完成身份校验,确保加载的技能副本与官方一致。当前版本仅完成工程与机械验证,尚未完成独立有效性基准测试,机械校验仅确认结构合规,不保证结论正确。所有认知锚和研究数据都存储在用户本地工作目录,无云端数据库。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Thhoho/reSanity

把 Thhoho/reSanity 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

Resanity(散修)

散修:锚 + 对勾

散修,修出你的 Sanity。

积极的信心,谨慎的动作。

一个首先为散户投资研究设计的证据搜索与逻辑梳理 Skill:查一手资料、拆经济暴露链、标注证据与推断边界,并用认知锚持续更新和复盘判断。

它面对的核心场景不是“预测下一只会涨的股票”,而是散户做公司、行业和题材研究时最常遇到的几类问题:消息到底是真是假,技术或政策怎样传到公司收入与现金,市场已经相信了什么,自己的判断要被哪个事实更新。

Resanity 把会改变投资决策的判断拆成四个问题:观察到什么、可以推出什么、不能推出什么、对决策有什么影响。模型保留问题定义、证据解释、结论和下一步等研究语义;代码只做 hash、引用、as-of、来源血缘、预算和安装身份等机械检查。

它不是荐股工具,不是行情软件,也不替用户下单、设仓位或承诺收益。它希望做的是:在题材最热时多问一句证据,在结论最顺时找出最弱环节,在验证日到来时记得更新判断,在复盘时说清自己到底错在哪一环。

当前正式代码版本是 0.2.1。当前版本已通过工程与机械验证,但尚无同版本、独立完成的研究有效性基准测试;这些检查不证明 Alpha、收益或 PMF。精确验证状态与运行边界见 validation/v2/README.md。

为什么需要散修

市场里不缺信息,缺的是经过边界检查的判断;不缺观点,缺的是能被后续事实更新的观点。

  • 刷到“某题材要起飞”的帖子时,先找公告、定期报告和具名客户等原始材料,把官方口径、市场转述和推断分开。
  • 看到订单、产能或政策利好时,逐段检查它是否真的走到交付、验收、收入、毛利和回款,而不是把产业相关性直接写成利润。
  • 研究过的公司到了财报、验收或政策落地日时,用“更新锚”只复核会改变原判断的事实,不必重做整份研究。
  • 复盘亏损或错判时,保留“当时相信什么、基于什么证据、哪个条件后来失效”,避免把教训压成一句情绪。

它怎样工作

投资研究首先把主题还原成经济暴露链:

需求或政策
→ 工程/产品可行性
→ 具名客户与合同
→ 交付
→ 验收、起租或计费
→ 收入
→ 毛利
→ 回款与自由现金

前一段成立不能自动证明后一段。每条真正承重的判断使用原子主张卡记录观察、推断边界、不能推出的更强结论和决策影响;结论强度服从最弱的承重主张。需要比较路径时再画基准、上行和下行可能性,不为格式强行制造三种对称答案。

最小输出是一句根结论、1–5 张关键主张卡和一个最低成本的下一验证。只有问题需要时才加入价格/预期对照、载体比较、认知锚或正式证据表。

直接使用

投资研究是默认目标场景,可以直接问:

这家公司和热门题材之间,是概念映射,还是已经形成可归属的收入和现金?
截至今天,这家公司从产品验证到收入和现金的哪一段已经被一手证据闭合?
这个行业真正稀缺的环节和利润池在哪里?市场价格已经计入了哪些预期?

结果不保证给出可买标的。证据不足时,WATCH_ONLY、NOT_EVALUABLE 或“暂不动作,等待某项验证”都是有效结论。

实验性泛化

原子主张卡、可能性地图、来源血缘和 as-of 边界在产品、政策和技术排障等问题上具有可复用潜力,因此 0.2 允许用户显式调用 Resanity 做小范围实验:

请使用 Resanity,为这个产品方案画可能性地图,并审计三条承重主张。

这不是已经验证的通用能力。当前设计、真实使用和较多案例仍以投资研究为主;非投资场景不自动触发,不套用价格、估值、利润池或候选载体等投资合同,也不把一次成功回答当成泛化证据。医疗诊断和法律判断需要独立协议,不属于当前通用实验范围。

0.2 的结构变化

  • 保留一个 canonical resanity Skill;
  • SKILL.md 只放通用原子主张协议和路由;
  • 投资、认知锚和正式审计分别放在条件加载的 references/;
  • 投资研究可以自动触发,非投资实验必须由用户明确调用;
  • 回答按问题选择模块,不强制每次生成完整报告;
  • 可读研究报告与机械审计解耦:未知和审计失败进入披露,不阻断报告;
  • 锚使用 active / refuted / realized / archived 生命周期,代码只读和提醒;
  • 正式验证绑定 active locator、canonical Skill hash 与 profile hash,避免验证 A、实际加载 B;
  • 正式收据绑定主张时态、来源日期依据和覆盖截止日,阻断用事后当前页回填历史状态。

完整边界见 ARCHITECTURE.md。

文件结构

SKILL.md                        canonical 核心协议与路由
references/investing.md         散户投资研究 profile 与完整报告格式
references/anchors.md           认知锚生命周期与文件协议
references/formal-audit.md      正式机械审计与身份绑定
tools/skill_identity.py         active/canonical/profile 身份检查
tools/research_check.py         报告机械检查
tools/report_check.py           报告交付编译机械闸门
tools/anchor_check.py           只读锚日期检查
lib/index.js                    可选 DSH 插件
validation/v2/                  当前分层验证协议

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-session-archive 下一个 Next dsh-minigame-plugin →