- 访客可在 <code>/faq</code> 提交提问（CSRF）；条目 <code>source=user</code> 待答
- Schema v2：<code>source</code> / <code>asker_name</code> / <code>user_id</code>
- 后台来源筛选、回复用户提问流；设置项「允许访客提问」
- API：<code>POST /api/v1/plugins/doc_ask/submit</code>
文档扩展
问答
站点问答中心：官方 FAQ + 访客提问待答；前台 /faq 聚合展示。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型文档扩展
版本v1.0.2
编码UTF-8
交付方式开源明文（weapp 目录）
商品介绍
这个插件能帮你做什么？
站点独立问答中心：官方维护 FAQ，访客可在前台 /faq 提交提问；站长回复并发布后公开展示。需要时也可把少量 FAQ 可选挂到单篇文档。
主路径是广场 / Hub；用户提问先进待答队列，不是多人讨论区（讨论可用评论/社区）。
典型场景
什么时候会生效？
| 情况 | 行为 |
|---|---|
| 插件启用 + FAQ 广场开启 | 前台 /faq（模板 list_page_faq）列出已发布「进广场」条目 |
| 允许访客提问开启 | /faq 显示提问表单；POST /api/v1/plugins/doc_ask/submit |
| 用户提问待答 | 后台条目状态「待答」；填写回答并启用后进广场 |
| 条目文档 ID = 0 且进广场 | 独立问答，不依赖任何文章 |
| 发布页展现 = 隐藏（默认） | 文档编辑器不出现问答面板 |
模板含 | 详情页输出该文档 FAQ |
站长怎么用？
- 插件中心启用「问答」。
- 「条目管理」写官方 FAQ，或回复访客在
/faq提交的待答问题。 - 「基础设置」：确认 FAQ 广场与「允许访客提问」开启。
- 前台打开
/faq验收列表与提问表单。
与正文的分工
复杂排版、图片教程写在文档正文；FAQ 保持简洁，便于折叠扫描。独立条目 document_id=0；挂载条目才关联具体文档。
常见问题
- /faq 空白？ 确认广场开关、条目「进广场」、模板为
list_page_faq。 - 后台建不了条目？ 用「新建独立问答」，不要依赖文档发布页（默认已隐藏）。
使用说明
功能简介（前端向）
主入口：站点页 默认折叠样式打包在 /faq 展示广场问答。可选：详情页通过
可用字段
字段 说明 示例 问题标题 折叠 summary 内 回答正文 details 内容区 排序值 后台排序 后台配置要点
前台效果示意
weapp/doc_ask/assets/css/ask.css，经 按需加载；主题勿复制整套 FAQ CSS，可在 frontassets 之后覆写颜色/间距。
升级日志
- 产品叙事改为「独立问答中心为主」；后台首页进条目管理
- 文档编辑器 slot 默认 hidden；设置文案对齐 Hub
- 条目列表支持新建/编辑；允许 <code>document_id=0</code>
- 前台 <code>list_page_faq</code> + InstallDemo 偏广场灌数
- 文档 FAQ 问答条目后台维护
- 文档编辑器 inline 问答 Tab
- 前台 `` 折叠展示
购买与安装
- 本插件为开源明文交付，源码位于站点
weapp/doc_ask/目录。 - 在站点后台 → 应用市场搜索
doc_ask安装并启用即可。 - 可按需二次开发；再分发须保留版权与许可声明。
交易须知
- 交付形式开源明文（weapp 目录），可按许可二次开发。
- 授权范围插件授权绑定单个站点域名；小程序类 SKU 规则以套餐说明为准。
- 退款规则请确认功能需求后再购买；非功能缺陷恕不退款。
- 官方保障官方插件由元舟提供安装指导与技术支持。