yu2001-s/finance-osint
GitHub: yu2001-s/finance-osint
金融OSINT是一个社区驱动的公共市场情报研究数据库。
Stars: 0 | Forks: 0
# 金融OSINT
金融OSINT是一个由社区驱动的公共市场情报研究数据库。
该项目旨在帮助缩小零售投资者、独立分析师和开源研究人员的研究访问差距。有价值的市场研究散布在文件、记录、新闻、公司材料、难以获取的数据集、实地笔记、第一手观察和贡献者来源的发现中。金融OSINT将可合法分享的证据转化为可检查、连接、辩论和公开改进的持久记录。
仓库就是数据库:贡献者添加YAML记录以记录来源、证据、结构化观察、图关系、审查压力和提出的论点,然后在本地验证后通过pull request提交更改。
金融OSINT保存证据和分析,而不是隐藏的权威。它不存储规范真相状态、置信度分数、隐藏的审查决策、重要非公开信息、私人专家网络材料或私人代理状态。审查状态是从记录中本地派生的。
## 仓库地图
```
records/ Canonical source, evidence, metric, event, claim, relationship,
validation, challenge, question, entity, dataset, and thesis data.
ontology/ Registered and proposed claim predicates, relationship types,
and metric definitions.
schemas/ JSON Schemas for every canonical record kind.
templates/ Copyable YAML templates.
fosint/ The `fo` command-line tool.
scripts/ CI and maintainer validation helpers.
docs/ User and contributor documentation.
examples/ Fictional example corpora and deferred prototypes.
tests/ Unit tests and synthetic fixtures.
```
只有`records/`和`ontology/`是规范数据。`.local/`、`examples/`和`tests/fixtures/`下的文件是生成的、说明性的或仅用于测试。
## 数据流
```
Source -> Dataset -> Evidence -> Metric / Event / Claim -> Relationship -> Thesis
-> Validation / Challenge / Question
```
从来源和证据开始。只有在支持链证明它们的情况下才提升更强的对象。如果链不完整,将差距记录为一个问题、挑战、范围声明或论点限制,而不是拉伸数据。
## 快速开始
安装本地工具:
```
uv sync
```
验证和构建本地读取工件:
```
uv run fo lint --json
uv run fo index build --json
uv run fo graph build --json
```
搜索和检查记录:
```
uv run fo search axt --json
uv run fo context entity:company:axt-inc --json
uv run fo review thesis:axt-sumitomo:inp-substrate-bottleneck-watch --chain --json
uv run fo graph neighbors entity:company:axt-inc --json
```
生成的文件写入`.local/`,并由git忽略。
如果您不能使用`uv`:
```
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
fo lint --json
```
## 贡献
欢迎原子贡献。一个有用的pull request可以添加一个来源、一条证据、一个指标、一个声明、一个关系、一个问题、一个挑战或一个验证。
在打开pull request之前,运行:
```
uv run fo lint --json
uv run python -m unittest discover -s tests
uv run fo index build --json
uv run fo graph build --json
uv run fo diff-review BASE --json
uv run fo view build BASE --json
```
使用`BASE`作为分支点或pull-request基础,例如`main`或`origin/main`。
新的规范记录必须使用您的GitHub身份:
```
submitted_by: github:your-login
```
参见`CONTRIBUTING.md`和`docs/research-batch-contribution.md`以获取完整的流程。
## 文档
从`docs/README.md`开始。
稳定的文档涵盖:
- 首次设置和第一个PR
- 记录模型和本体
- 如何编写基于来源的研究批次
- CLI命令和模式合约
- 审查、治理、存档和争议处理
- 维护者检查和生成的工件
## 非目标
金融OSINT不是一个投资推荐服务、托管数据库、审查后端、私人专家网络或代理记忆存储。该仓库保持证据链可见,以便读者可以自己评估工作。
## 许可证
金融OSINT根据Apache License,版本2.0许可。请参阅`LICENSE`。
标签:YAML, 二进制发布, 代码审查, 关系图谱, 内存扫描绕过, 分析师, 单元测试, 基线检查, 安全库, 市场研究, 开源工具, 开源框架, 开源研究, 投资者研究, 投资论点, 持续集成, 数据库, 数据结构, 数据验证, 文档编写, 日志审计, 社区驱动, 证据记录, 逆向工具, 金融情报, 零售投资者