chanlun-trading-system · 缠论分析 Skill

把**缠中说禅（缠论）**的技术分析体系，做成一个可以直接装进 AI Agent 的 Skill——让 AI 帮你看 A 股 / 港股 / ETF / 指数 / 期货的走势时，先定级别、先认结构、先写失效点，而不是张口就喊"必涨买点"。

⚠️ 仅供技术研究与学习，不构成投资建议，不给买卖指令，不承诺收益。 缠论存在主观性与失效风险，盈亏自负。

这个 Skill 到底做什么

不是	是
❌ 一个"必涨信号"机器	✅ 一套强制纪律的分析流程
❌ 指标金叉就喊买	✅ 走完 包含→分型→笔→线段→中枢→背驰→买卖点 才下结论
❌ 把突破当三买	✅ 中枢离开+回拉+不回 全部点名才认三买
❌ 假装看得懂任何图	✅ 数据不够就降级为"观察"，并说明近似损失

核心是一道自检门（Audit Gate）：级别门 → 结构门 → 类型门 → 比较门 → 买卖点门 → 触发门 → 风险门 → 降级门。任何一步缺失，输出自动从"确认买入"退回"观察"。

安装

1. 直接运行可视工作台

安装 uv 后，可以从固定版本一次性运行，不污染现有 Python 环境：

uvx --from "git+https://github.com/noahnan-max/chanlun-trading-system.git@v0.1.1" chanlun-visual

需要长期使用：

uv tool install "git+https://github.com/noahnan-max/chanlun-trading-system.git@v0.1.1"
chanlun-visual doctor --json
chanlun-visual

上述远端命令以 GitHub v0.1.1 tag 已发布为前提；未发布前请使用下方“本地开发安装”。公开行情是可选便利入口，CSV 与内置示例不依赖它：

uv tool install --with yfinance "git+https://github.com/noahnan-max/chanlun-trading-system.git@v0.1.1"

2. 安装 AI Skill

Codex/OpenAI 用户可以让 $skill-installer 从本 GitHub 仓库安装 chanlun-trading-system，或从 GitHub Release 下载 chanlun-trading-system-skill.zip 后执行：

mkdir -p "$HOME/.agents/skills"
unzip chanlun-trading-system-skill.zip -d "$HOME/.agents/skills"

腾讯 SkillHub 使用同一 Release 中的 chanlun-trading-system-skillhub.zip；它只比通用包多出 SkillHub 要求的分发元数据，规则正文和脚本保持一致。

Skill 与可视工作台运行时是两个安装单元：只装 Skill 可以进行规则化文字研究；要打开交互图表，还需要安装上面的 chanlun-visual。Skill 会先运行 doctor，缺失时只提示安装，不会静默修改环境。

Claude Code 可以把同一个发布版 Skill 解压到 ~/.claude/skills/。本地克隆安装方式：

git clone https://github.com/noahnan-max/chanlun-trading-system.git
cp -r chanlun-trading-system ~/.claude/skills/
# 新开一个会话，问它"用缠论帮我看下 XXXX 的日线走势"即可自动触发

其他 Agent / 本地模型也可以把 SKILL.md 作为系统提示加载，需要细节时再按表读取 references/*.md。

任意 AI / 完全不会写代码：打开 缠论Skill_完整版_通用AI.md（中文通用版，最详细、含调度协议+实战示例，适配 DeepSeek/豆包/Kimi/元宝/千问/ChatGPT/Claude 等任意 AI），整段复制进对话框，开头加一句：

"按这套规则帮我分析【标的】的走势，先定级别、先认结构、先写失效点，不要直接给我买卖建议。"

可视研究工作台（v0.1）

仓库同时提供一个本地优先、可交互、可分享的研究工作台。它把 OHLCV 数据标成分型、笔、线段代理、中枢、背驰证据与买卖点候选，并明确展示每个对象的确认时间、可用时间、定义模式和近似损失。

上图为使用合成数据的交互设计概念稿，不是实时行情截图；查看移动端概念稿。

3. 本地开发安装

git clone https://github.com/noahnan-max/chanlun-trading-system.git
cd chanlun-trading-system
uv sync --all-extras
uv run chanlun-visual doctor --json
uv run chanlun-visual

浏览器打开 http://127.0.0.1:8791。内置合成示例无需网络；导入 CSV 时至少需要 date,open,high,low,close，volume 可选。公开行情入口接受 300684、600519、0700、AAPL 等常见写法并自动补齐市场后缀。要使用这个便利入口，再安装：

工作台的公开行情入口是非权威可选适配器；失败时请回到 CSV。它不创建账户、不上传数据、不接券商、不下单。当前线段/中枢/背驰属于 research_proxy，不能称为严格原著等价实现。详细说明见 references/visual-workbench.md。

目录结构