Skip to content

Commit 17d127b

Browse files
hungryM0hungryM0
committed
文件拆分
1 parent f4b03de commit 17d127b

6 files changed

Lines changed: 208 additions & 160 deletions

File tree

‎.vitepress/config.mts‎

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,24 @@ export default defineConfig({
1717

1818
sidebar: [
1919
{
20-
text: '示例',
20+
text: '使用前准备：',
2121
items: [
2222
{ text: '下载与安装', link: '/download-install' },
23-
{ text: '如何提问', link: '/how-to-ask' },
24-
{ text: '使用说明', link: '/usage-guide' },
23+
{ text: '如何提问', link: '/how-to-ask' }
24+
]
25+
},
26+
{
27+
text: '使用过程：',
28+
items: [
29+
{ text: '载入问卷', link: '/upload' },
30+
{ text: '选项比例的配置', link: '/questions' },
31+
{ text: '运行参数', link: '/runtime' },
2532
{ text: 'API Key 配置', link: '/api-key-configuration' }
2633
]
2734
}
2835
],
2936

37+
3038
socialLinks: [
3139
{ icon: 'github', link: 'https://github.com/hungryM0/SurveyController' }
3240
]

‎download-install.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# 下载与安装
22

3-
真的不想说什么了，个别人连下载都不愿意去尝试，看都不看一眼就开始说“不会用”。我劝这些人还是别做什么问卷了吧，闲鱼花点钱请个代刷省大家的时间不好吗。
3+
~~真的不想说什么了，个别人连下载都不愿意去尝试，看都不看一眼就开始说“不会用”。我劝这些人还是别做什么问卷了吧，闲鱼花点钱请个代刷省大家的时间不好吗。~~
4+
5+
代填￥20起，不包售后，欢迎咨询。👍
46

57
:::tip 提示
68
以下都是简体中文教程，不难的，你真的能看懂的
@@ -10,11 +12,12 @@
1012

1113
双击下载到的安装包（此处以v3.0.4版本的为例），按提示安装。
1214

13-
![安装包界面](assets/install_1.png)
14-
1515
如果没有什么特别要求，大多数人保持默认一路`下一步`就行。
1616

17-
**没有必要听信什么“安装到 D 盘”之类的营销号，除非你真的有这个刚需。**
17+
> **没有必要听信什么“安装到 D 盘”之类的营销号，除非你真的有这个刚需。**
18+
19+
![安装包界面](assets/install_1.png)
20+
1821

1922
## 启动程序
2023

‎questions.md‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# 选项比例的配置
2+
3+
问卷解析成功后，程序会自动弹出一个便于你交互的界面，称为配置向导。
4+
5+
`自动配置问卷`会先帮你识别题型、跳题逻辑、分页情况。你需要做的只有动手`拖动滑块`或`输入数字`来调整每个选项的最终分布比例，其他的交给程序去实现。
6+
7+
下面简单介绍一下不同题型的配置逻辑
8+
9+
## 单选题、量表题、评价题
10+
> 滑块对应值表示**各选项大概的作答数量比例**
11+
>
12+
> 每题下方的百分数表示每个选项预期的最终占比，可能会不准确，仅供参考
13+
14+
![单选题与量表题配置](assets/config_1.png)
15+
16+
## 多选题
17+
> 每个选项的概率是独立计算的，不需要你把所有选项的概率总和硬凑到 100%
18+
19+
*<small>（ 例如，明天会下雨的概率是 60%，气温超过三十度的概率是 70%，而 60%+70%≠100% ）</small>*
20+
21+
![多选题配置](assets/config_2.png)
22+
23+
## 排序题
24+
> 不需要手动配比例，程序会自动随机排序
25+
>
26+
> 针对`至少选择x项`的排序数量要求，程序会自动识别
27+
28+
~~<small>（其实是不知道怎么规划排序题的交互界面会更合适，干脆完全随机就懒得管了）</small>~~
29+
30+
## 填空题
31+
> 你可以手动添加几条预设答案
32+
>
33+
> 程序会每次随机选一条填进去，但不能确保每个预设的答案都分别只用一次。
34+
35+
![填空题](assets/config_3.png)
36+
37+
我们也提供以下几种类型的处理方式：
38+
39+
- 随机姓名
40+
- 随机手机号
41+
- 随机身份证号
42+
- 随机整数
43+
- AI 填空
44+
:::tip 💡提示
45+
随机处理的结果完全由程序随机生成，并非真实数据
46+
:::
47+
48+
## 多项填空题
49+
> 按“一整组答案”来配置，每个空对应题目中的一个填空位置
50+
>
51+
> 其余与 [填空题](#填空题) 配置逻辑相同
52+
53+
![多项填空配置](assets/config_4.png)
54+
55+
:::warning ⚠️注意
56+
出于某些问卷设计者不看清题型就瞎搞的不负责态度
57+
58+
有的多项填空题可能只有 1 个填空位置，但是题型确实属于`多项填空题`的范畴。正常处理即可
59+
:::
60+
61+
## 带跳题逻辑的题
62+
没什么好说的，既然问卷里有这样的题目，肯定就有它存在的道理，剩下的就去咨询问卷的设计者吧
63+
64+
:::tip 💡提示
65+
如果你正好是问卷的设计者，请你重新端正设计问卷的态度
66+
67+
遇到不兼容、不支持的的题型，最快的解决方法是，稍微小改一些题目类型，让程序能够正确适配
68+
:::

‎runtime.md‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# 运行参数
2+
3+
这是一个很有价值的设置页面，十分建议仔细阅读和配置，几乎每一个选项都直接关系到你问卷的提交质量。
4+
5+
由于版本更迭在 UI 上的差异，以下截图可能和你看到的界面不完全一样，但大体逻辑都是没有变化的，看着配就行。
6+
7+
![作答设置](assets/runtime_1.png)
8+
9+
## 目标份数 & 并发数
10+
11+
这两个选项几乎是所有用户的必填配置项，在主页面也专门有这两个设置项的快捷入口。主页和运行参数页的这两个设置项是同步的，修改任一处都会同步更新另一个位置的显示。
12+
13+
至于**并发数**，简单来说就是提交速度。并发数越大，提交得越快，适用于问卷情况特别紧急的用户。
14+
15+
:::danger 🚫警告
16+
过高的并发数可能会导致电脑极度卡顿，不要无脑地追求过高的并发！除非你真的很紧急
17+
:::
18+
19+
下面以`无头模式`下提交 1000 份问卷数量为例，来说明不同并发数的提交效果：
20+
| 并发数 | 建议的最低配置 | 大约所需时间 |
21+
|-------|-------|-------|
22+
| 5 | 4核8G | 1小时 |
23+
| 16 | 8核16G | 40分钟 |
24+
| 32 | 8核24G | 25分钟 |
25+
| 64 | 12核24G | 15分钟 |
26+
27+
> 所以真的没必要拉高并发，又不是什么火烧眉毛的事情，慢工出细活没什么不好的。
28+
29+
:::tip 💡提示
30+
Playwright 的同步并发并不是线程安全的，创建、销毁、资源占用开销都是特别高的
31+
32+
因此，本程序采用了 async 异步单实例多 context 并发来极大降低资源占用，大幅提高性能
33+
:::
34+
35+
## 提升问卷信度
36+
37+
:::warning ⚠️注意
38+
此设置项仅对`量表题`、`矩阵量表题`、`评价题`生效！
39+
:::
40+
41+
标准的评估与调查问卷是采用严格的五级量表题型来设计的，采用诸如“`非常同意` `同意` `一般` `不同意` `非常不同意`”之类的选项内容。本程序对多级量表也提供支持。
42+
43+
> ⚠ 部分用户反映测试出来的信度过低，往往是他们采用了单选题而非量表题的题型设计，**属于问卷设计者自身的错误与失责**，非本程序问题！
44+
45+
支持自定义预期Cronbach's α系数，但最终以专业 SPSS 软件分析结果为准，此处仅供参考，不做保证。
46+
47+
## 无头模式
48+
49+
建议开启。启用则使浏览器在后台运行，不弹窗，资源占用小，不影响其他工作。
50+
51+
:::tip 💡提示
52+
若作答过程存在异常问题，建议关闭无头模式提交1份尝试复现。
53+
:::
54+
55+
## 提交间隔
56+
57+
即两次提交的问卷之间等待的时长。程序会在设定值附近做一点随机浮动。
58+
59+
绝大多数情况下，没必要调整此处的设置，保持默认为 0 即可，除非你真的有特殊需求。
60+
61+
![时间控制设置](assets/time_1.png)
62+
63+
如果你只是先测问卷是否能跑通，或者根本就没哪个闲着蛋疼要求你展示后台的详细作答情况，这里直接填 0 没有任何问题，反正问卷又不会被封禁。
64+
65+
反正真到了火烧眉毛的时候，这些时间控制啥的也都别管了，全部填 0 赶快填完再说吧…
66+
67+
## 作答时长
68+
69+
单份问卷大概耗时多久。程序会在你设定值附近做一点随机浮动。
70+
71+
:::tip 💡提示
72+
针对问卷星问卷，可通过修改 starttime 值可以实现伪造作答时长
73+
74+
即 5 秒钟完成提交，但后台显示 5 分钟甚至更长的时间
75+
:::
76+
77+
## 定时模式
78+
79+
一旦开启，就会忽略上述两个时间设置，改成在开放后立刻高频刷新并尽快提交。
80+
81+
:::tip 💡提示
82+
适用于`抢志愿名额` `抢选课名额`等类似场景，非特殊需求请勿开启
83+
:::

‎upload.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
outline: deep
3+
---
4+
# 载入问卷
5+
6+
请确保已按照 [下载与安装](./download-install) 的步骤成功安装了程序，并且已经正常打开了程序界面、准备好了问卷链接或者二维码图片。
7+
8+
## 导入问卷
9+
10+
打开程序后，你可以直接粘贴问卷链接，或者拖拽二维码图片到对话框中，也可以点击`左侧图标`手动选择问卷二维码图片。
11+
12+
![导入问卷](assets/gui_1.png)
13+
14+
:::warning ⚠️注意
15+
只接受标准的二维码！
16+
17+
**不接受**那种微信小程序码，还有那种封面花里胡哨绣了几朵花之后塞个小二维码的抽象艺术！
18+
:::
19+
20+
:::danger 🚫警告
21+
不接受考试、投票等不正当的问卷类型！
22+
:::
23+
24+
随后，点击`自动配置问卷`，会有友好的图形化界面引导你完成每个题目的配置。不要嫌麻烦，几个汉字有什么看不懂的。
25+
26+
一般来说，见数平台的问卷解析需要较长时间，甚至偶尔会失败。这是正常现象，重试几次就行了。如果还是不行，你可能要在自己浏览器里面亲自粘贴一遍问卷链接，看看是不是被要求登录拦截、或者是不是根本就没开放问卷
27+
28+
## 配置文件的复用
29+
30+
很多情况下，你可能会有多个问卷需求，或者同一个问卷需要在不同条件下都跑几次，又或者遇到报错需要提交反馈以便于复现问题。
31+
32+
右上角的`配置列表` `载入配置` `保存配置`就是适用于这些场景的。
33+
34+
![配置列表与保存](assets/gui_3.png)

0 commit comments

Comments
 (0)