本文档适用于：守界·大众版桌面端（Windows）。
内容涵盖持仓管理、ATR 止盈止损、模板策略、告警通知，以及
飞书 / 企业微信机器人接入的完整步骤。
不含市场情绪看板（后续版本功能）。
📱 移动端：守界·大众版现已推出
Android 移动版，可在手机上随时查看持仓盈亏、止损位与预警记录，把持仓纪律装进口袋。前往
下载页 获取 APK（要求 Android 6.0 及以上）。
1快速开始
从官网下载安装包后：
- 运行安装程序，按提示完成安装。
- 启动「守界·大众版」，首次进入会显示主窗口（6 个标签页）。
- 后台会自动启动监控线程，默认每 5 秒检查一次持仓是否触发风控条件。
数据源
- 首选：通达信本地日线（最准，路径默认
D:\TDX）。
- 降级：无通达信时自动切换到 TuShare / 新浪 / 腾讯行情。
建议在「设置」→「数据源」中确认当前行情源可用。首次使用可能需要配置 TuShare Token（可选）。
2持仓管理
这是主页面，展示你当前持有的所有股票及风控状态。
2.1 新增持仓
- 点击 「+ 新增持仓」 按钮。
- 在弹窗中填写：
- 股票代码 — 输入代码（如
600519），支持中文联想，选择后名称自动回填。
- 股票名称 — 联想选择后自动填入；也可手动输入。
- 成本价 / 数量 — 你的买入均价和股数。
- 当前价 — 可留空，系统会自动拉取最新行情填充。
- 策略模板 — 选择一套风控参数模板（见第 3 节），系统据此自动计算止损价、止盈线。
- 点击保存，持仓即出现在列表中。
2.2 编辑 / 删除
- 编辑：选中一行 → 点击「编辑持仓」，修改参数后保存。
- 删除：可按住
Ctrl 或 Shift 多选 → 点击「删除」，弹出确认框后批量删除。
2.3 应用模板
选中一只或多只持仓 → 点击「应用模板」→ 选模板，将该模板的风控参数批量套用到选中持仓。
2.4 持仓详情
双击某行或点击「详情」，查看该标的完整风控信息：成本、现价、浮动盈亏、真实 ATR、止损价、期间最高价（peak_price）、回撤止盈线、各档分批减仓位。
2.5 批量导入 / 导出
- 导入 CSV：从券商导出的持仓表批量录入（需包含代码、成本、数量列）。
- 导出 CSV：将当前持仓导出备份或用于二次分析。
3策略模板
模板就是一套「止损止盈纪律参数包」。选对模板 = 给每只票定好风控规矩。
3.1 内置 4 套模板
| 模板 | 适用周期 | 止损 | 高位回撤止盈 | 止盈激活 |
|---|
| 短线交易 | 1–5 天 | 1.5×ATR | 1.5×ATR | 盈利 2×ATR |
| 中线波段 | 1–4 周 | 2×ATR | 2×ATR | 盈利 2.5×ATR |
| 长线价值 | 月度/季度 | 2.5×ATR | 3×ATR | 盈利 3×ATR |
| 日内交易 | 日内 | 1×ATR | 1×ATR | 盈利 1.5×ATR |
3.2 查看模板说明
点击模板旁的「详情」按钮，弹窗展示完整说明：
- 止损设置（几倍 ATR、约百分之几）
- 止盈逻辑（重点）：追踪回撤止盈——从最高点回撤 N×ATR 触发卖出
- 仓位控制（最大仓位比例、单笔最大亏损）
- 风险回报比（RRR）
3.3 自定义模板
点击「新建模板」可另存一套自己的参数（最多 5 个），存于本地数据库，随软件携带。
4ATR 与止损止盈
什么是 ATR？
ATR（Average True Range，平均真实波幅）衡量这只股票平时一天正常波动多少钱。
用 ATR 设止损止盈，比拍脑袋写死百分比更贴合个股性格——波动大的票止损带更宽，不会被日常震荡洗出去。
4.1 在 ATR 页查询
- 切换到「ATR」标签页。
- 输入股票代码 → 显示 ATR 值、当前价、各倍数参考线。
- 下方列出从当前价近似高点回撤各倍数 ATR 的止盈参考位。
高位回撤止盈参考（从峰值回落 N×ATR 触发）
1.0× 回撤 -Y%
1.5× 回撤 -Y%
2.0× 回撤 -Y%
2.5× 回撤 -Y%
3.0× 回撤 -Y%
注意：ATR 页只是「静态参考」。实际触发由后台监控动态跟踪真实的 peak_price（期间最高价）计算，实盘止盈线只会随创新高而上移。
4.2 止损（纪律下限）
- ATR 止损：成本下方
N×ATR 设止损线。波动大的股票止损带更宽，避免被洗。
- 追踪止损：盈利后止损价随最高点上移，锁定部分利润（移动止损）。
- 触发即执行：止损是纪律下限，触发后按既定风控离场，避免深套。
4.3 追踪回撤止盈（核心设计）
本工具采用 Chandelier Exit（吊灯退出法）：
- 为什么用 N×ATR 回撤带：给足波动空间，持股过程不被日常震荡洗出局，拿得住趋势。
- 触发即必须卖：一旦从持仓期间最高点回撤达到 N×ATR，视为趋势已走坏，触发「锁定利润」的纪律条件。
这不是「涨到目标价立即卖」，而是「从最高点回撤够数才卖」。
4.4 两路止盈并存
| 类型 | 触发条件 | 行为 |
|---|
| 追踪回撤止盈 | peak_price 回撤 ≥ N×ATR | 提示减仓/清仓（主纪律） |
| 分批减仓 | 盈利达各档阈值 | 按比例减仓（如 5%/10%/15%） |
分批减仓需先满足激活条件（盈利达 激活倍数×ATR）才开始跟踪最高点，避免刚买就误触。
5工具箱
「工具箱」标签页提供四个实用工具：
5.1 组合分析
一键扫描全部持仓，汇总：总市值、总浮动盈亏、整体风险敞口、各标的触发状态。
5.2 批量检查止损
立即检查所有持仓是否跌破止损价，列出需关注的标的不等后台轮询。
5.3 仓位规模计算
输入：总资金、单笔可承受亏损比例、止损幅度（ATR 模式自动用真实 ATR）。
输出：建议股数、投入金额、最大亏损额 —— 帮你「先算亏多少，再决定买多少」。
5.4 买入计算器
输入成本价、目标价/止损价，给出风险回报比（RRR）与分批计划。用真实 ATR 换算，不再写死百分比。
6告警与监控
6.1 监控在背后做什么？
程序启动后，monitor.py 在后台默默工作：
- 每 5 秒轮询一次全部持仓。
- 实时更新
peak_price（期间最高）、当前价、真实 ATR（每 600 秒重算一次省接口）。
- 逐条判定 15 类预警（见下表）。
- 触发后：推送通知 + 落库记录（去重冷却防刷屏）。
6.2 支持的预警类型
| 类别 | 包含的预警 | 说明 |
|---|
| 价格类 | 涨停 / 跌停 / 炸板 | 到达涨跌停价位或开板 |
| 日内波动 | 日内大幅上涨/下跌 | 单日涨跌幅超阈值 |
| 量能类 | 放量异动 | 成交量异常放大 |
| 连续走势 | 连续上涨 / 连续下跌 | N 日连续同向 |
| 止损止盈 | 止损 / 追踪止损 / 分批止盈
追踪回撤止盈 | 触碰风控纪律线 |
| 其他 | 回本 / 单票最大亏损 / 波动收缩 | 特殊事件提醒 |
6.3 查看历史告警
切换到「告警」标签页，按时间倒序查看所有预警记录：类型、标的、触发价、时间。点击可看详情。
6.4 推送消息示例
【追踪回撤止盈】
贵州茅台 (600519)
持仓期间最高价 1182.19，当前从高点回撤 2×ATR（≈¥66.2），触及止盈线 ¥1115.97。
建议：趋势转弱信号已确认，按纪律止盈离场（可分批），锁定既有利润。
【止损预警】
贵州茅台 (600519)
当前价已跌破 2×ATR 止损线。
建议：止损是纪律下限，建议手动执行止损操作。
7设置说明
切换到「设置」标签页，分为三个区块：
7.1 外观
7.2 实时监控
- 暂停 / 恢复：临时停止后台轮询（不退出程序）。暂停期间仍保留 GUI 操作。
7.3 数据维护
- 立即备份：手动触发数据库备份（轮转保留最近 10 份）。
- 上次备份时间：显示最近一次自动备份的时间。
7.4 通知配置（详见第 8–9 节）
- 企业微信 Webhook 地址
- 飞书 Webhook 地址
- 免打扰时段
- 测试按钮（发送验证消息）
7.5 数据源
- 通达信路径：指向通达信安装目录（默认
D:\TDX）。
- TuShare Token：可选，填入后可用 TuShare 补齐历史数据。
7.6 自动刷新
8接入飞书机器人
飞书推送为交互卡片样式，按预警类型自动套颜色和建议语（止损=红、止盈=绿、异动=橙、回本=蓝）。
1
打开飞书群
进入你想接收预警的飞书群聊（已有群或新建群均可）。
2
添加群机器人
点击群名右侧 ··· → 「设置」→「群机器人」→「添加机器人」。
搜索「自定义机器人」，点击添加。
3
复制 Webhook 地址给机器人起个名字（如「守界风控」），安全设置选「自定义关键词」填入「守界」（也可选其他方式）。
创建完成后，复制
Webhook 地址，形如：
https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
4
填入软件设置
回到守界·大众版 →「设置」标签页 → 找到「飞书」区域 → 将复制的地址粘贴到 Webhook 输入框 → 勾选「启用」→ 点击「保存」。
5
测试验证
点击「测试」按钮，应在飞书群内收到一条「飞书推送功能正常！」的卡片消息。收到即表示接入成功。
飞书安全设置建议：
• 推荐使用「自定义关键词」方式，关键词填 守界（所有推送文案均含此词）。
• 如选「IP 白名单」，需确保你的出口 IP 稳定（家庭宽带 IP 可能变化）。
飞书卡片消息效果预览
不同预警类型的卡片颜色：
| 预警类型 | 卡片颜色 | 示例 |
|---|
| 止损 / 跌停 / 最大亏损 | 红色 | 紧急，需关注 |
| 止盈 / 涨停 / 连续上涨 | 绿色 | 利好，可持有观察 |
| 异动 / 放量 | 橙色 | 需留意 |
| 回本 | 蓝色 | 中性提醒 |
9接入企业微信机器人
企业微信推送为纯文本格式，简洁直接。止损类预警默认优先走此通道。
2
添加群机器人
点击群右上角 ··· →「添加群机器人」→「新建」。
搜索「自定义」（通过 webhook 方式接入），点击添加。
3
获取 Webhook Key给机器人命名（如「守界风控」），创建成功后会得到一个
Webhook 地址，形如：
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
复制完整地址。
4
填入软件设置
回到守界·大众版 →「设置」标签页 → 找到「企业微信」区域 → 将地址粘贴到 Webhook 输入框 → 勾选「启用」→ 点击「保存」。
5
测试验证点击「测试」按钮，应在企业微信群里收到一条文本消息：
【守界·大众版 测试消息】
软件: 守界·大众版 ATR风控工具
时间: 2026-07-13 16:00:00
状态: 企业微信推送功能正常！
收到即成功。
同时接入两个通道？ 可以。飞书和企业微信互不影响，可同时启用。软件会根据预警类型智能选择通道（见下一节）。
10推送规则与静默时段
10.1 通道分配规则
当两个通道都启用时，软件按以下策略选择推送通道：
| 预警类型 | 首选通道 | 备选通道 |
|---|
| 止损 / 最大亏损 | 企业微信 | — |
涨停 / 跌停 / 异动 / 连续
放量 / 回本 | 飞书 | 企业微信（飞书未启用时） |
| 其余类型 | 企业微信 | — |
如果首选通道未启用或发送失败，且备选通道也未启用，则本次预警不会推送（但仍会落库记录）。
10.2 静默时段（免打扰）
可在设置中配置免打扰时间段（默认 21:00 – 09:00）：
- 静默时段内，所有推送暂停，不会发到飞书或企业微信。
- 预警仍会正常检测并落库记录，只是不推送。
- 次日解除静默后，不会再补发历史消息（避免早上一堆过时消息轰炸）。
- 可在设置中关闭静默时段（全天推送）或调整时间范围。
10.3 冷却去重
同一只票的同一种预警类型，在冷却期内只推送一次，防止刷屏。冷却时间由内部算法根据预警严重程度自动设定。
11常见问题
Q：为什么我的止盈线一直在变？
追踪回撤止盈跟随 peak_price（期间最高价）上移。股价创新高，止盈线也跟着抬高；只有从最高点回撤达到 N×ATR 才触发。这是「移动止损保护利润」的设计。
Q：飞书/企业微信收不到消息？
请依次检查：
① 设置里的 Webhook 地址是否完整复制（不要漏掉末尾的 key）
② 机器人是否还在群里（被移除会失效）
③ 是否在静默时段内
④ 点「测试」按钮能否发出验证消息
⑤ 飞书安全设置的 IP 白名单 / 关键词是否匹配
Q：没有通达信能用吗？
可以。程序自动降级到 TuShare（需 token）/ 新浪 / 腾讯 行情接口。部分历史数据精度可能略低，但基本功能不受影响。
Q：数据存在哪里？安全吗？
全部存在本地 shoujie_clean.db（SQLite 数据库），位于你的用户目录下。
不上传任何持仓数据到服务器。你的持仓只有你自己能看到。
Q：可以同时接飞书和企业微信吗？
完全可以，两者独立配置、互不干扰。软件会根据预警类型自动选择合适的通道推送。
Q：「测试」按钮点了没反应？
说明 Webhook 地址有误或网络不通。请检查：
① 地址能否在浏览器中打开（应返回 {"errcode":0} 或类似 JSON）
② 是否被公司防火墙拦截（企业微信 webhook 域名为 qyapi.weixin.qq.com）
③ 重启软件后再试
Q：模板里写的「回撤 2×ATR」和 ATR 页看到的一致吗？
数值一致。ATR 页是静态参考（以当前价近似高点），监控是动态跟踪真实高点——实盘止盈线只会更优（随创新高上移）。
Q：如何备份数据？
「设置」→「数据维护」→ 点「立即备份」即可。程序也会每天自动备份，保留最近 10 份。备份文件为 .db 格式，可直接复制到安全位置。
Q：守界·大众版有手机版（Android）吗？
有。现已推出
Android 移动版（守界·大众版），功能与桌面端一致：持仓管理、ATR 计算器、策略模板、预警记录、设置中心。新安装默认提供
30 天免费试用，试用结束后需购买会员继续使用。APK 安装包请到
下载页 获取（要求 Android 6.0 及以上）。