把混沌的事件，拆成可检验的结构。
以三元结构理论为内核的结构化分析框架 —— 输入政策、事件、组织或舆论场的原始文本， 产出 Word / PDF / 交互式 HTML / PPT 四种格式的结构化报告。
以三元结构理论（三维 × 八阶 × 六类利益）为内核的结构化分析工具。输入政策文件、社会事件、组织资料或舆论场的相关文本，产出带来源标注的结构化报告，可导出 Word / PDF / 交互式 HTML / PPT。
分析方法是固定的：拆结构、约束输出、规范格式都写在框架里，同一份输入不会因为换一次对话就得到完全不同的结果。方法论、渲染器、利益关系网络图的代码全部开源，每一步怎么做的都可以审查。
已有 12+ 份真实案例报告验证（商标法修订、一人公司政策、胖猫事件舆论博弈、蜜雪冰城组织诊断等），均由 AI Agent 在框架约束下自动产出，脚本见
cases/目录。
这是作者的第一个完整产品实践，从零开始写。
| 起点 | 三元结构理论（三维 × 八阶 × 六类利益）。项目存在的理由就一个：把这套方法论变成能跑通、能交付的软件 |
| 投入 | 约两个月的业余时间，从第一行代码到第一个可交付版本 |
| 完成方式 | 一人完成：理论设计、架构、代码、提示词工程、文档、部署 |
| 定位 | 个人作品，入门级项目，知道自己在什么水平 |
与微舆（BettaFish）等同类成熟产品相比，本项目在功能覆盖、工程化程度和稳定性上都有明显差距——那些是投入量级完全不同的系统，不必硬比。
这个项目做到的事：把一套分析理论完整落成了工具链——理论假设 → 约束提示词 → 报告生成 → 导出交付，链路已跑通，仍在改进。
所有案例均为真实跑通的结果，不做演示性美化。发现问题欢迎直接提 Issue。
| 模式 | 结构 | 适用对象 |
|---|---|---|
| 政策分析 | 8 段式 | 法规、文件、制度文本 |
| 事件 / 案例分析 | 5 段式 / 深度 8 段式 | 社会事件、舆论热点 |
| 组织诊断 | 9 段式 | 组织、公司、机构 |
| 舆情分析 | 7 段式 | 舆论场、叙事竞争 |
支持组合分析：多模式章节按书写源序拼接，一份报告同时覆盖舆情 + 组织 + 政策多个维度。
- 利益关系网络 —— vis-network 关系图：力导向 / 环形分组 / 地理布局三种排布，支持利益类型、属地、强度阈值、关系状态四个维度筛选；节点大小 = 证据数、边宽 = 关系强度、跨省关系虚线标记，点开节点可查立场与逐条证据
- 写作规范校验 —— 内核强制校验输出：禁 EVD 编号、禁机械分层、禁套话，保证格式与质量的下限
- 版本留痕 —— 每次生成留存版本，可回溯、可编辑、可下载
- 联网检索降级链 —— BING → Brave → DuckDuckGo，零 Key 也能检索
- BYOK 架构 —— 访客自带 API Key，服务器不持有、不存储任何模型密钥，部署方零密钥成本、零额度风险
┌─────────────────────────────────────────────────────────┐
│ Next.js 15 前端工作台 │
│ 分析 / 项目 / 报告 / 利益网络 / 设置 / 实时进度 (WebSocket) │
└───────────────┬─────────────────────────┬────────────────┘
│ /api │ /ws
┌───────────────▼─────────────────────────▼────────────────┐
│ FastAPI 后端（SQLite） │
│ 任务队列 · 联网检索 · 提示词装配 · 契约校验 · 版本留痕 │
└───────────────┬───────────────────────────────────────────┘
│ engine.export_from_text()
┌───────────────▼───────────────────────────────────────────┐
│ 分析内核（纯 Python，可独立运行） │
│ parser → 三元结构分析 → docx / pdf / viz_network │
└───────────────────────────────────────────────────────────┘
- 前端 / 后端 / 内核三层解耦：内核可以脱离 Web 独立使用
- 单容器 Docker 部署（Caddy 反代），支持 Render Blueprint 一键上线
Windows 上零门槛启动：双击项目根目录的 启动工作台.bat
脚本会自动先关掉旧进程，再起新的前端 + 后端，所以改完代码后再双击一次就能看到新效果。
| 入口 | 地址 |
|---|---|
| 前端工作台 | http://127.0.0.1:3000 |
| 后端 API 文档 | http://127.0.0.1:8000/docs |
from engine import export_from_text
export_from_text(markdown_text, title="你的分析标题")| 层 | 选型 |
|---|---|
| 前端 | Next.js 15 · vis-network · ECharts |
| 后端 | FastAPI · SQLite · WebSocket |
| 内核 | 纯 Python（parser / docx / pdf / viz） |
| 部署 | Docker · Caddy · Render Blueprint |
项目在持续完善中，已知的改进方向（优先级由高到低）：
| 方向 | 要解决的问题 |
|---|---|
| 证据绑定 | 让每一个判断都能追到具体来源，并标注置信度与信息增量 |
| 数据锚点 | 关键结论尽量落到可查证的量化支撑，少用形容词 |
| 推演能力 | 博弈推演从"描述性"走向"带条件的阈值推演" |
| 案例积累 | 沉淀公开案例报告，形成可对照的样本库 |
| 交付体验 | 段落节奏、图表与正文的分工持续优化 |
- 提 Issue：bug、报告质量问题、对方法论本身的质疑，一律欢迎
- 提 PR：小修小补直接来；大改动建议先开 Issue 聊清楚再动手
- 方法论与报告结构：三元结构理论 © 2026，国作登字-2026-A-00048134
- 代码：GNU AGPL v3（见 LICENSE）
- 隐私：本项目为 BYOK 设计，不收集、不存储任何模型 API Key
- 作者联系：1823939919@QQ.com —— 定制分析、合作、方法论讨论都可以直接发邮件