petrezhu/ARK
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
知识方舟跃迁 - 软考架构师游戏化学习引擎
83 commits 3 branches 0 tags 55 MiB
  • Python 59%
  • JavaScript 27.2%
  • CSS 12.3%
  • HTML 0.9%
  • Shell 0.6%
Find a file
Exact
petrezhu b93ada8c96 Merge pull request 'feat: 驾驶舱控制台交互完善 — Cockpit Console Refinements (#15)' (#16) from feat/cockpit-console-refinements into master 
Reviewed-on: #16
2026-09-03 16:21:07 +08:00
.codegraph fix: 流式概览文章opacity:0→1(缺失.in类导致不可见) 2026-09-02 01:02:36 +08:00
deploy feat(#13): 部署上线（Nginx+域名） 2026-09-01 18:39:13 +08:00
docs docs: spec+context文档更新（星图永驻/流式/动态倒计时/LLM/面板/航路/交互） 2026-09-02 01:31:40 +08:00
specs docs(spec): cockpit console refinements — 12 decisions from grill-me 2026-09-02 11:10:00 +08:00
src/ark docs: mock错题归档顺序注释澄清(逐题真实topic_id优先,兜底id仅缺省时用) 2026-09-02 02:47:45 +08:00
static refactor: 删除crew-mini小窗, 由底栏船员dock取代 2026-09-02 13:31:58 +08:00
tests refactor: 删除crew-mini小窗, 由底栏船员dock取代 2026-09-02 13:31:58 +08:00
.gitignore feat(#2): ARK脚手架与星图数据管道 2026-09-01 18:01:38 +08:00
index.html refactor: 删除crew-mini小窗, 由底栏船员dock取代 2026-09-02 13:31:58 +08:00
README.md feat(#2): ARK脚手架与星图数据管道 2026-09-01 18:01:38 +08:00

README.md

ARK 知识方舟跃迁（Ticket #2 脚手架）

包裹 senior-software-architect-review 的游戏化学习 Web 应用（软考系统架构设计师备考）。

运行

# 开发服务器（默认配置，DB 落在 data/ark_state.db）
PYTHONPATH=src python3 -m uvicorn ark.app:app --host 127.0.0.1 --port 8000
# 或工厂模式
PYTHONPATH=src python3 -m uvicorn ark.app:create_app --factory

# 测试（提交前必须全绿）
PYTHONPATH=src python3 -m pytest tests/ -q

环境变量

变量 默认值 说明
ARK_REPO_ROOT /root/git/senior-software-architect-review Golden KG 根目录（只读）
ARK_DB_PATH <repo>/data/ark_state.db SQLite 状态库
ARK_LLM_API_KEY （空=降级占位） NewAPI 代理 Key
ARK_LLM_BASE_URL http://127.0.0.1:3300/v1 LLM 端点
ARK_LLM_MODEL glm-5.3-flash 默认模型
ARK_LLM_TIMEOUT 120 请求超时秒数

本 ticket 建立的契约（后续 ticket 依赖）

  • create_app(db_path=None) 应用工厂：routers + /static + 首页
  • golden_kg：22 星域 × 3~7 矿点 = 148 个矿点；矿点 id {topic_id}#{seq}； 稀有矿脉 = frequency_count>=12 && cross_subject_value>=0.8（K03/K04/K06，共 19 个）
  • state：状态读写唯一入口（players/star_map/ship/borer_timers/fuel_log/meta）， fuel_log 物理层 append-only（DB 触发器禁止 UPDATE/DELETE）
  • llm.chat(model, messages, temperature=0.3) -> str：永不抛异常，失败返回占位
  • 前端：registerView(name, renderFn, navConfig) 视图注册表；各 ticket 只维护自己的 static/js/<ticket>.js + static/css/<ticket>.css

API

  • GET /api/star-map → {sectors[22], ores[148], rare_flags}
  • GET /api/sector/{id} → 星域详情 + 矿点 + 学习进度