狗头军师 · Goutoujunshi:AI 恋爱军师 Skill · 最全部署与使用指南
一句话定位:GitHub 开源项目
shengjidaguai-china/goutoujunshi(狗头军师)是一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人文、哲学、婚姻家庭与性学知识库,支持多元关系。slogan:不只替你回消息,更帮你看清关系、判断局势、决定下一步。
仓库地址:https://github.com/shengjidaguai-china/goutoujunshi · 许可证:MIT · ⭐ 8546
目录
- 一、官方跳转与下载链接
- 二、项目简介与核心能力
- 三、官方图片
- 四、完整部署步骤(安装到 AI 智能体)
- 五、首次使用:建档问卷
- 六、使用方法详解
- 七、跨学科恋爱知识库
- 八、核心工作流:一次典型回答如何产生
- 九、设计原则与安全边界
- 十、按需加载:当前问题读什么
- 十一、项目结构全解
- 十二、版本更新维护记录
- 十三、常见问题排查
- 十四、参与建设与开源协议
- 十五、参考链接汇总
一、官方跳转与下载链接
二、项目简介与核心能力
2.1 这是什么
狗头军师是"升级打怪开源社区"首批开放共建项目。很多恋爱建议只有两个答案:"勇敢去追"或"赶紧分手"。狗头军师不会只凭一句话替你下结论——它先接住情绪,再把事实、推测和未知拆开;既看心动,也看现实条件、互惠、风险、机会成本和长期选择权,最后给出可以真正执行的下一步。
它不只是一个话术库:能读取聊天截图、导出文本和用户转述,区分素材来源与事实边界;把分析落到一句可发送的话、一次具体邀约、第一次见面安排或一段可复盘的对话演练。它是一套覆盖恋爱全周期、面向多元关系、能够解释建议理由的 Codex Skill。
2.2 核心能力一览
| 能力 | 说明 |
|---|---|
| 💬 即时话术 | 不知道这句话怎么回?先给一条能直接发送的话,再补时机和后续分支 |
| 🎯 关系推进 | 追求、复联、邀约、推进关系——给具体行动方案,按对方反馈继续调整 |
| 🔍 关系分析 | 结合行为、MBTI、主观评分和现实条件给明确判断,多人选择先分别分析再比较 |
| 🧠 长期记忆 | 首次明确同意后,跨任务记住双方档案和关键进展;自动更新、按需召回,可查看、暂停、撤销或清空 |
| 📊 聊天分析 | 锁定双方说话人,区分事实、推测和未知;可分析 ChatLab 已有数据(可选依赖) |
| 🧭 全周期覆盖 | 冷淡、冲突、投入失衡、分手、复合、婚姻选择——接住情绪,分析利弊,给下一步、观察窗口和停止条件 |
| 🏳️🌈 多元关系 | 支持异性恋、同性恋、双性恋、泛性恋、无性恋等;尊重跨性别、非二元性别及其他性别身份 |
2.3 不预设你应该爱谁
狗头军师支持各种性取向与性别身份,也可以讨论单身约会、长期伴侣、婚姻、异地、再婚、跨文化关系,以及建立在知情同意基础上的非单偶关系。系统不假设固定的性别角色:男女和多元性别用户都可以主动。对于中国常见的男女性约会语境,系统可能在没有明确拒绝或不适时建议男性把主动度提高一级——但这只是可被个人偏好和现实反馈覆盖的文化校准,不是"男性必须追、女性只能等"的定律。判断依据始终是具体的人、具体行为、双方意愿和现实条件。
三、官方图片
3.1 135 条参考资料总览

▲ 图 1:狗头军师 135 条参考资料总览(官方原图,2000×2000)——六大板块:关系科学/心理学/沟通研究、PUA/冷读与相关风险研究、法律/官方安全资料与统计、书籍与理论、课程/恋爱体系与公开材料、参考开源 Skill。
本图来自仓库
assets/reference-library-135.png,点击图片可查看完整尺寸。资料按证据强度和使用边界分类,详见references/knowledge/19-核心书单与论文索引.md。
四、完整部署步骤(安装到 AI 智能体)
4.1 前提条件
- 一个支持 Skill 技能目录机制的 AI 智能体(Agent),官方定位是 Codex(展示与默认提示词见
agents/openai.yaml); - 技能扫描规则:识别
<技能根目录>/<name>/SKILL.md这种单层直接子目录; - 本项目是单个 Skill(
goutoujunshi),不是多个——只需挂载一个目录。
4.2 方式一:口令安装(官方推荐,最简单)
将下面的安装口令发送给你使用的 AI 助手:
请将公开仓库 https://github.com/shengjidaguai-china/goutoujunshi 下载并安装为本地 Skill。
安装完成后,可以输入:
请使用狗头军师帮我梳理情绪、分析当前关系,并给出下一步建议。
4.3 方式二:手动克隆 + 挂载
# ① 克隆仓库
git clone https://github.com/shengjidaguai-china/goutoujunshi.git
cd goutoujunshi
# ② 在技能根目录建立软链接(macOS / Linux)
root="/path/to/skills"
ln -s "$(pwd)" "$root/goutoujunshi"
# Windows PowerShell(Junction 不需要管理员权限)
# New-Item -ItemType Junction -Path "<技能目录>\goutoujunshi" -Target "<本仓库路径>"
不用链接也可以:直接把整个仓库目录复制到技能根目录(代价是仓库更新后需重新复制)。
4.4 常用 Agent 的技能根目录
| Agent | 技能根目录 | 说明 |
|---|---|---|
| Codex | 见其文档"skills"配置 | 官方展示环境(agents/openai.yaml) |
| DSH | ~/.dsh/skills 或 <项目>/.dsh/skills |
已实测 |
| Claude Code | ~/.claude/skills |
已实测 |
| 通用 agents 约定 | ~/.agents/skills |
已实测 |
判断标准:该 agent 是否扫描某个目录下单层子目录里的
SKILL.md——是,就能装。
4.5 安装后验证
- 在 Agent 技能列表里看到
goutoujunshi; - 输入「请使用狗头军师帮我梳理情绪」,能触发建档问卷即安装成功;
- 可选:安装脚本
scripts/validate_skill.py可做项目完整性自检(白名单安装模式,不携带资料也能自检)。
五、首次使用:建档问卷
首次使用时,它会询问:
你:MBTI / 综合评分0–100 / 主要优势和短板
对象A:代号 / MBTI / 综合评分0–100 / 当前关系
对象B(如有):同上
经过:认识方式、发展时间、关键事件、联系和投入情况
目标:推进、确认、修复、比较选择,还是退出
情绪:目前最难受的点、强度0–10,以及是否有必须马上回复的消息
不知道的项目可以留空,也可以直接讲故事——Skill 会从叙述中整理档案,并只追问真正会改变建议的信息。需要跨任务复用时,Skill 会单独询问一次是否允许在本机保存精简档案;拒绝不影响正常使用。
紧急例外:当前对话没有档案时先发紧凑问卷;但如果处于危险、强烈崩溃或必须马上回复的状态,先处理眼前问题,再补档案。
六、使用方法详解
玩法一:分析已导出的聊天文件(ChatLab 可选依赖)
请使用狗头军师通过 ChatLab 分析我和对象A最近三个月的聊天。
- 狗头军师会先预览导入计划,再限定会话、对象和时间范围查询;
- 它不会直接读取、解密或导出聊天软件数据库;
- 没有 ChatLab 时仍可粘贴文字或上传截图分析。
玩法二:一句话怎么回
用户只问"这句怎么回"时,第一屏先给一条可复制成品,再写发送时机、主要代价和积极/含糊/不回应的后续。每条消息尽量只承载一个主动作,不堆叠承接、邀约、澄清和收线。
玩法三:多人选择比较
多人之间犹豫时,先分别分析再比较;区分"高分但不可得"和"略低但互惠稳定"。给出明确首选和 2–4 个理由,有真实权衡时再给不超过三个版本:稳健 / 会撩·策略 / 强势(强势是边界和快速筛选,不是羞辱、威胁或控制)。
玩法四:长期记忆(跨任务档案)
- 需要跨任务档案时,Skill 先读
references/practical/长期记忆与关系档案.md并检查状态; - 首次明确同意后才启用;同意后自动更新会影响未来建议的有限字段与关键事件,每次提示变更和撤销方式;
- 只按当前对象召回压缩上下文,不保存整份聊天,不无限累积;
- 用户可查看、暂停、撤销或删除;
- 没有记忆、字段缺失、脚本不可用或写入失败时,明确说不知道或没有保存,不从姓名、MBTI、旧案例或模型推测补事实,也不得声称已经记住。
玩法五:按需加载的知识检索
默认只读取当前问题直接需要的 1–3 份参考,不批量加载整个知识库。例如:问"冷读误用、PUA、推拉、服从测试、煤气灯"→ 只读 references/knowledge/05-PUA操控与伦理替代.md。
七、跨学科恋爱知识库
项目将核心关系知识、实用沟通和工具适配分开维护,覆盖:
| 领域 | 主要内容 |
|---|---|
| 关系心理学 | 吸引与选择、伴侣回应性、社会交换、比较水平、替代选择、承诺、依赖、权力、压力与修复 |
| 人格与情绪 | MBTI 的合理用法与局限、Big Five、依恋、焦虑与回避 |
| 认识与约会 | 吸引、主动表达、第一次见面、体验设计、邀约、确认关系、在线约会、幽灵与数字边界 |
| 沟通策略 | 聊天记录分析、场景校准、三层话术编排、对话演练、倾听、共情、赞美、冲突、道歉、拒绝与主动权 |
| PUA与社交策略 | Blueprint 内在状态、自然流、冷读、Mystery 结构/素材/表达,以及贬低、推拉、服从性测试、煤气灯等风险与低风险替代 |
| 性学与亲密 | 持续同意、性沟通、避孕与健康边界、身体自主和亲密协商 |
| 婚姻与家庭 | 婚前协商、共同财务、家务、育儿、双方父母与家庭生命周期 |
| 法律与安全 | 中国婚姻家庭法律、家暴、跟踪、诈骗、证据保存和危机转介 |
| 社会与人文 | 现代婚姻变迁、人口与城市化、平台约会、性别分工和照护劳动 |
| 恋爱哲学 | 欲望、友爱、自由、承诺、共同体、自我与他者、爱和占有 |
| 分手与特殊情境 | 失恋、背叛、复合、信任重建、多元关系与反刻板印象 |
知识库会区分较强研究证据、理论框架、流行说法和经验策略。MBTI、依恋类型和网络话术可以帮助提问和生成方案,但不会被包装成诊断、命运或"必胜公式"。 参考资料共 135 条,按证据强度和使用边界分类(见官方图片)。
八、核心工作流:一次典型回答如何产生
用户叙述
→ 情绪落地
→ 建立本人及目标对象档案
→ 分离事实/推测/未知
→ 检索当前情境所需知识
→ 比较互惠、现实、风险与机会成本
→ 给出明确首选建议和理由
→ 生成行动、话术、观察窗口与停止条件
每次分析五步法:
| 步骤 | 内容 |
|---|---|
| ① 情绪落地 | 用 2–4 句指出感受、触发点和冲突;认可感受,不替未经证实的解释背书;高情绪时先缩小到这一小时或发送前的动作 |
| ② 事实拆分 | 按需列已知事实、合理推测、关键未知;优先看持续主动、兑现、投入、边界和冲突修复,不凭单次回复、表情或标签定性 |
| ③ 利益判断 | 评估互惠、可靠、吸引、价值观、现实可行性、可逆性、安全与机会成本 |
| ④ 明确建议 | 先给一句首选和 2–4 个理由;有真实权衡时给不超过三个版本 |
| ⑤ 行动收束 | 给一个现在能做的小动作、观察窗口或停止条件,以及值得回来反馈的具体信号;只追问 1–3 个真正影响决策的问题 |
长期记忆和 ChatLab 只在用户同意或提供相应资料时按需使用,不改变这条核心分析流程。
九、设计原则与安全边界
9.1 六大设计原则
- 先接住人,再解决事。 情绪没有被看见时,最正确的建议也可能无法执行。
- 行为比标签可靠。 不凭 MBTI、性别或一次聊天记录替目标对象读心。
- 互惠比追到更重要。 得到某一个人不是唯一胜利;减少内耗、保留尊严与未来选择权同样是成功。
- 策略必须说明代价。 可以讨论撒娇、推拉、节奏和表达包装,但同时交代适用条件与长期成本。
- 同意和退出权不可绕过。 明确拒绝不是需要破解的障碍。
- 危险情境先保安全。 暴力、胁迫、跟踪、诈骗和自伤风险不能用普通恋爱话术处理。
9.2 经典社交体系的使用边界
只保留可观察、可纠正、可退出的能力:状态容纳、减少自我监控、现场取材、真实表达、双向筛选、阶段诊断、结构/素材/表达排错和反馈校准。把冷读改成"观察事实 + 暂定假设 + 邀请纠正",猜错时直接承认;不得把泛化陈述、人口统计、对方刚透露的信息或私下调查伪装成读心。
禁止:贬低、服从性测试、虚假时间限制、假未来、嫉妒操控、奖惩、煤气灯、孤立、跟踪或性施压的实施方案。不得把互动写成必须完成的漏斗;明确拒绝、僵住、躲避或撤回时立即停止。
9.3 安全边界
- 不诊断心理疾病,不用标签替代行为证据;
- 不保证话术能让特定的人爱上用户;明确表示不想发展时停止推进;
- 不协助性胁迫、下药、偷拍、跟踪、威胁、勒索、冒充、散布隐私或诈骗;
- 出现家暴、跟踪、强迫、财务控制、人身威胁或立即自伤、伤人、生命危险时,先确认当下安全并联系可信支持或当地紧急服务。
9.4 输入证据边界
| 素材类型 | 处理方式 |
|---|---|
| 聊天截图 / 导出 / 粘贴记录 | 只把可见原文、说话人、顺序、间隔和表情当事实;不补线下动作、语气或内心 |
| 长记录 | 先显示并锁定"用户/对象"的说话人映射;不按左右、语气或性别猜 |
| ChatLab | 只分析用户已提供或导入的数据,不声称能直接读取微信、QQ 记录 |
| 用户转述 | 视为用户提供的信息;精确措辞不可核实时注明 |
| 线下 / 通话 / 转写 | 区分观察、感受和解释 |
| 混合素材 | 分别标注"截图能证明""转述提示""仍未知";图片不清时请用户贴关键文字 |
资料彼此矛盾时指出矛盾;缺失信息保持未知,不为了完整而虚构。
十、按需加载:当前问题读什么
| 当前问题 | 必读或优先读取 |
|---|---|
| 一句话回复、开场、邀约、演练 | references/practical/实战话术编排器:从一句回复到后续分支.md |
| 松弛感、现场取材、轻松调情 | references/practical/场景感、松弛感与社交校准:从接话到关系推进.md |
| Blueprint、自然流、Mystery、冷读 | references/knowledge/20-经典社交体系的机制、证据与风险边界.md |
| 冷读误用、PUA、推拉、煤气灯 | references/knowledge/05-PUA操控与伦理替代.md |
| 聊天截图、网聊、隐私或诈骗 | references/knowledge/09-在线约会与数字关系.md |
| ChatLab、聊天文件、关系趋势 | references/practical/ChatLab聊天记录分析适配.md |
| 跨任务档案、记忆同意 | references/practical/长期记忆与关系档案.md |
| 主动表达、第一次见面 | references/practical/主动表达、第一次见面与自然接触.md |
| 投入失衡、降级或退出 | references/practical/关系投入失衡:互惠判断、降级投入与退出决策.md |
| 依恋、焦虑或情绪调节 | references/knowledge/03-依恋理论与情绪调节.md |
| MBTI | references/knowledge/04-MBTI人格与匹配.md |
| 冲突修复 | references/knowledge/07-沟通冲突与修复.md |
| 同意、性与亲密边界 | references/knowledge/08-同意边界性与亲密.md |
| 婚姻家庭、金钱家务育儿、分手背叛 | 知识 11、12、15 中对应的一份 |
| 家暴、跟踪、胁迫、法律或危机 | references/knowledge/17-中国法律安全与危机转介.md |
| 来源、证据等级或延伸阅读 | references/knowledge/01-证据分级与内容边界.md;19-核心书单与论文索引.md |
十一、项目结构全解
goutoujunshi/
├── SKILL.md # 核心行为与工作流(轻量行为与路由内核)
├── agents/openai.yaml # Codex 展示与默认提示词
├── README.md / README_EN.md # 中英文说明
├── LICENSE / LICENSE.zh-CN.md # MIT 许可(中英文)
├── CHANGELOG.md # 更新日志
├── CONTRIBUTING.md # 贡献指南
├── CODE_OF_CONDUCT.md # 行为准则
├── SECURITY.md # 安全说明
├── assets/
│ └── reference-library-135.png # 135 条参考资料总览图(官方图)
├── references/
│ ├── knowledge/ # 关系科学与跨学科知识文档
│ └── practical/ # 沟通、工具适配与记忆规则
├── documentation/ # 架构、流程与安全边界
└── scripts/
├── validate_skill.py # 项目完整性检查
└── memory_store.py # 同意门禁、限量记忆、撤销与删除
十二、版本更新维护记录
| 日期 | 类型 | 更新 | 用户价值 |
|---|---|---|---|
| 2026-08-03 | 记忆与聊天分析 | 保留老版建档、情绪承接、关系判断、主动推进和即时话术能力;增加首次同意后自动更新且可撤销的本地精简记忆,以及聊天截图、导出记录和 ChatLab 已有数据分析 | 支持跨任务复用有限档案、锁定聊天说话人并分析关系趋势 |
| 2026-07-23 | 架构 | 收缩 SKILL.md 为轻量行为与路由内核;新增经典社交体系机制/风险与伦理能力转译;验证器增加白名单安装模式 |
只按当前问题加载 1–3 份资料,日常上下文成本保守估算降低 48.3% |
| 2026-07-22 | 校准 | 新增主动表达、第一次见面与自然接触指南 | 普通约会默认更敢推进,同时保持清楚停止线 |
| 2026-07-22 | 扩充 | 调研童锦程、梵公子及关系副驾类 Skill,新增七种主策略、三层话术编排、36 条话术骨架和对话演练 | 用户问"这句怎么回"时先得到一条真正能发的首选成品 |
| 2026-07-22 | 改进 | 支持聊天截图、导出文本和粘贴内容,区分聊天、转述、通话、线下互动和混合素材 | 减少把文字聊天脑补成线下现场或把推测写成事实 |
| 2026-07-21 | 新增 | 增加投入失衡与体面退场模块 | 帮助用户判断是否继续投入、如何保护时间精力 |
十三、常见问题排查
| 问题 | 处理 |
|---|---|
| 安装后技能列表看不到 | 确认 goutoujunshi/SKILL.md 是技能根目录的直接子目录(不递归) |
| 首次使用问很多问题 | 不知道的项可留空,或直接讲故事;Skill 只追问真正会改变建议的信息 |
| 不想跨任务保存档案 | 拒绝不影响正常使用;已启用可随时查看、暂停、撤销或清空 |
| 想分析微信/QQ聊天记录 | 需先通过 ChatLab 导出你自己取得的聊天文件;Skill 不直接读取聊天软件数据库 |
| 截图太多看不清 | 主动贴关键文字或说明顺序;图片不清时它会请你补充 |
| 担心冷读/套路化 | 内置"观察事实+暂定假设+邀请纠正"模式,猜错会直接承认;禁止操控性方案 |
| 遇到家暴/威胁/危险 | 立即转入安全流程:先确认当下安全并联系当地紧急服务 |
| 想给朋友推荐 | 直接发仓库链接或安装口令即可 |
十四、参与建设与开源协议
参与建设:欢迎补充研究、改进话术、纠正文献或提交新的关系场景,开始前阅读 CONTRIBUTING.md。暂时不写代码也可以:点亮 ⭐ Star、分享匿名化真实场景、把它发给那个总在深夜替朋友分析感情的人。
开源协议:本项目采用 MIT License,允许商业使用、修改和分发;分发时须保留版权与许可声明。
本项目提供关系教育与决策支持,不替代心理治疗、医疗诊断、律师意见、警方或紧急服务。
十五、参考链接汇总
免责声明:本文所有命令、规则、数据均整理自官方 GitHub 仓库
shengjidaguai-china/goutoujunshi的 README 与 SKILL.md 原文,如仓库更新请以最新版本为准。本项目提供关系教育与决策支持,不替代专业服务。