Skip to content

revamp: publish detailed analysis, psychology methods, and project brief - #5

Merged
sherlock0717 merged 82 commits into
mainfrom
revamp/analysis-methods-doc
Jul 20, 2026
Merged

revamp: publish detailed analysis, psychology methods, and project brief#5
sherlock0717 merged 82 commits into
mainfrom
revamp/analysis-methods-doc

Conversation

@sherlock0717

@sherlock0717 sherlock0717 commented Jul 20, 2026

Copy link
Copy Markdown
Owner

发布内容

本次改版将 PsyLens 从简略项目入口扩展为完整的公开分析案例,页面、README、正式 DOCX 与方法文档采用统一数据口径。

1. 展示页

  • 增加研究设计、真实分析结果、话题与机制分布、交叉组合和平台描述性比较;
  • 增加心理学构念、数据清洗、证据切分、质量检查和可靠性评测流程;
  • 将抽样、编码来源与因果解释限制集中到一处“解释边界”;
  • 删除页面中反复出现的人工复核、待复核和内部状态提示;
  • 保留脱敏证据示例、离线 Demo 和资料入口;
  • 重做详细内容下的桌面端与移动端排版。

2. 正式项目说明

docs/files/PsyLens_project_brief.docx 已重写为 9 页完整文档,包含:

  • 执行摘要;
  • 项目问题与交付目标;
  • 数据设计与样本结构;
  • 数据清洗与证据构建;
  • 心理学分析框架;
  • 话题、机制、交叉与平台结果;
  • 证据示例;
  • 可靠性评测;
  • 产品方向与验证设计;
  • 解释边界、复现入口和参考文献。

Actions 生成版本已逐页渲染检查。表格跨页表头正常,没有裁切、重叠或空白尾页。

3. 公开数据与分析

  • 360 条样本,三个平台各 120 条;
  • 927 条证据,平均 2.575 条 / 样本;
  • 具体话题证据 441 条:平衡与数值 61.2%,匹配与对局分配 18.6%;
  • 已分配机制证据 441 条:胜任受挫 69.8%,公平受损 20.0%;
  • 机制 uncertain 为 486 条;证据纳入提醒为 163 条,两种口径分开统计;
  • ID、父样本、平台与文本回溯检查通过;URL、孤立证据和重复文本组均为 0。

新增确定性分析脚本 tools/summarize_public_analysis.py,页面读取生成的 analysis_summary.json

4. 数据 schema 修复

  • 删除 360 条样本中与 public_text 内容相同的冗余 raw_text 列;
  • 将 47 条空 surface_topic 统一为 other_uncertain
  • 新增 migration_history.json,记录迁移数量与保持不变的字段;
  • 修复规范化脚本重复运行后转换记录归零的问题;
  • manifest 记录 CSV 与 migration history 的 SHA-256。

5. 心理学与评测方法

新增:

  • docs/methodology/PSYCHOLOGY_FRAMEWORK.md
  • docs/methodology/DATA_CLEANING_AND_CODING.md
  • 重写 docs/evaluation/EVALUATION_METHOD.md
  • 重写 metrics、thresholds 与 failure taxonomy。

机制框架覆盖胜任受挫、公平受损、信任与沟通落差、归属感下降、规范与安全风险及显式不确定类别。

6. 全仓库审计修复

  • 修复文档中指向已删除 data/v2、旧评测脚本和 scripts_public 的失效说明;
  • 明确真实采集仅提供契约与配置模板,不把旧页面脚本包装成稳定能力;
  • requirements-optional.txt 替换失效的 legacy 脚本依赖说明;
  • 更新 Demo 与 Prompt 的输出路径和解释约束;
  • Pages 部署前重新运行数据规范化、分析汇总、DOCX 生成和 Demo;
  • CI 不再硬编码改版分支。

校验

Ubuntu 与 Windows 均已通过:

  • Python compileall;
  • Ruff 全目录静态检查;
  • Demo 与公开发布测试;
  • 数据规范化 smoke;
  • 分析汇总 smoke;
  • 正式 DOCX 生成 smoke;
  • Demo CLI smoke;
  • QA artifact 上传。

独立 Public Analysis Artifacts workflow 也已成功生成规范化数据、分析 JSON 和正式 DOCX。

仍需后续研究的内容

  • 240 条样本缺少日期,当前不做完整时间趋势分析;
  • 机制不确定率为 52.4%,需要通过上下文补充、标签边界修订与双人独立编码改善;
  • NGA / 贴吧历史 AI 编码与 B 站离线规则提案的来源不同,平台分布只作描述性比较;
  • 真实采集实现依赖平台当前接口与合规环境,公开仓库不声称现有模板可以直接抓取;
  • 产品方向仍需访谈、问卷、行为日志或实验验证。

合并方式:Squash and merge。

sherlock0717 and others added 30 commits July 20, 2026 15:36
github-actions Bot and others added 27 commits July 20, 2026 08:36
@sherlock0717 sherlock0717 changed the title revamp: expand analysis, methods, and project brief revamp: publish detailed analysis, psychology methods, and project brief Jul 20, 2026
@sherlock0717
sherlock0717 marked this pull request as ready for review July 20, 2026 09:05
@sherlock0717
sherlock0717 merged commit d60b7c3 into main Jul 20, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant