manmankan 0.0.6.8

A 股自选股 CLI · 不告诉你买什么 · 帮你找到符合条件的 · 多周期位置 + 共振 + 选股 DSL

慢慢看 · manmankan

告诉你坐标，不替你决策。

人和 AI 共用的 A 股本地数据筛选器：把自选、行业、题材、热榜、全市场和外部代码池整理成结构化、可审计、低上下文成本的数据。

支持 AI 辅助筛选 / 研究输入；不输出买卖建议、评级、目标价或策略结论。

慢慢看是一个纯命令行工具。它不试图判断一只股票值不值得买，而是回答更底层的问题：这批候选现在处在什么位置、哪些数据可用、哪些规则命中、哪些缺口需要继续研究。

English summary

manmankan is a local A-share data screening layer for both humans and AI workflows. It turns watchlists, industries, themes, hot lists, full-market scans, or external code pools into auditable CLI/JSON outputs: price-range coordinates, resonance, filters, fields, and data availability.

It provides coordinates, not decisions: no buy/sell advice, no ratings, no price targets, and no strategy conclusions. Python 3.11+ · local storage · A-share only · Parity Public License 7.0.0.

为什么存在

很多选股流程的问题不在于缺少观点，而在于输入太散：自选股、行业成分、题材池、热榜、全市场截面、外部候选代码各有入口；行情位置、估值裸值、资金、技术指标、缺数据状态又分散在不同地方。

慢慢看把这些输入统一成一个可复核的数据层：

• 给人看：在终端里快速看到候选池的多周期位置、共振、涨跌、行业 / 题材 / 热榜背景。
• 给 AI 用：用低噪声 JSON 把候选、字段、命中条件、缺数据语义交给模型，方便继续做解释、排序、研究清单或交叉验证。
• 给自动化用：CLI 和 kan.api 都能接外部代码池，适合 cron、notebook、脚本和本地研究流水线。

如果你要让 AI 参与候选筛选，慢慢看的角色是提供可审计输入：它负责把“坐标”和“条件命中”说清楚，不负责替你下结论。

快速开始

uv tool install manmankan
kan add 600519 601318 000858
kan scan

第一次 kan scan 会拉取日 K 线并建立本地缓存，之后按天增量更新。忘了命令直接跑：

kan help
kan scan --help
kan find --help

常用入口：

kan scan                                      # 扫当前自选
kan scan --codes 600519,000858               # 扫外部候选代码池
kan find --codes 600519,000858 --format json # 把候选池整理成 JSON
kan find --all --pe lt:20 --format json --compact
kan board rank --kind industry --by moneyflow --format json
kan history 600519 --format json

kan scan 面向终端阅读；kan find --format json 面向脚本和 AI 消费。

数据契约

慢慢看的核心输出不是“推荐”，而是可组合的数据事实。

主要能力：

• 多周期位置百分位：3 / 5 / 7 / 10 / 15 / 30 / 60 / 90 / 120 / 180 日。
• 共振：同一候选在多个周期同时接近低位或高位。
• 候选池：自选、行业、题材、热榜、全市场、外部 --codes 或 stdin。
• 筛选条件：位置、共振、涨跌、连阳连阴、估值、质量、资金、技术指标、筹码、股东、除权除息事件等。
• 输出形态：终端表格、Markdown、JSON、紧凑 JSON、字段白名单、Python API。

JSON 相关入口：

kan find --industry 半导体 --format json --fields @core,@valuation
kan find --codes - --format json --compact
kan find --all --format json --compact --no-compact-context

JSON schema、字段分组、data_availability、缺数据语义、错误 envelope 见 docs/find.md。脚本化入口以 kan/api.py 文件头 docstring 为公开 contract。

安装

要求 Python 3.11+。推荐用 uv：

uv tool install manmankan
kan --version

其他方式：

pipx install manmankan
python3 -m venv ~/.kan-venv && source ~/.kan-venv/bin/activate && pip install manmankan
git clone https://github.com/piklen/manmankan.git && cd manmankan && uv sync && uv run kan --version

如果装完当前终端找不到 kan，打开新终端让 PATH 生效。国内镜像源同步慢时，可以临时直连 PyPI：

uv tool install manmankan --index-url https://pypi.org/simple/

边界

慢慢看不会做这些事：

• 不推荐具体股票。
• 不预测涨跌。
• 不给买卖建议、评级、目标价或仓位建议。
• 不内置策略 preset、打分模型或“最佳标的”排序。
• 不下单、不接券商账户、不读取持仓。
• 不提供实时行情、分钟级行情、港股、美股、期货或完整财报数据库。

位置百分位的定义是：

(当前价 - N 日最低价) / (N 日最高价 - N 日最低价) * 100

0% 表示 N 日区间最低，100% 表示 N 日区间最高。共振 ×N 表示多个周期同时接近低位或高位。它们只是坐标，不是信号。合规细则见 docs/compliance.md。

隐私与数据

慢慢看本地运行：

• 自选股、缓存、扫描快照存放在 ~/.local/share/kan/，按 XDG 规范管理。
• 不需要登录，不上传自选股，不做遥测。
• CLI 会访问公开行情数据源；更新检查会访问 PyPI，可用 KAN_NO_UPDATE_CHECK=1 关闭。
• 配置 TuShare token 后，token 只发往你配置的 TuShare API 端点。
• kan uninstall 会清理本地数据并提示对应的软件包卸载命令。

数据主要来自 AKShare 生态及公开行情源，可用性依赖上游。AKShare 数据限制为学术研究用途，本工具继承该限制；商业使用、SaaS、二次分发或衍生软件还需遵守 LICENSE、NOTICE 与上游数据条款。

文档导航

文档	用途
CHANGELOG.md	版本变更记录
docs/find.md	kan find JSON schema、字段、缺数据语义
docs/compliance.md	合规边界、公开输出语言规范
docs/roadmap.md	路线图和明确不做的方向
kan/api.py	Python API 公开 contract
SECURITY.md	安全与漏洞报告
CONTRIBUTING.md	开发、测试、贡献规范

开发

git clone https://github.com/piklen/manmankan.git
cd manmankan
uv sync
uv run ruff check kan/ tests/
uv run mypy
uv run pytest -q -m "not network and not tty"

启用本地 hooks：

git config core.hooksPath .githooks

贡献前请读 CONTRIBUTING.md，尤其是公开输出的中性语言和合规边界。

许可证

Parity Public License 7.0.0 · 附 Attribution Rider · © 2026 piklen

个人、学术、评估、非营利用途免费；衍生作品须同 license 公开。商业使用、付费服务、SaaS 或嵌入商业产品须先获得作者书面授权。衍生作品须在 README 显著位置标注 “Based on manmankan (https://github.com/piklen/manmankan)”。

Bug / 功能反馈走 GitHub Issues 或 Discussions。