dsh-bagu 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,117 +1,137 @@
1
1
  # dsh-bagu
2
2
 
3
- 给一段话,数三样东西,再问你几个问题。
3
+ > 名字来自「八股文」——那种格式对仗、内容空洞、谁都能写的东西。
4
4
 
5
- 数的是:
5
+ ## 一句话:它是干什么的
6
6
 
7
- 1. **具体物** —— 每百字有几个数字、时间点、第一人称经历、原话、专有名字。
8
- 这些东西只有真的在场的人才给得出。
9
- 2. **撑场面的话** —— 意义、价值、本质、趋势这类抽象词,「重要、关键、深刻」这类评价词。
10
- 说得越多,越是在说事之外加光。
11
- 3. **留白词** —— 好像、应该、大概、可能。一个都没有,说明全篇没有一处不确定。
7
+ **你把一段话粘进去,它告诉你这段话里有没有「谁都能说」的成分。**
12
8
 
13
- 另算一个结构腔密度:不是X而是Y、先…再…、三段并列、破折号、「首先其次综上」,
14
- 跟同一文体的真人基线比,超三倍就报。
9
+ 不改你的字,不给分数,只指出哪几处可疑,然后问你几个问题。
15
10
 
16
- 输出长这样:
11
+ ## 什么是「八股」
12
+
13
+ 一句话,换个人说,还成不成立?
14
+
15
+ - 成立 → 就是八股。谁都能说的话,慢慢就没人想看了。
16
+ - 不成立 → 这段话里有只有你才给得出的东西。
17
+
18
+ 看两个例子就懂了:
17
19
 
18
20
  ```text
19
- [判断] 换谁都行 · 把这些句子搬到另一个人嘴里,读起来不会有差别。
20
- [具体] 每百字 0 个具体物 · 抽象词 1 · 评价词 1
21
- [留白] 0 个(0/千字) —— 一个都没有,等于句句在下断言
22
- [结构腔] 49.2/千字 · 基线的 37.8 倍
21
+ 差的:「本次修改已完成。首先调整了章节结构,其次新增了规则条款,最后优化了可读性。
22
+ 综上所述,这次改动具有重要意义。」
23
+
24
+ 好的:「改了 AGENTS.md,加了 §4。第七页那个表我删了,因为原来那三列一直是空的。」
23
25
  ```
24
26
 
25
- 底下跟一组问句,比如「开头就在总结,删掉这一句,下面的东西还站得住吗」。
26
- **它不给答案,也不改你的字。**
27
+ 第一段把「AGENTS.md」换成任何文件名都通顺,所以它是八股。
28
+ 第二段提到了第七页、提到了一个空表——别人编不出来。
27
29
 
28
- ## 它解决不了什么
30
+ ## 它看哪四样东西
29
31
 
30
- 先说清楚,免得期待错位。
32
+ | 看什么 | 具体抓什么 | 为什么算数 |
33
+ |---|---|---|
34
+ | **具体物** | 数字、时间点、「我试过」、原话、专有名字 | 只有真在场的人才给得出 |
35
+ | **撑场面的话** | 意义 / 价值 / 本质 / 趋势,重要 / 关键 / 深刻 | 说得越多,越是在给事加光 |
36
+ | **留白词** | 好像 / 应该 / 大概 / 可能 | 一个都没有 = 句句在下断言 |
37
+ | **结构腔** | 不是A而是B、先…再…、三段并列、破折号 | 真人用,但密度极低,超基线才报 |
31
38
 
32
- **它不管「整段话是不是人写的」,只管这段话里有没有可以指认的痕迹。**
33
- 通篇一个调子、每段都收个小结论、同一件事换个说法又说一遍 —— 这些它看不见。
39
+ 外加一个**同义轮换**:同一段里「使用 / 采用 / 运用」挑了两个以上。真人会反复用同一个词,换着说是心虚。
34
40
 
35
- **它是体温计,不是退烧药。** 测出来 49/千字不会让你的话变好。真要让一段话立起来的是
36
- 真实经验、只有当事人知道的细节、真的想说的观点。这三样插件给不了,模型也自己长不出来。
41
+ ## 装
37
42
 
38
- **它假设用的人愿意照镜子。** 会被说「一股 AI 味」的,多半是直接把输出复制出去。
39
- 这类人不会半夜开个 Node 脚本对着七个问句逐条想。对这种情况,工具的效果约等于零。
43
+ ```sh
44
+ dsh plugin --profile web add dsh-bagu
45
+ ```
40
46
 
41
- **规则会过期。** 今天有效的识别特征,一旦被规则化,就变成可学习、可识别的模式,
42
- 接着被新写法绕过。这是个止血带。
47
+ 装完重启一次 dsh。然后在**设置 → 八股检测**里能看到这一页。
43
48
 
44
- ## 它跟别的工具不一样在哪
49
+ ## 怎么用
45
50
 
46
- 市面上的同类多是**改写器**:读进去,吐一版「更像人」的。这类工具的问题是把话改了,
47
- 事也跟着丢了,而且改出来的东西有它自己的均匀。
51
+ **方式一 · 让它自己查。** 你写完一段话,跟它说:
48
52
 
49
- 这个只读不写。给坐标,不给成品。
53
+ ```
54
+ 帮我查查这段有没有八股味
55
+ ```
50
56
 
51
- ## 三个指标为什么这么定
57
+ 它会调 `bagu_check`,回三行:
52
58
 
53
- - **具体物**:可替换的反面。谁都能说的话里,一定没有只有当事人知道的东西。
54
- - **留白**:真人在不确定时会松口,AI 倾向给结论。一个「大概」都没有的段落,是在下断言。
55
- - **结构腔**:这些句式人类也用,只是密度极低。问题不是用不用,是用得多不多。
56
- 而且同一种句式重复两次不算病 —— 真人会重复自己的习惯,AI 是轮着用工具箱。
57
- 所以看的是同一百字里**几种不同句式扎堆**。
59
+ ```text
60
+ 可疑 具体0 抽象1 评价1 留白0 结构0/千
61
+ · 综上所述
62
+ 问 「综上所述」—— 这几个词,换成平时说话你会怎么讲?
63
+ ```
58
64
 
59
- ## 装了以后
65
+ 想要详细报告,加一句「完整报告」,它传 `full: true`,会给逐处的命中位置和六条问句。
60
66
 
61
- 系统提示里多一节「说话的念头」(讲念头,不列禁用词),两个只读工具:
67
+ **方式二 · 只要问句。**
62
68
 
63
- ```js
64
- bagu_check({ text: "……" }) // 指标 + 判档 + 问句
65
- bagu_ask({ text: "……" }) // 只要问句
69
+ ```
70
+ 用 bagu_ask 问问我这段话
66
71
  ```
67
72
 
68
- 外加一页设置:**设置 → 八股检测**。
73
+ 它只给问句,不给结论。答得上就留着,答不上来那处就是摆设。
69
74
 
70
- - **总开关**:关掉 = 那一节从系统提示里撤掉(立刻生效,不用重启)
71
- - **系统提示那一节开关**:关掉只留工具,不往提示里塞话 —— 想手动查、不想被改说话习惯的人用这个
72
- - **三个阈值**:留白词下限、结构腔报警倍数、具体物下限,都能调
73
- - **试一下**:粘一段话,当场看结果,不发送、不落盘
75
+ **方式三 · 设置页里当场试。** 粘一段话点「查一下」,不发送、不落盘。
74
76
 
75
- 配置存在插件目录的 `config.json`(已加进 `.gitignore`),宿主开 `/api/bagu`,
76
- 提供 `status` / `config` / `preview` 三个接口。
77
+ ## 它不干什么
77
78
 
78
- ## 装
79
+ 这几条先说清楚,免得期待错位。
79
80
 
80
- ```sh
81
- git clone https://github.com/hongdougao111/dsh-bagu.git
82
- dsh plugin --profile web add link:/path/to/dsh-bagu
83
- ```
81
+ **它不改写。** 一个字都不动。改是人的事,工具只把材料摆出来。
82
+
83
+ **它不给分数。** 没有「人味 62 分」这种东西。分数会让人只盯数字,不看句子。
84
84
 
85
- 或者直接用 release 里的 `dsh-bagu-0.2.0.tgz`。装完重启一次 dsh
86
- (宿主半侧、设置页和系统提示那一节都是启动时装配的)。
87
-
88
- 手动改 profile 的 `cordis.patch.yml` 也行:
89
-
90
- ```yaml
91
- - insert:
92
- - id: bagu
93
- name: dsh-bagu
94
- config:
95
- enabled: true
96
- prompt: true
97
- order: 921
98
- hedgeFloor: 0.5
99
- structureTimes: 3
100
- concreteFloor: 0.6
85
+ **它不是体检报告。** 它管不了「整段是不是人写的」。通篇一个调子、每段都收个小结论、
86
+ 同一件事换个说法又说一遍——这些它看不见,得你自己读。
87
+
88
+ **它是体温计,不是退烧药。** 测出来 49/千字,不会让你的话变好。真要让一段话立起来的是
89
+ 真实经历、只有你知道的细节、真的想说的观点。这三样插件给不了,模型也长不出来。
90
+
91
+ **规则会过期。** 今天有效的识别特征,被写成规则之后,就成了可以绕过去的东西。
92
+ 这是个止血带。
93
+
94
+ ## 省 token 是怎么做的
95
+
96
+ 这个插件从设计上就在控制上下文开销:
97
+
98
+ | 项 | 大小 |
99
+ |---|---|
100
+ | 系统提示注入 | 124 字(每次会话) |
101
+ | 两个工具的描述 | 62 字 |
102
+ | 默认输出 | 约 60 字(三行) |
103
+
104
+ 所有判断都在本地正则里跑完,**不调模型**——这是零 token 成本的那一半。
105
+ 要看详细报告才传 `full: true`,那时候才有几百字。
106
+
107
+ ## 短句也能查
108
+
109
+ 大部分「AI 味检测」靠密度(每百字几个),短句分母太小,等于废掉。
110
+
111
+ 这个插件在六十字以下切换成**绝对计数**:不看密度,看命中了什么。
112
+ 「不是A而是B」这种句式,出现在一句话里就已经可疑了,跟字数无关。
113
+
114
+ ```text
115
+ 「这不是技术问题,而是认知问题。」 → 可疑
116
+ 「卖卡卖完了随便写了」 → 正常
101
117
  ```
102
118
 
103
- ## 测试
119
+ ## 数据从哪来
120
+
121
+ 权重和基线不是拍的。主要依据:
122
+
123
+ - 两轮对照实验,1169 篇 / 520 万字 / 100+ 项指标([lieflat-less-ai-tone](https://github.com/larashero3-dotcom/lieflat-less-ai-tone))
124
+ - 10 万条真人评论 vs 2180 条 AI 评论的密度实测
125
+ - [sloplint](https://github.com/DW-Studio/sloplint) 的评分公式(绝对命中 + 权重,短文本可用)
126
+
127
+ ## 开发
104
128
 
105
129
  ```sh
106
- npm test # 30 个
130
+ npm test # 41 个
131
+ node preview.html # 需要起个本地服务器看 UI
107
132
  ```
108
133
 
109
- ## 边界
110
-
111
- - 中文为主,英文没专门校过
112
- - 基线取自中文评论语料,写长文和文档时会偏严 —— 那类文体本来就该有结构
113
- - 不给总分。分数会让人只盯数字,不看句子
114
- - 设置页在 headless 环境里没有,插件照样跑
134
+ 设置页的样稿在 `preview.html`,起个 `python -m http.server` 打开就能看,不用装 DSH。
115
135
 
116
136
  ## 许可
117
137