狗头军师开源贡献指南:如何为AI恋爱军师的知识库补充新关系场景与话术
【免费下载链接】goutoujunshi一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人文、哲学、婚姻家庭与性学知识库,支持多元关系。项目地址: https://gitcode.com/gh_mirrors/go/goutoujunshi
如果你正在为开源项目狗头军师贡献内容,这篇指南会带你一步步理解它的知识库架构,学会如何为这位 AI 恋爱军师补充新的关系场景与实用恋爱话术。无论你是心理学爱好者、沟通实践者,还是只想把身边真实故事沉淀成案例,都能在这里找到上手的起点。
🎯 一句话定位:狗头军师是一款"先接住情绪、再分析关系、最后给可执行策略"的 Codex 恋爱军师。它的聪明,来自一套分层维护的跨学科知识库。
先认识架构:狗头军师的三层知识库
在动手之前,先搞清楚"新知识该放哪里"。整个项目把行为规则、核心知识与实用材料分成三层,各司其职:
| 层级 | 所在目录 | 你往里放什么 |
|---|---|---|
| 行为规则 | SKILL.md | 何时提问、如何分析、输出格式与安全边界 |
| 核心知识 | references/knowledge/ | 心理学、法律、社会、人文与哲学等背景理论 |
| 实用材料 | references/practical/ | 接话、赞美、拒绝、冲突、主动推进等沟通话术 |
关键机制是按需加载:运行时只读取当前问题直接需要的 1–3 份资料,而不是把整个知识库灌进上下文。这意味着你新增的内容越"聚焦",就越容易被精准调用。
💡 建议:动手前先通读 references/practical/00-导读与使用分级.md,它定义了话术的"使用分级"与目录主题,是你判断"新场景属于哪一层"的最好参照。
新手优先贡献哪类内容
不是所有内容都同等重要。以下类型最受欢迎,也是新手最容易切入的方向:
- ✅修正事实:文献引用、法律口径、过时信息的校对;
- ✅补充场景:不同性取向、性别身份、文化、年龄、残障或家庭结构下的关系情境;
- ✅打磨话术:更自然的中文表达、地区化语气、可直接发送的对话模板;
- ✅提供测试:暴露读心、刻板印象、过度承诺或安全风险的边界场景;
- ✅修复链接:断链、目录、元数据与验证脚本问题。
完整的清单可以在 CONTRIBUTING.md 里查到。
如何补充一个新的关系场景
"场景"是指知识库尚未覆盖、但真实存在的处境,比如"未出柜的同性恋爱""异地再婚""跨文化约会"。贡献流程如下:
1. 判断该放哪一层
- 偏理论、证据、法律→ 放进 references/knowledge/,沿用现有的编号命名(如
11-婚姻家庭与生命周期.md); - 偏可执行的沟通与策略→ 放进 references/practical/。
2. 用统一结构写文档
项目对实用话术有固定骨架,新增场景请保持一致:
适用场景 → 预期效果 → 主要代价 → 下一步分支
这样写,才能让军师在"积极/含糊/不回应"三种反馈下都有据可依。
3. 对齐证据分级
在 references/knowledge/01-证据分级与内容边界.md 里,内容被分为较强证据、理论框架、流行说法、经验策略四级。MBTI 配对、依恋标签属于"流行说法",可以打开对话,但不能写成诊断或命运。
4. 让新场景被"路由"到
如果运行确实依赖这份新文档,需要在 SKILL.md 的按需加载路由表里登记路径。但请记住知识库治理原则:不设置最低篇数,不以数量激励膨胀——只补真正被需要的那一份。详见 documentation/knowledge-base.md 中的更新规则。
如何写一条能落地的恋爱话术
好的话术不是一句俏皮话,而是一套"可执行的分支"。项目核心参考 references/practical/实战话术编排器:从一句回复到后续分支.md 的做法值得照搬:
- 先给一条能直接复制发送的成品,再补发送时机与后续分支;
- 每条消息只承载一个主动作,不堆叠承接、邀约、澄清和收线;
- 提供三档强度:稳健版、会撩/策略版、强势版,让用户按关系阶段自选;
- 标注关键代价:积极、含糊、不回应时各自的下一步是什么。
想看看成熟样本,可以参考 references/practical/巧妙接话技巧:让沟通更流畅的实用指南.md,它把"接话"拆成了情绪优先、关键词延伸、补全细节、救场补位四类方法,结构清晰、实例丰富,是很好的模板。
证据分级:让贡献内容站得住脚
知识库最看重"诚实的证据边界"。提交知识文档时,请务必明确区分四类来源:
| 等级 | 特征 | 推荐表述 |
|---|---|---|
| 较强证据 | 元分析、系统综述、大型纵向研究、现行法律 | "综合证据较一致""现行制度为" |
| 理论框架 | 有学术来源,但不能诊断个体 | "可作为提问框架" |
| 流行说法 | MBTI、依恋标签、爱情语言等 | 注明证据局限 |
| 经验策略 | 依赖场景、缺乏稳定研究支持 | 给适用条件与代价 |
引用请优先原始研究、政府、法院、国际组织与大学资料,不要用单一自媒体文章支撑医学、法律或因果结论。完整的书单一律汇总在 references/knowledge/19-核心书单与论文索引.md。
内容红线:这些场景请绕行
为了保证项目"安全、包容、可退出",以下内容不会被接受,请务必避开:
- 🚫 帮助实施性胁迫、下药、偷拍、跟踪、勒索、诈骗或规避明确拒绝;
- 🚫 把人格类型、性别或性取向写成命运或"必胜公式";
- 🚫 用疾病标签羞辱或做未经诊断的读心;
- 🚫 把某种关系形式默认成更高尚或更低级。
✅ 你可以提交这些机制的风险分析与低风险替代方案,这正是知识库鼓励的方向。
提交前 5 步自检流程
走完这五步,你的贡献才算完整:
- 克隆仓库:
git clone https://gitcode.com/gh_mirrors/go/goutoujunshi - 建分支:Fork 后创建主题分支,只改与本次贡献相关的文件;
- 跑验证:执行
python3 scripts/validate_skill.py,确保无断链、无占位符、预算不超限(见 scripts/validate_skill.py); - 写说明:在 Pull Request 里讲清改了什么、为什么、证据来源、对用户的价值;
- 给场景:若改了建议流程,至少附一个成功场景和一个失败/边界场景。
版本与兼容性记录可在 CHANGELOG.md 中查看,保持贡献风格一致。
常见问题 FAQ
Q:我不会写代码,能贡献吗?能。狗头军师的核心贡献是 Markdown 知识文档与话术,几乎不需要代码。跑一次验证脚本即可完成自检。
Q:新增一篇文档必须改 SKILL.md 吗?不是。只有当运行真正依赖这份文档时,才把它加入路由与必需清单,避免上下文膨胀。
Q:能直接把朋友的真实聊天记录放进去吗?不能。真实用户的私密案例不得直接沉淀进公开知识库,需先匿名化、脱敏。
结语
给狗头军师补充内容,本质上是把"你的清醒"变成"更多人的清醒"。从一篇场景文档、一条落地话术开始,保持诚实的证据边界与包容的表达,你就能让这位 AI 恋爱军师更懂真实的人、给出更稳的下一步。🌱
【免费下载链接】goutoujunshi一个先接住情绪、再分析关系并给出可执行策略的 Codex 恋爱军师,内置心理、法律、社会、人文、哲学、婚姻家庭与性学知识库,支持多元关系。项目地址: https://gitcode.com/gh_mirrors/go/goutoujunshi
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考