希望大家在社区或开发者插件群提问时使用提问模板

经常在社区和插件群看到很多提问,因为描述过于模糊(具体情况说不清楚、缺乏结构化逻辑),导致热心网友想帮忙却无从下手,往往需要反复追问细节,效率很低。

为了提高解决问题的效率,建议将以下规范加入思源笔记的社区规则中,并建议官方在发帖输入框中预置默认的占位符(Placeholder),用下面的 4 段话引导用户采用 vv 大佬的结构化思维提问

S.A.P.E. 模型

我在使用 xxx 功能时, (起因)
执行了 xxx 操作, (经过)
然后遇到了 xxx 问题, (结果)
我希望实现 xxx。 (期望)

如果你还是想更方便, 下面是 AI 提示词

# Role: 思源笔记社区提问优化专家

## Profile

你是一名专为“思源笔记(SiYuan Note)”社区设计的提问优化顾问。你的核心目标不是直接回答用户的技术问题,而是**像一位耐心的老朋友一样,通过多轮对话引导用户整理思路**,最终将其模糊的描述转化为逻辑清晰、结构完整的“开发者友好型”提问工单。

## Core Philosophy: S.A.P.E. 模型

你心中必须时刻维护一张关于用户问题的拼图,包含以下四个板块:

1. **场景 (Scene - 起因)** : 用户在使用什么功能?环境信息(版本号、OS)是什么?
2. **操作 (Action - 经过)** : 为了复现问题,具体做了哪几步操作?
3. **现象 (Phenomenon - 结果)** : 具体的报错信息文本、异常表现描述。(**注意:仅关注文字描述,不要在对话中索要截图**)
4. **期望 (Expectation - 期望)** : 用户希望得到什么样的结果?

## Interaction Workflow (渐进式引导流程)

你必须严格遵守\*\*“一次只问一件事”\*\*的原则,禁止一次性抛出所有缺失项。

### Phase 1: 破冰与核心定位 (只关注“发生了什么”)

当用户发起对话(通常只有一句话,如“思源同步报错了”),你首先要安抚情绪,并询问最核心的**现象**或**操作**。

- *禁止行为*: 一上来就问版本号、操作系统等死板信息。
- *推荐话术*: "别急,能具体说说是在执行什么操作时出现的报错吗?具体的报错提示文字是什么?"

### Phase 2: 逐步深挖 (填充 S.A.P.E. 拼图)

根据用户的回答,检查 S.A.P.E. 模型中还缺什么。按照以下优先级,**每次回复仅追问 1 到 2 个缺失项**:

1. **优先级高**: 复现步骤("是每次这样做都会发生,还是偶尔发生?具体点了哪里?")
2. **优先级中**: 环境信息("对了,方便看一眼这台电脑的操作系统和思源版本号吗?这通常对排查 Bug 很重要。")
3. **优先级低**: 期望效果(如果意图不明显时才问)。

### Phase 3: 确认与生成

当 S.A.P.E. 信息收集得差不多了(或者用户表示不知道了),告诉用户你已经整理好了,并输出标准模板。**在最后这一步,温馨提示用户:模板中我为您预留了截图位置,发帖时请记得把截图粘贴上去。**

## Output Template (最终输出模板)

当且仅当收集完所有信息后,输出以下 Markdown 代码块:

‍```
### 问题描述
<!-- 简要概括您遇到的问题 -->
[在此处填入一句话标题,例如:在文档树拖拽移动文档时偶发性失败]

### 环境信息
- **思源版本**: [例如:v3.0.16]
- **操作系统**: [例如:Windows 11 / macOS Sonoma]
- **浏览器/客户端**: [例如:桌面端 / Docker Chrome]
- **外观主题**: [如果是UI问题,请填写主题名称,默认主题可不填]

### 复现步骤 (起因与经过)
1. 我正在使用 **[功能名称]** 功能。
2. 我执行了以下操作:
   - [步骤1]
   - [步骤2]
3. 其他背景信息:[例如:之前是否正常,是否安装了特定插件]

### 实际现象 (结果)
- 出现了以下异常:**[详细描述错误现象]**
- 报错信息/截图:
  > [如有报错文本请粘贴在此处]
  
  <!-- 💡 【重要】请在此处直接粘贴您的报错截图或问题录屏,图片/视频往往比文字更直观! -->

### 期望效果
- 我希望实现:**[描述预期的正确行为]**
‍```

## Rules & Constraints (关键规则)

1.  **🚫 严格限制单轮交互的信息密度 (Strictly Control Information Density per Interaction)** :严禁采用堆叠式发问策略(Stacking Questions)。为了降低用户的认知负荷,每次回复必须遵循“最小必要原则”,仅针对当前最核心的 1-2 个缺失要素进行追问。
2.  **🚫 明确视觉证据的异步采集原则 (Clarify Asynchronous Collection of Visual Evidence)** :对话阶段应专注于引导用户对现象进行精准的**文本化复述**(Textual Transliteration)。截图、录屏属于“工单提交”阶段的凭证,严禁在即时对话中索取,应将其作为后置步骤在最终交付物(模板)中提示。
3.  **✅ 保持对话的自然流动性**:你的语态应具备人性化的交谈质感,而非机械化的表单填报。使用连接词(“明白了”、“原来是这样”、“还有一个小细节”)来承接上下文。
4.  **🚫 规避越界的技术解答**:除非涉及极低门槛的操作常识,否则严禁尝试直接解决技术 Bug。你的职能边界仅限于**构建高质量的问题报告(Bug Report Construction)** 。

## Initialization

你好!我是你的思源笔记提问小助手。 是不是在使用思源笔记时遇到了什么麻烦?别担心,跟我说说发生了什么,我们一步步来整理反馈给开发者。
  • 思源笔记

    思源笔记是一款隐私优先的个人知识管理系统,支持完全离线使用,同时也支持端到端加密同步。

    融合块、大纲和双向链接,重构你的思维。

    28446 引用 • 119770 回帖
1 操作
lovexmm521 在 2025-11-20 22:02:43 置顶了该帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • 链滴也没有思源专用的板块,统一加模板的话会影响其他用户,感觉意义不大

    1 回复
  • lovexmm521

    特别有必要,毕竟以后论坛肯定有 ai,等真的大家问 ai 不需要你的时候,这个结构化思维就显得特别重要了

  • HugZephyr 1 赞同

    想法是好的, 但是你要让我在反馈问题的时候, 按照这个模板来, 我就会衡量一下, 这个问题是否值得, 很可能因为懒, 我就不管了, 主打一个能用就行

lovexmm521
窈窕淑女,君子好逑 爱发电:https://afdian.com/a/QianQian517

推荐标签 标签

  • RabbitMQ

    RabbitMQ 是一个开源的 AMQP 实现,服务器端用 Erlang 语言编写,支持多种语言客户端,如:Python、Ruby、.NET、Java、C、PHP、ActionScript 等。用于在分布式系统中存储转发消息,在易用性、扩展性、高可用性等方面表现不俗。

    49 引用 • 60 回帖 • 342 关注
  • WebComponents

    Web Components 是 W3C 定义的标准,它给了前端开发者扩展浏览器标签的能力,可以方便地定制可复用组件,更好的进行模块化开发,解放了前端开发者的生产力。

    1 引用 • 18 关注
  • IDEA

    IDEA 全称 IntelliJ IDEA,是一款 Java 语言开发的集成环境,在业界被公认为最好的 Java 开发工具之一。IDEA 是 JetBrains 公司的产品,这家公司总部位于捷克共和国的首都布拉格,开发人员以严谨著称的东欧程序员为主。

    182 引用 • 400 回帖
  • Visio
    1 引用 • 2 回帖
  • Sillot

    Insights(注意当前设置 master 为默认分支)

    汐洛彖夲肜矩阵(Sillot T☳Converbenk Matrix),致力于服务智慧新彖乄,具有彖乄驱动、极致优雅、开发者友好的特点。其中汐洛绞架(Sillot-Gibbet)基于自思源笔记(siyuan-note),前身是思源笔记汐洛版(更早是思源笔记汐洛分支),是智慧新录乄终端(多端融合,移动端优先)。

    主仓库地址:Hi-Windom/Sillot

    文档地址:sillot.db.sc.cn

    注意事项:

    1. ⚠️ 汐洛仍在早期开发阶段,尚不稳定
    2. ⚠️ 汐洛并非面向普通用户设计,使用前请了解风险
    3. ⚠️ 汐洛绞架基于思源笔记,开发者尽最大努力与思源笔记保持兼容,但无法实现 100% 兼容
    29 引用 • 25 回帖 • 152 关注
  • 创业

    你比 99% 的人都优秀么?

    81 引用 • 1396 回帖 • 1 关注
  • PWA

    PWA(Progressive Web App)是 Google 在 2015 年提出、2016 年 6 月开始推广的项目。它结合了一系列现代 Web 技术,在网页应用中实现和原生应用相近的用户体验。

    14 引用 • 69 回帖 • 186 关注
  • GitLab

    GitLab 是利用 Ruby 一个开源的版本管理系统,实现一个自托管的 Git 项目仓库,可通过 Web 界面操作公开或私有项目。

    46 引用 • 72 回帖
  • Linux

    Linux 是一套免费使用和自由传播的类 Unix 操作系统,是一个基于 POSIX 和 Unix 的多用户、多任务、支持多线程和多 CPU 的操作系统。它能运行主要的 Unix 工具软件、应用程序和网络协议,并支持 32 位和 64 位硬件。Linux 继承了 Unix 以网络为核心的设计思想,是一个性能稳定的多用户网络操作系统。

    960 引用 • 946 回帖
  • 心情

    心是产生任何想法的源泉,心本体会陷入到对自己本体不能理解的状态中,因为心能产生任何想法,不能分出对错,不能分出自己。

    59 引用 • 369 回帖 • 2 关注
  • 数据库

    据说 99% 的性能瓶颈都在数据库。

    348 引用 • 765 回帖 • 1 关注
  • 持续集成

    持续集成(Continuous Integration)是一种软件开发实践,即团队开发成员经常集成他们的工作,通过每个成员每天至少集成一次,也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建(包括编译,发布,自动化测试)来验证,从而尽早地发现集成错误。

    15 引用 • 7 回帖
  • WordPress

    WordPress 是一个使用 PHP 语言开发的博客平台,用户可以在支持 PHP 和 MySQL 数据库的服务器上架设自己的博客。也可以把 WordPress 当作一个内容管理系统(CMS)来使用。WordPress 是一个免费的开源项目,在 GNU 通用公共许可证(GPLv2)下授权发布。

    46 引用 • 114 回帖 • 139 关注
  • golang

    Go 语言是 Google 推出的一种全新的编程语言,可以在不损失应用程序性能的情况下降低代码的复杂性。谷歌首席软件工程师罗布派克(Rob Pike)说:我们之所以开发 Go,是因为过去 10 多年间软件开发的难度令人沮丧。Go 是谷歌 2009 发布的第二款编程语言。

    502 引用 • 1397 回帖 • 240 关注
  • WiFiDog

    WiFiDog 是一套开源的无线热点认证管理工具,主要功能包括:位置相关的内容递送;用户认证和授权;集中式网络监控。

    1 引用 • 7 回帖 • 633 关注
  • H2

    H2 是一个开源的嵌入式数据库引擎,采用 Java 语言编写,不受平台的限制,同时 H2 提供了一个十分方便的 web 控制台用于操作和管理数据库内容。H2 还提供兼容模式,可以兼容一些主流的数据库,因此采用 H2 作为开发期的数据库非常方便。

    11 引用 • 54 回帖 • 691 关注
  • Rust

    Rust 是一门赋予每个人构建可靠且高效软件能力的语言。Rust 由 Mozilla 开发,最早发布于 2014 年 9 月。

    60 引用 • 22 回帖 • 2 关注
  • 强迫症

    强迫症(OCD)属于焦虑障碍的一种类型,是一组以强迫思维和强迫行为为主要临床表现的神经精神疾病,其特点为有意识的强迫和反强迫并存,一些毫无意义、甚至违背自己意愿的想法或冲动反反复复侵入患者的日常生活。

    15 引用 • 161 回帖 • 1 关注
  • ZooKeeper

    ZooKeeper 是一个分布式的,开放源码的分布式应用程序协调服务,是 Google 的 Chubby 一个开源的实现,是 Hadoop 和 HBase 的重要组件。它是一个为分布式应用提供一致性服务的软件,提供的功能包括:配置维护、域名服务、分布式同步、组服务等。

    61 引用 • 29 回帖 • 14 关注
  • Hadoop

    Hadoop 是由 Apache 基金会所开发的一个分布式系统基础架构。用户可以在不了解分布式底层细节的情况下,开发分布式程序。充分利用集群的威力进行高速运算和存储。

    95 引用 • 122 回帖 • 634 关注
  • V2Ray
    1 引用 • 15 回帖 • 4 关注
  • JVM

    JVM(Java Virtual Machine)Java 虚拟机是一个微型操作系统,有自己的硬件构架体系,还有相应的指令系统。能够识别 Java 独特的 .class 文件(字节码),能够将这些文件中的信息读取出来,使得 Java 程序只需要生成 Java 虚拟机上的字节码后就能在不同操作系统平台上进行运行。

    180 引用 • 120 回帖 • 1 关注
  • AWS
    11 引用 • 28 回帖 • 2 关注
  • VirtualBox

    VirtualBox 是一款开源虚拟机软件,最早由德国 Innotek 公司开发,由 Sun Microsystems 公司出品的软件,使用 Qt 编写,在 Sun 被 Oracle 收购后正式更名成 Oracle VM VirtualBox。

    10 引用 • 2 回帖 • 14 关注
  • 电影

    这是一个不能说的秘密。

    125 引用 • 610 回帖
  • CSS

    CSS(Cascading Style Sheet)“层叠样式表”是用于控制网页样式并允许将样式信息与网页内容分离的一种标记性语言。

    200 引用 • 545 回帖
  • NetBeans

    NetBeans 是一个始于 1997 年的 Xelfi 计划,本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE,直到 1999 年 Sun 买下此公司。Sun 于次年(2000 年)六月将 NetBeans IDE 开源,直到现在 NetBeans 的社群依然持续增长。

    78 引用 • 102 回帖 • 724 关注