Releases · wzn1118/AsteriaAnalyst

发布说明

这是替代 v0.1.0 的正式公开发布版。v0.1.0 的公开 CI 未通过，且 Windows 便携包在解压路径包含空格时存在启动风险；请使用本版本，不要继续下载旧资产。

本次修复

修复 Windows 源码启动器和便携包启动器的路径引用，已在包含空格的目录中实测启动。
修复公开 CI 的前端 CommonJS lint 边界，并移除测试对私有数据集和本机绝对路径的依赖。
修复运行时、历史报告和 Smart Lens 的公开契约回归，同时保持正式管理报告的 AI 强制链、确定性数值计算、证据校验和 FormalPDFReleaseGate 不被绕过。
便携包使用独立 Python 运行时和同源前端，默认仅监听本机回环地址。

验证结果

GitHub Actions：前端与后端作业均已成功完成。
后端：551 项测试通过。
前端：lint 无错误、方法指南校验通过、生产构建通过；高危依赖审计为 0。
Windows 便携包：在含空格的解压目录中启动成功，/health、/analysis、/api/manifest、/api/datasets?compact=true 均返回 200。

Windows 快速使用

下载并解压 AsteriaAnalyst-portable.zip。
双击解压目录中的 start-asteria.bat。
等待浏览器自动打开 Asteria Analyst；如未自动打开，请访问 http://127.0.0.1:8787/analysis。
使用完成后关闭启动窗口或相应后台进程。

文件完整性

文件名：AsteriaAnalyst-portable.zip
SHA-256：BB3EFE88A19918EBBC9CBB33E3031351EE282FA0BF488D3D9213387EF09A8C8F
本包为本机单用户使用设计；正式管理报告只有在 AI 追踪、Schema 校验、确定性指标执行、证据校验及质量门槛全部通过时才会发布。

中文功能与模块全览

本说明与仓库内的详细文档同步，覆盖当前公开版能看到的页面、主要操作、后端职责、输出、前提条件和边界。需要逐项核对具体接口、数据结构、方法卡和失败状态时，请继续阅读完整的《功能逐项参考》。

1. 启动、健康检查与本机边界

Windows 便携版：下载 AsteriaAnalyst-portable.zip，完整解压后运行 start-asteria.bat；它会启动本机服务并打开工作区。
源码版：在 Windows 上运行 start-asteria.cmd，需要 Python 3.11+、Node.js 20.9+ 和首次安装依赖时可用的网络。
默认前端入口是 http://127.0.0.1:3000/analysis，后端健康检查是 http://127.0.0.1:8000/health；端口冲突时以启动器输出的实际地址为准。
项目默认只面向回环地址、本机单用户工作台，不是公网多用户 SaaS；不要直接暴露到互联网或共享网络。

2. 数据接入、工作簿和上下文材料

可导入 CSV、TSV、Excel（.xlsx；前端也接受 .xls）和 Stata（.dta）结构化数据。
Excel 工作簿支持识别和选择工作表；同一任务可以选择单表、合并多表、分别分析多表或组合分析。
数据画像会给出行列规模、数值/类别/日期字段、缺失值、字段摘要、样本行、工作表信息和可视化建议；大数据浏览器预览会采样以保持可用性。
可管理历史报告和业务背景材料，用作任务上下文、交付格式参考或业务约束说明；它们不能替代原始数据，也不会自动成为已验证事实。

3. 首页与智能报告任务设计

首页（/）提供快速智能报告入口：选择或上传数据，填写问题、目标读者、业务背景、约束和交付目标，然后进入报告任务。
正式分析页（/analysis）提供更完整的工作表、数据画像、业务简报、统计选项、任务进度、结构化章节、图表、表格和下载资产。
快速统计可按任务选择相关矩阵、OLS、随机森林、K-Means、PCA、正态性等受控方法；最多可绑定的特征数、实际可运行方法和产物取决于数据类型与后端能力。
报告的深度、视觉风格、图表说明、全文表格偏好、交付目标和行业/业务路线属于任务配置，不代表每个配置都会在每份数据上产生有效结论。

4. 数据画像、字段语义和业务路由

DataProfileService 在分析前确认数据结构、字段类型、缺失、候选时间/数值/分类字段与分析对象。
AIFieldSemanticMapper 只能辅助解释字段可能的业务含义和角色；单位、口径、时间窗、粒度和敏感字段仍需用户确认。
AIBusinessContextRouter 将数据和业务背景用于选择合适的问题框架、行业或业务路线；路由命中不是行业结论，也不保证任意数据都会进入专项模板。
AIMetricDerivationPlanner 把可直接计算、可由字段推导、仅属待验证假设和当前数据不支持的内容区分开来，防止把推测写成结论。

5. 受控统计、图表和证据

统计目录可检索描述统计、频数、交叉表、透视表、分位数、截尾、基尼、帕累托、KPI、相关、回归、组间比较、A/B 测试、方差分析、分类检验、非参数检验、Bootstrap、置换检验、PCA、K-Means、随机森林、基础神经网络、正态性和部分时间序列方法。
统计目录是路由和发现入口；出现方法名称不等于当前发布版每项都已有可执行引擎。方法运行必须匹配字段类型、样本量、方法假设和业务口径。
结果可以包括表格、图表、指标、方法说明、字段审计、清洗/派生过程、原始结果包或下载资产。相关、分类或预测结果不是因果结论。

6. 智能报告、异步任务和资产管理

报告任务通过 /api/datasets/{dataset_id}/smart-report 提交，任务状态可由 /api/report-jobs/{job_id} 跟踪，完成后在 /api/reports 浏览。
输出可能包括报告文本、HTML/PDF、表格、图表、CSV/XLSX、JSON、README、manifest、方法级证据或调试资产；实际文件由本次数据、路线、运行结果和交付清单决定。
报告资产可被下载、复核和后续修订。拿到文件不等于已经满足正式管理报告的发布条件。

7. 正式管理报告的强制可信链

正式 management_report.pdf 必须完整经过：
raw data -> DataProfileService -> AIFieldSemanticMapper -> AIBusinessContextRouter -> AIMetricDerivationPlanner -> DeterministicMetricExecutor -> EvidenceValidator -> ReportBindingLayer -> FormalPDFReleaseGate -> management_report.pdf。

AI 输出必须保存可追踪工件并通过 Schema 校验；AI 用于字段理解、业务路由和指标规划，不能编造或最终确定数值。
DeterministicMetricExecutor 执行所有数值计算，EvidenceValidator 校验输入、计算和报告绑定证据。
缺少 AI trace、Schema 校验、确定性执行或证据校验时，最多生成 debug_report，禁止发布正式 PDF。
最终质量分低于 90 时同样不能发布正式 management_report.pdf。渲染器不能在最后阶段重新理解字段或绕过链路。

8. Analysis Lab 方法实验台

/lab 用于探索、比较和复用方法；它不是绕过正式报告门禁的捷径。
数据准备与字段画像后，用户可以把字段配置为目标、分组、标签、时间、特征、重点对象，或气泡图/象限图的 X、Y、大小/对象字段。
派生指标要求填写中文名称、内部名称、定义和来源字段；指标计算仍由后端确定性执行，不能用自由文本虚构。
/api/lab/methods 提供方法目录，/api/lab/method-cards 提供方法卡，/api/lab/pdca 提供 PDCA 信息，/api/lab/run 执行实例。
运行模式包括自动、单方法、批量和报告试运行；结果可呈现方法解释、指标、图表、表格、文本、字段审计、清洗/派生过程、运行状态和可重跑的报告部件蓝图（如该方法提供）。
可查看结果包、索引、方法资产、阅读摘要和下载项。方法卡或目录中的能力必须以实际运行返回的状态为准。

9. 方法指南

/lab/method-guide 是静态操作说明页，不调用后端计算。
它帮助用户理解重点对象、字段角色、运行实例、建模输入字段和方法选择；用于降低配置错误，不替代统计假设检查和业务判断。

10. 报告库、修订会话、附件和批注

/revision 可按关键字、数据集、业务画像和排序条件筛选既有报告，并创建或恢复修订会话。
/revision/workspace?report_id=...&session_id=... 用于查看 HTML/PDF 预览、修订消息、事件流、差异、附件、批注和本地版本状态。
修订状态可展示原生 Codex 回合、执行尝试、范围、验证、禁止变更、错误、SSE 实时进度及轮询回退状态；高级续改依赖相应本机运行时。
支持 CSV、TSV、XLSX、XLS、Markdown、文本、PDF、JSON 等附件。PDF 可翻页、适宽/整页、缩放，并支持画笔、矩形、高亮和橡皮批注；批注坐标会保存在会话上下文。
工作区的 publish 表示本地报告版本发布，不等于 GitHub 发布或公网部署；预览、无活动回合和验证通过等条件应满足后才可发布。

11. 专项业务路线

项目包含电商经营、互联网运营、采购销售、通用深度经营、市场情报、媒体决策、管理会计和独立行业研究等后端路线。
它们只能在数据结构和业务问题匹配时由路由选择，不能因为仓库中存在某个服务就承诺所有用户或所有数据都会获得行业模板。

12. 可选运行时和扩展

基础本地数据工作不需要 API Key。需要 AI 辅助能力时，按 .env.example 建立本地 .env，填写自己的 OpenAI-compatible 提供方配置；浏览器不保存密钥。
R 工作流要求系统可找到 Rscript，不属于便携版默认保证能力。
Codex Runtime 默认关闭，只有可信本机管理员显式设置 ASTERIA_ENABLE_CODEX_RUNTIME_API=1 后才可使用；它不是公开互联网 API。
外部 Skill、feature trial 和本地报告 Agent Team 的安装/使用默认关闭，需要 ASTERIA_ENABLE_LOCAL_SKILL_INSTALLER=1，并应审查来源、代码、许可证、依赖、网络行为和数据访问范围。

13. 后端、接口和前端职责地图

backend/app/main.py 是本机 API 入口；数据服务负责导入、目录、工作表和画像，分析服务负责统计、方法目录、自动分析和可视化，ai_mandatory 服务负责强制链和 trace，report 服务负责任务、资产与发布门禁，runtime 服务负责受控扩展。
常用接口分组：/health、/api/manifest、/api/runtime-settings；/api/datasets、/api/datasets/upload、/api/historical-reports、/api/business-backgrounds；/api/statistics/catalog、/api/statistics/run、/api/analysis/auto；/api/lab/methods、/api/lab/method-cards、/api/lab/run；/api/reports 和修订会话相关接口。
前端页面包括首页、/analysis、/lab、/lab/method-guide、/revision 和 /revision/workspace；前端负责采集配置、显示进度和证据，后端负责本机数据与受控执行。

14. 隐私、安全和许可边界

不要提交 .env、API Key、令牌、客户数据、生成报告、会话、日志、缓存、私有作品集或未授权材料。
启用 AI 后，相关字段、报告上下文或工作簿/PDF 可能被发送给用户自行配置的提供方；处理敏感数据前先脱敏并遵守授权、合同和组织政策。
当前仓库没有 LICENSE。公开可见不等于已得到复制、修改、再分发或商用授权。

Releases: wzn1118/AsteriaAnalyst

Release list

Asteria Analyst v0.1.3

Uh oh!

Asteria Analyst v0.1.2

Uh oh!

Asteria Analyst v0.1.1 - 公开发布修复版

发布说明

本次修复

验证结果

Windows 快速使用

文件完整性

中文功能与模块全览

1. 启动、健康检查与本机边界

2. 数据接入、工作簿和上下文材料

3. 首页与智能报告任务设计

4. 数据画像、字段语义和业务路由

5. 受控统计、图表和证据

6. 智能报告、异步任务和资产管理

7. 正式管理报告的强制可信链

8. Analysis Lab 方法实验台

9. 方法指南

10. 报告库、修订会话、附件和批注

11. 专项业务路线

12. 可选运行时和扩展

13. 后端、接口和前端职责地图

14. 隐私、安全和许可边界

完整中文资料

Uh oh!

Asteria Analyst v0.1.0

Uh oh!