Compare commits
2
Commits
master
..
43c3c80927
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
43c3c80927 | ||
|
|
b39252080c |
No files matched your search
@@ -1,185 +0,0 @@
|
||||
---
|
||||
name: openspec-apply-change
|
||||
description: Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.
|
||||
allowed-tools: Bash(openspec:*)
|
||||
license: MIT
|
||||
compatibility: Requires openspec CLI.
|
||||
metadata:
|
||||
author: openspec
|
||||
version: "1.0"
|
||||
generatedBy: "1.7.0"
|
||||
---
|
||||
|
||||
Implement tasks from an OpenSpec change.
|
||||
|
||||
**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store <id>` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root.
|
||||
|
||||
**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
||||
|
||||
**Steps**
|
||||
|
||||
1. **Select the change**
|
||||
|
||||
If a name is provided, use it. Otherwise:
|
||||
- Infer from conversation context if the user mentioned a change
|
||||
- Auto-select if only one active change exists
|
||||
- If ambiguous, run `openspec list --json` to get available changes and ask the user to select one
|
||||
|
||||
Always announce: "Using change: <name>" and how to override (e.g., `/openspec-apply-change <other>`).
|
||||
|
||||
2. **Check status to understand the schema**
|
||||
```bash
|
||||
openspec status --change "<name>" --json
|
||||
```
|
||||
Parse the JSON to understand:
|
||||
- `schemaName`: The workflow being used (e.g., "spec-driven")
|
||||
- `planningHome`, `changeRoot`, and `actionContext`: planning scope and edit constraints
|
||||
- Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others)
|
||||
|
||||
3. **Get apply instructions**
|
||||
|
||||
```bash
|
||||
openspec instructions apply --change "<name>" --json
|
||||
```
|
||||
|
||||
This returns:
|
||||
- `contextFiles`: artifact ID -> array of concrete file paths (varies by schema - could be proposal/specs/design/tasks or spec/tests/implementation/docs)
|
||||
- Progress (total, complete, remaining)
|
||||
- Task list with status
|
||||
- Dynamic instruction based on current state
|
||||
- Optional `context`: current required project instruction input from the selected root
|
||||
- Optional `operationGuidance`: current advisory guidance for apply
|
||||
|
||||
**Handle states:**
|
||||
- If `state: "blocked"` (missing artifacts): show message, suggest using openspec-continue-change (if it is not installed, run `openspec status --change "<name>" --json` to see the next artifact and `openspec instructions <artifact-id> --change "<name>" --json` for how to create it)
|
||||
- If `state: "all_done"`: congratulate, suggest archive
|
||||
- Otherwise: proceed to implementation
|
||||
|
||||
Treat `context` as a required prompt-level input. Read and consider it, and
|
||||
apply relevant project facts, conventions, and constraints while implementing.
|
||||
Treat `operationGuidance` as optional additive advice. Read and consider every
|
||||
entry, and follow entries that are applicable and compatible with the built-in
|
||||
workflow.
|
||||
|
||||
Keep both fields separate from CLI-returned state, missing artifacts, tasks,
|
||||
progress, `contextFiles`, and the built-in `instruction`. They are not
|
||||
evidence of task completion, do not replace the built-in instruction, and do
|
||||
not permit bypassing a blocked state. If context conflicts with the built-in
|
||||
instruction, an explicit user choice, or a CLI-controlled value, report the
|
||||
conflict and preserve the controlling value. If guidance is inapplicable or
|
||||
conflicts with those controlling inputs, do not follow it and explain why.
|
||||
These are prompt-level behavior contracts, not enforceable checks.
|
||||
|
||||
4. **Read context files**
|
||||
|
||||
Read every file path listed under `contextFiles` from the apply instructions output.
|
||||
The files depend on the schema being used:
|
||||
- **spec-driven**: proposal, specs, design, tasks
|
||||
- Other schemas: follow the contextFiles from CLI output
|
||||
|
||||
Do not copy `context` or `operationGuidance` verbatim into implementation
|
||||
files or planning artifacts unless the user separately asks for that content.
|
||||
|
||||
5. **Show current progress**
|
||||
|
||||
Display:
|
||||
- Schema being used
|
||||
- Progress: "N/M tasks complete"
|
||||
- Remaining tasks overview
|
||||
- Dynamic instruction from CLI
|
||||
|
||||
6. **Implement tasks (loop until done or blocked)**
|
||||
|
||||
For each pending task:
|
||||
- Show which task is being worked on
|
||||
- Make the code changes required
|
||||
- Keep changes minimal and focused
|
||||
- Mark task complete in the tasks file: `- [ ]` → `- [x]`
|
||||
- Continue to next task
|
||||
|
||||
**Pause if:**
|
||||
- Task is unclear → ask for clarification
|
||||
- Implementation reveals a design issue → suggest updating artifacts
|
||||
- Error or blocker encountered → report and wait for guidance
|
||||
- User interrupts
|
||||
|
||||
7. **On completion or pause, show status**
|
||||
|
||||
Display:
|
||||
- Tasks completed this session
|
||||
- Overall progress: "N/M tasks complete"
|
||||
- If all done: suggest archive
|
||||
- If paused: explain why and wait for guidance
|
||||
|
||||
**Output During Implementation**
|
||||
|
||||
```
|
||||
## Implementing: <change-name> (schema: <schema-name>)
|
||||
|
||||
Working on task 3/7: <task description>
|
||||
[...implementation happening...]
|
||||
✓ Task complete
|
||||
|
||||
Working on task 4/7: <task description>
|
||||
[...implementation happening...]
|
||||
✓ Task complete
|
||||
```
|
||||
|
||||
**Output On Completion**
|
||||
|
||||
```
|
||||
## Implementation Complete
|
||||
|
||||
**Change:** <change-name>
|
||||
**Schema:** <schema-name>
|
||||
**Progress:** 7/7 tasks complete ✓
|
||||
|
||||
### Completed This Session
|
||||
- [x] Task 1
|
||||
- [x] Task 2
|
||||
...
|
||||
|
||||
All tasks complete! Ready to archive this change.
|
||||
```
|
||||
|
||||
**Output On Pause (Issue Encountered)**
|
||||
|
||||
```
|
||||
## Implementation Paused
|
||||
|
||||
**Change:** <change-name>
|
||||
**Schema:** <schema-name>
|
||||
**Progress:** 4/7 tasks complete
|
||||
|
||||
### Issue Encountered
|
||||
<description of the issue>
|
||||
|
||||
**Options:**
|
||||
1. <option 1>
|
||||
2. <option 2>
|
||||
3. Other approach
|
||||
|
||||
What would you like to do?
|
||||
```
|
||||
|
||||
**Guardrails**
|
||||
- Keep going through tasks until done or blocked
|
||||
- Always read context files before starting (from the apply instructions output)
|
||||
- If task is ambiguous, pause and ask before implementing
|
||||
- If implementation reveals issues, pause and suggest artifact updates
|
||||
- Keep code changes minimal and scoped to each task
|
||||
- Update task checkbox immediately after completing each task
|
||||
- Pause on errors, blockers, or unclear requirements - don't guess
|
||||
- Use contextFiles from CLI output, don't assume specific file names
|
||||
- Do not use context or operation guidance as proof that a task is complete
|
||||
- Apply relevant project context; report conflicts with controlling workflow inputs
|
||||
- Consider every guidance entry; explain any inapplicable or conflicting advice
|
||||
- Do not copy runtime context or operation guidance into implementation files or planning artifacts
|
||||
- Preserve CLI-controlled blocked/ready/all-done behavior and completion criteria
|
||||
|
||||
**Fluid Workflow Integration**
|
||||
|
||||
This skill supports the "actions on a change" model:
|
||||
|
||||
- **Can be invoked anytime**: Before all artifacts are done (if tasks exist), after partial implementation, interleaved with other actions
|
||||
- **Allows artifact updates**: If implementation reveals design issues, suggest updating artifacts - not phase-locked, work fluidly
|
||||
@@ -1,180 +0,0 @@
|
||||
---
|
||||
name: openspec-archive-change
|
||||
description: Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.
|
||||
allowed-tools: Bash(openspec:*)
|
||||
license: MIT
|
||||
compatibility: Requires openspec CLI.
|
||||
metadata:
|
||||
author: openspec
|
||||
version: "1.0"
|
||||
generatedBy: "1.7.0"
|
||||
---
|
||||
|
||||
Archive a completed change in the experimental workflow.
|
||||
|
||||
**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store <id>` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root.
|
||||
|
||||
**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
||||
|
||||
**Steps**
|
||||
|
||||
1. **Select the change**
|
||||
|
||||
If a name is provided, use it. Otherwise:
|
||||
- Infer from conversation context if the user mentioned a change
|
||||
- Auto-select if only one active change exists
|
||||
- If ambiguous, run `openspec list --json` to get available changes and ask the user to select one
|
||||
|
||||
When prompting, show only active changes (not already archived).
|
||||
Include the schema used for each change if available.
|
||||
|
||||
Always announce: "Using change: <name>" and how to override (e.g., `/openspec-archive-change <other>`).
|
||||
|
||||
**Load current archive inputs before the existing archive checks:**
|
||||
|
||||
After resolving the selected change and planning root, run:
|
||||
```bash
|
||||
openspec instructions archive --change "<name>" --json
|
||||
```
|
||||
Keep the same selected-root flags on this command. This lookup is advisory and
|
||||
optional: it only supplies extra prompt inputs, so it must never block archiving.
|
||||
If it exits non-zero or returns invalid JSON — for example on an older CLI that
|
||||
does not support this command yet — continue the archive workflow with no
|
||||
context and no operation guidance. Do not report an error and do not stop.
|
||||
|
||||
A successful response may omit both optional fields. Treat `context` as a
|
||||
required prompt-level input: read and consider it, and apply relevant project
|
||||
facts, conventions, and constraints. Treat `operationGuidance` as optional
|
||||
additive advice: read and consider every entry, and follow entries that are
|
||||
applicable and compatible with the built-in archive workflow.
|
||||
|
||||
Keep both fields separate from built-in steps, explicit user choices, resolved
|
||||
paths, CLI checks, and command contracts. If context conflicts with one of those
|
||||
controlling inputs, report the conflict and preserve the controlling value. If
|
||||
guidance is inapplicable or conflicts with a controlling input, do not follow it
|
||||
and explain why. Do not infer replacement paths, skipped prompts, or flags from
|
||||
either field, and do not copy their text verbatim into specs, change artifacts,
|
||||
or archive summaries unless the user separately asks for it. These are
|
||||
prompt-level behavior contracts, not enforceable checks.
|
||||
|
||||
2. **Check artifact completion status**
|
||||
|
||||
Run `openspec status --change "<name>" --json` to check artifact completion.
|
||||
|
||||
Parse the JSON to understand:
|
||||
- `schemaName`: The workflow being used
|
||||
- `planningHome`, `changeRoot`, `artifactPaths`, and `actionContext`: path and scope context
|
||||
- `artifacts`: List of artifacts with their status (`done`, `skipped`, or other)
|
||||
|
||||
**If any artifacts are neither `done` nor `skipped`** (skipped artifacts satisfy the requirement - the change declares skip_specs):
|
||||
- Display warning listing incomplete artifacts
|
||||
- Ask the user to confirm they want to proceed
|
||||
- Proceed if user confirms
|
||||
|
||||
3. **Check task completion status**
|
||||
|
||||
Read the tasks file (typically `tasks.md`) to check for incomplete tasks.
|
||||
|
||||
Count tasks marked with `- [ ]` (incomplete) vs `- [x]` (complete).
|
||||
|
||||
**If incomplete tasks found:**
|
||||
- Display warning showing count of incomplete tasks
|
||||
- Ask the user to confirm they want to proceed
|
||||
- Proceed if user confirms
|
||||
|
||||
**If no tasks file exists:** Proceed without task-related warning.
|
||||
|
||||
4. **Assess delta spec sync state**
|
||||
|
||||
Use `artifactPaths.specs.existingOutputPaths` from status JSON as the only
|
||||
delta-spec source. If the `specs` entry is missing or
|
||||
`existingOutputPaths` is empty, proceed without a sync prompt and do not infer
|
||||
delta specs from other artifacts.
|
||||
|
||||
**If delta specs exist:**
|
||||
- Compare each delta spec with its corresponding main spec at `<planningHome.root>/openspec/specs/<capability>/spec.md` (use the store-aware `planningHome.root` from step 2, not a hardcoded repo path)
|
||||
- Determine what changes would be applied (adds, modifications, removals, renames)
|
||||
- Show a combined summary before prompting
|
||||
|
||||
**Prompt options:**
|
||||
- If changes needed: "Sync now (recommended)", "Archive without syncing"
|
||||
- If already synced: "Archive now", "Sync anyway", "Cancel"
|
||||
|
||||
Route on the answer:
|
||||
- "Cancel" — stop, do not archive
|
||||
- "Archive without syncing" or "Archive now" — proceed to archive
|
||||
- "Sync now" or "Sync anyway" — sync, then verify (below)
|
||||
- Anything else — ask again rather than archiving
|
||||
|
||||
Before a selected sync writes any main spec, run
|
||||
`openspec instructions specs --change "<name>" --json` once with the same
|
||||
selected-root flags. Require a zero exit status and valid artifact-instruction
|
||||
JSON. If the lookup fails or returns invalid JSON, report the error and stop
|
||||
before writing any main spec or moving the change. A valid response with omitted
|
||||
`rules` is the no-rules case. Apply returned `rules` only to the content and
|
||||
form of main specs produced by this merge; do not use them as archive guidance,
|
||||
change CLI behavior, or copy the rule text into any output file.
|
||||
|
||||
Then run the `openspec-sync-specs` workflow inline (agent-driven intelligent merge) for change '<name>', passing the delta spec analysis and the fetched specs-rule snapshot from above, and wait for it to finish. The inline sync must reuse that snapshot without fetching `specs` instructions again. Do not delegate it to a background task — step 5 would move `changeRoot` out from under a sync that is still reading it, leaving the change archived and the main specs never updated. If your agent can only run it by delegation, delegate synchronously and wait for the result.
|
||||
|
||||
Then re-run the comparison from the top of this step against every capability that has a delta spec in `artifactPaths.specs.existingOutputPaths` — not only the ones the sync reports it touched. A successful sync leaves nothing left to apply, so each capability must now read as already synced:
|
||||
- ADDED requirements present
|
||||
- MODIFIED requirements carrying the scenario and description changes named in the delta, with their other scenarios intact
|
||||
- REMOVED requirements gone
|
||||
- RENAMED requirements present under the new name and absent under the old one
|
||||
|
||||
If the sync failed, or any capability does not match, report what differs and stop — do not archive. Nothing has moved and `changeRoot` is intact, so the user can fix the mismatch or re-run the sync and start the archive again.
|
||||
|
||||
5. **Perform the archive**
|
||||
|
||||
Create an `archive` directory under `planningHome.changesDir` if it doesn't exist:
|
||||
```bash
|
||||
mkdir -p "<planningHome.changesDir>/archive"
|
||||
```
|
||||
|
||||
Generate the target name: use the change name as-is when it already starts with a `YYYY-MM-DD-` prefix; otherwise prepend the current date as `YYYY-MM-DD-<change-name>`. Never stack a second date (same rule as `openspec archive`).
|
||||
|
||||
**Check if target already exists:**
|
||||
- If yes: Fail with error, suggest renaming existing archive or using different date
|
||||
- If no: Move `changeRoot` to the archive directory
|
||||
|
||||
```bash
|
||||
mv "<changeRoot>" "<planningHome.changesDir>/archive/<target-name>"
|
||||
```
|
||||
|
||||
6. **Display summary**
|
||||
|
||||
Show archive completion summary including:
|
||||
- Change name
|
||||
- Schema that was used
|
||||
- Archive location
|
||||
- Whether specs were synced (if applicable)
|
||||
- Note about any warnings (incomplete artifacts/tasks)
|
||||
|
||||
**Output On Success**
|
||||
|
||||
```markdown
|
||||
## Archive Complete
|
||||
|
||||
**Change:** <change-name>
|
||||
**Schema:** <schema-name>
|
||||
**Archived to:** the archive path derived from `planningHome.changesDir`/<target-name>/
|
||||
**Specs:** <"✓ Synced to main specs" only if the step 4 verification passed; otherwise "No delta specs" or "Sync skipped">
|
||||
|
||||
<"All artifacts complete. All tasks complete." — or, if archived with warnings, list them instead (e.g. "Archived with 2 incomplete tasks")>
|
||||
```
|
||||
|
||||
**Guardrails**
|
||||
- Announce the selected change; prompt for selection when it is ambiguous
|
||||
- Use artifact graph (openspec status --json) for completion checking
|
||||
- Don't block archive on warnings - just inform and confirm
|
||||
- Preserve .openspec.yaml when moving to archive (it moves with the directory)
|
||||
- Show clear summary of what happened
|
||||
- If sync is requested, run the `openspec-sync-specs` workflow inline (agent-driven)
|
||||
- Never archive while a spec sync is still in flight — run the sync inline and verify the main specs before moving `changeRoot`
|
||||
- If delta specs exist, always run the sync assessment and show the combined summary before prompting
|
||||
- Apply relevant runtime context and report conflicts; operation guidance remains advisory
|
||||
- Consider every guidance entry and explain any inapplicable or conflicting advice
|
||||
- Existing CLI checks, resolved paths, prompts, and command contracts are unchanged
|
||||
- Artifact rules constrain only the specs being written and are never operation guidance
|
||||
- Never copy runtime context, operation guidance, or artifact-rule text verbatim into output files
|
||||
@@ -1,296 +0,0 @@
|
||||
---
|
||||
name: openspec-explore
|
||||
description: Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.
|
||||
allowed-tools: Bash(openspec:*)
|
||||
license: MIT
|
||||
compatibility: Requires openspec CLI.
|
||||
metadata:
|
||||
author: openspec
|
||||
version: "1.0"
|
||||
generatedBy: "1.7.0"
|
||||
---
|
||||
|
||||
Enter explore mode. Think deeply. Visualize freely. Follow the conversation wherever it goes.
|
||||
|
||||
**IMPORTANT: Explore mode is for thinking, not implementing.** You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first and create a change proposal. You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.
|
||||
|
||||
**This is a stance, not a workflow.** There are no fixed steps, no required sequence, no mandatory outputs. You're a thinking partner helping the user explore.
|
||||
|
||||
**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store <id>` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root.
|
||||
|
||||
---
|
||||
|
||||
## The Stance
|
||||
|
||||
- **Curious, not prescriptive** - Ask questions that emerge naturally, don't follow a script
|
||||
- **Open threads, not interrogations** - Surface multiple interesting directions and let the user follow what resonates. Don't funnel them through a single path of questions.
|
||||
- **Visual** - Use ASCII diagrams liberally when they'd help clarify thinking
|
||||
- **Adaptive** - Follow interesting threads, pivot when new information emerges
|
||||
- **Patient** - Don't rush to conclusions, let the shape of the problem emerge
|
||||
- **Grounded** - Explore the actual codebase when relevant, don't just theorize
|
||||
|
||||
---
|
||||
|
||||
## What You Might Do
|
||||
|
||||
Depending on what the user brings, you might:
|
||||
|
||||
**Explore the problem space**
|
||||
- Ask clarifying questions that emerge from what they said
|
||||
- Challenge assumptions
|
||||
- Reframe the problem
|
||||
- Find analogies
|
||||
|
||||
**Investigate the codebase**
|
||||
- Map existing architecture relevant to the discussion
|
||||
- Find integration points
|
||||
- Identify patterns already in use
|
||||
- Surface hidden complexity
|
||||
|
||||
**Compare options**
|
||||
- Brainstorm multiple approaches
|
||||
- Build comparison tables
|
||||
- Sketch tradeoffs
|
||||
- Recommend a path (if asked)
|
||||
|
||||
**Visualize**
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Use ASCII diagrams liberally │
|
||||
├─────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌────────┐ ┌────────┐ │
|
||||
│ │ State │────────▶│ State │ │
|
||||
│ │ A │ │ B │ │
|
||||
│ └────────┘ └────────┘ │
|
||||
│ │
|
||||
│ System diagrams, state machines, │
|
||||
│ data flows, architecture sketches, │
|
||||
│ dependency graphs, comparison tables │
|
||||
│ │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Surface risks and unknowns**
|
||||
- Identify what could go wrong
|
||||
- Find gaps in understanding
|
||||
- Suggest spikes or investigations
|
||||
|
||||
---
|
||||
|
||||
## OpenSpec Awareness
|
||||
|
||||
You have full context of the OpenSpec system. Use it naturally, don't force it.
|
||||
|
||||
### Check for context
|
||||
|
||||
At the start, quickly check what exists:
|
||||
```bash
|
||||
openspec list --json
|
||||
```
|
||||
|
||||
This tells you:
|
||||
- If there are active changes
|
||||
- Their names, schemas, and status
|
||||
- What the user might be working on
|
||||
|
||||
Then read the project's own context from the resolved root - `<root.path>/openspec/config.yaml` (or `config.yml`). Use the `root.path` returned above, and skip this if neither file exists:
|
||||
- `context`: project background - tech stack, conventions, constraints
|
||||
- `rules`: keyed by artifact id - the entries for an artifact apply only when you write that artifact
|
||||
|
||||
Ground your thinking in these. They are constraints for you to follow, not content to reproduce: do NOT copy them into the conversation or into any artifact you create.
|
||||
|
||||
### When no change exists
|
||||
|
||||
Think freely. When insights crystallize, you might offer:
|
||||
|
||||
- "This feels solid enough to start a change. Want me to create a proposal?"
|
||||
- Or keep exploring - no pressure to formalize
|
||||
|
||||
### When a change exists
|
||||
|
||||
If the user mentions a change or you detect one is relevant:
|
||||
|
||||
1. **Resolve and read existing artifacts for context**
|
||||
- Run `openspec status --change "<name>" --json`.
|
||||
- Use `changeRoot`, `artifactPaths`, and `actionContext` from the status JSON.
|
||||
- Read existing files from `artifactPaths.<artifact>.existingOutputPaths`.
|
||||
|
||||
2. **Reference them naturally in conversation**
|
||||
- "Your design mentions using Redis, but we just realized SQLite fits better..."
|
||||
- "The proposal scopes this to premium users, but we're now thinking everyone..."
|
||||
|
||||
3. **Offer to capture when decisions are made**
|
||||
|
||||
| Insight Type | Where to Capture |
|
||||
|----------------------------|--------------------------------|
|
||||
| New requirement discovered | `specs/<capability>/spec.md` |
|
||||
| Requirement changed | `specs/<capability>/spec.md` |
|
||||
| Design decision made | `design.md` |
|
||||
| Scope changed | `proposal.md` |
|
||||
| New work identified | `tasks.md` |
|
||||
| Assumption invalidated | Relevant artifact |
|
||||
|
||||
Example offers:
|
||||
- "That's a design decision. Capture it in design.md?"
|
||||
- "This is a new requirement. Add it to specs?"
|
||||
- "This changes scope. Update the proposal?"
|
||||
|
||||
4. **The user decides** - Offer and move on. Don't pressure. Don't auto-capture.
|
||||
|
||||
---
|
||||
|
||||
## What You Don't Have To Do
|
||||
|
||||
- Follow a script
|
||||
- Ask the same questions every time
|
||||
- Produce a specific artifact
|
||||
- Reach a conclusion
|
||||
- Stay on topic if a tangent is valuable
|
||||
- Be brief (this is thinking time)
|
||||
|
||||
---
|
||||
|
||||
## Handling Different Entry Points
|
||||
|
||||
**User brings a vague idea:**
|
||||
```
|
||||
User: I'm thinking about adding real-time collaboration
|
||||
|
||||
You: Real-time collab is a big space. Let me think about this...
|
||||
|
||||
COLLABORATION SPECTRUM
|
||||
════════════════════════════════════════════
|
||||
|
||||
Awareness Coordination Sync
|
||||
│ │ │
|
||||
▼ ▼ ▼
|
||||
┌────────┐ ┌────────┐ ┌────────┐
|
||||
│Presence│ │Cursors │ │ CRDT │
|
||||
│ "3 │ │ Multi │ │Conflict│
|
||||
│online" │ │ select │ │ free │
|
||||
└────────┘ └────────┘ └────────┘
|
||||
│ │ │
|
||||
trivial moderate complex
|
||||
|
||||
Where's your head at?
|
||||
```
|
||||
|
||||
**User brings a specific problem:**
|
||||
```
|
||||
User: The auth system is a mess
|
||||
|
||||
You: [reads codebase]
|
||||
|
||||
┌─────────────────────────────────────────────┐
|
||||
│ CURRENT AUTH FLOW │
|
||||
└─────────────────────────────────────────────┘
|
||||
│
|
||||
┌─────────────┼─────────────┐
|
||||
▼ ▼ ▼
|
||||
┌─────────┐ ┌─────────┐ ┌─────────┐
|
||||
│ Google │ │ GitHub │ │ Email │
|
||||
│ OAuth │ │ OAuth │ │ Magic │
|
||||
└────┬────┘ └────┬────┘ └────┬────┘
|
||||
│ │ │
|
||||
└─────────────┼─────────────┘
|
||||
▼
|
||||
┌───────────┐
|
||||
│ Session │
|
||||
└─────┬─────┘
|
||||
│
|
||||
▼
|
||||
┌───────────┐
|
||||
│ Perms │
|
||||
└───────────┘
|
||||
|
||||
I see three tangles. Which one's burning?
|
||||
```
|
||||
|
||||
**User is stuck mid-implementation:**
|
||||
```
|
||||
User: /openspec-explore add-auth-system
|
||||
The OAuth integration is more complex than expected
|
||||
|
||||
You: [reads change artifacts]
|
||||
|
||||
You're on task 4: "Implement OAuth flow"
|
||||
|
||||
Let me trace what's involved...
|
||||
|
||||
[draws diagram, explores options, suggests paths]
|
||||
|
||||
Want to update the design to reflect this?
|
||||
Or add a spike task to investigate?
|
||||
```
|
||||
|
||||
**User wants to compare options:**
|
||||
```
|
||||
User: Should we use Postgres or SQLite?
|
||||
|
||||
You: Generic answer is boring. What's the context?
|
||||
|
||||
User: A CLI tool that tracks local dev environments
|
||||
|
||||
You: That changes everything.
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ CLI TOOL DATA STORAGE │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
Key constraints:
|
||||
• No daemon running
|
||||
• Must work offline
|
||||
• Single user
|
||||
|
||||
SQLite Postgres
|
||||
Deployment embedded ✓ needs server ✗
|
||||
Offline yes ✓ no ✗
|
||||
Single file yes ✓ no ✗
|
||||
|
||||
SQLite. Not even close.
|
||||
|
||||
Unless... is there a sync component?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Ending Discovery
|
||||
|
||||
There's no required ending. Discovery might:
|
||||
|
||||
- **Flow into a proposal**: "Ready to start? I can create a change proposal."
|
||||
- **Result in artifact updates**: "Updated design.md with these decisions"
|
||||
- **Just provide clarity**: User has what they need, moves on
|
||||
- **Continue later**: "We can pick this up anytime"
|
||||
|
||||
When it feels like things are crystallizing, you might summarize:
|
||||
|
||||
```
|
||||
## What We Figured Out
|
||||
|
||||
**The problem**: [crystallized understanding]
|
||||
|
||||
**The approach**: [if one emerged]
|
||||
|
||||
**Open questions**: [if any remain]
|
||||
|
||||
**Next steps** (if ready):
|
||||
- Create a change proposal
|
||||
- Keep exploring: just keep talking
|
||||
```
|
||||
|
||||
But this summary is optional. Sometimes the thinking IS the value.
|
||||
|
||||
---
|
||||
|
||||
## Guardrails
|
||||
|
||||
- **Don't implement** - Never write code or implement features. Creating OpenSpec artifacts is fine, writing application code is not.
|
||||
- **Don't fake understanding** - If something is unclear, dig deeper
|
||||
- **Don't rush** - Discovery is thinking time, not task time
|
||||
- **Don't force structure** - Let patterns emerge naturally
|
||||
- **Don't auto-capture** - Offer to save insights, don't just do it
|
||||
- **Do visualize** - A good diagram is worth many paragraphs
|
||||
- **Do explore the codebase** - Ground discussions in reality
|
||||
- **Do question assumptions** - Including the user's and your own
|
||||
@@ -1,123 +0,0 @@
|
||||
---
|
||||
name: openspec-propose
|
||||
description: Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.
|
||||
allowed-tools: Bash(openspec:*)
|
||||
license: MIT
|
||||
compatibility: Requires openspec CLI.
|
||||
metadata:
|
||||
author: openspec
|
||||
version: "1.0"
|
||||
generatedBy: "1.7.0"
|
||||
---
|
||||
|
||||
Propose a new change - create the change and generate all artifacts in one step.
|
||||
|
||||
I'll create a change with the artifacts your schema defines. With the default spec-driven schema that is:
|
||||
- proposal.md (what & why)
|
||||
- `specs/<capability>/spec.md` (what the system must do - a delta, not the main spec)
|
||||
- design.md (how)
|
||||
- tasks.md (implementation steps)
|
||||
|
||||
When ready to implement, run /openspec-apply-change
|
||||
|
||||
---
|
||||
|
||||
**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store <id>` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root.
|
||||
|
||||
**Input**: The user's request should include a change name (kebab-case) OR a description of what they want to build.
|
||||
|
||||
**Steps**
|
||||
|
||||
1. **If no clear input provided, ask what they want to build**
|
||||
|
||||
Ask the user (open-ended, no preset options):
|
||||
> "What change do you want to work on? Describe what you want to build or fix."
|
||||
|
||||
From their description, derive a kebab-case name (e.g., "add user authentication" → `add-user-auth`).
|
||||
|
||||
**IMPORTANT**: Do NOT proceed without understanding what the user wants to build.
|
||||
|
||||
2. **Create the change directory**
|
||||
```bash
|
||||
openspec new change "<name>"
|
||||
```
|
||||
This creates a scaffolded change in the planning home resolved by the CLI with `.openspec.yaml`.
|
||||
|
||||
3. **Get the artifact build order**
|
||||
```bash
|
||||
openspec status --change "<name>" --json
|
||||
```
|
||||
Parse the JSON to get:
|
||||
- `applyRequires`: array of artifact IDs needed before implementation (e.g., `["tasks"]`)
|
||||
- `artifacts`: list of all artifacts, each with its `status` and its `requires` edges (the artifact IDs it directly depends on)
|
||||
- `planningHome`, `changeRoot`, `artifactPaths`, and `actionContext`: path and scope context. Use these instead of assuming repo-local paths.
|
||||
|
||||
4. **Create every artifact in the required set**
|
||||
|
||||
Use a todo list to track progress through the artifacts.
|
||||
|
||||
Loop through artifacts in dependency order (artifacts with no pending dependencies first):
|
||||
|
||||
a. **For each artifact that is `ready` (dependencies satisfied)**:
|
||||
- Get instructions:
|
||||
```bash
|
||||
openspec instructions <artifact-id> --change "<name>" --json
|
||||
```
|
||||
- The instructions JSON includes:
|
||||
- `context`: Project background (constraints for you - do NOT include in output)
|
||||
- `rules`: Artifact-specific rules (constraints for you - do NOT include in output)
|
||||
- `template`: The structure to use for your output file
|
||||
- `instruction`: Schema-specific guidance for this artifact type
|
||||
- `skipped`/`warning`: present when the change declares skip_specs and this artifact must NOT be created - stop and pick another artifact
|
||||
- `resolvedOutputPath`: Resolved path or pattern to write the artifact
|
||||
- `dependencies`: Completed artifacts to read for context
|
||||
- Read any completed dependency files for context - always re-read them from disk, even if you saw them earlier in the conversation (the user may have edited them)
|
||||
- If the `instruction` field delegates creation to a specific skill or command, invoke it to produce the artifact instead of writing the file yourself, then verify the artifact file exists at `resolvedOutputPath`
|
||||
- Otherwise create the artifact file using `template` as the structure and write it to `resolvedOutputPath`. If `resolvedOutputPath` is a glob, follow `instruction` to choose the concrete file path
|
||||
- Apply `context` and `rules` as constraints - but do NOT copy them into the file
|
||||
- Show brief progress: "Created <artifact-id>"
|
||||
|
||||
b. **Continue until every artifact in the required set exists (not just `apply.requires`)**
|
||||
- After creating each artifact, re-run `openspec status --change "<name>" --json`
|
||||
- The required set is `applyRequires` plus every artifact reachable from those by following the `requires` edges in `status --json` - walk them transitively (spec-driven closes over proposal, specs, design, tasks). Leave artifacts outside that set alone
|
||||
- `status` is file-existence only, so an `applyRequires` artifact reading `done` does NOT mean its dependencies exist - writing `tasks.md` early marks `tasks` done while `specs` was never written. Use each artifact's `requires` edges, not its `status`, to build the required set: a `done` artifact still lists what it depends on
|
||||
- An artifact already reading `status: "skipped"` is satisfied: the change declares `skip_specs` in `.openspec.yaml`, so its files must NOT exist. Never try to create one
|
||||
- Create every artifact in the required set that is missing, then re-check - creating one can unblock others
|
||||
- Skip one only when `status` already reports it `skipped`, or when its own `instruction` says it is conditional: run `openspec instructions <artifact-id> --change "<name>" --json` and skip only if its `instruction` field marks it optional (e.g. "create only if..."). Spec-driven's `design.md` qualifies; `specs` qualifies only via the `skipped` status above, never by your own judgment. Tell the user, and do not reconsider it
|
||||
- Dependencies are enablers, not gates: if a required artifact is still `blocked` only because you skipped a conditional dependency, write it anyway
|
||||
- Stop when every artifact in the required set is `done`, `skipped`, or was deliberately skipped
|
||||
|
||||
c. **If an artifact requires user input** (unclear context):
|
||||
- Ask the user to clarify
|
||||
- Then continue with creation
|
||||
|
||||
5. **Show final status**
|
||||
```bash
|
||||
openspec status --change "<name>"
|
||||
```
|
||||
|
||||
**Output**
|
||||
|
||||
After completing all artifacts, summarize:
|
||||
- Change name and location
|
||||
- List of artifacts created with brief descriptions, plus any conditional artifact you skipped and why
|
||||
- What's ready: "All artifacts needed for implementation are ready."
|
||||
- Prompt: "Run `/openspec-apply-change` or ask me to implement to start working on the tasks."
|
||||
|
||||
**Artifact Creation Guidelines**
|
||||
|
||||
- Follow the `instruction` field from `openspec instructions` for each artifact type - it is the authoritative guidance, even for familiar artifact names
|
||||
- If the `instruction` field directs you to use a specific skill or command to create the artifact, invoke it instead of writing the artifact directly
|
||||
- The schema defines what each artifact should contain - follow it
|
||||
- Read dependency artifacts for context before creating new ones
|
||||
- Use `template` as the structure for your output file - fill in its sections
|
||||
- **IMPORTANT**: `context` and `rules` are constraints for YOU, not content for the file
|
||||
- Do NOT copy `<context>`, `<rules>`, `<project_context>` blocks into the artifact
|
||||
- These guide what you write, but should never appear in the output
|
||||
|
||||
**Guardrails**
|
||||
- Create every artifact the apply phase transitively depends on, not just the ids listed in `apply.requires`
|
||||
- Always read dependency artifacts before creating a new one - re-read from disk, not from conversation memory (files may have changed since you last saw them)
|
||||
- If context is critically unclear, ask the user - but prefer making reasonable decisions to keep momentum
|
||||
- If a change with that name already exists, ask if user wants to continue it or create a new one
|
||||
- Verify each artifact file exists after writing before proceeding to next
|
||||
@@ -1,223 +0,0 @@
|
||||
---
|
||||
name: openspec-sync-specs
|
||||
description: Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.
|
||||
allowed-tools: Bash(openspec:*)
|
||||
license: MIT
|
||||
compatibility: Requires openspec CLI.
|
||||
metadata:
|
||||
author: openspec
|
||||
version: "1.0"
|
||||
generatedBy: "1.7.0"
|
||||
---
|
||||
|
||||
Sync delta specs from a change to main specs.
|
||||
|
||||
This is an **agent-driven** operation - you will read delta specs and directly edit main specs to apply the changes. This allows intelligent merging (e.g., adding a scenario without copying the entire requirement).
|
||||
|
||||
**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store <id>` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root.
|
||||
|
||||
**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
||||
|
||||
**Steps**
|
||||
|
||||
1. **Select the change**
|
||||
|
||||
If a name is provided, use it. Otherwise:
|
||||
- Infer from conversation context if the user mentioned a change
|
||||
- Auto-select if only one active change exists
|
||||
- If ambiguous, run `openspec list --json` to get available changes and ask the user to select one
|
||||
|
||||
When prompting, show changes that have delta specs (under `specs/` directory).
|
||||
|
||||
Always announce: "Using change: <name>" and how to override (e.g., `/openspec-sync-specs <other>`).
|
||||
|
||||
2. **Resolve change context**
|
||||
|
||||
Run:
|
||||
```bash
|
||||
openspec status --change "<name>" --json
|
||||
```
|
||||
|
||||
The JSON includes `planningHome.root`. Main specs live under `<planningHome.root>/openspec/specs/` — use that (store-aware) root for every main-spec path below, not a hardcoded repo path. When a store is selected it points at the store, not the current repository.
|
||||
|
||||
3. **Find delta specs**
|
||||
|
||||
Use `artifactPaths.specs.existingOutputPaths` from the status JSON as the
|
||||
only source of delta spec paths. If the `specs` entry is missing or
|
||||
`existingOutputPaths` is empty, report that there are no delta specs to sync,
|
||||
do not infer them from other artifacts, and stop without requesting artifact
|
||||
instructions or writing a main spec.
|
||||
|
||||
Sync every path in `existingOutputPaths` unless the caller narrowed the set.
|
||||
A caller narrows it by naming an explicit list of delta spec paths to sync —
|
||||
archive does this inline, and a user can too ("only sync the billing delta").
|
||||
Then sync only the named paths and leave the remaining delta specs untouched:
|
||||
bulk archive excludes a delta whose implementation it could not find, and
|
||||
syncing it anyway would write a main spec the caller deliberately withheld.
|
||||
Carry that narrowed selection through step 4; never widen it back to the full
|
||||
list. If a named path is not in `existingOutputPaths`, do not sync it —
|
||||
report it and stop, rather than dropping it silently. If the named list is
|
||||
empty, report that there is nothing to sync and stop without writing a main
|
||||
spec.
|
||||
|
||||
Each delta spec file contains sections like:
|
||||
- `## ADDED Requirements` - New requirements to add
|
||||
- `## MODIFIED Requirements` - Changes to existing requirements
|
||||
- `## REMOVED Requirements` - Requirements to remove
|
||||
- `## RENAMED Requirements` - Requirements to rename (FROM:/TO: format)
|
||||
|
||||
If no delta specs found, inform user and stop.
|
||||
|
||||
4. **For each delta spec, apply changes to main specs**
|
||||
|
||||
Before the first main-spec write, obtain one current specs-rule snapshot:
|
||||
- If archive invoked this workflow inline and supplied a valid snapshot from
|
||||
`openspec instructions specs --change "<name>" --json`, reuse it and do not
|
||||
fetch the same instructions again.
|
||||
- Otherwise run that command once now with the same selected-root flags.
|
||||
- If the direct lookup exits non-zero or returns invalid artifact-instruction
|
||||
JSON, report the error and stop before writing any main spec. Do not treat the
|
||||
failure as an absent rule set.
|
||||
- A valid response with omitted `rules` means no artifact rules are configured
|
||||
and the existing semantic merge continues.
|
||||
|
||||
Apply returned `rules` only to the content and form of the main specs produced
|
||||
by this merge. Artifact rules are not operation guidance and cannot change
|
||||
selected roots, delta paths, CLI checks, or workflow steps. Use their text as
|
||||
constraints without copying it verbatim into a main spec or summary.
|
||||
|
||||
For each capability delta spec path selected in step 3 — the full `existingOutputPaths` list, or the narrowed subset when a caller supplied one (these may belong to a selected store, not the repo):
|
||||
|
||||
a. **Read the delta spec** to understand the intended changes
|
||||
|
||||
b. **Read the main spec** at `<planningHome.root>/openspec/specs/<capability>/spec.md` (may not exist yet)
|
||||
|
||||
c. **Apply changes intelligently**:
|
||||
|
||||
**ADDED Requirements:**
|
||||
- If requirement doesn't exist in main spec → add it
|
||||
- If requirement already exists → update it to match (treat as implicit MODIFIED)
|
||||
|
||||
**MODIFIED Requirements:**
|
||||
- Find the requirement in main spec
|
||||
- Apply the changes - this can be:
|
||||
- Adding new scenarios (don't need to copy existing ones)
|
||||
- Modifying existing scenarios
|
||||
- Changing the requirement description
|
||||
- Preserve scenarios/content not mentioned in the delta
|
||||
|
||||
**REMOVED Requirements:**
|
||||
- Remove the entire requirement block from main spec
|
||||
|
||||
**RENAMED Requirements:**
|
||||
- Find the FROM requirement, rename to TO
|
||||
|
||||
**`## Purpose` in the delta:**
|
||||
- The main spec already has one and it is authoritative - leave it alone
|
||||
(this is what `openspec archive` does; it warns and moves on)
|
||||
|
||||
d. **Create new main spec** if capability doesn't exist yet:
|
||||
- Create `<planningHome.root>/openspec/specs/<capability>/spec.md`
|
||||
- Add Purpose section: copy the delta's `## Purpose` body verbatim when it has one
|
||||
(this is what `openspec archive` does); only write a brief TBD placeholder when it does not
|
||||
- Add Requirements section with the ADDED requirements
|
||||
- Follow the **Main Spec Format Reference** below
|
||||
|
||||
5. **Show summary**
|
||||
|
||||
After applying all changes, summarize:
|
||||
- Which capabilities were updated
|
||||
- What changes were made (requirements added/modified/removed/renamed)
|
||||
- Any new main spec left with a TBD Purpose placeholder, so it gets written
|
||||
now rather than lingering
|
||||
|
||||
**Delta Spec Format Reference**
|
||||
|
||||
```markdown
|
||||
## Purpose
|
||||
|
||||
Only on a delta that introduces a brand-new capability. Seeds the new main spec.
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: New Feature
|
||||
The system SHALL do something new.
|
||||
|
||||
#### Scenario: Basic case
|
||||
- **WHEN** user does X
|
||||
- **THEN** system does Y
|
||||
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: Existing Feature
|
||||
#### Scenario: New scenario to add
|
||||
- **WHEN** user does A
|
||||
- **THEN** system does B
|
||||
|
||||
## REMOVED Requirements
|
||||
|
||||
### Requirement: Deprecated Feature
|
||||
|
||||
## RENAMED Requirements
|
||||
|
||||
- FROM: `### Requirement: Old Name`
|
||||
- TO: `### Requirement: New Name`
|
||||
```
|
||||
|
||||
**Main Spec Format Reference**
|
||||
|
||||
Main specs are what the delta merges INTO. They must never contain delta operation headers (`## ADDED/MODIFIED/REMOVED/RENAMED Requirements`) - after syncing, every requirement lives under a single `## Requirements` section:
|
||||
|
||||
```markdown
|
||||
# <capability> Specification
|
||||
|
||||
## Purpose
|
||||
Short description of what this capability does and why it exists.
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: New Feature
|
||||
The system SHALL do something new.
|
||||
|
||||
#### Scenario: Basic case
|
||||
- **WHEN** user does X
|
||||
- **THEN** system does Y
|
||||
```
|
||||
|
||||
**Key Principle: Intelligent Merging**
|
||||
|
||||
Unlike programmatic merging, you can apply **partial updates**:
|
||||
- To add a scenario, just include that scenario under MODIFIED - don't copy existing scenarios
|
||||
- The delta represents *intent*, not a wholesale replacement
|
||||
- Use your judgment to merge changes sensibly
|
||||
|
||||
**Output On Success**
|
||||
|
||||
```markdown
|
||||
## Specs Synced: <change-name>
|
||||
|
||||
Updated main specs:
|
||||
|
||||
**<capability-1>**:
|
||||
- Added requirement: "New Feature"
|
||||
- Modified requirement: "Existing Feature" (added 1 scenario)
|
||||
|
||||
**<capability-2>**:
|
||||
- Created new spec file
|
||||
- Added requirement: "Another Feature"
|
||||
|
||||
Main specs are now updated. The change remains active - archive when implementation is complete.
|
||||
```
|
||||
|
||||
**Guardrails**
|
||||
- Read both delta and main specs before making changes
|
||||
- Preserve existing content not mentioned in delta
|
||||
- Never copy a delta file into a main spec as-is - merge its content so the main spec keeps the Main Spec Format Reference structure, with no delta operation headers
|
||||
- If something is unclear, ask for clarification
|
||||
- Show what you're changing as you go
|
||||
- The operation should be idempotent - running twice should give same result
|
||||
- Use only `artifactPaths.specs.existingOutputPaths`; never infer delta specs from unrelated artifacts
|
||||
- Honor a caller-supplied subset of `existingOutputPaths`; never widen it back to the full list
|
||||
- Fetch specs instructions once for direct sync, or reuse the archive-supplied snapshot inline
|
||||
- Stop before every main-spec write on a non-zero or invalid JSON specs-instruction response
|
||||
- Artifact rules constrain only the specs being written and are never copied into output files
|
||||
@@ -1,90 +0,0 @@
|
||||
---
|
||||
name: openspec-update-change
|
||||
description: Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use when the user wants to revise a change's plan, fold new decisions into it, or reconcile its artifacts after an edit. Never edits code.
|
||||
allowed-tools: Bash(openspec:*)
|
||||
license: MIT
|
||||
compatibility: Requires openspec CLI.
|
||||
metadata:
|
||||
author: openspec
|
||||
version: "1.0"
|
||||
generatedBy: "1.7.0"
|
||||
---
|
||||
|
||||
Revise a change's existing planning artifacts and keep them coherent. Never edit code.
|
||||
|
||||
**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store <id>` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root.
|
||||
|
||||
**Input**: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
|
||||
|
||||
**Steps**
|
||||
|
||||
1. **Select the change**
|
||||
|
||||
If a name is provided, use it. Otherwise:
|
||||
- Infer from conversation context if the user mentioned a change
|
||||
- Auto-select if only one active change exists
|
||||
- If ambiguous, run `openspec list --json` to get available changes sorted by most recently modified, and ask the user to select one
|
||||
|
||||
When prompting, present the top 3-4 most recently modified changes as options, showing:
|
||||
- Change name
|
||||
- Schema (from `schema` field if present, otherwise "spec-driven")
|
||||
- Status (e.g., "0/5 tasks", "complete", "no tasks")
|
||||
- How recently it was modified (from `lastModified` field)
|
||||
|
||||
Mark the most recently modified change as "(Recommended)" since it's likely what the user wants to update.
|
||||
|
||||
Always announce: "Using change: <name>" and how to override (e.g., `/openspec-update-change <other>`).
|
||||
|
||||
2. **Get the change's artifacts**
|
||||
```bash
|
||||
openspec status --change "<name>" --json
|
||||
```
|
||||
Parse the JSON to understand current state. The response includes:
|
||||
- `schemaName`: The workflow schema being used (e.g., "spec-driven")
|
||||
- `artifacts`: Array of artifacts with their status ("done", "skipped", "ready", "blocked")
|
||||
- `isComplete`: Boolean indicating if all artifacts are complete
|
||||
- `planningHome`, `changeRoot`, `artifactPaths`, and `actionContext`: path and scope context. Use these instead of assuming repo-local paths.
|
||||
|
||||
The artifact ids and paths come from the active schema - do NOT assume them, and do NOT branch on hardcoded artifact names. Custom schemas must work unchanged.
|
||||
|
||||
The files to edit are `artifactPaths.<id>.existingOutputPaths` - the concrete files that exist on disk, already glob-expanded for glob artifacts (e.g. `specs/**/*.md`). Do NOT write to `resolvedOutputPath`: for a glob artifact it is still the glob pattern, not a real file.
|
||||
|
||||
3. **Understand the request**
|
||||
- If the user asked for a specific revision ("the design now uses X"), that is the starting edit.
|
||||
- If they only said "update" / "make this coherent", treat it as a coherence review: read the existing artifacts and check them against each other for contradictions, gaps, and duplication.
|
||||
|
||||
4. **Read and reconcile**
|
||||
- Read the artifact(s) the request touches and the change's other existing artifacts.
|
||||
- Apply the requested edit. Then check every other existing artifact against it - in ANY direction: an edit to a later artifact may require revising an earlier one, not only the other way around. Build order is a useful reading order, not a constraint on which artifacts may be revised.
|
||||
- Note everything that is now inconsistent, missing, or contradictory.
|
||||
- Revise only files that already exist (`existingOutputPaths`). Do NOT create artifacts that don't exist yet, and do NOT invent new files under a glob artifact - note them and point the user to `/openspec-continue-change` to create them.
|
||||
- If the change is already coherent, say so and make no edits.
|
||||
|
||||
5. **Confirm and apply, one artifact at a time**
|
||||
- Show each proposed revision and why. Write only after the user confirms.
|
||||
- If the user rejects a revision, do not write it - leave that artifact unchanged.
|
||||
- When a substantial rewrite is needed, get that artifact's rules and template first:
|
||||
```bash
|
||||
openspec instructions <artifact-id> --change "<name>" --json
|
||||
```
|
||||
|
||||
6. **Point to the next step (guidance only - NEVER act on it)**
|
||||
- Artifacts still missing -> suggest `/openspec-continue-change` to create them.
|
||||
- Change already implemented (tasks checked off / already applied) -> the code may no longer match the revised plan; suggest `/openspec-apply-change` to carry the delta into code.
|
||||
- Everything done and implemented -> suggest `/openspec-archive-change`.
|
||||
|
||||
**Output**
|
||||
|
||||
After each invocation, show:
|
||||
- Which artifacts were revised (and which proposed revisions were rejected)
|
||||
- Anything deferred to `/openspec-continue-change` (not-yet-created artifacts or files)
|
||||
- Where the change stands and the recommended next command
|
||||
|
||||
**Guardrails**
|
||||
- Planning artifacts only - NEVER edit implementation code. If the revised plan implies code changes, stop and point to `/openspec-apply-change`.
|
||||
- Use the artifact ids and paths reported by `openspec status`; never branch on hardcoded artifact names.
|
||||
- Edit only the concrete files in `existingOutputPaths`; never write to a glob `resolvedOutputPath`.
|
||||
- Do not advance the build frontier: no new artifacts, no new files under glob artifacts - that is `/openspec-continue-change`'s job.
|
||||
- Confirm every edit with the user before writing.
|
||||
- If the request changes the change's *intent* rather than refining it, recommend starting fresh with `/openspec-new-change` (the "Update vs. Start Fresh" heuristic).
|
||||
- `/openspec-continue-change` and `/openspec-new-change` may not be installed (core profile). When suggesting one that is unavailable, point to the CLI instead: `openspec status --change "<name>" --json` shows the next artifact and `openspec instructions <artifact-id> --change "<name>" --json` explains how to create it.
|
||||
@@ -1,26 +0,0 @@
|
||||
# 让镜像只带源码与运行必需文件,别把本机的浏览器 profile / 日志 / 凭据 / node_modules 打进去
|
||||
node_modules
|
||||
.run-profile
|
||||
.run-tmp
|
||||
run-logs
|
||||
*.log
|
||||
|
||||
# 凭据绝对不能进镜像层
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
runner.local.mjs
|
||||
|
||||
# 开发工具与文档:容器里跑无头用不到,省体积
|
||||
.git
|
||||
.gitattributes
|
||||
.gitignore
|
||||
.vscode
|
||||
.idea
|
||||
docs
|
||||
dev/tests
|
||||
|
||||
# 镜像自身文件(entrypoint.sh 由 Dockerfile 单独 COPY,这里的 .dockerignore 规则不影响)
|
||||
Dockerfile
|
||||
docker-compose.yml
|
||||
.dockerignore
|
||||
@@ -1,27 +0,0 @@
|
||||
# 复制成 .env 后填自己的账号密码(.env 已在 .gitignore 里,不会入库)
|
||||
# 凭据只认这两个变量,不能写进 config/runner.config.mjs
|
||||
YUN_XUE_TANG_USR=
|
||||
YUN_XUE_TANG_PWD=
|
||||
|
||||
# 本次最多刷多少分钟(0 / 留空 = 不限;Docker 里常用)
|
||||
YUN_XUE_TANG_BUDGET_MINUTES=0
|
||||
|
||||
# 开始运行 / 每门课获得学分 / 收尾时推送 Bark 手机通知。
|
||||
# 填 Bark App 里的推送地址(含设备 key),留空 = 不推送。优先级高于 config/runner.config.mjs
|
||||
YUN_XUE_TANG_BARK_URL=
|
||||
# 通知分组,留空 = Bark 默认
|
||||
YUN_XUE_TANG_BARK_GROUP=云学堂助手
|
||||
# 通知在 Bark 服务端保留多少秒,0 = 永久保留(不传 ttl)
|
||||
YUN_XUE_TANG_BARK_TTL=0
|
||||
|
||||
# 时区,影响日志时间戳
|
||||
TZ=Asia/Shanghai
|
||||
|
||||
# ---- 以下三个只在构建镜像时用(docker compose build / npm run docker:build)----
|
||||
# Debian 源地址:国内建议 mirrors.tuna.tsinghua.edu.cn,留空 = 保持 deb.debian.org
|
||||
APT_MIRROR=
|
||||
# npm 源地址:国内建议 https://registry.npmmirror.com,留空 = 官方源
|
||||
NPM_REGISTRY=
|
||||
# Chrome deb 直链:国内常常下不动 dl.google.com,填自己的内网镜像地址;
|
||||
# 留空 = 按架构自动取官网地址
|
||||
CHROME_DEB_URL=
|
||||
@@ -1,19 +0,0 @@
|
||||
# 统一换行符,避免 Windows / macOS 混合编辑产生整文件 diff
|
||||
* text=auto eol=lf
|
||||
|
||||
# Windows 批处理必须 CRLF,否则 cmd.exe 解析 if/goto 可能出错
|
||||
*.cmd text eol=crlf
|
||||
*.bat text eol=crlf
|
||||
|
||||
# 容器 entrypoint 必须 LF:带 CRLF 时 shebang 会变成 "/bin/sh\r",容器启动直接报 exec format error
|
||||
*.sh text eol=lf
|
||||
Dockerfile text eol=lf
|
||||
docker-compose.yml text eol=lf
|
||||
|
||||
# 二进制文件不做文本转换
|
||||
*.png binary
|
||||
*.jpg binary
|
||||
*.jpeg binary
|
||||
*.gif binary
|
||||
*.ico binary
|
||||
*.woff2 binary
|
||||
-29
@@ -1,29 +0,0 @@
|
||||
# ---- 依赖 ----
|
||||
node_modules/
|
||||
|
||||
# ---- 运行 / 调试产物 ----
|
||||
# 本地实跑会在这里生成浏览器配置目录、截图和一次性调试脚本,体积很大,不入库
|
||||
.run-tmp/
|
||||
# 真机测试(dev/tests/real-*.mjs)每次跑都重新生成的截图
|
||||
.run-tmp/screenshots/
|
||||
# 无头运行器的持久化 profile(含登录 cookie,绝不能入库)和运行日志
|
||||
.run-profile/
|
||||
run-logs/
|
||||
*.log
|
||||
*.tmp
|
||||
|
||||
# ---- 编辑器 / 系统 ----
|
||||
.vscode/
|
||||
.idea/
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
desktop.ini
|
||||
*~
|
||||
|
||||
# ---- 本地私有配置(不要提交账号信息) ----
|
||||
.env
|
||||
.env.*
|
||||
# 模板要入库:只有它不含真实凭据
|
||||
!.env.example
|
||||
# 个人临时覆盖用的运行器配置(仓库里的 config/runner.config.mjs 保持通用)
|
||||
runner.local.mjs
|
||||
-111
@@ -1,111 +0,0 @@
|
||||
# 云学堂助手 · 无头运行器镜像
|
||||
#
|
||||
# 设计要点(为什么是这些选择):
|
||||
# · 基础镜像用 node:22-bookworm-slim —— runner/ 依赖全局 WebSocket / fetch,
|
||||
# preflight.mjs 会硬性要求 Node 22+,低于这个版本连预检都过不去;
|
||||
# · 浏览器装官方 google-chrome-stable,而不是 Debian 的 chromium:
|
||||
# 发行版 chromium 不带 H.264/AAC 专有编解码器,课程视频会一直停在 0 秒
|
||||
# (README「无图形环境常见的坑」里那条 error.code=4 就是这个原因);
|
||||
# · 构建在镜像内完成(npm ci → npm run build),产物落在 /app 根目录,
|
||||
# 所以镜像可以直接跑,不依赖宿主机先 build;
|
||||
# · 容器内必然没有 DISPLAY,运行器会自动走无头;以 root 运行时
|
||||
# platform.mjs / browser.mjs 会自动补 --no-sandbox 与 --disable-dev-shm-usage,
|
||||
# 不需要在命令行里手写这些参数。
|
||||
#
|
||||
# 构建:docker build -t yun-xue-tang-assistant .
|
||||
# 运行:见 docker-compose.yml 或 README「容器(Docker)」
|
||||
|
||||
FROM node:22-bookworm-slim
|
||||
|
||||
# 国内或内网环境从 dl.google.com 下不动时,可用内网镜像 / 本地文件替换:
|
||||
# docker build --build-arg CHROME_DEB_URL=https://your-mirror/google-chrome-stable_current_amd64.deb .
|
||||
# 留空则按架构自动取官网地址。
|
||||
ARG CHROME_DEB_URL=
|
||||
# Debian 官方源在国内经常慢到几百字节每秒,可用内网/国内镜像替换:
|
||||
# docker build --build-arg APT_MIRROR=mirrors.tuna.tsinghua.edu.cn .
|
||||
# 留空 = 保持基础镜像自带的 deb.debian.org
|
||||
ARG APT_MIRROR=
|
||||
# npm 同理(https://registry.npmmirror.com 之类),留空 = 官方源
|
||||
ARG NPM_REGISTRY=
|
||||
# tzdata 让日志时间戳跟随 TZ(默认给上海时区);fonts-noto-cjk 只影响截图观感,
|
||||
# 但缺了它中文在页面里是方块,排查问题时不方便
|
||||
ENV TZ=Asia/Shanghai \
|
||||
DEBIAN_FRONTEND=noninteractive
|
||||
|
||||
# 注意:这段 RUN 里不要夹注释行——Docker 解析续行时可能把注释当成命令的一部分,容易把命令拼断。
|
||||
# 步骤:装基础包 → 按架构下官方 Chrome deb → 用 apt 一次装齐依赖 → 清缓存 → 验证能起来。
|
||||
# procps 提供 ps:运行器启动时靠它找「占着本 profile 的残留浏览器」并收掉(缺了也可跑,自愈会退化)。
|
||||
RUN set -eux; \
|
||||
if [ -n "$APT_MIRROR" ]; then \
|
||||
sed -ri "s|deb.debian.org|${APT_MIRROR}|g" /etc/apt/sources.list.d/debian.sources /etc/apt/sources.list 2>/dev/null || true; \
|
||||
echo "已切换 apt 源:$APT_MIRROR"; \
|
||||
fi; \
|
||||
apt-get update; \
|
||||
apt-get install -y --no-install-recommends \
|
||||
ca-certificates \
|
||||
curl \
|
||||
fonts-liberation \
|
||||
fonts-noto-cjk \
|
||||
gnupg \
|
||||
procps \
|
||||
tzdata \
|
||||
wget; \
|
||||
arch="$(dpkg --print-architecture)"; \
|
||||
case "$arch" in \
|
||||
amd64) chrome_deb="google-chrome-stable_current_amd64.deb" ;; \
|
||||
arm64) chrome_deb="google-chrome-stable_current_arm64.deb" ;; \
|
||||
*) echo "不支持的架构:$arch(可用 amd64 / arm64)" >&2; exit 1 ;; \
|
||||
esac; \
|
||||
chrome_url="${CHROME_DEB_URL:-https://dl.google.com/linux/direct/${chrome_deb}}"; \
|
||||
echo "下载 Chrome:$chrome_url"; \
|
||||
wget -q -O /tmp/chrome.deb "$chrome_url"; \
|
||||
apt-get install -y --no-install-recommends /tmp/chrome.deb; \
|
||||
rm -f /tmp/chrome.deb; \
|
||||
rm -rf /var/lib/apt/lists/*; \
|
||||
dpkg-query -W -f='chrome ${Version}\n' google-chrome-stable; \
|
||||
timeout 60 google-chrome-stable --headless=new --no-sandbox --disable-gpu \
|
||||
--disable-dev-shm-usage --dump-dom about:blank > /dev/null
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# 依赖层单独缓存:只有 lockfile 变了才重装。
|
||||
# devDependencies 里的 esbuild 是构建注入脚本必需的,所以不能用 --omit=dev;
|
||||
# 留着它也能让使用者在容器里直接 `npm run build`
|
||||
COPY package.json package-lock.json ./
|
||||
RUN set -eux; \
|
||||
if [ -n "$NPM_REGISTRY" ]; then \
|
||||
npm config set registry "$NPM_REGISTRY"; \
|
||||
fi; \
|
||||
npm ci --no-audit --no-fund
|
||||
|
||||
# 业务源码 + 构建脚本 + 无头运行器(node_modules / .run-profile / run-logs / .env 由 .dockerignore 排除)
|
||||
COPY . .
|
||||
|
||||
# 构建注入浏览器用的单文件脚本,并确认产物真的生成了
|
||||
RUN npm run build && test -s yun-xue-tang-assistant.user.js
|
||||
|
||||
# 运行期目录:profile(含登录 cookie)与日志。用命名卷 / 绑定挂载覆盖即可持久化
|
||||
RUN mkdir -p /app/.run-profile /app/run-logs && chmod 700 /app/.run-profile
|
||||
|
||||
COPY docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh
|
||||
# 用 tr 去掉可能存在的 CR(Windows 上检出后容易带 CRLF,shebang 会变成 /bin/sh\r,exec 直接报 exec format error),
|
||||
# 然后当场用 sh -n 验一遍语法,把问题拦在构建阶段
|
||||
RUN tr -d '\r' < /usr/local/bin/docker-entrypoint.sh > /tmp/ep.sh \
|
||||
&& mv /tmp/ep.sh /usr/local/bin/docker-entrypoint.sh \
|
||||
&& chmod +x /usr/local/bin/docker-entrypoint.sh \
|
||||
&& sh -n /usr/local/bin/docker-entrypoint.sh
|
||||
|
||||
# 容器里没有图形会话,强制无头;面板需要 TTY,后台跑时保持关闭
|
||||
# (`docker run -it -e YUN_XUE_TANG_TUI=1` 可以打开面板)
|
||||
ENV YUN_XUE_TANG_HEADLESS=1 \
|
||||
YUN_XUE_TANG_TUI=0 \
|
||||
YUN_XUE_TANG_PROFILE_DIR=/app/.run-profile \
|
||||
YUN_XUE_TANG_LOG_FILE=/app/run-logs/headless.log \
|
||||
YUN_XUE_TANG_CHROME_BIN=/usr/bin/google-chrome-stable
|
||||
|
||||
# 凭据只走环境变量,不在镜像里 ENV(否则会被写进镜像层):
|
||||
# docker run ... -e YUN_XUE_TANG_USR=账号 -e YUN_XUE_TANG_PWD=密码
|
||||
|
||||
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
|
||||
# 默认无参数:入口脚本在「没参数且没填凭据」时自动降级成 --check(只读自检)
|
||||
CMD []
|
||||
@@ -1,599 +0,0 @@
|
||||
# 云学堂助手
|
||||
|
||||
在云学堂(`*.yunxuetang.cn`)上自动登录、按目录顺序听课、自动切节,并在课程列表页逐门推进的
|
||||
Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含考试章节的课程会自动进入考试、
|
||||
不答题直接交卷;一门课学完会自动回列表选下一门。
|
||||
平台按**真实播放时长**计时,脚本只负责「自动点播放、自动切下一节、处理防挂机弹窗」,
|
||||
不快进、不改进度、不伪造学时。
|
||||
|
||||

|
||||
|
||||
## 功能
|
||||
|
||||
| 能力 | 说明 |
|
||||
| --- | --- |
|
||||
| 一键登录 | 面板里填账号密码,自动填充表单、勾选协议、点击登录;支持记住密码与自动登录 |
|
||||
| 顺序听课 | 进入课程(列表刷课或自己点开)后先对齐到「第一个未学完的课时」,从第一章第一节顺序往下学 |
|
||||
| 自动切节 | 本节播完(`video.ended` 或平台倒计时归零)后自动进入下一节,并等平台记账后再继续 |
|
||||
| 完成即跳课 | 平台汇总变成 `已完成学习`、进度 100% 或 `x/y` 满时判定整门课完成,自动回列表选下一门;不会停在已完成页,也不会把播完的视频从头重播 |
|
||||
| 多类型播放页 | 识别 `#/course/play`、`#/video/play`、`#/audio/play`、`#/ppt/play` 等播放页;单视频课程同样自动点「开始学习」 |
|
||||
| 防挂机验证 | 识别「已触发防挂机验证」弹窗并点「继续学习」;滑块/拼图类验证不绕过,提示人工处理 |
|
||||
| 课程列表自动刷课 | 在列表页逐门进入未学完的课程;每完成一门都重新调列表接口拿平台实时状态再选下一门,本次门数上限见下方配置表 |
|
||||
| 短课程优先 | 列表刷课默认按课程总时长**从短到长**选课(跨页),先完成 1 分钟的课再学 1 小时的课;面板可关闭 |
|
||||
| 每日积分模式 | **以平台积分台账为准**:整门课完成计 1 次,文档 1 次、视频 3 次、音频 2 次、微课 2 次,每次 3 分,单日封顶 24 分。多课时课程要所有课时(含考试)都完成才计分,按今天实际学过的课时类型归类;平台真的入账了才计数。先补文档/音频/微课单条内容,视频额度靠课程;某类满额自动切下一类,四类都满(或剩余类型没内容)就停止刷课。计数存 localStorage、跨刷新/重启不丢、跨天清零;面板可随时关闭 |
|
||||
| 考试自动空卷 | 含考试章节的课程不再跳过:自动点进考试节 → 开始/继续考试 → 一题不做直接「提交考试」→ 点「确定」交卷,交卷后课程进度被平台记账,课程即可完成。只有本页真的点过「提交考试/确定交卷」,看到的结果页才算一次交卷;平台恢复的旧结果页会先回「考试说明页」重新进入,不会在结果页和课程页之间空转。同一门课最多交卷 `maxExamTries` 次,超过仍不记账就跳过该课继续下一门(写明原因) |
|
||||
| 不跳过普通课程 | 没有任何「跳过本课」入口,也不会把普通课程加入黑名单;没学完就退避重试(30 秒起翻倍,最长 5 分钟),同一门课最多重试 `maxCourseRetries` 次,超过才停下整轮刷课并提示原因,等人工处理。**唯一例外**:考试空卷交卷达到 `maxExamTries` 仍未计入进度,或考试页始终没有可点的「开始考试/提交考试」——继续重试只会反复进同一门课,因此本轮跳过它、继续刷其它课 |
|
||||
| 进度可续 | 学习进度存在 `sessionStorage`(`yun-xue-tang-run-state-v3`),整页跳转/刷新后继续上次的队列和页码;**运行开关不跨会话** —— 浏览器重启、运行器新建标签页后一律回到待机,必须显式开跑(避免未登录就报「运行中」) |
|
||||
| 无头运行 | 在有/无图形界面的机器上都能跑;`runner/` 可自己起无头 Chromium 并注入脚本,适合 Linux 服务器 / Windows 无人值守常驻(见下方「无头运行」) |
|
||||
|
||||
## 安装
|
||||
|
||||
1. 浏览器安装 [Tampermonkey](https://www.tampermonkey.net/)。
|
||||
2. 打开 Tampermonkey 面板 → 添加新脚本 → 粘贴 [`yun-xue-tang-assistant.user.js`](yun-xue-tang-assistant.user.js) 全文 → 保存。
|
||||
3. 打开 <https://kfmic.yunxuetang.cn/login.html>,右下角出现「云学堂助手」面板:
|
||||
- 填账号密码 → 点「一键登录并刷课」,登录后自动进入列表并开始逐门学习;
|
||||
- 或手动登录后,在列表页点「一键刷课」。
|
||||
|
||||
脚本 `@grant none`,不依赖任何本地服务,可独立运行。
|
||||
|
||||
## 配置
|
||||
|
||||
配置项集中在 `src/config.js` 的 `CFG`(改完 `npm run build` 重新打包):
|
||||
|
||||
| 配置项 | 默认 | 作用 |
|
||||
| --- | --- | --- |
|
||||
| `mute` | `true` | 静音播放(自动播放更稳) |
|
||||
| `autoNext` | `true` | 当前课程自动连播:本节结束自动下一节 |
|
||||
| `tickMs` | `2000` | 主循环间隔 |
|
||||
| `startClickCooldownMs` | `3000` | 「开始学习」重复点击冷却:3 秒内没起播就补点 |
|
||||
| `entryGraceMs` | `30000` | 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」 |
|
||||
| `stuckMs` | `5 分钟` | 连续多久没有计时进展就放弃当前课程 |
|
||||
| `maxCourseRetries` | `5` | 同一门课最多重试多少次;超过则停止整轮刷课并提示(不会跳过该课) |
|
||||
| `courseRetryDelayMs` | `30000` | 首次重试前的等待;每次翻倍,最长 5 分钟 |
|
||||
| `alignToFirstIncomplete` | `true` | 进入课程先从第一个未学完的课时学起;`false` = 沿用平台上次位置 |
|
||||
| `preferShortCourses` | `true` | 列表刷课时优先总时长更短的课程(正序);面板勾选框「优先短课程(时长正序)」可随时切换 |
|
||||
| `pointsEnabled`(`localStorage`) | `true` | 每日积分模式:整门课完成计 1 次,文档 1 / 视频 3 / 音频 2 / 微课 2(每次 3 分,封顶 24 分);面板勾选框「每日积分模式」可随时切换 |
|
||||
| `maxExamTries` | `2` | 同一门课「空卷交卷」的最大次数;超过仍没计入进度就本轮跳过该课、继续下一门(记录在会话里,重启后会重新尝试) |
|
||||
| `examClickCooldownMs` | `1500` | 考试页内两次点击的间隔(毫秒) |
|
||||
|
||||
对齐起点对「一键刷课」和自己点开的课程(需勾选「当前课程自动连播」)都生效,
|
||||
每门课只在进入时对齐一次,之后手动点其它课时不会被拉回。
|
||||
|
||||
短课程优先开启时,列表刷课启动会先读取一次列表接口里的课程总时长(首次约 5–10 秒,
|
||||
结果在当前标签页缓存 5 分钟),把未学完课程按 `studyHours` 正序排队,再跳到目标页
|
||||
逐个进入。接口不可用(未登录、跨域、平台改版)时自动降级为「当前页按时长正序」,
|
||||
再不行就回到原来的列表顺序,不会让刷课任务卡住。
|
||||
|
||||
每日积分模式按**整门课**计数:多课时课程要所有课时(含考试)都完成才算一次,
|
||||
按今天实际学过的课时类型(视频/文档/音频/微课)归类;单视频/音频/课件播放页学完也算一次。
|
||||
某类满额后自动换下一类;四类都满额,或剩余额度的类型在当前目录里确认没有内容时,
|
||||
停止刷课并在面板/日志里汇报今日积分。只剩考试、今天没学内容的老课不计分;
|
||||
同一门课当天重复上报只算一次。
|
||||
|
||||
积分是否真的拿到,以平台「我的积分」台账为准:`/ssp/#/my/point` 背后的
|
||||
`api-phx-tc.yunxuetang.cn/ssp/point/history/self` 和 `ssp/rule/org`。脚本完成一门课后
|
||||
等平台入账,只有台账新增学习记录才计数;今日学习积分达到规则上限即收尾。
|
||||
接口不可用(未登录 / 跨域 / 网络)时自动退回本地计数。
|
||||
|
||||
## 无头运行(Linux / Windows 服务器)
|
||||
|
||||
用 `runner/headless.mjs` 把整套逻辑跑在一个无头 Chromium 里:自己起浏览器、用 CDP 把构建产物
|
||||
注入页面主世界(等价 Tampermonkey `@grant none`),不需要装浏览器插件、不需要桌面环境、
|
||||
不需要 Xvfb。Linux 与 Windows 都支持,macOS 也能跑。
|
||||
|
||||
支持的环境:
|
||||
|
||||
| 环境 | 说明 |
|
||||
| --- | --- |
|
||||
| Linux 服务器 | 机房机器、云主机、容器;root 运行、`/dev/shm` 只有 64MB 都自动适配 |
|
||||
| Docker 容器 | 自带官方 Chrome 与 Node 22,镜像内已完成构建;见下方「容器(Docker)」 |
|
||||
| Windows 桌面 | 后台挂着跑;关掉控制台窗口或 `Ctrl+C` 都能让它收尾 |
|
||||
| Windows 服务器核心版 / 无桌面 | 无交互桌面也能跑(Chromium 无头不需要窗口站) |
|
||||
| Windows 服务 / 计划任务 Session 0 | 会检测到 `SESSIONNAME=Services` 强制无头,`headless: false` 被忽略 |
|
||||
| macOS | 无头可用(本机调试场景) |
|
||||
|
||||
**Linux / macOS:**
|
||||
|
||||
```bash
|
||||
# 1. 依赖(Ubuntu / Debian 为例)
|
||||
sudo apt install -y chromium # 或安装官方包:google-chrome-stable
|
||||
# 2. 构建产物
|
||||
npm install && npm run build
|
||||
# 3. 调参:改 config/runner.config.mjs(budgetMinutes、preferShort…)
|
||||
# 只想临时覆盖就用命令行,例如 npm run headless -- --budget-minutes 15
|
||||
# 4. 凭据走环境变量(不要写进配置文件)
|
||||
export YUN_XUE_TANG_USR='你的账号'
|
||||
export YUN_XUE_TANG_PWD='你的密码'
|
||||
# 5. 先自检(只读:不登录、不点课程、不改进度)
|
||||
npm run headless:check
|
||||
# 6. 正式跑,前台常驻,Ctrl+C 结束
|
||||
npm run headless
|
||||
```
|
||||
|
||||
Linux 上建议用 `tmux` / `nohup` 托管,因为运行器是**前台进程**(不内置守护模式):
|
||||
|
||||
```bash
|
||||
tmux new -d -s yun-xue-tang 'cd ~/yun-xue-tang-assistant && npm run headless'
|
||||
tmux attach -t yun-xue-tang # 看实时输出
|
||||
tail -f run-logs/headless.log # 也可以直接看日志文件
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
|
||||
```powershell
|
||||
# 1. 浏览器:Chrome 或 Edge 都行(Edge 是 Chromium 内核,同样可用)
|
||||
winget install --id Google.Chrome
|
||||
# 2. 构建产物
|
||||
npm install; npm run build
|
||||
# 3. 调参:改 config/runner.config.mjs(无需重新 build)
|
||||
# 4. 凭据(PowerShell;用 CMD 请改成 set YUN_XUE_TANG_USR=...)
|
||||
$env:YUN_XUE_TANG_USR='你的账号'
|
||||
$env:YUN_XUE_TANG_PWD='你的密码'
|
||||
# 5. 自检 + 正式跑
|
||||
npm run headless:check
|
||||
npm run headless
|
||||
```
|
||||
|
||||
也可以直接双击 [`scripts/start-headless.cmd`](scripts/start-headless.cmd):它会自动构建、检查 Node、跑完后
|
||||
用 `pause` 留住退出码信息(方便看报错)。注意这个批处理文件**只写 ASCII 字符**——中文提示
|
||||
全部由 Node 侧输出,原因见下方常见坑表里的「`'鍏?npm' 不是内部或外部命令`」。
|
||||
|
||||
Windows 上常驻的三种方式:
|
||||
|
||||
```powershell
|
||||
# A. 隐藏窗口后台跑(立刻返回,日志看 run-logs\headless.log)
|
||||
Start-Process -WindowStyle Hidden node -ArgumentList "runner/headless.mjs" -WorkingDirectory $PWD
|
||||
|
||||
# B. 计划任务:登录时自动开始(勾「不管用户是否登录」也能跑,会强制无头)
|
||||
schtasks /create /tn "云学堂助手" /tr "node runner\headless.mjs" /sc onlogon /rl highest
|
||||
|
||||
# C. 只跑一段(例如每天凌晨跑 2 小时):命令行临时覆盖配置
|
||||
npm run headless -- --budget-minutes 120
|
||||
# 或把 budgetMinutes: 120 写进 config/runner.config.mjs,然后直接 npm run headless
|
||||
```
|
||||
|
||||
Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停批量、关浏览器)。
|
||||
但如果是在任务管理器里「结束任务」或 `taskkill /F`,进程会被直接终止、收尾代码不会执行;
|
||||
这种情况下次启动时会自动清理残留的浏览器进程与 `lockfile`,不需要手工处理。
|
||||
|
||||
### 终端面板
|
||||
|
||||
在终端里前台运行时(`npm run headless`、`tmux`、SSH 会话),运行器会自动开一块实时面板:
|
||||
|
||||
```text
|
||||
╭ 云学堂助手 · 无头运行器 ─────────────────────────────────────────────────────────╮
|
||||
│ 状态 刷课中 已运行 1:12:01 │
|
||||
│ 课程 2025年安全生产月专题培训课程(第三期) │
|
||||
│ 学时 已学 1:23:45 · 学分 12.75 · 本门 6.52 │
|
||||
│ 课时 第三章 事故应急处置与自救互救 已学 62% │
|
||||
│ 视频 ████████████████████░░░░░░░░░░░░ 62% 13:32/22:00 │
|
||||
│ 进度 本次 3/10 · 累计 17 · 课时数 8 · 等待重试 12s · 倒计时 42s │
|
||||
│ 日志 ./run-logs/headless.log · 已注入 4 次 │
|
||||
├ 最近日志 ────────────────────────────────────────────────────────────────────────┤
|
||||
│ [2024-05-21 09:12:03] [信息] 浏览器就绪:HeadlessChrome/124.0.6367.91 │
|
||||
│ [2024-05-21 09:12:07] [信息] 已注入脚本(第 1 次):…/course/play/xxx │
|
||||
╰──────────────────────────────────────────────────────────────────────────────────╯
|
||||
q 退出(等价 Ctrl+C:暂停视频、停批量、关浏览器)· 完整日志照常写入日志文件
|
||||
```
|
||||
|
||||
- **学习统计**:`学时` 那行给出两个数字——
|
||||
- `已学`:**视频真正在播**的累计时长(排队、重试退避、页面加载都不计;暂停时右侧会标「暂停中,不计时」,好确认面板是活的而不是卡住了);
|
||||
- `学分`:**本次运行里真正刷完**的课程累计能拿到的学分,按课程去重,重试/刷新页面不会重复计。
|
||||
- `本门 6.52` 是当前在刷这门课学完能拿多少分——平台只把这个数字写在倒计时文案里(「还需 2小时 8分钟 可完成本课程学习并获得6.52学分」),学完后文案元素就消失了,所以运行器是边播边记。
|
||||
- 两个数字都只统计本次运行(不落盘、不加 `stats.json`),退出即清零;退出时日志里会多一行「本次学习:视频累计播放 1:23:45,获得 12.75 学分」。
|
||||
- 注意学分口径是「运行器亲眼看到刷完的课」,如果中途 `Ctrl+C` 退出,正在刷的那门课即使已经学了 90% 也不会算进学分(平台只在课程真正完成时才给分)。
|
||||
- **只读**:面板不接收命令,唯一的按键是 `q`(等价 `Ctrl+C`,走同一套优雅退出:暂停视频 → 停批量 → 关浏览器)。`Ctrl+L` 可强制重绘。
|
||||
- **自动降级**:stdout 不是 TTY(重定向到文件、计划任务、`nohup cmd > out.txt`)时自动关闭,回到原来的逐行日志,不会往日志里写 ANSI 控制字符。
|
||||
- **不想用面板**:`--no-tui`(或配置文件 `tui: false`、环境变量 `YUN_XUE_TANG_TUI=0`)。
|
||||
- **不想用颜色**:`--no-color`、配置文件 `color: false` 或 `NO_COLOR=1`;关闭后只剩框线与符号,排版不变。
|
||||
- **完整日志不受影响**:面板只是终端的另一种显示方式,`run-logs/headless.log` 还是纯文本、按时间递增,`tail -f` 照常可看。
|
||||
- **跟随窗口**:面板宽度直接取终端宽度,多宽就画多宽(不再封顶 120 列),每秒重画一次。拖拽窗口或用 `tmux` 分屏时,能收到 `resize` 事件的终端(Linux / macOS / Windows Terminal)去抖 60ms 后立即重排;收到不到的(Windows 传统控制台 `conhost` 拖窗口、最大化,Node 不会发任何事件)由每秒的定时刷新发现尺寸变了、自动重画,最多晚 1 秒。
|
||||
- **变窄 / 还原**时要额外处理一件事:终端会把之前那些更宽的行重新折成多行,旧面板实际占的屏幕行数会比记录的逻辑行数多。运行器按「旧帧在新宽度下会折成几行」来回退光标,而不是数逻辑行;如果折完比整个窗口还高(最大化后还原就是这样),光标退不到块首,只能整屏重置(`Esc[H` + `Esc[2J`)后在顶部重画——代价是上方已经滚出去的历史日志不在屏幕上(但 `run-logs/*.log` 里一直都有一份)。小幅变窄(折完仍装得下窗口)走精确回退,不丢历史。
|
||||
- **宽度不够**时按重要性丢字段,而不是一律打省略号:「进度」先丢倒计时、课时数,「视频」先缩进度条、再丢 `13:32/22:00` 这种时间标——剩下的始终是百分比和「本次/累计」骨架。
|
||||
- **高度不够**时先降级成紧凑模式(不足 15 行省掉课时、日志两行,但**学时行一定保留**),再矮(不足 10 行)连 `q` 提示也省掉,更矮时连日志区一起省。任何时候帧高都不超过窗口,否则会把回滚区里的历史顶掉。
|
||||
|
||||
运行器做的事:
|
||||
|
||||
| 能力 | 说明 |
|
||||
| --- | --- |
|
||||
| 脚本注入 | 每次整页跳转(新 document)后自动补注入,和 Tampermonkey 按 `@match` 重注入等价 |
|
||||
| 持久化登录 | 浏览器 profile 固定到 `./.run-profile`,cookie / localStorage 都留着,重启不用重登 |
|
||||
| 掉登录自动重登 | cookie 失效或被踢回登录页时,用 `YUN_XUE_TANG_USR` / `YUN_XUE_TANG_PWD` 自动登录并接着刷课 |
|
||||
| 崩溃自愈 | CDP 断线、浏览器崩溃、90 秒读不到脚本状态都会重启浏览器,并由看护循环在新会话里显式重新开跑(浏览器重启后 sessionStorage 清空,进度里的「完成书目」会重新从平台接口取) |
|
||||
| 无进展保护 | 连续 30 分钟没有任何进展(`YUN_XUE_TANG_IDLE_RESTART_MINUTES`)时退出,避免无意义挂机 |
|
||||
| 优雅退出 | `Ctrl+C` / `q`(面板里)/ `SIGTERM` 时先 `pauseAllMedia`、停批量、再关浏览器,不留脏状态(Windows 上监听 `SIGINT` / `SIGBREAK` / `SIGHUP`) |
|
||||
| 残留自愈 | 上次被强杀(`kill -9` / 任务管理器「结束任务」)留下的浏览器进程与锁文件,启动时按 profile 目录自动清理,端口不会一直被占 |
|
||||
| 平台适配 | 平台差异集中在 `runner/platform.mjs`:有无图形会话、沙箱参数、进程树收尾、端口排查命令都按系统出 |
|
||||
| 日志 | 同时写终端和 `./run-logs/headless.log`(`YUN_XUE_TANG_LOG_MAX_BYTES` 默认 5MB,超出轮转成 `.1`) |
|
||||
|
||||
### 代码结构
|
||||
|
||||
`runner/` 按职责拆成小模块,入口只有 90 行,改哪块就看哪个文件:
|
||||
|
||||
| 文件 | 行数级别 | 职责 |
|
||||
| --- | --- | --- |
|
||||
| `runner/headless.mjs` | ~130 | 入口:解析参数 → 预检 → 交给 supervisor,只做组装 |
|
||||
| `runner/config.mjs` | ~360 | 三层合并(配置文件 / 环境变量 / 命令行)+ 校验 + `--help`,其它模块只读导出常量 |
|
||||
| `config/runner.config.mjs` | ~50 | **日常调参就改这里**:普通 JS 模块,可写注释,改完不用 build |
|
||||
| `runner/platform.mjs` | ~230 | 平台差异:有无图形会话、沙箱参数、进程树收尾、残留进程清理、排查命令 |
|
||||
| `runner/preflight.mjs` | ~95 | 启动前检查:产物、Node 版本、凭据、浏览器、调试端口(端口被占会先自愈) |
|
||||
| `runner/log.mjs` | ~50 | 终端 + 文件日志,超上限轮转成 `.1` |
|
||||
| `runner/stop.mjs` | ~60 | 终止信号优雅退出(Windows 走 SIGINT/SIGBREAK/SIGHUP) |
|
||||
| `runner/browser.mjs` | ~230 | 浏览器探测、启动参数、陈旧锁与孤儿进程清理 |
|
||||
| `runner/cdp.mjs` | ~90 | 极简 CDP 客户端(Node 22+ 原生 WebSocket,无第三方依赖) |
|
||||
| `runner/page.mjs` | ~155 | 注入后要调用的页面 JS 表达式 + `page.evalJS/json/tryEval` 封装 |
|
||||
| `runner/session.mjs` | ~310 | 单次会话:起浏览器 → 注入 → 自动重登 → 刷课 → 监控 → 收尾 |
|
||||
| `runner/selfcheck.mjs` | ~60 | `--check` 的只读环境自检 |
|
||||
| `runner/tui.mjs` | ~470 | 终端面板:框线布局、进度条、ANSI 宽度对齐、`q` 退出、尺寸自适应、非 TTY 自动关闭 |
|
||||
| `runner/study.mjs` | ~110 | 学习统计:本次跑了多久(只算视频真在播)、拿到多少学分(按课程去重) |
|
||||
| `runner/supervisor.mjs` | ~85 | 崩溃重启循环、退出码与本次学习统计汇总 |
|
||||
|
||||
模块之间是单向依赖(`headless` → `supervisor` → `session` → `page`/`selfcheck` → `cdp`),
|
||||
平台相关的判断全部下沉到 `platform.mjs`(`browser.mjs` 转发它的导出,老代码不用改),
|
||||
没有循环引用,也没有需要打包的步骤:`node runner/headless.mjs` 直接跑多文件 ESM。
|
||||
`tui.mjs` 只单向依赖 `log.mjs`(接管终端输出)与 `study.mjs`(学时/学分累计),
|
||||
所以对它来说 `session.mjs`、`supervisor.mjs` 都是「可选调用方」——面板关了也不会影响它们任何逻辑。
|
||||
`study.mjs` 不读终端也不读浏览器(只吃快照 + 一个可替换的时钟),所以能脱离两者直接用假时钟测。
|
||||
改脚本内部 API(`window.__yunXueTangAuto` 上的方法)只需要动 `runner/page.mjs`。
|
||||
|
||||
命令行参数(**日常改配置文件就行**;这里的开关只是临时覆盖,适合写进 `tmux` 命令或 `~/.bashrc`):
|
||||
|
||||
优先级:**内置默认值 < `config/runner.config.mjs` < 环境变量 `YUN_XUE_TANG_*` < 命令行参数**。
|
||||
|
||||
| 参数 | 环境变量 | 配置文件字段 | 默认 | 作用 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `--check` | — | (不支持) | 关 | 只做环境自检:浏览器能启动、页面能打开、脚本能注入、视频编解码可用;不登录、不动进度,通过则退出码 0 |
|
||||
| `--budget-minutes N`(旧名 `--budget`) | `YUN_XUE_TANG_BUDGET_MINUTES` | `budgetMinutes` | `0` | 运行 N 分钟后收尾退出(适合放进 cron 定长跑) |
|
||||
| `--restart-minutes N`(旧名 `--restart`) | `YUN_XUE_TANG_RESTART_MINUTES` | `restartMinutes` | `0` | 脚本自己停下后等待多少分钟再开新一轮;`0` = 直接退出 |
|
||||
| `--idle-restart-minutes N`(旧名 `--idle`) | `YUN_XUE_TANG_IDLE_RESTART_MINUTES` | `idleRestartMinutes` | `30` | 连续多少分钟无进展判定卡死 |
|
||||
| `--prefer-short 0\|1` | `YUN_XUE_TANG_PREFER_SHORT` | `preferShort` | `1` | 是否优先短课程(时长正序) |
|
||||
| `--points-mode 0\|1` | `YUN_XUE_TANG_POINTS_MODE` | `pointsMode` | `1` | 每日积分模式:整门课完成计 1 次,文档1/视频3/音频2/微课2,封顶即停 |
|
||||
| `--headless 0\|1`(旧名 `--visible`) | `YUN_XUE_TANG_HEADLESS` | `headless` | `1` | `1` = 无头;`0` = 开有界面浏览器(仅本机调试;无图形会话时被忽略并强制无头) |
|
||||
| `--origin URL` | `YUN_XUE_TANG_ORIGIN` | `origin` | `https://kfmic.yunxuetang.cn` | 站点根地址(换分公司环境时改这个) |
|
||||
| `--url URL` | `YUN_XUE_TANG_URL` | `url` | `<origin>/login.html` | 起始页面 |
|
||||
| `--port N` | `YUN_XUE_TANG_CDP_PORT` | `port` | `9336` | CDP 调试端口,同机多实例时分开 |
|
||||
| `--profile DIR` | `YUN_XUE_TANG_PROFILE_DIR` | `profile` | `./.run-profile` | 持久化 profile 目录,删掉即重置登录态与进度缓存 |
|
||||
| `--chrome PATH` | `YUN_XUE_TANG_CHROME_BIN` | `chrome` | 自动探测 | 指定 Chrome/Chromium 可执行文件 |
|
||||
| `--extra-args "…"` | `YUN_XUE_TANG_EXTRA_ARGS` | `extraArgs` | 空 | 追加给浏览器的命令行参数(空格分隔) |
|
||||
| `--log-file PATH`(旧名 `--log`) | `YUN_XUE_TANG_LOG_FILE` | `logFile` | `./run-logs/headless.log` | 日志文件路径 |
|
||||
| `--log-max-bytes N`(旧名 `--log-max`) | `YUN_XUE_TANG_LOG_MAX_BYTES` | `logMaxBytes` | `5242880` | 单文件上限,超出轮转 |
|
||||
| `--bark-url URL` | `YUN_XUE_TANG_BARK_URL` | `barkUrl` | 空 | Bark 推送地址(含设备 key),运行器自己收尾时推手机通知;空 = 不推送 |
|
||||
| `--bark-group NAME` | `YUN_XUE_TANG_BARK_GROUP` | `barkGroup` | 空 | Bark 通知分组(App 里按组折叠) |
|
||||
| `--bark-ttl N` | `YUN_XUE_TANG_BARK_TTL` | `barkTtl` | `0` | 通知在 Bark 服务端保留多少秒;`0` = 永久保留 |
|
||||
| `--no-tui` | `YUN_XUE_TANG_TUI` | `tui` | 开 | `1`/`0`,是否在终端显示实时面板;stdout 不是 TTY 时自动关闭 |
|
||||
| `--no-color` | `YUN_XUE_TANG_COLOR` | `color` | 开 | `1`/`0`,面板是否带 ANSI 颜色(也认 `NO_COLOR`) |
|
||||
| `--config PATH` | `YUN_XUE_TANG_CONFIG` | — | `./config/runner.config.mjs` | 指定另一个配置文件 |
|
||||
| `--help` / `-h` | — | — | — | 打印完整参数表(含配置文件字段、环境变量、当前生效值) |
|
||||
| — | `YUN_XUE_TANG_HAS_DISPLAY` | — | 自动判断 | `1`/`0` 强制认定「有无图形会话」(Linux 看 `DISPLAY`,Windows 看 `SESSIONNAME`;判断不准时用) |
|
||||
| — | `YUN_XUE_TANG_USR` / `YUN_XUE_TANG_PWD` | **不写入配置文件** | 必填 | 账号密码。故意只走环境变量:命令行会进进程列表/计划任务历史 |
|
||||
|
||||
未知参数、缺值参数、非数字值都会**直接报错并以退出码 2 退出**(不再静默忽略,避免 `--prefer-short` 拼错却以为生效了)。
|
||||
|
||||
### 配置文件
|
||||
|
||||
日常调参改 `config/runner.config.mjs` 即可,它是普通 JS 模块(可写注释、可写表达式),
|
||||
改完**不需要 `npm run build`**(构建只打包注入浏览器的 `src/`):
|
||||
|
||||
```js
|
||||
// config/runner.config.mjs
|
||||
export default {
|
||||
budgetMinutes: 0, // 0 = 不限运行时长
|
||||
preferShort: true, // 时长正序选课
|
||||
restartMinutes: 0, // 0 = 停下就退出
|
||||
idleRestartMinutes: 30,
|
||||
port: 9336,
|
||||
profile: './.run-profile',
|
||||
logFile: './run-logs/headless.log',
|
||||
tui: true, // 终端面板;false = 逐行日志
|
||||
color: true, // 面板颜色;false 或不设 NO_COLOR 都可
|
||||
};
|
||||
```
|
||||
|
||||
- 想看全部字段与当前生效值:`node runner/headless.mjs --help`
|
||||
- 想只为一个场景换配置:`node runner/headless.mjs --config ./my.mjs`
|
||||
- 个人机器的差异建议放 `runner.local.mjs`(已在 `.gitignore` 里)并用 `--config ./runner.local.mjs`
|
||||
- 配置文件里写 `username` / `password` 会被**忽略并告警**(凭据只认环境变量);写未知字段也会告警
|
||||
|
||||
### 运行提醒(Bark)
|
||||
|
||||
无头运行器会在三个时机推 [Bark](https://github.com/Finb/Bark) 手机通知(浏览器端油猴脚本不推送):
|
||||
|
||||
- **开始运行**:进程启动、预检通过后推一条,带运行模式与预算
|
||||
- **获得学分**:每刷完一门有学分的课推一条,带课程名、本门学分、本次累计
|
||||
- **结束**:正常刷完 / 达到上限 / 长时间无进展 / 连续登录失败时推一条,带今日积分、完成门数、用时和结束原因
|
||||
|
||||
```json
|
||||
[
|
||||
{
|
||||
"title": "云学堂助手:开始运行",
|
||||
"body": "正在启动浏览器并自动登录\n模式:每日积分\n运行预算:不限"
|
||||
},
|
||||
{
|
||||
"title": "云学堂助手:获得 6.52 学分",
|
||||
"body": "课程「某某课程」\n本次累计 12.75 学分 · 已完成 3 门"
|
||||
},
|
||||
{
|
||||
"title": "云学堂助手:任务完成",
|
||||
"body": "今日积分 15/24 · 文档1/1 视频3/3 音频1/2 微课0/2\n完成 4 门 · 用时 18 分 6 秒\n可用内容已学完"
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
配置(三选一,优先级从低到高):
|
||||
|
||||
```js
|
||||
// config/runner.config.mjs
|
||||
barkUrl: 'https://api.day.app/<你的设备 key>', // 也接受带 {title}/{body} 的完整模板
|
||||
barkGroup: '云学堂助手', // 通知分组
|
||||
barkTtl: 0, // 服务端保留秒数,0 = 永久保留
|
||||
```
|
||||
|
||||
```sh
|
||||
YUN_XUE_TANG_BARK_URL=https://api.day.app/<key> YUN_XUE_TANG_BARK_GROUP=云学堂助手 node runner/headless.mjs
|
||||
```
|
||||
|
||||
```sh
|
||||
# 环境变量优先级最高;Docker 里写进 .env 即可(.env 不入库)
|
||||
YUN_XUE_TANG_BARK_URL=https://api.day.app/<key>
|
||||
```
|
||||
|
||||
- 手动 `Ctrl+C` 主动停止**不推送**(人在终端前,不需要再提醒);`--check` 自检也不推送。
|
||||
- 推送失败只在日志里告警(网络不通 / key 错),不影响运行器退出码。
|
||||
- 配了 `restartMinutes` 时,重复的同一结论(例如「今日积分已学完」)只推一次,不会每轮刷屏。
|
||||
- `--help` 与启动日志里的 key 会打码成 `/***`,避免日志泄露推送权限。
|
||||
|
||||
退出码:`0` 正常收尾(`budgetMinutes` 到点 / 今日积分完成 / 无更多可学课程)、`1` 无进展卡死、
|
||||
`2` 环境或参数问题(缺构建产物、缺凭据、找不到浏览器、端口被占、参数写错)、`3` 连续 5 次登录失败(见 runner/)
|
||||
(多半是密码错误或站点要求验证码)。
|
||||
|
||||
无图形环境常见的坑:
|
||||
|
||||
| 现象 | 平台 | 原因与处理 |
|
||||
| --- | --- | --- |
|
||||
| 启动报 `Missing X server or $DISPLAY` | Linux | 有界面模式需要显示服务。运行器已自动判断:无 `DISPLAY` 强制无头 |
|
||||
| `Running as root without --no-sandbox is not supported` | Linux | 运行器在 Linux 上默认加 `--no-sandbox --disable-setuid-sandbox` |
|
||||
| 标签页莫名崩溃 / `Target closed` | Linux 容器 | `/dev/shm` 太小(默认 64MB)。运行器自动加 `--disable-dev-shm-usage` |
|
||||
| 中文显示成方块 | Linux | 只影响截图观感(脚本靠 DOM 文本匹配,不依赖字体)。需要截图时 `apt install fonts-noto-cjk` |
|
||||
| 视频一直 0 秒、`error.code=4` | 全平台 | 该 Chromium 不带 H.264/AAC 专有编解码器。Linux 上改装 `google-chrome-stable`(官方包带);Windows 上用官方 Chrome/Edge 即可。`npm run headless:check` 会直接告诉你 |
|
||||
| 登录页自动登录失败 | 全平台 | 站点要求验证码/滑块时无头环境无法完成,需要人工在 `headless: false`(有界面)模式下登录一次,之后靠持久化 profile 的 cookie |
|
||||
| 端口被占 | 全平台 | 运行器会先清理「命令行带本 profile」的残留浏览器(自愈);仍被别的程序占用时按提示换 `--port`。提示命令按平台出:Linux `pkill -f "remote-debugging-port=9336"`,Windows `netstat -ano \| findstr :9336` + `taskkill /PID <PID> /T /F` |
|
||||
| `"无法创建数据目录"` / `配置文件正在使用中` | Windows | 上次浏览器被强杀后 profile 还锁着。运行器启动时会自动清理;也可手动删掉 `.run-profile`(会丢失登录态) |
|
||||
| `Ctrl+C` 后浏览器没关 | Windows | 用了任务管理器「结束任务」/ `taskkill /F` 时收尾代码不执行(TerminateProcess)。下次启动会自动清理残留进程 |
|
||||
| 面板显示错行 / 有残留字符 | 全平台 | 终端被非运行器输出(后台脚本、`echo`、另一个进程)插话会打乱面板,按 `Ctrl+L` 重绘一次即可;或用 `--no-tui` 退回逐行日志 |
|
||||
| 计划任务里一起床就退出 | Windows | 运行在 Session 0 没有桌面。运行器检测 `SESSIONNAME=Services` 后强制无头,正常;若仍失败看 `run-logs/headless.log` |
|
||||
| `'鍏?npm' 不是内部或外部命令` / `'01' 不是内部或外部命令` / `'rofile' 不是内部或外部命令` | Windows | 批处理文件里出现了**中文(非 ASCII)字符**或**裸 LF 行尾**。cmd.exe 按当前代码页逐字节读批处理,多字节字符和 LF 都会让行偏移错位,于是把一行拆成几段当命令执行。修法:`.cmd` 只用 ASCII 且必须 CRLF。`npm run check` 会直接拦下这类文件 |
|
||||
|
||||
### 容器(Docker)
|
||||
|
||||
仓库自带 `Dockerfile` / `docker-compose.yml` / `.dockerignore`,镜像里已经装好
|
||||
Node 22 与 **官方 google-chrome-stable**(不是发行版 chromium —— 后者不带 H.264/AAC,
|
||||
课程视频会一直停在 0 秒),并在构建阶段跑完 `npm run build`,所以镜像开箱即用。
|
||||
|
||||
构建镜像推荐用仓库自带的脚本,它会把国内换源、按 `package.json` 版本打标签、构建后自检
|
||||
这几件容易漏的事一趟做完(纯 `docker build` 当然也能用,下面第 1 步就是它展开后的样子):
|
||||
|
||||
```bash
|
||||
npm run docker:build # 默认标签 <包名>:<版本号> + <包名>:latest
|
||||
npm run docker:build -- --mirror # 国内网络:apt 换清华源、npm 换 npmmirror
|
||||
npm run docker:build -- --check # 构建完顺手跑一次 --check 自检
|
||||
npm run docker:build -- --dry-run # 只打印将要执行的 docker 命令,不构建
|
||||
npm run docker:build -- --help # 全部选项(--tag / --platform / --no-cache / --pull / --chrome-url …)
|
||||
Windows 下也可以直接双击 scripts\build-docker.cmd;Linux/macOS 用 ./scripts/build-docker.sh
|
||||
```
|
||||
|
||||
`APT_MIRROR` / `NPM_REGISTRY` / `CHROME_DEB_URL` 三个构建参数按 **命令行 > 环境变量 > 仓库根 `.env`**
|
||||
的优先级取值,所以也可以把它们写进 `.env` 一次配好,之后直接 `npm run docker:build`。
|
||||
|
||||
```bash
|
||||
# 1. 构建(首次约 3-5 分钟,主要是下 Chrome 的 deb)
|
||||
docker build -t yun-xue-tang-assistant .
|
||||
|
||||
# 2. 先自检:只读,不登录、不动进度,不需要账号
|
||||
docker run --rm yun-xue-tang-assistant --check
|
||||
|
||||
# 3. 正式刷课(凭据只走环境变量,别写进镜像)
|
||||
docker run -d --name yun-xue-tang \
|
||||
-e YUN_XUE_TANG_USR='你的账号' \
|
||||
-e YUN_XUE_TANG_PWD='你的密码' \
|
||||
-e YUN_XUE_TANG_BUDGET_MINUTES=60 \
|
||||
-v "$PWD/.run-profile:/app/.run-profile" \
|
||||
-v "$PWD/run-logs:/app/run-logs" \
|
||||
--shm-size=512m \
|
||||
--restart on-failure:3 \
|
||||
yun-xue-tang-assistant
|
||||
|
||||
# 4. 看日志 / 收尾
|
||||
docker logs -f yun-xue-tang # 或 tail -f run-logs/headless.log
|
||||
docker stop yun-xue-tang # SIGTERM → 暂停视频 → 停批量 → 关浏览器
|
||||
```
|
||||
|
||||
用 `docker compose` 更省事(账号写在 `.env` 里,`.env` 已在 `.gitignore`):
|
||||
|
||||
```bash
|
||||
cp .env.example .env # 填 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD
|
||||
docker compose build
|
||||
docker compose run --rm yun-xue-tang --check # 自检
|
||||
docker compose run --rm yun-xue-tang --budget-minutes 15 # 最多跑 15 分钟
|
||||
docker compose up -d # 常驻
|
||||
docker compose logs -f
|
||||
docker compose down
|
||||
```
|
||||
|
||||
需要注意的几点:
|
||||
|
||||
| 事项 | 说明 |
|
||||
| --- | --- |
|
||||
| 挂载目录 | `/app/.run-profile`(登录 cookie,**别提交**)与 `/app/run-logs`(日志)要挂出来,否则重建容器就等于重登 + 丢日志 |
|
||||
| 卷权限 | 容器内以 root 跑。用绑定挂载时宿主机目录会被写成 root 所有;想用自己的 UID 就在 compose 里加 `user: "${UID}:${GID}"`(运行器会据此自动降级沙箱参数) |
|
||||
| `/dev/shm` | 容器默认只有 64MB,`shm_size: 512m` 更稳(运行器本身也加了 `--disable-dev-shm-usage` 兜底) |
|
||||
| 沙箱 | 容器内 Chrome 沙箱受限,运行器检测到 root/容器会自动补 `--no-sandbox --disable-setuid-sandbox`,不用手写 |
|
||||
| 终端面板 | 面板要求 stdout 是 TTY,后台容器里自动关闭、退回逐行日志。想在 `docker run -it` 里看面板:`docker run -it -e YUN_XUE_TANG_TUI=1 …` |
|
||||
| 验证码 | 首个登录若被要求验证码/滑块,无头环境无法完成:先在宿主机用 `npm run headless -- --headless 0` 有界面登录一次,再把宿主机 `.run-profile` 目录挂进容器复用 cookie |
|
||||
| 时区 | 镜像默认 `TZ=Asia/Shanghai`,日志时间戳与之对齐;要改就用 `-e TZ=...` |
|
||||
| 退出码与重启策略 | 与裸机一致:`0` 正常收尾、`1` 无进展、`2` 环境/参数问题、`3` 连续登录失败。**别用 `--restart always / unless-stopped`**:它们不看退出码,刷完课(`0`)会自动重启再来一轮,形成热循环;用 `--restart on-failure:3` 这类只在失败时重试的策略 |
|
||||
| 缺凭据 | 入口脚本在**没传参数且没填凭据**时自动降级成 `--check`,避免容器无意义重启空转 |
|
||||
| Chrome 下载失败 | 国内机器常从 dl.google.com 下不动,用构建参数换镜像源:`docker build --build-arg CHROME_DEB_URL=https://你的镜像/google-chrome-stable_current_amd64.deb .` |
|
||||
| 镜像内容 | 构建阶段已跑 `npm ci` + `npm run build`,产物 `/app/yun-xue-tang-assistant.user.js` 在镜像里;`node_modules` / `.run-profile` / `run-logs` / `.env` 由 `.dockerignore` 排除在外 |
|
||||
|
||||
Linux 上不需要 Xvfb,但如果你确实想跑有界面模式(例如远程看面板、人工过验证码),
|
||||
可以 `apt install xvfb x11vnc` 后 `xvfb-run -s "-screen 0 1360x940x24" npm run headless -- --headless 0`。
|
||||
|
||||
## 开发热加载
|
||||
|
||||
源码已拆分为 `src/` 下的多个模块,构建后合成单文件脚本。改完保存即生效,不用复制粘贴、不用刷新页面。详见 [dev/README.md](dev/README.md)。
|
||||
|
||||
```powershell
|
||||
npm install # 首次需要(安装 esbuild)
|
||||
npm run build # 打包 src/ → yun-xue-tang-assistant.user.js
|
||||
npm run build:watch # 监听 src/,保存即自动重新打包
|
||||
npm run dev # 等价于 node dev/serve.mjs,默认 127.0.0.1:8899
|
||||
```
|
||||
|
||||
Windows 下也可以直接双击 [`scripts/start-dev.cmd`](scripts/start-dev.cmd)。脚本暴露 `window.__yunXueTangDispose()`,
|
||||
加载器在注入新版本前先释放旧实例(定时器、监听器、面板),因此视频播放不会被打断。
|
||||
|
||||
## 目录结构
|
||||
|
||||
```text
|
||||
README.md 说明文档(本文件)
|
||||
package.json / package-lock.json npm scripts 与依赖锁(唯一依赖:esbuild)
|
||||
.gitattributes / .gitignore 换行符与忽略规则
|
||||
Dockerfile 容器镜像:Node 22 + 官方 Chrome,构建期完成 npm run build
|
||||
docker-compose.yml 一键构建 / 自检 / 常驻(挂载 profile、日志,限制 shm 与日志大小)
|
||||
.dockerignore 镜像上下文排除 node_modules / .run-profile / run-logs / docs
|
||||
docker/
|
||||
entrypoint.sh 容器入口:建目录 → 无凭据时降级 --check → exec 运行器
|
||||
yun-xue-tang-assistant.user.js 构建产物(唯一需要安装的文件,不要手改)
|
||||
src/ 业务脚本源码(拆成多个模块,日常改这里)
|
||||
meta.js UserScript 头 + 用法注释
|
||||
config.js CFG / 常量 / VERSION
|
||||
lifecycle.js 定时器·监听器·dispose
|
||||
utils.js DOM 工具
|
||||
state.js S / R / 持久化
|
||||
panel.js 悬浮面板
|
||||
route.js 路由识别
|
||||
login.js 登录 / 一键刷课
|
||||
list.js 列表页 + 短课程优先
|
||||
player.js 播放器 / 防挂机 / 课时切换
|
||||
exam.js 考试自动空卷交卷
|
||||
exam-plan.js 考试结果页处置决策(纯函数,可单测)
|
||||
course.js 课程页主循环
|
||||
complete.js 完成 / 未完成重试 / 跳课
|
||||
index.js 主循环 / 启动 / 调试入口
|
||||
scripts/ 开发与运维脚本(不在构建产物里)
|
||||
build.mjs esbuild 打包脚本(产物写回仓库根)
|
||||
check.mjs 静态检查:node --check + 批处理纯 ASCII/CRLF 校验
|
||||
build-docker.mjs 构建镜像(换源 / 打标签 / 构建后自检,参数见 --help)
|
||||
build-docker.cmd Windows 一键构建镜像(双击即可)
|
||||
build-docker.sh Linux / macOS 构建镜像(转交 build-docker.mjs)
|
||||
start-dev.cmd Windows 一键启动本地热加载服务(双击即可)
|
||||
start-headless.cmd Windows 一键启动无头运行器(双击即可)
|
||||
runner/ 无头运行器(Linux / Windows,无图形化环境)
|
||||
headless.mjs 入口:组装 配置 → 预检 → supervisor
|
||||
config.mjs 参数 / 配置文件 / 环境变量三层合并 + --help
|
||||
platform.mjs 平台差异(图形会话、沙箱、进程树、残留清理、排查命令)
|
||||
preflight.mjs 启动前检查(产物 / Node / 凭据 / 浏览器 / 端口)
|
||||
log.mjs 终端 + 文件日志
|
||||
stop.mjs 终止信号优雅退出
|
||||
browser.mjs 浏览器探测、启动参数、陈旧锁与孤儿进程清理
|
||||
cdp.mjs 极简 CDP 客户端(Node 22+ 原生 WebSocket)
|
||||
page.mjs 页面求值封装与注入后调用的表达式
|
||||
session.mjs 单次会话:起浏览器 / 注入 / 自动重登 / 崩溃自愈
|
||||
selfcheck.mjs --check 只读环境自检
|
||||
notify.mjs Bark 手机通知(开始运行 / 获得学分 / 收尾)
|
||||
tui.mjs 终端面板(框线 + 进度条,q 退出,非 TTY 自动关闭)
|
||||
study.mjs 学习统计(本次播放时长 / 获得学分)
|
||||
supervisor.mjs 崩溃重启循环与退出码
|
||||
config/
|
||||
runner.config.mjs 无头运行器配置(日常调参改这里,不用 build)
|
||||
.env.example 账号环境变量模板(复制成 .env 后填;.env 不入库)
|
||||
dev/ 本地热加载开发工具(HTTP 服务 + 薄加载器)
|
||||
serve.mjs 本地 HTTP 服务(默认 127.0.0.1:8899)
|
||||
dev-loader.user.js Tampermonkey 里的薄加载器
|
||||
tests/ 真机测试(真实 Chrome + 真实站点)
|
||||
real-cdp.mjs 极简 CDP 客户端(三个测试共用)
|
||||
real-test.mjs 面板渲染 / 路由 / 热替换断言(只读)
|
||||
real-e2e.mjs 真实账号登录 → 列表 → 进课 → 播放
|
||||
real-run.mjs 持续跑:跨章节 / 跨课程 / 断线重启
|
||||
tui-test.mjs 终端面板自测(不用浏览器:列宽 / 截断 / 极端尺寸)
|
||||
study-test.mjs 学习统计自测(假时钟:暂停不计时 / 防重复计分)
|
||||
docs/
|
||||
reports/ 历史实跑报告
|
||||
run-report-v203.md 2026-10-19 实跑报告(v2.0.3)
|
||||
evidence/ 当前版本的证据(叙述 + 接口日志)
|
||||
archive/v2.0-snapshots/ v2.0.x 时期的原始抓取片段(仅存档)
|
||||
screenshots/ 手工挑选的展示截图(测试自动截图不进库)
|
||||
```
|
||||
|
||||
## 本机数据
|
||||
|
||||
本机数据分三层存放,按「这条信息跨会话是否还成立」区分:
|
||||
|
||||
| `localStorage` 键(用户偏好,跨会话有效) | 内容 |
|
||||
| --- | --- |
|
||||
| `yun-xue-tang-login-v1` | 勾选「记住密码」时的账号密码(base64 混淆,**不是加密**) |
|
||||
| `yun-xue-tang-auto-play-enabled` | 「当前课程自动连播」开关 |
|
||||
| `yun-xue-tang-prefer-short` | 「优先短课程(时长正序)」开关(`1` / `0`) |
|
||||
| `yun-xue-tang-daily-points-mode` | 「每日积分模式」开关(`1` / `0`) |
|
||||
| `yun-xue-tang-daily-points-v1` | 今日积分计数(按本地日期自动清零,含当天已计分的课时去重表) |
|
||||
| `yun-xue-tang-target-catalog-url` | 目标目录 URL:决定刷哪个学院/目录的课(短课程队列的缓存键也来自它) |
|
||||
| `yun-xue-tang-auto-start-after-login` | 登录后自动开始刷课的一次性标记(5 分钟内有效) |
|
||||
|
||||
| `sessionStorage` 键(本次运行,关掉标签页即清空) | 内容 |
|
||||
| --- | --- |
|
||||
| `yun-xue-tang-run-state-v3` | 本轮是否在跑、页码、当前课程、本轮已完成 / 待重试 / 已跳过(考试交不了)记录 |
|
||||
| `yun-xue-tang-short-catalog-v1` | 短课程时长队列缓存(TTL 5 分钟) |
|
||||
| `yun-xue-tang-points-inventory-v1` | 文档/音频/微课单条内容库存缓存(TTL 5 分钟) |
|
||||
|
||||
旧版本(v2.8.0 之前)把所有状态整块存在 `localStorage` 的 `yun-xue-tang-batch-v2` 里,
|
||||
包括「是否在跑」。现在这个键只在启动时做一次性迁移:只迁进度(已完成书目、
|
||||
待重试、页码、目标目录),**不再恢复运行状态与当前课程**,迁移完即删除。
|
||||
|
||||
无头运行时这些键存在 `./.run-profile/` 下的浏览器 profile 里(不在仓库、不入库),
|
||||
删掉该目录即等于「清空登录态 + 重置进度」。
|
||||
|
||||
公用电脑请不要勾选「记住密码」;面板上的「清除密码」可随时删除本机保存的凭据。
|
||||
|
||||
## 已知限制
|
||||
|
||||
- 平台按真实播放时长计时,倍速/快进不会减少所需时间;脚本不提供这类加速。
|
||||
- 直接改 URL 或刷新课程页时,脚本优先用 URL 里的 `kngId` 校验课程;只有 URL 没有 id、
|
||||
且页面标题超过 30 秒仍是 `loading...` 时才可能误判并回到列表。从列表正常进入不受影响。
|
||||
- 验证码、滑块、拼图类验证需要人工完成,脚本不会绕过。
|
||||
- 平台存在同名课程(同一门课出现在多个目录)。脚本按课程 id 精确点击,但完成/重试记录仍沿用
|
||||
按标题去重的旧逻辑,同名课程不会重复安排。
|
||||
- 平台改版(目录结构、弹窗、倒计时文案、列表接口字段、完成文案变化)可能导致识别失败,
|
||||
需要更新选择器/完成判定。
|
||||
|
||||
## 免责声明
|
||||
|
||||
本项目仅用于个人学习自动化实践。请遵守所在单位与平台的使用规定,是否使用及由此产生的后果由使用者自行承担。
|
||||
|
||||
## 实跑记录
|
||||
|
||||
真实站点(`kfmic.yunxuetang.cn`)的完整实跑过程、发现的问题与修复记录见 [`docs/reports/run-report-v203.md`](docs/reports/run-report-v203.md),
|
||||
证据文件在 [`docs/evidence/`](docs/evidence/),截图在 [`docs/screenshots/`](docs/screenshots/)。
|
||||
|
||||
v2.5.2 修复「进入课程不从第一个未学完的课时开始」的定位过程、复刻用例与修复前后对比,
|
||||
见 [`docs/evidence/align-start-evidence.txt`](docs/evidence/align-start-evidence.txt)。
|
||||
|
||||
v2.6.0 新增「优先短课程(时长正序)」:真实站点读取 5148 门课程、跨页跳到最短课程所在页的
|
||||
实跑记录与 3 个回归用例,见 [`docs/evidence/short-course-evidence.txt`](docs/evidence/short-course-evidence.txt);
|
||||
面板效果见 [`docs/screenshots/panel-short.png`](docs/screenshots/panel-short.png)。
|
||||
|
||||
v2.8.0 状态分层重构:刷课开关不再进 localStorage(修「还没登录就开始刷课」)、字段名语义化、
|
||||
短课程模式下页码导航所有权归一到 `chooseShortCourse`(省掉每次多跳一页+白等 3.5 秒)。
|
||||
|
||||
每日积分模式:整门课完成计 1 次(文档1 / 视频3 / 音频2 / 微课2),每次 3 分封顶 24 分;
|
||||
多课时课程按今天实际学过的课时类型归类,只剩考试的老课不计分;先补文档/音频/微课单条内容,
|
||||
视频靠课程;某类满额自动换下一类,四类都满或无内容即停。计数落 localStorage 并跨天清零,
|
||||
面板与无头 TUI 都显示今日积分。离线回归见 `node dev/tests/points-test.mjs`(`npm run test:points`)。
|
||||
|
||||
v2.7.0 修复「进入课程有概率不自动播放」和「学完后不转下一门」:新增单视频/音频/课件播放页识别,
|
||||
完成判定同时支持 `已完成 x/y`、`已完成 N%`、`已完成学习`;真机复现、修复前后对比与回归结果见
|
||||
[`docs/evidence/completion-next-evidence.txt`](docs/evidence/completion-next-evidence.txt)。
|
||||
|
||||
无头运行(Linux 服务器 / Windows 无人值守):新增 `runner/`,自己起无头 Chromium + CDP 注入,
|
||||
持久化登录、掉登录自动重登、崩溃自愈;环境自检、真实刷课、断线重启、优雅退出的实跑记录见
|
||||
[`docs/evidence/headless-linux-evidence.txt`](docs/evidence/headless-linux-evidence.txt),
|
||||
平台差异与 Windows 侧适配见其中「九、跨平台适配」一节。
|
||||
@@ -1,69 +0,0 @@
|
||||
/**
|
||||
* 无头运行器配置文件(JS 模块,可以写注释、也可以写表达式)。
|
||||
*
|
||||
* 生效优先级(后者覆盖前者):
|
||||
* 内置默认值 < 本文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数 --x
|
||||
*
|
||||
* 账号密码不在这里:仍然只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,
|
||||
* 这样本文件可以放心提交,也不会出现在 `ps` / 任务管理器 / 计划任务历史里。
|
||||
*
|
||||
* 改完直接重新运行 `node runner/headless.mjs` 即生效,不需要 npm run build
|
||||
* (build 只打包注入浏览器的 src/ 脚本)。
|
||||
*
|
||||
* 每一项的覆盖方式见 README「无头运行 → 配置文件」;`--help` 会打印带默认值的完整清单。
|
||||
*/
|
||||
export default {
|
||||
// ---------- 选课 / 刷课策略 ----------
|
||||
/** 运行多少分钟后收尾退出;0 = 不限(适合 cron 定长跑时设成 60) */
|
||||
budgetMinutes: 0,
|
||||
/** 优先总时长最短的课程(正序);false = 按列表原顺序 */
|
||||
preferShort: true,
|
||||
/** 每日积分模式:整门课完成计 1 次(文档1/视频3/音频2/微课2,每次3分),四类封顶即停;false = 普通刷课 */
|
||||
pointsMode: true,
|
||||
/** 脚本自己停下后等多少分钟再开新一轮;0 = 直接退出。配合 restartMinutes 可以分段刷完 */
|
||||
restartMinutes: 0,
|
||||
/** 连续多少分钟没有任何进展就判定卡死并退出(0 = 用内置的 30 分钟) */
|
||||
idleRestartMinutes: 30,
|
||||
|
||||
// ---------- 站点 / 浏览器 ----------
|
||||
/** 站点根地址(换分公司环境只改这一行) */
|
||||
origin: 'https://kfmic.yunxuetang.cn',
|
||||
/** 起始页面;留空 = <origin>/login.html */
|
||||
url: '',
|
||||
/** CDP 调试端口;同机跑多个实例时分开 */
|
||||
port: 9336,
|
||||
/** true = 无头(默认);false = 开有界面浏览器,需要图形会话,没有时会被强制无头 */
|
||||
headless: true,
|
||||
/** Chrome/Chromium 可执行文件路径;留空 = 自动探测 */
|
||||
chrome: '',
|
||||
/** 追加给浏览器的命令行参数(空格分隔),例如 '--proxy-server=socks5://127.0.0.1:1080' */
|
||||
extraArgs: '',
|
||||
|
||||
// ---------- 文件 / 日志 ----------
|
||||
/** 持久化 profile 目录(cookie / localStorage);留空 = ./.run-profile,删掉即重置登录态 */
|
||||
profile: './.run-profile',
|
||||
/** 日志文件;留空 = ./run-logs/headless.log */
|
||||
logFile: './run-logs/headless.log',
|
||||
/** 单个日志文件上限(字节),超出后轮转成 .1 */
|
||||
logMaxBytes: 5 * 1024 * 1024,
|
||||
|
||||
// ---------- 运行提醒(Bark) ----------
|
||||
/**
|
||||
* 开始运行 / 每门课获得学分 / 收尾时各推一条手机通知。
|
||||
* 填 Bark App 里的推送地址(含设备 key),留空 = 不推送。
|
||||
* 也可以只写带占位符的完整模板:https://api.day.app/<key>/{title}/{body}
|
||||
* 注意:这个 key 等于「谁能往你手机推通知」,不要写进仓库;
|
||||
* 实际使用请设环境变量 YUN_XUE_TANG_BARK_URL(.env 不入库)。
|
||||
*/
|
||||
barkUrl: '',
|
||||
/** 通知分组(Bark App 里把同一组折叠在一起),留空 = Bark 默认 */
|
||||
barkGroup: '云学堂助手',
|
||||
/** 通知在 Bark 服务端保留多少秒;0 = 永久保留(不传 ttl 参数) */
|
||||
barkTtl: 0,
|
||||
|
||||
// ---------- 终端面板 ----------
|
||||
/** 终端里显示实时面板(框线 + 进度条);false = 回到逐行日志。非 TTY(重定向/计划任务)时自动关闭 */
|
||||
tui: true,
|
||||
/** 面板是否带 ANSI 颜色;false = 只用框线和符号。也认 NO_COLOR 环境变量 */
|
||||
color: true,
|
||||
};
|
||||
-168
@@ -1,168 +0,0 @@
|
||||
# 开发热加载(保存即生效)
|
||||
|
||||
目标:在编辑器里改 `src/` 下的源码模块,保存后自动重新打包,浏览器里的脚本自动换成新版本,
|
||||
**不用复制粘贴、不用重装、不用刷新页面**。
|
||||
|
||||
## 结构
|
||||
|
||||
`dev/` 只放「在浏览器里跑」的开发工具(HTTP 服务 + 薄加载器 + 真机测试),
|
||||
构建与检查脚本在 `../scripts/`,运行器配置在 `../config/`。
|
||||
|
||||
| 文件 | 作用 |
|
||||
| --- | --- |
|
||||
| `../src/` | 业务脚本源码(拆成多个模块,改这里) |
|
||||
| `../scripts/build.mjs` | 用 esbuild 把 `src/` 打包成单文件 `.user.js`(产物写在仓库根,热加载链路无需改动) |
|
||||
| `../yun-xue-tang-assistant.user.js` | **构建产物**(不要手改,改 `src/` 后 `npm run build`) |
|
||||
| `serve.mjs` | 本地 HTTP 服务,向浏览器提供源码与版本哈希(127.0.0.1:8899) |
|
||||
| `dev-loader.user.js` | Tampermonkey 里的薄加载器,轮询版本、释放旧实例、注入新实例 |
|
||||
| `tests/` | 测试脚本(真机测试 + 终端面板纯函数测试,见下方「真机测试」) |
|
||||
| `../scripts/start-dev.cmd` | 双击启动服务 |
|
||||
| `../scripts/check.mjs` | `npm run check` 的实现:自动遍历 `runner/`、`dev/`、`scripts/`、`config/` 跑 `node --check`,同时检查 `.cmd` 必须是纯 ASCII + CRLF(cmd.exe 逐字节按代码页读批处理,中文和裸 LF 会让行偏移错位);新增模块不用再手改命令 |
|
||||
|
||||
原理:加载器每 1 秒请求 `/version`,发现哈希变化就调用旧实例暴露的
|
||||
`window.__yunXueTangDispose()`(清定时器 / 监听器 / 面板),再把新源码以 `<script>` 形式注入页面主世界。
|
||||
因为脚本依赖页面里的 `__vue__`(登录组件),注入必须发生在主世界,不能走普通沙箱。
|
||||
|
||||
## 一次性安装
|
||||
|
||||
1. 双击 `scripts/start-dev.cmd` 启动本地服务(保持窗口开着)。
|
||||
2. 浏览器打开 <http://127.0.0.1:8899/>,点「安装 / 更新热加载器」,Tampermonkey 弹窗确认安装。
|
||||
> 手动方式:Tampermonkey 面板 → 添加新脚本 → 粘贴 `dev/dev-loader.user.js` 全文 → 保存。
|
||||
3. **停用或删除** Tampermonkey 里原来那份「云学堂助手」完整脚本。
|
||||
(两份同时跑会出现两个面板、双份定时器,行为会乱。)
|
||||
4. 打开 <https://kfmic.yunxuetang.cn/login.html>,F12 控制台应看到:
|
||||
`[云学堂·热加载] 已注入 xxxxx 字节源码`。
|
||||
|
||||
## 日常使用
|
||||
|
||||
- 改完 `src/` 下的模块保存 → `npm run build:watch` 自动重新打包,约 1 秒内页面控制台打印
|
||||
`[云学堂·热加载] 热更新 → <新哈希>`,面板会重建,视频播放不中断。
|
||||
- 列表刷课的进度存在 `localStorage`(`yun-xue-tang-batch-v2`),热替换 / 刷新都不会丢。
|
||||
- 改坏了(语法错误):构建失败,加载器会拒绝注入并弹出左下角红条提示,**旧版本继续运行**,修好再保存即可。
|
||||
- 想完全回到「手动刷新才生效」:把加载器里的 `MODE` 改成 `'reload'`。
|
||||
|
||||
## 真机测试
|
||||
|
||||
在**真实浏览器 + 真实云学堂页面**上验证脚本,不靠 Node 里的 DOM 桩。
|
||||
|
||||
```bash
|
||||
npm run build # 先出产物
|
||||
npm run test:real # 有界面 Chrome,能看见面板真实渲染
|
||||
npm run test:real:headless # 无头模式(CI / 无人值守)
|
||||
node dev/tests/real-test.mjs --keep # 跑完不关浏览器,便于人工复核
|
||||
```
|
||||
|
||||
### 终端面板自测(不用浏览器)
|
||||
|
||||
`runner/tui.mjs` 有个不联网、不开浏览器的纯函数测试;`runner/study.mjs` 的学时/学分累计也有一份(带假时钟):
|
||||
|
||||
```bash
|
||||
npm run test:tui # 面板渲染 / 列宽 / 尺寸自适应
|
||||
npm run test:study # 学习时长与学分累计口径
|
||||
npm run test:points # 每日积分:类型识别 / 封顶 / 去重 / 跨天清零 / 选类顺序
|
||||
```
|
||||
|
||||
它用假 stdout 渲染真实帧,逐行量列宽,重点盯五件容易错的事:
|
||||
- 中文/全角/emoji 占 2 列,ANSI 转义序列占 0 列(算错边框就歪、中文被劈成半个);
|
||||
- 截断到指定列宽时要补 `\x1b[0m`,否则颜色会溢出到下几行;
|
||||
- 尺寸自适应:宽度直接跟终端(240 列终端框线就是 240),从 40 行到 8 行的每种高度都不超出窗口,矮到 15 行时自动省掉课时/日志行但仍保留学时与视频进度;
|
||||
- 没有 `resize` 事件的平台(Windows 传统控制台):完全不发事件也能在定时刷新里发现尺寸变化,最大化后框线跟着变宽、缩小后自动清整块重画(不会把旧帧的尾巴留在屏上),尺寸没变时不多做一次清屏;
|
||||
- 折行感知的回退:终端变窄时会把宽行重排成多行,所以按「旧帧在新宽度下的可视行数」算回退步数;如果折完比窗口还高(最大化后还原)就整屏重置(`Esc[H` + `Esc[2J`),否则旧面板的上半截会永远留在屏幕上;小幅变窄(折完仍装得下)走精确回退,不丢上方历史;
|
||||
- 36 列窄终端 / 8 行矮终端下不崩、不超界;缩窗(100×24 → 60×12)后硬重绘的回退步数受新窗口高限制,不会把上面历史顶出屏幕;
|
||||
- 学时/学分累计:暂停时不计时、播放中按两帧间隔累加、倒计时元素消失后沿用学分缓存、完成数没变不重复计分、换课后重新读分。
|
||||
|
||||
`study-test.mjs` 用假时钟(不依赖真实时间)把口径钉死:
|
||||
- 暂停 30 秒一点都不计、
|
||||
- 两帧间隔超过 60 秒(浏览器重启 / 进程挂起)直接丢弃不补计、
|
||||
- 同一门课重复完成不重复计分、没读到学分的课完成后不瞎加分、
|
||||
- `0.1 + 0.2` 这种浮点累加输出成 `0.3` 而不是 `0.30000000000000004`。
|
||||
|
||||
另外还断言了「禁用时是空操作」(上层可以无条件调 `tui.set()`)和
|
||||
「`finish()` 只生效一次且会恢复光标」。改面板布局后先跑这个,比真机跑一轮快得多。
|
||||
|
||||
三个真机脚本(`dev/tests/real-test.mjs` / `real-e2e.mjs` / `real-run.mjs`)会自动适配当前平台:
|
||||
没有图形会话时强制 `--headless=new`(即使没传 `--headless`),并补上该平台需要的参数
|
||||
(Linux:`--no-sandbox --disable-setuid-sandbox --disable-dev-shm-usage`;Windows:不弹崩溃恢复气泡),
|
||||
因此可以原样在无图形化服务器 / 容器 / CI / Windows 后台里跑。平台判断复用
|
||||
`runner/platform.mjs`,不在这里重复实现。
|
||||
|
||||
> 想在生产环境长期无头挂机(持久化登录、掉登录自动重登、崩溃自愈),用 `runner/headless.mjs`,
|
||||
> 见主 README 的「无头运行(Linux / Windows 服务器)」。
|
||||
|
||||
原理:用独立临时用户目录启动 Chrome(不影响日常配置),开 CDP 端口后新建标签页打开
|
||||
`https://kfmic.yunxuetang.cn/login.html`,把 `yun-xue-tang-assistant.user.js` 注入页面主世界
|
||||
(等价 Tampermonkey `@grant none`),然后在真实 DOM 上断言:
|
||||
|
||||
| 断言 | 说明 |
|
||||
| --- | --- |
|
||||
| 面板渲染 | `#yun-xue-tang-panel` 可见、`position:fixed`、距右下各 16px、含密码框与 4 个按钮 |
|
||||
| 版本号 | `#yun-xue-tang-version` = `v2.7.0`(与 package.json 一致) |
|
||||
| 页面识别 | 真实登录页 `isLoginPage() === true`、`readSummary/readCountdown` 安全返回 `null` |
|
||||
| 点击不崩 | 真点「一键登录并刷课」后脚本仍存活、无自身 error 日志 |
|
||||
| 持久化 | 真实 `localStorage` 可读写 |
|
||||
| 热替换 | `__yunXueTangDispose()` 后真实 DOM 面板移除、`__yunXueTangAuto` 被删;再注入面板唯一 |
|
||||
| 路由 | SPA 内改 `location.hash` 后 `route()` 自动跟随,无需重新注入 |
|
||||
| 整页重定向 | 未登录访问 `#/list` 被站点跳回登录页(新 document),脚本无残留、重注入后正常 |
|
||||
|
||||
产物:截图存到 `.run-tmp/screenshots/real-chrome-login.png`(测试产物不入库,`--shotdir` / `YUN_XUE_TANG_SHOT_DIR` 可改)。
|
||||
|
||||
需要 Node 22+(全局 `WebSocket` / `fetch`),无需 puppeteer / playwright。
|
||||
测试**只读**:不填账号密码、不点登录、不改线上数据。
|
||||
|
||||
## 真机登录 / 进课测试(E2E)
|
||||
|
||||
带**真实账号**跑完整媒体链路。凭据从环境变量读,不写进代码、不打印明文:
|
||||
|
||||
```bash
|
||||
# 环境变量(已在当前环境配置)
|
||||
# YUN_XUE_TANG_USR 员工邮箱 / 账号
|
||||
# YUN_XUE_TANG_PWD 密码
|
||||
|
||||
npm run test:e2e # 登录 + 列表;默认只读,不碰学习进度
|
||||
npm run test:e2e:play # 额外进入最短的未学完课程,采样 25 秒后立即暂停
|
||||
npm run test:e2e:play -- --seconds 60
|
||||
node dev/tests/real-e2e.mjs --headless # 无头
|
||||
node dev/tests/real-e2e.mjs --keep # 跑完不关浏览器
|
||||
```
|
||||
|
||||
覆盖的断言(`--play` 时是 19 项,否则 12 项):
|
||||
|
||||
| 阶段 | 断言 |
|
||||
| --- | --- |
|
||||
| 登录页 | 脚本注入、识别到账号/密码框、`setNativeValue` 写入真实输入框值一致、隐私政策勾选 |
|
||||
| 登录 | 真点「一键登录并刷课」后**真正登录成功**(离开登录页);无脚本 error |
|
||||
| 新 document | 登录是整页跳转,模拟 Tampermonkey 按 `@match` 重新注入后面板恢复 |
|
||||
| 列表 | 16 张卡片(共 322 页)、`scanCards` 标题/状态解析、Vue 组件 `kngListData` 可读、`studyHours` 时长可用 |
|
||||
| 进课(`--play`)| 挑**最短的未学完课程**进入(减少对真实进度影响)、`readSummary`/`readCountdown`/`lessonItems` 读到真实数据 |
|
||||
| 播放(`--play`)| 真实 `<video>` 被接管:`muted=true`、`playbackRate=1`、`paused=false`、`currentTime` 真实推进 |
|
||||
| 收尾 | 立即 `pauseAllMedia` + `S.batchRunning=false`,`__yunXueTangDispose()` 后面板/API 清理干净 |
|
||||
|
||||
行为与安全:
|
||||
- 不加 `--play` 时会在登录成功后**立即停用列表刷课**(清 `yun-xue-tang-auto-start-after-login`、`S.batchRunning=false`),
|
||||
避免在真实账号上意外推进课程。
|
||||
- 加 `--play` 只采样默认 25 秒就暂停并释放,不会把整节课刷完;结束时会打印进度快照(如
|
||||
`进入前「已完成2/3」→ 采样后「已完成2/3」`)便于核对是否被改动。
|
||||
- 实测:进课 `2025坚持的力量`(273s 的第 3 节)采样 25 秒,`currentTime` 推进到 63s,进度保持 `2/3` 未变。
|
||||
|
||||
> 登录后收集的日志里会出现一条 `填写账号密码后,点「一键登录并刷课」`,这是
|
||||
> `loginPageTick` 轮询刷新状态文案造成的噪声(发生在点击登录之前),不影响登录结果。
|
||||
|
||||
## 常见问题
|
||||
|
||||
| 现象 | 处理 |
|
||||
| --- | --- |
|
||||
| 左下角红条「未连上本地开发服务」 | 服务没启动,或端口被占用;运行 `scripts/start-dev.cmd` |
|
||||
| 改完没反应 | 看控制台是否有 `热更新` 日志;确认 `npm run build:watch` 在跑,改的是 `src/` 下的模块 |
|
||||
| 页面出现两个面板 | 旧完整脚本没停用,去 Tampermonkey 停用它 |
|
||||
| 端口冲突 | `node dev/serve.mjs 8900`,同时把加载器里的 `SERVER` 常量改成对应端口 |
|
||||
| 服务没开也想用 | 加载器回退到上次缓存的源码(`GM_getValue('yun-xue-tang-dev-src')`) |
|
||||
|
||||
## 关闭开发模式
|
||||
|
||||
停用热加载器 + 重新安装一次完整脚本(把构建产出的 `.user.js` 全文粘进 Tampermonkey)即可。
|
||||
脚本本身不依赖任何本地服务,`@grant none`,可独立运行。
|
||||
|
||||
## 开机自启(可选)
|
||||
|
||||
把 `scripts/start-dev.cmd` 的快捷方式放进
|
||||
`%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup`,开机即后台常驻。
|
||||
@@ -1,215 +0,0 @@
|
||||
// ==UserScript==
|
||||
// @name 云学堂助手 · 开发热加载器
|
||||
// @namespace yxt.assistant.local
|
||||
// @version 1.0.0
|
||||
// @description 从本机 http://127.0.0.1:8899 拉取 yun-xue-tang-assistant.user.js,保存文件后约 1 秒内自动热替换,免复制粘贴
|
||||
// @author local
|
||||
// @match *://*.yunxuetang.cn/*
|
||||
// @grant GM_xmlhttpRequest
|
||||
// @grant GM_getValue
|
||||
// @grant GM_setValue
|
||||
// @grant unsafeWindow
|
||||
// @connect 127.0.0.1
|
||||
// @connect localhost
|
||||
// @run-at document-idle
|
||||
// ==/UserScript==
|
||||
|
||||
/*
|
||||
* 这是「开发期」用的薄加载器,本身不含业务逻辑:
|
||||
* 1. 页面加载时从本地开发服务拉取最新源码并注入页面主世界;
|
||||
* 2. 每 1 秒问一次 /version,哈希变了就「先释放旧实例、再注入新实例」;
|
||||
* 3. 服务没开时回退到上一次缓存的源码,保证照常可用;
|
||||
* 4. 新源码语法错误时拒绝注入,旧实例继续运行(不会把页面搞挂)。
|
||||
*
|
||||
* 依赖:先运行 scripts/start-dev.cmd(或 node dev/serve.mjs)启动本地服务。
|
||||
* 生效方式:MODE = 'hot' 不刷新页面;'reload' 变更后整页刷新。
|
||||
*/
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const SERVER = 'http://127.0.0.1:8899';
|
||||
const MODE = 'hot'; // 'hot' | 'reload'
|
||||
const POLL_MS = 1000; // 轮询间隔
|
||||
const RETRY_MS = 15000; // 服务不可用时的重试间隔
|
||||
const CACHE_KEY = 'yun-xue-tang-dev-src'; // 最近一次成功拉取的源码
|
||||
const TAG = '[云学堂·热加载]';
|
||||
const isTop = (function () {
|
||||
try { return window.top === window.self; } catch (e) { return true; }
|
||||
})();
|
||||
|
||||
const page = (typeof unsafeWindow !== 'undefined' && unsafeWindow) ? unsafeWindow : window;
|
||||
|
||||
let appliedHash = '';
|
||||
let failures = 0;
|
||||
let timer = 0;
|
||||
|
||||
// ---------- 网络 ----------
|
||||
function httpGet(url, timeoutMs) {
|
||||
return new Promise(function (resolve, reject) {
|
||||
if (typeof GM_xmlhttpRequest !== 'function') {
|
||||
reject(new Error('GM_xmlhttpRequest 不可用(请检查脚本授权)'));
|
||||
return;
|
||||
}
|
||||
GM_xmlhttpRequest({
|
||||
method: 'GET',
|
||||
url: url + (url.indexOf('?') < 0 ? '?' : '&') + '_=' + Date.now(),
|
||||
timeout: timeoutMs || 8000,
|
||||
headers: { 'Cache-Control': 'no-cache', Pragma: 'no-cache' },
|
||||
onload: function (r) {
|
||||
if (r.status >= 200 && r.status < 300) resolve(r.responseText || '');
|
||||
else reject(new Error('HTTP ' + r.status));
|
||||
},
|
||||
onerror: function () { reject(new Error('无法连接 ' + SERVER)); },
|
||||
ontimeout: function () { reject(new Error('请求超时')); },
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
// ---------- 注入 ----------
|
||||
function syntaxErrorOf(src) {
|
||||
try {
|
||||
new Function(src); // 只编译不执行,用来提前发现语法错误
|
||||
return null;
|
||||
} catch (e) {
|
||||
if (e && e.name === 'SyntaxError') return e;
|
||||
return null; // 环境不允许 eval 时跳过校验
|
||||
}
|
||||
}
|
||||
|
||||
function disposePrevious() {
|
||||
try {
|
||||
if (page && typeof page.__yunXueTangDispose === 'function') {
|
||||
page.__yunXueTangDispose();
|
||||
return true;
|
||||
}
|
||||
} catch (e) {
|
||||
console.warn(TAG, '旧实例释放失败', e);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
function inject(src) {
|
||||
const el = document.createElement('script');
|
||||
el.type = 'text/javascript';
|
||||
el.setAttribute('data-yun-xue-tang-dev-injected', '1');
|
||||
el.textContent = src;
|
||||
(document.head || document.documentElement).appendChild(el);
|
||||
el.remove();
|
||||
}
|
||||
|
||||
function apply(src) {
|
||||
if (!src || src.length < 500) {
|
||||
console.error(TAG, '拉到的源码异常(长度 ' + String(src && src.length) + '),已忽略');
|
||||
return false;
|
||||
}
|
||||
const err = syntaxErrorOf(src);
|
||||
if (err) {
|
||||
console.error(TAG, '新源码有语法错误,保留旧实例:', err);
|
||||
badge('新代码语法错误:' + err.message);
|
||||
return false;
|
||||
}
|
||||
|
||||
const hadInstance = !!(page && (page.__yunXueTangAuto || document.getElementById('yun-xue-tang-panel')));
|
||||
const disposed = disposePrevious();
|
||||
// 首次注入不存在旧实例,直接注入;之后若旧实例没有 __yunXueTangDispose 或指定了 reload 模式,才刷新整页
|
||||
if (hadInstance && (MODE === 'reload' || !disposed)) {
|
||||
console.log(TAG, MODE === 'reload' ? '源码变更,刷新页面' : '旧实例无 __yunXueTangDispose,刷新页面');
|
||||
location.reload();
|
||||
return false;
|
||||
}
|
||||
|
||||
try {
|
||||
inject(src);
|
||||
GM_setValue(CACHE_KEY, src);
|
||||
clearBadge();
|
||||
console.log(TAG, '已注入 ' + src.length + ' 字节源码');
|
||||
if (isTop && !page.__yunXueTangAuto && !document.getElementById('yun-xue-tang-panel')) {
|
||||
// 站点 CSP 若禁掉 inline script,退一步用页面主世界的 eval(需要 unsafe-eval)
|
||||
try { page.eval(src); } catch (e) { /* 两种方式都不行再看下一条 */ }
|
||||
if (!page.__yunXueTangAuto && !document.getElementById('yun-xue-tang-panel')) {
|
||||
badge('源码已注入但未生效:页面 CSP 可能拦截了注入,请查看控制台');
|
||||
}
|
||||
}
|
||||
return true;
|
||||
} catch (e) {
|
||||
console.error(TAG, '注入失败:', e);
|
||||
badge('注入失败:' + (e && e.message ? e.message : e));
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 失败提示 ----------
|
||||
let badgeEl = null;
|
||||
function badge(msg) {
|
||||
if (!isTop) return;
|
||||
try {
|
||||
if (!badgeEl) {
|
||||
badgeEl = document.createElement('div');
|
||||
badgeEl.style.cssText = [
|
||||
'position:fixed', 'left:12px', 'bottom:12px', 'z-index:2147483647',
|
||||
'background:#7d2f2f', 'color:#fff', 'padding:6px 10px', 'border-radius:6px',
|
||||
'font:12px/1.5 system-ui,"Microsoft YaHei",sans-serif', 'max-width:420px',
|
||||
'box-shadow:0 4px 14px rgba(0,0,0,.35)', 'white-space:pre-wrap',
|
||||
].join(';');
|
||||
document.body.appendChild(badgeEl);
|
||||
}
|
||||
badgeEl.textContent = TAG + ' ' + msg;
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
function clearBadge() {
|
||||
if (badgeEl && badgeEl.parentNode) badgeEl.parentNode.removeChild(badgeEl);
|
||||
badgeEl = null;
|
||||
}
|
||||
|
||||
// ---------- 轮询 ----------
|
||||
function schedule(ms) {
|
||||
clearTimeout(timer);
|
||||
timer = setTimeout(poll, ms || (failures ? RETRY_MS : POLL_MS));
|
||||
}
|
||||
|
||||
function poll() {
|
||||
httpGet(SERVER + '/version', 4000).then(function (body) {
|
||||
failures = 0;
|
||||
let v;
|
||||
try { v = JSON.parse(body); } catch (e) { return; }
|
||||
if (!v || !v.hash || v.hash === appliedHash) return;
|
||||
return httpGet(SERVER + '/src').then(function (src) {
|
||||
if (apply(src)) {
|
||||
appliedHash = v.hash;
|
||||
console.log(TAG, '热更新 → ' + v.hash);
|
||||
} else {
|
||||
appliedHash = v.hash; // 坏版本不再反复重试,修好后再变哈希
|
||||
}
|
||||
});
|
||||
}).catch(function (e) {
|
||||
failures++;
|
||||
if (failures === 1) console.warn(TAG, '开发服务不可用,稍后重试:', e.message);
|
||||
}).then(function () {
|
||||
schedule();
|
||||
});
|
||||
}
|
||||
|
||||
// ---------- 启动 ----------
|
||||
function boot() {
|
||||
httpGet(SERVER + '/version', 3000).then(function (body) {
|
||||
const v = JSON.parse(body);
|
||||
return httpGet(SERVER + '/src').then(function (src) {
|
||||
appliedHash = v.hash || '';
|
||||
return apply(src);
|
||||
});
|
||||
}).catch(function (e) {
|
||||
const cached = GM_getValue(CACHE_KEY, '');
|
||||
if (cached) {
|
||||
console.warn(TAG, '开发服务不可用,使用缓存源码:', e.message);
|
||||
apply(cached);
|
||||
} else {
|
||||
console.error(TAG, '开发服务不可用且无缓存。请先运行 scripts/start-dev.cmd');
|
||||
badge('未连上本地开发服务(' + SERVER + ')\n请运行 scripts/start-dev.cmd');
|
||||
}
|
||||
}).then(function () {
|
||||
if (isTop) schedule(POLL_MS);
|
||||
});
|
||||
}
|
||||
|
||||
boot();
|
||||
})();
|
||||
-153
@@ -1,153 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 云学堂助手 · 本地开发服务器
|
||||
*
|
||||
* 作用:把工作目录里的 yun-xue-tang-assistant.user.js 暴露给浏览器里的
|
||||
* Tampermonkey 热加载器(dev/dev-loader.user.js)拉取。
|
||||
*
|
||||
* 端点:
|
||||
* GET / 说明页
|
||||
* GET /src 最新脚本源码(no-store)
|
||||
* GET /version { hash, size, mtime },热加载器靠 hash 判断是否变更
|
||||
* GET /loader.user.js 热加载器本体(用于安装)
|
||||
*
|
||||
* 用法:node dev/serve.mjs [端口] 默认端口 8899
|
||||
*/
|
||||
import http from 'node:http';
|
||||
import path from 'node:path';
|
||||
import crypto from 'node:crypto';
|
||||
import { readFile, stat } from 'node:fs/promises';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
const ROOT = path.resolve(HERE, '..');
|
||||
const HOST = '127.0.0.1';
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_DEV_PORT || process.argv[2] || 8899);
|
||||
|
||||
const FILES = {
|
||||
'/src': path.join(ROOT, 'yun-xue-tang-assistant.user.js'),
|
||||
'/loader.user.js': path.join(HERE, 'dev-loader.user.js'),
|
||||
};
|
||||
|
||||
const BASE = `http://${HOST}:${PORT}`;
|
||||
|
||||
function hashOf(buf) {
|
||||
return crypto.createHash('sha1').update(buf).digest('hex').slice(0, 12);
|
||||
}
|
||||
|
||||
function send(res, status, body, type, origin) {
|
||||
const headers = {
|
||||
'Content-Type': type || 'text/plain; charset=utf-8',
|
||||
'Cache-Control': 'no-store, no-cache, must-revalidate, max-age=0',
|
||||
Pragma: 'no-cache',
|
||||
'Access-Control-Allow-Headers': '*',
|
||||
'Access-Control-Allow-Methods': 'GET,HEAD,OPTIONS',
|
||||
'X-Content-Type-Options': 'nosniff',
|
||||
};
|
||||
// 只放行云学堂页面(Tampermonkey 的 GM_xmlhttpRequest 本来也不受 CORS 限制,
|
||||
// 这里拒绝其它站点读取是为了别让随便哪个网页都能拉到你的脚本)
|
||||
if (origin && /^https?:\/\/([a-z0-9-]+\.)*yunxuetang\.cn(:\d+)?$/i.test(origin)) {
|
||||
headers['Access-Control-Allow-Origin'] = origin;
|
||||
headers.Vary = 'Origin';
|
||||
}
|
||||
res.writeHead(status, headers);
|
||||
res.end(body);
|
||||
}
|
||||
|
||||
function indexHtml() {
|
||||
return `<!doctype html><meta charset="utf-8"><title>YXT Assistant · 本地开发服务</title>
|
||||
<style>body{font:14px/1.7 system-ui,"Microsoft YaHei";max-width:760px;margin:40px auto;padding:0 16px;color:#222}
|
||||
code{background:#f2f2f4;padding:1px 5px;border-radius:4px}a{color:#2f7d5b}
|
||||
.ok{color:#2f7d5b;font-weight:600}</style>
|
||||
<h2>云学堂助手 · 本地开发服务 <span class="ok">运行中</span></h2>
|
||||
<p>源码文件:<code>${path.join(ROOT, 'yun-xue-tang-assistant.user.js')}</code></p>
|
||||
<ul>
|
||||
<li><a href="/loader.user.js">安装 / 更新热加载器</a>(Tampermonkey 会弹出安装页)</li>
|
||||
<li><a href="/src">查看当前源码</a></li>
|
||||
<li><a href="/version">版本哈希</a></li>
|
||||
</ul>
|
||||
<p>改完源码保存后,浏览器页面约 1 秒内自动热替换,无需刷新、无需重装脚本。</p>`;
|
||||
}
|
||||
|
||||
const server = http.createServer(async (req, res) => {
|
||||
const url = new URL(req.url, BASE);
|
||||
const route = url.pathname.replace(/\/+$/, '') || '/';
|
||||
const origin = req.headers.origin || '';
|
||||
const reply = (status, body, type) => send(res, status, body, type, origin);
|
||||
|
||||
if (req.method === 'OPTIONS') return reply(204, '');
|
||||
if (route === '/favicon.ico') return reply(204, '');
|
||||
|
||||
if (route === '/') {
|
||||
return reply(200, indexHtml(), 'text/html; charset=utf-8');
|
||||
}
|
||||
|
||||
if (route === '/version') {
|
||||
try {
|
||||
const file = FILES['/src'];
|
||||
const [buf, st] = await Promise.all([readFile(file), stat(file)]);
|
||||
const body = JSON.stringify({
|
||||
hash: hashOf(buf),
|
||||
size: buf.length,
|
||||
mtime: st.mtimeMs,
|
||||
at: Date.now(),
|
||||
});
|
||||
return reply(200, body, 'application/json; charset=utf-8');
|
||||
} catch (e) {
|
||||
return reply(500, JSON.stringify({ error: String(e.message || e) }), 'application/json; charset=utf-8');
|
||||
}
|
||||
}
|
||||
|
||||
const file = FILES[route];
|
||||
if (file) {
|
||||
try {
|
||||
const buf = await readFile(file);
|
||||
const type = route === '/src'
|
||||
? 'application/javascript; charset=utf-8'
|
||||
: 'text/plain; charset=utf-8';
|
||||
if (route === '/src') {
|
||||
console.log(`[${time()}] /src ${buf.length}B ${hashOf(buf)}`);
|
||||
}
|
||||
return reply(200, buf, type);
|
||||
} catch (e) {
|
||||
console.error(`[${time()}] ${route} 读取失败: ${e.message}`);
|
||||
return reply(500, `读取失败: ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
return reply(404, 'not found: ' + route);
|
||||
});
|
||||
|
||||
function time() {
|
||||
return new Date().toLocaleTimeString('zh-CN', { hour12: false });
|
||||
}
|
||||
|
||||
server.listen(PORT, HOST, () => {
|
||||
console.log('');
|
||||
console.log(' YXT Assistant · 本地开发服务已启动');
|
||||
console.log(' ------------------------------------');
|
||||
console.log(` 脚本源码 : ${FILES['/src']}`);
|
||||
console.log(` 热加载器 : ${BASE}/loader.user.js`);
|
||||
console.log(` 版本接口 : ${BASE}/version`);
|
||||
console.log(` 首页 : ${BASE}/`);
|
||||
console.log(' ------------------------------------');
|
||||
console.log(' 保持本窗口开启;关闭窗口 = 停止服务。');
|
||||
console.log('');
|
||||
});
|
||||
|
||||
server.on('error', (e) => {
|
||||
if (e.code === 'EADDRINUSE') {
|
||||
console.error(`端口 ${PORT} 已被占用。可能服务已在运行,或用 "node dev/serve.mjs 8900" 换端口。`);
|
||||
} else {
|
||||
console.error('服务启动失败:', e);
|
||||
}
|
||||
process.exit(1);
|
||||
});
|
||||
|
||||
for (const sig of ['SIGINT', 'SIGTERM']) {
|
||||
process.on(sig, () => {
|
||||
console.log('\n服务已停止。');
|
||||
server.close(() => process.exit(0));
|
||||
setTimeout(() => process.exit(0), 1500).unref();
|
||||
});
|
||||
}
|
||||
@@ -1,38 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 考试结果页处置(src/exam-plan.js)自测:纯决策逻辑,不需要浏览器。
|
||||
*
|
||||
* 钉住的回归:重进课程时平台会恢复上次的考试结果页。那一页不是本页交的卷,
|
||||
* 不能计入「空卷交卷」次数,否则 maxExamTries 失效且会在结果页↔课程页之间死循环。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/exam-test.mjs
|
||||
* npm run test:exam
|
||||
*/
|
||||
import { planExamResult } from '../../src/exam-plan.js';
|
||||
|
||||
let failed = 0;
|
||||
function eq(actual, expect, name) {
|
||||
if (actual === expect) console.log(' ✔ ' + name);
|
||||
else {
|
||||
failed++;
|
||||
console.log(' ✘ ' + name + ' → 期望 ' + JSON.stringify(expect) +
|
||||
',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
}
|
||||
|
||||
console.log('考试结果页');
|
||||
eq(planExamResult({ submitted: true, complete: false }), 'count', '本页交的卷、平台未记账 → 计一次空卷交卷');
|
||||
eq(planExamResult({ submitted: true, complete: true }), 'complete', '本页交的卷、平台已记账 → 直接收课');
|
||||
eq(planExamResult({ submitted: false, complete: false, staleTries: 0 }), 'reback',
|
||||
'平台恢复的旧结果页 → 回考试说明页重进,不计交卷');
|
||||
eq(planExamResult({ submitted: false, complete: false, staleTries: 2 }), 'skip',
|
||||
'反复回不到考试说明页 → 跳过该课等人工');
|
||||
eq(planExamResult({ submitted: false, complete: true }), 'complete',
|
||||
'没交卷但平台已算完成 → 直接收课');
|
||||
|
||||
if (failed) {
|
||||
console.log('\n失败 ' + failed + ' 项');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('\n全部通过');
|
||||
@@ -1,114 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Bark 完成提醒(runner/notify.mjs)自测:只验证地址拼接与文案,不发真实请求。
|
||||
*
|
||||
* 这两块错了都不会让运行器报错——只会在手机上收到一条打不开的链接或看不懂的文案,
|
||||
* 而且往往要等到真正刷完那一刻才发现。用纯函数把格式钉死。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/notify-test.mjs
|
||||
* npm run test:notify
|
||||
*/
|
||||
import { buildBarkUrl, buildFinishMessage, buildStartMessage, buildCreditMessage } from '../../runner/notify.mjs';
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) console.log(' ✔ ' + name);
|
||||
else { failed++; console.log(' ✘ ' + name + (extra ? ' → ' + extra : '')); }
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
console.log('地址拼接');
|
||||
{
|
||||
eq(buildBarkUrl('', 't', 'b'), '', '空地址 = 不推送');
|
||||
eq(
|
||||
buildBarkUrl('https://api.day.app/KEY', '任务完成', '积分 15/24'),
|
||||
'https://api.day.app/KEY/' + encodeURIComponent('任务完成') + '/' + encodeURIComponent('积分 15/24'),
|
||||
'根地址 + 中文标题/正文按路径段编码'
|
||||
);
|
||||
eq(
|
||||
buildBarkUrl('https://api.day.app/KEY/', 't', 'b', { group: '云学堂', ttl: 600 }),
|
||||
'https://api.day.app/KEY/t/b?group=' + encodeURIComponent('云学堂') + '&ttl=600',
|
||||
'结尾斜杠不会拼出双斜杠,group/ttl 追加为查询参数'
|
||||
);
|
||||
eq(
|
||||
buildBarkUrl('https://api.day.app/KEY/{title}/{body}', 't', 'b'),
|
||||
'https://api.day.app/KEY/t/b',
|
||||
'带 {title}/{body} 占位符的完整模板'
|
||||
);
|
||||
eq(
|
||||
buildBarkUrl('https://api.day.app/KEY/{title}/{body}?group=example&ttl=600', 't', 'b', { group: 'x', ttl: 1 }),
|
||||
'https://api.day.app/KEY/t/b?group=example&ttl=600',
|
||||
'模板里已经有 group/ttl 时不再重复追加'
|
||||
);
|
||||
ok(
|
||||
buildBarkUrl('https://api.day.app/KEY', 'a&b', 'c?d').indexOf('a%26b') > 0,
|
||||
'特殊字符不会破坏路径'
|
||||
);
|
||||
}
|
||||
|
||||
console.log('收尾文案');
|
||||
{
|
||||
const done = buildFinishMessage({
|
||||
kind: 'done',
|
||||
finishReason: '无更多可学课程',
|
||||
completed: 10,
|
||||
elapsed: 125,
|
||||
points: { enabled: true, text: '今日积分 15/24 · 文档1/1 视频3/3 音频1/2 微课0/2' },
|
||||
});
|
||||
eq(done.title, '云学堂助手:任务完成', '正常完成标题');
|
||||
ok(done.body.indexOf('今日积分 15/24') === 0, '正文以今日积分开头');
|
||||
ok(done.body.indexOf('完成 10 门 · 用时 2 分 5 秒') > 0, '完成门数与用时');
|
||||
ok(done.body.indexOf('无更多可学课程') > 0, '带上结束原因');
|
||||
eq(done.body.split('\n').filter((l) => l.indexOf('完成') >= 0).length, 1, '完成门数只出现一次');
|
||||
|
||||
const pointsDone = buildFinishMessage({
|
||||
kind: 'done',
|
||||
finishReason: '可用内容已学完',
|
||||
completed: 4,
|
||||
elapsed: 1086,
|
||||
points: { enabled: true, text: '今日积分 24/24 · 文档1/1 视频3/3 音频1/2 微课0/2' },
|
||||
});
|
||||
ok(pointsDone.body.indexOf('(今日积分') < 0, '结束原因不再内嵌一遍积分台账');
|
||||
|
||||
eq(buildFinishMessage({ kind: 'stalled' }).title, '云学堂助手:长时间无进展', '卡死标题');
|
||||
eq(buildFinishMessage({ kind: 'login' }).title, '云学堂助手:登录失败', '登录失败标题');
|
||||
ok(buildFinishMessage({ kind: 'done', elapsed: 45 }).body.indexOf('用时 45 秒') > 0, '不足一分钟只显示秒');
|
||||
|
||||
const noPoints = buildFinishMessage({ kind: 'done', completed: 3, elapsed: 0 });
|
||||
ok(noPoints.body.indexOf('今日积分') < 0, '积分模式关闭时不硬塞今日积分');
|
||||
|
||||
const off = buildFinishMessage({
|
||||
kind: 'done', completed: 3, elapsed: 0,
|
||||
points: { enabled: false, text: '今日积分 0/24 · 文档0/1 视频0/3 音频0/2 微课0/2' },
|
||||
});
|
||||
ok(off.body.indexOf('今日积分 0/24') < 0 && off.body.indexOf('每日积分模式:关') >= 0,
|
||||
'enabled=false 时只说明模式已关闭,不贴 0/24');
|
||||
}
|
||||
|
||||
console.log('开始 / 学分通知');
|
||||
{
|
||||
const start = buildStartMessage({ POINTS_MODE: true, BUDGET_MINUTES: 180 });
|
||||
eq(start.title, '云学堂助手:开始运行', '开始运行标题');
|
||||
ok(start.body.indexOf('模式:每日积分') >= 0, '开始通知带上运行模式');
|
||||
ok(start.body.indexOf('运行预算:180 分钟') >= 0, '开始通知带上运行预算');
|
||||
|
||||
const startFree = buildStartMessage({ POINTS_MODE: false, BUDGET_MINUTES: 0 });
|
||||
ok(startFree.body.indexOf('模式:普通刷课') >= 0 && startFree.body.indexOf('运行预算:不限') >= 0,
|
||||
'普通刷课 + 不限预算');
|
||||
|
||||
const credit = buildCreditMessage({ course: '某课程', credit: 6.52, total: 12.75, completed: 3 });
|
||||
eq(credit.title, '云学堂助手:获得 6.52 学分', '学分通知标题带本次学分数');
|
||||
ok(credit.body.indexOf('课程「某课程」') >= 0, '学分通知带上课程名');
|
||||
ok(credit.body.indexOf('本次累计 12.75 学分 · 已完成 3 门') >= 0, '学分通知带上累计与完成门数');
|
||||
eq(buildCreditMessage({ credit: 1, total: 1 }).title, '云学堂助手:获得 1 学分', '整数学分不带小数点');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('✘ ' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('✔ 全部通过');
|
||||
@@ -1,270 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 只读探测:打开「我的积分」页,抓它真实调的接口与返回字段。
|
||||
*
|
||||
* node dev/tests/points-api-probe.mjs
|
||||
*
|
||||
* 用现有 profile 里的登录态(不登录、不点课程、不动进度),
|
||||
* 打印 /ssp/#/my/point 加载期间与积分/学时相关的 XHR 响应,
|
||||
* 以及页面渲染出来的文本,用来确认「今日获得多少积分」该读哪个字段。
|
||||
*/
|
||||
import path from 'node:path';
|
||||
import fs from 'node:fs';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, httpJson, sleep } from '../../runner/cdp.mjs';
|
||||
import { launchBrowser, resolveBrowser } from '../../runner/browser.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
const ROOT = path.resolve(HERE, '..', '..');
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9340);
|
||||
const ORIGIN = (process.env.YUN_XUE_TANG_ORIGIN || 'https://kfmic.yunxuetang.cn').replace(/\/+$/, '');
|
||||
const TARGET = ORIGIN + '/ssp/#/my/point';
|
||||
const LOGIN = ORIGIN + '/login.html';
|
||||
const PROFILE = process.env.YUN_XUE_TANG_PROFILE_DIR
|
||||
? path.resolve(ROOT, process.env.YUN_XUE_TANG_PROFILE_DIR)
|
||||
: path.join(ROOT, '.run-profile');
|
||||
|
||||
const INTERESTING = /point|jf|score|credit|study|history|\/ssp\/rule|\/user\/point/i;
|
||||
|
||||
function trim(s, n = 1200) {
|
||||
const t = String(s == null ? '' : s).replace(/\s+/g, ' ');
|
||||
return t.length > n ? t.slice(0, n) + '…' : t;
|
||||
}
|
||||
|
||||
async function main() {
|
||||
console.log('[探测] 浏览器:' + resolveBrowser());
|
||||
console.log('[探测] profile:' + PROFILE);
|
||||
console.log('[探测] 页面:' + TARGET);
|
||||
|
||||
const browser = await launchBrowser({
|
||||
binary: resolveBrowser(),
|
||||
profileDir: PROFILE,
|
||||
port: PORT,
|
||||
headless: true,
|
||||
log: (s) => console.log(s),
|
||||
});
|
||||
let cdp = null;
|
||||
try {
|
||||
const target = await httpJson(
|
||||
'http://127.0.0.1:' + PORT + '/json/new?' + encodeURIComponent(LOGIN), 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Network.enable');
|
||||
await cdp.send('Log.enable');
|
||||
|
||||
const reqs = new Map();
|
||||
const hits = [];
|
||||
const all = [];
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
console.log('[console.' + m.params.type + '] ' + trim(text, 400));
|
||||
return;
|
||||
}
|
||||
if (m.method === 'Log.entryAdded') {
|
||||
console.log('[log.' + m.params.entry.level + '] ' + trim(m.params.entry.text, 400));
|
||||
return;
|
||||
}
|
||||
if (m.method === 'Network.requestWillBeSent') {
|
||||
const info = {
|
||||
url: m.params.request.url,
|
||||
method: m.params.request.method,
|
||||
type: m.params.type,
|
||||
headers: m.params.request.headers,
|
||||
postData: m.params.request.postData,
|
||||
};
|
||||
reqs.set(m.params.requestId, info);
|
||||
if (/XHR|Fetch/.test(info.type || '')) all.push(info);
|
||||
return;
|
||||
}
|
||||
if (m.method === 'Network.responseReceived') {
|
||||
const url = m.params.response.url || '';
|
||||
if (!INTERESTING.test(url)) return;
|
||||
const req = reqs.get(m.params.requestId) || {};
|
||||
if (req.type && !/XHR|Fetch/.test(req.type)) return;
|
||||
hits.push({
|
||||
requestId: m.params.requestId,
|
||||
url: url,
|
||||
method: req.method || '',
|
||||
status: m.params.response.status,
|
||||
mime: m.params.response.mimeType,
|
||||
headers: req.headers || {},
|
||||
postData: req.postData || '',
|
||||
});
|
||||
}
|
||||
});
|
||||
|
||||
await sleep(6000);
|
||||
|
||||
// 只登录,不启动刷课:注入脚本后自己填表 + 点「登录」,并清掉「登录后自动刷课」标记。
|
||||
const usr = process.env.YUN_XUE_TANG_USR || '';
|
||||
const pwd = process.env.YUN_XUE_TANG_PWD || '';
|
||||
const scriptSrc = fs.readFileSync(path.join(ROOT, 'yun-xue-tang-assistant.user.js'), 'utf8');
|
||||
await cdp.send('Runtime.evaluate', { expression: scriptSrc });
|
||||
await sleep(1200);
|
||||
const filled = await cdp.send('Runtime.evaluate', {
|
||||
expression: `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return 'no-api';
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
var ok = a.fillLoginForm(${JSON.stringify(usr)}, ${JSON.stringify(pwd)});
|
||||
try { a.checkLoginAgreement(); } catch (e) {}
|
||||
try { a.doLoginAndStart(); } catch (e) {}
|
||||
// doLoginAndStart 会写「登录后自动刷课」标记;这里立刻清掉,保证只登录不刷课
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
try { a.S.batchRunning = false; } catch (e) {}
|
||||
return ok ? 'submitted' : 'no-fields';
|
||||
})()`,
|
||||
returnByValue: true,
|
||||
});
|
||||
console.log('[登录] 结果:' + filled.result.value);
|
||||
await sleep(12000);
|
||||
// 保险:登录页若把「自动刷课」标记写进 localStorage,这里再清一次并停批量
|
||||
await cdp.send('Runtime.evaluate', {
|
||||
expression: `(function () {
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (a) { try { a.S.batchRunning = false; a.S.batchFinished = false; } catch (e) {} }
|
||||
return true;
|
||||
})()`,
|
||||
});
|
||||
|
||||
hits.length = 0;
|
||||
all.length = 0;
|
||||
await cdp.send('Page.navigate', { url: TARGET });
|
||||
await sleep(25000);
|
||||
|
||||
const state = await cdp.send('Runtime.evaluate', {
|
||||
expression: `JSON.stringify((function () {
|
||||
function findTok(s) {
|
||||
try {
|
||||
for (var i = 0; i < s.length; i++) {
|
||||
var k = s.key(i), v = s.getItem(k) || '';
|
||||
if (/eyJ[a-zA-Z0-9_-]{10,}/.test(v)) return k;
|
||||
}
|
||||
} catch (e) {}
|
||||
return '';
|
||||
}
|
||||
return {
|
||||
href: location.href,
|
||||
ready: document.readyState,
|
||||
appLen: (document.getElementById('app') || {}).innerHTML ? document.getElementById('app').innerHTML.length : 0,
|
||||
ls: Object.keys(localStorage || {}),
|
||||
ss: Object.keys(sessionStorage || {}),
|
||||
lsTok: findTok(localStorage),
|
||||
ssTok: findTok(sessionStorage),
|
||||
cookies: String(document.cookie || '').split(';').map(function (s) { return s.split('=')[0].trim(); }),
|
||||
};
|
||||
})())`,
|
||||
returnByValue: true,
|
||||
}).then((r) => JSON.parse(r.result.value || '{}')).catch(() => ({}));
|
||||
console.log('\n[状态] ' + JSON.stringify(state));
|
||||
|
||||
const info = await cdp.send('Runtime.evaluate', {
|
||||
expression: 'JSON.stringify({ href: location.href, title: document.title, text: document.body ? document.body.innerText : "" })',
|
||||
returnByValue: true,
|
||||
}).then((r) => JSON.parse(r.result.value || '{}')).catch(() => ({}));
|
||||
console.log('\n[页面] ' + info.href + ' title=' + info.title);
|
||||
console.log('[页面文本] ' + trim(info.text, 800));
|
||||
|
||||
// 用构建产物自己的平台台账逻辑再拉一次,验证 token / CORS / 折算链路
|
||||
if (state.lsTok) {
|
||||
await cdp.send('Runtime.evaluate', { expression: scriptSrc });
|
||||
await sleep(1200);
|
||||
const ledger = await cdp.send('Runtime.evaluate', {
|
||||
expression: `(async function () {
|
||||
var tk = localStorage.getItem('token') || '';
|
||||
var h = { 'Content-Type': 'application/json;charset=UTF-8', source: '501', 'x-yxt-product': 'xxv2', token: tk };
|
||||
var d0 = new Date();
|
||||
var p2 = function (n) { return n < 10 ? '0' + n : '' + n; };
|
||||
var day = d0.getFullYear() + '-' + p2(d0.getMonth() + 1) + '-' + p2(d0.getDate());
|
||||
var body = JSON.stringify({
|
||||
startDate: day + ' 00:00:00', endDate: day + ' 23:59:59',
|
||||
sourceType: -1, optionType: 0, type: 1, userId: ''
|
||||
});
|
||||
var out = {};
|
||||
async function probe(name, url, opts) {
|
||||
try {
|
||||
var r = await fetch(url, opts);
|
||||
out[name] = { status: r.status, body: (await r.text()).slice(0, 400) };
|
||||
} catch (e) { out[name] = { error: String(e) }; }
|
||||
}
|
||||
await probe('rules', 'https://api-phx-tc.yunxuetang.cn/ssp/rule/org', { headers: h });
|
||||
await probe('rulesQ', 'https://api-phx-tc.yunxuetang.cn/ssp/rule/org?0=' + Math.random(), { headers: h });
|
||||
await probe('ledger', 'https://api-phx-tc.yunxuetang.cn/ssp/point/history/self?limit=200&offset=0', { method: 'POST', headers: h, body: body });
|
||||
// 统计历史台账里 nameType / actionType 的分布,判断能否据此归类
|
||||
try {
|
||||
var wide = JSON.stringify({
|
||||
startDate: '2025-01-01 00:00:00', endDate: d0.getFullYear() + '-12-31 23:59:59',
|
||||
sourceType: -1, optionType: 0, type: 1, userId: ''
|
||||
});
|
||||
var lr = await fetch('https://api-phx-tc.yunxuetang.cn/ssp/point/history/self?limit=200&offset=0', { method: 'POST', headers: h, body: wide });
|
||||
var lj = await lr.json();
|
||||
var combos = {};
|
||||
for (var rec of (lj.datas || [])) {
|
||||
if (Number(rec.sourceType) !== 1002) continue;
|
||||
var k = [rec.nameType, rec.actionType, rec.point].join('/');
|
||||
if (!combos[k]) combos[k] = { n: 0, samples: [] };
|
||||
combos[k].n++;
|
||||
if (combos[k].samples.length < 3) combos[k].samples.push(String(rec.remark || '').slice(0, 40));
|
||||
}
|
||||
out.combos = combos;
|
||||
} catch (e) { out.combos = { error: String(e) }; }
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (a) {
|
||||
var d = await a.refreshPlatformPoints(a.points, { force: true });
|
||||
out.platform = {
|
||||
ok: d.ok, todayPoints: d.todayPoints, maxPoints: d.maxPoints, rules: d.rules,
|
||||
recordCount: d.records ? d.records.length : 0, reason: d.reason,
|
||||
};
|
||||
out.counts = a.points.snapshot();
|
||||
}
|
||||
return JSON.stringify(out);
|
||||
})()`,
|
||||
awaitPromise: true,
|
||||
returnByValue: true,
|
||||
});
|
||||
console.log('\n[台账] ' + trim(ledger.result.value, 3000));
|
||||
}
|
||||
|
||||
console.log('\n[XHR/Fetch] 共 ' + all.length + ' 条:');
|
||||
const seen = new Set();
|
||||
for (const r of all) {
|
||||
if (seen.has(r.url)) continue;
|
||||
seen.add(r.url);
|
||||
console.log(' ' + r.method + ' ' + r.url);
|
||||
}
|
||||
|
||||
console.log('\n[接口] 命中 ' + hits.length + ' 条:'); for (const h of hits) {
|
||||
console.log('\n--- ' + h.method + ' ' + h.status + ' ' + h.url);
|
||||
const hdr = h.headers || {};
|
||||
for (const [k, v] of Object.entries(hdr)) {
|
||||
console.log(' ' + k + ': ' + String(v).slice(0, 120));
|
||||
}
|
||||
if (h.postData) console.log(' body: ' + trim(h.postData, 600));
|
||||
try {
|
||||
const body = await cdp.send('Network.getResponseBody', { requestId: h.requestId });
|
||||
const text = body.base64Encoded ? Buffer.from(body.body, 'base64').toString('utf8') : body.body;
|
||||
console.log(trim(text, 4000));
|
||||
} catch (e) {
|
||||
console.log('(响应体不可读:' + e.message + ')');
|
||||
}
|
||||
}
|
||||
|
||||
const res = await cdp.send('Runtime.evaluate', {
|
||||
expression: `JSON.stringify(performance.getEntriesByType('resource').map(function(e){return e.name;}).filter(function(u){return ${INTERESTING}.test(u);}))`,
|
||||
returnByValue: true,
|
||||
}).then((r) => JSON.parse(r.result.value || '[]')).catch(() => []);
|
||||
console.log('\n[资源] ' + res.length + ' 条');
|
||||
for (const u of res.slice(0, 60)) console.log(' ' + u);
|
||||
} finally {
|
||||
if (cdp) cdp.close();
|
||||
await browser.kill();
|
||||
}
|
||||
}
|
||||
|
||||
main().catch((e) => {
|
||||
console.error('[失败] ' + (e && e.stack ? e.stack : e));
|
||||
process.exit(1);
|
||||
});
|
||||
@@ -1,118 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 平台积分台账(src/points-platform.js)自测:
|
||||
* 平台台账才是权威计数,这里钉死「按课程名归类」「用待对账记录兜底」「同一条不重复计」。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/points-platform-test.mjs
|
||||
*/
|
||||
function fakeStorage() {
|
||||
const mem = new Map();
|
||||
return {
|
||||
getItem: (k) => (mem.has(k) ? mem.get(k) : null),
|
||||
setItem: (k, v) => { mem.set(k, String(v)); },
|
||||
removeItem: (k) => { mem.delete(k); },
|
||||
clear: () => mem.clear(),
|
||||
};
|
||||
}
|
||||
|
||||
globalThis.localStorage = fakeStorage();
|
||||
|
||||
const { applyLedger, rememberCourseAward } = await import('../../src/points-platform.js');
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) console.log(' ✔ ' + name);
|
||||
else { failed++; console.log(' ✘ ' + name + (extra ? ' → ' + extra : '')); }
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
function tracker() {
|
||||
const counts = { doc: 0, video: 0, audio: 0, micro: 0 };
|
||||
const seen = new Set();
|
||||
return {
|
||||
counts,
|
||||
record(type, id) {
|
||||
if (seen.has(id)) return false;
|
||||
seen.add(id);
|
||||
counts[type] = (counts[type] || 0) + 1;
|
||||
return true;
|
||||
},
|
||||
resetCounts() {
|
||||
for (const k of Object.keys(counts)) counts[k] = 0;
|
||||
seen.clear();
|
||||
},
|
||||
summary() { return ''; },
|
||||
};
|
||||
}
|
||||
|
||||
const now = new Date();
|
||||
const p = (n) => (n < 10 ? '0' + n : '' + n);
|
||||
const day = now.getFullYear() + '-' + p(now.getMonth() + 1) + '-' + p(now.getDate());
|
||||
|
||||
console.log('按课程名归类');
|
||||
{
|
||||
const t = tracker();
|
||||
rememberCourseAward('课程 A', 'video');
|
||||
const data = {
|
||||
ok: true, day,
|
||||
records: [{ id: '1', point: 3, remark: '课程 A', sourceType: 1002 }],
|
||||
};
|
||||
eq(applyLedger(data, t), 1, '平台入账 1 条');
|
||||
eq(t.counts.video, 1, '计入视频');
|
||||
}
|
||||
|
||||
console.log('台账 nameType 优先于标题');
|
||||
{
|
||||
const t = tracker();
|
||||
const data = {
|
||||
ok: true, day,
|
||||
records: [{ id: '9', point: 3, remark: '不认识的标题', sourceType: 1002, nameType: 1008 }],
|
||||
};
|
||||
eq(applyLedger(data, t), 1, '靠 nameType 归类');
|
||||
eq(t.counts.audio, 1, 'nameType 1008 = 音频');
|
||||
}
|
||||
|
||||
console.log('平台用课时名时用待对账记录兜底');
|
||||
{
|
||||
const t = tracker();
|
||||
rememberCourseAward('课程 B', 'doc');
|
||||
const data = {
|
||||
ok: true, day,
|
||||
records: [{ id: '2', point: 3, remark: '第一节课时名', sourceType: 1002 }],
|
||||
};
|
||||
eq(applyLedger(data, t), 1, '兜底计入');
|
||||
eq(t.counts.doc, 1, '计入文档');
|
||||
}
|
||||
|
||||
console.log('同一条记录不重复计');
|
||||
{
|
||||
const t = tracker();
|
||||
rememberCourseAward('课程 C', 'audio');
|
||||
const data = {
|
||||
ok: true, day,
|
||||
records: [
|
||||
{ id: '3', point: 3, remark: '课程 C', sourceType: 1002 },
|
||||
{ id: '3', point: 3, remark: '课程 C', sourceType: 1002 },
|
||||
],
|
||||
};
|
||||
eq(applyLedger(data, t), 1, '同一 id 只计一次');
|
||||
eq(applyLedger(data, t), 0, '再次应用不重复计');
|
||||
eq(t.counts.audio, 1, '音频只计 1 次');
|
||||
}
|
||||
|
||||
console.log('未登录 / 接口失败时不动计数');
|
||||
{
|
||||
const t = tracker();
|
||||
eq(applyLedger({ ok: false, reason: 'no-token' }, t), 0, 'ok:false 直接跳过');
|
||||
eq(t.counts.video, 0, '计数保持 0');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('✘ ' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('✔ 全部通过');
|
||||
@@ -1,239 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 每日积分(src/points.js)自测:纯数据逻辑,假时钟 + 假存储,不需要浏览器。
|
||||
*
|
||||
* 口径一旦错,日志和面板上的「今日积分 12/24」就是假的,而这种错在运行日志里
|
||||
* 完全看不出来。用假时钟把「每日封顶」「同节不重复计」「跨日清零」「缺内容的类型不阻塞」
|
||||
* 这些边界钉死。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/points-test.mjs
|
||||
* npm run test:points
|
||||
*/
|
||||
import {
|
||||
POINT_RULES, POINTS_PER_TASK, MAX_DAILY_POINTS,
|
||||
detectLessonType, apiTypeKey, createPointsTracker, nextTarget,
|
||||
} from '../../src/points.js';
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) console.log(' ✔ ' + name);
|
||||
else { failed++; console.log(' ✘ ' + name + (extra ? ' → ' + extra : '')); }
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
/** 假存储:只实现 getItem / setItem,跨 tracker 实例复用即验证持久化 */
|
||||
function fakeStorage() {
|
||||
const mem = new Map();
|
||||
return {
|
||||
getItem: (k) => (mem.has(k) ? mem.get(k) : null),
|
||||
setItem: (k, v) => { mem.set(k, String(v)); },
|
||||
removeItem: (k) => { mem.delete(k); },
|
||||
dump: () => Object.fromEntries(mem),
|
||||
};
|
||||
}
|
||||
|
||||
/** 假时钟:手动推进 */
|
||||
function clock(start = new Date(2026, 10, 1, 9, 0, 0).getTime()) {
|
||||
let t = start;
|
||||
return {
|
||||
now: () => t,
|
||||
tick: (sec) => { t += sec * 1000; },
|
||||
set: (d) => { t = d.getTime(); },
|
||||
};
|
||||
}
|
||||
|
||||
function newTracker(c, storage) {
|
||||
return createPointsTracker({ now: c.now, storage: storage || fakeStorage() });
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 1. 规则与类型识别
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('规则与类型识别');
|
||||
{
|
||||
eq(POINTS_PER_TASK, 3, '每条任务 3 分');
|
||||
eq(MAX_DAILY_POINTS, 24, '每日上限 1+3+2+2 = 8 条 × 3 = 24 分');
|
||||
eq(POINT_RULES.map((r) => r.key).join(','), 'doc,video,audio,micro', '四类顺序:文档/视频/音频/微课');
|
||||
|
||||
eq(detectLessonType({ tag: '视频' }), 'video', '课时标签「视频」');
|
||||
eq(detectLessonType({ tag: '文档' }), 'doc', '课时标签「文档」');
|
||||
eq(detectLessonType({ tag: '课件' }), 'doc', '课时标签「课件」按文档算');
|
||||
eq(detectLessonType({ tag: '音频' }), 'audio', '课时标签「音频」');
|
||||
eq(detectLessonType({ tag: '微课' }), 'micro', '课时标签「微课」');
|
||||
eq(detectLessonType({ hash: '#/video/play?kngId=x' }), 'video', '单视频路由');
|
||||
eq(detectLessonType({ hash: '#/audio/play?kngId=x' }), 'audio', '单音频路由');
|
||||
eq(detectLessonType({ hash: '#/ppt/play?kngId=x' }), 'doc', '单课件路由按文档算');
|
||||
eq(detectLessonType({ hash: '#/document/play?kngId=x' }), 'doc', '文档路由');
|
||||
eq(detectLessonType({ hash: '#/micro/play?kngId=x' }), 'micro', '微课路由');
|
||||
eq(detectLessonType({ fileType: 'video' }), 'video', '接口 fileType=video');
|
||||
eq(detectLessonType({ fileType: 'ppt' }), 'doc', '接口 fileType=ppt');
|
||||
eq(detectLessonType({ tag: '视频', hash: '#/document/play' }), 'doc', '多来源冲突时以路由/精确类型为准(文档优先)');
|
||||
eq(detectLessonType({ hash: '#/course/play?kngId=x' }), '', '多课时课程容器本身不算类型');
|
||||
eq(detectLessonType({ tag: '考试' }), '', '考试节点不计积分');
|
||||
eq(detectLessonType({}), '', '没有信息时返回空(不瞎猜)');
|
||||
|
||||
eq(apiTypeKey(1), 'doc', '列表接口 type=1 → 文档');
|
||||
eq(apiTypeKey(2), 'video', '列表接口 type=2 → 视频');
|
||||
eq(apiTypeKey(3), 'audio', '列表接口 type=3 → 音频');
|
||||
eq(apiTypeKey(0), '', 'type=0 是课程容器,不计');
|
||||
eq(apiTypeKey(99), '', '未知 type 不计');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 2. 每日封顶:四类各自上限
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('每日封顶');
|
||||
{
|
||||
const c = clock();
|
||||
const p = newTracker(c);
|
||||
let n = 0;
|
||||
for (let i = 0; i < 5; i++) if (p.record('doc', 'course-a|doc-' + i)) n++;
|
||||
eq(n, 1, '文档每天只计 1 次');
|
||||
eq(p.count('doc'), 1, '文档计数封顶 1');
|
||||
eq(p.isFull('doc'), true, '文档封顶后 isFull');
|
||||
eq(p.remaining('doc'), 0, '文档剩余额度 0');
|
||||
|
||||
n = 0;
|
||||
for (let i = 0; i < 6; i++) if (p.record('video', 'course-a|v-' + i)) n++;
|
||||
eq(n, 3, '视频每天只计 3 次');
|
||||
|
||||
n = 0;
|
||||
for (let i = 0; i < 5; i++) if (p.record('audio', 'a-' + i)) n++;
|
||||
eq(n, 2, '音频每天只计 2 次');
|
||||
|
||||
n = 0;
|
||||
for (let i = 0; i < 5; i++) if (p.record('micro', 'm-' + i)) n++;
|
||||
eq(n, 2, '微课每天只计 2 次');
|
||||
|
||||
eq(p.totalPoints(), 24, '四类满额 = 24 分');
|
||||
eq(p.maxPoints(), 24, '每日满分 24');
|
||||
eq(p.allFull(), true, '四类都满');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 3. 去重:同一课时重复上报不重复计
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('去重');
|
||||
{
|
||||
const c = clock();
|
||||
const p = newTracker(c);
|
||||
eq(p.record('video', 'course-a|lesson-1'), true, '第一次记录成功');
|
||||
eq(p.record('video', 'course-a|lesson-1'), false, '同一课时再次上报不计');
|
||||
eq(p.count('video'), 1, '计数仍为 1');
|
||||
eq(p.record('video', 'course-a|lesson-2'), true, '下一节正常计');
|
||||
eq(p.count('video'), 2, '计数 2');
|
||||
eq(p.record('video', ''), true, '没有课时 id 时不做去重(按事件计一次)');
|
||||
eq(p.record('video', ''), false, '无 id 事件也受每日封顶限制');
|
||||
eq(p.count('video'), 3, '视频封顶 3');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 4. 跨日清零 + 持久化
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('跨日与持久化');
|
||||
{
|
||||
const c = clock();
|
||||
const storage = fakeStorage();
|
||||
const p = newTracker(c, storage);
|
||||
p.record('doc', 'd1');
|
||||
p.record('video', 'v1');
|
||||
eq(p.totalPoints(), 6, '当天 2 条 = 6 分');
|
||||
|
||||
// 同一份存储、新的 tracker 实例(模拟刷新 / 运行器重启)
|
||||
const p2 = newTracker(c, storage);
|
||||
eq(p2.count('doc'), 1, '刷新后计数保留');
|
||||
eq(p2.record('video', 'v1'), false, '刷新后同节仍不重复计');
|
||||
|
||||
// 跨日
|
||||
c.set(new Date(2026, 10, 2, 0, 0, 5));
|
||||
const p3 = newTracker(c, storage);
|
||||
eq(p3.count('doc'), 0, '新的一天文档清零');
|
||||
eq(p3.totalPoints(), 0, '新的一天积分清零');
|
||||
eq(p3.record('video', 'v1'), true, '新的一天同一课时可以重新计');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 5. 可用性:没内容的类型不阻塞「今天已完成」
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('可用性与完成判断');
|
||||
{
|
||||
const c = clock();
|
||||
const p = newTracker(c);
|
||||
p.record('doc', 'd1');
|
||||
p.record('audio', 'a1');
|
||||
p.record('video', 'v1');
|
||||
p.record('video', 'v2');
|
||||
p.record('video', 'v3');
|
||||
// 音频每天 2 次,但全站只有 1 条音频;微课 0 条
|
||||
const available = { doc: false, video: true, audio: false, micro: false };
|
||||
eq(p.isFull('audio'), false, '音频只学了 1 次,还没到上限');
|
||||
eq(p.done(available), true, '剩余额度的类型都没内容 → 今日任务已完成');
|
||||
eq(p.done({ doc: true, video: true, audio: true, micro: true }), false, '还有可用内容时不算完成');
|
||||
eq(p.done(), false, '不传可用性时按「都还有内容」处理,不误判完成');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6. 选类顺序:文档 → 视频 → 音频 → 微课;跳过已满/无内容
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('选类顺序');
|
||||
{
|
||||
const full = {};
|
||||
const avail = { doc: true, video: true, audio: true, micro: true };
|
||||
const isFull = (k) => !!full[k];
|
||||
eq(nextTarget({ isFull, available: avail }).type, 'doc', '第一步先补文档');
|
||||
full.doc = true;
|
||||
eq(nextTarget({ isFull, available: avail }).type, 'video', '文档满后学视频');
|
||||
full.video = true;
|
||||
eq(nextTarget({ isFull, available: avail }).type, 'audio', '视频满后换音频');
|
||||
full.audio = true;
|
||||
eq(nextTarget({ isFull, available: avail }).type, 'micro', '音频满后换微课');
|
||||
full.micro = true;
|
||||
eq(nextTarget({ isFull, available: avail }), null, '全满 → 没有可做任务');
|
||||
|
||||
// 文档没内容:直接跳过(不能卡在缺内容的类型上)
|
||||
const f2 = {};
|
||||
eq(nextTarget({ isFull: (k) => !!f2[k], available: { doc: false, video: true, audio: true, micro: true } }).type, 'video', '文档无内容时跳过');
|
||||
|
||||
// 视频靠课程里的课时,不用单独库存;课程也没有时跳过
|
||||
eq(nextTarget({ isFull: () => false, available: { doc: false, video: false, audio: true, micro: true } }).type, 'audio', '没有可学课程时跳过视频');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7. 关闭开关:完全不计数
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('开关');
|
||||
{
|
||||
const c = clock();
|
||||
const p = createPointsTracker({ now: c.now, storage: fakeStorage(), enabled: false });
|
||||
eq(p.isEnabled(), false, '初始关闭');
|
||||
eq(p.record('video', 'v1'), false, '关闭时不计分');
|
||||
eq(p.totalPoints(), 0, '关闭时积分 0');
|
||||
p.setEnabled(true);
|
||||
eq(p.record('video', 'v1'), true, '重新开启后可以计分');
|
||||
eq(p.totalPoints(), 3, '开启后计 3 分');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 8. 摘要文本
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('摘要');
|
||||
{
|
||||
const c = clock();
|
||||
const p = newTracker(c);
|
||||
p.record('doc', 'd1');
|
||||
p.record('video', 'v1');
|
||||
eq(p.summary(), '今日积分 6/24 · 文档1/1 视频1/3 音频0/2 微课0/2', '摘要含总分与各类进度');
|
||||
eq(p.snapshot().total, 6, 'snapshot 给运行器用:总分');
|
||||
eq(p.snapshot().max, 24, 'snapshot 给运行器用:满分');
|
||||
eq(p.snapshot().progress.length, 4, 'snapshot 给运行器用:四类进度');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('每日积分自测:' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('每日积分自测:全部通过');
|
||||
@@ -1,88 +0,0 @@
|
||||
// 极简 CDP 客户端:Node 18+ 原生 WebSocket,无需 puppeteer / playwright。
|
||||
// 只实现本项目真机测试用到的部分:send / waitEvent / 事件堆积。
|
||||
// Linux 无图形化服务器 / 容器的浏览器探测与启动参数统一放在 runner/browser.mjs,
|
||||
// 这里一并转发,避免 dev 测试脚本和 runner 两套逻辑跑偏。
|
||||
import fs from 'node:fs';
|
||||
import {
|
||||
resolveBrowser as _resolveBrowser, safetyArgs as _safetyArgs, hasDisplay,
|
||||
} from '../../runner/browser.mjs';
|
||||
|
||||
export { cleanStaleSingleton } from '../../runner/browser.mjs';
|
||||
|
||||
export async function connect(wsUrl) {
|
||||
const ws = new WebSocket(wsUrl);
|
||||
await new Promise((res, rej) => {
|
||||
ws.addEventListener('open', res, { once: true });
|
||||
ws.addEventListener('error', rej, { once: true });
|
||||
});
|
||||
|
||||
let id = 0;
|
||||
const pending = new Map();
|
||||
const events = [];
|
||||
const waiters = [];
|
||||
const listeners = [];
|
||||
|
||||
ws.addEventListener('message', (ev) => {
|
||||
const msg = JSON.parse(ev.data);
|
||||
if (msg.id != null && pending.has(msg.id)) {
|
||||
const { res, rej } = pending.get(msg.id);
|
||||
pending.delete(msg.id);
|
||||
if (msg.error) rej(new Error(msg.error.message));
|
||||
else res(msg.result);
|
||||
return;
|
||||
}
|
||||
events.push(msg);
|
||||
for (const fn of listeners) {
|
||||
try { fn(msg); } catch (e) { /* 忽略订阅者异常 */ }
|
||||
}
|
||||
for (let i = waiters.length - 1; i >= 0; i--) {
|
||||
if (waiters[i].match(msg)) waiters.splice(i, 1)[0].res(msg);
|
||||
}
|
||||
});
|
||||
|
||||
const send = (method, params = {}) => new Promise((res, rej) => {
|
||||
const mid = ++id;
|
||||
pending.set(mid, { res, rej });
|
||||
ws.send(JSON.stringify({ id: mid, method, params }));
|
||||
});
|
||||
|
||||
const waitEvent = (name, timeoutMs = 30000) => new Promise((res, rej) => {
|
||||
const timer = setTimeout(() => rej(new Error('等待事件超时: ' + name)), timeoutMs);
|
||||
waiters.push({
|
||||
match: (m) => m.method === name,
|
||||
res: (m) => { clearTimeout(timer); res(m.params); },
|
||||
});
|
||||
});
|
||||
|
||||
const onEvent = (fn) => { listeners.push(fn); };
|
||||
|
||||
return { ws, send, waitEvent, onEvent, events, close: () => { try { ws.close(); } catch (e) {} } };
|
||||
}
|
||||
|
||||
export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
||||
|
||||
export async function httpJson(url, method = 'GET') {
|
||||
const r = await fetch(url, { method });
|
||||
const t = await r.text();
|
||||
try { return JSON.parse(t); } catch (e) { return t; }
|
||||
}
|
||||
|
||||
// ---- Linux 无图形化服务器 / 容器适配 ----
|
||||
|
||||
// 无显示环境:Linux 上没有 DISPLAY / WAYLAND_DISPLAY 就只能无头
|
||||
// (跑在 Xvfb 下时 Xvfb 会设置 DISPLAY,因此这里只判断变量)
|
||||
export function forceHeadless() {
|
||||
return !hasDisplay();
|
||||
}
|
||||
|
||||
// 按环境变量 / 常见安装位置找到真实存在的浏览器;找不到时返回 null
|
||||
export function findChrome(candidates) {
|
||||
return _resolveBrowser() || candidates.filter(Boolean).find(function (p) {
|
||||
try { return fs.statSync(p).isFile(); } catch (e) { return false; }
|
||||
}) || null;
|
||||
}
|
||||
|
||||
// 必须追加给浏览器的平台安全参数(容器 /dev/shm 小、root 无沙箱)
|
||||
export function safetyArgs() {
|
||||
return _safetyArgs();
|
||||
}
|
||||
@@ -1,422 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 真机端到端测试:真实 Chrome + 真实云学堂账号,跑「登录 → 列表 → 进课 → 播放」全链路。
|
||||
*
|
||||
* 账号来源(环境变量,不写进代码、不打印明文):
|
||||
* YUN_XUE_TANG_USR 员工邮箱 / 账号
|
||||
* YUN_XUE_TANG_PWD 密码
|
||||
*
|
||||
* 用法:
|
||||
* node dev/real-e2e.mjs 登录 + 列表断言(不动任何课程进度)
|
||||
* node dev/real-e2e.mjs --play 额外进入最短的一门课,采样播放 N 秒后停止
|
||||
* node dev/real-e2e.mjs --play --seconds 60
|
||||
* node dev/real-e2e.mjs --headless 无头模式
|
||||
* node dev/real-e2e.mjs --keep 跑完不关浏览器(便于人工复核)
|
||||
* node dev/real-e2e.mjs --shotdir X 截图目录
|
||||
*
|
||||
* 安全约束(刻意保守):
|
||||
* - 只有显式传 --play 才会进入课程页;默认全程只读,不改任何学习进度。
|
||||
* - --play 默认只采样 25 秒,采完立刻 pause + 释放脚本,不会把整节课刷完。
|
||||
* - 结束前会打印本轮进度变化(开课前 / 结束后 的 已完成 x/y),便于核对影响。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
// 本文件在 dev/tests/ 下,仓库根目录是上两级
|
||||
const ROOT = path.resolve(HERE, '..', '..');
|
||||
const SCRIPT_SRC = fs.readFileSync(path.join(ROOT, 'yun-xue-tang-assistant.user.js'), 'utf8');
|
||||
|
||||
const argv = process.argv.slice(2);
|
||||
const flag = (n) => argv.includes(n);
|
||||
const opt = (n, d) => {
|
||||
const i = argv.indexOf(n);
|
||||
return i >= 0 && argv[i + 1] ? argv[i + 1] : d;
|
||||
};
|
||||
|
||||
const USR = process.env.YUN_XUE_TANG_USR || '';
|
||||
const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||||
const PLAY = flag('--play');
|
||||
const SAMPLE_SECONDS = Number(opt('--seconds', 25));
|
||||
const HEADLESS = flag('--headless') || process.env.YUN_XUE_TANG_HEADLESS === '1';
|
||||
const KEEP = flag('--keep');
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9334);
|
||||
const SHOT_DIR = opt('--shotdir', path.join(ROOT, '.run-tmp', 'screenshots'));
|
||||
const ORIGIN = 'https://kfmic.yunxuetang.cn';
|
||||
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/chromium',
|
||||
].filter(Boolean);
|
||||
const CHROME = findChrome(CANDIDATES);
|
||||
|
||||
const results = [];
|
||||
const consoleLogs = [];
|
||||
const log = (...a) => console.log(...a);
|
||||
function check(name, ok, detail) {
|
||||
results.push({ name, ok: !!ok, detail });
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
}
|
||||
|
||||
if (!CHROME) { console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=... 指定'); process.exit(2); }
|
||||
if (!USR || !PWD) { console.error('缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD'); process.exit(2); }
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
console.error('需要 Node 22+,当前 ' + process.version);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
log('[E2E] 账号:' + USR.slice(0, 3) + '***' + USR.slice(-2) + ' 密码:' + '*'.repeat(Math.min(PWD.length, 8)) + '(长度 ' + PWD.length + ')');
|
||||
// Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数
|
||||
const HEADLESS_ONLY = HEADLESS || forceHeadless();
|
||||
log('[E2E] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless)' : '(有界面)') + ' 进课采样:' + (PLAY ? SAMPLE_SECONDS + ' 秒' : '否(只读)'));
|
||||
const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-e2e-'));
|
||||
const args = [
|
||||
`--remote-debugging-port=${PORT}`,
|
||||
`--user-data-dir=${userDataDir}`,
|
||||
'--no-first-run', '--no-default-browser-check', '--disable-sync',
|
||||
'--disable-background-timer-throttling', '--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
'--autoplay-policy=no-user-gesture-required',
|
||||
'--window-size=1360,940',
|
||||
].concat(safetyArgs(), ['about:blank']);
|
||||
if (HEADLESS_ONLY) args.unshift('--headless=new');
|
||||
|
||||
let chrome = null;
|
||||
let cdp = null;
|
||||
|
||||
try {
|
||||
chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true });
|
||||
|
||||
let version = null;
|
||||
for (let i = 0; i < 100; i++) {
|
||||
try { const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`); if (v && v.webSocketDebuggerUrl) { version = v; break; } } catch (e) {}
|
||||
await sleep(250);
|
||||
}
|
||||
if (!version) throw new Error('Chrome CDP 未就绪');
|
||||
log('[E2E] ' + version.Browser);
|
||||
|
||||
const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(ORIGIN + '/login.html')}`, 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
consoleLogs.push({ type: m.params.type, text: String(text) });
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
consoleLogs.push({ type: m.params.entry.level, text: m.params.entry.text });
|
||||
}
|
||||
});
|
||||
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true, userGesture: true });
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
const waitFor = async (exprFn, timeoutMs, label) => {
|
||||
const started = Date.now();
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
try { if (await evalJS(exprFn)) return true; } catch (e) {}
|
||||
await sleep(500);
|
||||
}
|
||||
return false;
|
||||
};
|
||||
const shot = async (name) => {
|
||||
try {
|
||||
fs.mkdirSync(SHOT_DIR, { recursive: true });
|
||||
const s = await cdp.send('Page.captureScreenshot', { format: 'png' });
|
||||
const f = path.join(SHOT_DIR, name);
|
||||
fs.writeFileSync(f, Buffer.from(s.data, 'base64'));
|
||||
return path.relative(ROOT, f);
|
||||
} catch (e) { return '截图失败: ' + e.message; }
|
||||
};
|
||||
|
||||
const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null);
|
||||
await cdp.send('Page.navigate', { url: ORIGIN + '/login.html' });
|
||||
await loaded;
|
||||
await sleep(2000);
|
||||
|
||||
// ---------- 1. 登录页 + 注入 ----------
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1000);
|
||||
const loginInfo = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
return {
|
||||
url: location.href,
|
||||
title: document.title,
|
||||
isLoginPage: a.isLoginPage(),
|
||||
panel: !!document.getElementById('yun-xue-tang-panel'),
|
||||
fields: (() => { const f = a.loginFields(); return { user: !!f.user, pwd: !!f.pwd, ph: f.user ? f.user.placeholder : null }; })(),
|
||||
};
|
||||
})())`);
|
||||
check('登录页加载 + 脚本注入', loginInfo.isLoginPage === true && loginInfo.panel === true, loginInfo.url);
|
||||
check('识别到账号/密码输入框', loginInfo.fields.user && loginInfo.fields.pwd, loginInfo.fields);
|
||||
|
||||
// ---------- 2. 填账号密码(走真实的 setNativeValue + Vue 双向绑定) ----------
|
||||
const filled = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const u = ${JSON.stringify(USR)};
|
||||
const p = ${JSON.stringify(PWD)};
|
||||
document.getElementById('yun-xue-tang-login-user').value = u;
|
||||
document.getElementById('yun-xue-tang-login-pass').value = p;
|
||||
const okForm = a.fillLoginForm(u, p);
|
||||
const f = a.loginFields();
|
||||
return {
|
||||
okForm,
|
||||
userValueLen: f.user ? f.user.value.length : -1,
|
||||
pwdValueLen: f.pwd ? f.pwd.value.length : -1,
|
||||
userMatched: f.user ? f.user.value === u : false,
|
||||
pwdMatched: f.pwd ? f.pwd.value === p : false,
|
||||
panelUser: document.getElementById('yun-xue-tang-login-user').value.length,
|
||||
};
|
||||
})())`);
|
||||
check('账号密码写入真实输入框', filled.okForm === true && filled.userMatched === true && filled.pwdMatched === true,
|
||||
{ 长度: [filled.userValueLen, filled.pwdValueLen], 一致: [filled.userMatched, filled.pwdMatched] });
|
||||
|
||||
const agree = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const before = [...document.querySelectorAll('label')].filter(x => /已阅读并同意|隐私政策/.test(x.innerText||''))
|
||||
.map(x => { const c = x.querySelector('input[type=checkbox]'); return c ? c.checked : null; });
|
||||
const ok = a.checkLoginAgreement ? a.checkLoginAgreement() : 'no-api';
|
||||
const after = [...document.querySelectorAll('label')].filter(x => /已阅读并同意|隐私政策/.test(x.innerText||''))
|
||||
.map(x => { const c = x.querySelector('input[type=checkbox]'); return c ? c.checked : null; });
|
||||
return { before, after, ok };
|
||||
})())`);
|
||||
check('隐私政策勾选处理正常', agree.ok === true || agree.ok === 'no-api', agree);
|
||||
|
||||
// ---------- 3. 点「一键登录并刷课」,等真实登录成功 ----------
|
||||
// 注意:这个按钮会写 LS_PENDING,登录后自动开启列表刷课(脚本设计行为)。
|
||||
// 默认(不加 --play)测完登录马上刹住,避免动到真实学习进度。
|
||||
await evalJS(`(document.getElementById('yun-xue-tang-oneclick').click(), true)`);
|
||||
const loginOk = await waitFor(`(() => {
|
||||
if (/\\/login/.test(location.pathname)) return false;
|
||||
if (!document.body) return false;
|
||||
if (document.querySelector('input[type=password]')) return false;
|
||||
return true;
|
||||
})()`, 45000);
|
||||
await sleep(2000);
|
||||
const afterLogin = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const status = (document.getElementById('yun-xue-tang-status') || {}).textContent || '';
|
||||
const bodyText = document.body ? (document.body.innerText || '').replace(/\\s+/g, ' ').slice(0, 400) : '';
|
||||
return {
|
||||
url: location.href, title: document.title, status,
|
||||
alive: typeof window.__yunXueTangAuto,
|
||||
isLoginPage: a ? a.isLoginPage() : null,
|
||||
captcha: /验证码|滑块|安全验证/.test(bodyText),
|
||||
errText: (bodyText.match(/(用户名密码错误|账号或密码错误|密码错误|账号不存在|登录失败)[^ ]{0,40}/) || [''])[0],
|
||||
panel: !!document.getElementById('yun-xue-tang-panel'),
|
||||
};
|
||||
})())`);
|
||||
check('真实登录成功(离开登录页)', loginOk === true, afterLogin);
|
||||
const scriptErrs = () => consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text));
|
||||
check('登录流程无脚本 error', scriptErrs().length === 0, scriptErrs().map((e) => e.text.slice(0, 140)));
|
||||
log(' 截图:' + await shot('e2e-01-after-login.png'));
|
||||
|
||||
// 登录是整页跳转(新 document),真实 Tampermonkey 会按 @match 重新注入;
|
||||
// 这里模拟同样的行为。
|
||||
if ((await evalJS('typeof window.__yunXueTangAuto')) === 'undefined') {
|
||||
log('[E2E] 登录后是新 document(' + afterLogin.url + '),重新注入脚本');
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1200);
|
||||
}
|
||||
check('登录后新 document 上脚本已注入', (await evalJS('typeof window.__yunXueTangAuto')) === 'object', await evalJS('document.title || location.pathname'));
|
||||
|
||||
if (!PLAY) {
|
||||
// 立即刹住列表刷课:清 pending 标记 + 关闭 running,防止在真实账号上推进课程
|
||||
const halted = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
if (a) { a.S.batchRunning = false; a.S.batchFinished = false; a.S.activeCourse = null; a.S.coursePhase = 'idle'; a.save(); }
|
||||
return { running: a ? a.S.batchRunning : null, current: a ? a.S.activeCourse : null };
|
||||
})())`);
|
||||
check('默认只读:登录后立即停用列表刷课', halted.running === false && halted.current === null, halted);
|
||||
}
|
||||
|
||||
// ---------- 4. 列表页断言 ----------
|
||||
const listNavStarted = Date.now();
|
||||
await evalJS(`(location.href = 'https://kfmic.yunxuetang.cn/kng/#/list', true)`);
|
||||
await cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null);
|
||||
await sleep(2500);
|
||||
// 换页后可能又是新 document,重新注入
|
||||
if ((await evalJS('typeof window.__yunXueTangAuto')) === 'undefined') {
|
||||
log('[E2E] 列表页是新 document,重新注入脚本');
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1000);
|
||||
}
|
||||
if (!PLAY) {
|
||||
// 新 document 里 S 从 sessionStorage 恢复了 batchRunning=true,再次刹住
|
||||
await evalJS(`(() => {
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (a) { a.S.batchRunning = false; a.S.activeCourse = null; a.S.coursePhase = 'idle'; a.save(); }
|
||||
return true;
|
||||
})()`);
|
||||
await sleep(400);
|
||||
}
|
||||
const listReady = await waitFor(`!!window.__yunXueTangAuto && document.querySelectorAll('li.kng-list-new__item').length > 0`, 45000);
|
||||
await sleep(1500);
|
||||
const listInfo = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto; const cards = a.scanCards();
|
||||
const vm = (() => {
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
return v || null;
|
||||
})();
|
||||
const data = (vm && vm.kngListData) || [];
|
||||
return {
|
||||
url: location.href,
|
||||
route: a.route(),
|
||||
cards: cards.length,
|
||||
page: a.currentPage(),
|
||||
maxPage: a.maxPageNumber(),
|
||||
first3: cards.slice(0, 3).map((c) => ({ title: c.title.slice(0, 30), status: c.status })),
|
||||
vmCount: data.length,
|
||||
vmFirst: data.slice(0, 3).map((d) => ({ title: String(d.title || d.name || '').slice(0, 26), studyHours: d.studyHours, id: String(d.id || d.kngId || '').slice(0, 12) })),
|
||||
pending: cards.filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status)).length,
|
||||
};
|
||||
})())`);
|
||||
check('列表页卡片渲染', listReady === true && listInfo.cards > 0, { 卡片数: listInfo.cards, 页码: listInfo.page + '/' + listInfo.maxPage });
|
||||
check('scanCards 解析标题与状态', listInfo.first3.every((c) => c.title.length > 0), listInfo.first3);
|
||||
check('列表 Vue 组件可读(时长来源)', listInfo.vmCount > 0, { 条数: listInfo.vmCount, 样例: listInfo.vmFirst });
|
||||
const dur = listInfo.vmFirst.filter((d) => Number.isFinite(d.studyHours) && d.studyHours > 0);
|
||||
check('studyHours 时长可用(短课程优先的数据源)', dur.length > 0, dur);
|
||||
|
||||
// ---------- 5. 可选:真实进课 + 采样播放 ----------
|
||||
let beforeProgress = null;
|
||||
let playInfo = null;
|
||||
if (PLAY) {
|
||||
// 选一门「最短」的未学完课程,尽量减小对真实进度的影响
|
||||
const pick = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const cards = a.scanCards();
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
const data = (v && v.kngListData) || [];
|
||||
const byTitle = new Map();
|
||||
for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d);
|
||||
const cand = cards
|
||||
.filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status))
|
||||
.map((c) => ({ c, d: byTitle.get(c.title) }))
|
||||
.filter((x) => x.d && Number(x.d.studyHours) > 0)
|
||||
.sort((x, y) => Number(x.d.studyHours) - Number(y.d.studyHours));
|
||||
if (!cand.length) {
|
||||
const any = cards.find((c) => c.title && !/已学完|已完成|已学习/.test(c.status));
|
||||
return any ? { title: any.title, studyHours: null, idx: any.i, fallback: true } : null;
|
||||
}
|
||||
return { title: cand[0].c.title, studyHours: Number(cand[0].d.studyHours), idx: cand[0].c.i };
|
||||
})())`);
|
||||
check('找到可学的最短课程', !!pick, pick);
|
||||
if (pick) {
|
||||
log('[E2E] 选课:' + pick.title + '(' + (pick.studyHours ? Math.round(pick.studyHours / 60) + ' 分钟' : '时长未知') + ')');
|
||||
// 用脚本自己的 startCourse 走真实进课流程(会写 S.activeCourse 并点卡片)
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const card = a.scanCards().find((c) => c.i === ${pick.idx});
|
||||
if (!card) return 'no-card';
|
||||
a.startCourse(card);
|
||||
return 'started';
|
||||
})()`);
|
||||
|
||||
const entered = await waitFor(`window.__yunXueTangAuto && window.__yunXueTangAuto.route() === 'course' && /\\/play/.test(location.hash)`, 40000);
|
||||
await sleep(2500);
|
||||
const before = await json(`JSON.stringify((() => ({
|
||||
url: location.hash,
|
||||
summary: window.__yunXueTangAuto.readSummary(),
|
||||
countdown: window.__yunXueTangAuto.readCountdown(),
|
||||
lessons: window.__yunXueTangAuto.lessonItems().length,
|
||||
active: window.__yunXueTangAuto.lessonItems().length ? (document.querySelector('.yxtulcdsdk-catalog .liactive') || {}).innerText || '' : '',
|
||||
}))())`);
|
||||
beforeProgress = before.summary && before.summary.text;
|
||||
check('进入真实课程播放页', entered === true, before.url);
|
||||
check('读取到课程汇总/目录', !!before.summary || before.lessons > 0, { 汇总: before.summary && before.summary.text, 目录: before.lessons });
|
||||
|
||||
// 触发「开始学习」并观察播放器
|
||||
const play = await waitFor(`(() => {
|
||||
const v = document.querySelector('video, audio');
|
||||
return !!v && v.duration > 0;
|
||||
})()`, 25000);
|
||||
const t0 = Date.now();
|
||||
// 让主循环自己动起来(模拟用户手动打开课程时的自动连播开关)
|
||||
await evalJS(`(() => { window.__yunXueTangAuto.tick(); return true; })()`);
|
||||
await sleep(SAMPLE_SECONDS * 1000);
|
||||
|
||||
playInfo = await json(`JSON.stringify((() => {
|
||||
const v = document.querySelector('video, audio');
|
||||
const a = window.__yunXueTangAuto;
|
||||
return {
|
||||
found: !!v,
|
||||
muted: v ? v.muted : null,
|
||||
paused: v ? v.paused : null,
|
||||
rate: v ? v.playbackRate : null,
|
||||
currentTime: v ? Math.round(v.currentTime) : null,
|
||||
duration: v ? Math.round(v.duration) : null,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
elapsedSec: Math.round((Date.now() - ${t0}) / 1000),
|
||||
};
|
||||
})())`);
|
||||
check('播放器被找到并接管(静音 1x)', playInfo.found === true && playInfo.muted === true && playInfo.rate === 1, playInfo);
|
||||
check('视频真实在播放(时间在走)', playInfo.paused === false && playInfo.currentTime > 0, { 已播到: playInfo.currentTime + 's / ' + playInfo.duration + 's' });
|
||||
check('采样期间无脚本 error', scriptErrs().length === 0, scriptErrs().map((e) => e.text.slice(0, 140)));
|
||||
log(' 截图:' + await shot('e2e-02-playing.png'));
|
||||
|
||||
// 立刻停手:暂停媒体 + 关闭批量 + dispose
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.S.batchRunning = false;
|
||||
a.save();
|
||||
a.pauseAllMedia ? a.pauseAllMedia() : document.querySelectorAll('video, audio').forEach((x) => x.pause());
|
||||
return true;
|
||||
})()`);
|
||||
await sleep(1200);
|
||||
const stopped = await json(`JSON.stringify((() => {
|
||||
const v = document.querySelector('video, audio');
|
||||
return { paused: v ? v.paused : null, running: window.__yunXueTangAuto ? window.__yunXueTangAuto.S.batchRunning : null,
|
||||
summary: window.__yunXueTangAuto ? window.__yunXueTangAuto.readSummary() : null };
|
||||
})())`);
|
||||
check('停止后媒体已暂停', stopped.paused === true && stopped.running === false, stopped);
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 6. 释放脚本,确认无残留 ----------
|
||||
if (PLAY) {
|
||||
const disposed = await json(`JSON.stringify((() => {
|
||||
window.__yunXueTangDispose();
|
||||
return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto };
|
||||
})())`);
|
||||
check('dispose 后面板与 API 清理干净', disposed.panel === false && disposed.api === 'undefined', disposed);
|
||||
}
|
||||
|
||||
log('\n[E2E] 脚本日志(' + consoleLogs.filter((l) => /云学堂助手/.test(l.text)).length + ' 条脚本相关):');
|
||||
for (const l of consoleLogs.filter((x) => /云学堂助手/.test(x.text)).slice(-25)) log(' [' + l.type + '] ' + l.text.slice(0, 170));
|
||||
if (beforeProgress) log('[E2E] 进度快照:进入前「' + beforeProgress + '」→ 采样后「' + (playInfo && playInfo.summary && playInfo.summary.text) + '」');
|
||||
} catch (e) {
|
||||
check('E2E 流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 5).join(' | ') : String(e));
|
||||
} finally {
|
||||
if (cdp && !KEEP) cdp.close();
|
||||
if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} }
|
||||
if (!KEEP) { await sleep(700); try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {} }
|
||||
else log('[E2E] --keep:浏览器保持打开 ' + userDataDir);
|
||||
}
|
||||
|
||||
const failed = results.filter((r) => !r.ok);
|
||||
log('\n===== E2E 结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' =====');
|
||||
for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail));
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -1,468 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 真机持续运行测试:跨章节 + 跨课程。
|
||||
*
|
||||
* 真实 Chrome + 真实账号,让脚本自己跑列表刷课,观察它能否
|
||||
* 1) 在一门多课时课程里自动从第 N 节切到第 N+1 节(跨章节)
|
||||
* 2) 一门课完成后回到列表、进下一门课(跨课程)
|
||||
* 3) 每次整页跳转(新 document)后重新注入并接续运行
|
||||
* 4) 全程视频持续推进、无脚本 error、没学完的课程按退避重试而不是被跳过
|
||||
*
|
||||
* 用法:
|
||||
* node dev/real-run.mjs --scan 只登录 + 列表,打印所有卡片(只读)
|
||||
* node dev/real-run.mjs --probe 8 读前 8 门课最短的「未学完」课的目录(不进播放,不动进度)
|
||||
* node dev/real-run.mjs --max 2 --budget 15 跑批量,最多完成 2 门 / 最多 15 分钟
|
||||
* node dev/real-run.mjs --title 坚持 --max 2 先把匹配标题的课程跑完,再自动跑下一门
|
||||
* node dev/real-run.mjs --headless --keep 无头 / 跑完不关浏览器
|
||||
* node dev/real-run.mjs --out run.json 时间线写到指定文件(默认临时目录)
|
||||
*
|
||||
* 注意:这个测试会**真实推进学习进度**(这就是它的目的)。
|
||||
* 只读的登录/列表测试请看 dev/real-e2e.mjs。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
// 本文件在 dev/tests/ 下,仓库根目录是上两级
|
||||
const ROOT = path.resolve(HERE, '..', '..');
|
||||
const SCRIPT_SRC = fs.readFileSync(path.join(ROOT, 'yun-xue-tang-assistant.user.js'), 'utf8');
|
||||
|
||||
const argv = process.argv.slice(2);
|
||||
const flag = (n) => argv.includes(n);
|
||||
const opt = (n, d) => {
|
||||
const i = argv.indexOf(n);
|
||||
return i >= 0 && argv[i + 1] ? argv[i + 1] : d;
|
||||
};
|
||||
|
||||
const USR = process.env.YUN_XUE_TANG_USR || '';
|
||||
const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||||
const SCAN = flag('--scan');
|
||||
const PROBE = flag('--probe') ? Number(opt('--probe', 8)) : 0;
|
||||
const HEADLESS = flag('--headless') || process.env.YUN_XUE_TANG_HEADLESS === '1';
|
||||
const KEEP = flag('--keep');
|
||||
const MAX_COURSES = Number(opt('--max', 2));
|
||||
const BUDGET_MIN = Number(opt('--budget', 15));
|
||||
const PIN_TITLE = opt('--title', '');
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9335);
|
||||
const ORIGIN = 'https://kfmic.yunxuetang.cn';
|
||||
const OUT = opt('--out', path.join(os.tmpdir(), 'yun-xue-tang-run-' + Date.now() + '.json'));
|
||||
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/chromium',
|
||||
].filter(Boolean);
|
||||
const CHROME = findChrome(CANDIDATES);
|
||||
|
||||
const results = [];
|
||||
const consoleLogs = [];
|
||||
const timeline = [];
|
||||
const log = (...a) => console.log(...a);
|
||||
const clock = () => new Date().toISOString().slice(11, 19);
|
||||
function check(name, ok, detail) {
|
||||
results.push({ name, ok: !!ok, detail });
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
}
|
||||
|
||||
if (!CHROME) { console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=... 指定'); process.exit(2); }
|
||||
if (!USR || !PWD) { console.error('缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD'); process.exit(2); }
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
console.error('需要 Node 22+,当前 ' + process.version);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
log('[RUN] 账号:' + USR.slice(0, 3) + '***' + USR.slice(-2));
|
||||
log('[RUN] 模式:' + (SCAN ? '只读扫描列表' : (PROBE ? '只读探测前 ' + PROBE + ' 门课的目录' : '批量持续运行(最多 ' + MAX_COURSES + ' 门 / ' + BUDGET_MIN + ' 分钟)')) +
|
||||
(PIN_TITLE ? ' 指定课程:' + PIN_TITLE : ''));
|
||||
|
||||
// Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数
|
||||
const HEADLESS_ONLY = HEADLESS || forceHeadless();
|
||||
const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-run-'));
|
||||
const args = [
|
||||
`--remote-debugging-port=${PORT}`,
|
||||
`--user-data-dir=${userDataDir}`,
|
||||
'--no-first-run', '--no-default-browser-check', '--disable-sync',
|
||||
// 后台标签页/最小化时不要把定时器和视频节流,否则「持续运行」测不准
|
||||
'--disable-background-timer-throttling', '--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
'--autoplay-policy=no-user-gesture-required',
|
||||
'--window-size=1360,940',
|
||||
].concat(safetyArgs(), ['about:blank']);
|
||||
if (HEADLESS_ONLY) args.unshift('--headless=new');
|
||||
|
||||
let chrome = null;
|
||||
let cdp = null;
|
||||
|
||||
log('[RUN] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless)' : '(有界面)'));
|
||||
|
||||
try {
|
||||
chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true });
|
||||
|
||||
let version = null;
|
||||
for (let i = 0; i < 100; i++) {
|
||||
try { const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`); if (v && v.webSocketDebuggerUrl) { version = v; break; } } catch (e) {}
|
||||
await sleep(250);
|
||||
}
|
||||
if (!version) throw new Error('Chrome CDP 未就绪');
|
||||
log('[RUN] ' + version.Browser);
|
||||
|
||||
const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(ORIGIN + '/login.html')}`, 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
consoleLogs.push({ t: Date.now(), type: m.params.type, text: String(text) });
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
consoleLogs.push({ t: Date.now(), type: m.params.entry.level, text: m.params.entry.text });
|
||||
}
|
||||
});
|
||||
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true, userGesture: true });
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
const waitFor = async (exprFn, timeoutMs) => {
|
||||
const started = Date.now();
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
try { if (await evalJS(exprFn)) return true; } catch (e) {}
|
||||
await sleep(500);
|
||||
}
|
||||
return false;
|
||||
};
|
||||
|
||||
// ---------- 整页跳转后自动重新注入(等价 Tampermonkey 按 @match 重注入) ----------
|
||||
let injections = 0;
|
||||
let reinjectTimer = null;
|
||||
const injectIfMissing = async () => {
|
||||
let t;
|
||||
try { t = await evalJS('typeof window.__yunXueTangAuto'); } catch (e) { return false; }
|
||||
if (t === 'object') return false;
|
||||
try {
|
||||
await evalJS(SCRIPT_SRC);
|
||||
injections++;
|
||||
return true;
|
||||
} catch (e) { return false; }
|
||||
};
|
||||
// 每 1.5 秒兜底检查一次:任何原因导致脚本不在,就补注入(真实环境里由 @match 保证)
|
||||
const startWatchdog = () => {
|
||||
if (reinjectTimer) clearInterval(reinjectTimer);
|
||||
reinjectTimer = setInterval(() => {
|
||||
injectIfMissing().then((did) => {
|
||||
if (did) console.log('[RUN] ' + clock() + ' 新 document 已重新注入(第 ' + injections + ' 次)');
|
||||
}).catch(() => {});
|
||||
}, 1500);
|
||||
};
|
||||
|
||||
const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null);
|
||||
await cdp.send('Page.navigate', { url: ORIGIN + '/login.html' });
|
||||
await loaded;
|
||||
await sleep(2000);
|
||||
|
||||
// ---------- 登录 ----------
|
||||
await evalJS(SCRIPT_SRC);
|
||||
injections++;
|
||||
await sleep(1200);
|
||||
const loginPage = await evalJS(`!!(window.__yunXueTangAuto && window.__yunXueTangAuto.isLoginPage())`);
|
||||
check('登录页脚本就绪', loginPage === true, await evalJS('location.pathname'));
|
||||
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.fillLoginForm(${JSON.stringify(USR)}, ${JSON.stringify(PWD)});
|
||||
try { a.checkLoginAgreement(); } catch (e) {}
|
||||
return true;
|
||||
})()`);
|
||||
await evalJS(`(document.getElementById('yun-xue-tang-oneclick').click(), true)`);
|
||||
const loginOk = await waitFor(`(() => {
|
||||
if (/\\/login/.test(location.pathname)) return false;
|
||||
if (!document.body) return false;
|
||||
return !document.querySelector('input[type=password]');
|
||||
})()`, 45000);
|
||||
check('真实登录成功', loginOk === true, await evalJS('location.pathname'));
|
||||
|
||||
// 进列表(新 document)
|
||||
const loaded2 = cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null);
|
||||
await evalJS(`(location.href = '${ORIGIN}/kng/#/list', true)`);
|
||||
await loaded2;
|
||||
await sleep(2500);
|
||||
await injectIfMissing();
|
||||
if (injections === 1) injections++; // 上面那次是列表页注入
|
||||
await waitFor(`!!window.__yunXueTangAuto && window.__yunXueTangAuto.scanCards().length > 0`, 45000);
|
||||
await sleep(1500);
|
||||
|
||||
// 优先短课程(缩短验证耗时;真机上这是默认勾选行为)
|
||||
await evalJS(`(() => { try { localStorage.setItem('yun-xue-tang-prefer-short', '1'); } catch (e) {} const a = window.__yunXueTangAuto; if (a) a.state.preferShortCourses = true; return true; })()`);
|
||||
|
||||
// ---------- --probe:只读探测目录(关掉自动播放,避免动进度) ----------
|
||||
if (PROBE) {
|
||||
// 当前课程自动连播开关关掉:进课后脚本不会自动起播、也不会自动切节
|
||||
await evalJS(`(() => { localStorage.setItem('yun-xue-tang-auto-play-enabled', '0'); const a = window.__yunXueTangAuto; if (a) a.state.autoPlayEnabled = false; return true; })()`);
|
||||
const picks = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
const data = (v && v.kngListData) || [];
|
||||
const byTitle = new Map();
|
||||
for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d);
|
||||
return a.scanCards()
|
||||
.filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status))
|
||||
.map((c) => {
|
||||
const d = byTitle.get(c.title) || {};
|
||||
return { i: c.i, title: c.title, studyHours: Number(d.studyHours) || 0, id: String(d.id || '') };
|
||||
})
|
||||
.filter((c) => c.studyHours > 0)
|
||||
.sort((x, y) => x.studyHours - y.studyHours)
|
||||
.slice(0, ${PROBE});
|
||||
})())`);
|
||||
log('\n[RUN] 探测 ' + picks.length + ' 门课(按总时长正序):');
|
||||
const report = [];
|
||||
for (const p of picks) {
|
||||
await evalJS(`(() => {
|
||||
try { localStorage.setItem('yun-xue-tang-auto-play-enabled', '0'); } catch (e) {}
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.state.autoPlayEnabled = false;
|
||||
const card = a.scanCards().find((c) => c.i === ${p.i});
|
||||
if (card) a.startCourse(card);
|
||||
return true;
|
||||
})()`).catch(() => {});
|
||||
const ok = await waitFor(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
return !!a && a.route() === 'course' && a.lessonItems().length > 0;
|
||||
})()`, 25000);
|
||||
let info = null;
|
||||
if (ok) {
|
||||
await sleep(1200);
|
||||
info = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const items = a.lessonItems();
|
||||
return {
|
||||
lessons: items.length,
|
||||
completed: items.filter((li) => a.isLessonCompleted(li)).length,
|
||||
quiz: /考试|测验|问卷|答题/.test((document.querySelector('.yxtulcdsdk-catalog') || {}).innerText || ''),
|
||||
names: items.map((li) => ((li.innerText || '').replace(/\\s+/g, ' ').trim()).slice(0, 22)),
|
||||
summary: a.readSummary(),
|
||||
};
|
||||
})())`);
|
||||
}
|
||||
const remaining = info ? info.lessons - info.completed : 0;
|
||||
log(' ' + (info ? (info.lessons + ' 节/剩 ' + remaining + (info.quiz ? ' [含考试]' : '')) : '进课失败').padEnd(18) +
|
||||
' ' + String(Math.round(p.studyHours / 60)).padStart(4) + ' 分 ' + p.title.slice(0, 40));
|
||||
report.push({ ...p, ...(info || {}), remaining });
|
||||
// 回列表
|
||||
await evalJS(`(location.href = '${ORIGIN}/kng/#/list', true)`).catch(() => {});
|
||||
await sleep(2500);
|
||||
await injectIfMissing();
|
||||
await waitFor(`!!window.__yunXueTangAuto && window.__yunXueTangAuto.scanCards().length > 0`, 40000);
|
||||
await sleep(1200);
|
||||
}
|
||||
const multi = report.filter((r) => r.remaining >= 2 && !r.quiz);
|
||||
log('\n[RUN] 适合测「跨章节」的候选(≥2 节未学完且不含考试):');
|
||||
for (const m of multi) log(' ' + m.remaining + ' 节待学 ' + m.title.slice(0, 40) + ' → ' + m.names.join(' / '));
|
||||
check('找到可跨章节验证的课程(≥2 节未学完)', multi.length > 0, multi.slice(0, 5).map((m) => ({ title: m.title.slice(0, 30), remaining: m.remaining })));
|
||||
fs.writeFileSync(path.join(os.tmpdir(), 'yun-xue-tang-probe.json'), JSON.stringify(report, null, 2));
|
||||
} else if (SCAN) {
|
||||
const cards = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
const data = (v && v.kngListData) || [];
|
||||
const byTitle = new Map();
|
||||
for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d);
|
||||
return a.scanCards().map((c) => {
|
||||
const d = byTitle.get(c.title) || {};
|
||||
return { title: c.title, status: c.status, studyHours: d.studyHours, id: String(d.id || '') };
|
||||
});
|
||||
})())`);
|
||||
log('\n[RUN] 列表卡片(' + cards.length + ' 张):');
|
||||
for (const c of cards) {
|
||||
log(' ' + (c.status || '-').padEnd(4) + ' ' +
|
||||
(c.studyHours ? String(Math.round(c.studyHours / 60)).padStart(5) + ' 分' : ' ? 分') +
|
||||
' ' + c.title.slice(0, 46));
|
||||
}
|
||||
check('列表可读', cards.length > 0, { 卡片数: cards.length });
|
||||
} else {
|
||||
// ---------- 启动批量 ----------
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.S.completedThisRun = 0;
|
||||
a.S.batchFinished = false;
|
||||
a.startBatch();
|
||||
return true;
|
||||
})()`);
|
||||
await sleep(1500);
|
||||
|
||||
// 指定课程:进入列表后抢先开始它(S.batchRunning 先关掉,避免 listTick 抢选别的课)
|
||||
if (PIN_TITLE) {
|
||||
const armed = await waitFor(`window.__yunXueTangAuto && window.__yunXueTangAuto.route() === 'list' && window.__yunXueTangAuto.scanCards().length > 0`, 60000);
|
||||
if (armed) {
|
||||
const pinned = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.S.batchRunning = false; a.save();
|
||||
const card = a.scanCards().find((c) => c.title.indexOf(${JSON.stringify(PIN_TITLE)}) >= 0);
|
||||
if (!card) { a.S.batchRunning = true; a.save(); return { ok: false }; }
|
||||
a.startCourse(card);
|
||||
a.S.batchRunning = true; a.save();
|
||||
return { ok: true, title: card.title };
|
||||
})())`);
|
||||
check('已指定首门课程并开始', pinned.ok === true, pinned);
|
||||
} else {
|
||||
check('已指定首门课程并开始', false, '列表未就绪');
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 持续监控 ----------
|
||||
const startedAt = Date.now();
|
||||
const deadline = startedAt + BUDGET_MIN * 60 * 1000;
|
||||
let lastSig = '';
|
||||
let lastSample = null;
|
||||
let lastAdvanceAt = Date.now();
|
||||
let lastCt = 0;
|
||||
let maxStallMs = 0;
|
||||
const perCourse = new Map(); // title -> lesson keys seen
|
||||
const transitions = []; // { t, from, to, course }
|
||||
let playEvidence = 0; // currentTime 增长次数
|
||||
|
||||
const sample = async () => {
|
||||
try {
|
||||
return await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (!a) return { gone: true, href: location.href };
|
||||
const v = document.querySelector('video, audio');
|
||||
const items = a.lessonItems();
|
||||
return {
|
||||
href: location.href,
|
||||
route: a.route(),
|
||||
phase: a.S.coursePhase,
|
||||
running: a.S.batchRunning,
|
||||
runFinished: a.S.batchFinished,
|
||||
completed: a.S.completedThisRun,
|
||||
pendingRetries: Object.keys(a.S.courseRetries || {}).length,
|
||||
cur: a.S.activeCourse ? a.S.activeCourse.title : null,
|
||||
curId: a.S.activeCourse ? a.S.activeCourse.id : null,
|
||||
lesson: a.readActiveLessonKey ? a.readActiveLessonKey() : '',
|
||||
lessonCount: items.length,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
video: v ? { ct: Math.round(v.currentTime), dur: Math.round(v.duration), paused: v.paused, muted: v.muted, rate: v.playbackRate } : null,
|
||||
done: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryTitles: Object.keys(a.S.courseRetries || {}).length,
|
||||
};
|
||||
})())`);
|
||||
} catch (e) {
|
||||
return null; // 跳转中 DOM 不可用
|
||||
}
|
||||
};
|
||||
|
||||
log('\n[RUN] 开始持续监控(Ctrl+C 或到点自动结束)…\n');
|
||||
while (Date.now() < deadline) {
|
||||
const s = await sample();
|
||||
if (s && !s.gone) {
|
||||
lastSample = s;
|
||||
// 视频推进证据
|
||||
if (s.video && !s.video.paused && s.video.ct > lastCt) {
|
||||
playEvidence++;
|
||||
lastAdvanceAt = Date.now();
|
||||
lastCt = s.video.ct;
|
||||
} else if (s.video && s.video.paused && s.video.ct !== lastCt) {
|
||||
lastCt = s.video.ct;
|
||||
}
|
||||
if (Date.now() - lastAdvanceAt > maxStallMs) maxStallMs = Date.now() - lastAdvanceAt;
|
||||
|
||||
// 每门课出现过的课时
|
||||
if (s.cur) {
|
||||
if (!perCourse.has(s.cur)) perCourse.set(s.cur, []);
|
||||
const keys = perCourse.get(s.cur);
|
||||
if (s.lesson && keys[keys.length - 1] !== s.lesson) keys.push(s.lesson);
|
||||
}
|
||||
|
||||
const sig = [s.cur, s.lesson, s.completed, s.phase, s.runFinished].join('|');
|
||||
if (sig !== lastSig) {
|
||||
const prev = lastSample && lastSig ? lastSig.split('|') : null;
|
||||
log('[RUN] ' + clock() + ' ' + (s.cur ? s.cur.slice(0, 26) : '(列表)') +
|
||||
' ' + (s.phase || '-') + (s.runFinished ? ' [已停止]' : '') +
|
||||
' 完成 ' + s.completed + ' 待重试 ' + s.pendingRetries +
|
||||
(s.lesson ? ' 课时:' + s.lesson.slice(0, 30) : '') +
|
||||
(s.summary ? ' 汇总:' + s.summary.text : '') +
|
||||
(s.countdown != null ? ' 倒计时 ' + s.countdown + 's' : ''));
|
||||
if (prev && prev[0] && s.cur && prev[0] === s.cur && prev[1] && s.lesson && prev[1] !== s.lesson) {
|
||||
transitions.push({ t: Date.now() - startedAt, course: s.cur, from: prev[1], to: s.lesson });
|
||||
}
|
||||
timeline.push({ at: Date.now() - startedAt, ...s });
|
||||
lastSig = sig;
|
||||
}
|
||||
|
||||
if (s.completed >= MAX_COURSES) { log('\n[RUN] 已完成 ' + s.completed + ' 门,达到上限,收尾'); break; }
|
||||
if (s.runFinished) { log('\n[RUN] 脚本自己停止了:' + s.status); break; }
|
||||
if (s.runFinished && /重试 .* 次仍未完成/.test(s.status || '')) { log('[RUN] 重试用尽,脚本已停止,收尾'); break; }
|
||||
}
|
||||
await sleep(2000);
|
||||
}
|
||||
|
||||
const elapsed = Math.round((Date.now() - startedAt) / 1000);
|
||||
const errors = consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text));
|
||||
const final = (await sample()) || lastSample || {};
|
||||
|
||||
check('持续运行未因脚本 exception 中断', errors.length === 0, errors.map((e) => e.text.slice(0, 140)));
|
||||
check('批处理仍在运行或已按上限结束', final.runFinished !== undefined, { running: final.running, runFinished: final.runFinished });
|
||||
check('至少完成 2 门课程(跨课程)', (final.completed || 0) >= 2, { 完成: final.completed, 用时秒: elapsed });
|
||||
check('观察到课时自动切换(跨章节)', transitions.length >= 1, { 切换次数: transitions.length, 明细: transitions.map((x) => x.from.slice(0, 14) + ' → ' + x.to.slice(0, 14)) });
|
||||
check('视频持续推进(无长时间卡死)', playEvidence >= 3 && maxStallMs < 120000, { 推进采样: playEvidence, 最长停滞秒: Math.round(maxStallMs / 1000) });
|
||||
check('整页跳转后自动恢复(重新注入)', injections >= 2, { 注入次数: injections });
|
||||
check('没有课程被永久跳过(重试计数可控)', (final.retryTitles || 0) < 5, { 待重试标题: final.retryTitles });
|
||||
|
||||
log('\n[RUN] 每门课观察到的课时:');
|
||||
for (const [title, keys] of perCourse) {
|
||||
log(' ' + title.slice(0, 34) + ' → ' + keys.length + ' 节:' + keys.map((k) => k.slice(0, 18)).join(' / '));
|
||||
}
|
||||
log('[RUN] 完成后本地已记录 done:' + (final.done || 0) + ' 门;用时 ' + Math.round(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒');
|
||||
|
||||
// 收尾:停批量 + 暂停媒体
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (a) { a.S.batchRunning = false; a.save(); if (a.pauseAllMedia) a.pauseAllMedia(); }
|
||||
return true;
|
||||
})()`).catch(() => {});
|
||||
await sleep(1000);
|
||||
const disposed = await json(`JSON.stringify((() => {
|
||||
try { window.__yunXueTangDispose(); } catch (e) {}
|
||||
return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto };
|
||||
})())`).catch(() => ({ panel: null, api: 'n/a' }));
|
||||
check('dispose 后面板与 API 清理干净', disposed.panel === false && disposed.api === 'undefined', disposed);
|
||||
}
|
||||
|
||||
log('\n[RUN] 脚本日志(' + consoleLogs.filter((l) => /云学堂助手/.test(l.text)).length + ' 条):');
|
||||
for (const l of consoleLogs.filter((x) => /云学堂助手/.test(x.text)).slice(-40)) log(' [' + l.type + '] ' + l.text.slice(0, 170));
|
||||
} catch (e) {
|
||||
check('持续运行流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 5).join(' | ') : String(e));
|
||||
} finally {
|
||||
if (cdp && !KEEP) cdp.close();
|
||||
if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} }
|
||||
if (!KEEP) { await sleep(700); try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {} }
|
||||
else log('[RUN] --keep:浏览器保持打开 ' + userDataDir);
|
||||
try {
|
||||
fs.writeFileSync(OUT, JSON.stringify({ timeline, results, logs: consoleLogs.slice(-400) }, null, 2));
|
||||
log('[RUN] 时间线已写入 ' + OUT);
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
const failed = results.filter((r) => !r.ok);
|
||||
log('\n===== RUN 结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' =====');
|
||||
for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail));
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -1,329 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 真机测试:真实 Chrome + 真实 https://kfmic.yunxuetang.cn 页面。
|
||||
*
|
||||
* 做法:启动一个独立用户目录的 Chrome(不碰你日常配置),通过 CDP 把打包产物
|
||||
* yun-xue-tang-assistant.user.js 注入页面主世界——这与 Tampermonkey 在
|
||||
* @grant none 下的执行环境一致,所以断言的是脚本在真实浏览器 / 真实站点
|
||||
* DOM 上的行为,而不是 Node 里的 DOM 桩。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/real-test.mjs 有界面浏览器(默认,最接近真机)
|
||||
* node dev/real-test.mjs --headless 无头模式(CI 用)
|
||||
* node dev/real-test.mjs --keep 跑完不关浏览器(便于人工肉眼复核)
|
||||
*
|
||||
* 环境变量:
|
||||
* YUN_XUE_TANG_CHROME Chrome/Edge 可执行文件路径
|
||||
* YUN_XUE_TANG_CDP_PORT 调试端口,默认 9333
|
||||
* YUN_XUE_TANG_URL 起始页面,默认 https://kfmic.yunxuetang.cn/login.html
|
||||
* YUN_XUE_TANG_SHOT_DIR 截图目录,默认 .run-tmp/screenshots(不入库)
|
||||
*
|
||||
* 需要 Node 22+(用到全局 WebSocket 与 fetch);只做只读探测:
|
||||
* 不填写账号密码、不点登录、不修改线上数据。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
// 本文件在 dev/tests/ 下,仓库根目录是上两级
|
||||
const ROOT = path.resolve(HERE, '..', '..');
|
||||
const SCRIPT_FILE = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
|
||||
const SCRIPT_SRC = fs.readFileSync(SCRIPT_FILE, 'utf8');
|
||||
// 版本号只有 package.json 一个来源(与 build.mjs 注入产物的一致),避免断言写死后每次升版都要改测试
|
||||
const VERSION = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).version;
|
||||
const EXPECT_VERSION = 'v' + VERSION;
|
||||
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/chromium',
|
||||
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
|
||||
].filter(Boolean);
|
||||
|
||||
const CHROME = findChrome(CANDIDATES);
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9333);
|
||||
const START_URL = process.env.YUN_XUE_TANG_URL || 'https://kfmic.yunxuetang.cn/login.html';
|
||||
const HEADLESS = process.env.YUN_XUE_TANG_HEADLESS === '1' || process.argv.includes('--headless');
|
||||
const KEEP = process.env.YUN_XUE_TANG_KEEP === '1' || process.argv.includes('--keep');
|
||||
const SHOT_DIR = process.env.YUN_XUE_TANG_SHOT_DIR || path.join(ROOT, '.run-tmp', 'screenshots');
|
||||
|
||||
const results = [];
|
||||
const consoleLogs = [];
|
||||
const log = (...a) => console.log(...a);
|
||||
|
||||
function check(name, ok, detail) {
|
||||
results.push({ name, ok: !!ok, detail });
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
}
|
||||
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
console.error('需要 Node 22 及以上(依赖全局 WebSocket / fetch),当前 ' + process.version);
|
||||
process.exit(2);
|
||||
}
|
||||
if (!CHROME) {
|
||||
console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=/path/to/chrome 指定');
|
||||
process.exit(2);
|
||||
}
|
||||
if (!fs.existsSync(SCRIPT_FILE)) {
|
||||
console.error('缺少构建产物,先运行 npm run build');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
// Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数
|
||||
const HEADLESS_ONLY = HEADLESS || forceHeadless();
|
||||
const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-chrome-'));
|
||||
const args = [
|
||||
`--remote-debugging-port=${PORT}`,
|
||||
`--user-data-dir=${userDataDir}`,
|
||||
'--no-first-run', '--no-default-browser-check', '--disable-sync',
|
||||
'--disable-background-timer-throttling', '--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
'--window-size=1280,900',
|
||||
].concat(safetyArgs(), ['about:blank']);
|
||||
if (HEADLESS_ONLY) args.unshift('--headless=new');
|
||||
|
||||
let chrome = null;
|
||||
let cdp = null;
|
||||
|
||||
try {
|
||||
log('[真机] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless=new)' : '(有界面)'));
|
||||
chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true });
|
||||
|
||||
// ---- 1. 等 CDP 就绪 ----
|
||||
let version = null;
|
||||
for (let i = 0; i < 100; i++) {
|
||||
try {
|
||||
const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`);
|
||||
if (v && v.webSocketDebuggerUrl) { version = v; break; }
|
||||
} catch (e) { /* 还没起来 */ }
|
||||
await sleep(250);
|
||||
}
|
||||
if (!version) throw new Error('Chrome CDP 端口未就绪(' + PORT + ')');
|
||||
check('真实浏览器进程启动', /^(Chrome|HeadlessChrome|Edg)\//.test(version.Browser || ''), version.Browser);
|
||||
|
||||
// ---- 2. 打开真实页面 ----
|
||||
const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(START_URL)}`, 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
await cdp.send('Network.enable');
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
consoleLogs.push({ type: m.params.type, text: String(text) });
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
consoleLogs.push({ type: m.params.entry.level, text: m.params.entry.text });
|
||||
}
|
||||
});
|
||||
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', {
|
||||
expression: expr, returnByValue: true, awaitPromise: true, userGesture: true,
|
||||
});
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
|
||||
const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null);
|
||||
await cdp.send('Page.navigate', { url: START_URL });
|
||||
await loaded;
|
||||
await sleep(1800);
|
||||
|
||||
const page = await json(`JSON.stringify({ url: location.href, title: document.title, host: location.host, ua: navigator.userAgent })`);
|
||||
log('[真机] 页面:' + page.url);
|
||||
log('[真机] 标题:' + page.title);
|
||||
check('落在真实云学堂页面', /(^|\.)yunxuetang\.cn$/.test(page.host), page.host);
|
||||
check('真实浏览器内核', /Chrome\//.test(page.ua), page.ua.slice(0, 96) + '…');
|
||||
|
||||
// ---- 3. 注入(等价 Tampermonkey @grant none 主世界执行)----
|
||||
check('注入前页面无残留实例', (await evalJS('typeof window.__yunXueTangAuto')) === 'undefined', await evalJS('typeof window.__yunXueTangAuto'));
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1200);
|
||||
|
||||
const loadedLog = consoleLogs.find((l) => /云学堂助手 v[\d.]+ 已加载/.test(l.text));
|
||||
check('控制台打印加载日志', !!loadedLog, loadedLog && loadedLog.text);
|
||||
|
||||
// ---- 4. 面板在真实 DOM 里的渲染 ----
|
||||
const panel = await json(`JSON.stringify((() => {
|
||||
const el = document.getElementById('yun-xue-tang-panel');
|
||||
if (!el) return null;
|
||||
const r = el.getBoundingClientRect();
|
||||
const cs = getComputedStyle(el);
|
||||
return {
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent || '',
|
||||
w: Math.round(r.width), h: Math.round(r.height),
|
||||
right: Math.round(innerWidth - r.right), bottom: Math.round(innerHeight - r.bottom),
|
||||
visible: cs.display !== 'none' && cs.visibility !== 'hidden' && Number(cs.opacity) > 0,
|
||||
position: cs.position, zIndex: cs.zIndex,
|
||||
buttons: [...el.querySelectorAll('button')].map((b) => b.textContent.trim()),
|
||||
inputTypes: [...el.querySelectorAll('input')].map((i) => i.type),
|
||||
text: el.innerText.replace(/\\s+/g, ' ').trim().slice(0, 220),
|
||||
};
|
||||
})())`);
|
||||
check('面板渲染进真实 DOM 且可见', panel && panel.visible && panel.w > 0 && panel.h > 0,
|
||||
panel && { 宽: panel.w, 高: panel.h, position: panel.position, zIndex: panel.zIndex });
|
||||
check('面板版本号 ' + EXPECT_VERSION, panel && panel.version === EXPECT_VERSION, panel && panel.version);
|
||||
check('固定在右下角', panel && panel.right >= 0 && panel.right < 40 && panel.bottom >= 0 && panel.bottom < 40,
|
||||
panel && { 距右: panel.right, 距下: panel.bottom });
|
||||
check('面板含按钮与密码框', panel && panel.buttons.length >= 2 && panel.inputTypes.includes('password'),
|
||||
panel && { 按钮: panel.buttons, 输入框: panel.inputTypes });
|
||||
|
||||
// ---- 5. 真实页面上调试入口 / 页面识别 ----
|
||||
const api = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (!a) return null;
|
||||
return {
|
||||
keys: Object.keys(a).length,
|
||||
route: a.route(),
|
||||
isLoginPage: a.isLoginPage(),
|
||||
hasDispose: typeof window.__yunXueTangDispose === 'function',
|
||||
courseId: a.courseIdFromUrl(),
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
};
|
||||
})())`);
|
||||
check('window.__yunXueTangAuto 调试入口存在', !!api && api.keys > 20, api && { 导出项: api.keys });
|
||||
check('真实登录页被正确识别', api && api.isLoginPage === true, api && { route: api.route, isLoginPage: api.isLoginPage });
|
||||
check('__yunXueTangDispose 可用(热替换前提)', api && api.hasDispose === true, api && api.hasDispose);
|
||||
check('登录页上 readSummary/readCountdown 安全返回 null',
|
||||
api && api.summary === null && api.countdown === null, api && { summary: api.summary, countdown: api.countdown });
|
||||
|
||||
// ---- 6. 真实点击面板按钮(不填账号,只验证不崩)----
|
||||
const click = await json(`JSON.stringify((() => {
|
||||
const panel = document.getElementById('yun-xue-tang-panel');
|
||||
const btn = document.getElementById('yun-xue-tang-oneclick');
|
||||
if (!btn) return { error: 'no #yun-xue-tang-oneclick' };
|
||||
btn.click();
|
||||
return {
|
||||
label: btn.textContent.trim(),
|
||||
panelVisibleAfter: getComputedStyle(panel).display !== 'none',
|
||||
statusLine: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
panelText: panel.innerText.replace(/\\s+/g, ' ').slice(0, 200),
|
||||
};
|
||||
})())`);
|
||||
await sleep(800);
|
||||
const afterClick = await json(`JSON.stringify(({
|
||||
url: location.href,
|
||||
alive: typeof window.__yunXueTangAuto,
|
||||
panel: !!document.getElementById('yun-xue-tang-panel'),
|
||||
}))`);
|
||||
check('点击「一键登录并刷课」不崩溃', afterClick.alive === 'object' && afterClick.panel === true, { 点击前标签: click.label, ...afterClick });
|
||||
|
||||
const scriptErrors = () => consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text));
|
||||
check('无脚本自身 error 日志', scriptErrors().length === 0, scriptErrors().map((e) => e.text.slice(0, 140)));
|
||||
|
||||
// ---- 7. 真实 localStorage 读写 ----
|
||||
const ls = await json(`JSON.stringify((() => {
|
||||
const before = localStorage.getItem('yun-xue-tang-auto-play-enabled');
|
||||
localStorage.setItem('yun-xue-tang-auto-play-enabled', '0');
|
||||
const read = localStorage.getItem('yun-xue-tang-auto-play-enabled');
|
||||
if (before === null) localStorage.removeItem('yun-xue-tang-auto-play-enabled'); else localStorage.setItem('yun-xue-tang-auto-play-enabled', before);
|
||||
return { read, keys: Object.keys(localStorage).filter((k) => k.indexOf('yun-xue-tang-') === 0) };
|
||||
})())`);
|
||||
check('真实 localStorage 可读写', ls.read === '0', ls);
|
||||
|
||||
// ---- 8. 真实热替换:dispose → 重新注入 ----
|
||||
const hot = await json(`JSON.stringify((() => {
|
||||
window.__yunXueTangDispose();
|
||||
return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto, dispose: typeof window.__yunXueTangDispose };
|
||||
})())`);
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(900);
|
||||
const hot2 = await json(`JSON.stringify({
|
||||
count: document.querySelectorAll('#yun-xue-tang-panel').length,
|
||||
api: typeof window.__yunXueTangAuto,
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent,
|
||||
timers: 'n/a',
|
||||
})`);
|
||||
check('dispose 后真实 DOM 面板被移除', hot.panel === false && hot.api === 'undefined',
|
||||
hot);
|
||||
check('重新注入后面板唯一且版本正确', hot2.count === 1 && hot2.api === 'object' && hot2.version === EXPECT_VERSION, hot2);
|
||||
|
||||
// ---- 9. 截图存证 ----
|
||||
try {
|
||||
fs.mkdirSync(SHOT_DIR, { recursive: true });
|
||||
const shot = await cdp.send('Page.captureScreenshot', { format: 'png' });
|
||||
const file = path.join(SHOT_DIR, 'real-chrome-login.png');
|
||||
fs.writeFileSync(file, Buffer.from(shot.data, 'base64'));
|
||||
const size = fs.statSync(file).size;
|
||||
check('真机截图已保存', size > 5000, path.relative(ROOT, file) + ' (' + size + ' 字节)');
|
||||
} catch (e) {
|
||||
check('真机截图已保存', false, e.message);
|
||||
}
|
||||
|
||||
// ---- 10. SPA 内 hash 路由(不换 document):脚本靠 hashchange 自更新,不需要重新注入 ----
|
||||
const hashNav = await json(`JSON.stringify((() => {
|
||||
location.hash = '#/list';
|
||||
return { hash: location.hash, route: window.__yunXueTangAuto.route(), panel: !!document.getElementById('yun-xue-tang-panel') };
|
||||
})())`);
|
||||
await sleep(600);
|
||||
const hashAfter = await json(`JSON.stringify({ hash: location.hash, route: window.__yunXueTangAuto.route(), alive: typeof window.__yunXueTangAuto })`);
|
||||
check('SPA 内 hash 切换后脚本自动跟随路由', hashAfter.route === 'list' && hashAfter.alive === 'object', { 切前: hashNav, 切后: hashAfter });
|
||||
|
||||
// ---- 11. 未登录访问 #/list:站点整页重定向到登录页(新 document)----
|
||||
// 真实 Tampermonkey 会在新 document 上按 @match 重新注入,这里同样重新注入后再断言。
|
||||
// 先订阅 load 事件再触发跳转,避免竞态。
|
||||
const redirected = cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null);
|
||||
await evalJS(`(() => { window.__yunXueTangDocMarker = 'before-nav'; location.href = 'https://kfmic.yunxuetang.cn/kng/#/list'; return true; })()`);
|
||||
await redirected;
|
||||
await sleep(2500);
|
||||
|
||||
const afterNav = await json(`JSON.stringify({
|
||||
url: location.href,
|
||||
host: location.host,
|
||||
title: document.title,
|
||||
newDocument: window.__yunXueTangDocMarker === undefined,
|
||||
alive: typeof window.__yunXueTangAuto,
|
||||
})`);
|
||||
check('未登录访问 #/list 被站点重定向(document 已换新)',
|
||||
/(^|\.)yunxuetang\.cn$/.test(afterNav.host) && afterNav.newDocument === true, afterNav);
|
||||
check('新 document 上脚本未残留(重定向后必须重新注入)', afterNav.alive === 'undefined', afterNav.alive);
|
||||
|
||||
// 模拟 Tampermonkey 在新 document 上按 @match 自动注入
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1200);
|
||||
const reinjected = await json(`JSON.stringify({
|
||||
url: location.href,
|
||||
route: window.__yunXueTangAuto ? window.__yunXueTangAuto.route() : 'no-api',
|
||||
isLoginPage: window.__yunXueTangAuto ? window.__yunXueTangAuto.isLoginPage() : null,
|
||||
panel: document.querySelectorAll('#yun-xue-tang-panel').length,
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent,
|
||||
bodyScrollable: document.body.scrollHeight > 0,
|
||||
})`);
|
||||
check('重定向后重新注入:面板唯一且脚本正常',
|
||||
reinjected.panel === 1 && reinjected.version === EXPECT_VERSION && reinjected.route !== 'no-api', reinjected);
|
||||
check('列表页导航无脚本报错', scriptErrors().length === 0, scriptErrors().map((e) => e.text.slice(0, 140)));
|
||||
|
||||
// ---- 汇总控制台 ----
|
||||
log('\n[真机] 控制台共 ' + consoleLogs.length + ' 条,最后 15 条:');
|
||||
for (const l of consoleLogs.slice(-15)) log(' [' + l.type + '] ' + l.text.slice(0, 170));
|
||||
} catch (e) {
|
||||
check('真机流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 4).join(' | ') : String(e));
|
||||
} finally {
|
||||
if (cdp && !KEEP) cdp.close();
|
||||
if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} }
|
||||
if (!KEEP) {
|
||||
await sleep(600);
|
||||
try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {}
|
||||
} else {
|
||||
log('[真机] YUN_XUE_TANG_KEEP=1,浏览器保持打开:' + userDataDir);
|
||||
}
|
||||
}
|
||||
|
||||
const failed = results.filter((r) => !r.ok);
|
||||
log('\n===== 真机结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' =====');
|
||||
for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail));
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -1,234 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 学习统计(runner/study.mjs)自测:纯数据逻辑,假时钟,不需要浏览器也不碰终端。
|
||||
*
|
||||
* 为什么单独测:这段逻辑的口径一旦错,面板上的「已学 1:23:45 / 学分 12.75」就是假的,
|
||||
* 而这种错在日志里完全看不出来(日志只有收尾那一行)。用假时钟把
|
||||
* 「暂停不计时」「间隔过大不补计」「重复完成不重复计分」这些边界钉死。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/study-test.mjs
|
||||
* npm run test:study
|
||||
*/
|
||||
import { createStudyTracker } from '../../runner/study.mjs';
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) console.log(' ✔ ' + name);
|
||||
else { failed++; console.log(' ✘ ' + name + (extra ? ' → ' + extra : '')); }
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
/** 假时钟:手动推进,不依赖真实时间 */
|
||||
function clock(start = 1700000000000) {
|
||||
let t = start;
|
||||
return { now: () => t, tick(sec) { t += sec * 1000; } };
|
||||
}
|
||||
|
||||
const video = (paused) => ({ t: 10, d: 100, paused, err: 0, src: 1 });
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 1. 学习时长:只在视频真的在播时累加
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学习时长');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 0, '首帧没有上一帧可比,不计时');
|
||||
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 2, '连续两帧都在播,累加 2 秒');
|
||||
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(true) });
|
||||
eq(s.get().studySeconds, 2, '这一帧已暂停:上一段播到暂停前就停了,不再补');
|
||||
|
||||
c.tick(30);
|
||||
s.update({ course: 'A', video: video(true) });
|
||||
eq(s.get().studySeconds, 2, '暂停 30 秒一点都不计(排队/挂机不算学习)');
|
||||
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
c.tick(3);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 5, '恢复播放后从 2 秒接着累加');
|
||||
|
||||
// 没有 video(列表页 / 加载中)等于没在播
|
||||
c.tick(10);
|
||||
s.update({ course: 'A', video: null });
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: null });
|
||||
eq(s.get().studySeconds, 5, 'video 为 null 时不计时(列表页/加载中的时间不算学习)');
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 5, '从 null 回到播放:这一帧不算(上一帧没在播)');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 2. 学习时长:间隔异常(浏览器重启 / 进程挂起)不补计
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('异常间隔');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
c.tick(600); // 10 分钟没有任何快照:中间肯定断过
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 0, '间隔 600 秒视为断线,不补计(上限 60 秒)');
|
||||
|
||||
c.tick(59);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 59, '间隔 59 秒仍在容忍范围内');
|
||||
|
||||
c.tick(61);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 59, '间隔 61 秒丢弃');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 3. 学分:边播边记,倒计时消失后沿用缓存
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学分读取');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
|
||||
s.update({ course: 'A', credit: 2.5, video: video(false) });
|
||||
eq(s.get().credit, 2.5, '播放期间读到本门可得学分');
|
||||
|
||||
// 学完后倒计时元素消失(credit=null),本门学分仍要显示
|
||||
s.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
eq(s.get().credit, 2.5, '倒计时消失后沿用缓存(否则面板会突然变 —)');
|
||||
eq(s.get().creditEarned, 2.5, '课程完成后计入获得学分');
|
||||
|
||||
// 换到新课,还没读到学分
|
||||
s.update({ course: 'B', credit: null, completed: 1, video: video(false) });
|
||||
eq(s.get().credit, null, '换课后本门学分先清空(还没读到新课的分)');
|
||||
|
||||
s.update({ course: 'B', credit: 1.25, completed: 1, video: video(false) });
|
||||
eq(s.get().credit, 1.25, '读到新课学分');
|
||||
s.update({ course: 'B', credit: null, completed: 2, video: video(false) });
|
||||
eq(s.get().creditEarned, 3.75, '第二门学完累加(2.5 + 1.25)');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 4. 学分:不重复计数
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('防重复计数');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
|
||||
s.update({ course: 'A', credit: 2.5, completed: 0, video: video(false) });
|
||||
s.update({ course: 'A', credit: 2.5, completed: 1, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '第一次完成计 2.5');
|
||||
|
||||
// completed 没变(页面刷新 / 重试后重复上报)
|
||||
for (let i = 0; i < 5; i++) s.update({ course: 'A', credit: 2.5, completed: 1, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '完成数没变不重复加');
|
||||
|
||||
// completed 涨到 2 但课程名还是 A(重试同一门又完成了一遍)——按课程去重,仍不加
|
||||
s.update({ course: 'A', credit: 2.5, completed: 2, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '同一门课重复完成不重复计分');
|
||||
|
||||
// 没读到过学分的课,完成后也不瞎加
|
||||
s.update({ course: 'C', credit: null, completed: 3, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '没读到学分的课完成后不加分');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 5. 学分事件:每次真正计入学分时产出 { course, credit },供 Bark 通知使用
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学分事件');
|
||||
{
|
||||
const s = createStudyTracker({ now: clock().now });
|
||||
let st = s.update({ course: 'A', credit: 2.5, completed: 0, video: video(false) });
|
||||
eq(st.earned.length, 0, '只有学分、没完成时没有事件');
|
||||
|
||||
st = s.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
eq(st.earned.length, 1, '课程完成时产出一条事件');
|
||||
eq(st.earned[0].course, 'A', '事件带课程名');
|
||||
eq(st.earned[0].credit, 2.5, '事件带本门学分数');
|
||||
eq(st.creditEarned, 2.5, '返回值里的累计学分同步更新');
|
||||
|
||||
st = s.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
eq(st.earned.length, 0, '同一门重复上报不重复产生事件');
|
||||
|
||||
st = s.update({ course: 'C', credit: null, completed: 2, video: video(false) });
|
||||
eq(st.earned.length, 0, '没读到学分的课完成时不产生事件');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6. 学分文本:浮点累加不出现 3.7499999
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学分文本');
|
||||
{
|
||||
const s = createStudyTracker({ now: clock().now });
|
||||
eq(s.creditText(3.75), '3.75', '3.75 原样输出');
|
||||
eq(s.creditText(1), '1', '整数不带小数点');
|
||||
eq(s.creditText(0.1 + 0.2), '0.3', '浮点误差被抹平(0.1+0.2)');
|
||||
eq(s.creditText(6.5), '6.5', '一位小数不带尾随 0');
|
||||
eq(s.creditText(12.75), '12.75', '两位小数');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7. 摘要 / 空状态
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('摘要与空状态');
|
||||
{
|
||||
const s = createStudyTracker({ now: clock().now });
|
||||
eq(s.summary(), '', '什么都没学时摘要为空(收尾不该打一行 0 学时的废话)');
|
||||
eq(s.get().studySeconds, 0, '初始时长为 0');
|
||||
eq(s.get().creditEarned, 0, '初始学分为 0');
|
||||
eq(s.get().credit, null, '初始本门学分为 null');
|
||||
|
||||
const c = clock();
|
||||
const s2 = createStudyTracker({ now: c.now });
|
||||
s2.update({ course: 'A', credit: 2.5, video: video(false) });
|
||||
c.tick(3600);
|
||||
s2.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
// 间隔 3600 秒 > 60 被丢弃,所以时长仍是 0;这里主要是验证摘要格式
|
||||
eq(s2.summary(), '视频累计播放 00:00,获得 2.5 学分', '摘要把时长和学分写在一句里');
|
||||
|
||||
const c3 = clock();
|
||||
const s3 = createStudyTracker({ now: c3.now });
|
||||
s3.update({ course: 'A', video: video(false) });
|
||||
c3.tick(2);
|
||||
s3.update({ course: 'A', video: video(false) });
|
||||
eq(s3.summary(), '视频累计播放 00:02,获得 0 学分', '只有时长没有学分时也照常输出');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 8. reset:重开一轮(supervisor 重启的会话之间)要能清零
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('重置');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
s.update({ course: 'A', credit: 2.5, video: video(false) });
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
ok(s.get().studySeconds > 0 && s.get().creditEarned > 0, '重置前有数据');
|
||||
|
||||
s.reset();
|
||||
eq(s.get().studySeconds, 0, 'reset 清空时长');
|
||||
eq(s.get().creditEarned, 0, 'reset 清空学分');
|
||||
eq(s.get().credit, null, 'reset 清空本门学分');
|
||||
eq(s.summary(), '', 'reset 后摘要为空');
|
||||
|
||||
// 重置后再来一门同名的课,应该能重新计分(去重表也清了)
|
||||
s.update({ course: 'A', credit: 2.5, completed: 1, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, 'reset 后同名课程能重新计分');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('学习统计自测:' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('学习统计自测:全部通过');
|
||||
@@ -1,448 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 终端面板(runner/tui.mjs)自测:纯函数 + 假终端渲染,不需要浏览器、不联网。
|
||||
*
|
||||
* 为什么需要它:面板的正确性全在「列宽」上——中文占 2 列、ANSI 转义不占列、
|
||||
* 截断后要补 reset。这三处一旦算错,边框就会歪或者把中文劈成半个,
|
||||
* 而这类问题是肉眼看日志发现不了的(日志文件里根本没有面板)。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/tui-test.mjs # 断言全部通过则退出码 0
|
||||
* npm run test:tui
|
||||
*/
|
||||
import { textWidth, stripAnsi, formatDuration, progressBar, visualRows, createTui } from '../../runner/tui.mjs';
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) {
|
||||
console.log(' ✔ ' + name);
|
||||
} else {
|
||||
failed++;
|
||||
console.log(' ✘ ' + name + (extra ? ' → ' + extra : ''));
|
||||
}
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 1. 列宽:中文 2 列、emoji 2 列、组合/控制字符 0 列
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('列宽计算');
|
||||
eq(textWidth('abc'), 3, 'ASCII 每字符 1 列');
|
||||
eq(textWidth('课程'), 4, '中文每字 2 列');
|
||||
eq(textWidth('课'), 2, '单字中文');
|
||||
eq(textWidth('(三)'), 6, '全角标点 2 列');
|
||||
eq(textWidth('a课b'), 4, '中英混排');
|
||||
eq(textWidth(''), 0, '空串 0 列');
|
||||
eq(textWidth('\x1b[32m课\x1b[0m'), 2, 'ANSI 序列不占列');
|
||||
eq(textWidth(stripAnsi('\x1b[1m\x1b[31mabc\x1b[0m')), 3, 'stripAnsi 后再量');
|
||||
eq(textWidth('😀'), 2, 'emoji 2 列');
|
||||
eq(textWidth('█░'), 2, '进度条字符 1 列(非全角)');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 2. 时长 / 进度条
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('时长与进度条');
|
||||
eq(formatDuration(0), '00:00', '0 秒');
|
||||
eq(formatDuration(72), '01:12', '72 秒');
|
||||
eq(formatDuration(3600), '1:00:00', '整小时');
|
||||
eq(formatDuration(3661), '1:01:01', '超一小时');
|
||||
eq(formatDuration(-5), '00:00', '负数按 0');
|
||||
eq(progressBar(0, 4), '░░░░', '0% 全空');
|
||||
eq(progressBar(1, 4), '████', '100% 全满');
|
||||
eq(progressBar(0.5, 4), '██░░', '50% 一半');
|
||||
eq(progressBar(2, 4), '████', '大于 1 截到 1');
|
||||
eq(progressBar(0.5, 4).length, 4, '进度条宽度准确');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 3. 帧渲染:假 stdout 捕获一帧,逐行量宽度
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('帧渲染');
|
||||
function makeFrame(opts) {
|
||||
const chunks = [];
|
||||
const out = {
|
||||
columns: opts.columns || 80,
|
||||
rows: opts.rows || 24,
|
||||
isTTY: true,
|
||||
write(s) { chunks.push(s); },
|
||||
on() {},
|
||||
removeListener() {},
|
||||
};
|
||||
const tui = createTui({
|
||||
enabled: true,
|
||||
out,
|
||||
stdin: null,
|
||||
color: opts.color !== false,
|
||||
logFile: './run-logs/headless.log',
|
||||
title: '面板测试',
|
||||
});
|
||||
if (opts.setup) opts.setup(tui, out);
|
||||
// 强制重画一帧(createTui 建的时候已经画过一帧,这里要最后一帧)
|
||||
tui.render();
|
||||
const frame = chunks[chunks.length - 1] || '';
|
||||
// 一帧内用 \r\n 分隔;最后一行后面紧跟 \x1b[0J
|
||||
const lines = frame.split('\r\n').map((l) => l.replace(/\x1b\[0J$/, '').replace(/\x1b\[K/g, ''));
|
||||
tui.finish();
|
||||
return { lines, chunks, frame, out, tui };
|
||||
}
|
||||
|
||||
const plain = makeFrame({ columns: 80, color: false });
|
||||
ok(plain.lines.length >= 12, '帧有足够行数(' + plain.lines.length + ' 行)');
|
||||
for (const line of plain.lines) {
|
||||
const w = textWidth(stripAnsi(line));
|
||||
ok(w <= 80, '行宽不超过 80 列', w + ' 列:' + JSON.stringify(stripAnsi(line)));
|
||||
}
|
||||
// 边框的三行必须等宽,否则右边框会锯齿
|
||||
const boxLines = plain.lines.filter((l) => /^[╭├╰│]/.test(stripAnsi(l)));
|
||||
const widths = [...new Set(boxLines.map((l) => textWidth(stripAnsi(l))))];
|
||||
eq(widths.length, 1, '所有框线行等宽(实际宽度集合:' + widths.join(',') + ')');
|
||||
ok(widths[0] === 80, '框线正好占满终端宽度', String(widths[0]));
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 4. 彩色帧:ANSI 序列混在中文里也不能顶歪边框
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('彩色帧');
|
||||
const colored = makeFrame({
|
||||
columns: 84,
|
||||
color: true,
|
||||
setup(tui) {
|
||||
tui.snap({
|
||||
course: '2025年安全生产月专题培训课程(第三期)',
|
||||
lesson: '第三章 事故应急处置与自救互救',
|
||||
summary: { text: '已学 62%' },
|
||||
countdown: 42,
|
||||
completed: 3,
|
||||
doneCount: 17,
|
||||
retryCount: 1,
|
||||
retryWait: 12,
|
||||
lessons: 8,
|
||||
video: { t: 812, d: 1320, paused: false, err: 0, src: 1 },
|
||||
});
|
||||
tui.set({ phase: '刷课中', tone: 'ok', injected: 4 });
|
||||
},
|
||||
});
|
||||
ok(colored.frame.includes('\x1b['), '彩色帧里确实有 ANSI 序列');
|
||||
for (const line of colored.lines) {
|
||||
const w = textWidth(stripAnsi(line));
|
||||
ok(w <= 84, '彩色帧行宽不超过 84 列', w + ' 列');
|
||||
}
|
||||
const coloredBox = colored.lines.filter((l) => /^[╭├╰│]/.test(stripAnsi(l)));
|
||||
const cw = [...new Set(coloredBox.map((l) => textWidth(stripAnsi(l))))];
|
||||
eq(cw.length, 1, '彩色帧里框线仍等宽(' + cw.join(',') + ')');
|
||||
ok(cw[0] === 84, '彩色帧框线占满宽度', String(cw[0]));
|
||||
// 状态行不该出现「多余的省略号」(上一版把带色的状态行误判成超宽)
|
||||
const statusLine = colored.lines.find((l) => stripAnsi(l).includes('状态'));
|
||||
ok(statusLine && !stripAnsi(statusLine).includes('刷课中…'), '状态行没有被误截断');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 5. 窗口尺寸自适应:宽度跟随终端(不再封顶 120 列)+ 矮终端降级
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('窗口尺寸自适应');
|
||||
{
|
||||
// 宽终端(240 列):框线也得撑满 240,不能停在 120
|
||||
const wide = makeFrame({ columns: 240, rows: 30, color: false });
|
||||
const wideBox = wide.lines.filter((l) => /^[╭├╰│]/.test(stripAnsi(l)));
|
||||
const ww = [...new Set(wideBox.map((l) => textWidth(stripAnsi(l))))];
|
||||
eq(ww.length, 1, '240 列终端:框线仍等宽(' + ww.join(',') + ')');
|
||||
eq(ww[0], 240, '240 列终端:框线跟随终端宽度(不再封顶 120)');
|
||||
|
||||
// 每种高度下,帧的行数都不能超过窗口,否则会把回滚区里的历史顶掉
|
||||
for (const rows of [40, 30, 24, 20, 16, 14, 12, 10, 8]) {
|
||||
const f = makeFrame({ columns: 100, rows, color: false });
|
||||
ok(f.lines.length <= rows, rows + ' 行窗口:帧高 ' + f.lines.length + ' 不超过窗口');
|
||||
}
|
||||
|
||||
// 24 行:正常模式(有课时 / 日志行)
|
||||
const full = makeFrame({ columns: 100, rows: 24, color: false });
|
||||
ok(stripAnsi(full.lines.join('\n')).includes('课时'), '24 行窗口:显示课时行');
|
||||
ok(stripAnsi(full.lines.join('\n')).includes('已注入'), '24 行窗口:显示日志行');
|
||||
ok(stripAnsi(full.lines.join('\n')).includes('q 退出'), '24 行窗口:显示 q 提示');
|
||||
|
||||
// 12 行:紧凑模式,先丢课时/日志,保住视频进度与 q 提示
|
||||
const tight = makeFrame({ columns: 100, rows: 12, color: false });
|
||||
const tightText = stripAnsi(tight.lines.join('\n'));
|
||||
ok(!tightText.includes('课时'), '12 行窗口:省掉课时行');
|
||||
ok(tightText.includes('视频'), '12 行窗口:保留视频进度行');
|
||||
ok(tightText.includes('进度'), '12 行窗口:保留完成数行');
|
||||
ok(tightText.includes('q 退出'), '12 行窗口:仍显示 q 提示');
|
||||
ok(tightText.includes('最近日志'), '12 行窗口:保留日志区(只是变矮)');
|
||||
|
||||
// 8 行:极端矮,连 q 提示都省掉,也绝不能有半截框
|
||||
const tiny = makeFrame({ columns: 100, rows: 8, color: false });
|
||||
ok(tiny.lines.length <= 8, '8 行窗口:帧高不超过 8(实际 ' + tiny.lines.length + ')');
|
||||
ok(!tiny.lines[0].includes('\n'), '8 行窗口:标题行完整');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6. 尺寸变化时重画不错位:上帧 24 行 → 窗口缩到 12 行
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('尺寸变化重绘');
|
||||
{
|
||||
const chunks = [];
|
||||
const ESC = String.fromCharCode(27);
|
||||
const CRLF = String.fromCharCode(13, 10);
|
||||
const ANSI_ALL = new RegExp(ESC + '\\\[[0-9;]*[A-Za-z]', 'g');
|
||||
const foldMarker = ESC + '[H';
|
||||
const out = {
|
||||
columns: 100, rows: 24, isTTY: true,
|
||||
write(s) { chunks.push(s); },
|
||||
on() {}, removeListener() {},
|
||||
};
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
tui.render();
|
||||
// 窗口缩小到 60×12:上帧每行 100 列,在 60 列下要折成 2 行,
|
||||
// 整块折完远超新窗口高度 —— 光标退不到块首,只能整屏重置
|
||||
out.rows = 12;
|
||||
out.columns = 60;
|
||||
chunks.length = 0;
|
||||
tui.redraw();
|
||||
const after = chunks.join('');
|
||||
ok(after.includes(foldMarker), '旧帧折行后比窗口还高时走整屏重置(ESC[H)');
|
||||
const lines = after.split(CRLF).map((l) => l.replace(ANSI_ALL, ''));
|
||||
const box = lines.filter((l) => /^[╭├╰│]/.test(l));
|
||||
const bw = [...new Set(box.map((l) => textWidth(l)))];
|
||||
eq(bw.length, 1, '缩窗后框线仍等宽(' + bw.join(',') + ')');
|
||||
eq(bw[0], 60, '缩窗后框线跟新宽度 60');
|
||||
ok(box.length <= 12, '缩窗后帧高不超过 12(实际 ' + box.length + ')');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6b. 尺寸小幅变窄:折行后仍装得下窗口 → 精确回退,不整屏重置(保住可视历史)
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('小幅变窄');
|
||||
{
|
||||
const chunks = [];
|
||||
const ESC = String.fromCharCode(27);
|
||||
const out = { columns: 120, rows: 48, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
tui.render();
|
||||
// 120 列的行在 110 列下折成 2 行,整块约 42 行但仍装得进 48 行的窗口
|
||||
out.columns = 110;
|
||||
chunks.length = 0;
|
||||
tui.redraw();
|
||||
const frame = chunks.join('');
|
||||
ok(!frame.includes(ESC + '[2J'), '装得下时不整屏重置(不白白丢掉上方历史日志)');
|
||||
ok(/\x1b\[\d+A\x1b\[0J/.test(frame), '改用精确回退(向上退到旧帧首行)');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7. 没有 resize 事件的平台(Windows 传统控制台):靠定时刷新自己发现尺寸变化
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('无 resize 事件的尺寸变化');
|
||||
{
|
||||
const chunks = [];
|
||||
const CRLF = String.fromCharCode(13, 10);
|
||||
const ESC = String.fromCharCode(27);
|
||||
// 注意:on/removeListener 是空实现,模拟「平台根本不发 resize 事件」
|
||||
const out = {
|
||||
columns: 100, rows: 24, isTTY: true,
|
||||
write(s) { chunks.push(s); },
|
||||
on() {}, removeListener() {},
|
||||
};
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
tui.render();
|
||||
ok(chunks.length > 0, '首帧已画');
|
||||
|
||||
const boxWidths = (text) => [...new Set(text.split(CRLF).map(stripAnsi).filter((l) => /^[╭├╰│]/.test(l)).map(textWidth))];
|
||||
const boxHeight = (text) => text.split(CRLF).map(stripAnsi).filter((l) => /^[╭├╰│]/.test(l)).length;
|
||||
const clears = (text) => text.split(ESC + '[0J').length - 1;
|
||||
|
||||
// 最大化:100×24 → 180×40,全程不触发任何事件
|
||||
out.columns = 180;
|
||||
out.rows = 40;
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
eq(boxWidths(chunks.join('')).join(','), '180', '最大化后框线跟到 180 列(不靠 resize 事件)');
|
||||
|
||||
// 缩回去:同样没有事件,必须自己发现并清旧帧
|
||||
out.columns = 80;
|
||||
out.rows = 20;
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
const shrunk = chunks.join('');
|
||||
ok(shrunk.includes(ESC + '[2J'), '缩窗时整屏重置(旧帧折行后比窗口还高)');
|
||||
eq(boxWidths(shrunk).join(','), '80', '缩窗后框线跟到 80 列');
|
||||
ok(boxHeight(shrunk) <= 20, '缩窗后帧高不超 20 行');
|
||||
|
||||
// 尺寸没变时不该多清屏(每帧都清屏会闪)
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
eq(clears(chunks.join('')), 1, '尺寸未变时不多做清屏(只留帧尾那一次)');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7b. 最大化后还原:终端会把宽行折成多行,回退行数必须按折行后的可视行算
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('最大化后还原');
|
||||
{
|
||||
const chunks = [];
|
||||
const ESC = String.fromCharCode(27);
|
||||
const CRLF = String.fromCharCode(13, 10);
|
||||
const out = { columns: 180, rows: 40, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
// 上一帧是 180 列宽的一整块面板(帧内用 CRLF 分隔,首行前面还有回退控制符);
|
||||
// 只看框线行,它们才是真正撑满宽度的内容行
|
||||
const wideWidths = chunks.join('').split(CRLF)
|
||||
.map((l) => stripAnsi(l))
|
||||
.filter((l) => /^[╭├╰│]/.test(l))
|
||||
.map(textWidth);
|
||||
ok(wideWidths.length > 0 && wideWidths.every((w) => w > 80), '上一帧那些框线行都比 80 列宽(还原后必然折行)');
|
||||
|
||||
const folded = visualRows(wideWidths, 80);
|
||||
ok(folded > wideWidths.length, '按 80 列重排后行数变多(' + wideWidths.length + ' → ' + folded + ' 行)');
|
||||
|
||||
ok(folded > 24, '折行后(' + folded + ' 行)比新窗口 24 行还高,光标退不到块首');
|
||||
|
||||
// 还原到 80 列:不发 resize 事件,靠定时刷新发现
|
||||
out.columns = 80;
|
||||
out.rows = 24;
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
const back = chunks.join('');
|
||||
ok(back.includes(ESC + '[H') && back.includes(ESC + '[2J'), '还原时整屏重置,旧帧上半截不会残留');
|
||||
ok(!/\x1b\[\d+A\x1b\[0J/.test(back), '不再用「向上退 N 行」那条路径(退不到块首)');
|
||||
const box = back.split(CRLF).map(stripAnsi).filter((l) => /^[╭├╰│]/.test(l));
|
||||
eq([...new Set(box.map(textWidth))].join(','), '80', '重置后框线是 80 列');
|
||||
ok(box.length <= 24, '重置后帧高不超 24(实际 ' + box.length + ')');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7c. visualRows 纯函数
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('可视行换算');
|
||||
{
|
||||
eq(visualRows([80, 80, 80], 80), 3, '不折行时等于行数');
|
||||
eq(visualRows([160, 160], 80), 4, '两行 160 列在 80 列终端下折成 4 行');
|
||||
eq(visualRows([181], 80), 3, '181 列折成 3 行(向上取整)');
|
||||
eq(visualRows([], 80), 0, '空数组 0 行');
|
||||
eq(visualRows([0, 0], 80), 2, '空白行也占一行');
|
||||
eq(visualRows([40], 0), 1, '宽度非法时按 1 行算,不会崩');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 8. 窄终端:不超界、不硬截断(字段按重要性递降)
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('极端尺寸');
|
||||
const narrow = makeFrame({ columns: 36, rows: 12, color: true, setup(tui) {
|
||||
tui.snap({ course: '课程', completed: 3, doneCount: 17, lessons: 8, retryCount: 1, countdown: 812, video: { t: 812, d: 1320, paused: false, err: 0, src: 1 } });
|
||||
}});
|
||||
for (const line of narrow.lines) {
|
||||
ok(textWidth(stripAnsi(line)) <= 36, '36 列终端:行宽不超界', String(textWidth(stripAnsi(line))));
|
||||
}
|
||||
ok(narrow.lines.length <= 12, '矮终端帧行数不超过 12', String(narrow.lines.length));
|
||||
const narrowText = narrow.lines.map((l) => stripAnsi(l));
|
||||
const progressLine = narrowText.find((l) => l.includes('进度'));
|
||||
ok(progressLine.includes('本次') && progressLine.includes('累计'), '36 列:进度行保住本次/累计两个骨架字段');
|
||||
ok(!progressLine.includes('倒计时'), '36 列:进度行主动丢掉倒计时字段(而不是截断成省略号)');
|
||||
const videoLine = narrowText.find((l) => l.includes('视频'));
|
||||
ok(videoLine.includes('%'), '36 列:视频行保住百分比');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 9. 学习时长与学分:只算视频真在播的时间,学分只算刷完的课
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学习时长与学分');
|
||||
{
|
||||
const chunks = [];
|
||||
const out = { columns: 100, rows: 24, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false });
|
||||
const snap = (o) => tui.snap({ course: 'A课', lessons: 3, video: { t: 10, d: 100, paused: false, err: 0, src: 1 }, ...o });
|
||||
|
||||
// 视频在播:靠真实的 Date.now 差累计,这里直接用间隔验证(把时钟往前拨太脏,改断言区间)
|
||||
snap({ credit: 2.5 });
|
||||
eq(tui.state.credit, 2.5, '学分:在播时从倒计时文案读到的本门学分');
|
||||
eq(tui.state.studySeconds, 0, '首帧没有上一帧可比,不计时');
|
||||
|
||||
// 暂停期间不累加:间隔再长也不计入
|
||||
tui.snap({ course: 'A课', video: { t: 10, d: 100, paused: true, err: 0, src: 1 } });
|
||||
const pausedAt = tui.state.studySeconds;
|
||||
tui.snap({ course: 'A课', video: { t: 10, d: 100, paused: true, err: 0, src: 1 } });
|
||||
eq(tui.state.studySeconds, pausedAt, '视频暂停时不计学习时长');
|
||||
|
||||
// 播放中才有增量(正常应 < 1 秒,断言「大于 0 且不超 30 秒封顶」)
|
||||
snap({ video: { t: 20, d: 100, paused: false, err: 0, src: 1 } });
|
||||
const t1 = tui.state.studySeconds;
|
||||
snap({ video: { t: 21, d: 100, paused: false, err: 0, src: 1 } });
|
||||
const t2 = tui.state.studySeconds;
|
||||
ok(t2 >= t1 && t2 - t1 < 30, '两帧之间按真实间隔累计', t1 + ' → ' + t2);
|
||||
|
||||
// 倒计时消失(学完)后沿用缓存,不会变回 —
|
||||
snap({ credit: undefined });
|
||||
eq(tui.state.credit, 2.5, '倒计时消失后沿用本门学分缓存');
|
||||
|
||||
// 真的完成了才发分;重复上报不重复计数
|
||||
snap({ completed: 1 });
|
||||
eq(tui.state.creditEarned, 2.5, '课程完成后计入获得学分');
|
||||
snap({ completed: 1 });
|
||||
eq(tui.state.creditEarned, 2.5, '完成数没变不重复加学分');
|
||||
|
||||
// 换课:学分清零待读,学完再累加
|
||||
snap({ course: 'B课', completed: 1, credit: 1.25 });
|
||||
eq(tui.state.credit, 1.25, '换课后读到新课的学分');
|
||||
snap({ course: 'B课', completed: 2, credit: null });
|
||||
eq(tui.state.creditEarned, 3.75, '第二门学完后累加(2.5 + 1.25)');
|
||||
|
||||
// 面板上真的画出来了吗
|
||||
tui.render();
|
||||
const frame = (chunks[chunks.length - 1] || '').split('\r\n').map(stripAnsi).join('\n');
|
||||
ok(frame.includes('学时'), '面板有「学时」行');
|
||||
ok(frame.includes('已学 '), '「学时」行显示学习时长');
|
||||
ok(frame.includes('学分 3.75'), '「学时」行显示累计学分', frame.match(/学分[^·│]*/)?.[0]);
|
||||
tui.finish();
|
||||
|
||||
// 暂停时提示「不计时」,避免用户以为面板死了
|
||||
const f2 = makeFrame({ columns: 100, rows: 24, color: false, setup(t2ui) {
|
||||
t2ui.snap({ course: 'A课', video: { t: 10, d: 100, paused: true, err: 0, src: 1 } });
|
||||
} });
|
||||
ok(f2.lines.map(stripAnsi).some((l) => l.includes('暂停中,不计时')), '暂停时明确提示不计时');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 10. 禁用时是空操作(上层可以无条件调用)
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('禁用即空操作');
|
||||
{
|
||||
const chunks = [];
|
||||
const out = { columns: 80, rows: 24, isTTY: false, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
let quitCalled = 0;
|
||||
const tui = createTui({ enabled: false, out, stdin: null, onQuit: () => quitCalled++ });
|
||||
tui.set({ phase: '不该出现' });
|
||||
tui.snap({ course: '不该出现', video: { t: 1, d: 2 } });
|
||||
tui.render();
|
||||
tui.finish();
|
||||
eq(chunks.length, 0, '禁用时不写任何字节');
|
||||
eq(tui.state.phase, '启动中', '禁用时 set 不改状态');
|
||||
eq(tui.logLines.length, 0, '禁用时不缓存日志');
|
||||
eq(quitCalled, 0, '禁用时不会触发退出回调');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 11. 收尾:finish 只生效一次,且恢复光标 / 换行
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('收尾');
|
||||
{
|
||||
const chunks = [];
|
||||
const out = { columns: 80, rows: 24, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false });
|
||||
chunks.length = 0;
|
||||
tui.finish();
|
||||
const after = chunks.join('');
|
||||
ok(after.includes('\x1b[?25h'), 'finish 恢复了光标(?25h)');
|
||||
ok(after.startsWith('\n'), 'finish 先换行,收尾日志不会盖在面板上');
|
||||
chunks.length = 0;
|
||||
tui.finish();
|
||||
eq(chunks.length, 0, '重复 finish 不重复输出');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('TUI 自测:' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('TUI 自测:全部通过');
|
||||
@@ -1,64 +0,0 @@
|
||||
# docker compose 用法:
|
||||
# cp .env.example .env # 填账号密码(.env 已在 .gitignore 里,不会入库)
|
||||
# docker compose build
|
||||
# docker compose run --rm yun-xue-tang --check # 先自检(只读,不登录)
|
||||
# docker compose run --rm yun-xue-tang --budget-minutes 15 # 最多跑 15 分钟
|
||||
# docker compose up -d # 正式后台刷课
|
||||
# docker compose logs -f # 跟随日志(也可 tail -f ./run-logs/headless.log)
|
||||
# docker compose down # 停(SIGTERM → 暂停视频 → 关浏览器)
|
||||
#
|
||||
# 凭据走 environment 插值(compose 会自动读同目录的 .env),而不是 env_file:
|
||||
# 这样 .env 不存在时也不会直接报错,入口脚本会降级成 --check。
|
||||
services:
|
||||
yun-xue-tang:
|
||||
build:
|
||||
context: .
|
||||
# apt / npm 镜像源可在 .env 里覆盖(APT_MIRROR / NPM_REGISTRY),留空则用默认官方源
|
||||
args:
|
||||
APT_MIRROR: "${APT_MIRROR:-}"
|
||||
NPM_REGISTRY: "${NPM_REGISTRY:-}"
|
||||
CHROME_DEB_URL: "${CHROME_DEB_URL:-}"
|
||||
image: yun-xue-tang-assistant:latest
|
||||
container_name: yun-xue-tang
|
||||
# 为什么不是 unless-stopped:运行器「刷完了」会以退出码 0 正常退出,
|
||||
# 而 unless-stopped / always 不看退出码,会造成「退出 → 立即重启 → 又刷完 → 再重启」的
|
||||
# 热循环,反复请求平台。on-failure 只在非 0 时重试,正常收尾就停下。
|
||||
# 想让它长期挂着,用运行器自己的 restartMinutes / budgetMinutes(见 config/runner.config.mjs),
|
||||
# 或用 cron 定期 `docker compose up -d`。
|
||||
restart: on-failure:3
|
||||
# 自带一个极小的 init(tini)当 PID 1:node 是它 exec 出来的子进程,
|
||||
# 信号照常透传(SIGTERM 仍能让运行器收尾),同时回收 Chrome 被收养的孤儿进程
|
||||
init: true
|
||||
environment:
|
||||
TZ: "${TZ:-Asia/Shanghai}"
|
||||
# 凭据只走环境变量,绝不写进镜像或提交到仓库
|
||||
YUN_XUE_TANG_USR: "${YUN_XUE_TANG_USR:-}"
|
||||
YUN_XUE_TANG_PWD: "${YUN_XUE_TANG_PWD:-}"
|
||||
# 面板要求 stdout 是 TTY,后台跑必须关(默认就是关的,这里显式写出来防误改)
|
||||
YUN_XUE_TANG_TUI: "0"
|
||||
# 本次最多刷多少分钟;0 = 不限
|
||||
YUN_XUE_TANG_BUDGET_MINUTES: "${YUN_XUE_TANG_BUDGET_MINUTES:-0}"
|
||||
# 开始运行 / 获得学分 / 收尾时推 Bark 手机通知;不填则沿用 config/runner.config.mjs 里的 barkUrl
|
||||
YUN_XUE_TANG_BARK_URL: "${YUN_XUE_TANG_BARK_URL:-}"
|
||||
YUN_XUE_TANG_BARK_GROUP: "${YUN_XUE_TANG_BARK_GROUP:-}"
|
||||
YUN_XUE_TANG_BARK_TTL: "${YUN_XUE_TANG_BARK_TTL:-}"
|
||||
volumes:
|
||||
# 持久化登录态(cookie / localStorage):删掉该目录等于重置登录与进度缓存
|
||||
# 注意:与裸机运行共用同一个目录,容器内以 root 写入,宿主机上会是 root 所有
|
||||
- ./.run-profile:/app/.run-profile
|
||||
# 日志跟着宿主机走,方便 tail -f
|
||||
- ./run-logs:/app/run-logs
|
||||
# 容器内 /dev/shm 默认 64MB,Chrome 多标签时容易崩;给大一点更稳
|
||||
# (运行器本身也加了 --disable-dev-shm-usage 兜底)
|
||||
shm_size: 512m
|
||||
# 运行器是前台进程,不需要端口映射(CDP 只监听容器内 127.0.0.1)
|
||||
stop_grace_period: 30s
|
||||
security_opt:
|
||||
# 容器内 Chrome 沙箱受限,运行器会自动加 --no-sandbox;
|
||||
# seccomp 默认策略也会拦 Chrome 的 namespace 调用,放宽到 unconfined 更省事
|
||||
- seccomp=unconfined
|
||||
logging:
|
||||
driver: json-file
|
||||
options:
|
||||
max-size: "10m"
|
||||
max-file: "3"
|
||||
@@ -1,39 +0,0 @@
|
||||
#!/bin/sh
|
||||
# 容器入口:只做三件事——兜底默认路径、保证 profile / 日志目录存在、必要时降级成自检。
|
||||
# 所有实际逻辑仍在 runner/headless.mjs 里,这里不复制任何业务判断,避免两处行为分叉。
|
||||
#
|
||||
# docker run 镜像 → 没凭据则 --check(只读自检),有凭据则正式刷课
|
||||
# docker run 镜像 --budget-minutes 15 → 参数原样透传给运行器
|
||||
# docker run -it 镜像 sh → 进容器排查
|
||||
set -e
|
||||
|
||||
PROFILE_DIR="${YUN_XUE_TANG_PROFILE_DIR:-/app/.run-profile}"
|
||||
LOG_FILE="${YUN_XUE_TANG_LOG_FILE:-/app/run-logs/headless.log}"
|
||||
export YUN_XUE_TANG_PROFILE_DIR="$PROFILE_DIR"
|
||||
export YUN_XUE_TANG_LOG_FILE="$LOG_FILE"
|
||||
|
||||
mkdir -p "$PROFILE_DIR" "$(dirname "$LOG_FILE")"
|
||||
# profile 里有登录 cookie,收窄权限(挂载卷时可能已经是宿主机权限,失败就算了)
|
||||
chmod 700 "$PROFILE_DIR" 2>/dev/null || true
|
||||
|
||||
# 第一个参数是可执行文件时直接 exec,方便 docker run -it 镜像 sh / node -v 之类排查
|
||||
case "${1:-}" in
|
||||
sh|bash|node|npm|google-chrome|google-chrome-stable|chromium)
|
||||
exec "$@"
|
||||
;;
|
||||
esac
|
||||
|
||||
# 没有参数且没填凭据:跑正式刷课只会被预检拦下(退出码 2),容器会反复重启。
|
||||
# 这里降级成 --check,让容器稳定地给出「环境 OK 但缺凭据」的结论。
|
||||
if [ "$#" -eq 0 ]; then
|
||||
if [ -z "${YUN_XUE_TANG_USR:-}" ] || [ -z "${YUN_XUE_TANG_PWD:-}" ]; then
|
||||
{
|
||||
echo "[入口] 未提供凭据,改为只读自检(--check):不登录、不点课程、不动进度。"
|
||||
echo "[入口] 正式刷课请带上环境变量:"
|
||||
echo "[入口] docker run -e YUN_XUE_TANG_USR=账号 -e YUN_XUE_TANG_PWD=密码 ..."
|
||||
} >&2
|
||||
set -- --check
|
||||
fi
|
||||
fi
|
||||
|
||||
exec node /app/runner/headless.mjs "$@"
|
||||
@@ -1,25 +0,0 @@
|
||||
=== 平台进度接口 study/summary ===
|
||||
026 finishNum=0/3 acqHours=0
|
||||
049 finishNum=1/3 acqHours=302
|
||||
|
||||
=== 脚本日志(切节瞬间) ===
|
||||
[2026-10-19T13:36:34.933Z] [page] [云学堂自动] 本节已记录,切换下一节…
|
||||
[2026-10-19T13:36:34.934Z] [page] [云学堂自动] 进入下一节
|
||||
[2026-10-19T13:36:40.930Z] [page] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
|
||||
[2026-10-19T13:36:43.870Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":0.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 5分钟 5秒 可完成本课程学习并
|
||||
[2026-10-19T13:36:48.784Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":5.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 5分钟 可完成本课程学习并获得0
|
||||
[2026-10-19T13:36:53.786Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":10.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 55秒 可完成本课程学
|
||||
[2026-10-19T13:36:58.799Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":15.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 50秒 可完成本课程学
|
||||
[2026-10-19T13:37:03.801Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":20.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 45秒 可完成本课程学
|
||||
[2026-10-19T13:37:08.802Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":25.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 40秒 可完成本课程学
|
||||
[2026-10-19T13:37:13.882Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":30.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 35秒 可完成本课程学
|
||||
[2026-10-19T13:37:18.815Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":35.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 30秒 可完成本课程学
|
||||
[2026-10-19T13:37:23.826Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":40.7,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 25秒 可完成本课程学
|
||||
[2026-10-19T13:37:28.842Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":45.7,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 20秒 可完成本课程学
|
||||
[2026-10-19T13:37:33.929Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":50.8,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 15秒 可完成本课程学
|
||||
|
||||
=== 最终状态 ===
|
||||
summary: 已完成 1/3
|
||||
countdown: 还需 4分钟 10秒 可完成本课程学习并获得0.25学分,加油!
|
||||
video: {"paused": true, "ended": false, "currentTime": 55.7, "duration": 304.5, "muted": false, "rate": 1, "src": "blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"}
|
||||
status: 自动刷课已暂停
|
||||
@@ -1,6 +0,0 @@
|
||||
2026-10-19T13:36:23.764Z | countdown='还需 10秒 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 0/3' | t=291.5 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:28.770Z | countdown='还需 5秒 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 0/3' | t=296.5 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:33.772Z | countdown='' | summary='已完成 1/3' | t=301.5 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:38.784Z | countdown='' | summary='已完成 1/3' | t=1.8 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:43.870Z | countdown='还需 5分钟 5秒 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 1/3' | t=0.6 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)'
|
||||
2026-10-19T13:36:48.784Z | countdown='还需 5分钟 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 1/3' | t=5.6 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)'
|
||||
@@ -1,164 +0,0 @@
|
||||
{
|
||||
"title": "KFMI2025年品质能力强化培训(APQP/CP/FMEA) - 江丰云课堂",
|
||||
"url": "https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7",
|
||||
"iframes": [
|
||||
""
|
||||
],
|
||||
"catalogCount": 10,
|
||||
"catalogClass": [
|
||||
"yxtulcdsdk-catalog mb20"
|
||||
],
|
||||
"activeText": "视频2025-05-29--1",
|
||||
"activeHasLi": true,
|
||||
"summary": "已完成 0/8",
|
||||
"countdown": "还需 2小时 7分钟 59秒 可完成本课程学习并获得6.52学分,加油!",
|
||||
"countdownNorm": "还需2小时7分钟59秒可完成本课程学习并获得6.52学分,加油!",
|
||||
"oldRegexMatch": null,
|
||||
"newRegexMatch": [
|
||||
"2",
|
||||
"7",
|
||||
"59"
|
||||
],
|
||||
"tagTypes": [
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频"
|
||||
],
|
||||
"lessons": [
|
||||
{
|
||||
"text": "第1章:先期产品质量策划\n视频2025-05-29--1\n视频2025-05-29--2\n视频202",
|
||||
"active": true,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M4.286.146a.5.5 0 ",
|
||||
"M20 0H0v20h20z",
|
||||
"M10 2a8 8 0 100 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--1",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M20 0H0v20h20z",
|
||||
"M10 2a8 8 0 100 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--2",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--3",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--4",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--1",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--2",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "第2章:控制计划培训\n视频2025-05-30--3\n视频2025-05-30--4",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M4.286.146a.5.5 0 ",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--3",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--4",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
}
|
||||
],
|
||||
"videos": [
|
||||
{
|
||||
"duration": 7829.442033,
|
||||
"paused": false,
|
||||
"ended": false,
|
||||
"muted": true,
|
||||
"rate": 1
|
||||
},
|
||||
{
|
||||
"duration": null,
|
||||
"paused": true,
|
||||
"ended": false,
|
||||
"muted": true,
|
||||
"rate": 1
|
||||
}
|
||||
],
|
||||
"startButtons": [
|
||||
"继续学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习"
|
||||
]
|
||||
}
|
||||
@@ -1,115 +0,0 @@
|
||||
{
|
||||
"activeTag": "LI",
|
||||
"activeClass": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16 liactive",
|
||||
"activeLiIndex": 1,
|
||||
"leafCount": 8,
|
||||
"leafIdx": 0,
|
||||
"activeLiText": "视频2025-05-29--1",
|
||||
"nextLeafText": "视频2025-05-29--2",
|
||||
"nextLeafHand": true,
|
||||
"oldFindIdx": 0,
|
||||
"oldNextText": "视频2025-05-29--1",
|
||||
"items": [
|
||||
{
|
||||
"i": 0,
|
||||
"cls": "",
|
||||
"directUl": true,
|
||||
"anyUl": true,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": true,
|
||||
"text": "第1章:先期产品质量策划\n视频2025-05-29--1\n视频2025-05-29--2\n视频2025-05-29--3"
|
||||
},
|
||||
{
|
||||
"i": 1,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16 liactive",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": true,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--1"
|
||||
},
|
||||
{
|
||||
"i": 2,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--2"
|
||||
},
|
||||
{
|
||||
"i": 3,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--3"
|
||||
},
|
||||
{
|
||||
"i": 4,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--4"
|
||||
},
|
||||
{
|
||||
"i": 5,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--1"
|
||||
},
|
||||
{
|
||||
"i": 6,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--2"
|
||||
},
|
||||
{
|
||||
"i": 7,
|
||||
"cls": "",
|
||||
"directUl": true,
|
||||
"anyUl": true,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "第2章:控制计划培训\n视频2025-05-30--3\n视频2025-05-30--4"
|
||||
},
|
||||
{
|
||||
"i": 8,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--3"
|
||||
},
|
||||
{
|
||||
"i": 9,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--4"
|
||||
}
|
||||
],
|
||||
"activeHtml": "<li class=\"hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16 liactive\"><div class=\"ml24 flex-center flex-space-between\"><span class=\"yxtf-tooltip ulcdsdk-ellipsis-2 ulcdsdk-break item\" aria-describedby=\"yxtf-tooltip-2494\" tabindex=\"0\"><span class=\"tag-type mr6\">视频</span>2025-05-29--1</span><svg aria-hidden=\"true\" class=\"yxt-svg-icon mr14 ml14 hand\" style=\"display: inline-block; width: 20px; height: 20px;\" xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\"><g fill=\"none\" fill-rule=\"evenodd\"><path d=\"M20 0H0v20h20z\"></path><path fill=\"currentColor\" fil"
|
||||
}
|
||||
@@ -1,16 +0,0 @@
|
||||
{
|
||||
"nextTag": "svg",
|
||||
"nextClass": "yxt-svg-icon mr14 ml14 hand",
|
||||
"nextLiText": "视频2025-05-29--2",
|
||||
"activeLiText": "视频2025-05-29--1",
|
||||
"leafTexts": [
|
||||
"视频2025-05-29--1",
|
||||
"视频2025-05-29--2",
|
||||
"视频2025-05-29--3",
|
||||
"视频2025-05-29--4",
|
||||
"视频2025-05-30--1",
|
||||
"视频2025-05-30--2",
|
||||
"视频2025-05-30--3",
|
||||
"视频2025-05-30--4"
|
||||
]
|
||||
}
|
||||
@@ -1,38 +0,0 @@
|
||||
PHASE: running
|
||||
UPDATED: 2026-10-19T13:20:57.653Z
|
||||
URL: https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7
|
||||
TITLE: KFMI2025年品质能力强化培训(APQP/CP/FMEA) - 江丰云课堂
|
||||
PANEL: True
|
||||
BATCH: True
|
||||
STATUS: 点击开始学习…
|
||||
STATS: 本次 0/10 · 失败 0
|
||||
COUNTDOWN: 还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!
|
||||
SUMMARY: 已完成 0/8
|
||||
VIDEO: {"paused": false, "ended": false, "currentTime": 114.1, "duration": 7829.4, "muted": true, "rate": 1, "src": "blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"}
|
||||
S: {"running": true, "runFinished": false, "completedThisRun": 0, "consecutiveFailures": 0, "listUrl": "https://kfmic.yunxuetang.cn/kng/#/list?catalogId=&cid=f644032e-e9dd-4b81-9adf-48645c4d78aa&order=0&sort=0&type=", "listPage": 1, "current": {"title": "KFMI2025年品质能力强化培训(APQP/CP/FMEA)", "status": "学习中", "startedAt": 1792416015027, "page": 1}, "returning": false, "phase": "learning", "done": {}, "failed": {}}
|
||||
CARDS: 0
|
||||
|
||||
LOG MARKERS:
|
||||
进入课程: 2
|
||||
点击开始学习: 9
|
||||
学习中:: 1
|
||||
自动刷课已开启: 1
|
||||
pageerror: 4
|
||||
FATAL: 0
|
||||
loop error: 0
|
||||
|
||||
LOG TAIL:
|
||||
[2026-10-19T13:20:16.926Z] [nav] https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7
|
||||
[2026-10-19T13:20:16.953Z] [page] [云学堂自动] 学习中:视频2025-05-29--1
|
||||
[2026-10-19T13:20:17.591Z] screenshot -> C:\Users\void\Desktop\yunxuetang-auto-play\.run-tmp\13-batch-on.png
|
||||
[2026-10-19T13:20:17.594Z] batch enabled, watching...
|
||||
[2026-10-19T13:20:18.919Z] [page] [云学堂自动] 点击开始学习…
|
||||
[2026-10-19T13:20:22.600Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":79.1,"duration":7829.4,"muted":false,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 9分钟 9秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:27.604Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":84.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 9分钟 4秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:32.611Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":89.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 59秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:37.619Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":94.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 54秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:42.620Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":99.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 49秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:47.751Z] screenshot -> C:\Users\void\Desktop\yunxuetang-auto-play\.run-tmp\watch-006.png
|
||||
[2026-10-19T13:20:47.752Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":104.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 44秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:52.639Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":109.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 39秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:57.654Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":114.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
@@ -1,20 +0,0 @@
|
||||
=== v2.0.3 复跑:第 2 节 -> 第 3 节 ===
|
||||
|
||||
平台 study/summary 接口:
|
||||
049 finishNum=0/8 acqHours=221
|
||||
073 finishNum=1/3 acqHours=342
|
||||
096 finishNum=2/3 acqHours=607
|
||||
|
||||
脚本日志(本地时间 21:50:46 - 21:50:53):
|
||||
[2026-10-19T13:50:46.567Z] [api] 200 https://api-phx-tc.yunxuetang.cn/kng/study/summary
|
||||
[2026-10-19T13:50:47.198Z] [page] [云学堂自动] 本节已记录,切换下一节…
|
||||
[2026-10-19T13:50:47.198Z] [page] [云学堂自动] 进入下一节
|
||||
[2026-10-19T13:50:49.202Z] [page] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
|
||||
[2026-10-19T13:50:52.966Z] [api] 200 https://api-phx-tc.yunxuetang.cn/kng/study/kngPlay
|
||||
[2026-10-19T13:50:53.198Z] [page] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》下(钱百峰)
|
||||
|
||||
最终状态:
|
||||
summary=已完成 2/3
|
||||
status=自动刷课已暂停
|
||||
video={"paused": true, "ended": false, "currentTime": 58.4, "duration": 273, "muted": false, "rate": 1, "src": "blob:https://kfmic.yunxuetang.cn/3d699349-bcb6-40eb-a7f8-67b9602149a2"}
|
||||
countdown=还需 3分钟 35秒 可完成本课程学习并获得0.23学分,加油!
|
||||
@@ -1,68 +0,0 @@
|
||||
云学堂助手 v2.5.2 · 起点对齐回归(本地复刻目录)
|
||||
==================================================
|
||||
|
||||
背景
|
||||
----
|
||||
用户反馈:进入课程后不会从「第一个未学完的课时」开始,前面的课时被跳过 / 整门课学不完。
|
||||
真实站点需要登录,无法在本地直接复现,因此按 docs/archive/v2.0-snapshots/probe.txt、probe2.txt、probe4.txt
|
||||
里记录的真实目录结构,复刻课程页 DOM,再用无头 Chromium 注入用户脚本跑 20 秒,
|
||||
读取目录高亮、面板状态与控制台日志。复刻页面与用例脚本在 .run-tmp/align/(本机调试用,未入库)。
|
||||
|
||||
复刻的真实结构(来自 probe2.txt / probe4.txt)
|
||||
--------------------------------------------
|
||||
- .yxtulcdsdk-catalog ul > li:章节点含子 ul,课时是叶子 li
|
||||
- 课时 li > div.ml24.flex-center.flex-space-between > span.item(tag-type 在标题之前)+ 右侧 svg 状态图标
|
||||
- 完成态图标:起点 M10 2.75 的实心圆 + 对勾;未学完:空心圆;当前课时:带「!」的圆
|
||||
- 进入课程时平台停在「上次学习的位置」(用例里用 resume 参数模拟)
|
||||
- 本节视频 ended 后平台把完成数 +1,脚本据此切下一节
|
||||
|
||||
用例与结果(v2.5.1 → v2.5.2)
|
||||
------------------------------
|
||||
A1 批量 · 点击句柄在 li PASS → PASS
|
||||
A2 批量 · 点击句柄在行容器 PASS → PASS
|
||||
A3 批量 · 点击句柄在标题 span FAIL(停在平台上次位置第 5 节)→ PASS
|
||||
A4 批量 · 点击句柄在状态图标 PASS(第 6 次点击才命中)→ PASS
|
||||
A5 批量 · 完成态只有文字标签 FAIL(已学完被当成未学,退回第 1 节)→ PASS
|
||||
A6 批量 · 全部未学 PASS → PASS
|
||||
A7 批量 · 切换有确认弹窗 PASS → PASS
|
||||
A8 批量 · 目标在折叠章(展开箭头是 svg) PASS → PASS(展开章节日志正常)
|
||||
A9 手动 · 点击句柄在 li FAIL(完全不对齐,停在第 5 节)→ PASS
|
||||
A10 手动 · 点击句柄在标题 span FAIL(同上)→ PASS
|
||||
A11 批量 · 本节结束后切下一节 FAIL(记账后仍停在第 3 节)→ PASS
|
||||
A12 批量 · 本节结束后切下一节(图标句柄) FAIL(同上)→ PASS
|
||||
A13 手动 · 本节结束后切下一节 FAIL(未对齐,无进展)→ PASS
|
||||
|
||||
汇总:v2.5.1 = 6 PASS / 7 FAIL;v2.5.2 = 13 PASS / 0 FAIL
|
||||
|
||||
原因
|
||||
----
|
||||
1) clickLesson() 只点 li 和「li 内第一个 .hand」。真实目录里 .hand 是右侧的 <svg>,
|
||||
而 SVGSVGElement 没有 HTMLElement.click()(Chromium 实测 typeof svg.click === 'undefined'),
|
||||
svg.click() 抛 TypeError 后被 try/catch 静默吞掉,等于没点;句柄挂在标题 span /
|
||||
行容器上时,前 4 次点击都没命中,脚本就放弃并「按当前位置继续」。
|
||||
2) isLessonCompleted() 的文本兜底写成 /(已学完|已完成)$/,要求标签出现在 li 文本末尾;
|
||||
真实目录的 tag-type 在标题之前(probe2.txt:<span class="tag-type">视频</span>标题),
|
||||
标成「已学完 第1节」时永远匹配不到 → 已学完的课时被当成未学 → 目标退回第 1 节。
|
||||
3) 起点对齐只写在 courseTick()(批量刷课)里,manualCourseTick()(手动打开课程)没有对齐。
|
||||
4) findNextLessonElement() 返回 li 内第一个 .hand(真实目录里是 svg),
|
||||
advanceLesson() / manualCourseTick() 直接 next.click() → 同 (1),切节点击不生效。
|
||||
(docs 里 2.0.3 实跑看起来「切成功」,其实是平台自己播完自动连播。)
|
||||
|
||||
修复(v2.5.2)
|
||||
--------------
|
||||
- 新增 clickNode():HTMLElement 用 click(),svg 等没有 click() 的节点改派发 MouseEvent。
|
||||
- clickLesson() 按「标题 span → 行容器 → li → 状态图标」逐次尝试,并补 pointer/mouse 序列;
|
||||
对齐重试次数 4 → 8。
|
||||
- isLessonCompleted() 文案匹配去掉结尾锚定,并补充 aria-label/title/class 语义与图标路径兜底。
|
||||
- 起点对齐抽成 alignToFirstIncomplete(),courseTick() 与 manualCourseTick() 共用;
|
||||
手动模式按课程标题判断换课,每门课只对齐一次,标题还是 loading 时不做任何判断。
|
||||
- findNextLessonElement() 改回返回课时 li;切节用 switchLesson()(标题 → 行容器 → li → 图标,
|
||||
每步先确认还没切过去),advanceLesson() 与手动连播共用。
|
||||
- 章节展开、确认弹窗按钮统一走 clickNode();确认弹窗只在弹层内找按钮,避免误点页面其它按钮。
|
||||
|
||||
复现方式(本机)
|
||||
----------------
|
||||
$env:PLAYWRIGHT_PATH="<playwright 包目录>"
|
||||
$env:CHROME_PATH="<chromium 可执行文件>"
|
||||
node .run-tmp/align/run.mjs # 当前脚本
|
||||
$env:SCRIPT=".run-tmp/align/before.user.js"; node .run-tmp/align/run.mjs # 修复前对照
|
||||
@@ -1,142 +0,0 @@
|
||||
云学堂助手 v2.7.0 · 单视频自动播放 / 完成后转下一门 实跑与回归
|
||||
================================================================
|
||||
|
||||
结论
|
||||
----
|
||||
用户反馈的两个问题是同一个根因链条上的两处断点,均已在真实站点复现并修复:
|
||||
|
||||
1) 进入课程「有概率」不自动播放
|
||||
- 平台的播放页不只有 #/course/play。单个视频课程点开后走的是
|
||||
#/scan?kngId=… -> #/video/play?kngId=…,音频/课件还有 #/audio/play、#/ppt/play。
|
||||
- v2.6.0 的 route() 只把 #/course/play 识别为课程页,其它播放页返回 'other',
|
||||
主循环既不跑 courseTick 也不跑 manualCourseTick:不点「开始学习」、不接管视频。
|
||||
- 真实站点「氦泄漏通用」(type=2 / fileType=video / 60 秒,列表第 307 页)复现:
|
||||
进课后 150 秒内 S.phase 一直是 entering,video=null,面板停在
|
||||
「进入课程(1 分钟):氦泄漏通用」,done=0。
|
||||
|
||||
2) 一门课学完后不自动转到下一门
|
||||
- 平台课程真正学完时,汇总文案会从「已完成 0/1」变成 **「已完成学习」**;
|
||||
单视频页则是「已完成 0%」->「已完成 67%」-> **「已完成学习」**。
|
||||
此时倒计时和进度条都会消失。
|
||||
- v2.6.0 的 readSummary() 只匹配 /已完成(\d+)\/(\d+)/,读不到「已完成学习」和百分比,
|
||||
永远不判完成:停在课程页、不回列表、也不选下一门;而且播放器会把视频重置到 0 秒,
|
||||
v.ended 变回 false,脚本又调用 play() 从头重播。
|
||||
- 真实站点「如何搭建分销体系,实现用户指数级增长?(上篇)」(1 节 / 127 秒)复现:
|
||||
127 秒时 study/summary 已返回 finishNum=1/1、acqHours=127,页面汇总变成「已完成学习」,
|
||||
但 20 秒后 S.completedThisRun 仍为 0、S.current 未清空,video 被重新 play 到 0.5 秒。
|
||||
|
||||
真实站点证据
|
||||
------------
|
||||
复现环境:https://kfmic.yunxuetang.cn(江丰云课堂),2026-10-22,Asia/Shanghai。
|
||||
登录凭据来自用户级环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,没有写入脚本或仓库。
|
||||
|
||||
A. 单视频课程的实际路由与完成文案(#/video/play)
|
||||
------------------------------------------------
|
||||
NAV /kng/#/scan?kngId=283c683a-fa98-4f69-9e08-c45116118aa1
|
||||
NAV /kng/#/video/play?kngId=283c683a-fa98-4f69-9e08-c45116118aa1&projectId=&btid=&gwnlUrl=
|
||||
NET /kng/study/kngInfo {"title":"氦泄漏通用","type":2,"fileType":"video",...}
|
||||
NET /kng/study/summary {"finishNum":0,"totalNum":1,...,"studyHours":60}
|
||||
页面汇总:已完成 0% -> 已完成 33% -> 已完成 67% -> 已完成学习
|
||||
倒计时: 还需 59秒 …(从 60 秒开始,注意视频本身 107 秒,平台按 required time 计时)
|
||||
开始按钮:<button class="yxtf-button yxtf-button--primary yxtf-button--larger">开始学习</button>
|
||||
|
||||
修复前(v2.6.0)在该页连续 150 个 tick 的状态:
|
||||
status=进入课程(1 分钟):氦泄漏通用
|
||||
phase=entering done=0 video=- sum=已完成0% 150 秒无变化
|
||||
|
||||
B. 多课时课程完成后汇总变成「已完成学习」
|
||||
----------------------------------------
|
||||
NET /kng/study/summary {"finishNum":0,"totalNum":1,...,"studyHours":127}
|
||||
[14s] 页面汇总:已完成0/1
|
||||
[21s] 视频开始播放:video=play@0/127.1
|
||||
[148s] NET /kng/study/summary {"finishNum":1,"totalNum":1,"acqHours":127,...}
|
||||
[149s] 页面汇总:已完成学习(倒计时、进度条消失)
|
||||
status=学习中:视频如何搭建分销体系,实现用户指数型增长?(上)
|
||||
done=0 video=PAUSE@0/127.1
|
||||
[150s] video=play@0.5/127.1 ← 平台重置后脚本又把视频从头播放
|
||||
|
||||
修复内容(v2.7.0)
|
||||
------------------
|
||||
1) route() 识别全部播放页:#/course/play、#/video/play、#/audio/play、#/ppt/play、
|
||||
#/document/play、#/article/play,以及进课过渡页 #/scan。
|
||||
新增 mediaPage() 区分「有目录的多课时课程」和「单媒体播放页」。
|
||||
|
||||
2) readSummary() 同时解析三种真实完成文案:
|
||||
- 已完成 2/3 -> { x:2, y:3, complete:false, kind:'ratio' }
|
||||
- 已完成 67% -> { x:67, y:100, complete:false, kind:'percent' }
|
||||
- 已完成学习 -> { x:100, y:100, complete:true, kind:'done' }
|
||||
另用 [role="progressbar"] 的 aria-valuenow 兜底。
|
||||
|
||||
3) courseTick():
|
||||
- 单视频/音频页不再走目录对齐,也不把百分比进度当成「一节学完」去切节;
|
||||
- 汇总 complete 时(比例满、100%、已完成学习)统一 completeCurrent();
|
||||
- 新增 doneLatchKey:倒计时归零/video.ended 后记住本节已播完,
|
||||
平台把播放器重置到 0 秒时不再自动 play,避免完成后重播;
|
||||
- 单媒体页等待记账时只轮询汇总,不调用 advanceLesson()。
|
||||
|
||||
4) 进课判定改用 URL 的 kngId:startCourse() 把课程 id 写入 S.current.id,
|
||||
courseTick() 优先用 kngId 比对,标题短暂是 loading.../在线课堂 时不再误判;
|
||||
宽限从 12 秒提高到 30 秒(CFG.entryGraceMs)。#/scan 只是过渡页,此时不做完成判定,
|
||||
防止读到上一门课残留的「已完成学习」。
|
||||
|
||||
5) 自动播放兜底:「开始学习」冷却 15 秒 -> 3 秒(3 秒没起播就补点);
|
||||
选择器在 button/a 之外支持最内层 div/span,并跳过 disabled 按钮;
|
||||
手动模式(手动课程自动连播)在单媒体页也会点开始;
|
||||
点课程卡片后 4 秒仍停在列表时自动补点,最多 2 次,不再直接记为失败跳过。
|
||||
|
||||
6) 完成文案连续两次读到才确认(三种完成文案统一),避免 SPA 切页瞬间
|
||||
把上一门课的完成文案算到新课程上。completeCurrent() 改为强制返回列表
|
||||
(不受 goToList 5 秒节流影响),并先 pause 播放器;列表页把「已完成/已学习」
|
||||
也当作完成状态过滤。
|
||||
|
||||
回归用例(本地复刻 DOM,Playwright)
|
||||
------------------------------------
|
||||
node .run-tmp/align/run.mjs => 13 PASS / 0 FAIL(起点对齐 + 自动切节)
|
||||
node .run-tmp/complete/run.mjs => 8 PASS / 0 FAIL
|
||||
E1 首次点卡片无反应:自动补点进入课程
|
||||
U1 readSummary 解析 x/y、百分比、已完成学习
|
||||
U2 route 识别 course/video/audio/ppt/scan
|
||||
V1 单视频课:自动播放 -> 完成后进入下一门
|
||||
C1 多课时课:已完成学习 -> 回列表 -> 下一门
|
||||
L1 标题 loading 但 kngId 匹配:不误判、继续播放
|
||||
T1 倒计时归零后平台重置视频:不重播,汇总更新后照常进入下一门
|
||||
D1 「开始学习」是 div 时仍能自动播放
|
||||
|
||||
真机修复后验证
|
||||
--------------
|
||||
场景 1:已完成的多课时课程(#/course/play,汇总「已完成学习」)
|
||||
[11s] 课程完成:如何搭建分销体系,实现用户指数级增长?(上篇)第 1 门,返回列表选下一门
|
||||
[12s] NAV /kng/#/list
|
||||
[15s] 回到列表第 1 页,继续…
|
||||
[22s] 短课程队列已就绪:待学 5131 门;最短 2 分钟
|
||||
[25s] 进入课程(2 分钟):如何制定渠道战略
|
||||
[27s] 跳过:如何制定渠道战略(课程包含考试/测验章节)
|
||||
[28s] 回到列表第 13 页,继续… -> 第 63 页
|
||||
[31s] 进入课程(2 分钟):APP做裂变的三大专属玩法
|
||||
[38s] 学习中:视频APP做裂变的三大专属玩法(video=0.6/132.1)
|
||||
[PASS] complete=true next=APP做裂变的三大专属玩法 playing=true
|
||||
|
||||
场景 2:已完成的单视频课程(#/video/play,汇总「已完成学习」)
|
||||
[11s] 课程完成:氦泄漏通用 第 1 门,返回列表选下一门
|
||||
[12s] NAV /kng/#/list
|
||||
[16s] 短课程队列已就绪:待学 5131 门;最短 2 分钟
|
||||
[19s] 进入课程(2 分钟):如何制定渠道战略 -> 跳过(考试/测验章节)
|
||||
[25s] 进入课程(2 分钟):APP做裂变的三大专属玩法
|
||||
[32s] 学习中:视频APP做裂变的三大专属玩法(video=1.3/132.1)
|
||||
[PASS] complete=true next=APP做裂变的三大专属玩法 playing=true
|
||||
|
||||
复现命令(本机)
|
||||
----------------
|
||||
$env:PLAYWRIGHT_PATH="<playwright 包目录>"
|
||||
$env:CHROME_PATH="<chromium 可执行文件>"
|
||||
node .run-tmp/align/run.mjs
|
||||
node .run-tmp/complete/run.mjs
|
||||
# 真机观测/验证需要 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD
|
||||
$env:YUN_XUE_TANG_USR=...; $env:YUN_XUE_TANG_PWD=...
|
||||
node .run-tmp/real/probe-bugs2.mjs # 修复前:video/play 全程不动作
|
||||
node .run-tmp/real/verify-fix.mjs # 修复后:两个场景 PASS
|
||||
|
||||
清理说明
|
||||
--------
|
||||
- 登录态 storageState(.run-tmp/real/state.json)与调试截图只在本地调试目录,验证完成后删除。
|
||||
- 仓库内没有写入账号、密码、token 或 cookie。
|
||||
@@ -1,5 +0,0 @@
|
||||
还需2小时7分钟59秒可完成本课程学习并获得6.52学分,加油! -> 7679
|
||||
还需5分钟可完成本课程学习并获得0.25学分,加油! -> 300
|
||||
还需4分钟10秒可完成本课程学习并获得0.25学分,加油! -> 250
|
||||
还需59秒可完成本课程学习并获得0.25学分,加油! -> 59
|
||||
已完成 -> null
|
||||
@@ -1,361 +0,0 @@
|
||||
云学堂助手 · 无头运行(Linux 无图形化服务器)证据
|
||||
==================================================
|
||||
|
||||
一、需求
|
||||
- 用户诉求:「支持无头模式运行在linux无图形化服务器上」。
|
||||
- 澄清后的范围:新增无头运行器 + 部署说明;常驻方式为手动前台跑(tmux/nohup,
|
||||
不做 systemd / Docker);持久化 profile,掉登录时用环境变量账号自动重登。
|
||||
|
||||
|
||||
二、方案
|
||||
新增 `runner/`,不装 Tampermonkey、不装桌面环境、不需要 Xvfb:
|
||||
|
||||
| 文件 | 作用 |
|
||||
| --- | --- |
|
||||
| runner/headless.mjs | 入口(约 90 行):解析参数 → 预检 → 交给 supervisor |
|
||||
| runner/config.mjs | 命令行参数与环境变量(--max / YUN_XUE_TANG_* 集中在此) |
|
||||
| runner/preflight.mjs | 启动前检查:产物、Node 版本、凭据、浏览器、调试端口 |
|
||||
| runner/log.mjs | 终端 + 文件日志(5MB 轮转) |
|
||||
| runner/stop.mjs | SIGINT / SIGTERM 优雅退出(注册式收尾) |
|
||||
| runner/browser.mjs | 浏览器探测(含 Linux/容器常见路径)、启动参数、陈旧 SingletonLock 清理 |
|
||||
| runner/cdp.mjs | 极简 CDP 客户端(Node 22+ 原生 WebSocket + fetch,无第三方依赖) |
|
||||
| runner/page.mjs | 注入后要调用的页面 JS 表达式 + page.evalJS/json/tryEval |
|
||||
| runner/session.mjs | 单次会话:起浏览器 → 注入 → 自动重登 → 起批量 → 监控 → 收尾 |
|
||||
| runner/selfcheck.mjs | --check 的只读环境自检 |
|
||||
| runner/supervisor.mjs | 崩溃重启循环与退出码 |
|
||||
|
||||
依赖方向是单向的:headless → supervisor → session → page/selfcheck → cdp,无循环引用。
|
||||
按需求不打包:node runner/headless.mjs 直接跑多文件 ESM,部署时整个 runner/ 目录一起带走。
|
||||
改脚本内部 API(window.__yunXueTangAuto 上的方法)时只需要改 runner/page.mjs。
|
||||
|
||||
注入方式与 Tampermonkey 等价:用 `Runtime.evaluate` 把构建产物源码注入页面主世界
|
||||
(脚本 `@grant none`,不需要沙箱隔离),因此每次整页跳转(新 document)都要重新注入,
|
||||
运行器用 1.5 秒的看护循环检测 `window.__yunXueTangAuto` 是否存在并补注入。
|
||||
|
||||
|
||||
三、Linux 无图形化环境的三个必踩坑(与代码对应)
|
||||
1) 没有 DISPLAY:有界面模式直接报 `Missing X server or $DISPLAY` 并退出。
|
||||
- `runner/browser.mjs:hasDisplay()` 判 `DISPLAY` / `WAYLAND_DISPLAY`;
|
||||
- `runner/headless.mjs` 里 `VISIBLE = WANT_VISIBLE && hasDisplay()`,
|
||||
即**即使传了 `--visible` 也会被强制无头并打警告**;
|
||||
- `dev/tests/real-cdp.mjs:forceHeadless()` 让三个真机测试脚本同样自动无头。
|
||||
2) root 运行:Chromium 拒绝启动(`Running as root without --no-sandbox is not supported`)。
|
||||
- `safetyArgs()` 在 `process.getuid()===0` 时补 `--no-sandbox --disable-setuid-sandbox --disable-gpu`;
|
||||
- `buildArgs()` 在 Linux 上恒加 `--no-sandbox --disable-setuid-sandbox`。
|
||||
3) 容器 /dev/shm 只有 64MB:标签页会莫名崩溃(`Target closed`)。
|
||||
- Linux 上恒加 `--disable-dev-shm-usage`。
|
||||
|
||||
另外补的稳定性参数:`--no-zygote`、`--disable-gpu`、`--mute-audio`、
|
||||
`--autoplay-policy=no-user-gesture-required`(无人值守必须能自己起播)、
|
||||
`--disable-background-timer-throttling` / `--disable-renderer-backgrounding` /
|
||||
`--disable-backgrounding-occluded-windows`(后台标签页不节流,否则计时会停)。
|
||||
|
||||
实测(在 Windows 上把 process.platform 覆盖成 linux、getuid 覆盖成 0 验证分支取值):
|
||||
|
||||
safetyArgs() root ["--disable-dev-shm-usage","--no-sandbox","--disable-setuid-sandbox","--disable-gpu"]
|
||||
hasDisplay() 无 DISPLAY false
|
||||
hasDisplay() 有 DISPLAY true
|
||||
关键参数(root 无头) ["--autoplay-policy=no-user-gesture-required","--mute-audio","--disable-dev-shm-usage",
|
||||
"--disable-gpu","--no-zygote","--no-sandbox","--disable-setuid-sandbox","--headless=new"]
|
||||
有界面+关沙箱 [] ← 非 Linux 不注入任何沙箱参数,保留本机 Chrome 沙箱
|
||||
|
||||
陈旧的 `SingletonLock`(上次被 kill -9 留下的符号链接指向已不存在的 pid)会被清理,
|
||||
活跃的锁保留;清理后普通文件形式的 `SingletonCookie` 也一并删除(实测:lock=false, cookie=false)。
|
||||
|
||||
|
||||
四、可观测能力与容错
|
||||
- 持久化:profile 固定到 `./.run-profile`(`YUN_XUE_TANG_PROFILE_DIR` 可改),cookie / localStorage 都在里面;
|
||||
删掉该目录 = 重置登录态 + 进度缓存。
|
||||
- 自动重登:看护循环每 1.5 秒读一次 `isLoginPage()`,是登录页就填账号密码 + 勾协议 + 点登录;
|
||||
20 秒限速、连续 5 次失败则退出码 3(多半是密码错或站点要验证码)。
|
||||
- 崩溃自愈:CDP 断线 / 90 秒读不到脚本状态 → 抛错 → 外层等 15s、30s… 最多 120s 后重建浏览器,
|
||||
进度由页面 localStorage(`yun-xue-tang-batch-v2`)接续。
|
||||
- 无进展保护:课程/课时/进度/视频任一有变化即重置计时,连续 30 分钟(`YUN_XUE_TANG_IDLE_RESTART_MINUTES`)
|
||||
没变化则判定卡死退出。
|
||||
- 编解码自检:`--check` 会探测 `video/mp4; codecs="avc1.42E01E"`;运行中若
|
||||
`video.error.code >= 3` 立刻告警「这个 Chromium 不带 H.264/AAC」。
|
||||
- 优雅退出:SIGINT/SIGTERM → 页面内 `pauseAllMedia()` + `S.running=false` + `save()` → 关浏览器。
|
||||
- 日志:终端 + `./run-logs/headless.log`,超 5MB 轮转成 `.1`。
|
||||
- 端口占用:启动前先探 `/json/version`,被占时直接提示 `pkill -f "remote-debugging-port=9336"`
|
||||
或换 `--port`(实测提示正确,exit 2)。
|
||||
|
||||
|
||||
五、实跑验证(真实站点 kfmic.yunxuetang.cn,真实账号)
|
||||
1) 环境自检 `npm run headless:check`(只读、不登录、不动进度):
|
||||
|
||||
PASS 页面可访问 → https://kfmic.yunxuetang.cn/login.html
|
||||
PASS 脚本已注入 window.__yunXueTangAuto → object
|
||||
PASS 面板渲染唯一 → {"面板数":1,"可见":true}
|
||||
PASS 脚本版本可读 → "v2.7.0"
|
||||
PASS 视频编解码 H.264 可用 → {"h264":"probably","aac":"probably","vp9":"probably"}
|
||||
页面识别的路由:other 是否登录页:true
|
||||
|
||||
2) 真跑 `node runner/headless.mjs --max 1`(无头、自动登录、真实刷课):
|
||||
|
||||
浏览器就绪:Chrome/155.0.8059.85
|
||||
已注入脚本(第 1 次):https://kfmic.yunxuetang.cn/login.html
|
||||
登录页:自动登录(第 1 次尝试)
|
||||
已注入脚本(第 2 次):https://kfmic.yunxuetang.cn/sparring/#/web/drillmate
|
||||
已注入脚本(第 3 次):https://kfmic.yunxuetang.cn/kng/#/list?...
|
||||
页面:优先短课程:共 5109 门待学,最短 2 分钟
|
||||
页面:跳过:如何制定渠道战略(课程包含考试/测验章节)
|
||||
页面:起点已对齐:第 1 节 视频如何读懂留存曲线?
|
||||
页面:学习中:视频如何读懂留存曲线?
|
||||
页面:课程完成: 如何读懂留存曲线? 第 1 门,返回列表选下一门
|
||||
页面:本次已完成 1 门,已停止。
|
||||
本次会话结束:已完成 1 门(达到 --max 上限) 用时 2 分 19 秒 本次完成 1 门,累计 1 门
|
||||
=== 运行器退出 === (退出码 0)
|
||||
|
||||
3) 崩溃自愈(kill -F 掉浏览器主进程后):
|
||||
会话异常:CDP 连接断开,重启浏览器
|
||||
浏览器/连接异常,15 秒后重试(第 1 次)
|
||||
--- 第 2 次尝试 ---
|
||||
浏览器就绪:Chrome/ ...
|
||||
登录页:自动登录(第 1 次尝试) ← profile 里的 cookie 过期后被站点踢回登录页,自动重登成功
|
||||
已注入脚本(第 3 次):...#/list... ← 列表页新 document 重新注入
|
||||
状态:进入课程(3 分钟):什么是增长黑客
|
||||
页面:点击开始学习 继续学习
|
||||
页面:学习中:视频什么是增长黑客?
|
||||
|
||||
4) 优雅退出(kill -TERM 运行器进程):
|
||||
[浏览器] 进程退出 code=143 ← 浏览器被 SIGTERM 收掉
|
||||
残留 chrome 进程数:0 ← 没有孤儿进程
|
||||
|
||||
5) 缺凭据时直接拒绝并给原因:`缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD。`,退出码 2。
|
||||
|
||||
|
||||
六、回归(改动没有破坏原有链路)
|
||||
- `npm run check`:24 个文件逐个 `node --check` 全通过(新增 runner/*.mjs 与 dev/tests/real-run.mjs 也已纳入)。
|
||||
- `npm run test:real:headless`(真机只读断言):**24/24 通过,失败 0**。
|
||||
- `node dev/tests/real-e2e.mjs --headless`:**12/12 通过,失败 0**(真实登录 → 新 document → 列表 16 张卡片 / 322 页)。
|
||||
- `node dev/tests/real-run.mjs --headless --scan`:**3/3 通过,失败 0**。
|
||||
|
||||
|
||||
七、已知限制
|
||||
- 无头环境无法完成滑块/拼图类验证码:需要先在有界面模式(本机或 `xvfb-run` + `x11vnc`)
|
||||
人工登录一次,之后靠持久化 profile 的 cookie 免登录。
|
||||
- 服务器上如果装的是 `chromium`(Debian/Ubuntu 的 Chromium 包),可能不带 H.264/AAC:
|
||||
课程视频会一直 0 秒。`--check` 会直接给出提示,改装 `google-chrome-stable` 即可。
|
||||
- 运行器是前台进程,进程管理交给 tmux / nohup / screen,不内置守护模式(按需求如此)。
|
||||
|
||||
|
||||
八、拆分重构(单文件过长 → 模块化)与回归
|
||||
------------------------------------------
|
||||
用户反馈「单文件代码太多了,考虑拆分」。runner/headless.mjs 从 626 行拆成 11 个模块、
|
||||
入口只剩 90 行(结构见第二节表格),**不引入打包步骤**(按用户选择:保持直接 import)。
|
||||
|
||||
同时把 package.json 的 check 从「一长串 node --check a && node --check b …」
|
||||
改成 scripts/check.mjs 自动遍历 runner/、dev/、scripts/ 与 config/ —— 以前新增模块必须手改那行命令,
|
||||
漏改就会静默不被检查。现在输出:语法检查:20/20 个文件通过。
|
||||
|
||||
拆分过程中发现并修掉 3 个真实缺陷(都是原单文件里藏着的):
|
||||
|
||||
1) 端口占用检查被自己的 try/catch 吞掉
|
||||
- preflight 里 fail() 在 try 块内抛出,又被同一个 catch 接住,等于端口占用永不报警;
|
||||
- 而 Chrome 起来后会拒绝启动,外层只是不断重试。现在只捕获探测本身的异常。
|
||||
- 实测:假 CDP 服务占住 9336 → 退出码 2,三行提示(占用者、pkill 命令、换端口建议)。
|
||||
|
||||
2) 连续登录失败不会退出(最严重)
|
||||
- 原代码在看护循环里 throw,但 setInterval 的 catch 把它当「看护循环异常」打印成警告,
|
||||
主循环永远看不到这个错误:错误凭据下会无限刷日志、永不退出。
|
||||
- 修法:致命错误寄存到 fatalError + 停掉定时器,主循环抛出;supervisor 据此返回退出码 3。
|
||||
- 实测(故意错的账号密码):5 次尝试(每次 20 秒限速)→
|
||||
会话异常:连续 5 次登录失败:请检查 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,… → 退出码 3。
|
||||
|
||||
3) 会话抛错时浏览器没收干净
|
||||
- 异常路径跳过了 disposeSession,浏览器进程残留会占住 CDP 端口,下一轮重启撞端口。
|
||||
- 修法:session 暴露 disposeActiveSession()(幂等),supervisor 在 catch 里先调用它。
|
||||
- 实测:退出码 3 之后残留 chrome 进程数 0。
|
||||
|
||||
回归(重构后全部重跑,真实站点、真实账号):
|
||||
|
||||
npm run check 语法检查:20/20 个文件通过(原 12 个,新增 8 个模块)
|
||||
npm run headless:check 5/5 PASS,退出码 0
|
||||
node runner/headless.mjs --max 1 真实完成 1 门,退出码 0(多次重跑:2 分 16 秒 / 3 分 39 秒)
|
||||
kill 浏览器主进程 会话异常:CDP 连接断开 → 15 秒后第 2 次尝试 → 自动重登 → 继续刷课
|
||||
SIGTERM 浏览器 code=143,残留 chrome 进程数 0
|
||||
npm run test:real:headless 24/24 通过
|
||||
node dev/tests/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/tests/real-run.mjs --headless --scan 3/3 通过
|
||||
|
||||
stop.mjs 的单元核查(一次性脚本,未入库):注册的收尾函数全部执行、已注销的不执行、
|
||||
重复信号不重复执行、收尾后调用 onExit(0)。
|
||||
stop.mjs 全部断言通过:{"order":["browser.kill","log.close"],"exited":0,"lines":["收到 SIGTERM,正在收尾…"]}
|
||||
|
||||
======================================================================
|
||||
九、跨平台适配(追加 Windows / macOS 支持,实测于 Windows)
|
||||
======================================================================
|
||||
|
||||
背景:无头运行器最初只按「Linux 无图形化服务器」设计,但项目主开发机是 Windows。
|
||||
实际运行暴露了一批 Windows 专属问题(强杀后残留、锁文件名字不同、SIGTERM 收不到、
|
||||
Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模块里抽出来集中处理。
|
||||
|
||||
9.1 新增 runner/platform.mjs(平台差异唯一出口)
|
||||
|
||||
isWindows / isLinux / isMac / platformName
|
||||
isRunningAsRoot() getuid()===0
|
||||
hasDisplay() 有无图形会话;支持 YUN_XUE_TANG_HAS_DISPLAY=0/1 强制覆盖
|
||||
Linux 看 DISPLAY/WAYLAND_DISPLAY
|
||||
Windows 看 SESSIONNAME(Services = Session 0,无桌面)
|
||||
noDisplayReason() 给日志用的人话原因
|
||||
safetyArgs() 本平台需要的额外启动参数
|
||||
Linux: --disable-dev-shm-usage(+ root: --no-sandbox 等)
|
||||
Windows: 不注入 --no-sandbox;只加 --disable-session-crashed-bubble
|
||||
--hide-crash-restore-bubble(避免无人值守时弹窗等人点)
|
||||
killTree(child) 进程树收尾:POSIX SIGTERM→SIGKILL;Windows TerminateProcess
|
||||
+ 兜底 taskkill /T /F
|
||||
killProfileOrphans(profileDir) 按 --user-data-dir 找残留浏览器进程并杀掉(自愈)
|
||||
Linux: ps -eo pid=,args=
|
||||
Windows: Get-CimInstance Win32_Process + taskkill
|
||||
portInUseHint(port) 按平台出排查命令
|
||||
browserInstallHint() / residentHint() 按平台出安装与常驻建议
|
||||
|
||||
browser.mjs 转发 platform.mjs 的导出(safetyArgs / hasDisplay / isRunningAsRoot 等),
|
||||
老的调用方(dev/tests/real-cdp.mjs、dev/tests/real-*.mjs)不需要改 import。
|
||||
|
||||
9.2 各模块的改动点
|
||||
|
||||
browser.mjs CANDIDATES 补 Windows 用户级安装(LOCALAPPDATA)与 Edge/Chromium 路径,
|
||||
可执行名匹配改为 EXE_RE(认 .exe);
|
||||
buildArgs 把 --disable-dev-shm-usage / --no-zygote 限定为非 Windows;
|
||||
spawn 加 windowsHide(否则无人值守时闪黑框);
|
||||
kill() 改为 platform.killTree();
|
||||
cleanStaleSingleton 在 Windows 上额外清 lockfile(普通文件,无法反查 pid,
|
||||
所以先 killProfileOrphans 再清)。
|
||||
preflight.mjs 浏览器缺失提示、Node 升级提示、端口排查命令全部按平台出;
|
||||
端口被占时先 killProfileOrphans 自愈一次,再判断是否真的失败。
|
||||
stop.mjs 监听 SIGINT + SIGBREAK + SIGHUP(Windows 上 SIGTERM 根本收不到,
|
||||
Ctrl+C 是 SIGINT,Ctrl+Break 是 SIGBREAK,关窗口是 SIGHUP)。
|
||||
config.mjs VISIBLE = WANT_VISIBLE && hasDisplay(),导出 platformName / noDisplayReason。
|
||||
supervisor.mjs 启动横幅打平台名;--visible 被忽略时用 noDisplayReason() 说原因。
|
||||
headless.mjs 注释补 Windows 用法(set / $env:)与代码结构。
|
||||
dev/tests/real-*.mjs spawn 补 windowsHide: true。
|
||||
|
||||
9.3 实测(Windows 11 / Chrome 155.0.8059.85 / Node v24.19.0)
|
||||
|
||||
平台判断
|
||||
hasDisplay() → true(SESSIONNAME=Console)
|
||||
safetyArgs() → ["--disable-session-crashed-bubble",
|
||||
"--hide-crash-restore-bubble"]
|
||||
buildArgs 平台相关参数 → --disable-gpu / --disable-session-crashed-bubble
|
||||
/ --hide-crash-restore-bubble / --headless=new
|
||||
(无 --no-sandbox / --disable-dev-shm-usage)
|
||||
模拟 SESSIONNAME=Services → hasDisplay() false,--visible 被忽略
|
||||
|
||||
killTree(进程树收尾)
|
||||
启动后同 profile chrome 进程数 10
|
||||
b.kill() 返回用时 206ms
|
||||
kill 后进程数 0 ✔ 无残留
|
||||
|
||||
killProfileOrphans(残留自愈)—— 用 detached 造出「父进程退出后仍活着」的浏览器
|
||||
detached 浏览器进程数 10
|
||||
端口 9358 可响应 true
|
||||
killProfileOrphans 返回 10
|
||||
清理后进程数 / 端口 9358 0 / false ✔
|
||||
|
||||
预检自愈(端到端)
|
||||
先用残留浏览器占住默认端口 9336 端口可响应 true
|
||||
node runner/headless.mjs --check
|
||||
[预检] 已清理 11 个占用本 profile 的残留进程,重新检测端口…
|
||||
PASS 页面可访问 / 脚本已注入 / 面板渲染唯一 / 版本可读 / H.264 可用
|
||||
退出码 0 ✔ 自愈成功(不再误报退出码 2)
|
||||
|
||||
Windows 上的信号事实(一次性脚本核查,未入库)
|
||||
process.kill(pid, 'SIGINT') 子进程被直接终止,SIGINT 处理函数不执行
|
||||
process.kill(pid, 'SIGTERM') 报 ESRCH,不可用
|
||||
taskkill /pid <pid>(不带 /F) 报「无法终止」;必须 /F,而 /F 是 TerminateProcess
|
||||
→ 结论:Windows 上跨进程没有优雅信号,只有当前控制台的 Ctrl+C 能触发 SIGINT。
|
||||
因此 stop.mjs 监听 SIGINT/SIGBREAK/SIGHUP,并把「强杀留下残局」交给 killProfileOrphans 兜底。
|
||||
|
||||
真实链路回归(真实站点 kfmic.yunxuetang.cn、真实账号)
|
||||
npm run headless:check 5/5 PASS,退出码 0
|
||||
node runner/headless.mjs --max 1 已完成 1 门(用时 3 分 9 秒),退出码 0
|
||||
npm run test:real:headless 24/24 通过
|
||||
node dev/tests/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/tests/real-run.mjs --headless --scan 3/3 通过
|
||||
npm run check(scripts/check.mjs) 24/24 个文件通过
|
||||
|
||||
9.4 Windows 额外交付
|
||||
|
||||
scripts/start-headless.cmd 一键启动(自动构建 / 检查 Node / 退出码说明 + pause)
|
||||
README「无头运行」一节 改成 Linux / Windows 双栏,补「Windows 常驻三种方式」
|
||||
与按平台分的「无图形环境常见坑」表
|
||||
环境变量 YUN_XUE_TANG_HAS_DISPLAY 0/1 强制认定有无图形会话(自动判断不准时用)
|
||||
|
||||
9.5 buildArgs 参数去重(Linux 分支在 Windows 上模拟验证)
|
||||
|
||||
platform.mjs 在模块加载时就用 process.platform 定下了常量,因此模拟 Linux 必须在
|
||||
import 之前改写(一次性脚本 .run-tmp/linux-sim.mjs,用 Object.defineProperty 覆盖
|
||||
process.platform='linux'、process.getuid=()=>0、清掉 DISPLAY/WAYLAND_DISPLAY)。
|
||||
|
||||
hasDisplay() → false(无 DISPLAY)
|
||||
noDisplayReason() → 当前环境没有图形显示(DISPLAY / WAYLAND_DISPLAY 都为空)
|
||||
safetyArgs() → ["--disable-dev-shm-usage","--no-sandbox",
|
||||
"--disable-setuid-sandbox","--disable-gpu"]
|
||||
buildArgs(去重后) → --disable-gpu / --disable-dev-shm-usage / --no-zygote
|
||||
/ --no-sandbox / --disable-setuid-sandbox / --headless=new
|
||||
portInUseHint(9336) → ["ss -lptn \"sport = :9336\"", "pkill -f \"remote-debugging-port=9336\""]
|
||||
|
||||
发现并修掉:手写的 Linux 参数与 safetyArgs() 有重叠(--disable-dev-shm-usage /
|
||||
--no-sandbox / --disable-setuid-sandbox 各出现两次),Chrome 收到重复开关没有意义,
|
||||
改为 [...new Set(args)] 去重后再拼 extraArgs。Windows 侧核查重复项:无。
|
||||
|
||||
======================================================================
|
||||
十、Windows 批处理启动脚本的编码陷阱(scripts/start-headless.cmd 报「不是内部或外部命令」)
|
||||
======================================================================
|
||||
|
||||
10.1 现象
|
||||
|
||||
双击 scripts/start-headless.cmd,控制台输出:
|
||||
'e' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'鍏?npm' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'rofile' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'nner' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'姝e父鏀跺熬' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
即:整行被拆成几段、中文乱码(UTF-8 字节被按 GBK 解释)、还丢了字符。
|
||||
|
||||
10.2 根因(两个独立问题叠加)
|
||||
|
||||
a) 行尾是裸 LF。cmd.exe 逐行读取批处理,但它只认 CRLF;只有 LF 时会漏掉换行,
|
||||
把上一行的尾部当成下一行命令的一部分 —— 于是出现 'e' / 'rofile' / 'nner'
|
||||
这种「从单词中间开始」的片段。
|
||||
b) 文件里有非 ASCII 字符(中文)。cmd.exe 按当前代码页(中文 Windows 是 936/GBK)
|
||||
逐字节读,UTF-8 编码的中文占 3 字节,被当成 3 个 GBK 字符,行读取指针随之错位,
|
||||
后续命令也跟着被截断 —— 于是出现 '鍏?npm'(UTF-8 的「关」被读成 GBK 乱码,
|
||||
连后面的空格和 npm 一起粘进来)和 '姝e父鏀跺熬'(「正常收尾」的乱码)。
|
||||
|
||||
对照实验(同一台机器,同一目录):
|
||||
CRLF + chcp 65001 + 中文 → 输出「中文提示 CRLF」「second line」 ✔ 正常
|
||||
LF + chcp 65001 + 中文 → '01' 不是内部或外部命令 / '文提示' 不是内部或外部命令 ✘ 错位
|
||||
所以 chcp 65001 并不能救 UTF-8 中文 —— 偏移发生在解析阶段,而不是显示阶段。
|
||||
|
||||
GBK 编码 + 不 chcp 的方案虽然能执行,但显示是乱码(终端代码页不匹配),
|
||||
且文件必须随系统区域设置改动,不适合入库。
|
||||
|
||||
10.3 采用方案:批处理只用 ASCII,中文交给 Node 输出
|
||||
|
||||
scripts/start-headless.cmd 与 scripts/start-dev.cmd 全部改写为纯 ASCII + CRLF:
|
||||
- 注释里写明「本文件必须保持纯 ASCII」及原因,避免以后有人手改回去;
|
||||
- 所有面向用户的提示(构建中 / 启动中 / 退出码含义 / 缺 Node)改用英文短句
|
||||
(如 [build] / [run] / [exit] / [error]),中文提示由 Node 侧日志输出;
|
||||
- 文件仍保留 chcp 65001,这样 Node 输出的 UTF-8 中文在控制台正常显示。
|
||||
|
||||
验证:
|
||||
file scripts/start-headless.cmd → DOS batch file, ASCII text, with CRLF line terminators
|
||||
非 ASCII 字节数 → 0(scripts/start-dev.cmd 同样为 0,原为 50)
|
||||
cmd /c scripts\start-headless.cmd --check → 5/5 PASS,退出码 0
|
||||
cmd /c scripts\start-headless.cmd(错误凭据)→ 连续 5 次登录失败 → [exit] code 3 → pause
|
||||
|
||||
10.4 防回归:scripts/check.mjs 增加批处理检查
|
||||
|
||||
`npm run check` 原来只跑 node --check,对 .cmd 完全无感知(所以这个 bug 是双击才发现)。
|
||||
现在 scripts/check.mjs 同时遍历 *.cmd / *.bat 并断言两件事:
|
||||
1. 不含任何 >0x7F 的字节(报错时给出首次出现的偏移与上下文片段);
|
||||
2. LF 与 CRLF 数量相等(存在裸 LF 就报错)。
|
||||
自测(临时文件,验证完即删):
|
||||
造一个 UTF-8 + LF 的坏文件 → FAIL,两条都被指出
|
||||
造一个 ASCII + CRLF 的对照文件 → PASS
|
||||
现在输出:静态检查:23/23 个文件通过(JS 21 · 批处理 2)
|
||||
|
||||
同时把这两条写进 README 的「无图形环境常见的坑」表(新增一行,症状列直接给出
|
||||
'鍏?npm' / '01' / 'rofile' 这三个典型报错原文,方便以后按报错搜索)。
|
||||
@@ -1,72 +0,0 @@
|
||||
云学堂助手 v2.6.0 · 优先短课程(时长正序)证据
|
||||
日期:2026-10-22(Asia/Shanghai)
|
||||
站点:https://kfmic.yunxuetang.cn/kng/#/list(已登录账号)
|
||||
|
||||
一、需求
|
||||
批量刷课时,不再只按列表顺序(最新发布)选课,而是优先学习总时长更短的课程(正序)。
|
||||
|
||||
二、真实数据结构
|
||||
列表卡片本身不显示时长。列表组件 ul.kng-list-new.__vue__ 的 kngListData 每项包含:
|
||||
- title 课程名
|
||||
- studyHours 课程总时长(秒)
|
||||
- status 1=学习中,2=已学完,0=未开始
|
||||
- id 课程 id(用于精确匹配卡片,避免同名课程点错)
|
||||
列表接口:POST https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist
|
||||
?limit=6000&offset=0&orderType=desc&orderBy=createTime
|
||||
请求体:
|
||||
{"collegeId":"<orgId>","catalogId":"","title":"","type":"","allTag":1,"tagIds":[]}
|
||||
鉴权最小请求头(实测):
|
||||
content-type: application/json;charset=UTF-8
|
||||
token: <localStorage.token>
|
||||
yxt-orgdomain: kfmic.yunxuetang.cn
|
||||
source: 501
|
||||
其中 limit=6000 可一次返回全站 5148 门课程(实测 8.65 MB,6.3 秒)。
|
||||
orderBy 传 studyHours 不会被服务端接受(返回默认顺序),所以脚本自行按 studyHours 正序排序。
|
||||
|
||||
三、真实站点读取结果(2026-10-22 20:07 左右)
|
||||
课程总数:5148
|
||||
未学完(status != 2):5134
|
||||
最短课程:氦泄漏通用,60 秒,status=0,位于第 307 页
|
||||
下一页最短:想精准触达消费者,你得了解立体用户画像!113 秒,第 73 页
|
||||
再下一页:如何搭建分销体系,实现用户指数型增长?(上篇)127 秒,第 71 页
|
||||
说明:平台存在同名课程(如「如何制定渠道战略」出现在多页),脚本优先按课程 id 匹配卡片。
|
||||
|
||||
四、真实列表页跳页 / 匹配验证
|
||||
目标:{"title":"氦泄漏通用","duration":60,"status":0,"page":307}
|
||||
1) 脚本读取时长队列后,jumpToPage(307) 成功,浏览器页码变为 307。
|
||||
2) 第 307 页 16 张卡片的标题中确实包含「氦泄漏通用」(第 12 张)。
|
||||
3) chooseShortCourse 返回 { title: "氦泄漏通用", duration: 60 },说明跨页映射与卡片匹配正确。
|
||||
日志:
|
||||
[云学堂助手] 正在读取课程时长,优先安排短课程…
|
||||
[云学堂助手] 短课程队列已就绪:待学 5134 门;最短 1 分钟
|
||||
[云学堂助手] 跳转到第 307 页
|
||||
[云学堂助手] 优先短课程:转到第 307 页(1 分钟)
|
||||
|
||||
五、回归测试(Playwright + 本地列表 fixture,3 个用例)
|
||||
命令:node .run-tmp/short-course/test-list.mjs
|
||||
结果:3 PASS / 0 FAIL
|
||||
[PASS] S1 短课程优先 · 跨页选全局最短
|
||||
点击 D 短课(期望 D 短课)/ 页码 2(期望 2)
|
||||
[PASS] S2 关闭开关 · 沿用列表顺序
|
||||
点击 A 长课(期望 A 长课)/ 页码 1(期望 1)
|
||||
[PASS] S3 接口失败 · 退回当前页时长正序
|
||||
点击 B 中课(期望 B 中课)/ 页码 1(期望 1)
|
||||
命令:node .run-tmp/short-course/test-restore.mjs
|
||||
结果:PASS
|
||||
[PASS] 回到列表恢复第 9 页:实际第 9 页(直接跳页,不一页页翻)
|
||||
覆盖点:
|
||||
- 接口可用时跨页选择全局最短;
|
||||
- 面板开关关闭时恢复原有顺序;
|
||||
- 接口 500 时降级为当前页 studyHours 正序;
|
||||
- 已学完(status=2)课程不进入队列;
|
||||
- 课程完成回到列表时,深页码(短课程优先会到 300+ 页)直接跳回,不逐页翻。
|
||||
|
||||
六、实现要点
|
||||
- 面板新增「优先短课程(时长正序)」复选框,默认开启,保存在 localStorage `yun-xue-tang-prefer-short`。
|
||||
- 队列缓存在 sessionStorage `yun-xue-tang-short-catalog-v1`,5 分钟有效,关闭标签页即清空。
|
||||
- 选课时按 studyHours 升序;时长未知的排最后。
|
||||
- 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。
|
||||
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
|
||||
|
||||
七、面板截图
|
||||
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选;展示图随仓库入库)
|
||||
@@ -1,193 +0,0 @@
|
||||
# 云学堂助手 · 实跑报告(v2.0.3)
|
||||
|
||||
> 历史记录:本报告对应 **v2.0.3**,当时的文件名为 `yunxuetang-auto-play.user.js`。
|
||||
> 脚本现已更名为 [`yun-xue-tang-assistant.user.js`](../../yun-xue-tang-assistant.user.js),当前版本 **v2.8.0**,
|
||||
> 下文记录的修复均已包含在当前版本中。v2.6.0 新增「优先短课程(时长正序)」,
|
||||
> 实跑与回归证据见 [`docs/evidence/short-course-evidence.txt`](../../docs/evidence/short-course-evidence.txt);
|
||||
> v2.7.0 修复单视频课程不自动播放与课程完成后不转下一门,
|
||||
> 证据见 [`docs/evidence/completion-next-evidence.txt`](../../docs/evidence/completion-next-evidence.txt)。
|
||||
|
||||
日期:2026-10-19 21:19–21:51(Asia/Shanghai)
|
||||
脚本:`yun-xue-tang-assistant.user.js`(v2.0.3 时名为 `yunxuetang-auto-play.user.js`),最终版本 **v2.0.3**
|
||||
|
||||
## 结论
|
||||
|
||||
- 脚本在真实站点(`kfmic.yunxuetang.cn`,江丰云课堂)跑通:登录 → 课程列表 → 批量选课 → 自动进入课程 → 静音 1x 播放 → 读取进度/倒计时。
|
||||
- **自动切节已端到端验证通过**:302 秒的第 1 节播完后平台进度 `0/3 → 1/3`,脚本切到第 2 节;v2.0.3 复跑又把第 2 节(305 秒)播完,进度 `1/3 → 2/3`,切到第 3 节「下(钱百峰)」。
|
||||
- 实跑共发现 4 个真实问题,均已修复:
|
||||
1. 「2小时 8分钟 34秒」格式的倒计时解析为 `null`;
|
||||
2. 只剩分钟(「还需 5分钟」)的倒计时也解析为 `null`;
|
||||
3. 自动切节会点回当前节(目录「章」节点也包含 `.liactive`);
|
||||
4. 平台在切节后自动显示的「还需 5分钟」是**下一节**的时长,旧逻辑可能据此把已结束的上一节视频拉回开头重播。
|
||||
- 实际影响了账号进度:`2025坚持的力量` 已完成第 1、2 节,当前 `2/3`;第 3 节在 58 秒处手动暂停。`KFMI2025...` 本轮又播了约 221 秒,进度仍为 `0/8`。
|
||||
|
||||
## 实跑 1:长课程 + 批量入口
|
||||
|
||||
| 步骤 | 实际结果 |
|
||||
| --- | --- |
|
||||
| 登录页 | `https://kfmic.yunxuetang.cn/login.html`,标题「登录-江丰云课堂」 |
|
||||
| 课程列表 | 第 1 页 16 张卡片;前两张「已学完」被正确跳过 |
|
||||
| 选中课程 | `KFMI2025年品质能力强化培训(APQP/CP/FMEA)`(学习中) |
|
||||
| 目录 | 10 个 `li` = 2 个章节点 + 8 个课时;汇总「已完成 0/8」 |
|
||||
| 播放 | `paused=false`、`muted=true`、`playbackRate=1`;`currentTime` 79s → 114s → 234s |
|
||||
| 倒计时 | 「还需 2小时 8分钟 34秒」 |
|
||||
| 停止 | 手动停在 234s,避免无人值守跑 2 小时以上 |
|
||||
|
||||

|
||||
|
||||
## 实跑 2:短课时验证自动切节
|
||||
|
||||
为了不让批量模式继续跑 2 小时的 KFMI 课程,这次把 `S.current` 指向短课程后开启批量逻辑(列表筛选逻辑已在实跑 1 验证)。课程来自同一列表,状态「学习中」:
|
||||
|
||||
`2025坚持的力量(黄文杰、袁倩靖、钱百峰)`,总时长 880 秒,共 3 节:
|
||||
|
||||
| 节 | 时长 | 起始进度 |
|
||||
| --- | --- | --- |
|
||||
| 上(黄文杰) | 302s | 0 |
|
||||
| 中(袁倩靖) | 305s | 0 |
|
||||
| 下(钱百峰) | 273s | 0 |
|
||||
|
||||
时间线(本地时间):
|
||||
|
||||
| 时间 | 事件 |
|
||||
| --- | --- |
|
||||
| 21:31:28 | 第 1 节开始播放,`duration=302.4s`,静音 1x |
|
||||
| 21:36:33 | 平台 `study/summary` 返回 `finishNum: 0 → 1`,`acqHours: 0 → 302` |
|
||||
| 21:36:34.933 | 脚本日志「本节已记录,切换下一节…」 |
|
||||
| 21:36:34.934 | 脚本日志「进入下一节」 |
|
||||
| 21:36:40.930 | 脚本日志「学习中:…中(袁倩靖)」;汇总「已完成 1/3」 |
|
||||
| 21:37:04 | 第 2 节播放到 20.6s 时手动暂停(最终停在 55.7s) |
|
||||
|
||||
平台接口证据:
|
||||
|
||||
```
|
||||
026 study/summary finishNum=0/3 acqHours=0
|
||||
049 study/summary finishNum=1/3 acqHours=302
|
||||
```
|
||||
|
||||
脚本日志证据:
|
||||
|
||||
```
|
||||
[21:36:34.933] [云学堂自动] 本节已记录,切换下一节…
|
||||
[21:36:34.934] [云学堂自动] 进入下一节
|
||||
[21:36:40.930] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
|
||||
```
|
||||
|
||||

|
||||
|
||||
## v2.0.3 复跑:第 2 节 → 第 3 节
|
||||
|
||||
这一轮专门验证「视频结束后不会被下一节的倒计时文案拉回重播」。为了避开目录点击,这次直接用第 2 节的 `locateshare` 地址进入:
|
||||
|
||||
| 时间 | 事件 |
|
||||
| --- | --- |
|
||||
| 21:45:37 | 第 2 节开始播放(平台自动起播),`duration=304.5s`;21:46:17 脚本接管时已到 40s |
|
||||
| 21:50:46 | 平台 `study/summary` 返回 `finishNum=2/3`,`acqHours=607`(302+305) |
|
||||
| 21:50:47.198 | 脚本日志「本节已记录,切换下一节…」 |
|
||||
| 21:50:47.198 | 脚本日志「进入下一节」 |
|
||||
| 21:50:53.198 | 脚本日志「学习中:…下(钱百峰)」,新视频 `duration=273s` 开始播放 |
|
||||
| 21:51:01+ | 第 3 节正常计时;到 58.4s 时手动暂停 |
|
||||
|
||||
关键点:第 2 节结束时,页面先出现的是第 3 节的提示「还需 4分钟 33秒」(第 3 节总长 273 秒),不是上一节的剩余时间;脚本没有把它当成第 2 节还没结束,也没有 seek 回 0,而是按 `video.ended` 直接进入第 3 节。平台汇总从 `1/3` 变为 `2/3`。
|
||||
|
||||
平台接口:
|
||||
|
||||
```
|
||||
073 study/summary finishNum=1/3 acqHours=342
|
||||
096 study/summary finishNum=2/3 acqHours=607
|
||||
```
|
||||
|
||||

|
||||
|
||||
测试过程中有一个插曲:第一次在批量运行中直接 `goto` 第 2 节地址,页面加载瞬间标题还是 `loading...`,脚本判定「页面课程与队列不一致」,按保护逻辑回到列表并选中了第一门未完成课程 KFMI,播了约 221 秒后才被手动停掉。正常从列表进入课程不会触发;但**刷新课程页/直接改 URL** 时确实可能遇到,属于已知限制,本轮未改。
|
||||
|
||||
## 问题 1:小时级倒计时解析失败
|
||||
|
||||
真实文案:
|
||||
|
||||
```
|
||||
还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!
|
||||
```
|
||||
|
||||
旧正则 `/还需(\d+)分钟(\d+)秒/` 只认「分钟+秒」,`readCountdown()` 返回 `null`。
|
||||
|
||||
修复(`readCountdown()`):改为小时/分钟/秒都可选,并至少匹配到一个数字。
|
||||
|
||||
## 问题 2:只剩分钟时也解析失败
|
||||
|
||||
这条文案不是上一节完成后的“剩余时间”,而是平台切到下一节后自动显示的下一节提示。实跑日志能看清顺序:
|
||||
|
||||
```
|
||||
21:36:28 当前节「还需 5秒」 汇总 0/3
|
||||
21:36:33 倒计时为空 汇总 1/3
|
||||
21:36:48 下一节「还需 5分钟」 下一节已播放 5.6s
|
||||
```
|
||||
|
||||
也就是说,`5分钟` 是下一节的总时长。对下一节本身来说它是有效的倒计时,但第一次修复后仍要求「秒」,所以这条会解析成 `null`。已把秒改为可选,并用 4 种真实格式验证:
|
||||
|
||||
| 文案 | 解析结果 |
|
||||
| --- | --- |
|
||||
| 还需2小时7分钟59秒… | 7679 |
|
||||
| 还需5分钟… | 300 |
|
||||
| 还需4分钟10秒… | 250 |
|
||||
| 还需59秒… | 59 |
|
||||
|
||||
## 问题 3:自动切节会点回当前节
|
||||
|
||||
真实目录里「章」节点也包含 `.liactive`,旧代码 `findIndex(li => li.querySelector('.liactive'))` 先命中章节点,于是「下一节」= 当前节。
|
||||
|
||||
线上对比(KFMI 课程):
|
||||
|
||||
- 旧逻辑:`视频2025-05-29--1`(当前节)
|
||||
- 修复后:`视频2025-05-29--2`(正确下一节)
|
||||
|
||||
修复(`findNextLessonElement()` / `lessonItems()`):新增 `lessonItems()` 过滤包含子 `ul` 的章节点;用 `active.closest('li')` 定位当前课时后再取下一个。`findFirstIncompleteLessonElement()` 同步改用 `lessonItems()`。
|
||||
|
||||
短课时实测已证明修复有效:脚本没有点回「上(黄文杰)」,而是进入「中(袁倩靖)」。
|
||||
|
||||
## 问题 4:切节后的「还需 5分钟」被误当成上一节还没结束
|
||||
|
||||
旧判断:
|
||||
|
||||
```js
|
||||
const localDone = (cd != null && cd <= 0) ||
|
||||
(v && v.ended && (cd == null || cd <= 3));
|
||||
```
|
||||
|
||||
如果视频已经 `ended`,但页面先挂出下一节的「还需 5分钟」(`cd=300`),`localDone` 会是 `false`;随后 `ensurePlaying()` 命中 `v.ended && cd > 3`,把视频 `currentTime = 0` 并重新播放,导致本节迟迟不切走。
|
||||
|
||||
这次实跑在 21:36:33 时倒计时刚好为空,所以脚本正常切了;但按你指出的平台行为,这条文案不能作为上一节是否结束的依据。修复:
|
||||
|
||||
- `localDone` 改为 `v.ended || cd <= 0`,`video.ended` 是本节结束的主信号(`courseTick()` 中的 `localDone`)。
|
||||
- `ensurePlaying()` 遇到 `ended` 直接返回,不再 seek 回 0(`if (v.ended) return`)。
|
||||
- 删除只为“提前结束补时长”服务的 `lastRestartAt` 重播分支;平台按真实时长计时,脚本本身也不快进,不需要它。
|
||||
|
||||
## 其他小修
|
||||
|
||||
- 视频开始播放后,面板从「点击开始学习…」恢复为「学习中:…」。
|
||||
- 列表状态标签优先匹配 `已学完/学习中/未开始/…`,避免其它标签被误判。
|
||||
- 版本号:2.0.0 → 2.0.1(前两个修复)→ 2.0.2(分钟级倒计时)→ **2.0.3**(完成后提示不再触发重播)。
|
||||
|
||||
## 说明
|
||||
|
||||
- 平台按真实播放时长计时,倍速/快进不会减少所需时间;本次没有伪造进度。
|
||||
- v2.0.2 验证了第 1 → 2 节;v2.0.3 验证了第 2 → 3 节,均实际切成功。
|
||||
- 第 3 节只有 273 秒,结束提示是下一节的「4分钟 33秒」,没有正好出现「5分钟」文案;但结束判断已改为 `video.ended`,本次确认没有重播。
|
||||
- 第 3 节停在 58 秒,没有再继续,避免把课程刷到 3/3。
|
||||
- 直接改 URL/刷新课程页时,页面标题短暂为 `loading...`,批量逻辑可能误判为课程不一致并回到列表;正常从列表进入不受影响。
|
||||
- 测试浏览器的登录配置目录已删除,未把会话留在工作区。
|
||||
|
||||
## 证据文件
|
||||
|
||||
- [`docs/archive/v2.0-snapshots/advance-evidence.txt`](../../docs/archive/v2.0-snapshots/advance-evidence.txt):平台进度 0→1、切节日志、最终状态
|
||||
- [`docs/archive/v2.0-snapshots/v203-advance-evidence.txt`](../../docs/archive/v2.0-snapshots/v203-advance-evidence.txt):v2.0.3 第 2→3 节、平台进度 1→2、最终状态
|
||||
- [`docs/archive/v2.0-snapshots/completion-banner-evidence.txt`](../../docs/archive/v2.0-snapshots/completion-banner-evidence.txt):完成后「还需 5分钟」出现的时序
|
||||
- [`docs/evidence/countdown-regex-test.txt`](../../docs/evidence/countdown-regex-test.txt):4 种倒计时格式的解析结果
|
||||
- [`docs/archive/v2.0-snapshots/probe.txt`](../../docs/archive/v2.0-snapshots/probe.txt)、[`probe2.txt`](../../docs/archive/v2.0-snapshots/probe2.txt)、[`probe4.txt`](../../docs/archive/v2.0-snapshots/probe4.txt):目录结构与新旧切节逻辑对比
|
||||
- [`docs/archive/v2.0-snapshots/report.txt`](../../docs/archive/v2.0-snapshots/report.txt):首轮运行状态与日志摘录
|
||||
- [`docs/screenshots/watch-006.png`](../../docs/screenshots/watch-006.png):首轮播放中截图
|
||||
- [`docs/screenshots/15-after-advance.png`](../../docs/screenshots/15-after-advance.png):v2.0.2 切到第 2 节后的画面
|
||||
- [`docs/screenshots/16-v203-next.png`](../../docs/screenshots/16-v203-next.png):v2.0.3 切到第 3 节、汇总 2/3 的画面
|
||||
|
||||
> 整理仓库时已删除 `.run-tmp/`(浏览器配置目录、一次性调试脚本与其余截图,约 460 MB);
|
||||
> 报告引用到的原始抓取片段已归档到 `docs/archive/v2.0-snapshots/`,截图仍在 `docs/screenshots/`。
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 263 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 273 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 11 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 51 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 403 KiB |
@@ -1,32 +0,0 @@
|
||||
schema: spec-driven
|
||||
|
||||
# Project context (optional)
|
||||
# This is shown to AI when creating artifacts.
|
||||
# Add your tech stack, conventions, style guides, domain knowledge, etc.
|
||||
# Example:
|
||||
# context: |
|
||||
# Tech stack: TypeScript, React, Node.js
|
||||
# We use conventional commits
|
||||
# Domain: e-commerce platform
|
||||
|
||||
# Per-artifact rules (optional)
|
||||
# Add custom rules for specific artifacts.
|
||||
# Example:
|
||||
# rules:
|
||||
# proposal:
|
||||
# - Keep proposals under 500 words
|
||||
# - Always include a "Non-goals" section
|
||||
# tasks:
|
||||
# - Break tasks into chunks of max 2 hours
|
||||
|
||||
# Per-operation guidance (optional)
|
||||
# Add advisory guidance for how apply and archive work should be conducted.
|
||||
# This is separate from artifact rules above.
|
||||
# Example:
|
||||
# operations:
|
||||
# apply:
|
||||
# guidance:
|
||||
# - Keep test summaries concise
|
||||
# archive:
|
||||
# guidance:
|
||||
# - Summarize the archive outcome before finishing
|
||||
Generated
-502
@@ -1,502 +0,0 @@
|
||||
{
|
||||
"name": "yun-xue-tang-assistant",
|
||||
"version": "2.7.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "yun-xue-tang-assistant",
|
||||
"version": "2.7.0",
|
||||
"devDependencies": {
|
||||
"esbuild": "^0.28.2"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/aix-ppc64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
|
||||
"integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
|
||||
"cpu": [
|
||||
"ppc64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"aix"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-arm": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
|
||||
"integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/darwin-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/darwin-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/freebsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/freebsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-arm": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
|
||||
"integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-ia32": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
|
||||
"integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
|
||||
"cpu": [
|
||||
"ia32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-loong64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
|
||||
"integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
|
||||
"cpu": [
|
||||
"loong64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-mips64el": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
|
||||
"integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
|
||||
"cpu": [
|
||||
"mips64el"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-ppc64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
|
||||
"integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
|
||||
"cpu": [
|
||||
"ppc64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-riscv64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
|
||||
"integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
|
||||
"cpu": [
|
||||
"riscv64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-s390x": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
|
||||
"integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
|
||||
"cpu": [
|
||||
"s390x"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/netbsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"netbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/netbsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"netbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openbsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openbsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openharmony-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openharmony"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/sunos-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"sunos"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-ia32": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
|
||||
"integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
|
||||
"cpu": [
|
||||
"ia32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/esbuild": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/esbuild/-/esbuild-0.28.2.tgz",
|
||||
"integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
|
||||
"dev": true,
|
||||
"hasInstallScript": true,
|
||||
"license": "MIT",
|
||||
"bin": {
|
||||
"esbuild": "bin/esbuild"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@esbuild/aix-ppc64": "0.28.2",
|
||||
"@esbuild/android-arm": "0.28.2",
|
||||
"@esbuild/android-arm64": "0.28.2",
|
||||
"@esbuild/android-x64": "0.28.2",
|
||||
"@esbuild/darwin-arm64": "0.28.2",
|
||||
"@esbuild/darwin-x64": "0.28.2",
|
||||
"@esbuild/freebsd-arm64": "0.28.2",
|
||||
"@esbuild/freebsd-x64": "0.28.2",
|
||||
"@esbuild/linux-arm": "0.28.2",
|
||||
"@esbuild/linux-arm64": "0.28.2",
|
||||
"@esbuild/linux-ia32": "0.28.2",
|
||||
"@esbuild/linux-loong64": "0.28.2",
|
||||
"@esbuild/linux-mips64el": "0.28.2",
|
||||
"@esbuild/linux-ppc64": "0.28.2",
|
||||
"@esbuild/linux-riscv64": "0.28.2",
|
||||
"@esbuild/linux-s390x": "0.28.2",
|
||||
"@esbuild/linux-x64": "0.28.2",
|
||||
"@esbuild/netbsd-arm64": "0.28.2",
|
||||
"@esbuild/netbsd-x64": "0.28.2",
|
||||
"@esbuild/openbsd-arm64": "0.28.2",
|
||||
"@esbuild/openbsd-x64": "0.28.2",
|
||||
"@esbuild/openharmony-arm64": "0.28.2",
|
||||
"@esbuild/sunos-x64": "0.28.2",
|
||||
"@esbuild/win32-arm64": "0.28.2",
|
||||
"@esbuild/win32-ia32": "0.28.2",
|
||||
"@esbuild/win32-x64": "0.28.2"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,32 +0,0 @@
|
||||
{
|
||||
"name": "yun-xue-tang-assistant",
|
||||
"version": "2.8.0",
|
||||
"private": true,
|
||||
"description": "云学堂(*.yunxuetang.cn)Tampermonkey 助手:自动登录、顺序听课、自动切节、批量刷课",
|
||||
"scripts": {
|
||||
"build": "node scripts/build.mjs",
|
||||
"build:watch": "node scripts/build.mjs --watch",
|
||||
"dev": "node dev/serve.mjs",
|
||||
"check": "node scripts/check.mjs",
|
||||
"test:real": "node dev/tests/real-test.mjs",
|
||||
"test:real:headless": "node dev/tests/real-test.mjs --headless",
|
||||
"test:e2e": "node dev/tests/real-e2e.mjs",
|
||||
"test:e2e:play": "node dev/tests/real-e2e.mjs --play",
|
||||
"test:tui": "node dev/tests/tui-test.mjs",
|
||||
"test:study": "node dev/tests/study-test.mjs",
|
||||
"test:points": "node dev/tests/points-test.mjs",
|
||||
"test:points-platform": "node dev/tests/points-platform-test.mjs",
|
||||
"test:notify": "node dev/tests/notify-test.mjs",
|
||||
"test:exam": "node dev/tests/exam-test.mjs",
|
||||
"docker:build": "node scripts/build-docker.mjs",
|
||||
"docker:check": "node scripts/build-docker.mjs --check",
|
||||
"headless": "node runner/headless.mjs",
|
||||
"headless:check": "node runner/headless.mjs --check"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"devDependencies": {
|
||||
"esbuild": "^0.28.2"
|
||||
}
|
||||
}
|
||||
@@ -1,278 +0,0 @@
|
||||
// 浏览器探测与启动:Linux 无图形化服务器(含 root / 容器)与 Windows 无人值守都适配。
|
||||
//
|
||||
// 关键点:
|
||||
// - 无显示环境下必须 --headless=new(或回退 --headless),否则 Chrome 起不来;
|
||||
// - 以 root 运行时 Chromium 拒绝启动,必须 --no-sandbox;
|
||||
// - 容器里 /dev/shm 通常只有 64MB,必须 --disable-dev-shm-usage,否则标签页会崩;
|
||||
// - 服务器上没有 GPU/音频设备,关闭相关初始化可减少噪声与卡顿;
|
||||
// - user-data-dir 固定到可配置目录(持久化 cookie),并清理上次被强杀留下的残局:
|
||||
// Linux 的 SingletonLock 符号链接、Windows 的 lockfile,以及两个平台上
|
||||
// 「被任务管理器/ kill -9 杀掉后留下来占着端口的孤儿浏览器进程」。
|
||||
//
|
||||
// 平台相关的判断(有无图形会话、沙箱参数、进程树怎么收)全部在 platform.mjs,
|
||||
// 这里只负责「探测路径 + 拼参数 + 启动 + 等端口就绪」。
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { httpJson, sleep } from './cdp.mjs';
|
||||
import {
|
||||
isWindows, isLinux, isRunningAsRoot, safetyArgs, killTree, killProfileOrphans,
|
||||
} from './platform.mjs';
|
||||
|
||||
// 由本模块统一再导出,老的调用方(dev/tests/real-cdp.mjs 等)不用改
|
||||
// (hasDisplay / safetyArgs 只在这里转发,本模块内部不直接用)
|
||||
export {
|
||||
hasDisplay, safetyArgs, isRunningAsRoot, platformName, noDisplayReason,
|
||||
} from './platform.mjs';
|
||||
|
||||
// 各平台常见的 Chrome / Chromium 安装位置(按优先级)
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME_BIN,
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
// Linux(发行版包管理器)
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/google-chrome-stable',
|
||||
'/usr/bin/chromium',
|
||||
'/usr/bin/chromium-browser',
|
||||
'/snap/bin/chromium',
|
||||
'/opt/google/chrome/chrome',
|
||||
// 常见容器镜像(playwright / puppeteer 预装)
|
||||
'/root/.cache/ms-playwright/chromium-latest-linux/chrome-linux/chrome',
|
||||
'/ms-playwright/chromium-*/chrome-linux/chrome',
|
||||
'/usr/lib/chromium/chromium',
|
||||
'/usr/lib/chromium-browser/chromium-browser',
|
||||
// Windows:Chrome / Edge / Chromium 的常见安装位置(含按用户安装的 LOCALAPPDATA)
|
||||
process.env.LOCALAPPDATA && path.join(process.env.LOCALAPPDATA, 'Google/Chrome/Application/chrome.exe'),
|
||||
process.env.LOCALAPPDATA && path.join(process.env.LOCALAPPDATA, 'Chromium/Application/chrome.exe'),
|
||||
process.env.PROGRAMFILES && path.join(process.env.PROGRAMFILES, 'Google/Chrome/Application/chrome.exe'),
|
||||
process.env['PROGRAMFILES(X86)'] && path.join(process.env['PROGRAMFILES(X86)'], 'Google/Chrome/Application/chrome.exe'),
|
||||
process.env.PROGRAMFILES && path.join(process.env.PROGRAMFILES, 'Microsoft/Edge/Application/msedge.exe'),
|
||||
process.env['PROGRAMFILES(X86)'] && path.join(process.env['PROGRAMFILES(X86)'], 'Microsoft/Edge/Application/msedge.exe'),
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
|
||||
// macOS
|
||||
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
|
||||
'/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
|
||||
'/Applications/Chromium.app/Contents/MacOS/Chromium',
|
||||
].filter(Boolean);
|
||||
|
||||
// 运行时的可执行名(Windows 上文件名带 .exe,Linux 上可执行名不带扩展名)
|
||||
const EXE_RE = /(^|[\/])(chrome|chromium|msedge)(\.exe)?$/i;
|
||||
|
||||
function isFile(p) {
|
||||
try { return fs.statSync(p).isFile(); } catch (e) { return false; }
|
||||
}
|
||||
|
||||
// 通配符路径(例如 playwright 缓存目录带哈希后缀)逐个展开
|
||||
function expandGlob(patterns) {
|
||||
const out = [];
|
||||
const seen = new Set();
|
||||
const walk = function (dir, depth) {
|
||||
if (depth > 6) return;
|
||||
let entries;
|
||||
try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch (e) { return; }
|
||||
for (const en of entries) {
|
||||
const full = path.join(dir, en.name);
|
||||
if (en.isFile() && EXE_RE.test(full) && isFile(full)) {
|
||||
if (!seen.has(full)) { seen.add(full); out.push(full); }
|
||||
} else if (en.isDirectory()) {
|
||||
walk(full, depth + 1);
|
||||
}
|
||||
}
|
||||
};
|
||||
for (const p of patterns) {
|
||||
if (p.indexOf('*') < 0) continue;
|
||||
const base = p.slice(0, p.indexOf('*'));
|
||||
walk(base.endsWith('/') ? base : base.slice(0, base.lastIndexOf('/') + 1), 0);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
export function resolveBrowser() {
|
||||
const globbed = expandGlob(CANDIDATES);
|
||||
const all = CANDIDATES.concat(globbed);
|
||||
for (const p of all) {
|
||||
if (p && p.indexOf('*') < 0 && isFile(p)) return p;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function listCandidatePaths() {
|
||||
return CANDIDATES.concat(expandGlob(CANDIDATES));
|
||||
}
|
||||
|
||||
// 上次进程被强杀(kill -9 / 任务管理器「结束任务」)时,profile 目录会留下锁文件,
|
||||
// Chrome 可能因此拒绝启动或一直弹「配置文件正在使用中」。
|
||||
//
|
||||
// 两套锁的名字不同:
|
||||
// POSIX SingletonLock / SingletonSocket / SingletonCookie,lock 是指向 hostname-pid 的符号链接,
|
||||
// 目标 hostname-pid:主机名不是本机 → 一定是陈旧锁(容器重建后 hostname 会变,
|
||||
// 而旧 pid 在新容器里常被别的进程复用);主机名相同且 pid 不存在 → 陈旧;
|
||||
// pid 还活着才说明真有浏览器在跑,不能动。
|
||||
// Windows 用普通的空文件 lockfile;Windows 上没法从文件反查 pid,
|
||||
// 所以由调用方先用 killProfileOrphans() 把残留进程收掉,再清文件。
|
||||
export function cleanStaleSingleton(profileDir) {
|
||||
const names = isWindows
|
||||
? ['lockfile', 'SingletonLock', 'SingletonSocket', 'SingletonCookie']
|
||||
: ['SingletonLock', 'SingletonSocket', 'SingletonCookie'];
|
||||
|
||||
for (const name of names) {
|
||||
const p = path.join(profileDir, name);
|
||||
let st;
|
||||
try { st = fs.lstatSync(p); } catch (e) { continue; }
|
||||
try {
|
||||
if (st.isSymbolicLink()) {
|
||||
const target = fs.readlinkSync(p);
|
||||
const m = /^(.*)-(\d+)$/.exec(target);
|
||||
const host = m ? m[1] : '';
|
||||
const pid = m ? Number(m[2]) : 0;
|
||||
// 锁里的主机名不是本机:上一个容器 / 另一台机器留下的残局。
|
||||
// 容器重建后 hostname 变了,而旧 pid(如 19)在新容器里常常恰好被占用,
|
||||
// 只看 pid 存活会误判成「浏览器还在跑」,导致锁永远清不掉。
|
||||
const foreign = host !== '' && host !== os.hostname();
|
||||
let alive = false;
|
||||
if (!foreign && pid > 0) {
|
||||
try { process.kill(pid, 0); alive = true; } catch (e) { alive = false; }
|
||||
}
|
||||
if (alive) continue; // 真的是本机上活着的浏览器,别动
|
||||
fs.unlinkSync(p);
|
||||
} else {
|
||||
fs.unlinkSync(p);
|
||||
}
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
|
||||
export function buildArgs({
|
||||
profileDir, port, headless, noSandbox, windowSize = '1360,940', extraArgs = [],
|
||||
}) {
|
||||
const args = [
|
||||
`--remote-debugging-port=${port}`,
|
||||
`--remote-debugging-address=127.0.0.1`,
|
||||
`--user-data-dir=${profileDir}`,
|
||||
'--no-first-run',
|
||||
'--no-default-browser-check',
|
||||
'--disable-sync',
|
||||
'--disable-background-networking',
|
||||
'--disable-component-update',
|
||||
'--disable-features=Translate,MediaRouter,OptimizationHints',
|
||||
// 后台标签页/最小化时不要把定时器与视频节流,否则「持续听课」测不准
|
||||
'--disable-background-timer-throttling',
|
||||
'--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
// 无人值守必须自己能起播,不能等用户手势
|
||||
'--autoplay-policy=no-user-gesture-required',
|
||||
'--mute-audio',
|
||||
// 服务器 / 无人值守机器上没有可用的 GPU 加速,关掉能少一类崩溃与噪声
|
||||
'--disable-gpu',
|
||||
'--window-size=' + windowSize,
|
||||
];
|
||||
|
||||
// 下面这些都是 POSIX 概念,Windows 上不认(加了也无害,但没必要)
|
||||
if (!isWindows) {
|
||||
args.push(
|
||||
// 容器里 /dev/shm 通常只有 64MB,不加会随机崩标签页
|
||||
'--disable-dev-shm-usage',
|
||||
// 部分发行版 / 容器里 zygote 起不来
|
||||
'--no-zygote',
|
||||
);
|
||||
}
|
||||
|
||||
if (noSandbox && (isLinux || isRunningAsRoot())) {
|
||||
// Linux 服务器常见两种情况都需要它:以 root 运行、容器内 namespace 受限
|
||||
args.push('--no-sandbox', '--disable-setuid-sandbox');
|
||||
}
|
||||
|
||||
// 本平台额外需要的稳定性参数(Windows:不弹崩溃恢复气泡,免得无人值守时卡在等点击)
|
||||
args.push(...safetyArgs());
|
||||
|
||||
if (headless) args.push('--headless=new', '--hide-scrollbars');
|
||||
// 去重:上面手写的 Linux 参数和 safetyArgs() 有重叠,同一个开关重复传给 Chrome 没意义
|
||||
// (但 --disable-features 这类「后面的覆盖前面的」要注意,所以按首次出现保留并合并)
|
||||
return [...new Set(args)].concat(extraArgs, ['about:blank']);
|
||||
}
|
||||
|
||||
// 启动浏览器并等 CDP 端口就绪。失败时回退到老的无头开关(老版本 Chromium 不认 --headless=new)。
|
||||
export async function launchBrowser(opts) {
|
||||
const {
|
||||
binary, profileDir, port, headless = true, noSandbox = true,
|
||||
extraArgs = [], timeoutMs = 45000, log = () => {},
|
||||
} = opts;
|
||||
|
||||
fs.mkdirSync(profileDir, { recursive: true });
|
||||
// 先收残留进程(被强杀后留下的孤儿会一直占着 CDP 端口),再清锁文件
|
||||
const orphans = await killProfileOrphans(profileDir, { log });
|
||||
if (orphans) log('[浏览器] 已清理 ' + orphans + ' 个残留浏览器进程');
|
||||
cleanStaleSingleton(profileDir);
|
||||
|
||||
// headless=true 先试 --headless=new,起不来再试 --headless
|
||||
const modes = headless ? [true, 'old'] : [false];
|
||||
|
||||
let lastErr = null;
|
||||
for (const mode of modes) {
|
||||
const isNew = mode === true || mode === 'old';
|
||||
let args = buildArgs({
|
||||
profileDir, port, headless: isNew, noSandbox, extraArgs,
|
||||
});
|
||||
if (mode === 'old') {
|
||||
args = args.map((a) => (a === '--headless=new' ? '--headless' : a));
|
||||
}
|
||||
log('[浏览器] 启动:' + binary + ' ' + (isNew ? (mode === 'old' ? '(headless 旧模式)' : '(headless=new)') : '(有界面)'));
|
||||
|
||||
// windowsHide:Windows 上不加会闪一个黑色控制台窗口,无人值守时必须隐藏
|
||||
const child = spawn(binary, args, { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
|
||||
let stderrTail = '';
|
||||
child.stderr.on('data', (b) => { stderrTail = (stderrTail + String(b)).slice(-4000); });
|
||||
child.stdout.on('data', () => {});
|
||||
let exited = false;
|
||||
child.on('exit', (code, signal) => {
|
||||
exited = true;
|
||||
if (code !== 0 && code !== null) log('[浏览器] 进程退出 code=' + code + ' signal=' + signal);
|
||||
});
|
||||
|
||||
const started = Date.now();
|
||||
let version = null;
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
if (exited) break;
|
||||
try {
|
||||
const v = await httpJson(`http://127.0.0.1:${port}/json/version`);
|
||||
if (v && v.webSocketDebuggerUrl) { version = v; break; }
|
||||
} catch (e) { /* 还没起来 */ }
|
||||
await sleep(300);
|
||||
}
|
||||
|
||||
if (version) {
|
||||
return {
|
||||
child, version, args,
|
||||
headless: isNew,
|
||||
kill: function () {
|
||||
// 跨平台收进程树(Windows 走 TerminateProcess + taskkill /T,POSIX 走 SIGTERM→SIGKILL)
|
||||
return killTree(child, { log });
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
await killTree(child, { log, timeoutMs: 3000 });
|
||||
await sleep(500);
|
||||
lastErr = new Error('CDP 端口未就绪(' + port + ')');
|
||||
if (stderrTail.trim()) {
|
||||
lastErr.message += '\n浏览器 stderr(尾部):\n' + stderrTail.trim().split('\n').slice(-12).join('\n');
|
||||
}
|
||||
// 只有 headless 才需要回退,非 headless 直接报错
|
||||
if (!headless) break;
|
||||
}
|
||||
throw lastErr || new Error('浏览器启动失败');
|
||||
}
|
||||
|
||||
// 建议的持久化 profile 目录:默认放项目内的 .run-profile(可用 YUN_XUE_TANG_PROFILE_DIR 覆盖)
|
||||
export function defaultProfileDir(root) {
|
||||
if (process.env.YUN_XUE_TANG_PROFILE_DIR) return path.resolve(process.env.YUN_XUE_TANG_PROFILE_DIR);
|
||||
return path.join(root, '.run-profile');
|
||||
}
|
||||
|
||||
export function tmpProfileDir(prefix = 'yun-xue-tang-headless-') {
|
||||
return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
|
||||
}
|
||||
@@ -1,87 +0,0 @@
|
||||
// 极简 CDP 客户端:Node 22+ 原生 WebSocket,无需 puppeteer / playwright。
|
||||
// 与 dev/tests/real-cdp.mjs 同一套思路,额外提供「连接断开回调」与事件订阅失败隔离,
|
||||
// 供无人值守的 runner/headless.mjs 在断线时判断是否需要重建浏览器。
|
||||
export async function connect(wsUrl, opts = {}) {
|
||||
const ws = new WebSocket(wsUrl);
|
||||
await new Promise(function (res, rej) {
|
||||
ws.addEventListener('open', res, { once: true });
|
||||
ws.addEventListener('error', rej, { once: true });
|
||||
});
|
||||
|
||||
let id = 0;
|
||||
const pending = new Map();
|
||||
const events = [];
|
||||
const waiters = [];
|
||||
const listeners = [];
|
||||
const state = { closed: false };
|
||||
|
||||
ws.addEventListener('close', function () {
|
||||
state.closed = true;
|
||||
// 断线后所有未完成的调用直接拒绝,避免 runner 卡死在 await 上
|
||||
for (const [, p] of pending) {
|
||||
try { p.rej(new Error('CDP 连接已断开')); } catch (e) { /* ignore */ }
|
||||
}
|
||||
pending.clear();
|
||||
if (typeof opts.onClose === 'function') {
|
||||
try { opts.onClose(); } catch (e) { /* ignore */ }
|
||||
}
|
||||
});
|
||||
|
||||
ws.addEventListener('message', function (ev) {
|
||||
const msg = JSON.parse(ev.data);
|
||||
if (msg.id != null && pending.has(msg.id)) {
|
||||
const { res, rej } = pending.get(msg.id);
|
||||
pending.delete(msg.id);
|
||||
if (msg.error) rej(new Error(msg.error.message));
|
||||
else res(msg.result);
|
||||
return;
|
||||
}
|
||||
events.push(msg);
|
||||
for (const fn of listeners) {
|
||||
try { fn(msg); } catch (e) { /* 忽略订阅者异常 */ }
|
||||
}
|
||||
for (let i = waiters.length - 1; i >= 0; i--) {
|
||||
if (waiters[i].match(msg)) waiters.splice(i, 1)[0].res(msg);
|
||||
}
|
||||
});
|
||||
|
||||
const send = function (method, params = {}) {
|
||||
return new Promise(function (res, rej) {
|
||||
if (state.closed) { rej(new Error('CDP 连接已断开')); return; }
|
||||
const mid = ++id;
|
||||
pending.set(mid, { res, rej });
|
||||
try {
|
||||
ws.send(JSON.stringify({ id: mid, method, params }));
|
||||
} catch (e) {
|
||||
pending.delete(mid);
|
||||
rej(e);
|
||||
}
|
||||
});
|
||||
};
|
||||
|
||||
const waitEvent = function (name, timeoutMs = 30000) {
|
||||
return new Promise(function (res, rej) {
|
||||
const timer = setTimeout(function () { rej(new Error('等待事件超时: ' + name)); }, timeoutMs);
|
||||
waiters.push({
|
||||
match: (m) => m.method === name,
|
||||
res: (m) => { clearTimeout(timer); res(m.params); },
|
||||
});
|
||||
});
|
||||
};
|
||||
|
||||
const onEvent = function (fn) { listeners.push(fn); };
|
||||
|
||||
return {
|
||||
ws, send, waitEvent, onEvent, events,
|
||||
get closed() { return state.closed; },
|
||||
close: function () { try { ws.close(); } catch (e) { /* ignore */ } },
|
||||
};
|
||||
}
|
||||
|
||||
export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
||||
|
||||
export async function httpJson(url, method = 'GET') {
|
||||
const r = await fetch(url, { method });
|
||||
const t = await r.text();
|
||||
try { return JSON.parse(t); } catch (e) { return t; }
|
||||
}
|
||||
@@ -1,412 +0,0 @@
|
||||
// 运行参数与路径:配置文件 / 环境变量 / 命令行在这里集中解析,其它模块只读导出的常量。
|
||||
//
|
||||
// 优先级(后者覆盖前者):
|
||||
// 内置默认值 < runner.config.mjs < 环境变量 YUN_XUE_TANG_* < 命令行参数 --x
|
||||
//
|
||||
// 配置文件是 JS 模块(见仓库根目录的 runner.config.mjs),可以写注释和表达式。
|
||||
// 账号密码不在配置文件里,只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,
|
||||
// 避免凭据进入版本库、进程列表和计划任务历史。
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { fileURLToPath, pathToFileURL } from 'node:url';
|
||||
import { defaultProfileDir } from './browser.mjs';
|
||||
import { hasDisplay, noDisplayReason, platformName } from './platform.mjs';
|
||||
|
||||
export { platformName, noDisplayReason };
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
export const ROOT = path.resolve(HERE, '..');
|
||||
/** 构建产物(注入页面的单文件脚本) */
|
||||
export const SCRIPT_FILE = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 一层:内置默认值
|
||||
// ---------------------------------------------------------------------------
|
||||
const DEFAULTS = {
|
||||
budgetMinutes: 0, // 0 = 不限
|
||||
preferShort: true,
|
||||
pointsMode: true, // 每日积分模式:整门课完成计 1 次,四类封顶后停止(文档1/视频3/音频2/微课2)
|
||||
restartMinutes: 0, // 0 = 停下就退出
|
||||
idleRestartMinutes: 30,
|
||||
origin: 'https://kfmic.yunxuetang.cn',
|
||||
url: '', // 留空 = <origin>/login.html
|
||||
port: 9336,
|
||||
headless: true,
|
||||
chrome: '',
|
||||
extraArgs: '',
|
||||
profile: '', // 留空 = ./.run-profile
|
||||
logFile: '', // 留空 = ./run-logs/headless.log
|
||||
logMaxBytes: 5 * 1024 * 1024,
|
||||
tui: true, // true = 交互式终端里启用面板;非 TTY 自动退化为逐行日志
|
||||
color: true, // false = 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||||
// Bark 推送:运行器在开始运行、每门课获得学分、收尾时各发一条手机通知。
|
||||
// barkUrl 是含设备 key 的地址(https://api.day.app/<key>),留空 = 不推送。
|
||||
// key 等价于「谁能往你手机推通知」,别提交到公开仓库;可用环境变量覆盖。
|
||||
barkUrl: '',
|
||||
barkGroup: '', // 通知分组(Bark App 里按组折叠),留空 = Bark 默认
|
||||
barkTtl: 0, // 通知在 Bark 服务端保留多少秒;0 = 永久保留
|
||||
};
|
||||
|
||||
const argv = process.argv.slice(2);
|
||||
|
||||
// 已废弃 / 旧版参数别名:老脚本里的写法继续可用,不报错
|
||||
const DEPRECATED = {
|
||||
'--visible': '已废弃:等价于设置 headless: false(或 --headless 0),本版本仍然可用',
|
||||
};
|
||||
/** 旧参数名 -> 配置字段(保持向后兼容,dev/tests/ 下的脚本还在用) */
|
||||
const ALIASES = {
|
||||
'--budget': 'budgetMinutes',
|
||||
'--restart': 'restartMinutes',
|
||||
'--idle': 'idleRestartMinutes',
|
||||
'--log': 'logFile',
|
||||
'--log-max': 'logMaxBytes',
|
||||
};
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 两层:读配置文件(JS 模块)
|
||||
// ---------------------------------------------------------------------------
|
||||
/** 配置文件路径:命令行 --config > 环境变量 YUN_XUE_TANG_CONFIG > config/runner.config.mjs */
|
||||
function configPath() {
|
||||
const i = argv.indexOf('--config');
|
||||
if (i >= 0 && argv[i + 1]) return path.resolve(argv[i + 1]);
|
||||
if (process.env.YUN_XUE_TANG_CONFIG) return path.resolve(process.env.YUN_XUE_TANG_CONFIG);
|
||||
const def = path.join(ROOT, 'config/runner.config.mjs');
|
||||
return fs.existsSync(def) ? def : '';
|
||||
}
|
||||
|
||||
export const CONFIG_FILE = configPath();
|
||||
const CONFIG_KNOWN = new Set([...Object.keys(DEFAULTS), 'username', 'password', 'check']);
|
||||
|
||||
let fileConfig = {};
|
||||
const configWarnings = [];
|
||||
if (CONFIG_FILE) {
|
||||
try {
|
||||
const mod = await import(pathToFileURL(CONFIG_FILE).href + '?t=' + Date.now());
|
||||
const raw = mod.default;
|
||||
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
|
||||
throw new Error('默认导出必须是一个对象:export default { ... }');
|
||||
}
|
||||
for (const [k, v] of Object.entries(raw)) {
|
||||
if (!CONFIG_KNOWN.has(k)) configWarnings.push('配置文件里有未知字段「' + k + '」,已忽略');
|
||||
else if (v !== undefined) fileConfig[k] = v;
|
||||
}
|
||||
// 配置里写了账号:不采纳,只提示一次,避免有人以为这样能生效
|
||||
if (fileConfig.username !== undefined || fileConfig.password !== undefined) {
|
||||
configWarnings.push('配置文件里的 username / password 已忽略:凭据只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD');
|
||||
}
|
||||
} catch (e) {
|
||||
const explicit = argv.includes('--config') || !!process.env.YUN_XUE_TANG_CONFIG;
|
||||
const msg = e && e.code === 'ERR_MODULE_NOT_FOUND'
|
||||
? (explicit ? '指定的配置文件不存在' : '配置文件导入失败')
|
||||
: '配置文件内容有误';
|
||||
console.error(msg + ':' + CONFIG_FILE + '\n ' + (e && e.message ? e.message.split('\n')[0] : e));
|
||||
process.exit(2);
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 命令行解析:--key value / --key=value / --flag
|
||||
// ---------------------------------------------------------------------------
|
||||
const BOOL_KEYS = ['preferShort', 'pointsMode', 'headless', 'check', 'tui', 'color'];
|
||||
const NUM_KEYS = ['budgetMinutes', 'restartMinutes', 'idleRestartMinutes', 'port', 'logMaxBytes', 'barkTtl'];
|
||||
const STR_KEYS = ['origin', 'url', 'profile', 'logFile', 'chrome', 'extraArgs', 'config', 'barkUrl', 'barkGroup'];
|
||||
|
||||
/** kebab-case → camelCase:--budget-minutes → budgetMinutes */
|
||||
function toCamel(flag) {
|
||||
return flag.replace(/^--/, '').replace(/-([a-z])/g, (m, c) => c.toUpperCase());
|
||||
}
|
||||
const camelToFlag = (k) => '--' + k.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase());
|
||||
|
||||
function parseBool(v, raw) {
|
||||
const s = String(v).trim().toLowerCase();
|
||||
if (['1', 'true', 'yes', 'on', 'y'].includes(s)) return true;
|
||||
if (['0', 'false', 'no', 'off', 'n'].includes(s)) return false;
|
||||
console.error('参数值不是布尔值:' + raw + '(可用 1/0、true/false、on/off)');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
const cliRaw = {};
|
||||
const unknownFlags = [];
|
||||
const missingValues = [];
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const a = argv[i];
|
||||
if (!a.startsWith('--')) {
|
||||
unknownFlags.push(a);
|
||||
continue;
|
||||
}
|
||||
const eq = a.indexOf('=');
|
||||
let name;
|
||||
let inline;
|
||||
if (eq > 0) {
|
||||
name = a.slice(0, eq);
|
||||
inline = a.slice(eq + 1);
|
||||
} else {
|
||||
name = a;
|
||||
}
|
||||
if (DEPRECATED[name]) configWarnings.push(DEPRECATED[name]);
|
||||
let key = toCamel(name);
|
||||
if (ALIASES[name]) key = ALIASES[name];
|
||||
if (name === '--visible') key = 'headless'; // --visible = headless false
|
||||
if (name === '--no-tui') key = 'tui'; // --no-tui = tui false
|
||||
if (name === '--no-color') key = 'color'; // --no-color = color false
|
||||
if (name === '--help' || name === '-h') key = 'help';
|
||||
if (name === '--check') key = 'check';
|
||||
const known = CONFIG_KNOWN.has(key) || key === 'help' || key === 'config';
|
||||
if (!known) {
|
||||
unknownFlags.push(name);
|
||||
// 把未知参数的值一并吞掉,否则它会被当成一个独立的多余位置参数一起报
|
||||
if (inline === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) i++;
|
||||
continue;
|
||||
}
|
||||
if (!BOOL_KEYS.includes(key) && !NUM_KEYS.includes(key) && !STR_KEYS.includes(key) && key !== 'help' && key !== 'config') {
|
||||
unknownFlags.push(name);
|
||||
if (inline === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) i++;
|
||||
continue;
|
||||
}
|
||||
// 布尔量可以不带值(--check 等于 --check 1);数值和字符串必须带值
|
||||
let val;
|
||||
if (inline !== undefined) val = inline;
|
||||
else if (BOOL_KEYS.includes(key) && (argv[i + 1] === undefined || argv[i + 1].startsWith('--'))) val = '1';
|
||||
else if (argv[i + 1] !== undefined && !argv[i + 1].startsWith('--')) val = argv[++i];
|
||||
else {
|
||||
missingValues.push(name);
|
||||
continue;
|
||||
}
|
||||
if (name === '--visible') val = String(parseBool(val, name) ? 0 : 1); // --visible 0 → headless 1
|
||||
if (name === '--no-tui' || name === '--no-color') val = String(parseBool(val, name) ? 0 : 1);
|
||||
cliRaw[key] = val;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 三层:环境变量
|
||||
// ---------------------------------------------------------------------------
|
||||
const envNum = (name, cur) => {
|
||||
const v = process.env[name];
|
||||
if (v === undefined || v === '') return cur;
|
||||
const n = Number(v);
|
||||
if (!Number.isFinite(n)) {
|
||||
configWarnings.push(name + ' 不是数字,已忽略:' + v);
|
||||
return cur;
|
||||
}
|
||||
return n;
|
||||
};
|
||||
const envBool = (name, cur) => {
|
||||
const v = process.env[name];
|
||||
if (v === undefined || v === '') return cur;
|
||||
return !/^(0|false|no|off)$/i.test(v);
|
||||
};
|
||||
const envStr = (name, cur) => {
|
||||
const v = process.env[name];
|
||||
return v === undefined || v === '' ? cur : v;
|
||||
};
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 合并:defaults < 配置文件 < 环境变量 < 命令行
|
||||
// ---------------------------------------------------------------------------
|
||||
const merged = { ...DEFAULTS, ...fileConfig };
|
||||
|
||||
merged.budgetMinutes = envNum('YUN_XUE_TANG_BUDGET_MINUTES', merged.budgetMinutes);
|
||||
merged.restartMinutes = envNum('YUN_XUE_TANG_RESTART_MINUTES', merged.restartMinutes);
|
||||
merged.idleRestartMinutes = envNum('YUN_XUE_TANG_IDLE_RESTART_MINUTES', merged.idleRestartMinutes);
|
||||
merged.port = envNum('YUN_XUE_TANG_CDP_PORT', merged.port);
|
||||
merged.logMaxBytes = envNum('YUN_XUE_TANG_LOG_MAX_BYTES', merged.logMaxBytes);
|
||||
merged.preferShort = envBool('YUN_XUE_TANG_PREFER_SHORT', merged.preferShort);
|
||||
merged.pointsMode = envBool('YUN_XUE_TANG_POINTS_MODE', merged.pointsMode);
|
||||
merged.headless = envBool('YUN_XUE_TANG_HEADLESS', merged.headless);
|
||||
merged.origin = envStr('YUN_XUE_TANG_ORIGIN', merged.origin);
|
||||
merged.url = envStr('YUN_XUE_TANG_URL', merged.url);
|
||||
merged.logFile = envStr('YUN_XUE_TANG_LOG_FILE', merged.logFile);
|
||||
merged.profile = envStr('YUN_XUE_TANG_PROFILE_DIR', merged.profile);
|
||||
merged.chrome = envStr('YUN_XUE_TANG_CHROME_BIN', merged.chrome);
|
||||
merged.extraArgs = envStr('YUN_XUE_TANG_EXTRA_ARGS', merged.extraArgs);
|
||||
merged.tui = envBool('YUN_XUE_TANG_TUI', merged.tui);
|
||||
merged.color = envBool('YUN_XUE_TANG_COLOR', merged.color);
|
||||
merged.barkTtl = envNum('YUN_XUE_TANG_BARK_TTL', merged.barkTtl);
|
||||
merged.barkUrl = envStr('YUN_XUE_TANG_BARK_URL', merged.barkUrl);
|
||||
merged.barkGroup = envStr('YUN_XUE_TANG_BARK_GROUP', merged.barkGroup);
|
||||
|
||||
// 命令行最后覆盖
|
||||
const numBad = [];
|
||||
for (const [key, raw] of Object.entries(cliRaw)) {
|
||||
if (key === 'help' || key === 'config') continue;
|
||||
if (key === 'check') { merged.check = parseBool(raw, '--check'); continue; }
|
||||
if (BOOL_KEYS.includes(key)) { merged[key] = parseBool(raw, camelToFlag(key)); continue; }
|
||||
if (NUM_KEYS.includes(key)) {
|
||||
const n = Number(raw);
|
||||
if (!Number.isFinite(n)) numBad.push(camelToFlag(key) + ' 需要数字,收到「' + raw + '」');
|
||||
else merged[key] = n;
|
||||
continue;
|
||||
}
|
||||
merged[key] = raw;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 校验
|
||||
// ---------------------------------------------------------------------------
|
||||
const problems = [...numBad];
|
||||
if (numBad.length === 0) {
|
||||
if (!(merged.port >= 1 && merged.port <= 65535)) problems.push('port 必须在 1-65535 之间,收到 ' + merged.port);
|
||||
if (!(merged.budgetMinutes >= 0)) problems.push('budgetMinutes 不能为负,收到 ' + merged.budgetMinutes);
|
||||
if (!(merged.restartMinutes >= 0)) problems.push('restartMinutes 不能为负,收到 ' + merged.restartMinutes);
|
||||
if (!(merged.idleRestartMinutes >= 0)) problems.push('idleRestartMinutes 不能为负,收到 ' + merged.idleRestartMinutes);
|
||||
if (!(merged.logMaxBytes >= 0)) problems.push('logMaxBytes 不能为负,收到 ' + merged.logMaxBytes);
|
||||
if (!(merged.barkTtl >= 0)) problems.push('barkTtl 不能为负,收到 ' + merged.barkTtl);
|
||||
}
|
||||
if (unknownFlags.length) {
|
||||
const uniq = [...new Set(unknownFlags)];
|
||||
problems.push('无法识别的参数:' + uniq.join(' ') + '(用 --help 查看支持的参数)');
|
||||
}
|
||||
if (missingValues.length) {
|
||||
const uniq = [...new Set(missingValues)];
|
||||
problems.push('这些参数缺少值:' + uniq.join(' '));
|
||||
}
|
||||
|
||||
export const HELP = argv.includes('--help') || argv.includes('-h');
|
||||
if (problems.length && !HELP) {
|
||||
console.error('参数有误:');
|
||||
for (const p of problems) console.error(' · ' + p);
|
||||
console.error('\n用 --help 查看支持的参数与配置文件字段。');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 导出(保持原有大写下划线命名,其它模块不用改)
|
||||
// ---------------------------------------------------------------------------
|
||||
export const CHECK_ONLY = !!merged.check;
|
||||
export const ORIGIN = String(merged.origin || DEFAULTS.origin).replace(/\/+$/, '');
|
||||
export const START_URL = merged.url ? String(merged.url) : ORIGIN + '/login.html';
|
||||
export const USR = process.env.YUN_XUE_TANG_USR || '';
|
||||
export const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||||
export const PORT = merged.port;
|
||||
/** 运行多少分钟后收尾(0 = 不限) */
|
||||
export const BUDGET_MINUTES = merged.budgetMinutes;
|
||||
export const PROFILE_DIR = merged.profile
|
||||
? path.resolve(ROOT, merged.profile)
|
||||
: defaultProfileDir(ROOT);
|
||||
|
||||
// 没有图形显示的环境(Linux 无 DISPLAY、Windows 的 Session 0)上开不了有界面浏览器,
|
||||
// 即使配置成有界面也强制无头:否则 Chrome 在 Linux 上报「Missing X server」然后退出,
|
||||
// 在 Windows 服务会话里则是起来就崩。
|
||||
export const WANT_VISIBLE = !merged.headless;
|
||||
export const VISIBLE = WANT_VISIBLE && hasDisplay();
|
||||
|
||||
export const PREFER_SHORT = merged.preferShort;
|
||||
export const POINTS_MODE = merged.pointsMode;
|
||||
/** 脚本自己停下后等待多少分钟再开新一轮(0 = 直接退出) */
|
||||
export const RESTART_MINUTES = merged.restartMinutes;
|
||||
/** 连续多少分钟没有任何进展判定卡死 */
|
||||
export const IDLE_RESTART_MINUTES = merged.idleRestartMinutes;
|
||||
export const LOG_FILE = merged.logFile
|
||||
? path.resolve(ROOT, merged.logFile)
|
||||
: path.join(ROOT, 'run-logs/headless.log');
|
||||
export const LOG_MAX_BYTES = merged.logMaxBytes;
|
||||
export const EXTRA_ARGS = String(merged.extraArgs || '').split(/\s+/).filter(Boolean);
|
||||
/** 配置文件里指定的浏览器路径(空 = 自动探测;优先级低于 YUN_XUE_TANG_CHROME_BIN,见 browser.mjs) */
|
||||
export const CHROME_BIN = merged.chrome || '';
|
||||
/** Bark 推送地址(含设备 key);空 = 不推送 */
|
||||
export const BARK_URL = String(merged.barkUrl || '').trim();
|
||||
export const BARK_GROUP = String(merged.barkGroup || '').trim();
|
||||
export const BARK_TTL = merged.barkTtl;
|
||||
export const WARNINGS = configWarnings;
|
||||
|
||||
/** 打印/展示 Bark 地址时把路径里的第一段(设备 key)打码,避免日志泄露推送权限 */
|
||||
export function maskBarkUrl(url) {
|
||||
const s = String(url || '');
|
||||
if (!s) return '(未配置)';
|
||||
const m = s.match(/^(https?:\/\/[^/]+)(\/.*)?$/i);
|
||||
if (!m) return '(已配置)';
|
||||
return m[1] + (m[2] || '').replace(/^\/([^/?]*)/, '/***');
|
||||
}
|
||||
|
||||
/** 面板是否带颜色:配置 / 环境变量 / 行业惯例的 NO_COLOR 都生效 */
|
||||
export const COLOR = merged.color && !process.env.NO_COLOR;
|
||||
|
||||
/**
|
||||
* 是否启用终端面板(TUI)。
|
||||
* 三个条件都满足才开:配置没关 + stdout 是交互式终端 + 不是自检模式。
|
||||
* 自检要打印 PASS/FAIL 清单,塞进面板的日志区会看不到,所以强制逐行输出。
|
||||
* 重定向到文件、管道、CI、计划任务里 stdout 不是 TTY,会自然退化。
|
||||
*/
|
||||
export const TUI = !!merged.tui && !CHECK_ONLY && !!process.stdout.isTTY;
|
||||
|
||||
/** 面板没开时,给一句人能看懂的原因(日志里只打一次) */
|
||||
export function tuiDisabledReason() {
|
||||
if (TUI) return '';
|
||||
if (CHECK_ONLY) return '自检模式不启用面板(要逐行看 PASS/FAIL)';
|
||||
if (!merged.tui) return '已按配置 / --no-tui 关闭面板';
|
||||
if (!process.stdout.isTTY) return 'stdout 不是交互式终端(重定向 / 管道 / 服务),改用逐行日志';
|
||||
return '环境不支持终端面板,改用逐行日志';
|
||||
}
|
||||
|
||||
/** 一条便于粘贴到 issue / 日志的自述 */
|
||||
export function describeRun() {
|
||||
return {
|
||||
configFile: CONFIG_FILE || '(未找到,使用内置默认值)',
|
||||
platform: platformName,
|
||||
checkOnly: CHECK_ONLY,
|
||||
headless: !VISIBLE,
|
||||
port: PORT,
|
||||
budgetMinutes: BUDGET_MINUTES > 0 ? BUDGET_MINUTES : '不限',
|
||||
preferShort: PREFER_SHORT,
|
||||
pointsMode: POINTS_MODE,
|
||||
restartMinutes: RESTART_MINUTES,
|
||||
idleRestartMinutes: IDLE_RESTART_MINUTES,
|
||||
profileDir: PROFILE_DIR,
|
||||
logFile: LOG_FILE,
|
||||
tui: TUI,
|
||||
color: COLOR,
|
||||
bark: BARK_URL ? (maskBarkUrl(BARK_URL) + (BARK_GROUP ? '(分组 ' + BARK_GROUP + ')' : '')) : '(未配置)',
|
||||
};
|
||||
}
|
||||
|
||||
/** --help 文本:字段、命令行名、环境变量、当前生效值一起列出 */
|
||||
export function helpText() {
|
||||
const rows = [
|
||||
['配置字段', '命令行', '环境变量', '当前生效', '说明'],
|
||||
['budgetMinutes', '--budget-minutes', 'YUN_XUE_TANG_BUDGET_MINUTES', BUDGET_MINUTES, '跑多少分钟后收尾;0 = 不限'],
|
||||
['preferShort', '--prefer-short', 'YUN_XUE_TANG_PREFER_SHORT', PREFER_SHORT, '优先总时长最短的课程'],
|
||||
['pointsMode', '--points-mode', 'YUN_XUE_TANG_POINTS_MODE', POINTS_MODE, '每日积分模式:文档1/视频3/音频2/微课2,封顶即停'],
|
||||
['restartMinutes', '--restart-minutes', 'YUN_XUE_TANG_RESTART_MINUTES', RESTART_MINUTES, '脚本停下后等几分钟开新一轮;0 = 退出'],
|
||||
['idleRestartMinutes', '--idle-restart-minutes', 'YUN_XUE_TANG_IDLE_RESTART_MINUTES', IDLE_RESTART_MINUTES, '多少分钟无进展判卡死'],
|
||||
['origin', '--origin', 'YUN_XUE_TANG_ORIGIN', ORIGIN, '站点根地址'],
|
||||
['url', '--url', 'YUN_XUE_TANG_URL', START_URL, '起始页面;空 = <origin>/login.html'],
|
||||
['port', '--port', 'YUN_XUE_TANG_CDP_PORT', PORT, 'CDP 调试端口'],
|
||||
['headless', '--headless 0|1', 'YUN_XUE_TANG_HEADLESS', !VISIBLE, '1 = 无头,0 = 有界面'],
|
||||
['chrome', '--chrome', 'YUN_XUE_TANG_CHROME_BIN', CHROME_BIN || '(自动探测)', '浏览器可执行文件'],
|
||||
['extraArgs', '--extra-args', 'YUN_XUE_TANG_EXTRA_ARGS', EXTRA_ARGS.join(' ') || '(无)', '追加给浏览器的参数'],
|
||||
['profile', '--profile', 'YUN_XUE_TANG_PROFILE_DIR', PROFILE_DIR, '持久化 profile 目录'],
|
||||
['tui', '--no-tui', 'YUN_XUE_TANG_TUI', TUI ? '开' : '关', '交互式终端里的进度面板;非 TTY 自动关闭'],
|
||||
['color', '--no-color', 'YUN_XUE_TANG_COLOR', COLOR ? '开' : '关', '面板是否用 ANSI 颜色(也认 NO_COLOR)'],
|
||||
['logFile', '--log-file', 'YUN_XUE_TANG_LOG_FILE', LOG_FILE, '日志文件'],
|
||||
['logMaxBytes', '--log-max-bytes', 'YUN_XUE_TANG_LOG_MAX_BYTES', LOG_MAX_BYTES, '单文件上限,超出轮转'],
|
||||
['barkUrl', '--bark-url', 'YUN_XUE_TANG_BARK_URL', maskBarkUrl(BARK_URL), 'Bark 推送地址(含设备 key);留空 = 不推送'],
|
||||
['barkGroup', '--bark-group', 'YUN_XUE_TANG_BARK_GROUP', BARK_GROUP || '(Bark 默认)', 'Bark 通知分组'],
|
||||
['barkTtl', '--bark-ttl', 'YUN_XUE_TANG_BARK_TTL', BARK_TTL, 'Bark 通知在服务端保留秒数;0 = 永久保留'],
|
||||
['(字段 check)', '--check', '', CHECK_ONLY, '只做环境自检,不动进度'],
|
||||
['(无字段)', '--config', 'YUN_XUE_TANG_CONFIG', CONFIG_FILE || '(内置默认)', '指定配置文件路径'],
|
||||
];
|
||||
const widths = [0, 1, 2, 3].map((c) => Math.max(...rows.map((r) => String(r[c]).length)));
|
||||
const lines = [];
|
||||
lines.push('云学堂无头运行器');
|
||||
lines.push('');
|
||||
lines.push('用法:node runner/headless.mjs [参数…]');
|
||||
lines.push('优先级:内置默认值 < 配置文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数');
|
||||
lines.push('配置文件:' + (CONFIG_FILE || '(未找到)') + (CONFIG_FILE ? '' : ' —— 复制 config/runner.config.mjs 即可'));
|
||||
lines.push('账号密码:只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD(不写进配置文件)');
|
||||
lines.push('');
|
||||
for (let i = 0; i < rows.length; i++) {
|
||||
const r = rows[i].map((v, c) => (c < 4 ? String(v).padEnd(widths[c]) : String(v)));
|
||||
lines.push((i === 0 ? '' : '') + r.join(' '));
|
||||
if (i === 0) lines.push(' '.repeat(0) + widths.map((w) => '-'.repeat(w)).join(' '));
|
||||
}
|
||||
lines.push('');
|
||||
lines.push('示例:');
|
||||
lines.push(' node runner/headless.mjs --check # 只做环境自检');
|
||||
lines.push(' node runner/headless.mjs --budget-minutes 15 # 最多跑 15 分钟');
|
||||
lines.push(' node runner/headless.mjs --headless 0 # 开有界面浏览器调试');
|
||||
lines.push(' node runner/headless.mjs --no-tui # 不用面板,回到逐行日志');
|
||||
lines.push(' node runner/headless.mjs --config ./config/runner.config.mjs # 显式指定配置文件');
|
||||
lines.push('');
|
||||
lines.push('旧参数名(仍然兼容):--budget / --restart / --idle / --log / --log-max / --visible');
|
||||
return lines.join('\n');
|
||||
}
|
||||
@@ -1,133 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 无头运行器入口:在**无图形化环境**里跑云学堂助手。
|
||||
* 支持 Linux 服务器(机房机器 / 云主机 / 容器)与 Windows(桌面后台、服务器核心版、
|
||||
* 计划任务、Session 0 服务),也能在 macOS 上无头跑。
|
||||
*
|
||||
* 这个文件只做「组装」:解析参数 → 启动前预检 → 交给 supervisor 跑。
|
||||
* 具体实现在同目录的模块里:
|
||||
*
|
||||
* config.mjs 参数与环境变量(--budget / YUN_XUE_TANG_* 全部集中在这里)
|
||||
* platform.mjs 平台差异(有无图形会话、沙箱参数、进程树收尾、端口排查命令)
|
||||
* preflight.mjs 启动前检查(产物 / Node 版本 / 凭据 / 浏览器 / 端口)
|
||||
* log.mjs 终端 + 文件日志(超上限轮转)
|
||||
* stop.mjs 终止信号优雅退出(Windows 上按 SIGINT/SIGBREAK/SIGHUP)
|
||||
* browser.mjs 浏览器探测、启动参数(root / 容器 / Windows 无人值守适配)、残局清理
|
||||
* cdp.mjs 极简 CDP 客户端
|
||||
* page.mjs 注入后要调用的页面 JS 表达式 + page 求值封装
|
||||
* session.mjs 单次会话:起浏览器 → 注入 → 自动登录 → 刷课 → 监控 → 收尾
|
||||
* selfcheck.mjs --check 的只读环境自检
|
||||
* notify.mjs Bark 手机通知(开始运行 / 获得学分 / 收尾)
|
||||
* supervisor.mjs 崩溃重启循环与退出码
|
||||
* tui.mjs 交互式终端面板(框线 + 进度条,q 退出;非 TTY 自动关闭)
|
||||
*
|
||||
* 用法(详见 README「无头运行」):
|
||||
* npm run build # 先出构建产物
|
||||
* Linux/macOS: export YUN_XUE_TANG_USR=... export YUN_XUE_TANG_PWD=...
|
||||
* Windows CMD: set YUN_XUE_TANG_USR=... set YUN_XUE_TANG_PWD=...
|
||||
* Windows PS: $env:YUN_XUE_TANG_USR='...'
|
||||
* npm run headless # 前台常驻,Ctrl+C 结束
|
||||
* npm run headless:check # 只做环境自检(只读,不登录、不刷课)
|
||||
*
|
||||
* 常用参数 / 环境变量:
|
||||
* --check 只自检:浏览器可启动、页面可访问、脚本可注入、视频编解码可用,
|
||||
* 不登录、不点课程、不动进度
|
||||
* --budget N 运行 N 分钟后收尾(0 = 不限,默认 0)
|
||||
* --profile DIR 持久化 profile 目录(默认 ./.run-profile)
|
||||
* --port N CDP 调试端口(默认 9336)
|
||||
* --visible 不无头(无图形环境里会被忽略;本机调试用)
|
||||
* --no-tui 不用终端面板,回到逐行日志(stdout 非 TTY 时自动如此)
|
||||
* --no-color 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||||
* --url URL 起始页面(默认 https://kfmic.yunxuetang.cn/login.html)
|
||||
* YUN_XUE_TANG_CHROME_BIN Chrome/Chromium 可执行文件路径(默认自动探测)
|
||||
* YUN_XUE_TANG_EXTRA_ARGS 追加给浏览器的命令行参数(空格分隔)
|
||||
* YUN_XUE_TANG_PREFER_SHORT 1/0,是否优先短课程(默认 1)
|
||||
* YUN_XUE_TANG_POINTS_MODE 1/0,每日积分模式(默认 1;文档1/视频3/音频2/微课2,封顶即停)
|
||||
* YUN_XUE_TANG_RESTART_MINUTES 脚本停止/无进展后等待多久重新开始(0 = 直接退出,默认 0)
|
||||
* YUN_XUE_TANG_IDLE_RESTART_MINUTES 连续无进展多少分钟后判定卡死(默认 30)
|
||||
* YUN_XUE_TANG_LOG_FILE 日志文件路径(默认 ./run-logs/headless.log)
|
||||
* YUN_XUE_TANG_LOG_MAX_BYTES 单个日志文件上限,超过就轮转成 .1(默认 5MB)
|
||||
* YUN_XUE_TANG_HAS_DISPLAY 0/1,强制认定「有没有图形显示会话」(自动判断不准时用)
|
||||
* YUN_XUE_TANG_TUI 0/1,是否启用终端面板(默认 1,非 TTY 时无效)
|
||||
* YUN_XUE_TANG_COLOR 0/1,面板是否带颜色(也认 NO_COLOR)
|
||||
* YUN_XUE_TANG_BARK_URL Bark 推送地址(含设备 key);留空 = 不推送
|
||||
* YUN_XUE_TANG_BARK_GROUP Bark 通知分组(默认 Bark 自己的分组)
|
||||
* YUN_XUE_TANG_BARK_TTL Bark 通知在服务端保留多少秒(0 = 默认)
|
||||
*
|
||||
* 退出码:0 正常收尾 / 1 无进展卡死 / 2 环境或参数问题 / 3 连续登录失败
|
||||
*/
|
||||
import * as cfg from './config.mjs';
|
||||
import { log, warn, error, closeLog } from './log.mjs';
|
||||
import { createStopHandler } from './stop.mjs';
|
||||
import { runPreflight, PreflightError } from './preflight.mjs';
|
||||
import { runSupervisor } from './supervisor.mjs';
|
||||
import { createTui } from './tui.mjs';
|
||||
|
||||
async function main() {
|
||||
// --help:打印完整参数表(含配置文件字段、环境变量、当前生效值)后直接退出
|
||||
if (cfg.HELP) {
|
||||
console.log(cfg.helpText());
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
const stop = createStopHandler({ log });
|
||||
|
||||
// 面板在预检之前就建好:预检的提示也进面板日志区,不会出现「先刷屏再盖住」
|
||||
const tui = createTui({
|
||||
enabled: cfg.TUI,
|
||||
title: '云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : ''),
|
||||
logFile: cfg.CHECK_ONLY ? '' : cfg.LOG_FILE,
|
||||
color: cfg.COLOR,
|
||||
onQuit: (reason) => stop.request(reason),
|
||||
});
|
||||
tui.set({ phase: '环境预检', tone: 'info' });
|
||||
|
||||
// 配置文件里有未知字段 / 废弃参数 / 被忽略的凭据:起来先提醒一句,不阻断
|
||||
for (const w of cfg.WARNINGS || []) warn('配置:' + w);
|
||||
|
||||
let pre;
|
||||
try {
|
||||
pre = await runPreflight({
|
||||
checkOnly: cfg.CHECK_ONLY,
|
||||
scriptFile: cfg.SCRIPT_FILE,
|
||||
usr: cfg.USR,
|
||||
pwd: cfg.PWD,
|
||||
port: cfg.PORT,
|
||||
profileDir: cfg.PROFILE_DIR,
|
||||
chromeBin: cfg.CHROME_BIN,
|
||||
log,
|
||||
});
|
||||
} catch (e) {
|
||||
if (e instanceof PreflightError) {
|
||||
tui.set({ phase: '环境预检失败', tone: 'error' });
|
||||
tui.finish();
|
||||
for (const l of e.lines) error(l);
|
||||
warn('修好上面问题后重跑;参数用 --help 查看。');
|
||||
closeLog();
|
||||
process.exit(e.exitCode);
|
||||
}
|
||||
tui.finish();
|
||||
closeLog();
|
||||
throw e;
|
||||
}
|
||||
|
||||
const { exitCode } = await runSupervisor({
|
||||
cfg,
|
||||
binary: pre.browser,
|
||||
scriptSrc: pre.scriptSrc,
|
||||
stop,
|
||||
tui,
|
||||
log,
|
||||
warn,
|
||||
error,
|
||||
});
|
||||
|
||||
closeLog();
|
||||
process.exit(exitCode);
|
||||
}
|
||||
|
||||
main().catch((e) => {
|
||||
error('致命错误:' + (e && e.stack ? e.stack : e));
|
||||
closeLog();
|
||||
process.exit(1);
|
||||
});
|
||||
@@ -1,69 +0,0 @@
|
||||
// 日志:同时写终端和日志文件(文件超上限就轮转成 .1)。
|
||||
//
|
||||
// 用法:
|
||||
// import { openLog, closeLog, log, warn, error } from './log.mjs';
|
||||
// openLog(file, maxBytes); // 不调用就只打终端
|
||||
// log('信息A', { x: 1 }); // → [2026-01-01 00:00:00] [信息] 信息A {"x":1}
|
||||
//
|
||||
// 终端面板(tui.mjs)启用时会把「终端」这一路改道到面板的日志区(setConsoleSink),
|
||||
// 文件那一路始终是纯文本逐行 —— 面板不会污染日志文件,grep / 采集不受影响。
|
||||
//
|
||||
// 注意:openLog 必须在任何写文件之前调用;closeLog 在进程退出路径上兜底调用。
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
|
||||
let stream = null;
|
||||
/** 终端输出目标;null = 直接 console.log(未启用面板时的默认行为) */
|
||||
let consoleSink = null;
|
||||
|
||||
/**
|
||||
* 接管 / 归还终端输出。传 null 恢复逐行 console.log。
|
||||
* sink(level, text) 收到的是完整的一行(不含换行)。
|
||||
* @param {null | ((level: string, text: string) => void)} fn
|
||||
*/
|
||||
export function setConsoleSink(fn) {
|
||||
consoleSink = typeof fn === 'function' ? fn : null;
|
||||
}
|
||||
|
||||
/** 打开日志文件;maxBytes 为单文件上限,超出时把现有文件改名成 .1 */
|
||||
export function openLog(file, maxBytes) {
|
||||
try {
|
||||
fs.mkdirSync(path.dirname(file), { recursive: true });
|
||||
try {
|
||||
const st = fs.statSync(file);
|
||||
if (st.size > maxBytes) fs.renameSync(file, file + '.1');
|
||||
} catch (e) { /* 文件还不存在 */ }
|
||||
stream = fs.createWriteStream(file, { flags: 'a' });
|
||||
} catch (e) {
|
||||
console.error('[日志] 无法写入 ' + file + ':' + e.message);
|
||||
}
|
||||
}
|
||||
|
||||
/** 关闭日志文件(可重复调用) */
|
||||
export function closeLog() {
|
||||
if (!stream) return;
|
||||
try { stream.end(); } catch (e) { /* ignore */ } finally { stream = null; }
|
||||
}
|
||||
|
||||
export function isLogOpen() {
|
||||
return stream !== null;
|
||||
}
|
||||
|
||||
const clock = () => new Date().toISOString().replace('T', ' ').slice(0, 19);
|
||||
|
||||
function line(level, args) {
|
||||
const text = '[' + clock() + '] [' + level + '] ' + args.map(function (a) {
|
||||
if (typeof a === 'string') return a;
|
||||
try { return JSON.stringify(a); } catch (e) { return String(a); }
|
||||
}).join(' ');
|
||||
if (consoleSink) {
|
||||
try { consoleSink(level, text); } catch (e) { /* 面板异常不影响日志文件 */ }
|
||||
} else {
|
||||
console.log(text);
|
||||
}
|
||||
if (stream) { try { stream.write(text + '\n'); } catch (e) { /* ignore */ } }
|
||||
}
|
||||
|
||||
export const log = (...a) => line('信息', a);
|
||||
export const warn = (...a) => line('警告', a);
|
||||
export const error = (...a) => line('错误', a);
|
||||
@@ -1,155 +0,0 @@
|
||||
// Bark 推送:运行器自己收尾时把结果发到手机。
|
||||
//
|
||||
// 覆盖三类事件(都只在 headless 运行器里发,浏览器端油猴脚本不推送):
|
||||
// · 开始运行:「进程已经跑起来了」
|
||||
// · 获得学分:每刷完一门有学分的课推一条
|
||||
// · 收尾:正常刷完 / 长时间无进展 / 登录失败
|
||||
// 手动 Ctrl+C 主动停止不推送:人就在键盘前,不需要再提醒一次。
|
||||
// 通知是附加信息:发送失败只记告警,绝不影响退出码,也不阻塞下一次会话。
|
||||
//
|
||||
// Bark 接口:GET https://api.day.app/<key>/<title>/<body>?group=<分组>[&ttl=<秒>](省略 ttl = 永久保留)
|
||||
|
||||
import { formatCredit } from './study.mjs';
|
||||
|
||||
/** 单次请求超时:Bark 正常在 1 秒内返回,卡住就当失败,别拖慢收尾 */
|
||||
export const BARK_TIMEOUT_MS = 8000;
|
||||
|
||||
function withParam(url, key, val) {
|
||||
if (val === '' || val == null) return url;
|
||||
// 地址里已经写了同名参数(例如配置里直接粘了完整 curl 地址)就不再追加
|
||||
if (new RegExp('[?&]' + key + '=').test(url)) return url;
|
||||
return url + (url.includes('?') ? '&' : '?') + key + '=' + encodeURIComponent(val);
|
||||
}
|
||||
|
||||
/**
|
||||
* 拼 Bark 请求地址。
|
||||
* base 可以是:
|
||||
* · 含设备 key 的根地址:https://api.day.app/KEY
|
||||
* · 带 {title}/{body} 占位符的完整模板:https://api.day.app/KEY/{title}/{body}?group=x
|
||||
*/
|
||||
export function buildBarkUrl(base, title, body, opts = {}) {
|
||||
let url = String(base || '').trim();
|
||||
if (!url) return '';
|
||||
const t = encodeURIComponent(title || '');
|
||||
const b = encodeURIComponent(body || '');
|
||||
if (/\{title\}|\{body\}/.test(url)) {
|
||||
url = url.replace(/\{title\}/g, t).replace(/\{body\}/g, b);
|
||||
} else {
|
||||
url = url.replace(/\/+$/, '') + '/' + t + '/' + b;
|
||||
}
|
||||
url = withParam(url, 'group', opts.group);
|
||||
url = withParam(url, 'ttl', opts.ttl ? String(opts.ttl) : '');
|
||||
return url;
|
||||
}
|
||||
|
||||
/** 收尾通知的标题与正文:把本次刷课的结论压缩成手机上能一眼看懂的两三行 */
|
||||
export function buildFinishMessage(result) {
|
||||
const r = result || {};
|
||||
const kind = r.kind || 'done';
|
||||
const title = kind === 'login'
|
||||
? '云学堂助手:登录失败'
|
||||
: kind === 'stalled' ? '云学堂助手:长时间无进展'
|
||||
: '云学堂助手:任务完成';
|
||||
|
||||
const lines = [];
|
||||
// 积分模式关闭时 snapshot 里仍是 0/24,直接贴出来会让人以为今天一条都没刷到
|
||||
if (r.points && r.points.enabled === false) lines.push('每日积分模式:关');
|
||||
else if (r.points && r.points.text) lines.push(String(r.points.text));
|
||||
// 登录失败时还没开始刷,「完成 0 门 · 用时 0 秒」只会让人以为跑过一轮
|
||||
if (kind !== 'login') {
|
||||
const secs = Number(r.elapsed) || 0;
|
||||
const used = secs >= 60
|
||||
? Math.floor(secs / 60) + ' 分 ' + (secs % 60) + ' 秒'
|
||||
: secs + ' 秒';
|
||||
lines.push('完成 ' + (Number(r.completed) || 0) + ' 门 · 用时 ' + used);
|
||||
}
|
||||
if (r.finishReason) lines.push(String(r.finishReason));
|
||||
return { title, body: lines.join('\n') };
|
||||
}
|
||||
|
||||
/** 启动通知:预检通过、浏览器即将启动时发一条,手机上能确认「程序真的跑起来了」 */
|
||||
export function buildStartMessage(cfg) {
|
||||
const c = cfg || {};
|
||||
const lines = ['正在启动浏览器并自动登录'];
|
||||
lines.push('模式:' + (c.POINTS_MODE ? '每日积分' : '普通刷课'));
|
||||
const budget = Number(c.BUDGET_MINUTES) || 0;
|
||||
lines.push('运行预算:' + (budget > 0 ? budget + ' 分钟' : '不限'));
|
||||
return { title: '云学堂助手:开始运行', body: lines.join('\n') };
|
||||
}
|
||||
|
||||
/** 学分通知:每刷完一门课发一条,带上本次累计学分与已完成门数 */
|
||||
export function buildCreditMessage(event) {
|
||||
const e = event || {};
|
||||
const title = '云学堂助手:获得 ' + formatCredit(e.credit) + ' 学分';
|
||||
const lines = [];
|
||||
if (e.course) lines.push('课程「' + String(e.course) + '」');
|
||||
let total = '本次累计 ' + formatCredit(e.total) + ' 学分';
|
||||
if (e.completed != null) total += ' · 已完成 ' + (Number(e.completed) || 0) + ' 门';
|
||||
lines.push(total);
|
||||
return { title, body: lines.join('\n') };
|
||||
}
|
||||
|
||||
/**
|
||||
* 发送 Bark 通知。永远不抛异常。
|
||||
* @returns {Promise<{ok?:boolean, skipped?:boolean, status?:number}>}
|
||||
*/
|
||||
export async function sendBark(opts) {
|
||||
const o = opts || {};
|
||||
const log = o.log || (() => {});
|
||||
const warn = o.warn || (() => {});
|
||||
const url = buildBarkUrl(o.url, o.title, o.body, { group: o.group, ttl: o.ttl });
|
||||
if (!url) return { skipped: true };
|
||||
if (typeof fetch !== 'function') {
|
||||
warn('当前 Node 没有全局 fetch(需要 Node 18+),跳过 Bark 通知');
|
||||
return { skipped: true };
|
||||
}
|
||||
|
||||
try {
|
||||
const res = await fetch(url, {
|
||||
method: 'GET',
|
||||
signal: AbortSignal.timeout(o.timeoutMs || BARK_TIMEOUT_MS),
|
||||
});
|
||||
let data = null;
|
||||
try { data = await res.json(); } catch (e) { /* 非 JSON 响应按状态码判断 */ }
|
||||
const code = data && data.code != null ? Number(data.code) : 200;
|
||||
if (!res.ok || code !== 200) {
|
||||
warn('Bark 通知发送失败:HTTP ' + res.status +
|
||||
(data && data.message ? '(' + data.message + ')' : ''));
|
||||
return { ok: false, status: res.status };
|
||||
}
|
||||
log('已发送 Bark 通知:' + o.title);
|
||||
return { ok: true, status: res.status };
|
||||
} catch (e) {
|
||||
warn('Bark 通知发送失败:' + (e && e.message ? e.message : e));
|
||||
return { ok: false };
|
||||
}
|
||||
}
|
||||
|
||||
/** 按运行器配置发一条通知;没配 barkUrl 时是空操作 */
|
||||
function notifyWith(cfg, msg, io) {
|
||||
if (!cfg || !cfg.BARK_URL) return Promise.resolve({ skipped: true });
|
||||
return sendBark({
|
||||
url: cfg.BARK_URL,
|
||||
group: cfg.BARK_GROUP,
|
||||
ttl: cfg.BARK_TTL,
|
||||
title: msg.title,
|
||||
body: msg.body,
|
||||
log: io && io.log,
|
||||
warn: io && io.warn,
|
||||
});
|
||||
}
|
||||
|
||||
/** 开始运行通知 */
|
||||
export function notifyRunStarted(cfg, io) {
|
||||
return notifyWith(cfg, buildStartMessage(cfg), io);
|
||||
}
|
||||
|
||||
/** 获得学分通知(每门刷完的课一条) */
|
||||
export function notifyCreditEarned(cfg, event, io) {
|
||||
return notifyWith(cfg, buildCreditMessage(event), io);
|
||||
}
|
||||
|
||||
/** 收尾通知 */
|
||||
export function notifyRunFinished(cfg, result, io) {
|
||||
return notifyWith(cfg, buildFinishMessage(result), io);
|
||||
}
|
||||
-161
@@ -1,161 +0,0 @@
|
||||
// 页面侧接口:所有「注入后要调用的 JS 表达式」集中在这里,外加把 CDP 的求值包成
|
||||
// 好用的 page 对象。改脚本内部 API 时只需要动这一个文件。
|
||||
//
|
||||
// page.evalJS(expr) 求值并返回值(异常会抛出)
|
||||
// page.json(expr) 求值并把返回的 JSON 字符串解析成对象
|
||||
// page.tryEval(expr) 求值但吞掉异常,返回 undefined(页面正在跳转时用)
|
||||
import { sleep } from './cdp.mjs';
|
||||
|
||||
/**
|
||||
* @param {object} cdp cdp.mjs 的客户端
|
||||
*/
|
||||
export function createPage(cdp) {
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', {
|
||||
expression: expr, returnByValue: true, awaitPromise: true, userGesture: true,
|
||||
});
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
const tryEval = async (expr) => {
|
||||
try { return await evalJS(expr); } catch (e) { return undefined; }
|
||||
};
|
||||
return { evalJS, json, tryEval };
|
||||
}
|
||||
|
||||
/** 环境自检:脚本是否注入、面板是否渲染、视频编解码能力、中文字体 */
|
||||
export const EXPR_SELF_CHECK = `JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
var probe = document.createElement('video');
|
||||
var codecs = {
|
||||
h264: probe.canPlayType('video/mp4; codecs="avc1.42E01E"') || '',
|
||||
aac: probe.canPlayType('audio/mp4; codecs="mp4a.40.2"') || '',
|
||||
vp9: probe.canPlayType('video/webm; codecs="vp9"') || '',
|
||||
};
|
||||
return {
|
||||
url: location.href,
|
||||
ua: navigator.userAgent,
|
||||
api: typeof a,
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent || '',
|
||||
panels: document.querySelectorAll('#yun-xue-tang-panel').length,
|
||||
panelVisible: (function () {
|
||||
var el = document.getElementById('yun-xue-tang-panel');
|
||||
if (!el) return false;
|
||||
var r = el.getBoundingClientRect();
|
||||
return r.width > 0 && r.height > 0;
|
||||
})(),
|
||||
isLoginPage: a ? a.isLoginPage() : null,
|
||||
route: a ? a.route() : null,
|
||||
codecs: codecs,
|
||||
fonts: (function () {
|
||||
// 中文字体缺失不影响逻辑(靠 DOM 文本匹配),仅影响截图观感
|
||||
var c = document.createElement('canvas').getContext('2d');
|
||||
if (!c) return 'n/a';
|
||||
c.font = '16px sans-serif';
|
||||
var w = c.measureText('云学堂助手').width;
|
||||
var w2 = c.measureText('abcd').width;
|
||||
return w > 0 && w2 > 0 ? 'ok' : 'unknown';
|
||||
})(),
|
||||
};
|
||||
})())`;
|
||||
|
||||
/** 看护循环:判断是否需要注入 / 是否在登录页 */
|
||||
export const EXPR_WATCH = `JSON.stringify({
|
||||
href: location.href,
|
||||
ready: typeof window.__yunXueTangAuto === 'object',
|
||||
onLogin: !!(window.__yunXueTangAuto && window.__yunXueTangAuto.isLoginPage()),
|
||||
hasPwd: !!document.querySelector('input[type=password]'),
|
||||
bodyLen: (document.body && document.body.innerText || '').length,
|
||||
})`;
|
||||
|
||||
/** 主监控快照:课程、课时、进度、倒计时、视频状态 */
|
||||
export const EXPR_SNAPSHOT = `JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return { noApi: true, href: location.href };
|
||||
var v = document.querySelector('video, audio');
|
||||
var items = [];
|
||||
try { items = a.lessonItems(); } catch (e) {}
|
||||
return {
|
||||
href: location.href,
|
||||
route: a.route(),
|
||||
running: a.S.batchRunning,
|
||||
runFinished: a.S.batchFinished,
|
||||
phase: a.S.coursePhase,
|
||||
completed: a.S.completedThisRun,
|
||||
pendingRetries: Object.keys(a.S.courseRetries || {}).length,
|
||||
course: a.S.activeCourse ? a.S.activeCourse.title : null,
|
||||
lesson: (a.readActiveLessonKey ? a.readActiveLessonKey() : ''),
|
||||
lessons: items.length,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
// 本课程可获得多少学分:平台只把它写在倒计时文案里
|
||||
// 「还需 2小时 7分钟 可完成本课程学习并获得6.52学分,加油!」
|
||||
// 学完后倒计时会消失,所以必须在播放期间就读出来(运行器靠它累计到手学分)
|
||||
credit: (function () {
|
||||
var el = document.querySelector('.yxtulcdsdk-course-player__countdown');
|
||||
if (!el) return null;
|
||||
var t = String(el.innerText || el.textContent || '').replace(/\\s+/g, '');
|
||||
var m = t.match(/获得([0-9]+(?:\\.[0-9]+)?)学分/);
|
||||
return m ? Number(m[1]) : null;
|
||||
})(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
// 每日积分:{ enabled, total, max, progress:[{label,count,cap}], text }
|
||||
points: (a.points && a.points.snapshot ? a.points.snapshot() : null),
|
||||
doneCount: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryCount: Object.keys(a.S.courseRetries || {}).length,
|
||||
retryWait: (a.retryWaitSeconds ? a.retryWaitSeconds() : 0),
|
||||
retryTitle: a.R.retryTitle || '',
|
||||
video: v ? {
|
||||
t: Math.round(v.currentTime), d: Math.round(v.duration || 0),
|
||||
paused: v.paused, err: v.error ? v.error.code : 0, src: v.currentSrc ? 1 : 0,
|
||||
} : null,
|
||||
};
|
||||
})())`;
|
||||
|
||||
/** 会话结尾的累计统计 */
|
||||
export const EXPR_FINAL_STATS = `JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return {};
|
||||
return {
|
||||
completed: a.S.completedThisRun,
|
||||
doneCount: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryCount: Object.keys(a.S.courseRetries || {}).length,
|
||||
// 每日积分:收尾通知里要带上「今日积分 X/24 · 各类次数」
|
||||
points: (a.points && a.points.snapshot ? a.points.snapshot() : null),
|
||||
};
|
||||
})())`;
|
||||
|
||||
/** 收尾:暂停媒体、停批量、存进度(浏览器关掉前调用) */
|
||||
export const EXPR_PAUSE_AND_SAVE = `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (a) { try { a.pauseAllMedia(); a.S.batchRunning = false; a.save(); } catch (e) {} }
|
||||
return true;
|
||||
})()`;
|
||||
|
||||
/** 启动 / 接续批量刷课,同时同步「优先短课程」「每日积分」偏好 */
|
||||
export const exprStartBatch = (preferShort, pointsMode) => `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
try { localStorage.setItem('yun-xue-tang-prefer-short', '${preferShort ? '1' : '0'}'); } catch (e) {}
|
||||
try { localStorage.setItem('yun-xue-tang-daily-points-mode', '${pointsMode ? '1' : '0'}'); } catch (e) {}
|
||||
a.state.preferShortCourses = ${preferShort ? 'true' : 'false'};
|
||||
a.state.pointsEnabled = ${pointsMode ? 'true' : 'false'};
|
||||
try { a.points.setEnabled(${pointsMode ? 'true' : 'false'}); } catch (e) {}
|
||||
a.startBatch();
|
||||
return true;
|
||||
})()`;
|
||||
|
||||
/** 登录页:填账号密码、勾协议、点登录并接着刷课 */
|
||||
export const exprAutoLogin = (usr, pwd) => `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return 'no-api';
|
||||
var ok = a.fillLoginForm(${JSON.stringify(usr)}, ${JSON.stringify(pwd)});
|
||||
try { a.checkLoginAgreement(); } catch (e) {}
|
||||
a.doLoginAndStart();
|
||||
return ok ? 'filled' : 'no-fields';
|
||||
})()`;
|
||||
|
||||
export { sleep };
|
||||
@@ -1,230 +0,0 @@
|
||||
// 平台差异集中在这里,其它模块不再直接判断 process.platform。
|
||||
//
|
||||
// 三个操作系统要处理的差异:
|
||||
// Linux 无 DISPLAY 必须无头;root 必须 --no-sandbox;容器 /dev/shm 小;SIGTERM 可优雅退出
|
||||
// Windows 会话 0(服务 / 计划任务「不管用户是否登录」)没有交互桌面;
|
||||
// 关闭终端窗口发的是 SIGHUP、Ctrl+Break 发的是 SIGBREAK(SIGTERM 根本收不到);
|
||||
// 跨进程只能用 taskkill 强杀(process.kill 是 TerminateProcess,子进程来不及收尾);
|
||||
// 浏览器进程树要用 taskkill /T 收;spawn 要 windowsHide 避免弹黑框
|
||||
// macOS 与 Linux 类似但没有 root 沙箱问题,SIGTERM 可用
|
||||
import { spawnSync } from 'node:child_process';
|
||||
|
||||
export const isWindows = process.platform === 'win32';
|
||||
export const isLinux = process.platform === 'linux';
|
||||
export const isMac = process.platform === 'darwin';
|
||||
/** 给人看的平台名(日志 / 提示里用) */
|
||||
export const platformName = isWindows ? 'Windows' : isMac ? 'macOS' : 'Linux';
|
||||
|
||||
export function isRunningAsRoot() {
|
||||
return typeof process.getuid === 'function' && process.getuid() === 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* 有没有图形显示会话(决定能不能开有界面浏览器)。
|
||||
* 拿不准时返回 true(宁可按有界面处理,免得把正常桌面环境误判成无头)。
|
||||
* 可用 YUN_XUE_TANG_HAS_DISPLAY=0/1 强制覆盖。
|
||||
*/
|
||||
export function hasDisplay() {
|
||||
const force = process.env.YUN_XUE_TANG_HAS_DISPLAY;
|
||||
if (force !== undefined && force !== '') return !/^(0|false|no|off)$/i.test(force);
|
||||
|
||||
if (isLinux) {
|
||||
// 跑在 Xvfb / x11vnc 下时这两个变量会被设置
|
||||
return !!(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
|
||||
}
|
||||
if (isWindows) {
|
||||
// SESSIONNAME=Services 表示当前在 Session 0(服务、计划任务勾了「不管用户是否登录」),
|
||||
// 那里没有交互式桌面,带界面的 Chrome 起不来。正常控制台是 Console,远程桌面是 RDP-Tcp#N。
|
||||
const sess = process.env.SESSIONNAME || '';
|
||||
if (/^Services$/i.test(sess)) return false;
|
||||
return true;
|
||||
}
|
||||
return true; // macOS:登录会话里默认有 WindowServer
|
||||
}
|
||||
|
||||
/** 为什么判定没有图形显示(无图形时的日志用,有图形时返回 '') */
|
||||
export function noDisplayReason() {
|
||||
if (isLinux) {
|
||||
return '当前环境没有图形显示(DISPLAY / WAYLAND_DISPLAY 都为空)';
|
||||
}
|
||||
if (isWindows) {
|
||||
return '当前进程运行在 Session 0(SESSIONNAME=Services,服务或「不管用户是否登录」的计划任务),没有交互式桌面';
|
||||
}
|
||||
return '当前环境没有图形显示';
|
||||
}
|
||||
|
||||
// 平台安全参数验证:Windows 不注入 --no-sandbox(沙箱能正常工作,关掉只会削弱安全)
|
||||
// 注意:不要在这里返回 --disable-features,因为 Chrome 对同名开关只认最后一个,
|
||||
// 会抵消 buildArgs 里已有的 --disable-features=Translate,MediaRouter,OptimizationHints。
|
||||
export function safetyArgs() {
|
||||
if (isWindows) {
|
||||
// Windows 上不存在 /dev/shm 与 zygote;需要的是「别弹崩溃恢复气泡」,
|
||||
// 否则无人值守时会卡在一个等点击的窗口上。
|
||||
return ['--disable-session-crashed-bubble', '--hide-crash-restore-bubble'];
|
||||
}
|
||||
if (isLinux) {
|
||||
const args = ['--disable-dev-shm-usage'];
|
||||
if (isRunningAsRoot()) args.push('--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu');
|
||||
return args;
|
||||
}
|
||||
return [];
|
||||
}
|
||||
|
||||
/**
|
||||
* 按 --user-data-dir 找出属于本 profile 的残留浏览器进程并杀掉。
|
||||
*
|
||||
* 很必要的自愈:Windows 上用户常用任务管理器「结束任务」(= TerminateProcess),
|
||||
* 信号收尾根本不会执行,浏览器就成了孤儿进程占着 CDP 端口,下次启动直接失败;
|
||||
* Linux 上 kill -9 同理。这里只杀命令行里带我们专属 profile 目录的进程,
|
||||
* 不碰用户自己的 Chrome。
|
||||
*
|
||||
* @param {string} profileDir
|
||||
* @param {{ log?: Function, timeoutMs?: number }} [opts]
|
||||
* @returns {Promise<number>} 杀掉的进程数
|
||||
*/
|
||||
export async function killProfileOrphans(profileDir, opts = {}) {
|
||||
const log = opts.log || (() => {});
|
||||
const timeoutMs = opts.timeoutMs || 5000;
|
||||
if (!profileDir) return 0;
|
||||
const self = process.pid;
|
||||
let pids = [];
|
||||
|
||||
try {
|
||||
if (isWindows) {
|
||||
// 注意:PowerShell 的各条语句必须用 '; ' 分隔,不能用空格连——
|
||||
// 否则 "$p -join ','" 会被当成上一条 Select-Object 的参数,变量永远为空。
|
||||
const pattern = profileDir.replace(/'/g, "''");
|
||||
const ps = [
|
||||
"$p = Get-CimInstance Win32_Process -Filter \"Name='chrome.exe' or Name='msedge.exe' or Name='chromium.exe'\"",
|
||||
' | Where-Object { $_.CommandLine -like \'*' + pattern + '*\' }',
|
||||
' | Select-Object -ExpandProperty ProcessId;',
|
||||
'$p -join \",\"',
|
||||
].join(' ');
|
||||
const r = spawnSync('powershell', ['-NoProfile', '-NonInteractive', '-Command', ps], {
|
||||
encoding: 'utf8', windowsHide: true, timeout: timeoutMs,
|
||||
});
|
||||
if (opts.debug) log('[浏览器] 排查命令输出:' + JSON.stringify(String(r.stdout || '').trim()));
|
||||
pids = String(r.stdout || '').trim().split(/[,\s]+/).filter(Boolean).map(Number);
|
||||
} else {
|
||||
const r = spawnSync('sh', ['-c', 'ps -eo pid=,args= 2>/dev/null || ps ax -o pid=,args='], {
|
||||
encoding: 'utf8', timeout: timeoutMs,
|
||||
});
|
||||
pids = String(r.stdout || '').split('\n')
|
||||
.filter((line) => line.includes(profileDir) && /(chrome|chromium|msedge)/i.test(line))
|
||||
.map((line) => Number(String(line).trim().split(/\s+/)[0]))
|
||||
.filter(Boolean);
|
||||
}
|
||||
} catch (e) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
pids = pids.filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== self);
|
||||
if (!pids.length) return 0;
|
||||
|
||||
log('[浏览器] 发现 ' + pids.length + ' 个占用本 profile 的残留进程(pid ' + pids.join(', ') + '),先收掉');
|
||||
if (isWindows) {
|
||||
spawnSync('taskkill', ['/pid', String(pids[0]), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
|
||||
for (const pid of pids) {
|
||||
spawnSync('taskkill', ['/pid', String(pid), '/F'], { windowsHide: true, stdio: 'ignore' });
|
||||
}
|
||||
} else {
|
||||
for (const pid of pids) {
|
||||
try { process.kill(pid, 'SIGKILL'); } catch (e) { /* 已经没了 */ }
|
||||
}
|
||||
}
|
||||
await new Promise((r) => setTimeout(r, 600));
|
||||
return pids.length;
|
||||
}
|
||||
|
||||
/**
|
||||
* 收掉浏览器进程(含子进程)。跨平台差异都在这里。
|
||||
* @param {import('node:child_process').ChildProcess} child
|
||||
* @param {{ log?: Function, timeoutMs?: number, profileDir?: string }} [opts]
|
||||
*/
|
||||
export async function killTree(child, opts = {}) {
|
||||
const log = opts.log || (() => {});
|
||||
const timeoutMs = opts.timeoutMs || 8000;
|
||||
const pid = child && child.pid;
|
||||
if (!pid) return;
|
||||
|
||||
const exited = () => child.exitCode !== null || child.signalCode !== null;
|
||||
const waitExit = async (ms) => {
|
||||
const t0 = Date.now();
|
||||
while (!exited() && Date.now() - t0 < ms) await new Promise((r) => setTimeout(r, 150));
|
||||
};
|
||||
|
||||
if (isWindows) {
|
||||
// Windows 上 child.kill() 就是 TerminateProcess:不优雅但立即生效。
|
||||
// 主进程若被 updater / crashpad handler 之类接管没退掉,退回 taskkill /T /F 收整棵树。
|
||||
try { child.kill(); } catch (e) { /* ignore */ }
|
||||
await waitExit(timeoutMs);
|
||||
if (!exited()) {
|
||||
log('[浏览器] 主进程未退出,用 taskkill /T /F 收整棵树(pid=' + pid + ')');
|
||||
try {
|
||||
spawnSync('taskkill', ['/pid', String(pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
|
||||
} catch (e) { /* ignore */ }
|
||||
await waitExit(3000);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// POSIX:先 SIGTERM 让它自己收拾(Chrome 会 flush profile),超时再 SIGKILL
|
||||
try { child.kill('SIGTERM'); } catch (e) { /* ignore */ }
|
||||
await waitExit(timeoutMs);
|
||||
if (!exited()) { try { child.kill('SIGKILL'); } catch (e) { /* ignore */ } }
|
||||
}
|
||||
|
||||
/**
|
||||
* 端口被占用时给用户可以照抄的命令(按平台出)。
|
||||
* @param {number} port
|
||||
*/
|
||||
export function portInUseHint(port) {
|
||||
if (isWindows) {
|
||||
return [
|
||||
'netstat -ano | findstr :' + port + ' (最后一列是 PID)',
|
||||
'taskkill /PID <上一步的 PID> /T /F',
|
||||
];
|
||||
}
|
||||
if (isMac) {
|
||||
return ['lsof -nP -iTCP:' + port + ' -sTCP:LISTEN', 'kill <PID>'];
|
||||
}
|
||||
return [
|
||||
'ss -lptn "sport = :' + port + '"',
|
||||
'pkill -f "remote-debugging-port=' + port + '"',
|
||||
];
|
||||
}
|
||||
|
||||
/** 启动前提示:本平台的浏览器装在哪 / 怎么装 */
|
||||
export function browserInstallHint() {
|
||||
if (isWindows) {
|
||||
return [
|
||||
'装一个 Chrome 或 Edge 即可(Edge 是 Chromium 内核,同样可用):',
|
||||
' winget install --id Google.Chrome',
|
||||
' 或 YUN_XUE_TANG_CHROME_BIN="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"',
|
||||
];
|
||||
}
|
||||
if (isMac) {
|
||||
return ['安装 Chrome:brew install --cask google-chrome(或下载 .dmg)',
|
||||
'或 YUN_XUE_TANG_CHROME_BIN="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"'];
|
||||
}
|
||||
return [
|
||||
'安装浏览器:sudo apt install -y chromium (或 google-chrome-stable)',
|
||||
'或指定路径:YUN_XUE_TANG_CHROME_BIN=/usr/bin/chromium',
|
||||
];
|
||||
}
|
||||
|
||||
/** 常驻方式提示(README 里也有,这里给的是「照着敲」的命令) */
|
||||
export function residentHint() {
|
||||
if (isWindows) {
|
||||
return [
|
||||
'前台:npm run headless (Ctrl+C 结束)',
|
||||
'后台:Start-Process -WindowStyle Hidden node -ArgumentList "runner/headless.mjs"',
|
||||
'开机自启:把上面一行做成「登录时运行」的计划任务(勾「不管用户是否登录」也支持)',
|
||||
];
|
||||
}
|
||||
return [
|
||||
'前台:npm run headless (Ctrl+C 结束)',
|
||||
'后台:tmux new -d -s yun-xue-tang "npm run headless"',
|
||||
'看日志:tail -f run-logs/headless.log',
|
||||
];
|
||||
}
|
||||
@@ -1,97 +0,0 @@
|
||||
// 启动前预检:构建产物、Node 版本、凭据、浏览器、调试端口。
|
||||
//
|
||||
// 目标是把「失败」变成一段人能照着做的说明,而不是一个栈。所有检查失败都抛
|
||||
// PreflightError(exitCode=2),由 headless.mjs 统一打印并退出。
|
||||
import fs from 'node:fs';
|
||||
import { httpJson } from './cdp.mjs';
|
||||
import { resolveBrowser, listCandidatePaths } from './browser.mjs';
|
||||
import {
|
||||
isWindows, platformName, portInUseHint, browserInstallHint, killProfileOrphans,
|
||||
} from './platform.mjs';
|
||||
|
||||
export class PreflightError extends Error {
|
||||
constructor(lines, exitCode = 2) {
|
||||
super(Array.isArray(lines) ? lines.join('\n') : String(lines));
|
||||
this.name = 'PreflightError';
|
||||
this.lines = Array.isArray(lines) ? lines : [String(lines)];
|
||||
this.exitCode = exitCode;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 逐项检查,全部通过后返回 { browser, scriptSrc }。
|
||||
* @param {object} o
|
||||
* @param {boolean} o.checkOnly 自检模式不校验凭据
|
||||
* @param {string} o.scriptFile 构建产物路径
|
||||
* @param {string} o.usr
|
||||
* @param {string} o.pwd
|
||||
* @param {number} o.port
|
||||
* @param {string} o.profileDir 端口被占时用来找出「自己的」残留浏览器
|
||||
* @param {string} [o.chromeBin] 配置文件里指定的浏览器路径(空 = 自动探测)
|
||||
* @param {Function} [o.log]
|
||||
*/
|
||||
export async function runPreflight(o) {
|
||||
const fail = (lines) => { throw new PreflightError(lines); };
|
||||
|
||||
// 1) 构建产物:没有它就没东西可注入
|
||||
if (!fs.existsSync(o.scriptFile)) {
|
||||
fail([
|
||||
'缺少构建产物 ' + o.scriptFile + ',先运行 npm run build',
|
||||
'(仓库里只提交源码 src/,产物由 esbuild 生成)',
|
||||
]);
|
||||
}
|
||||
|
||||
// 2) Node 运行时能力:cdp.mjs 用全局 WebSocket / fetch,Node 22 起才稳定
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
fail([
|
||||
'需要 Node 22+(依赖全局 WebSocket / fetch),当前 ' + process.version,
|
||||
isWindows
|
||||
? 'Windows 上升级:winget install OpenJS.NodeJS.LTS 或到 nodejs.org 下载 LTS 安装包'
|
||||
: 'Linux 上可用 nvm / nodesource 升级:curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -',
|
||||
]);
|
||||
}
|
||||
|
||||
// 3) 凭据:自检模式不需要(只读检查不登录)
|
||||
if (!o.checkOnly && (!o.usr || !o.pwd)) {
|
||||
fail([
|
||||
'缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD。',
|
||||
'(即使 profile 里有有效 cookie,也建议填上:cookie 失效时才能自动重登)',
|
||||
]);
|
||||
}
|
||||
|
||||
// 4) 浏览器:找不到就把所有尝试过的路径列出来,省得用户猜
|
||||
const browser = o.chromeBin || resolveBrowser();
|
||||
if (!browser || !fs.existsSync(browser)) {
|
||||
fail(['找不到 Chrome/Chromium(' + platformName + '),可用 YUN_XUE_TANG_CHROME_BIN=/path/to/chrome '
|
||||
+ '或配置文件里的 chrome 字段指定。已尝试:']
|
||||
.concat(listCandidatePaths().map((p) => ' ' + p))
|
||||
.concat(browserInstallHint()));
|
||||
}
|
||||
|
||||
// 5) 调试端口:被占用意味着上一次的浏览器还在跑,Chrome 会直接拒绝启动。
|
||||
// 无人值守场景下「自己上次没退干净」是最常见的原因,先按 profile 自愈一次:
|
||||
// 只杀命令行里带本 profile 目录的进程,不碰用户自己的浏览器。
|
||||
const probe = async () => {
|
||||
try { return await httpJson('http://127.0.0.1:' + o.port + '/json/version'); } catch (e) { return null; }
|
||||
};
|
||||
let live = await probe();
|
||||
if (live && live.webSocketDebuggerUrl) {
|
||||
const killed = await killProfileOrphans(o.profileDir, { log: o.log });
|
||||
if (killed) {
|
||||
o.log('[预检] 已清理 ' + killed + ' 个占用本 profile 的残留进程,重新检测端口…');
|
||||
await new Promise((r) => setTimeout(r, 1200));
|
||||
live = await probe();
|
||||
}
|
||||
}
|
||||
if (live && live.webSocketDebuggerUrl) {
|
||||
const hint = portInUseHint(o.port);
|
||||
fail([
|
||||
'CDP 端口 ' + o.port + ' 已被占用(' + (live.Browser || '未知浏览器') + ')。',
|
||||
'先结束占用该端口的进程:' + hint[0],
|
||||
hint[1],
|
||||
'或换端口重跑:--port ' + (o.port + 1) + ' / YUN_XUE_TANG_CDP_PORT=' + (o.port + 1),
|
||||
]);
|
||||
}
|
||||
|
||||
return { browser, scriptSrc: fs.readFileSync(o.scriptFile, 'utf8') };
|
||||
}
|
||||
@@ -1,62 +0,0 @@
|
||||
// 环境自检(--check):只读,不登录、不点课程、不动进度。
|
||||
//
|
||||
// 检查项:页面能不能打开、脚本能不能注入、面板是否唯一可见、版本是否可读、
|
||||
// 这个 Chromium 到底带不带 H.264/AAC(服务器上最常见的问题:装了发行版 chromium 却放不了视频)。
|
||||
import { sleep } from './cdp.mjs';
|
||||
import { EXPR_SELF_CHECK } from './page.mjs';
|
||||
|
||||
/**
|
||||
* @param {object} o
|
||||
* @param {object} o.page page.mjs 的 page 对象
|
||||
* @param {Function} o.tickWatchdog 会话里负责注入 / 重登的看护函数
|
||||
* @param {Function} o.isDisconnected 判断 CDP 是否已断开
|
||||
* @param {number} [o.timeoutMs] 注入自检的最长等待
|
||||
* @returns {Promise<{ok:boolean, failed:string[], reason:string}>}
|
||||
*/
|
||||
export async function runSelfCheck(o) {
|
||||
const timeoutMs = o.timeoutMs || 60000;
|
||||
const log = o.log;
|
||||
|
||||
// 等页面加载完 + 注入成功(tickWatchdog 会补注入)
|
||||
const info = await (async () => {
|
||||
const started = Date.now();
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
if (o.isDisconnected()) throw new Error('CDP 连接断开');
|
||||
try {
|
||||
await o.tickWatchdog();
|
||||
const v = await o.page.json(EXPR_SELF_CHECK);
|
||||
if (v && v.api === 'object') return v;
|
||||
} catch (e) { /* 页面仍在加载 */ }
|
||||
await sleep(1000);
|
||||
}
|
||||
throw new Error(Math.round(timeoutMs / 1000) + ' 秒内未能完成注入自检');
|
||||
})();
|
||||
|
||||
const failed = [];
|
||||
const ck = (name, ok, detail) => {
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
if (!ok) failed.push(name);
|
||||
};
|
||||
|
||||
log('--- 无头环境自检(只读)---');
|
||||
ck('页面可访问', /yunxuetang\.cn$/.test(new URL(info.url).host), info.url);
|
||||
ck('脚本已注入 window.__yunXueTangAuto', info.api === 'object', info.api);
|
||||
ck('面板渲染唯一', info.panels === 1 && info.panelVisible, { 面板数: info.panels, 可见: info.panelVisible });
|
||||
ck('脚本版本可读', /^v\d+\.\d+\.\d+$/.test(info.version || ''), info.version);
|
||||
ck('视频编解码 H.264 可用', info.codecs.h264 === 'probably' || info.codecs.h264 === 'maybe',
|
||||
{ h264: info.codecs.h264, aac: info.codecs.aac, vp9: info.codecs.vp9 });
|
||||
|
||||
log(' 提示:H.264 为 "maybe" 通常仍可播放;为空字符串说明该 Chromium 不带专有编解码器,');
|
||||
log(' 请改装 google-chrome-stable(官方包带 H.264/AAC),否则课程视频会一直是 0 秒。');
|
||||
log(' 页面识别的路由:' + info.route + ' 是否登录页:' + info.isLoginPage);
|
||||
log(' UA:' + String(info.ua).slice(0, 110));
|
||||
if (info.fonts && info.fonts !== 'ok') {
|
||||
log(' 提示:中文字体可能缺失(fonts=' + info.fonts + '),只影响截图观感;需要截图时 apt install fonts-noto-cjk');
|
||||
}
|
||||
|
||||
return {
|
||||
ok: failed.length === 0,
|
||||
failed,
|
||||
reason: failed.length ? '自检失败:' + failed.join('、') : '',
|
||||
};
|
||||
}
|
||||
@@ -1,371 +0,0 @@
|
||||
// 单次会话:一个浏览器进程的生命周期。
|
||||
//
|
||||
// 顺序:起浏览器 → 建标签页 → 连 CDP → 转发页面日志 → 每 1.5 秒看护
|
||||
// (补注入 / 自动重登 / 启动批量)→ 主监控(进度、卡死、退出条件)→ 收尾。
|
||||
// 崩溃或断线时直接抛错,由 supervisor.mjs 负责重建浏览器。
|
||||
import { connect, httpJson, sleep } from './cdp.mjs';
|
||||
import { launchBrowser } from './browser.mjs';
|
||||
import {
|
||||
createPage, EXPR_WATCH, EXPR_SNAPSHOT, EXPR_FINAL_STATS, EXPR_PAUSE_AND_SAVE,
|
||||
exprStartBatch, exprAutoLogin,
|
||||
} from './page.mjs';
|
||||
import { runSelfCheck } from './selfcheck.mjs';
|
||||
import { notifyCreditEarned } from './notify.mjs';
|
||||
|
||||
/** 看护循环间隔:既不能太密(CDP 往返),也要能及时补注入 */
|
||||
export const WATCHDOG_MS = 1500;
|
||||
/** 主监控轮询间隔:与面板的 1 秒刷新对齐,画面才不会一帧新一帧旧 */
|
||||
export const MONITOR_MS = 1000;
|
||||
/** 状态读不到多久后判定浏览器不可用 */
|
||||
const STATE_TIMEOUT_MS = 90000;
|
||||
/** 连续多少次登录失败判定为凭据/验证码问题(退出码 3) */
|
||||
const MAX_LOGIN_ATTEMPTS = 5;
|
||||
|
||||
// 当前会话的清理句柄。runSession 抛错时(CDP 断线、登录失败…)内部收尾代码不会执行,
|
||||
// 由 supervisor 在 catch 里调用 disposeActiveSession() 保证浏览器被收干净、端口能立刻复用。
|
||||
let activeCleanup = null;
|
||||
|
||||
/** 收掉当前会话(幂等,可在任何时刻调用) */
|
||||
export async function disposeActiveSession() {
|
||||
const fn = activeCleanup;
|
||||
activeCleanup = null;
|
||||
if (fn) await fn();
|
||||
}
|
||||
/** 两次自动登录之间的最小间隔,避免把账号刷到风控 */
|
||||
const LOGIN_COOLDOWN_MS = 20000;
|
||||
|
||||
/**
|
||||
* @param {object} o
|
||||
* @param {object} o.cfg config.mjs 的常量集合(见 headless.mjs 传入的 cfg 对象)
|
||||
* @param {string} o.binary 浏览器可执行文件
|
||||
* @param {string} o.scriptSrc 构建产物源码(注入用)
|
||||
* @param {object} o.stop stop.mjs 的 stop 句柄
|
||||
* @param {object} [o.tui] tui.mjs 的面板(不传 / 未启用时所有调用都是空操作)
|
||||
* @param {Function} o.log / o.warn / o.error 日志函数
|
||||
*/
|
||||
export async function runSession(o) {
|
||||
const { cfg, binary, scriptSrc, stop } = o;
|
||||
const log = o.log, warn = o.warn, error = o.error;
|
||||
// 面板是可选件:未启用时 set/snap 都是空操作,这里不需要分支判断
|
||||
const tui = o.tui || { set: () => {}, snap: () => {}, finish: () => {}, enabled: false };
|
||||
|
||||
let browser = null;
|
||||
let cdp = null;
|
||||
let watchdog = null;
|
||||
let disconnected = false;
|
||||
let injected = 0;
|
||||
let loginAttempts = 0;
|
||||
let loginLastAt = 0;
|
||||
let finished = false;
|
||||
let finishReason = '';
|
||||
let lastSig = '';
|
||||
let lastStateAt = Date.now();
|
||||
let codecWarned = false;
|
||||
// 看护循环里抛出的致命错误(如连续登录失败)不能就地丢掉:定时器的 catch
|
||||
// 拿不到主循环的控制流,必须把错误寄存下来,由主循环抛出。
|
||||
let fatalError = null;
|
||||
const consoleErrors = [];
|
||||
|
||||
const page = {
|
||||
evalJS: null, json: null, tryEval: null,
|
||||
};
|
||||
|
||||
const disposeSession = async () => {
|
||||
if (watchdog) { clearInterval(watchdog); watchdog = null; }
|
||||
if (page.evalJS && cdp && !cdp.closed) {
|
||||
try { await page.evalJS(EXPR_PAUSE_AND_SAVE); } catch (e) { /* ignore */ }
|
||||
}
|
||||
if (cdp) { cdp.close(); cdp = null; }
|
||||
if (browser) { await browser.kill(); browser = null; }
|
||||
};
|
||||
const unregister = stop.add(disposeSession);
|
||||
activeCleanup = async () => { await disposeSession(); unregister(); };
|
||||
|
||||
// ---- 起浏览器 + 建标签页 + 连 CDP ----
|
||||
// 注意:attempt 由 supervisor 管,这里不要传(传 undefined 会把它抹掉)
|
||||
tui.set({ phase: '启动浏览器', tone: 'info' });
|
||||
browser = await launchBrowser({
|
||||
binary,
|
||||
profileDir: cfg.PROFILE_DIR,
|
||||
port: cfg.PORT,
|
||||
headless: !cfg.VISIBLE,
|
||||
extraArgs: cfg.EXTRA_ARGS,
|
||||
log,
|
||||
});
|
||||
log('浏览器就绪:' + browser.version.Browser + ' profile=' + cfg.PROFILE_DIR);
|
||||
tui.set({ phase: '打开页面', tone: 'info' });
|
||||
|
||||
const target = await httpJson('http://127.0.0.1:' + cfg.PORT + '/json/new?' + encodeURIComponent(cfg.START_URL), 'PUT');
|
||||
const wsUrl = target && target.webSocketDebuggerUrl;
|
||||
if (!wsUrl) throw new Error('无法创建标签页(/json/new 未返回 webSocketDebuggerUrl)');
|
||||
cdp = await connect(wsUrl, { onClose: () => { disconnected = true; } });
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
|
||||
const p = createPage(cdp);
|
||||
page.evalJS = p.evalJS;
|
||||
page.json = p.json;
|
||||
page.tryEval = p.tryEval;
|
||||
|
||||
// 页面 console / Log 转发:只关心脚本自己打的日志,其它 UA 噪声不看
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
if (!/云学堂助手/.test(String(text))) return;
|
||||
if (m.params.type === 'error') {
|
||||
consoleErrors.push(String(text));
|
||||
error('页面脚本报错:' + String(text).slice(0, 300));
|
||||
} else {
|
||||
log('页面:' + String(text).slice(0, 300));
|
||||
}
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
const t = m.params.entry;
|
||||
if (t.level === 'error' && /云学堂助手/.test(t.text)) {
|
||||
consoleErrors.push(t.text);
|
||||
error('页面报错:' + t.text.slice(0, 300));
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
// ---------------- 看护循环 ----------------
|
||||
// 每 WATCHDOG_MS 跑一次:新 document 补注入;掉登录自动重登;启动/接续批量。
|
||||
const tickWatchdog = async () => {
|
||||
if (disconnected || stop.stopping) return;
|
||||
const s = await page.tryEval(EXPR_WATCH).then((v) => (v ? JSON.parse(v) : null));
|
||||
if (!s || !s.href) return;
|
||||
|
||||
// 新 document / 首次加载:注入脚本(等价 Tampermonkey 按 @match 重注入)
|
||||
if (!s.ready) {
|
||||
if (/^(about:|chrome-error:|data:)/.test(String(s.href))) return; // 还没导航到真页面
|
||||
if (!s.bodyLen && !s.hasPwd) return; // 页面还在渲染
|
||||
try {
|
||||
await page.evalJS(scriptSrc);
|
||||
const t = await page.evalJS('typeof window.__yunXueTangAuto');
|
||||
if (t === 'object') {
|
||||
injected++;
|
||||
tui.set({ injected, phase: '已注入脚本' });
|
||||
log('已注入脚本(第 ' + injected + ' 次):' + String(s.href).slice(0, 90));
|
||||
} else {
|
||||
warn('注入后未生成 window.__yunXueTangAuto(typeof=' + t + ')');
|
||||
}
|
||||
} catch (e) {
|
||||
warn('注入失败:' + (e && e.message ? e.message : e));
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 掉登录:用环境变量里的账号自动重登(限速 + 次数上限)
|
||||
if (s.onLogin) {
|
||||
if (loginAttempts >= MAX_LOGIN_ATTEMPTS) {
|
||||
throw new Error('连续 ' + MAX_LOGIN_ATTEMPTS + ' 次登录失败:请检查 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,'
|
||||
+ '或站点要求人工验证码(无头环境无法完成)');
|
||||
}
|
||||
if (Date.now() - loginLastAt < LOGIN_COOLDOWN_MS) return;
|
||||
loginLastAt = Date.now();
|
||||
loginAttempts++;
|
||||
tui.set({ phase: '自动登录(第 ' + loginAttempts + ' 次)', tone: 'warn' });
|
||||
log('登录页:自动登录(第 ' + loginAttempts + ' 次尝试)');
|
||||
try {
|
||||
const r = await page.evalJS(exprAutoLogin(cfg.USR, cfg.PWD));
|
||||
if (r === 'no-fields') warn('登录页没找到账号/密码输入框:可能站点改版或页面尚未渲染完');
|
||||
} catch (e) {
|
||||
warn('自动登录调用失败:' + (e && e.message ? e.message : e));
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (loginAttempts) {
|
||||
loginAttempts = 0;
|
||||
tui.set({ phase: '已登录,准备刷课', tone: 'ok' });
|
||||
log('已离开登录页,登录成功');
|
||||
}
|
||||
|
||||
// 启动 / 接续批量。注意:脚本的运行状态存在 sessionStorage,
|
||||
// 每个会话都是新标签页 → 必然从「未运行」开始,所以这里每次都会显式启动一次,
|
||||
// 不会出现「浏览器重启后自动接着刷」或「未登录就报运行中」。
|
||||
const raw = await page.tryEval(`JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
return { route: a.route(), batchRunning: a.S.batchRunning, batchFinished: a.S.batchFinished,
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '' };
|
||||
})())`);
|
||||
if (!raw) return; // 路由跳转中,下一轮再试
|
||||
const st = JSON.parse(raw);
|
||||
|
||||
if (st.batchFinished) {
|
||||
// 完成门数由收尾日志和通知正文另行给出,这里只留页面给出的停止原因
|
||||
finishReason = String(st.status || '').trim().slice(0, 120) ||
|
||||
(cfg.RESTART_MINUTES > 0 ? '无更多可学课程,稍后重新开始' : '无更多可学课程');
|
||||
finished = true;
|
||||
return;
|
||||
}
|
||||
if (!st.batchRunning && st.route !== 'other') {
|
||||
const ok = await page.tryEval(exprStartBatch(cfg.PREFER_SHORT, cfg.POINTS_MODE));
|
||||
if (ok) {
|
||||
tui.set({ phase: '刷课中', tone: 'ok' });
|
||||
log('已启动列表刷课' + (cfg.PREFER_SHORT ? '(优先短课程)' : '') +
|
||||
(cfg.POINTS_MODE ? '(每日积分模式)' : ''));
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
// ---------------- 自检模式 ----------------
|
||||
if (cfg.CHECK_ONLY) {
|
||||
tui.set({ phase: '环境自检中', tone: 'info' });
|
||||
const result = await runSelfCheck({
|
||||
page,
|
||||
tickWatchdog,
|
||||
isDisconnected: () => disconnected,
|
||||
log,
|
||||
});
|
||||
await disposeSession();
|
||||
unregister();
|
||||
activeCleanup = null;
|
||||
return result;
|
||||
}
|
||||
|
||||
log('模式:无头 ' + (browser.headless ? 'headless' : '否') +
|
||||
' 预算 ' + (cfg.BUDGET_MINUTES > 0 ? cfg.BUDGET_MINUTES + ' 分钟' : '不限') +
|
||||
' 短课程优先 ' + (cfg.PREFER_SHORT ? '开' : '关') +
|
||||
' 每日积分 ' + (cfg.POINTS_MODE ? '开' : '关') +
|
||||
' 无进展 ' + cfg.IDLE_RESTART_MINUTES + ' 分钟');
|
||||
|
||||
watchdog = setInterval(() => {
|
||||
tickWatchdog().catch((e) => {
|
||||
if (stop.stopping || disconnected) return;
|
||||
// 登录次数用尽这类错误是终局的,不能只警告后继续轮询
|
||||
if (/连续 \d+ 次登录失败/.test(e && e.message ? e.message : '')) {
|
||||
fatalError = e;
|
||||
if (watchdog) { clearInterval(watchdog); watchdog = null; }
|
||||
return;
|
||||
}
|
||||
warn('看护循环异常:' + (e && e.message ? e.message : e));
|
||||
});
|
||||
}, WATCHDOG_MS);
|
||||
await tickWatchdog();
|
||||
if (fatalError) throw fatalError;
|
||||
|
||||
// ---------------- 主监控 ----------------
|
||||
const startedAt = Date.now();
|
||||
const stallLimit = cfg.IDLE_RESTART_MINUTES > 0 ? cfg.IDLE_RESTART_MINUTES * 60 * 1000 : 30 * 60 * 1000;
|
||||
const deadline = cfg.BUDGET_MINUTES > 0 ? startedAt + cfg.BUDGET_MINUTES * 60 * 1000 : Infinity;
|
||||
let lastProgressAt = Date.now();
|
||||
let lastProgressKey = '';
|
||||
let doneReported = 0;
|
||||
|
||||
while (!stop.stopping) {
|
||||
if (fatalError) throw fatalError;
|
||||
if (disconnected) throw new Error('CDP 连接断开,重启浏览器');
|
||||
if (Date.now() > deadline) { finishReason = '达到运行预算 ' + cfg.BUDGET_MINUTES + ' 分钟'; break; }
|
||||
if (finished) break;
|
||||
|
||||
const raw = await page.tryEval(EXPR_SNAPSHOT);
|
||||
if (!raw) {
|
||||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||||
}
|
||||
await sleep(MONITOR_MS);
|
||||
continue;
|
||||
}
|
||||
const snap = JSON.parse(raw);
|
||||
if (snap.noApi) {
|
||||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||||
}
|
||||
await sleep(MONITOR_MS);
|
||||
continue;
|
||||
}
|
||||
lastStateAt = Date.now();
|
||||
// 面板每一轮都刷(快照本身就是最新状态,不需要另算);面板未启用时也照常累计学时/学分
|
||||
const study = tui.snap(snap);
|
||||
if (!finishReason) {
|
||||
if (snap.runFinished) tui.set({ phase: '脚本已停止', tone: 'ok' });
|
||||
else if (snap.retryWait > 0) tui.set({ phase: '等待重试', tone: 'warn' });
|
||||
else if (snap.video && !snap.video.paused) tui.set({ phase: '刷课中', tone: 'ok' });
|
||||
else if (snap.route === 'list') tui.set({ phase: '列表页排队中', tone: 'info' });
|
||||
else tui.set({ phase: '运行中', tone: 'info' });
|
||||
}
|
||||
// 每刷完一门课推一条学分提醒;study.earned 已经按课程去重,重试不会重复推
|
||||
if (study && study.earned && study.earned.length && !stop.stopping) {
|
||||
for (const ev of study.earned) {
|
||||
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
|
||||
await notifyCreditEarned(cfg, {
|
||||
course: ev.course,
|
||||
credit: ev.credit,
|
||||
total: study.creditEarned,
|
||||
completed: snap.completed,
|
||||
}, { log, warn });
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
// 编解码器缺失:视频元素有源但解码错误(MEDIA_ERR_DECODE / SRC_NOT_SUPPORTED)
|
||||
if (!codecWarned && snap.video && snap.video.src && snap.video.err >= 3) {
|
||||
codecWarned = true;
|
||||
warn('视频解码失败(error.code=' + snap.video.err + '):这个 Chromium 很可能不带 H.264/AAC 编解码器。');
|
||||
warn('请改装官方 google-chrome-stable,或换用带专有编解码器的 Chromium 构建。');
|
||||
}
|
||||
|
||||
// 有进展就重置停滞计时:课程/课时/进度/视频在播任一都算
|
||||
const key = [snap.course, snap.lesson, snap.completed, snap.summary && snap.summary.text, snap.doneCount].join('|');
|
||||
if (key !== lastProgressKey || (snap.video && !snap.video.paused)) {
|
||||
lastProgressKey = key;
|
||||
lastProgressAt = Date.now();
|
||||
}
|
||||
|
||||
// 只在状态变化时打日志,避免刷屏
|
||||
const sig = [snap.route, snap.course, snap.lesson, snap.completed, snap.phase, snap.runFinished].join('|');
|
||||
if (sig !== lastSig) {
|
||||
lastSig = sig;
|
||||
const parts = [];
|
||||
parts.push(snap.course ? ('课程「' + String(snap.course).slice(0, 28) + '」')
|
||||
: (snap.route === 'list' ? '列表页' : snap.route));
|
||||
if (snap.lesson) parts.push('课时 ' + String(snap.lesson).slice(0, 24));
|
||||
if (snap.summary && snap.summary.text) parts.push(String(snap.summary.text).slice(0, 24));
|
||||
if (snap.countdown != null) parts.push('倒计时 ' + snap.countdown + 's');
|
||||
parts.push('本次完成 ' + snap.completed);
|
||||
if (snap.retryWait) parts.push('等待重试 ' + snap.retryWait + 's');
|
||||
else if (snap.retryCount) parts.push('待重试 ' + snap.retryCount);
|
||||
log(parts.join(' '));
|
||||
if (snap.status) log(' 状态:' + String(snap.status).slice(0, 120));
|
||||
}
|
||||
if (snap.completed > doneReported) {
|
||||
doneReported = snap.completed;
|
||||
log('✔ 已完成 ' + snap.completed + ' 门(累计记录 ' + snap.doneCount + ' 门)');
|
||||
}
|
||||
|
||||
// 脚本停止 / 长时间无进展
|
||||
if (snap.runFinished) {
|
||||
// 标题已经说明「结束了」,这里只要有具体原因就够了
|
||||
finishReason = String(snap.status || '').trim() || '页面脚本已停止';
|
||||
break;
|
||||
}
|
||||
if (Date.now() - lastProgressAt > stallLimit) {
|
||||
finishReason = '超过 ' + Math.round(stallLimit / 60000) + ' 分钟没有任何进展(最后停在 ' +
|
||||
(snap.course || '列表') + ')';
|
||||
break;
|
||||
}
|
||||
|
||||
await sleep(MONITOR_MS);
|
||||
}
|
||||
|
||||
// ---------------- 收尾 ----------------
|
||||
const elapsed = Math.round((Date.now() - startedAt) / 1000);
|
||||
const final = await page.tryEval(EXPR_FINAL_STATS).then((v) => (v ? JSON.parse(v) : {})).catch(() => ({}));
|
||||
tui.set({ phase: '本次会话结束,收尾中', tone: 'ok', completed: final.completed || 0 });
|
||||
log('本次会话结束:' + (finishReason || '收到退出信号') +
|
||||
' 用时 ' + Math.floor(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒' +
|
||||
' 本次完成 ' + (final.completed || 0) + ' 门,累计 ' + (final.doneCount || 0) + ' 门');
|
||||
if (consoleErrors.length) {
|
||||
warn('本次共 ' + consoleErrors.length + ' 条页面脚本报错,最后一条:' + consoleErrors.slice(-1)[0].slice(0, 200));
|
||||
}
|
||||
|
||||
await disposeSession();
|
||||
unregister();
|
||||
activeCleanup = null;
|
||||
|
||||
return {
|
||||
finishReason, completed: final.completed || 0, elapsed, injected, ok: true,
|
||||
points: final.points || null,
|
||||
};
|
||||
}
|
||||
@@ -1,72 +0,0 @@
|
||||
// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。
|
||||
//
|
||||
// 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。
|
||||
// const stop = createStopHandler({ log });
|
||||
// const unregister = stop.add(() => browser.kill());
|
||||
// if (stop.stopping) return; // 主循环里轮询这个开关
|
||||
// stop.request('q'); // 面板里按 q 也走同一条收尾路径
|
||||
//
|
||||
// 收尾完成后会 closeLog() 并以 0 退出,所以主循环不用自己处理信号。
|
||||
//
|
||||
// 各平台的信号差异(很重要,不然 Windows 上会「关不掉」):
|
||||
// Linux/macOS Ctrl+C = SIGINT,kill = SIGTERM,两者都能收
|
||||
// Windows Ctrl+C = SIGINT(可用),Ctrl+Break = SIGBREAK,关闭控制台窗口 = SIGHUP
|
||||
// SIGTERM 根本收不到;用 taskkill /F 或任务管理器「结束任务」是 TerminateProcess,
|
||||
// 任何处理函数都不会执行 —— 那种情况只能靠下次启动时清理残留进程+锁文件。
|
||||
import { closeLog, log as defaultLog } from './log.mjs';
|
||||
|
||||
/** 各平台实际可能收到的终止信号 */
|
||||
const SIGNALS = process.platform === 'win32'
|
||||
? ['SIGINT', 'SIGBREAK', 'SIGHUP']
|
||||
: ['SIGINT', 'SIGTERM', 'SIGHUP'];
|
||||
|
||||
/**
|
||||
* @param {{ log?: Function, onExit?: (code:number)=>void }} [opts]
|
||||
*/
|
||||
export function createStopHandler(opts = {}) {
|
||||
const say = opts.log || defaultLog;
|
||||
const exit = opts.onExit || ((code) => process.exit(code));
|
||||
const cleaners = [];
|
||||
let stopping = false;
|
||||
let triggered = null;
|
||||
|
||||
const run = async (signal) => {
|
||||
if (stopping) return;
|
||||
stopping = true;
|
||||
triggered = signal;
|
||||
say('收到 ' + signal + ',正在收尾…');
|
||||
// 收尾函数并行跑,谁也挡不住谁(浏览器关不掉也要退)
|
||||
await Promise.allSettled(cleaners.map((fn) => {
|
||||
try { return Promise.resolve(fn()); } catch (e) { return Promise.reject(e); }
|
||||
}));
|
||||
closeLog();
|
||||
exit(0);
|
||||
};
|
||||
|
||||
process.on('SIGINT', () => run('SIGINT'));
|
||||
process.on('SIGTERM', () => run('SIGTERM'));
|
||||
process.on('SIGBREAK', () => run('SIGBREAK')); // Windows:Ctrl+Break
|
||||
process.on('SIGHUP', () => run('SIGHUP')); // Windows:关闭控制台窗口
|
||||
|
||||
return {
|
||||
/** 注册一个收尾函数,返回取消注册的函数 */
|
||||
add(fn) {
|
||||
cleaners.push(fn);
|
||||
return () => {
|
||||
const i = cleaners.indexOf(fn);
|
||||
if (i >= 0) cleaners.splice(i, 1);
|
||||
};
|
||||
},
|
||||
/**
|
||||
* 主动请求收尾(终端面板里按 q / Ctrl+C 走这里),
|
||||
* 与收到信号完全同一条路径:并行收尾 → closeLog → exit(0)。
|
||||
*/
|
||||
request(reason) {
|
||||
run(reason || '面板退出');
|
||||
},
|
||||
get stopping() { return stopping; },
|
||||
get signal() { return triggered; },
|
||||
/** 本平台实际监听的信号列表(自检 / 日志里用) */
|
||||
signals: SIGNALS,
|
||||
};
|
||||
}
|
||||
@@ -1,119 +0,0 @@
|
||||
// 学习统计:本次运行学了多久、拿到多少学分。
|
||||
//
|
||||
// 两个口径都是用户能直接验证的,所以规则要写死在这里、别散到面板里:
|
||||
// · 学习时长 = 视频真正在播的累计时间(暂停 / 排队 / 重试退避 / 页面加载都不算)
|
||||
// · 获得学分 = 本次运行里真正刷完的课程能拿到的学分之和(按课程去重)
|
||||
//
|
||||
// 数据都来自 page.mjs 的 EXPR_SNAPSHOT:视频状态来自 <video> 元素,
|
||||
// 学分来自倒计时文案「…可完成本课程学习并获得6.52学分,加油!」。
|
||||
// 学完之后那个倒计时元素就消失了,所以学分必须边播边记进 creditOf。
|
||||
//
|
||||
// 这里不读时钟以外的任何东西,也不太碰终端——所以能脱离浏览器和 TTY 直接测。
|
||||
/** 两次快照间隔超过这个秒数就认为中间断过(浏览器重启 / 进程被挂起),不补计 */
|
||||
const MAX_GAP_SECONDS = 60;
|
||||
|
||||
/**
|
||||
* @param {object} [opts]
|
||||
* @param {Function} [opts.now] 取当前时间(毫秒),测试里可换成假时钟
|
||||
*/
|
||||
export function createStudyTracker(opts = {}) {
|
||||
const now = opts.now || (() => Date.now());
|
||||
|
||||
let studySeconds = 0; // 本次运行累计播放时长(秒)
|
||||
let creditEarned = 0; // 本次运行累计获得学分
|
||||
let credit = null; // 当前这门课学完能拿多少学分(平台只在播放期间写出来)
|
||||
let lastAt = 0; // 上一条快照的时间,用来算两次之间播了多少秒
|
||||
let lastPlaying = false;
|
||||
let lastCompleted = 0;
|
||||
let lastCourse = '';
|
||||
|
||||
const creditOf = new Map(); // 课程名 → 可得学分(学完后元素消失,只能靠缓存)
|
||||
const credited = new Set(); // 已计入的课程,防止重试 / 刷新页面重复累加
|
||||
|
||||
/**
|
||||
* 吃一条主监控快照,返回最新的统计值。
|
||||
* 传进来的快照字段可能缺失(页面刚跳转时就是半空的),所以全部按可选处理。
|
||||
*/
|
||||
function update(snap) {
|
||||
if (!snap || snap.noApi) return { ...get(), earned: [] };
|
||||
const at = now();
|
||||
const course = snap.course || '';
|
||||
const earned = [];
|
||||
|
||||
// ---- 学习时长:只算视频真的在播的时间 ----
|
||||
// 用「两次快照的真实间隔」而不是写死的轮询周期:CDP 往返偶尔会慢,
|
||||
// 写死一个常数会让长跑下来明显偏少或偏多。间隔过大说明中间断过,直接丢弃不补计。
|
||||
// 只有「上一帧在播、这一帧也在播」才计:宁可少算一秒,不能把
|
||||
// 暂停后挂机的时间 算成学习时长(挂机好几分钟才是常态)。
|
||||
const playing = !!(snap.video && !snap.video.paused);
|
||||
if (lastPlaying && playing && lastAt > 0) {
|
||||
const gap = (at - lastAt) / 1000;
|
||||
if (gap > 0 && gap <= MAX_GAP_SECONDS) studySeconds += gap;
|
||||
}
|
||||
lastPlaying = playing;
|
||||
lastAt = at;
|
||||
|
||||
// ---- 学分:边播边记「这门课值多少分」----
|
||||
const read = typeof snap.credit === 'number' && snap.credit > 0 ? snap.credit : null;
|
||||
if (read != null) {
|
||||
credit = read;
|
||||
if (course) creditOf.set(course, read);
|
||||
} else if (course && creditOf.has(course)) {
|
||||
credit = creditOf.get(course); // 倒计时消失(学完了)后沿用缓存值
|
||||
} else if (course && course !== lastCourse) {
|
||||
credit = null; // 换课了,新课的学分还没读出来
|
||||
}
|
||||
|
||||
// ---- 学分:只给真正刷完的课发分 ----
|
||||
const completed = Number(snap.completed) || 0;
|
||||
if (completed > lastCompleted) {
|
||||
// 完成数涨了:刚刷完的那门课此刻可能已经从快照里切走,所以用上一次记的课程名
|
||||
const justDone = lastCourse || course;
|
||||
if (justDone && creditOf.has(justDone) && !credited.has(justDone)) {
|
||||
credited.add(justDone);
|
||||
const amount = creditOf.get(justDone);
|
||||
creditEarned += amount;
|
||||
earned.push({ course: justDone, credit: amount });
|
||||
}
|
||||
lastCompleted = completed;
|
||||
}
|
||||
if (course) lastCourse = course;
|
||||
|
||||
return { ...get(), earned };
|
||||
}
|
||||
|
||||
/** 当前统计值(不会被外部改到内部状态) */
|
||||
function get() {
|
||||
// 学分保留两位小数:平台给的本来就是 0.23 / 6.52 这种,浮点累加会出现 3.7499999
|
||||
return { studySeconds, credit, creditEarned };
|
||||
}
|
||||
|
||||
/** 日志 / 收尾用的一句话(没有数据时返回空串,调用方直接跳过) */
|
||||
function summary() {
|
||||
if (studySeconds <= 0 && creditEarned <= 0) return '';
|
||||
return '视频累计播放 ' + fmt(studySeconds) + ',获得 ' + creditText() + ' 学分';
|
||||
}
|
||||
|
||||
/** 学分文本:整数不带小数点,小数保留最多两位并去掉尾随 0 */
|
||||
function creditText(value) {
|
||||
return formatCredit(value === undefined ? creditEarned : value);
|
||||
}
|
||||
|
||||
return { update, get, summary, creditText, reset() { studySeconds = 0; creditEarned = 0; credit = null; lastAt = 0; lastPlaying = false; lastCompleted = 0; lastCourse = ''; creditOf.clear(); credited.clear(); } };
|
||||
}
|
||||
|
||||
/** 学分文本:整数不带小数点,小数保留最多两位并去掉尾随 0 */
|
||||
export function formatCredit(value) {
|
||||
const v = Number(value) || 0;
|
||||
return String(Number(v.toFixed(2)));
|
||||
}
|
||||
|
||||
/** 秒 → 1:23:45 / 23:45(与面板显示保持一致,面板自己那份在 tui.mjs) */
|
||||
function fmt(sec) {
|
||||
const s = Math.max(0, Math.round(Number(sec) || 0));
|
||||
const h = Math.floor(s / 3600);
|
||||
const two = (n) => String(n).padStart(2, '0');
|
||||
const m = Math.floor((s % 3600) / 60);
|
||||
const r = s % 60;
|
||||
return h > 0 ? h + ':' + two(m) + ':' + two(r) : two(m) + ':' + two(r);
|
||||
}
|
||||
@@ -1,159 +0,0 @@
|
||||
// 进程层:日志开关、终端面板、启动横幅、崩溃重启循环、退出码。
|
||||
//
|
||||
// 一次会话(session.mjs)只管一个浏览器进程;这里管「崩了就重来」以及「什么情况该放弃」。
|
||||
// 重试等待递增:15s → 30s → 45s …,上限 120s,避免持续失败时疯狂刷 CDP 端口。
|
||||
import { sleep } from './cdp.mjs';
|
||||
import { cleanStaleSingleton } from './browser.mjs';
|
||||
import { runSession, disposeActiveSession } from './session.mjs';
|
||||
import { openLog } from './log.mjs';
|
||||
import { noDisplayReason, platformName } from './platform.mjs';
|
||||
import { createTui } from './tui.mjs';
|
||||
import { notifyRunStarted, notifyRunFinished } from './notify.mjs';
|
||||
|
||||
const RETRY_BASE_MS = 15000;
|
||||
const RETRY_MAX_MS = 120000;
|
||||
|
||||
/**
|
||||
* @param {object} o
|
||||
* @param {object} o.cfg
|
||||
* @param {string} o.binary
|
||||
* @param {string} o.scriptSrc
|
||||
* @param {object} o.stop stop.mjs 的句柄
|
||||
* @param {object} [o.tui] 已创建的面板(不传就按 cfg.TUI 自己建)
|
||||
* @param {Function} [o.onQuitRequest] 面板按 q 时的回调(默认接到 stop 上)
|
||||
* @param {Function} o.log / o.warn / o.error
|
||||
*/
|
||||
export async function runSupervisor(o) {
|
||||
const { cfg, stop } = o;
|
||||
const log = o.log, warn = o.warn, error = o.error;
|
||||
|
||||
// 自检不写文件日志:避免每次 --check 都改仓库内容
|
||||
if (!cfg.CHECK_ONLY) openLog(cfg.LOG_FILE, cfg.LOG_MAX_BYTES);
|
||||
|
||||
// 面板要先于启动横幅建好:横幅和后续日志都会进面板的日志区
|
||||
const tui = o.tui || createTui({
|
||||
enabled: cfg.TUI,
|
||||
title: '云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : ''),
|
||||
logFile: cfg.CHECK_ONLY ? '' : cfg.LOG_FILE,
|
||||
color: cfg.COLOR,
|
||||
onQuit: (reason) => {
|
||||
if (o.onQuitRequest) o.onQuitRequest(reason);
|
||||
else if (typeof stop.request === 'function') stop.request(reason);
|
||||
},
|
||||
});
|
||||
|
||||
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
|
||||
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
|
||||
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 config/runner.config.mjs,使用内置默认值)'));
|
||||
log('浏览器 ' + o.binary);
|
||||
log('profile ' + cfg.PROFILE_DIR + '(cookie / localStorage 持久化,删掉即重置登录态与进度缓存)');
|
||||
if (cfg.WANT_VISIBLE && !cfg.VISIBLE) {
|
||||
warn(noDisplayReason() + ',配置里的 headless: false 被忽略,强制无头运行。');
|
||||
}
|
||||
if (!cfg.CHECK_ONLY) {
|
||||
log('日志 ' + cfg.LOG_FILE + '(Ctrl+C 或面板里按 q 结束)');
|
||||
}
|
||||
if (!cfg.TUI && cfg.tuiDisabledReason) log('面板:' + cfg.tuiDisabledReason());
|
||||
tui.set({ phase: '启动中' });
|
||||
if (!cfg.CHECK_ONLY) {
|
||||
// 整个进程只发一次「开始运行」;配了 restartMinutes 时每轮会话重开不再推
|
||||
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
|
||||
await notifyRunStarted(cfg, { log, warn });
|
||||
}
|
||||
|
||||
let attempt = 0;
|
||||
let last = null;
|
||||
let lastNotified = '';
|
||||
|
||||
/**
|
||||
* 收尾 Bark 通知。通知识别键相同的只发一次:配了 restartMinutes 时,
|
||||
* 「今日积分已学完」这类结论会在每一轮重启后原样重复,没必要每小时推一次。
|
||||
* 用户按 Ctrl+C 主动停的不发;自检模式不发。
|
||||
*/
|
||||
const notify = async (result) => {
|
||||
if (stop.stopping || cfg.CHECK_ONLY) return;
|
||||
const key = [result.kind, result.finishReason, result.completed,
|
||||
result.points && result.points.text].join('|');
|
||||
if (key === lastNotified) return;
|
||||
lastNotified = key;
|
||||
await notifyRunFinished(cfg, result, { log, warn });
|
||||
};
|
||||
|
||||
/** 一次会话的结果 → 通知入参:卡死和无进展在退出码里是两种结论,标题也不同 */
|
||||
const finishResult = (s) => ({
|
||||
kind: /没有任何进展/.test((s && s.finishReason) || '') ? 'stalled' : 'done',
|
||||
finishReason: (s && s.finishReason) || '',
|
||||
completed: (s && s.completed) || 0,
|
||||
elapsed: (s && s.elapsed) || 0,
|
||||
points: s && s.points,
|
||||
});
|
||||
|
||||
/** 收尾时先把面板收掉,退出日志和退出码提示才会逐行打印出来 */
|
||||
const finishTui = (phase, tone) => {
|
||||
tui.set({ phase, tone });
|
||||
tui.finish();
|
||||
};
|
||||
|
||||
while (!stop.stopping) {
|
||||
attempt++;
|
||||
if (attempt > 1) log('--- 第 ' + attempt + ' 次尝试 ---');
|
||||
tui.set({ attempt, phase: attempt > 1 ? '重启浏览器' : '启动浏览器', tone: 'info' });
|
||||
try {
|
||||
last = await runSession({ ...o, cfg, tui });
|
||||
if (stop.stopping) break;
|
||||
if (cfg.CHECK_ONLY) break;
|
||||
// 每轮会话自己结束就先推一次:配了 restartMinutes 时进程不会退出,
|
||||
// 只在最终收尾推就等于永远不推。重复结论由 notify() 的识别键挡掉。
|
||||
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
|
||||
await notify(finishResult(last));
|
||||
// 正常结束:配了重启间隔就再来一轮
|
||||
const restartable = cfg.RESTART_MINUTES > 0;
|
||||
if (!restartable) break;
|
||||
log('按 YUN_XUE_TANG_RESTART_MINUTES=' + cfg.RESTART_MINUTES + ' 等待后重新开始…');
|
||||
tui.set({ phase: '等待 ' + cfg.RESTART_MINUTES + ' 分钟后重开', tone: 'ok' });
|
||||
const until = Date.now() + cfg.RESTART_MINUTES * 60000;
|
||||
while (!stop.stopping && Date.now() < until) await sleep(2000);
|
||||
if (stop.stopping) break;
|
||||
cleanStaleSingleton(cfg.PROFILE_DIR);
|
||||
} catch (e) {
|
||||
if (stop.stopping) break;
|
||||
// 会话抛错时内部的收尾代码已被跳过,这里补上:否则浏览器进程会残留、端口被占
|
||||
await disposeActiveSession();
|
||||
error('会话异常:' + (e && e.message ? e.message : e));
|
||||
tui.set({ phase: '会话异常,准备重试', tone: 'error' });
|
||||
// 连登 5 次失败基本都是密码错 / 要验证码,重试没意义,直接用专门的退出码结束
|
||||
if (e && e.message && /连续 \d+ 次登录失败/.test(e.message)) {
|
||||
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
|
||||
await notify({ kind: 'login', finishReason: e.message, completed: 0, elapsed: 0 });
|
||||
finishTui('登录失败,检查账号密码 / 验证码', 'error');
|
||||
return { exitCode: 3, last };
|
||||
}
|
||||
const waitMs = Math.min(RETRY_BASE_MS * attempt, RETRY_MAX_MS);
|
||||
const secs = Math.round(waitMs / 1000);
|
||||
warn('浏览器/连接异常,' + secs + ' 秒后重试(第 ' + attempt + ' 次)');
|
||||
tui.set({ phase: '会话异常,' + secs + ' 秒后重试', tone: 'warn' });
|
||||
await sleep(waitMs);
|
||||
}
|
||||
}
|
||||
|
||||
const stalled = !!(last && /没有任何进展/.test(last.finishReason || ''));
|
||||
const exitCode = cfg.CHECK_ONLY ? (last && last.ok ? 0 : 1) : (stalled ? 1 : 0);
|
||||
// 0 = 正常收尾(预算 / 积分完成 / 无更多课程);1 = 无进展卡死;3 = 连续登录失败
|
||||
const phase = cfg.CHECK_ONLY
|
||||
? (exitCode === 0 ? '自检通过' : '自检失败')
|
||||
: stalled ? '退出:长时间无进展' : '正常收尾';
|
||||
if (last) {
|
||||
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
|
||||
await notify(finishResult(last));
|
||||
}
|
||||
finishTui(phase, exitCode === 0 ? 'ok' : (stalled ? 'warn' : 'error'));
|
||||
|
||||
log('=== 运行器退出 ===');
|
||||
if (last && last.finishReason) log('结束原因:' + last.finishReason);
|
||||
if (cfg.CHECK_ONLY && last) log('自检结果:' + (last.ok ? '通过' : '失败 —— ' + last.reason));
|
||||
// 学习统计只在本次运行内有效(不落盘),退出时在日志里留一行,方便事后回看
|
||||
const studyLine = typeof tui.studySummary === 'function' ? tui.studySummary() : '';
|
||||
if (!cfg.CHECK_ONLY && studyLine) log('本次学习:' + studyLine);
|
||||
|
||||
return { exitCode, last, tui };
|
||||
}
|
||||
-566
@@ -1,566 +0,0 @@
|
||||
// 终端面板(TUI):把无头运行器的状态画成一个会自己刷新的框,代替刷屏的逐行日志。
|
||||
//
|
||||
// 设计约束(都很重要,改之前先看一遍):
|
||||
// 1. 只读:面板不提供暂停 / 改配置之类的操作,唯一按键是 q(或 Ctrl+C)优雅退出。
|
||||
// 「改行为」仍然走配置文件 / 环境变量 / 命令行,面板不制造第二套控制入口。
|
||||
// 2. 不碰日志文件:面板只接管「终端」输出(log.mjs 的控制台 sink),
|
||||
// run-logs/*.log 仍然是纯文本逐行,grep / 采集都不受影响。
|
||||
// 3. 自动降级:stdout 不是交互式终端(重定向到文件、CI、计划任务)时完全不启用,
|
||||
// 行为与旧版逐行日志一模一样(见 config.mjs 的 TUI 判断)。
|
||||
//
|
||||
// 重绘方式:不整屏清空,而是「回到本帧首行重画」——面板上方的启动横幅等历史输出
|
||||
// 仍留在回滚区里。技巧是最后一帧不留结尾换行,光标停在帧尾;下次从帧尾向上移动
|
||||
// (行数-1) 行即回到首行,因此永远不会触发终端滚动、也不会闪烁。
|
||||
import { setConsoleSink } from './log.mjs';
|
||||
import { createStudyTracker } from './study.mjs';
|
||||
|
||||
const ESC = '\x1b[';
|
||||
const RESET = ESC + '0m';
|
||||
/** 保留多少行历史日志(终端再高也只显示其中一部分) */
|
||||
const BUFFER_MAX = 200;
|
||||
/** 标签列宽(「倒计时」这类三字标签也放得下) */
|
||||
const LABEL_W = 7;
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 中文对齐:全角字符占 2 列,直接用 String.length 补空格会把边框顶歪
|
||||
// ---------------------------------------------------------------------------
|
||||
function charWidth(ch) {
|
||||
const cp = ch.codePointAt(0);
|
||||
if (cp === 0 || cp < 32 || (cp >= 0x7f && cp < 0xa0)) return 0;
|
||||
if (cp === 0x2329 || cp === 0x232a) return 2;
|
||||
if (cp >= 0x1100 && cp <= 0x115f) return 2;
|
||||
if (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) return 2;
|
||||
if (cp >= 0xac00 && cp <= 0xd7a3) return 2;
|
||||
if (cp >= 0xf900 && cp <= 0xfaff) return 2;
|
||||
if (cp >= 0xfe30 && cp <= 0xfe6f) return 2;
|
||||
if (cp >= 0xff00 && cp <= 0xff60) return 2;
|
||||
if (cp >= 0xffe0 && cp <= 0xffe6) return 2;
|
||||
if (cp >= 0x1f300 && cp <= 0x1f64f) return 2;
|
||||
if (cp >= 0x1f900 && cp <= 0x1f9ff) return 2;
|
||||
if (cp >= 0x20000 && cp <= 0x3fffd) return 2;
|
||||
return 1;
|
||||
}
|
||||
|
||||
/** 字符串在终端里占几列(ANSI 转义序列不计数) */
|
||||
export function textWidth(s) {
|
||||
let w = 0;
|
||||
for (const ch of stripAnsi(s)) w += charWidth(ch);
|
||||
return w;
|
||||
}
|
||||
|
||||
/** 去掉 ANSI 序列(算可见宽度用) */
|
||||
export function stripAnsi(s) {
|
||||
return String(s).replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
|
||||
}
|
||||
|
||||
const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
|
||||
|
||||
/**
|
||||
* 按可见列宽遍历:回调拿到 (token, width),ANSI 转义序列 width=0。
|
||||
* cut / padEnd 都靠它,否则带颜色的字符串会被当成超宽而错误截断。
|
||||
*/
|
||||
function walkWidth(s, fn) {
|
||||
s = String(s);
|
||||
let i = 0;
|
||||
ANSI_RE.lastIndex = 0;
|
||||
let m;
|
||||
while ((m = ANSI_RE.exec(s))) {
|
||||
for (const ch of s.slice(i, m.index)) fn(ch, charWidth(ch));
|
||||
fn(m[0], 0);
|
||||
i = m.index + m[0].length;
|
||||
}
|
||||
for (const ch of s.slice(i)) fn(ch, charWidth(ch));
|
||||
}
|
||||
|
||||
/** 右侧补空格到指定列宽(ANSI 序列不计数) */
|
||||
function padEnd(s, width) {
|
||||
const gap = width - textWidth(s);
|
||||
return gap > 0 ? String(s) + ' '.repeat(gap) : String(s);
|
||||
}
|
||||
|
||||
/** 截断到指定列宽,被截断时末尾用 … 占位(ANSI 序列不计数,截断后补 reset) */
|
||||
function cut(s, width) {
|
||||
s = String(s);
|
||||
if (width <= 0) return '';
|
||||
const plain = stripAnsi(s);
|
||||
if (textWidth(plain) <= width) return s;
|
||||
let out = '';
|
||||
let w = 0;
|
||||
let truncated = false;
|
||||
walkWidth(s, (tok, cw) => {
|
||||
if (truncated) return;
|
||||
if (cw === 0) { out += tok; return; } // ANSI 序列照常透传
|
||||
if (w + cw > width - 1) { truncated = true; return; }
|
||||
out += tok;
|
||||
w += cw;
|
||||
});
|
||||
return out + '…' + (s.includes('\x1b[') ? '\x1b[0m' : '');
|
||||
}
|
||||
|
||||
/** 秒数 → 01:12:45 / 12:45 */
|
||||
export function formatDuration(sec) {
|
||||
const s = Math.max(0, Math.round(Number(sec) || 0));
|
||||
const h = Math.floor(s / 3600);
|
||||
const two = (n) => String(n).padStart(2, '0');
|
||||
const m = Math.floor((s % 3600) / 60);
|
||||
const r = s % 60;
|
||||
return h > 0 ? h + ':' + two(m) + ':' + two(r) : two(m) + ':' + two(r);
|
||||
}
|
||||
|
||||
/** 进度条:█ / ░ 各占 1 列 */
|
||||
export function progressBar(ratio, width) {
|
||||
const r = Math.max(0, Math.min(1, Number(ratio) || 0));
|
||||
const filled = Math.round(r * width);
|
||||
return '█'.repeat(filled) + '░'.repeat(Math.max(0, width - filled));
|
||||
}
|
||||
|
||||
/**
|
||||
* 一组行在宽度 cols 下实际占的屏幕行数。
|
||||
* 终端在窗口变窄时会把超宽的行自己折成多行,所以「逻辑行数」≠「屏幕行数」;
|
||||
* 回退光标、决定清屏起点都得用这个函数,否则窗口一变就会留下半截面板。
|
||||
* 行宽为 0 时算一行(空白行不折)。
|
||||
*/
|
||||
export function visualRows(widths, cols) {
|
||||
const w = Math.max(1, Number(cols) || 80);
|
||||
let total = 0;
|
||||
for (const raw of widths || []) {
|
||||
const width = Number(raw) || 0;
|
||||
total += Math.max(1, Math.ceil(width / w));
|
||||
}
|
||||
return total;
|
||||
}
|
||||
|
||||
/** ANSI 颜色;关闭时全部退化为恒等函数(NO_COLOR / --no-color) */
|
||||
function makeColors(on) {
|
||||
const wrap = (code) => (s) => (on ? ESC + code + 'm' + s + RESET : String(s));
|
||||
return {
|
||||
bold: wrap('1'), dim: wrap('2'), gray: wrap('90'),
|
||||
red: wrap('31'), green: wrap('32'), yellow: wrap('33'),
|
||||
blue: wrap('34'), magenta: wrap('35'), cyan: wrap('36'),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建面板实例。enabled 为 false 时所有方法都是空操作,
|
||||
* 所以上层(supervisor / session)可以无条件调用 tui.set() / tui.snap()。
|
||||
*
|
||||
* @param {object} opts
|
||||
* @param {boolean} opts.enabled 是否启用(由 config.mjs 按 TTY 判断)
|
||||
* @param {Function} [opts.onQuit] 用户按 q / Ctrl+C 时的回调(接到 stop.mjs 上)
|
||||
* @param {string} [opts.title] 标题
|
||||
* @param {string} [opts.logFile] 日志文件路径(面板里显示)
|
||||
* @param {boolean} [opts.color] 是否用 ANSI 颜色(默认看 NO_COLOR)
|
||||
* @param {object} [opts.out] 输出流(测试用,默认 process.stdout)
|
||||
* @param {object} [opts.stdin] 输入流(测试用,默认 process.stdin)
|
||||
*/
|
||||
export function createTui(opts = {}) {
|
||||
const enabled = !!opts.enabled;
|
||||
const out = opts.out || process.stdout;
|
||||
const stdin = opts.stdin || process.stdin;
|
||||
const onQuit = opts.onQuit || (() => {});
|
||||
const colorOn = enabled && opts.color !== false && !process.env.NO_COLOR;
|
||||
const C = makeColors(colorOn);
|
||||
|
||||
const state = {
|
||||
title: opts.title || '云学堂助手 · 无头运行器',
|
||||
phase: '启动中',
|
||||
tone: 'info', // info / ok / warn / error
|
||||
attempt: 1,
|
||||
course: '',
|
||||
lesson: '',
|
||||
summary: '',
|
||||
countdown: null,
|
||||
completed: 0,
|
||||
doneCount: 0,
|
||||
retryCount: 0,
|
||||
retryWait: 0,
|
||||
lessons: 0,
|
||||
video: null,
|
||||
// 学习统计(只在本次运行内累计,退出清零,不落盘)
|
||||
studySeconds: 0, // 学习时长:只累加视频真正在播的时间
|
||||
creditEarned: 0, // 获得学分:只算本次运行里完成(刷完)的课程
|
||||
credit: null, // 当前课程可得多少学分(平台只在播放期间写在倒计时文案里)
|
||||
points: null, // 每日积分:{ enabled, total, max, progress, text }
|
||||
injected: 0,
|
||||
logFile: opts.logFile || '',
|
||||
startedAt: Date.now(),
|
||||
};
|
||||
|
||||
const buffer = [];
|
||||
// 学时 / 学分累计逻辑在 study.mjs(纯数据,可脱离终端与浏览器单测)
|
||||
const study = createStudyTracker(opts.studyOpts);
|
||||
let timer = null;
|
||||
let resizeTimer = null;
|
||||
let lastLines = 0;
|
||||
// 上一帧每行的「可见列宽」。终端变窄时它会把自己重排(把宽行折成多行),
|
||||
// 所以回退光标时不能只数逻辑行数,得按新宽度算出旧帧实际占了几行。
|
||||
let lastWidths = [];
|
||||
let finished = false;
|
||||
let rawAttached = false;
|
||||
|
||||
// ---------------- 布局 ----------------
|
||||
// 窗口大小每画一帧都重新读:拖动终端、tmux 分屏、浏览器式面板都会改 out.columns / out.rows,
|
||||
// 不做缓存,resize 之后第一帧就是对的。宽度跟终端走(只保留最小 36 列防止破版)。
|
||||
const columns = () => Math.max(36, Number(out.columns) || 80);
|
||||
const rowsOf = () => Math.max(8, Number(out.rows) || 24);
|
||||
|
||||
// 记住上一次实际用过的尺寸。Windows 的 Node 不会在最大化 / 拉伸控制台时发 resize 事件
|
||||
// (libuv 拿不到那边的控制台尺寸变更通知),所以不能只靠事件,必须每次画之前自己比一次。
|
||||
let lastCols = columns();
|
||||
let lastRows = rowsOf();
|
||||
/** 终端尺寸真的变了就记录并报告;缩小需要先清整块(否则旧帧的尾巴会露在框外) */
|
||||
function syncSize() {
|
||||
const cols = columns();
|
||||
const rows = rowsOf();
|
||||
if (cols === lastCols && rows === lastRows) return false;
|
||||
const shrank = cols < lastCols || rows < lastRows;
|
||||
lastCols = cols;
|
||||
lastRows = rows;
|
||||
return shrank;
|
||||
}
|
||||
|
||||
/**
|
||||
* 当前窗口下的行分配。
|
||||
* 矮窗口(<15 行)进紧凑模式:省掉「课时」「日志」两行,先保住视频进度和学时;
|
||||
* 更矮时连日志区和底部 q 提示也省掉——绝不让面板超出窗口,超出会把回滚区里的历史顶掉。
|
||||
*/
|
||||
function layout() {
|
||||
const rows = rowsOf();
|
||||
const compact = rows < 15;
|
||||
const hint = rows >= 10 ? 1 : 0;
|
||||
const infoRows = compact ? 5 : 7; // 状态 / 课程 / 学时 / 视频 / 进度(+ 课时 / 日志)
|
||||
// 1 标题行 + infoRows + 1 分隔行 + room 日志行 + 1 底边框 + hint
|
||||
const slack = rows - (infoRows + 3 + hint);
|
||||
const showLogs = slack >= 1;
|
||||
const room = showLogs ? Math.min(10, slack) : 0;
|
||||
return { rows, compact, hint, showLogs, room };
|
||||
}
|
||||
|
||||
function toneWrap(text) {
|
||||
if (state.tone === 'ok') return C.green(text);
|
||||
if (state.tone === 'warn') return C.yellow(text);
|
||||
if (state.tone === 'error') return C.red(text);
|
||||
return C.cyan(text);
|
||||
}
|
||||
|
||||
function videoValue(width) {
|
||||
const v = state.video;
|
||||
if (!v || !v.d) {
|
||||
if (state.countdown != null) return C.gray('等待视频(倒计时 ' + state.countdown + 's)');
|
||||
return C.gray('—');
|
||||
}
|
||||
const ratio = v.d > 0 ? v.t / v.d : 0;
|
||||
// 窄终端里进度条先缩,仍有地方就按实宽决定加不加时光与状态(不硬截断)
|
||||
const times = formatDuration(v.t) + '/' + formatDuration(v.d);
|
||||
const barW = Math.max(10, Math.min(40, width - 30));
|
||||
const parts = [progressBar(ratio, barW), String(Math.round(ratio * 100)).padStart(3) + '%'];
|
||||
const used = () => textWidth(parts.join(' '));
|
||||
if (used() + 2 + textWidth(times) <= width) parts.push(times);
|
||||
const tail = v.err >= 3 ? C.red('解码失败 error.code=' + v.err) : (v.paused ? C.yellow('暂停') : '');
|
||||
if (tail && used() + 2 + textWidth(tail) <= width) parts.push(tail);
|
||||
return parts.join(' ');
|
||||
}
|
||||
|
||||
function countValue(width) {
|
||||
// 字段按重要性递降:本次/累计是骨架,其余在窄终端里从右往左丢,不硬截断
|
||||
const parts = ['本次 ' + state.completed, '累计 ' + state.doneCount];
|
||||
const extra = [];
|
||||
if (state.lessons) extra.push('课时数 ' + state.lessons);
|
||||
if (state.retryWait > 0) extra.push(C.yellow('等待重试 ' + state.retryWait + 's'));
|
||||
else if (state.retryCount > 0) extra.push(C.yellow('待重试 ' + state.retryCount));
|
||||
if (state.countdown != null) extra.push('倒计时 ' + state.countdown + 's');
|
||||
const used = () => textWidth(parts.join(' · '));
|
||||
for (const item of extra) {
|
||||
if (used() + 3 + textWidth(item) > width) break; // +3 = ' · '
|
||||
parts.push(item);
|
||||
}
|
||||
return parts.join(' · ');
|
||||
}
|
||||
|
||||
function statusValue(valueW) {
|
||||
const plain = state.phase + (state.attempt > 1 ? ' · 第 ' + state.attempt + ' 次尝试' : '');
|
||||
const colored = toneWrap(plain);
|
||||
const elapsed = '已运行 ' + formatDuration((Date.now() - state.startedAt) / 1000);
|
||||
const gap = valueW - textWidth(plain) - textWidth(elapsed);
|
||||
if (gap < 2) return cut(colored + (gap > 0 ? ' '.repeat(gap) : '') + ' ' + elapsed, valueW);
|
||||
return colored + ' '.repeat(gap) + C.gray(elapsed);
|
||||
}
|
||||
|
||||
/**
|
||||
* 「学时」行:本次已学时长 + 本次获得学分。
|
||||
* 时长按视频实际播放累计(排队 / 重试 / 加载不算);
|
||||
* 学分只算真正刷完的课程,且按课程去重。窄终端先丢「本门」再截断。
|
||||
*/
|
||||
function studyValue(width) {
|
||||
const parts = [C.cyan('已学 ' + formatDuration(state.studySeconds))];
|
||||
parts.push(C.green('学分 ' + study.creditText(state.creditEarned)));
|
||||
const used = () => textWidth(parts.join(' · '));
|
||||
if (state.points && state.points.enabled) {
|
||||
const p = '积分 ' + state.points.total + '/' + state.points.max;
|
||||
if (used() + 3 + textWidth(p) <= width) parts.push(C.cyan(p));
|
||||
}
|
||||
if (state.credit != null) {
|
||||
const now = '本门 ' + study.creditText(state.credit);
|
||||
if (used() + 3 + textWidth(now) <= width) parts.push(now);
|
||||
}
|
||||
const tail = state.video && state.video.paused ? C.gray('暂停中,不计时') : '';
|
||||
if (tail && used() + 3 + textWidth(tail) <= width) parts.push(tail);
|
||||
return parts.join(' · ');
|
||||
}
|
||||
|
||||
/** 组装一帧的所有行(含 ANSI 色,宽度已按列算好) */
|
||||
function buildFrame() {
|
||||
const cols = columns();
|
||||
const inner = cols - 4; // "│ " + 内容 + " │"
|
||||
const valueW = inner - LABEL_W;
|
||||
|
||||
const row = (label, value) => {
|
||||
const text = padEnd(cut(value, valueW), valueW);
|
||||
return '│ ' + C.dim(padEnd(label, LABEL_W)) + text + ' │';
|
||||
};
|
||||
|
||||
const { compact, hint, showLogs, room } = layout();
|
||||
|
||||
const lines = [];
|
||||
const title = ' ' + cut(state.title, cols - 8) + ' ';
|
||||
lines.push('╭' + title + '─'.repeat(Math.max(0, cols - 2 - textWidth(title))) + '╮');
|
||||
lines.push(row('状态', statusValue(valueW)));
|
||||
lines.push(row('课程', state.course || (state.phase === '启动中' ? '—' : '列表页 / 未识别')));
|
||||
// 学时紧跟在课程后面:挂机时最关心「学了多久、赚了多少」
|
||||
lines.push(row('学时', studyValue(valueW)));
|
||||
// 紧凑模式先丢「课时」「日志」:视频进度和学时才是挂机时真想看的
|
||||
if (!compact) lines.push(row('课时', [state.lesson || '—', state.summary].filter(Boolean).join(' ')));
|
||||
lines.push(row('视频', videoValue(valueW)));
|
||||
lines.push(row('进度', countValue(valueW)));
|
||||
if (!compact) {
|
||||
lines.push(row('日志', [state.logFile || '(未写日志文件)', '已注入 ' + state.injected + ' 次'].join(' · ')));
|
||||
}
|
||||
|
||||
if (showLogs) {
|
||||
const sec = ' 最近日志 ';
|
||||
lines.push('├' + C.dim(sec) + '─'.repeat(Math.max(0, cols - 2 - textWidth(sec))) + '┤');
|
||||
|
||||
const recent = buffer.slice(-room);
|
||||
const blank = '│' + ' '.repeat(cols - 2) + '│';
|
||||
for (let i = recent.length; i < room; i++) lines.push(blank);
|
||||
for (const line of recent) {
|
||||
lines.push('│ ' + C.dim(padEnd(cut(line, inner), inner)) + ' │');
|
||||
}
|
||||
}
|
||||
|
||||
lines.push('╰' + '─'.repeat(Math.max(0, cols - 2)) + '╯');
|
||||
if (hint) lines.push(C.gray(cut(' q 退出(等价 Ctrl+C:暂停视频、停批量、关浏览器)· 完整日志照常写入日志文件', cols)));
|
||||
return lines;
|
||||
}
|
||||
|
||||
/**
|
||||
* 画一帧。尺寸变了就改跑 redraw():终端变窄 / 变矮时,上一帧更宽或更高的字符
|
||||
* 会露在新框外面,必须先整块清掉;变大时旧帧完全被盖住,直接重画就行。
|
||||
*/
|
||||
function render() {
|
||||
if (!enabled || finished) return;
|
||||
// Windows 控制台最大化 / 拖动时不会发 resize 事件,只能在这里发现变化
|
||||
if (syncSize()) redraw();
|
||||
else paint();
|
||||
}
|
||||
|
||||
function paint() {
|
||||
if (!enabled || finished) return;
|
||||
let lines;
|
||||
try {
|
||||
lines = buildFrame();
|
||||
} catch (e) {
|
||||
return; // 面板自身出错绝不能影响刷课
|
||||
}
|
||||
const cols = columns();
|
||||
const maxRows = rowsOf();
|
||||
if (lines.length > maxRows) lines = lines.slice(0, maxRows);
|
||||
|
||||
// 上一帧在当前宽度下实际占的可视行数(窗口没变时它就等于上帧的逻辑行数)
|
||||
const prevRows = visualRows(lastWidths, cols);
|
||||
let buf = '';
|
||||
// 上一帧光标停在帧尾;向上移动 (可视行数-1) 行即回到本帧首行
|
||||
if (prevRows > 0) {
|
||||
const up = Math.max(0, Math.min(prevRows - 1, maxRows - 1));
|
||||
buf += ESC + up + 'A\r';
|
||||
}
|
||||
for (let i = 0; i < lines.length; i++) {
|
||||
// 行尾清到行末(\x1b[K):终端变窄或日志变短时,上一帧的尾巴不会残留
|
||||
buf += lines[i] + ESC + 'K';
|
||||
if (i < lines.length - 1) buf += '\r\n';
|
||||
}
|
||||
buf += ESC + '0J'; // 本帧下方的内容一并清掉(终端变矮时防残留)
|
||||
try { out.write(buf); } catch (e) { /* ignore */ }
|
||||
lastLines = lines.length;
|
||||
lastWidths = lines.map((l) => textWidth(stripAnsi(l)));
|
||||
}
|
||||
|
||||
/**
|
||||
* 硬重绘:终端尺寸变了之后,上次记的帧行数已经不可信(终端可能还自己重排过),
|
||||
* 所以先把光标拉回块首、清掉整块,再按新尺寸画一帧。
|
||||
* 向上移动的步数取 min(上帧行数-1, 当前行数-1):窗口缩到比上帧还矮时不会被顶出屏幕。
|
||||
*/
|
||||
function redraw() {
|
||||
if (!enabled || finished) return;
|
||||
if (lastWidths.length > 0 || lastLines > 0) {
|
||||
const cols = columns();
|
||||
const maxRows = rowsOf();
|
||||
// 关键:用「旧帧在新宽度下会被折成几行」来回退,而不是旧的逻辑行数。
|
||||
// 最大化后再还原(170 列 → 80 列)时,旧帧每行都被折成两行,
|
||||
// 按逻辑行数退会落在旧面板中间,上半截就永远留在屏幕上了。
|
||||
const folded = visualRows(lastWidths, cols);
|
||||
if (folded - 1 > maxRows - 1) {
|
||||
// 旧帧折行后比整个窗口还高:它的起点已经滚到屏幕上方去了,
|
||||
// 光标最多只能退到第一行,退不到块首。这种情况只能整屏重置——
|
||||
// 先把光标匀回左上角再清掉全屏,然后在顶部重画。
|
||||
// (屏幕上方的历史会没,但那些日志本来就在 run-logs/*.log 里)
|
||||
try { out.write(ESC + 'H' + ESC + '2J'); } catch (e) { /* ignore */ }
|
||||
} else {
|
||||
const up = Math.max(0, folded - 1);
|
||||
try { out.write('\r' + (up > 0 ? ESC + up + 'A' : '') + ESC + '0J'); } catch (e) { /* ignore */ }
|
||||
}
|
||||
lastLines = 0; // 光标已经回到块首,paint 不必再回退
|
||||
lastWidths = [];
|
||||
}
|
||||
paint();
|
||||
}
|
||||
|
||||
// ---------------- 键盘:只认 q / Q / Ctrl+C ----------------
|
||||
function onKey(chunk) {
|
||||
for (const ch of String(chunk)) {
|
||||
if (ch === 'q' || ch === 'Q' || ch === '\u0003') {
|
||||
// 先收面板再走退出流程,退出日志才能正常打在面板下面
|
||||
const reason = ch === '\u0003' ? 'Ctrl+C' : 'q';
|
||||
finish();
|
||||
onQuit(reason);
|
||||
return;
|
||||
}
|
||||
if (ch === '\u000c') redraw(); // Ctrl+L 强制重画(终端被外部输出打乱时用)
|
||||
}
|
||||
}
|
||||
|
||||
function attachInput() {
|
||||
if (!enabled || rawAttached) return;
|
||||
if (!stdin || !stdin.isTTY || typeof stdin.setRawMode !== 'function') return;
|
||||
try {
|
||||
stdin.setRawMode(true);
|
||||
stdin.setEncoding('utf8');
|
||||
stdin.on('data', onKey);
|
||||
stdin.resume();
|
||||
rawAttached = true;
|
||||
} catch (e) {
|
||||
rawAttached = false;
|
||||
}
|
||||
}
|
||||
|
||||
function restoreInput() {
|
||||
if (!rawAttached) return;
|
||||
rawAttached = false;
|
||||
try {
|
||||
stdin.off('data', onKey);
|
||||
stdin.setRawMode(false);
|
||||
stdin.pause();
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
// ---------------- 生命周期 ----------------
|
||||
function finish() {
|
||||
if (!enabled || finished) return;
|
||||
finished = true;
|
||||
if (timer) { clearInterval(timer); timer = null; }
|
||||
if (resizeTimer) { clearTimeout(resizeTimer); resizeTimer = null; }
|
||||
if (typeof out.removeListener === 'function') {
|
||||
out.removeListener('resize', onResize);
|
||||
}
|
||||
restoreInput();
|
||||
setConsoleSink(null); // 终端输出恢复逐行,收尾日志才看得见
|
||||
// 摘掉 exit 监听:supervisor 重试用例里同一进程会建多次面板,不摘会触发 MaxListeners 警告
|
||||
try { process.removeListener('exit', finish); } catch (e) { /* ignore */ }
|
||||
try { out.write('\n' + ESC + '?25h'); } catch (e) { /* ignore */ } // 换行 + 显示光标
|
||||
}
|
||||
|
||||
/**
|
||||
* 窗口尺寸变化:拖拽终端时 resize 事件会连发几十次,去抖后再硬重绘。
|
||||
* 注意这条路径只在支持该事件的平台生效(Linux / macOS / Windows Terminal);
|
||||
* Windows 传统控制台(conhost)拖窗口 / 最大化不会发事件,那种情况靠
|
||||
* render() 里的 syncSize() 在 1 秒内发现。两者取其一即可,都碰到也只是多一次重绘。
|
||||
*/
|
||||
function onResize() {
|
||||
if (resizeTimer) clearTimeout(resizeTimer);
|
||||
resizeTimer = setTimeout(() => {
|
||||
resizeTimer = null;
|
||||
lastCols = columns(); // 事件已经告诉我们尺寸变了,直接记录,避免 syncSize 再判一次
|
||||
lastRows = rowsOf();
|
||||
redraw();
|
||||
}, 60);
|
||||
if (typeof resizeTimer.unref === 'function') resizeTimer.unref();
|
||||
}
|
||||
|
||||
function install() {
|
||||
if (!enabled || finished) return;
|
||||
attachInput();
|
||||
try { out.write(ESC + '?25l'); } catch (e) { /* ignore */ } // 隐藏光标
|
||||
// 终端输出改道到面板日志区;文件日志不受影响(log.mjs 里两路分开写)
|
||||
setConsoleSink((level, text) => {
|
||||
buffer.push(text);
|
||||
if (buffer.length > BUFFER_MAX) buffer.splice(0, buffer.length - BUFFER_MAX);
|
||||
// 警告 / 错误立即重绘,普通信息等下一次定时刷新,避免频繁重绘
|
||||
if (level !== '信息') render();
|
||||
});
|
||||
if (typeof out.on === 'function') out.on('resize', onResize);
|
||||
render();
|
||||
timer = setInterval(render, 1000);
|
||||
if (typeof timer.unref === 'function') timer.unref();
|
||||
if (typeof process.on === 'function') process.on('exit', finish);
|
||||
}
|
||||
|
||||
if (enabled) install();
|
||||
|
||||
return {
|
||||
enabled,
|
||||
/** 合并更新面板状态(enabled=false 时是空操作) */
|
||||
set(patch) {
|
||||
if (enabled && patch) Object.assign(state, patch);
|
||||
},
|
||||
/**
|
||||
* 用 session 的主监控快照刷新面板,顺便累计学习时长与学分(详细规则见 study.mjs)。
|
||||
* 面板关闭时也照常统计:学分明细要拿来发 Bark 通知,不能只在 TTY 下有。
|
||||
* @returns {object|null} study.update() 的结果,含本次新增的学分事件
|
||||
*/
|
||||
snap(s) {
|
||||
if (!s || s.noApi) return null;
|
||||
const pick = (v, d) => (v === undefined ? d : v);
|
||||
const st = study.update(s);
|
||||
if (!enabled) return st;
|
||||
state.studySeconds = st.studySeconds;
|
||||
state.creditEarned = st.creditEarned;
|
||||
state.credit = st.credit;
|
||||
state.points = s.points || null;
|
||||
|
||||
state.course = pick(s.course, '');
|
||||
state.lesson = pick(s.lesson, '');
|
||||
state.summary = (s.summary && s.summary.text) || '';
|
||||
state.countdown = s.countdown == null ? null : s.countdown;
|
||||
state.completed = Number(s.completed) || 0;
|
||||
state.doneCount = pick(s.doneCount, 0);
|
||||
state.retryCount = pick(s.retryCount, 0);
|
||||
state.retryWait = pick(s.retryWait, 0);
|
||||
state.lessons = pick(s.lessons, 0);
|
||||
state.video = s.video || null;
|
||||
return st;
|
||||
},
|
||||
render,
|
||||
redraw,
|
||||
finish,
|
||||
/** 学习统计(收尾日志用,与面板显示同一份数据) */
|
||||
get study() { return study.get(); },
|
||||
/** 学习统计的一句话摘要(没有数据时是空串) */
|
||||
studySummary() { return study.summary(); },
|
||||
/** 当前布局分配(自测里断言矮终端降级用) */
|
||||
get layout() { return layout(); },
|
||||
/** 当前状态快照(自检 / 测试用) */
|
||||
get state() { return { ...state }; },
|
||||
/** 已缓存的终端日志行(测试用) */
|
||||
get logLines() { return buffer.slice(); },
|
||||
};
|
||||
}
|
||||
@@ -1,33 +0,0 @@
|
||||
@echo off
|
||||
rem ---------------------------------------------------------------
|
||||
rem This file must stay PURE ASCII and CRLF (see scripts\start-headless.cmd
|
||||
rem for the full explanation: cmd.exe parses batch files byte-by-byte with
|
||||
rem the current code page, so multi-byte chars / bare LF corrupt line offsets).
|
||||
rem All Chinese messages come from the Node script instead.
|
||||
rem
|
||||
rem Usage:
|
||||
rem scripts\build-docker.cmd build with default tags
|
||||
rem scripts\build-docker.cmd --mirror --check build with CN mirrors, then self-check
|
||||
rem scripts\build-docker.cmd --help list all options
|
||||
rem ---------------------------------------------------------------
|
||||
setlocal
|
||||
chcp 65001 >nul
|
||||
cd /d "%~dp0.."
|
||||
title YunXueTang Assistant - docker build
|
||||
|
||||
where node >nul 2>nul
|
||||
if errorlevel 1 goto no_node
|
||||
|
||||
node "scripts\build-docker.mjs" %*
|
||||
set RC=%ERRORLEVEL%
|
||||
if "%RC%"=="0" exit /b 0
|
||||
|
||||
echo.
|
||||
echo [exit] code %RC% (0 ok 1 build failed 2 env/args problem)
|
||||
pause
|
||||
exit /b %RC%
|
||||
|
||||
:no_node
|
||||
echo [error] node.exe not found. Install Node.js 22+ from https://nodejs.org/
|
||||
pause
|
||||
exit /b 2
|
||||
@@ -1,342 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 构建 Docker 镜像的便捷入口。
|
||||
*
|
||||
* 为什么要有这层脚本,而不是让人手敲 `docker build`:
|
||||
* 1. Dockerfile 里有三个构建参数(APT_MIRROR / NPM_REGISTRY / CHROME_DEB_URL),
|
||||
* 国内机器几乎必须换源才能构建成功,但每次手写 `--build-arg` 又长又容易漏;
|
||||
* 这里统一从命令行、环境变量、.env 三处按优先级取值。
|
||||
* 2. 镜像标签跟着 package.json 的 version 走,顺手再打一个 latest;
|
||||
* 版本号只在 package.json 维护一处,不靠人记。
|
||||
* 3. 构建完能直接 `--check`(只读自检:不登录、不动进度),一步验证镜像真的能起来。
|
||||
*
|
||||
* 用法:
|
||||
* npm run docker:build # 默认标签 = 包里版本号 + latest
|
||||
* npm run docker:build -- --mirror # 一键换国内源(apt 清华 + npm npmmirror)
|
||||
* npm run docker:build -- --check # 构建完立刻跑一次 --check 自检
|
||||
* npm run docker:build -- --tag my/yxt:dev # 只打指定标签
|
||||
* npm run docker:build -- --dry-run # 只打印将要执行的 docker 命令
|
||||
* npm run docker:build -- --help
|
||||
*
|
||||
* 退出码与仓库其它脚本保持一致:0 成功 / 1 构建失败 / 2 环境或参数问题。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
||||
|
||||
/** 国内常用镜像源预设(--mirror 一键套用);Chrome 的 deb 没有公认镜像,只能由使用者用 --chrome-url 指定 */
|
||||
const MIRROR_PRESET = {
|
||||
apt: 'mirrors.tuna.tsinghua.edu.cn',
|
||||
npm: 'https://registry.npmmirror.com',
|
||||
};
|
||||
|
||||
const HELP = `构建云学堂助手 Docker 镜像
|
||||
|
||||
用法:node scripts/build-docker.mjs [选项]
|
||||
|
||||
选项:
|
||||
-t, --tag <名称:标签> 镜像标签;可重复给多次。默认 <包名>:<package.json 版本> 加 <包名>:latest
|
||||
--mirror 一键套用国内镜像源(apt = ${MIRROR_PRESET.apt},npm = ${MIRROR_PRESET.npm})
|
||||
--apt-mirror <host> Debian 源地址,对应 Dockerfile 的 APT_MIRROR
|
||||
--npm-registry <url> npm 源地址,对应 NPM_REGISTRY
|
||||
--chrome-url <url> Chrome deb 直链,对应 CHROME_DEB_URL(国内下不动 dl.google.com 时用)
|
||||
--platform <平台> 如 linux/amd64、linux/arm64(默认用构建机架构)
|
||||
--build-arg <K=V> 透传任意额外构建参数,可重复
|
||||
--no-cache 不用构建缓存
|
||||
--pull 先拉取最新的基础镜像
|
||||
--check 构建成功后跑一次 \`docker run --rm <镜像> --check\` 自检
|
||||
--dry-run 只打印 docker 命令,不真正构建
|
||||
-h, --help 显示本帮助
|
||||
|
||||
取值优先级:命令行 > 同名环境变量 > 仓库根目录 .env > 默认值
|
||||
(只从 .env 读 APT_MIRROR / NPM_REGISTRY / CHROME_DEB_URL 三个键,凭据类变量一律不读)
|
||||
|
||||
示例:
|
||||
node scripts/build-docker.mjs --mirror --check
|
||||
node scripts/build-docker.mjs -t yun-xue-tang-assistant:test --no-cache
|
||||
APT_MIRROR=mirrors.aliyun.com node scripts/build-docker.mjs
|
||||
`;
|
||||
|
||||
/** 解析成 { options, error } —— 手写解析而非引入依赖,仓库唯一的 devDependency 是 esbuild */
|
||||
function parseArgs(argv) {
|
||||
const opts = {
|
||||
tags: [],
|
||||
mirror: false,
|
||||
aptMirror: '',
|
||||
npmRegistry: '',
|
||||
chromeUrl: '',
|
||||
platform: '',
|
||||
buildArgs: [],
|
||||
noCache: false,
|
||||
pull: false,
|
||||
check: false,
|
||||
dryRun: false,
|
||||
help: false,
|
||||
};
|
||||
|
||||
const needValue = (i, name) => {
|
||||
const v = argv[i + 1];
|
||||
if (v === undefined || v.startsWith('-')) {
|
||||
throw new Error(`选项 ${name} 需要一个值`);
|
||||
}
|
||||
return v;
|
||||
};
|
||||
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const arg = argv[i];
|
||||
// 支持 --key=value 与 --key value 两种写法
|
||||
const eq = arg.indexOf('=');
|
||||
const key = arg.startsWith('--') && eq > 0 ? arg.slice(0, eq) : arg;
|
||||
const inline = arg.startsWith('--') && eq > 0 ? arg.slice(eq + 1) : null;
|
||||
const take = (name) => (inline !== null ? inline : needValue(i, name));
|
||||
const takeAndSkip = (name) => {
|
||||
const v = take(name);
|
||||
if (inline === null) i++;
|
||||
return v;
|
||||
};
|
||||
|
||||
switch (key) {
|
||||
case '-t':
|
||||
case '--tag': {
|
||||
const v = takeAndSkip(key);
|
||||
if (!v.trim()) throw new Error('镜像标签不能为空');
|
||||
opts.tags.push(v.trim());
|
||||
break;
|
||||
}
|
||||
case '--mirror':
|
||||
opts.mirror = true;
|
||||
break;
|
||||
case '--apt-mirror':
|
||||
opts.aptMirror = takeAndSkip(key);
|
||||
break;
|
||||
case '--npm-registry':
|
||||
opts.npmRegistry = takeAndSkip(key);
|
||||
break;
|
||||
case '--chrome-url':
|
||||
opts.chromeUrl = takeAndSkip(key);
|
||||
break;
|
||||
case '--platform':
|
||||
opts.platform = takeAndSkip(key);
|
||||
break;
|
||||
case '--build-arg':
|
||||
opts.buildArgs.push(takeAndSkip(key));
|
||||
break;
|
||||
case '--no-cache':
|
||||
opts.noCache = true;
|
||||
break;
|
||||
case '--pull':
|
||||
opts.pull = true;
|
||||
break;
|
||||
case '--check':
|
||||
opts.check = true;
|
||||
break;
|
||||
case '--dry-run':
|
||||
opts.dryRun = true;
|
||||
break;
|
||||
case '-h':
|
||||
case '--help':
|
||||
opts.help = true;
|
||||
break;
|
||||
default:
|
||||
throw new Error(`未知选项:${arg}`);
|
||||
}
|
||||
}
|
||||
return opts;
|
||||
}
|
||||
|
||||
/** 极简 .env 解析:只认 KEY=VALUE / KEY="VALUE",忽略注释与空行 */
|
||||
function readDotEnv(file) {
|
||||
const out = {};
|
||||
if (!fs.existsSync(file)) return out;
|
||||
let text = '';
|
||||
try {
|
||||
text = fs.readFileSync(file, 'utf8');
|
||||
} catch {
|
||||
return out;
|
||||
}
|
||||
for (const raw of text.split(/\r?\n/)) {
|
||||
const line = raw.trim();
|
||||
if (!line || line.startsWith('#')) continue;
|
||||
const m = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
|
||||
if (!m) continue;
|
||||
let v = m[2].trim();
|
||||
if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
|
||||
v = v.slice(1, -1);
|
||||
}
|
||||
out[m[1]] = v;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function readPackage(file) {
|
||||
try {
|
||||
return JSON.parse(fs.readFileSync(file, 'utf8'));
|
||||
} catch (e) {
|
||||
throw new Error(`读不出 ${path.relative(ROOT, file)}:${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** 把参数数组还原成可以直接粘进终端的命令行(仅用于日志展示) */
|
||||
function quote(argv) {
|
||||
return argv
|
||||
.map((a) => (/^[\w@%+=:,./-]+$/.test(a) ? a : `'${a.replace(/'/g, `'\\''`)}'`))
|
||||
.join(' ');
|
||||
}
|
||||
|
||||
function run(cmd, args, { capture = false } = {}) {
|
||||
return spawnSync(cmd, args, {
|
||||
cwd: ROOT,
|
||||
stdio: capture ? ['ignore', 'pipe', 'pipe'] : 'inherit',
|
||||
encoding: 'utf8',
|
||||
});
|
||||
}
|
||||
|
||||
function main() {
|
||||
let opts;
|
||||
try {
|
||||
opts = parseArgs(process.argv.slice(2));
|
||||
} catch (e) {
|
||||
console.error('[错误] ' + e.message);
|
||||
console.error('用 --help 查看用法。');
|
||||
return 2;
|
||||
}
|
||||
|
||||
if (opts.help) {
|
||||
process.stdout.write(HELP);
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (!fs.existsSync(path.join(ROOT, 'Dockerfile'))) {
|
||||
console.error('[错误] 找不到 Dockerfile,请在仓库根目录运行。');
|
||||
return 2;
|
||||
}
|
||||
|
||||
// ---- 1. 检查 docker 是否可用(CLI 缺失和守护进程没起来,处理方式完全不同,分开报) ----
|
||||
// --dry-run 只打印命令、不真的构建,所以这里只警告不拦截,方便在没有 docker 的机器上预览
|
||||
const cli = run('docker', ['--version'], { capture: true });
|
||||
const cliOk = !cli.error && cli.status === 0;
|
||||
if (!cliOk) {
|
||||
const msg = '找不到可用的 docker 命令,请先安装 Docker Desktop / Docker Engine。';
|
||||
if (!opts.dryRun) {
|
||||
console.error('[错误] ' + msg);
|
||||
if (cli.stderr) console.error(String(cli.stderr).trim());
|
||||
return 2;
|
||||
}
|
||||
console.log('[警告] ' + msg + '(dry-run 继续)');
|
||||
} else {
|
||||
console.log('[环境] ' + String(cli.stdout).trim());
|
||||
}
|
||||
|
||||
// 守护进程没启动时,docker build 会报一长串语焉不详的连接错误,这里提前拦下
|
||||
if (cliOk) {
|
||||
const daemon = run('docker', ['info', '--format', '{{.ServerVersion}}'], { capture: true });
|
||||
if (daemon.status !== 0) {
|
||||
const detail = String(daemon.stderr || '').trim();
|
||||
if (!opts.dryRun) {
|
||||
console.error('[错误] docker 守护进程未运行(Docker Desktop 没启动 / 当前用户没权限连 socket)。');
|
||||
if (detail) console.error(detail);
|
||||
return 2;
|
||||
}
|
||||
console.log('[警告] docker 守护进程未运行(dry-run 继续)');
|
||||
} else {
|
||||
console.log('[环境] 守护进程 ' + String(daemon.stdout).trim());
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 2. 收集构建参数:命令行 > 环境变量 > .env > 默认 ----
|
||||
const pkg = readPackage(path.join(ROOT, 'package.json'));
|
||||
const dotenv = readDotEnv(path.join(ROOT, '.env'));
|
||||
const pick = (cliValue, envKey) =>
|
||||
cliValue || process.env[envKey] || dotenv[envKey] || '';
|
||||
|
||||
let aptMirror = pick(opts.aptMirror, 'APT_MIRROR');
|
||||
let npmRegistry = pick(opts.npmRegistry, 'NPM_REGISTRY');
|
||||
const chromeUrl = pick(opts.chromeUrl, 'CHROME_DEB_URL');
|
||||
if (opts.mirror) {
|
||||
// --mirror 只填空位,不覆盖使用者显式给的值
|
||||
if (!aptMirror) aptMirror = MIRROR_PRESET.apt;
|
||||
if (!npmRegistry) npmRegistry = MIRROR_PRESET.npm;
|
||||
}
|
||||
|
||||
const buildArgs = [];
|
||||
if (aptMirror) buildArgs.push('--build-arg', 'APT_MIRROR=' + aptMirror);
|
||||
if (npmRegistry) buildArgs.push('--build-arg', 'NPM_REGISTRY=' + npmRegistry);
|
||||
if (chromeUrl) buildArgs.push('--build-arg', 'CHROME_DEB_URL=' + chromeUrl);
|
||||
// 额外的 --build-arg 放最后,允许覆盖上面的预设
|
||||
for (const kv of opts.buildArgs) buildArgs.push('--build-arg', kv);
|
||||
|
||||
// ---- 3. 标签:没给就按 package.json 的版本号打 version + latest ----
|
||||
const repoName = (pkg.name || 'yun-xue-tang-assistant').toLowerCase();
|
||||
const version = pkg.version || 'dev';
|
||||
const tags = opts.tags.length ? opts.tags : [`${repoName}:${version}`, `${repoName}:latest`];
|
||||
|
||||
const args = ['build'];
|
||||
if (opts.platform) args.push('--platform', opts.platform);
|
||||
if (opts.noCache) args.push('--no-cache');
|
||||
if (opts.pull) args.push('--pull');
|
||||
for (const t of tags) args.push('-t', t);
|
||||
args.push(...buildArgs, '.');
|
||||
|
||||
const cmdline = 'docker ' + quote(args);
|
||||
console.log('[构建] 镜像标签:' + tags.join('、'));
|
||||
console.log('[构建] 上下文:' + ROOT);
|
||||
if (aptMirror) console.log('[构建] APT_MIRROR = ' + aptMirror);
|
||||
if (npmRegistry) console.log('[构建] NPM_REGISTRY = ' + npmRegistry);
|
||||
if (chromeUrl) console.log('[构建] CHROME_DEB_URL= ' + chromeUrl);
|
||||
if (!chromeUrl) console.log('[构建] CHROME_DEB_URL 未指定,将从 dl.google.com 下载(国内网络可能失败,见 README 常见问题)');
|
||||
console.log('[构建] 命令:' + cmdline);
|
||||
console.log('[构建] 首次构建约 3-5 分钟(主要是下 Chrome 的 deb),后续走缓存会快很多。\n');
|
||||
|
||||
if (opts.dryRun) {
|
||||
console.log('[dry-run] 未执行构建。');
|
||||
return 0;
|
||||
}
|
||||
|
||||
// ---- 4. 真正构建 ----
|
||||
const build = run('docker', args);
|
||||
if (build.error) {
|
||||
console.error('[错误] 启动 docker build 失败:' + build.error.message);
|
||||
return 2;
|
||||
}
|
||||
if (build.status !== 0) {
|
||||
console.error('\n[失败] 构建未通过(退出码 ' + build.status + ')。常见原因:');
|
||||
console.error(' · 拉不到 Chrome deb → 加 --chrome-url <你的镜像地址>,或先配好代理');
|
||||
console.error(' · apt / npm 太慢 → 加 --mirror 换国内源');
|
||||
console.error(' · 依赖变了但缓存没失效 → 加 --no-cache 重来一次');
|
||||
return 1;
|
||||
}
|
||||
|
||||
const primary = tags[0];
|
||||
console.log('\n[完成] 已构建:' + tags.join('、'));
|
||||
|
||||
// ---- 5. 可选自检:只读,不登录、不动课程进度,用来确认镜像真的能起来 ----
|
||||
if (opts.check) {
|
||||
console.log('[自检] 运行 docker run --rm ' + primary + ' --check ...\n');
|
||||
const chk = run('docker', ['run', '--rm', primary, '--check']);
|
||||
if (chk.status !== 0) {
|
||||
console.error('\n[失败] 镜像自检未通过(退出码 ' + chk.status + ')。');
|
||||
return 1;
|
||||
}
|
||||
console.log('\n[自检] 通过:镜像内的 Node、Chrome、构建产物都可用。');
|
||||
}
|
||||
|
||||
console.log(`
|
||||
下一步:
|
||||
# 自检(不需要账号,只读)
|
||||
docker run --rm ${primary} --check
|
||||
|
||||
# 正式刷课(凭据只走环境变量,别写进镜像)
|
||||
docker run -d --name yun-xue-tang \\
|
||||
-e YUN_XUE_TANG_USR='账号' -e YUN_XUE_TANG_PWD='密码' \\
|
||||
-v "$PWD/.run-profile:/app/.run-profile" -v "$PWD/run-logs:/app/run-logs" \\
|
||||
--shm-size=512m --restart on-failure:3 ${primary}
|
||||
|
||||
# 或用 compose(账号写在 .env 里):cp .env.example .env && docker compose up -d
|
||||
`);
|
||||
return 0;
|
||||
}
|
||||
|
||||
process.exit(main());
|
||||
@@ -1,11 +0,0 @@
|
||||
#!/bin/sh
|
||||
# 构建 Docker 镜像的薄封装(Linux / macOS 用)。
|
||||
# 所有逻辑都在 scripts/build-docker.mjs 里,这里只负责切到仓库根目录再转交。
|
||||
#
|
||||
# ./scripts/build-docker.sh 默认标签
|
||||
# ./scripts/build-docker.sh --mirror --check 国内源 + 构建后自检
|
||||
# ./scripts/build-docker.sh --help
|
||||
set -e
|
||||
ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
|
||||
cd "$ROOT"
|
||||
exec node scripts/build-docker.mjs "$@"
|
||||
@@ -1,69 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 用 esbuild 把 src/ 下的模块打包成单个 Tampermonkey 脚本。
|
||||
*
|
||||
* 产物:仓库根目录的 yun-xue-tang-assistant.user.js(与拆分前的文件名完全一致,
|
||||
* 因此 dev/serve.mjs、dev/dev-loader.user.js 热加载链路无需任何改动)。
|
||||
*
|
||||
* 用法:
|
||||
* npm run build 一次性打包
|
||||
* npm run build:watch 监听 src/ 自动重新打包(配合热加载器,保存即生效)
|
||||
* node scripts/build.mjs --minify 压缩产物(发布用)
|
||||
*/
|
||||
import esbuild from 'esbuild';
|
||||
import path from 'node:path';
|
||||
import { readFile, stat } from 'node:fs/promises';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
// 本文件在 scripts/ 下,仓库根目录是它的上一级
|
||||
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
||||
const SRC_DIR = path.join(ROOT, 'src');
|
||||
const ENTRY = path.join(SRC_DIR, 'index.js');
|
||||
const META = path.join(SRC_DIR, 'meta.js');
|
||||
const OUT = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
|
||||
|
||||
// 版本号只有 package.json 一个来源:banner 的 @version 与 config.js 的 VERSION 都由它生成
|
||||
const { version } = JSON.parse(await readFile(path.join(ROOT, 'package.json'), 'utf8'));
|
||||
|
||||
const args = process.argv.slice(2);
|
||||
const watch = args.includes('--watch');
|
||||
const minify = args.includes('--minify');
|
||||
|
||||
const common = {
|
||||
entryPoints: [ENTRY],
|
||||
bundle: true,
|
||||
format: 'iife',
|
||||
target: ['chrome80', 'firefox78', 'safari13'],
|
||||
minify,
|
||||
charset: 'utf8',
|
||||
// __YUN_XUE_TANG_VERSION__ 由 src/config.js 引用,构建时替换成 package.json 的版本号
|
||||
define: { __YUN_XUE_TANG_VERSION__: JSON.stringify(version) },
|
||||
// 用原生 import/export + format=iife,esbuild 不会注入 __export 等辅助代码。
|
||||
logLevel: 'info',
|
||||
};
|
||||
|
||||
// src/meta.js 里的 @version 写成 __YUN_XUE_TANG_VERSION__,由这里按 package.json 替换
|
||||
async function bannerText() {
|
||||
const raw = await readFile(META, 'utf8');
|
||||
return raw.replace('__YUN_XUE_TANG_VERSION__', version).trimEnd() + '\n';
|
||||
}
|
||||
|
||||
const buildOptions = (banner) => ({ ...common, banner: { js: banner }, outfile: OUT });
|
||||
|
||||
async function runOnce() {
|
||||
const startedAt = Date.now();
|
||||
await esbuild.build(buildOptions(await bannerText()));
|
||||
const size = (await stat(OUT)).size;
|
||||
console.log(`[build] 已生成 ${OUT}(${size} 字节 / ${(size / 1024).toFixed(1)} KB)${minify ? '(压缩)' : ''},耗时 ${Date.now() - startedAt}ms`);
|
||||
}
|
||||
|
||||
async function runWatch() {
|
||||
const ctx = await esbuild.context(buildOptions(await bannerText()));
|
||||
await ctx.watch();
|
||||
console.log('[build] 监听中:保存 src/ 下的文件即自动重新打包(dev 服务会感知哈希变化)');
|
||||
}
|
||||
|
||||
(watch ? runWatch() : runOnce()).catch((e) => {
|
||||
console.error('[build] 失败:', e);
|
||||
process.exit(1);
|
||||
});
|
||||
@@ -1,143 +0,0 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 静态检查:对仓库里会直接 `node` 执行的脚本跑 `node --check`,
|
||||
* 并对批处理文件做两项硬性检查(这两项一旦坏掉就极难排查):
|
||||
* 1. 必须是纯 ASCII —— cmd.exe 按当前代码页逐字节读批处理,
|
||||
* 多字节字符(中文)会让行偏移错位,报出 "'鍏?npm' is not recognized" 这种怪错;
|
||||
* 2. 必须用 CRLF 行尾 —— 只有 LF 时 cmd.exe 会把上一行的尾部当成命令的一部分,
|
||||
* 同样报出莫名其妙的 "'01' is not recognized"。
|
||||
*
|
||||
* 以前 package.json 的 check 脚本是一长串 `node --check a && node --check b && …`,
|
||||
* 每次新增模块都要手改那行命令(漏了就默默不检查)。现在改为自动遍历目录。
|
||||
*
|
||||
* 用法:npm run check
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
||||
/** 要遍历的目录(JS 与 bat 一起收;scripts/ 也在里面,含本文件自己) */
|
||||
const DIRS = ['runner', 'dev', 'scripts', 'config', 'docker'];
|
||||
/** 顶层要单独检查的文件(构建产物不入源码校验,它在 scripts/ 下重新生成后自然被覆盖) */
|
||||
const FILES = ['yun-xue-tang-assistant.user.js'];
|
||||
const SKIP_DIRS = new Set(['node_modules', '.git', '.run-profile', 'run-logs', '.run-tmp']);
|
||||
|
||||
function walk(dir, out = []) {
|
||||
for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
|
||||
const p = path.join(dir, ent.name);
|
||||
if (ent.isDirectory()) {
|
||||
if (!SKIP_DIRS.has(ent.name)) walk(p, out);
|
||||
} else if (/\.m?js$|\.cmd$|\.bat$|\.sh$/i.test(ent.name)) {
|
||||
out.push(p);
|
||||
}
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
const jsTargets = [];
|
||||
const cmdTargets = [];
|
||||
const shTargets = [];
|
||||
for (const d of DIRS) {
|
||||
const dir = path.join(ROOT, d);
|
||||
if (fs.existsSync(dir)) {
|
||||
for (const f of walk(dir)) {
|
||||
if (/\.m?js$/.test(f)) jsTargets.push(f);
|
||||
else if (/\.sh$/i.test(f)) shTargets.push(f);
|
||||
else cmdTargets.push(f);
|
||||
}
|
||||
}
|
||||
}
|
||||
for (const f of FILES) {
|
||||
const p = path.join(ROOT, f);
|
||||
if (fs.existsSync(p)) jsTargets.push(p);
|
||||
}
|
||||
|
||||
let failed = 0;
|
||||
|
||||
// ---- 1. JS 语法 ----
|
||||
for (const file of jsTargets.sort()) {
|
||||
const r = spawnSync(process.execPath, ['--check', file], { encoding: 'utf8' });
|
||||
if (r.status !== 0) {
|
||||
failed++;
|
||||
console.error(' FAIL ' + path.relative(ROOT, file));
|
||||
console.error((r.stderr || '').trim());
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 2. 批处理文件:纯 ASCII + CRLF ----
|
||||
for (const file of cmdTargets.sort()) {
|
||||
const rel = path.relative(ROOT, file);
|
||||
const buf = fs.readFileSync(file);
|
||||
const bad = [];
|
||||
|
||||
const nonAscii = [];
|
||||
for (let i = 0; i < buf.length; i++) {
|
||||
if (buf[i] > 0x7f) nonAscii.push(i);
|
||||
}
|
||||
if (nonAscii.length) {
|
||||
const first = nonAscii[0];
|
||||
const ctx = buf.slice(Math.max(0, first - 20), first + 20).toString('utf8');
|
||||
bad.push('含 ' + nonAscii.length + ' 个非 ASCII 字节(首次出现在偏移 ' + first + ',上下文 “' + ctx + '”);'
|
||||
+ 'cmd.exe 按代码页逐字节读取,中文会让行偏移错位');
|
||||
}
|
||||
|
||||
let lf = 0;
|
||||
let crlf = 0;
|
||||
let loneCr = 0;
|
||||
for (let i = 0; i < buf.length; i++) {
|
||||
if (buf[i] === 0x0a) {
|
||||
lf++;
|
||||
if (i > 0 && buf[i - 1] === 0x0d) crlf++;
|
||||
} else if (buf[i] === 0x0d && buf[i + 1] !== 0x0a) {
|
||||
loneCr++;
|
||||
}
|
||||
}
|
||||
// 裸 CR(不是 CRLF 的一部分)会把下一个字符吃掉:'config\runner' 里的反斜杠
|
||||
// 曾经变成 CR,报“configunner.config.mjs not found”
|
||||
if (loneCr) {
|
||||
bad.push('有 ' + loneCr + ' 处裸 CR(不是 CRLF 的 CR);'
|
||||
+ '它会吞掉后面的字符,例如 config\\runner 变成 config<CR>unner');
|
||||
}
|
||||
if (lf !== crlf) {
|
||||
bad.push('有 ' + (lf - crlf) + ' 处裸 LF 行尾(共 ' + lf + ' 个 LF / ' + crlf + ' 个 CRLF);'
|
||||
+ 'cmd.exe 会把上一行尾部当成命令的一部分');
|
||||
}
|
||||
|
||||
if (bad.length) {
|
||||
failed++;
|
||||
console.error(' FAIL ' + rel);
|
||||
for (const b of bad) console.error(' - ' + b);
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 3. 容器入口脚本:sh -n 语法 + 必须是 LF 行尾 ----
|
||||
// 容器的 entrypoint 若带 CRLF,shebang 会变成 "/bin/sh\r",直接报 exec format error。
|
||||
// Windows 上不一定有 sh(纯 CMD / PowerShell 环境),找不到就跳过语法检查,但行尾照样校验。
|
||||
const hasSh = spawnSync('sh', ['-c', 'exit 0'], { stdio: 'ignore' }).status === 0;
|
||||
for (const file of shTargets.sort()) {
|
||||
const rel = path.relative(ROOT, file);
|
||||
const buf = fs.readFileSync(file);
|
||||
const bad = [];
|
||||
const crlf = buf.indexOf('\r\n') >= 0;
|
||||
if (crlf) bad.push('含 CRLF 行尾;容器里的 sh 会把 shebang 读成 "/bin/sh\\r" 而报 exec format error');
|
||||
if (hasSh) {
|
||||
const r = spawnSync('sh', ['-n', file], { encoding: 'utf8' });
|
||||
if (r.status !== 0) bad.push((r.stderr || '').trim());
|
||||
}
|
||||
if (bad.length) {
|
||||
failed++;
|
||||
console.error(' FAIL ' + rel);
|
||||
for (const b of bad) console.error(' - ' + b);
|
||||
}
|
||||
}
|
||||
|
||||
const total = jsTargets.length + cmdTargets.length + shTargets.length;
|
||||
if (failed) {
|
||||
console.error('\n静态检查:' + failed + '/' + total + ' 个文件失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('静态检查:' + total + '/' + total + ' 个文件通过'
|
||||
+ '(JS ' + jsTargets.length + ' · 批处理 ' + cmdTargets.length
|
||||
+ ' · 容器入口 ' + shTargets.length + (hasSh ? '' : '(当前环境无 sh,仅校验行尾)') + ')');
|
||||
@@ -1,15 +0,0 @@
|
||||
@echo off
|
||||
rem NOTE: keep this file PURE ASCII, see scripts\start-headless.cmd for why.
|
||||
rem (cmd.exe parses batch files byte-by-byte with the current code page;
|
||||
rem multi-byte characters corrupt line offsets.)
|
||||
chcp 65001 >nul
|
||||
cd /d "%~dp0.."
|
||||
title YXT Cruise - dev server
|
||||
where node >nul 2>nul
|
||||
if errorlevel 1 (
|
||||
echo [error] node.exe not found. Install Node.js from https://nodejs.org/
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
node "%~dp0..\dev\serve.mjs" %*
|
||||
if errorlevel 1 pause
|
||||
@@ -1,60 +0,0 @@
|
||||
@echo off
|
||||
rem ---------------------------------------------------------------
|
||||
rem This file must stay PURE ASCII.
|
||||
rem cmd.exe reads batch files byte-by-byte with the current code page;
|
||||
rem multi-byte characters (e.g. Chinese) corrupt line offsets and make
|
||||
rem it report nonsense like "'npm' is not recognized".
|
||||
rem All Chinese messages come from the Node runner output instead.
|
||||
rem
|
||||
rem Usage:
|
||||
rem scripts\start-headless.cmd use config\runner.config.mjs
|
||||
rem scripts\start-headless.cmd --help print all options
|
||||
rem scripts\start-headless.cmd --budget-minutes 15 command line overrides config file
|
||||
rem ---------------------------------------------------------------
|
||||
setlocal
|
||||
chcp 65001 >nul
|
||||
cd /d "%~dp0.."
|
||||
title YunXueTang Assistant - headless runner
|
||||
|
||||
where node >nul 2>nul
|
||||
if errorlevel 1 goto no_node
|
||||
|
||||
if exist "yun-xue-tang-assistant.user.js" goto have_build
|
||||
echo [build] build output not found, running npm run build ...
|
||||
call npm run build
|
||||
if errorlevel 1 goto build_fail
|
||||
|
||||
:have_build
|
||||
if not exist "config\runner.config.mjs" goto no_config
|
||||
echo [config] config\runner.config.mjs found, editing it is enough (no rebuild needed)
|
||||
goto run
|
||||
|
||||
:no_config
|
||||
echo [warn] config\runner.config.mjs not found, built-in defaults will be used
|
||||
|
||||
:run
|
||||
echo [run] headless runner starting, press Ctrl+C to stop
|
||||
echo.
|
||||
node "runner/headless.mjs" %*
|
||||
set RC=%ERRORLEVEL%
|
||||
|
||||
if "%RC%"=="0" goto done
|
||||
echo.
|
||||
echo [exit] code %RC%
|
||||
echo 0 finished 1 no progress 2 env/args error 3 login failed
|
||||
echo full log: run-logs\headless.log
|
||||
pause
|
||||
exit /b %RC%
|
||||
|
||||
:done
|
||||
exit /b 0
|
||||
|
||||
:no_node
|
||||
echo [error] node.exe not found. Install Node.js 22+ from https://nodejs.org/
|
||||
pause
|
||||
exit /b 1
|
||||
|
||||
:build_fail
|
||||
echo [error] build failed. Run npm install first.
|
||||
pause
|
||||
exit /b 1
|
||||
-153
@@ -1,153 +0,0 @@
|
||||
// ======== 完成 / 未完成 ========
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, saveRunState, invalidateShortCatalog, PHASE_IDLE } from './state.js';
|
||||
import { goToList } from './route.js';
|
||||
import { later } from './lifecycle.js';
|
||||
import { truncate, isGenericCourseTitle, norm } from './utils.js';
|
||||
import { setStatus, updatePanel } from './panel.js';
|
||||
import { courseTitle, pauseAllMedia } from './player.js';
|
||||
|
||||
// 取本次要记录的课程名:优先用队列里启动时抓到的真课程名,
|
||||
// 不要在切页瞬间用页面标题(会变成「在线课堂」这类占位文案,
|
||||
// 导致 completedTitles 记错名、下轮又重复进同一门课)。
|
||||
function recordTitle() {
|
||||
const queued = S.activeCourse ? S.activeCourse.title : '';
|
||||
if (queued && !isGenericCourseTitle(queued)) return queued;
|
||||
const page = courseTitle();
|
||||
if (page && !isGenericCourseTitle(page)) return page;
|
||||
return queued || page;
|
||||
}
|
||||
|
||||
// 这门课本轮已试过几次(按标题归一化后的键,同名课程共用一条记录)
|
||||
export function retryCount(title) {
|
||||
const t = norm(title);
|
||||
if (!t) return 0;
|
||||
const rec = (S.courseRetries || {})[t];
|
||||
return rec && rec.n ? rec.n : 0;
|
||||
}
|
||||
|
||||
export function completeCurrent() {
|
||||
const title = recordTitle();
|
||||
if (title) {
|
||||
S.completedTitles[title] = Date.now();
|
||||
delete S.courseRetries[norm(title)];
|
||||
}
|
||||
S.completedThisRun = (S.completedThisRun || 0) + 1;
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = true;
|
||||
saveRunState();
|
||||
R.doneLatchKey = '';
|
||||
R.lastSummary = null;
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
// 完成一门就丢掉时长队列:下一轮重新调列表接口拿平台实时状态
|
||||
invalidateShortCatalog();
|
||||
// 平台在完成后会把播放器重置到 0 秒,先暂停,避免又从头播一遍
|
||||
pauseAllMedia();
|
||||
|
||||
console.log(TAG, '课程完成:', title, '第', S.completedThisRun, '门,返回列表选下一门');
|
||||
// 不按门数设上限:每日积分模式由 pointsDone() 决定何时收尾,
|
||||
// 一门课只有考试、没产出积分时也要继续找下一门。
|
||||
setStatus('课程完成:' + truncate(title, 26) + '(本次 ' + S.completedThisRun + ')');
|
||||
// 完成后的返回列表不能被 5 秒节流吞掉
|
||||
later(function () { goToList(true); }, 1200);
|
||||
}
|
||||
|
||||
// 这门课在本轮是否已被判为「无法自动完成」而跳过(目前只有考试交不了的情况)
|
||||
export function courseSkipped(title) {
|
||||
const t = norm(title);
|
||||
return !!(t && (S.skippedCourses || {})[t]);
|
||||
}
|
||||
|
||||
// 跳过这门课,继续下一门。
|
||||
// 只用于「重试也不会好」的确定性失败:考试空卷交卷后平台始终不记账、
|
||||
// 结果页又回不到考试说明页。继续按 failCurrent 退避重试只会反复进同一门课,
|
||||
// 最后停下整轮刷课,其它 5000 多门课也跟着停——所以这里记下原因、本轮不再选它,
|
||||
// 由人工事后处理这门考试。记录只活在本次会话(sessionStorage),重启会重新尝试。
|
||||
export function skipCurrent(reason) {
|
||||
const title = recordTitle();
|
||||
const key = norm(title);
|
||||
if (key) S.skippedCourses[key] = { reason: reason, at: Date.now() };
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = true;
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
// 下一门课重新拉平台实时状态;被跳过的课仍在平台未学完列表里,靠 skippedCourses 排除
|
||||
invalidateShortCatalog();
|
||||
saveRunState();
|
||||
setStatus('已跳过「' + truncate(title || '当前课程', 20) + '」:' + reason + '(继续下一门)');
|
||||
console.warn(TAG, '跳过课程:', title, reason);
|
||||
updatePanel();
|
||||
later(function () { goToList(true); }, 1200);
|
||||
}
|
||||
|
||||
// 课程没学完(不是「跳过」,是「重试」):
|
||||
// 同一门课最多重试 CFG.maxCourseRetries 次,退避等待后重新进这门课;
|
||||
// 超过次数才停止整轮刷课并明确提示——不会把这门课悄悄拉黑、换下一门。
|
||||
export function failCurrent(reason) {
|
||||
const title = recordTitle();
|
||||
const key = norm(title);
|
||||
const rec = key ? (S.courseRetries[key] || { n: 0 }) : { n: 0 };
|
||||
rec.n = (rec.n || 0) + 1;
|
||||
rec.reason = reason;
|
||||
rec.at = Date.now();
|
||||
if (key) S.courseRetries[key] = rec;
|
||||
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = false;
|
||||
|
||||
if (rec.n > CFG.maxCourseRetries) {
|
||||
// 重试用尽:停下整轮刷课,把原因留在面板上,等人工处理
|
||||
S.batchRunning = false;
|
||||
S.batchFinished = true;
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
saveRunState();
|
||||
setStatus('「' + truncate(title || '当前课程', 22) + '」重试 ' + CFG.maxCourseRetries +
|
||||
' 次仍未完成,已停止刷课:' + reason);
|
||||
console.warn(TAG, '重试用尽,停止刷课:', title, reason);
|
||||
pauseAllMedia();
|
||||
updatePanel();
|
||||
return;
|
||||
}
|
||||
|
||||
// 退避:30 秒起,每次翻倍,最长 5 分钟;整轮连续重试次数越多等得越久,
|
||||
// 避免「进课就失败 → 立刻重进」把页面刷爆。
|
||||
const backoff = Math.min(300000, CFG.courseRetryDelayMs * Math.pow(2, Math.min(rec.n - 1, 4)));
|
||||
R.retryWaitUntil = Date.now() + backoff;
|
||||
R.retryTitle = title;
|
||||
R.retryStatusSec = -1;
|
||||
// 重试前重新拉一次列表接口:同一门课可能已被手动学完/状态已变化
|
||||
invalidateShortCatalog();
|
||||
S.awaitingListReturn = true;
|
||||
saveRunState();
|
||||
console.warn(TAG, '课程未完成,' + Math.round(backoff / 1000) + ' 秒后重试(第 ' +
|
||||
rec.n + '/' + CFG.maxCourseRetries + ' 次):', title, reason);
|
||||
setStatus('未学完:' + truncate(title, 20) + '(' + reason + '),' +
|
||||
Math.round(backoff / 1000) + ' 秒后重试第 ' + rec.n + '/' + CFG.maxCourseRetries + ' 次');
|
||||
updatePanel();
|
||||
// 回列表等退避结束(listTick 会在等待期内不进课,到点后重新挑最短的未完成课)
|
||||
later(function () { goToList(true); }, 1200);
|
||||
}
|
||||
|
||||
// 重试退避是否还在等待期内
|
||||
export function retryWaiting() {
|
||||
return !!(R.retryWaitUntil && Date.now() < R.retryWaitUntil);
|
||||
}
|
||||
|
||||
// 重试等待剩余秒数(面板/日志用)
|
||||
export function retryWaitSeconds() {
|
||||
if (!R.retryWaitUntil) return 0;
|
||||
return Math.max(0, Math.ceil((R.retryWaitUntil - Date.now()) / 1000));
|
||||
}
|
||||
|
||||
export function stopBatch(reason) {
|
||||
S.batchRunning = false;
|
||||
S.batchFinished = true;
|
||||
saveRunState();
|
||||
setStatus(reason || '列表刷课结束');
|
||||
updatePanel();
|
||||
}
|
||||
@@ -1,39 +0,0 @@
|
||||
// ======== 配置 ========
|
||||
export const CFG = {
|
||||
mute: true, // 静音(自动播放更稳)
|
||||
autoNext: true, // 当前课程自动连播:本节结束后自动下一节
|
||||
tickMs: 2000, // 主循环间隔
|
||||
startClickCooldownMs: 3000, // 「开始学习」重复点击冷却(3 秒内没起播就补点)
|
||||
entryGraceMs: 30000, // 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」
|
||||
stuckMs: 5 * 60 * 1000, // 连续多久没有计时进展就放弃当前课程
|
||||
maxCourseRetries: 5, // 同一门课最多重试多少次(不跳过课程,超次数就停下整轮刷课)
|
||||
courseRetryDelayMs: 30000, // 首次重试前的等待;之后每次翻倍,最长 5 分钟
|
||||
alignToFirstIncomplete: true, // 进入课程先从「第一个未学完的课时」学起;false = 沿用平台上次位置
|
||||
preferShortCourses: true, // 列表刷课时优先总时长更短的课程(正序)
|
||||
maxExamTries: 2, // 同一门课「空卷交卷」的最大次数(平台没记账时避免死循环)
|
||||
examClickCooldownMs: 1500, // 考试页内两次点击的间隔
|
||||
staleCourseMs: 10 * 60 * 1000, // 恢复「当前课程」时允许的最大年龄,更旧的一律丢弃
|
||||
};
|
||||
|
||||
// 版本号:由 build.mjs 从 package.json 注入,不要手改
|
||||
export const VERSION = __YUN_XUE_TANG_VERSION__;
|
||||
|
||||
// ---- localStorage:用户偏好(跨会话成立) ----
|
||||
export const LS_ENABLED = 'yun-xue-tang-auto-play-enabled';
|
||||
export const LS_PREFER_SHORT = 'yun-xue-tang-prefer-short';
|
||||
export const LS_TARGET_CATALOG_URL = 'yun-xue-tang-target-catalog-url';
|
||||
export const LS_LOGIN = 'yun-xue-tang-login-v1';
|
||||
export const LS_PENDING = 'yun-xue-tang-auto-start-after-login';
|
||||
|
||||
// ---- sessionStorage:本次进度 + 本次运行状态(换标签页/重启即作废) ----
|
||||
export const SS_RUN_STATE = 'yun-xue-tang-run-state-v3';
|
||||
export const SS_SHORT_CATALOG = 'yun-xue-tang-short-catalog-v1';
|
||||
export const SS_POINTS_INVENTORY = 'yun-xue-tang-points-inventory-v1';
|
||||
export const SHORT_CATALOG_TTL = 5 * 60 * 1000;
|
||||
export const POINTS_INVENTORY_TTL = 5 * 60 * 1000;
|
||||
|
||||
// 旧版本把「进度 + 运行意图」整块塞进 localStorage,只用于一次性迁移(迁移后即删除)
|
||||
export const LEGACY_LS_BATCH = 'yun-xue-tang-batch-v2';
|
||||
|
||||
export const PANEL_ID = 'yun-xue-tang-panel';
|
||||
export const TAG = '[云学堂助手]';
|
||||
-516
@@ -1,516 +0,0 @@
|
||||
// ======== 课程页 ========
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, state, points, saveRunState, PHASE_LEARNING } from './state.js';
|
||||
import { detectLessonType, pointLabel } from './points.js';
|
||||
import {
|
||||
platformMode, rememberCourseAward, noteCourseCompleted, refreshPlatformPoints,
|
||||
} from './points-platform.js';
|
||||
import { goToList, mediaPage } from './route.js';
|
||||
import { courseIdFromUrl, norm, textOf, truncate, findVisibleClickable } from './utils.js';
|
||||
import { later } from './lifecycle.js';
|
||||
import { setStatus, statusEl } from './panel.js';
|
||||
import {
|
||||
alignToFirstIncomplete, courseHasQuizLesson, detectQuiz, handleAntiIdle, courseTitle,
|
||||
hookAllVideos, findPlayableVideo, ensurePlaying, readSummary, readCountdown,
|
||||
readActiveLessonKey, findNextLessonElement, findNextButton, clickNode,
|
||||
fireClickSequence, lessonClickNodes, syncManualCourse, pauseAllMedia,
|
||||
findPendingExamLesson, lessonItems, isLessonCompleted, lessonActiveLi, clickLesson,
|
||||
} from './player.js';
|
||||
import { examTick, examPhase } from './exam.js';
|
||||
import { completeCurrent, failCurrent } from './complete.js';
|
||||
|
||||
// ---- 每日积分:整门课完成才计 1 次 ----
|
||||
// 多课时课程按「整门课」算一次任务,不按节数累计:
|
||||
// 逐节只记住今天学过的类型,等整门课(含考试)完成时才计分。
|
||||
// 类型在播放期间就按 lessonId 缓存下来:平台记账或自动切节后页面可能已经
|
||||
// 跳到下一节,事后再读目录就不知道刚完成的是哪一类了。
|
||||
function pointLessonId(key) {
|
||||
const courseId = (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || '';
|
||||
return courseId + '|' + (key || 'media');
|
||||
}
|
||||
|
||||
function rememberLessonType(key) {
|
||||
if (!state.pointsEnabled) return;
|
||||
const li = lessonActiveLi();
|
||||
const tagEl = li ? li.querySelector('.tag-type') : null;
|
||||
const type = detectLessonType({
|
||||
tag: tagEl ? textOf(tagEl) : '',
|
||||
hash: location.hash,
|
||||
});
|
||||
if (!type) return;
|
||||
R.lessonTypes[pointLessonId(key)] = type;
|
||||
}
|
||||
|
||||
// 记下「这门课今天确实学了一节」,类型留给整门课完成时计分。
|
||||
// 只剩考试、今天没学内容的老课不会留下类型,因此不产出积分。
|
||||
function markLessonStudied(key) {
|
||||
if (!state.pointsEnabled) return '';
|
||||
const id = pointLessonId(key);
|
||||
const type = R.lessonTypes[id] || detectLessonType({ hash: location.hash });
|
||||
if (!type) return '';
|
||||
R.coursePointType = type;
|
||||
return type;
|
||||
}
|
||||
|
||||
// 整门课完成 → 计 1 次。同一门课当天只计一次(去重键 courseId|course)。
|
||||
// 平台台账可用时以平台为准:先记下课程类型,等平台真的入账后再计入。
|
||||
function recordCoursePoint() {
|
||||
if (!state.pointsEnabled) return '';
|
||||
const key = R.waitLessonKey || R.lastLessonKey || '';
|
||||
const type = R.coursePointType || R.lessonTypes[pointLessonId(key)] || '';
|
||||
if (!type) return '';
|
||||
|
||||
if (platformMode() === 'platform') {
|
||||
const title = (S.activeCourse && S.activeCourse.title) || courseTitle() || '';
|
||||
rememberCourseAward(title, type);
|
||||
noteCourseCompleted();
|
||||
refreshPlatformPoints(points, { force: true });
|
||||
// 平台入账有延迟:完成后再补拉两次
|
||||
later(function () { refreshPlatformPoints(points, { force: true }); }, 8000);
|
||||
later(function () { refreshPlatformPoints(points, { force: true }); }, 25000);
|
||||
setStatus('整门课完成,等待平台记账:' + pointLabel(type));
|
||||
return type;
|
||||
}
|
||||
|
||||
// 平台接口不可用(未登录 / 跨域):退回本地计数
|
||||
if (!points.record(type, pointLessonId('course'))) return '';
|
||||
const text = points.snapshot().text;
|
||||
console.log(TAG, '积分 +3:' + pointLabel(type) + '(整门课完成 · ' + text + ')');
|
||||
setStatus('积分 +3:' + pointLabel(type) + '(' + text + ')');
|
||||
return type;
|
||||
}
|
||||
|
||||
export function courseTick() {
|
||||
R.listWithCurrentSince = 0;
|
||||
if (!S.activeCourse) {
|
||||
goToList();
|
||||
return;
|
||||
}
|
||||
|
||||
// 播放器可能是点「开始学习」后才创建的;每轮顺带接管一次,
|
||||
// 新视频一出现就静音并挂上 play/ended/timeupdate 监听。
|
||||
hookAllVideos();
|
||||
|
||||
const isMedia = mediaPage();
|
||||
const urlId = courseIdFromUrl();
|
||||
const curId = S.activeCourse.id || '';
|
||||
const title = courseTitle();
|
||||
const nt = norm(title);
|
||||
const nc = norm(S.activeCourse.title);
|
||||
const genericTitle = !nt || /^(loading|加载中|在线课堂|江丰云课堂|云课堂|课程详情|课程)$/.test(nt);
|
||||
const titleSame = genericTitle || !nc || nt === nc ||
|
||||
nt.indexOf(nc) >= 0 || nc.indexOf(nt) >= 0;
|
||||
// 有了 URL 里的 kngId 就以 id 为准:标题在 SPA 切页时经常短暂是 loading/
|
||||
// 在线课堂,旧逻辑会把它当成「课程不一致」在 12 秒后把课退回列表。
|
||||
const idKnown = !!(urlId && curId);
|
||||
const sameCourse = idKnown ? urlId === curId : titleSame;
|
||||
const graceOver = Date.now() - (S.activeCourse.startedAt || 0) > CFG.entryGraceMs;
|
||||
if (!sameCourse) {
|
||||
if (graceOver) {
|
||||
console.warn(TAG, '页面课程与队列不一致:队列', nc, curId,
|
||||
'页面', nt, urlId, location.href);
|
||||
failCurrent('页面课程与队列不一致');
|
||||
return;
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 换了一门课就清掉「今天学过什么类型」,整门课完成时只按本课的类型计分
|
||||
const pointCourseKey = curId || urlId || '';
|
||||
if (R.coursePointCourseId !== pointCourseKey) {
|
||||
R.coursePointCourseId = pointCourseKey;
|
||||
R.coursePointType = '';
|
||||
}
|
||||
|
||||
if (S.coursePhase !== PHASE_LEARNING) {
|
||||
S.coursePhase = PHASE_LEARNING;
|
||||
saveRunState();
|
||||
}
|
||||
|
||||
// #/scan 只是进课过渡页:此时页面组件里可能还残留上一门课的汇总,
|
||||
// 等路由切到真正的播放页再判断,避免把旧课程的「已完成学习」当成新课程完成。
|
||||
if ((location.hash || '').indexOf('#/scan') === 0) return;
|
||||
|
||||
// 1) 防挂机验证(每 10 分钟弹一次,120 秒内不点「继续学习」就停止计时)
|
||||
if (handleAntiIdle()) return;
|
||||
|
||||
// 2) 考试页(说明页 / 答卷页 / 结果页):自动进考试并空卷交卷
|
||||
if (examTick(false)) return;
|
||||
|
||||
// 3) 答题/测验/问卷仍需人工处理
|
||||
if (detectQuiz()) {
|
||||
failCurrent('检测到答题/测验,需要手动处理');
|
||||
return;
|
||||
}
|
||||
|
||||
// 4) 课程是否包含答题/测验类章节(只需检查一次)
|
||||
if (!R.quizChecked && document.querySelector('.yxtulcdsdk-catalog ul > li .tag-type')) {
|
||||
R.quizChecked = true;
|
||||
if (courseHasQuizLesson()) {
|
||||
failCurrent('课程包含答题/测验章节');
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
// 5) 有未完成的考试课时且当前不在考试页:先点进考试节(进去后下一轮 examTick 接管)
|
||||
// 汇总已满时不再进考试:个别课程考试节未做但平台已算完成,
|
||||
// 再进考试只会白白多交一次卷。
|
||||
if (!examPhase() && !isSummaryComplete() && enterPendingExamLesson()) return;
|
||||
|
||||
// 6) 整门课程是否已完成 / 平台是否刚记录了一节
|
||||
// 先把当前课时的类型记下来,后面平台记账/课程完成时才知道该给哪一类计分。
|
||||
rememberLessonType(readActiveLessonKey());
|
||||
const summary = readSummary();
|
||||
const prevSummaryX = R.lastSummary ? R.lastSummary.x : -1;
|
||||
if (summary) {
|
||||
// 三种完成文案统一走这里:x/y 满、百分比 100%、「已完成学习」。
|
||||
// 页面切换瞬间可能读到上一门课的残留文案,连续两次读到才确认。
|
||||
if (summary.complete) {
|
||||
const confirmed = !!(R.lastSummary && R.lastSummary.complete);
|
||||
R.lastSummary = summary;
|
||||
if (confirmed) {
|
||||
recordCoursePoint();
|
||||
completeCurrent();
|
||||
return;
|
||||
}
|
||||
setStatus('课程已完成,确认中…');
|
||||
return;
|
||||
}
|
||||
|
||||
if (R.lastSummary && summary.x > R.lastSummary.x) {
|
||||
R.lastProgressAt = Date.now();
|
||||
const prevKey = R.lastLessonKey;
|
||||
const curKey = readActiveLessonKey();
|
||||
R.lastSummary = summary;
|
||||
|
||||
// 平台刚记录了一节 → 只记住这一节的类型,整门课完成时才计分
|
||||
if (!isMedia && summary.kind !== 'percent') markLessonStudied(prevKey);
|
||||
|
||||
// 单视频/音频页的百分比是播放进度,不是「一节学完」,不能据此切节
|
||||
if (!isMedia && summary.kind !== 'percent' && (!prevKey || curKey === prevKey)) {
|
||||
// 平台已记账但没有自动切节 → 脚本主动切下一节
|
||||
setStatus('本节已记录,切换下一节…');
|
||||
advanceLesson();
|
||||
return;
|
||||
}
|
||||
setStatus(summary.kind === 'percent'
|
||||
? '学习进度:' + summary.x + '%'
|
||||
: '进度更新:' + summary.x + '/' + summary.y);
|
||||
return;
|
||||
}
|
||||
|
||||
R.lastSummary = summary;
|
||||
}
|
||||
|
||||
// 5) 对齐起点:进入课程后统一从「第一个未学完的课时」开始(即第一章第一节起顺序学),
|
||||
// 不沿用平台上次停留的位置。否则前面的课时会被跳过,整门课永远学不完。
|
||||
// 单视频/音频页没有目录,不走这一步。
|
||||
if (!isMedia && alignToFirstIncomplete()) return;
|
||||
|
||||
// 6) 计时与当前章节
|
||||
const cd = readCountdown();
|
||||
if (cd != null) {
|
||||
if (R.lastCountdown == null || cd < R.lastCountdown) {
|
||||
R.lastProgressAt = Date.now();
|
||||
}
|
||||
R.lastCountdown = cd;
|
||||
}
|
||||
|
||||
const lessonKey = readActiveLessonKey();
|
||||
if (lessonKey && lessonKey !== R.lastLessonKey) {
|
||||
R.lastLessonKey = lessonKey;
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
R.waitSummaryX = -1;
|
||||
R.waitLessonKey = '';
|
||||
R.lastProgressAt = Date.now();
|
||||
setStatus('学习中:' + truncate(lessonKey, 28) + (R.alignFailed ? '(起点未对齐)' : ''));
|
||||
}
|
||||
|
||||
// 7) 本节是否已在本地结束(必须先判断,避免把已结束的视频重新拉回开头)
|
||||
const v = findPlayableVideo();
|
||||
// 视频 ended 是本节结束的主信号;倒计时文案在切节后可能变成下一节的时长。
|
||||
// doneLatchKey 用来记住「这节已经播完」:平台在完成后会把播放器重置到 0 秒,
|
||||
// video.ended 变回 false、倒计时也消失,若只看即时状态就会把视频从头重播。
|
||||
const latchKey = isMedia ? 'media' : (lessonKey || '');
|
||||
const cdDone = cd != null && cd <= 0;
|
||||
const ended = !!(v && v.ended);
|
||||
if (latchKey && R.doneLatchKey && R.doneLatchKey !== latchKey) R.doneLatchKey = '';
|
||||
if (latchKey && (cdDone || (ended && (cd == null || cd <= 3)))) {
|
||||
R.doneLatchKey = latchKey;
|
||||
}
|
||||
const localDone = ended || cdDone ||
|
||||
(!!latchKey && R.doneLatchKey === latchKey);
|
||||
|
||||
// 8) 播放器
|
||||
if (!localDone) {
|
||||
if (v) {
|
||||
ensurePlaying(v);
|
||||
const want = '学习中:' + truncate(lessonKey || S.activeCourse.title, 30);
|
||||
if (statusEl && (statusEl.textContent === '点击开始学习…' ||
|
||||
(isMedia && statusEl.textContent !== want))) {
|
||||
setStatus(want);
|
||||
}
|
||||
} else {
|
||||
const startBtn = findVisibleClickable(/^(开始学习|继续学习|继续观看)$/);
|
||||
if (startBtn && Date.now() - R.lastStartClickAt > CFG.startClickCooldownMs) {
|
||||
R.lastStartClickAt = Date.now();
|
||||
setStatus('点击开始学习…');
|
||||
console.log(TAG, '点击开始学习', textOf(startBtn) || startBtn.tagName);
|
||||
try { startBtn.click(); } catch (e) {}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 9) 标记等待平台记录
|
||||
if (!localDone) {
|
||||
R.waitStart = 0;
|
||||
} else if (!R.waitStart) {
|
||||
R.waitStart = Date.now();
|
||||
R.waitSummaryX = prevSummaryX;
|
||||
R.waitLessonKey = lessonKey;
|
||||
setStatus(isMedia ? '课程已播完,等待平台记录…' : '本节结束,等待平台记录…');
|
||||
}
|
||||
|
||||
// 10) 等待平台记录本节完成
|
||||
if (R.waitStart) {
|
||||
const newKey = readActiveLessonKey();
|
||||
const s2 = readSummary();
|
||||
|
||||
// 整门课已完成(含「已完成学习」/百分比 100%)
|
||||
if (s2 && s2.complete) {
|
||||
const confirmed = !!(R.lastSummary && R.lastSummary.complete);
|
||||
R.lastSummary = s2;
|
||||
if (!confirmed) {
|
||||
setStatus('课程已完成,确认中…');
|
||||
return;
|
||||
}
|
||||
R.waitStart = 0;
|
||||
R.lastProgressAt = Date.now();
|
||||
recordCoursePoint();
|
||||
completeCurrent();
|
||||
return;
|
||||
}
|
||||
|
||||
// 平台自动进入了下一节(只可能发生在有目录的多课时课程)
|
||||
if (!isMedia && R.waitLessonKey && newKey && newKey !== R.waitLessonKey) {
|
||||
R.waitStart = 0;
|
||||
R.lastLessonKey = newKey;
|
||||
R.doneLatchKey = '';
|
||||
R.lastProgressAt = Date.now();
|
||||
markLessonStudied(R.waitLessonKey);
|
||||
setStatus('已自动进入下一节');
|
||||
return;
|
||||
}
|
||||
|
||||
// 完成数增加 → 手动切下一节
|
||||
if (!isMedia && s2 && s2.x > R.waitSummaryX) {
|
||||
R.waitStart = 0;
|
||||
R.lastProgressAt = Date.now();
|
||||
markLessonStudied(R.waitLessonKey || R.lastLessonKey);
|
||||
if (s2.complete) {
|
||||
completeCurrent();
|
||||
} else {
|
||||
advanceLesson();
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (Date.now() - R.waitStart > 30000) {
|
||||
if (isMedia) {
|
||||
// 单视频/音频:平台记账有延迟,继续等,不能把已播完的视频再拉回 0 秒
|
||||
R.waitStart = Date.now();
|
||||
setStatus('课程已播完,等待平台完成记录…');
|
||||
} else {
|
||||
R.waitStart = 0;
|
||||
setStatus('平台未更新进度,尝试下一节…');
|
||||
advanceLesson();
|
||||
}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 11) 长时间无进展 → 放弃
|
||||
if (Date.now() - R.lastProgressAt > CFG.stuckMs) {
|
||||
failCurrent('长时间没有计时进展');
|
||||
}
|
||||
}
|
||||
|
||||
// 自动切下一节:先点标题(事件会冒泡到行容器 / li 上的句柄),
|
||||
// 平台没反应时再依次补点行容器、li、状态图标;每一步都先确认目标课时还没
|
||||
// 变成当前课时,避免平台自己已经切过去之后又被点回来。
|
||||
export function switchLesson(li) {
|
||||
if (!li) return;
|
||||
const want = norm(textOf(li));
|
||||
const nodes = lessonClickNodes(li);
|
||||
const svg = li.querySelector('svg');
|
||||
const steps = [
|
||||
{ at: 0, run: function () { clickNode(nodes[0]); } },
|
||||
{ at: 500, run: function () { if (nodes[1]) clickNode(nodes[1]); } },
|
||||
{ at: 1000, run: function () { fireClickSequence(li); } },
|
||||
{ at: 1500, run: function () { if (svg) fireClickSequence(svg); } },
|
||||
];
|
||||
for (const step of steps) {
|
||||
if (!step.at) {
|
||||
step.run();
|
||||
continue;
|
||||
}
|
||||
later(function () {
|
||||
if (want && readActiveLessonKey() === want) return;
|
||||
step.run();
|
||||
}, step.at);
|
||||
}
|
||||
}
|
||||
|
||||
export function advanceLesson() {
|
||||
if (Date.now() - R.lastAdvanceAt < 5000) return;
|
||||
R.lastAdvanceAt = Date.now();
|
||||
R.lastCountdown = null;
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
|
||||
const next = findNextLessonElement();
|
||||
if (next) {
|
||||
setStatus('进入下一节');
|
||||
switchLesson(next);
|
||||
return;
|
||||
}
|
||||
const btn = findNextButton();
|
||||
if (btn) {
|
||||
setStatus('进入下一节');
|
||||
clickNode(btn);
|
||||
return;
|
||||
}
|
||||
|
||||
const s = readSummary();
|
||||
if (s && s.complete) {
|
||||
recordCoursePoint();
|
||||
completeCurrent();
|
||||
} else {
|
||||
setStatus('没有找到下一节,等待课程完成…');
|
||||
}
|
||||
}
|
||||
|
||||
// ======== 考试课时 ========
|
||||
// 平台汇总已算完成(个别课考试节没做也判完成)时不再进考试,
|
||||
// 否则只会白白多交一次卷。
|
||||
function isSummaryComplete() {
|
||||
const s = readSummary();
|
||||
return !!(s && s.complete);
|
||||
}
|
||||
|
||||
// 目录里有未完成的考试课时时,先点进考试节。点完后平台会渲染考试说明页,
|
||||
// 下一轮 tick 由 examTick() 接管(开始考试 → 不答题 → 提交 → 确定)。
|
||||
// 顺序上把考试放到最后:还有普通课时没学完就不进考试,
|
||||
// 避免「进考试→交卷→重进课程页」的额外跳转打断正常播放。
|
||||
// 返回 true = 本 tick 已在处理,调用方直接 return。
|
||||
export function enterPendingExamLesson() {
|
||||
const li = findPendingExamLesson();
|
||||
if (!li) return false;
|
||||
|
||||
// 换课/离课后重置「点考试节」的计数,否则下一门课会凭空背着上一门课的次数
|
||||
const courseKey = (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || '';
|
||||
if (R.examLessonKey !== courseKey) {
|
||||
R.examLessonKey = courseKey;
|
||||
R.examLessonTries = 0;
|
||||
R.examLessonAt = 0;
|
||||
}
|
||||
|
||||
const pendingNormal = lessonItems().some(function (item) {
|
||||
const tag = item.querySelector('.tag-type');
|
||||
const isExam = !!tag && /考试/.test(textOf(tag));
|
||||
return !isExam && !isLessonCompleted(item);
|
||||
});
|
||||
if (pendingNormal) return false;
|
||||
|
||||
if (Date.now() - R.examLessonAt < CFG.examClickCooldownMs * 2) return true;
|
||||
|
||||
// 已经停在这一节(说明页/答卷页由 examTick 管),不重复点
|
||||
const activeLi = lessonActiveLi();
|
||||
if (activeLi && activeLi === li && examPhase()) return false;
|
||||
|
||||
if (R.examLessonTries >= 10) {
|
||||
failCurrent('点击考试章节多次后仍未进入考试页');
|
||||
return true;
|
||||
}
|
||||
|
||||
R.examLessonAt = Date.now();
|
||||
R.examLessonTries++;
|
||||
setStatus('进入考试章节:' + truncate(textOf(li), 20) +
|
||||
(R.examLessonTries > 1 ? '(第 ' + R.examLessonTries + ' 次)' : ''));
|
||||
clickLesson(li, R.examLessonTries);
|
||||
return true;
|
||||
}
|
||||
|
||||
// ======== 当前课程自动连播(手动打开的课) ========
|
||||
export function manualCourseTick() {
|
||||
hookAllVideos();
|
||||
if (handleAntiIdle()) return;
|
||||
|
||||
// 课程标题就绪前不做任何判断,避免在旧课程的目录上点来点去
|
||||
const title = courseTitle();
|
||||
if (!title || /^(loading|加载中)/i.test(title)) return;
|
||||
|
||||
// 手动进入课程时同样先对齐到「第一个未学完的课时」;每门课只对齐一次,
|
||||
// 之后用户自己点别的课时不会被拉回来
|
||||
syncManualCourse();
|
||||
if (!mediaPage() && alignToFirstIncomplete()) return;
|
||||
|
||||
// 考试页:同样自动进考试、空卷交卷(出错只提示,不影响手动听课)
|
||||
if (examTick(true)) return;
|
||||
if (!examPhase() && !isSummaryComplete() && enterPendingExamLesson()) return;
|
||||
|
||||
const lessonKey = readActiveLessonKey();
|
||||
if (lessonKey && lessonKey !== R.lastLessonKey) {
|
||||
R.lastLessonKey = lessonKey;
|
||||
R.doneLatchKey = '';
|
||||
setStatus('学习中:' + truncate(lessonKey, 28));
|
||||
}
|
||||
|
||||
// 整门课已完成(平台汇总会变成「已完成学习」/100%):停在这里,别再重播
|
||||
const summary = readSummary();
|
||||
if (summary && summary.complete) {
|
||||
pauseAllMedia();
|
||||
setStatus('课程已完成:' + truncate(S.activeCourse ? S.activeCourse.title : title, 24));
|
||||
return;
|
||||
}
|
||||
|
||||
const v = findPlayableVideo();
|
||||
if (!v) {
|
||||
// 单视频/音频页初始只有封面和「开始学习」,手动模式也要能点开
|
||||
if (!mediaPage()) return;
|
||||
const startBtn = findVisibleClickable(/^(开始学习|继续学习|继续观看)$/);
|
||||
if (startBtn && Date.now() - R.lastStartClickAt > CFG.startClickCooldownMs) {
|
||||
R.lastStartClickAt = Date.now();
|
||||
setStatus('点击开始学习…');
|
||||
try { startBtn.click(); } catch (e) {}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
const cd = readCountdown();
|
||||
if (cd != null) {
|
||||
if (R.lastCountdown == null || cd < R.lastCountdown) R.lastProgressAt = Date.now();
|
||||
R.lastCountdown = cd;
|
||||
}
|
||||
|
||||
if (v.ended || (cd != null && cd <= 0)) R.doneLatchKey = 'manual';
|
||||
const localDone = v.ended || (cd != null && cd <= 0) || R.doneLatchKey === 'manual';
|
||||
|
||||
if (localDone) {
|
||||
if (CFG.autoNext && Date.now() - R.manualAdvanceAt > 6000) {
|
||||
R.manualAdvanceAt = Date.now();
|
||||
const next = findNextLessonElement();
|
||||
if (next) {
|
||||
switchLesson(next);
|
||||
} else {
|
||||
const btn = findNextButton();
|
||||
if (btn) clickNode(btn);
|
||||
}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
ensurePlaying(v);
|
||||
}
|
||||
@@ -1,19 +0,0 @@
|
||||
// ======== 考试结果页的处置决策(纯函数,便于单测) ========
|
||||
//
|
||||
// 交卷后平台会把课程恢复到「考试结果页」。重进课程时也会看到这一页,
|
||||
// 但那次并不是本页刚交的卷 —— 以前把它当成一次空卷交卷,导致:
|
||||
// · examEmptySubmits 虚增,maxExamTries 形同虚设(上限在结果分支之后才检查);
|
||||
// · 结果页 → 回课程页 → 又被恢复到结果页,同一页反复「交卷」,进度永远不动。
|
||||
//
|
||||
// 只有本页确实点过「提交考试 / 确定交卷」,结果页才算一次真实交卷。
|
||||
// 否则先回到考试说明页重新进入考试;回不去才跳过这门课,等人工处理。
|
||||
export function planExamResult(ctx) {
|
||||
const submitted = !!(ctx && ctx.submitted);
|
||||
const complete = !!(ctx && ctx.complete);
|
||||
|
||||
if (submitted) return complete ? 'complete' : 'count';
|
||||
// 没交卷但平台已算完成:不重进考试,直接收课
|
||||
if (complete) return 'complete';
|
||||
if ((Number(ctx && ctx.staleTries) || 0) >= 2) return 'skip';
|
||||
return 'reback';
|
||||
}
|
||||
-364
@@ -1,364 +0,0 @@
|
||||
// ======== 考试:自动进入考试并空卷交卷 ========
|
||||
// 平台的考试章节不是可播放的课时:进课后显示的是「考试说明页」(开始考试 / 继续考试),
|
||||
// 点进去是答卷页(答题卡 + 提交考试),交卷后是结果页(查看答卷详情 / 返回考试说明页)。
|
||||
// 这里的目标只有一个:进入考试后一题不做,直接交卷,让考试章节计入课程进度,
|
||||
// 从而让「含考试章节的课程」也能被刷完,而不是整门课被跳过。
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, saveRunState } from './state.js';
|
||||
import { textOf, isVisible, courseIdFromUrl } from './utils.js';
|
||||
import { later } from './lifecycle.js';
|
||||
import { setStatus } from './panel.js';
|
||||
import { failCurrent, completeCurrent, skipCurrent } from './complete.js';
|
||||
import { readSummary } from './player.js';
|
||||
import { planExamResult } from './exam-plan.js';
|
||||
|
||||
// 只认「考试」相关文案:答题/测验/问卷仍按「需要人工处理」跳过
|
||||
const START_RE = /^(开始考试|继续考试|重新考试|进入考试)$/;
|
||||
const SUBMIT_RE = /^(提交考试|提交试卷|交卷|交卷并退出)$/;
|
||||
// 「交卷」类文案里只有考试独有的几个能用来判定「当前是考试答卷页」;
|
||||
// 「提交试卷」同样会出现在答题/测验页上,不能拿来当考试标志(否则会误抢答题页)。
|
||||
const EXAM_SUBMIT_RE = /^(提交考试|交卷|交卷并退出)$/;
|
||||
const CONFIRM_RE = /^(确定|确认|确定交卷|确认交卷|提交|提交试卷)$/;
|
||||
const RESULT_RE = /^(查看答卷详情|返回考试说明页)$/;
|
||||
|
||||
function visibleAll(sel, root) {
|
||||
let list = [];
|
||||
try {
|
||||
list = [...(root || document).querySelectorAll(sel)];
|
||||
} catch (e) {
|
||||
return [];
|
||||
}
|
||||
return list.filter(isVisible);
|
||||
}
|
||||
|
||||
// 点击优先级:真正的 button > 按钮类样式 > a > span > 其它。
|
||||
// 站点把点击回调绑在 <button> 上,点到外层 div 不会有任何反应。
|
||||
function rankOf(el) {
|
||||
const tag = el.tagName;
|
||||
if (tag === 'BUTTON' || tag === 'INPUT') return 0;
|
||||
if (/yxtf?-button|btn/i.test(String(el.className || ''))) return 1;
|
||||
if (tag === 'A') return 2;
|
||||
if (tag === 'SPAN') return 3;
|
||||
return 4;
|
||||
}
|
||||
|
||||
// 有些节点是 svg 包装,没有 click();统一派发鼠标事件序列
|
||||
export function examClick(el) {
|
||||
if (!el) return false;
|
||||
try {
|
||||
el.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true, view: window }));
|
||||
el.dispatchEvent(new MouseEvent('mouseup', { bubbles: true, cancelable: true, view: window }));
|
||||
el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, view: window }));
|
||||
return true;
|
||||
} catch (e) {
|
||||
try { el.click(); return true; } catch (e2) { return false; }
|
||||
}
|
||||
}
|
||||
|
||||
// 按「去掉全部空白后的完整文案」匹配可点元素(平台按钮文案带大量换行缩进)
|
||||
function findClickableByText(re, root) {
|
||||
const cands = visibleAll('button, [role="button"], a, span, div', root);
|
||||
const hit = cands.filter(function (el) {
|
||||
const t = textOf(el);
|
||||
return !!t && t.length <= 12 && re.test(t);
|
||||
});
|
||||
if (!hit.length) return null;
|
||||
hit.sort(function (a, b) {
|
||||
const d = rankOf(a) - rankOf(b);
|
||||
if (d) return d;
|
||||
return textOf(a).length - textOf(b).length;
|
||||
});
|
||||
return hit[0];
|
||||
}
|
||||
|
||||
// ---- 考试页的三种形态 ----
|
||||
export function examPreviewRoot() {
|
||||
return visibleAll('.yxtulcdsdk-uexam-preview, [class*="uexam-preview"]')[0] || null;
|
||||
}
|
||||
|
||||
export function examPaperRoot() {
|
||||
return visibleAll('[class*="answer-card"], [class*="answerSheet"], [class*="answer-sheet"]')[0] || null;
|
||||
}
|
||||
|
||||
export function examResultRoot() {
|
||||
const btns = visibleAll('button, [role="button"], a');
|
||||
for (const b of btns) {
|
||||
const t = textOf(b);
|
||||
if (t && t.length <= 12 && RESULT_RE.test(t)) return b;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 'preview' = 考试说明页 | 'paper' = 答卷页 | 'result' = 交卷后的结果页 | '' = 不在考试页
|
||||
export function examPhase() {
|
||||
if (examResultRoot()) return 'result';
|
||||
if (examPaperRoot()) return 'paper';
|
||||
if (examPreviewRoot()) return 'preview';
|
||||
// 兜底:容器类名改版时按按钮文案判断。
|
||||
// 「提交试卷」不单独作数:答题/测验页也有这个按钮,只有从考试说明页进来后才认它,
|
||||
// 避免把需要人工处理的答题页误当成考试自动交卷。
|
||||
if (findClickableByText(EXAM_SUBMIT_RE)) return 'paper';
|
||||
if (R.examPhase === 'preview' && findClickableByText(SUBMIT_RE)) return 'paper';
|
||||
if (findClickableByText(START_RE)) return 'preview';
|
||||
return '';
|
||||
}
|
||||
|
||||
// 交卷确认框里的「确定」按钮:只认可见、文案短、且提到交卷/未做的弹层,避免点到隐藏的弹窗模板。
|
||||
// 注意:弹层里文案最短的一层往往是「还有 N 道题未做,是否确认交卷?」的消息体,
|
||||
// 它本身不包含底部按钮,所以按文案长度升序逐个尝试,谁里面有「确定」就用谁。
|
||||
function confirmState() {
|
||||
const boxes = visibleAll('.yxtf-dialog__wrapper, .yxt-dialog__wrapper, [class*="dialog"], [class*="modal"], [role="dialog"]');
|
||||
const cands = boxes.filter(function (b) {
|
||||
const t = textOf(b);
|
||||
return !!t && t.length <= 300 && /交卷|未做|确认提交|是否确认/.test(t);
|
||||
});
|
||||
if (!cands.length) return { shown: false, btn: null };
|
||||
cands.sort(function (a, b) { return textOf(a).length - textOf(b).length; });
|
||||
for (const b of cands) {
|
||||
const btn = findClickableByText(CONFIRM_RE, b);
|
||||
if (btn) return { shown: true, btn: btn };
|
||||
}
|
||||
return { shown: true, btn: null };
|
||||
}
|
||||
|
||||
// 手动刷课(自己点开的课)里出错不应该动队列,只停下并提示;
|
||||
// 批量刷课走 failCurrent(重试退避,超过次数才停止整轮)。
|
||||
// skip=true:重试也不会好的确定性失败(考试交不了),本轮跳过这门课继续下一门。
|
||||
function examAbort(reason, manual, skip) {
|
||||
if (manual) {
|
||||
setStatus('考试:' + reason);
|
||||
return true;
|
||||
}
|
||||
if (skip) skipCurrent(reason); else failCurrent(reason);
|
||||
return true;
|
||||
}
|
||||
|
||||
function examCourseKey() {
|
||||
return (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || (location.pathname + location.hash);
|
||||
}
|
||||
|
||||
export function examTriedTimes(key) {
|
||||
const m = S.examEmptySubmits || {};
|
||||
return m[key || examCourseKey()] || 0;
|
||||
}
|
||||
|
||||
// 交卷后返回课程页有两种真实情况:
|
||||
// 1) 结果页是课程页里的一个视图,location.href 目标与当前 URL 相同,赋值不会触发任何导航
|
||||
// → 必须 reload,否则会停在结果页无限循环交卷;
|
||||
// 2) 正常的跨路由跳转,href 赋值即可。
|
||||
export function backToCourse() {
|
||||
const id = (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || '';
|
||||
const target = id ? location.origin + '/kng/#/course/play?kngId=' + encodeURIComponent(id) : '';
|
||||
// 重新进课要重新对齐起点,否则会停在考试节点上没有任何可播内容
|
||||
R.initialLessonChecked = false;
|
||||
R.alignTries = 0;
|
||||
R.alignStable = 0;
|
||||
R.alignFailed = false;
|
||||
R.phaseSince = 0;
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
R.lastCountdown = null;
|
||||
R.lastSummary = null;
|
||||
R.examLeaving = false;
|
||||
// 离开考试页后,再看到的结果页(平台恢复的)就不能再算一次交卷
|
||||
R.examSubmitted = false;
|
||||
R.examPreviewAt = 0;
|
||||
try {
|
||||
const cur = location.href;
|
||||
if (!target || cur === target) {
|
||||
location.reload();
|
||||
return;
|
||||
}
|
||||
location.href = target;
|
||||
// 兜底:SPA 有时只换 hash 不重渲染,1.5 秒后仍在原地址就强制刷新
|
||||
later(function () {
|
||||
if (location.href === cur) {
|
||||
try { location.reload(); } catch (e) { /* ignore */ }
|
||||
}
|
||||
}, 1500);
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
// 结果页其实是平台恢复的旧结果(本页没交过卷):回考试说明页重新进入考试。
|
||||
// 交卷后课程页会被恢复到考试结果页,若直接回课程页只会再次看到同一页,
|
||||
// 于是「交卷 → 回课程 → 又是结果页」无限循环,课程进度却不动。
|
||||
function backToPreview() {
|
||||
R.examLeaving = false;
|
||||
const btn = findClickableByText(/^返回考试说明页$/);
|
||||
if (btn) {
|
||||
setStatus('考试:返回考试说明页,重新进入考试…');
|
||||
examClick(btn);
|
||||
return;
|
||||
}
|
||||
// 说明页按钮也找不到:只能退回课程页重进考试节;
|
||||
// 平台若又把我们恢复到结果页,examStaleResults 会累加,最终跳过这门课。
|
||||
backToCourse();
|
||||
}
|
||||
|
||||
function finishExam(manual) {
|
||||
if (R.examLeaving) return;
|
||||
|
||||
const s = readSummary();
|
||||
const plan = planExamResult({
|
||||
submitted: R.examSubmitted,
|
||||
complete: !!(s && s.complete),
|
||||
staleTries: R.examStaleResults,
|
||||
});
|
||||
|
||||
if (plan === 'complete') {
|
||||
R.examLeaving = true;
|
||||
setStatus('考试已交卷(未答题),课程已完成');
|
||||
later(completeCurrent, 1500);
|
||||
return;
|
||||
}
|
||||
|
||||
if (plan === 'reback') {
|
||||
R.examLeaving = true;
|
||||
R.examStaleResults++;
|
||||
console.log(TAG, '考试结果页不是本页交的卷(平台恢复的旧结果),返回说明页重新进入考试');
|
||||
setStatus('考试结果为上次残留,返回考试说明页重新进入…');
|
||||
later(backToPreview, 1500);
|
||||
return;
|
||||
}
|
||||
|
||||
if (plan === 'skip') {
|
||||
return examAbort('考试结果页反复出现,无法重新进入考试,需手动处理', manual, true);
|
||||
}
|
||||
|
||||
// plan === 'count':本页确实点了「提交考试/确定交卷」
|
||||
R.examLeaving = true;
|
||||
const key = examCourseKey();
|
||||
if (!S.examEmptySubmits) S.examEmptySubmits = {};
|
||||
S.examEmptySubmits[key] = examTriedTimes(key) + 1;
|
||||
saveRunState();
|
||||
const times = S.examEmptySubmits[key];
|
||||
console.log(TAG, '考试已空卷交卷(第', times, '次),返回课程页继续学习');
|
||||
|
||||
if (times >= Math.max(1, CFG.maxExamTries)) {
|
||||
examAbort('已空卷交卷 ' + times + ' 次,仍未计入课程进度,需手动处理', manual, true);
|
||||
return;
|
||||
}
|
||||
|
||||
setStatus('考试已交卷(未答题),返回课程继续…');
|
||||
later(backToCourse, 1800);
|
||||
}
|
||||
|
||||
// 每个 tick 调用。返回 true = 本 tick 已在处理考试页,调用方应直接 return。
|
||||
export function examTick(manual) {
|
||||
const now = Date.now();
|
||||
const phase = examPhase();
|
||||
|
||||
if (!phase) {
|
||||
// 不在考试页:清掉考试引导状态,交回正常播放逻辑
|
||||
if (R.examPhase) {
|
||||
R.examPhase = '';
|
||||
R.examPaperAt = 0;
|
||||
R.examSubmits = 0;
|
||||
R.examConfirms = 0;
|
||||
R.examStarts = 0;
|
||||
R.examActionAt = 0;
|
||||
R.examPreviewAt = 0;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
// 换形态(说明页 → 答卷页 → 结果页)时重置本形态的点击节奏
|
||||
if (R.examPhase !== phase) {
|
||||
R.examPhase = phase;
|
||||
R.examActionAt = 0;
|
||||
R.examSubmits = 0;
|
||||
R.examConfirms = 0;
|
||||
R.examStarts = 0;
|
||||
R.examPaperAt = 0;
|
||||
// 新一次考试从说明页/答卷页开始时,之前的「已交卷」标记作废;
|
||||
// 进入结果页时必须保留——那是本页刚交卷产生的
|
||||
if (phase === 'preview' || phase === 'paper') R.examSubmitted = false;
|
||||
R.examPreviewAt = phase === 'preview' ? now : 0;
|
||||
if (phase === 'preview') {
|
||||
console.log(TAG, '检测到考试章节:进入考试后不答题,直接交卷');
|
||||
setStatus('检测到考试:进入考试后直接交卷…');
|
||||
}
|
||||
}
|
||||
|
||||
if (phase === 'result') {
|
||||
finishExam(manual);
|
||||
return true;
|
||||
}
|
||||
|
||||
// 同一门课空卷交卷次数上限:平台没记账时避免「进考试→交卷→再进考试」死循环。
|
||||
// 到上限就跳过这门课,继续下一门——再退避重试也只会重复同一份考卷。
|
||||
const key = examCourseKey();
|
||||
if (examTriedTimes(key) >= Math.max(1, CFG.maxExamTries)) {
|
||||
return examAbort('已空卷交卷 ' + examTriedTimes(key) + ' 次,仍未计入课程进度,需手动处理', manual, true);
|
||||
}
|
||||
|
||||
if (now - R.examActionAt < CFG.examClickCooldownMs) return true;
|
||||
|
||||
if (phase === 'preview') {
|
||||
const root = examPreviewRoot();
|
||||
const btn = findClickableByText(START_RE, root) || findClickableByText(START_RE);
|
||||
if (!btn) {
|
||||
// 说明页可能永远不给「开始考试」(考试已用完次数/需人工),不能无限等
|
||||
if (now - R.examPreviewAt > 30000) {
|
||||
return examAbort('考试说明页没有「开始考试」按钮,需手动处理', manual, true);
|
||||
}
|
||||
setStatus('考试:未找到「开始考试」按钮,等待页面渲染…');
|
||||
return true;
|
||||
}
|
||||
R.examPreviewAt = 0;
|
||||
R.examActionAt = now;
|
||||
R.examStarts++;
|
||||
if (R.examStarts > Math.max(3, CFG.maxExamTries + 3)) {
|
||||
return examAbort('点击「开始考试」多次仍不进答卷页', manual);
|
||||
}
|
||||
setStatus(R.examStarts > 1
|
||||
? '考试:再次点击「' + textOf(btn) + '」…(第 ' + R.examStarts + ' 次)'
|
||||
: '考试:进入考试(不答题,随后直接交卷)');
|
||||
examClick(btn);
|
||||
return true;
|
||||
}
|
||||
|
||||
// ---- 答卷页:等题目渲染出来 → 点提交考试 → 在确认框点确定 ----
|
||||
if (!R.examPaperAt) R.examPaperAt = now;
|
||||
if (now - R.examPaperAt < 2000) return true;
|
||||
|
||||
const cs = confirmState();
|
||||
if (cs.shown) {
|
||||
if (!cs.btn) {
|
||||
if (now - R.examPaperAt > 30000) {
|
||||
return examAbort('交卷确认框里没有「确定」按钮', manual);
|
||||
}
|
||||
setStatus('考试:交卷确认框里没找到「确定」按钮');
|
||||
return true;
|
||||
}
|
||||
R.examActionAt = now;
|
||||
R.examConfirms++;
|
||||
if (R.examConfirms > 6) {
|
||||
return examAbort('交卷确认框点了多次仍未交卷', manual);
|
||||
}
|
||||
// 只有真的点了交卷,之后看到的结果页才算一次空卷交卷
|
||||
R.examSubmitted = true;
|
||||
setStatus('考试:不答题,确认交卷…');
|
||||
examClick(cs.btn);
|
||||
return true;
|
||||
}
|
||||
|
||||
const sub = findClickableByText(SUBMIT_RE);
|
||||
if (!sub) {
|
||||
if (now - R.examPaperAt > 30000) {
|
||||
return examAbort('答卷页没有「提交考试」按钮', manual);
|
||||
}
|
||||
setStatus('考试:等待「提交考试」按钮…');
|
||||
return true;
|
||||
}
|
||||
if (R.examSubmits >= 6) {
|
||||
return examAbort('「提交考试」点了多次仍无结果', manual);
|
||||
}
|
||||
R.examActionAt = now;
|
||||
R.examSubmits++;
|
||||
R.examSubmitted = true;
|
||||
setStatus('考试:不答题,直接交卷…');
|
||||
examClick(sub);
|
||||
return true;
|
||||
}
|
||||
-125
@@ -1,125 +0,0 @@
|
||||
// ======== 主循环 ========
|
||||
'use strict';
|
||||
import { CFG, VERSION, TAG } from './config.js';
|
||||
import { R, S, state, points, saveRunState, flushRunState, invalidateShortCatalog } from './state.js';
|
||||
import { every, later, onWindow } from './lifecycle.js';
|
||||
import { courseIdFromUrl } from './utils.js';
|
||||
import { route, mediaPage } from './route.js';
|
||||
import { ensurePanel, setStatus } from './panel.js';
|
||||
import { isLoginPage, loginPageTick, doLoginAndStart, fillLoginForm, startBatch, consumePendingStart, setTick, loginFields, findLoginVm, checkLoginAgreement, setNativeValue, saveCreds, loadCreds, clearSavedCreds } from './login.js';
|
||||
import {
|
||||
listTick, listVm, shortCatalogKey, courseIdOfCard, ensureShortCatalog,
|
||||
chooseShortCourse, sortCardsByDuration, formatDuration,
|
||||
pendingShortItems, scanCards, currentPage, maxPageNumber,
|
||||
startCourse, jumpToPage, nextPage,
|
||||
ensurePointsInventory, pointsAvailability, pointsDone, pointsTarget, startStandalone,
|
||||
} from './list.js';
|
||||
import { courseTick, manualCourseTick } from './course.js';
|
||||
import {
|
||||
stopBatch, retryCount, retryWaiting, retryWaitSeconds,
|
||||
completeCurrent, failCurrent, skipCurrent, courseSkipped,
|
||||
} from './complete.js';
|
||||
import { examTick, examPhase } from './exam.js';
|
||||
import { refreshPlatformPoints, cachedPlatformPoints } from './points-platform.js';
|
||||
import {
|
||||
hookAllVideos, readSummary, readCountdown, lessonItems,
|
||||
findNextLessonElement, clickLesson, alignToFirstIncomplete,
|
||||
isLessonCompleted, findFirstIncompleteLessonElement, dumpCatalog,
|
||||
pauseAllMedia, findPlayableVideo, ensurePlaying, readActiveLessonKey,
|
||||
detectQuiz, courseTitle, findNextButton, clickNode,
|
||||
examLessonElements, findPendingExamLesson,
|
||||
} from './player.js';
|
||||
|
||||
function tick() {
|
||||
try {
|
||||
if (window.top !== window.self) return;
|
||||
ensurePanel();
|
||||
if (isLoginPage()) loginPageTick();
|
||||
if (consumePendingStart()) return;
|
||||
|
||||
if (!S.batchRunning) {
|
||||
if (route() === 'course' && state.autoPlayEnabled) {
|
||||
manualCourseTick();
|
||||
} else {
|
||||
R.manualCourseKey = ''; // 离开课程页后,下次进入同一门课要重新对齐
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
const r = route();
|
||||
if (r === 'list') {
|
||||
listTick();
|
||||
} else if (r === 'course') {
|
||||
courseTick();
|
||||
}
|
||||
} catch (e) {
|
||||
console.error(TAG, e);
|
||||
}
|
||||
}
|
||||
|
||||
// 把主循环回填给 login.startBatch(它在点击「一键刷课」后需要立即 tick 一次)
|
||||
setTick(tick);
|
||||
|
||||
// iframe 内只负责接管视频
|
||||
if (window.top !== window.self) {
|
||||
every(function () {
|
||||
try { hookAllVideos(); } catch (e) {}
|
||||
}, CFG.tickMs);
|
||||
} else {
|
||||
ensurePanel();
|
||||
hookAllVideos();
|
||||
every(tick, CFG.tickMs);
|
||||
onWindow(window, 'hashchange', function () {
|
||||
later(tick, 300);
|
||||
});
|
||||
}
|
||||
|
||||
// 调试入口(仅本地使用,可在控制台查看状态)
|
||||
try {
|
||||
Object.defineProperty(window, '__yunXueTangAuto', {
|
||||
value: {
|
||||
S, R, state, points, tick, save: saveRunState, flush: flushRunState, route,
|
||||
// 平台积分台账:调试时可手动刷新(见 dev/tests/points-api-probe.mjs)
|
||||
refreshPlatformPoints, cachedPlatformPoints,
|
||||
// CFG 暴露给无头运行器:脚本内可调参数(重试次数、冷却等)
|
||||
CFG,
|
||||
mediaPage, courseIdFromUrl,
|
||||
readCountdown, readSummary,
|
||||
isLoginPage, loginPageTick,
|
||||
doLoginAndStart, fillLoginForm,
|
||||
startBatch, consumePendingStart,
|
||||
findNextLessonElement, lessonItems,
|
||||
dumpCatalog, clickLesson,
|
||||
alignToFirstIncomplete,
|
||||
isLessonCompleted,
|
||||
findFirstIncompleteLessonElement,
|
||||
listVm, shortCatalogKey,
|
||||
courseIdOfCard,
|
||||
ensureShortCatalog, chooseShortCourse,
|
||||
sortCardsByDuration, formatDuration,
|
||||
pendingShortItems, invalidateShortCatalog,
|
||||
retryCount, retryWaiting, retryWaitSeconds,
|
||||
completeCurrent, failCurrent, skipCurrent, courseSkipped,
|
||||
// 以下供开发/真机测试驱动内部路径使用:
|
||||
scanCards, currentPage, maxPageNumber, startCourse, jumpToPage, nextPage,
|
||||
ensurePointsInventory, pointsAvailability, pointsDone, pointsTarget,
|
||||
startStandalone,
|
||||
listTick, courseTick, manualCourseTick,
|
||||
loginFields, findLoginVm, checkLoginAgreement, setNativeValue,
|
||||
saveCreds, loadCreds, clearSavedCreds,
|
||||
pauseAllMedia, findPlayableVideo, ensurePlaying, readActiveLessonKey,
|
||||
detectQuiz, courseTitle, findNextButton, clickNode,
|
||||
stopBatch,
|
||||
// 考试:调试/真机验证用
|
||||
examTick, examPhase, examLessonElements, findPendingExamLesson,
|
||||
},
|
||||
configurable: true,
|
||||
});
|
||||
} catch (e) { /* ignore */ }
|
||||
|
||||
console.log('%c云学堂助手 v' + VERSION + ' 已加载', 'color:#3c9;font-weight:bold');
|
||||
// 刷课是否在跑由 sessionStorage 里的本标签页状态决定:
|
||||
// 浏览器重启 / 运行器新建标签页后一定是待机,不会在未登录的页面上谎报「运行中」。
|
||||
setStatus(S.batchFinished
|
||||
? '本次已完成 ' + S.completedThisRun + ' 门(已停止)'
|
||||
: (S.batchRunning ? '列表刷课运行中' : '待机'));
|
||||
@@ -1,66 +0,0 @@
|
||||
// ======== 生命周期(支持热替换:新版本注入前先 dispose 旧实例) ========
|
||||
import { PANEL_ID, TAG } from './config.js';
|
||||
|
||||
export const TIMERS = []; // setInterval id
|
||||
export const DELAYS = []; // setTimeout id
|
||||
export const WINDOW_LISTENERS = [];// [target, type, fn]
|
||||
export const ELEMENT_LISTENERS = [];// [el, type, fn]
|
||||
|
||||
export function every(fn, ms) {
|
||||
const id = setInterval(fn, ms);
|
||||
TIMERS.push(id);
|
||||
return id;
|
||||
}
|
||||
|
||||
export function later(fn, ms) {
|
||||
const id = setTimeout(function () {
|
||||
const i = DELAYS.indexOf(id);
|
||||
if (i >= 0) DELAYS.splice(i, 1);
|
||||
try { fn(); } catch (e) { console.error(TAG, e); }
|
||||
}, ms);
|
||||
DELAYS.push(id);
|
||||
return id;
|
||||
}
|
||||
|
||||
export function onWindow(target, type, fn) {
|
||||
target.addEventListener(type, fn);
|
||||
WINDOW_LISTENERS.push([target, type, fn]);
|
||||
}
|
||||
|
||||
export function onElement(el, type, fn) {
|
||||
el.addEventListener(type, fn);
|
||||
ELEMENT_LISTENERS.push([el, type, fn]);
|
||||
}
|
||||
|
||||
// 登记表里的一项:[target, type, fn]
|
||||
function detachListener(x) {
|
||||
x[0].removeEventListener(x[1], x[2]);
|
||||
}
|
||||
|
||||
// 清空一个登记表并逐项释放;单项抛错不影响其余项
|
||||
function drain(arr, fn) {
|
||||
arr.splice(0).forEach(function (x) { try { fn(x); } catch (e) {} });
|
||||
}
|
||||
|
||||
export function dispose() {
|
||||
drain(TIMERS, clearInterval);
|
||||
drain(DELAYS, clearTimeout);
|
||||
drain(WINDOW_LISTENERS, detachListener);
|
||||
drain(ELEMENT_LISTENERS, detachListener);
|
||||
try {
|
||||
document.querySelectorAll('video[data-yun-xue-tang-hooked]').forEach(function (v) {
|
||||
v.removeAttribute('data-yun-xue-tang-hooked');
|
||||
});
|
||||
} catch (e) {}
|
||||
const panel = document.getElementById(PANEL_ID);
|
||||
if (panel && panel.parentNode) panel.parentNode.removeChild(panel);
|
||||
try { delete window.__yunXueTangAuto; } catch (e) {}
|
||||
try { if (window.__yunXueTangDispose === dispose) delete window.__yunXueTangDispose; } catch (e) {}
|
||||
console.log(TAG, '旧实例已释放');
|
||||
}
|
||||
|
||||
try {
|
||||
Object.defineProperty(window, '__yunXueTangDispose', {
|
||||
value: dispose, configurable: true, writable: true,
|
||||
});
|
||||
} catch (e) { /* 重复注入时忽略 */ }
|
||||
-916
@@ -1,916 +0,0 @@
|
||||
// ======== 列表页 ========
|
||||
import {
|
||||
SHORT_CATALOG_TTL, SS_SHORT_CATALOG, SS_POINTS_INVENTORY, POINTS_INVENTORY_TTL, TAG,
|
||||
} from './config.js';
|
||||
import {
|
||||
R, S, state, points, saveRunState, setTargetCatalogUrl, resetCourseRuntime,
|
||||
invalidateShortCatalog, PHASE_ENTERING, PHASE_LEARNING, PHASE_IDLE,
|
||||
} from './state.js';
|
||||
import { apiTypeKey, detectLessonType, nextTarget, pointLabel, POINT_RULES } from './points.js';
|
||||
import { cachedPlatformPoints, platformNoAward, refreshPlatformPoints } from './points-platform.js';
|
||||
import { norm, textOf, truncate } from './utils.js';
|
||||
import { clickNode } from './player.js';
|
||||
import { setStatus, updatePanel } from './panel.js';
|
||||
import { failCurrent, stopBatch, courseSkipped } from './complete.js';
|
||||
import { retryWaiting, retryWaitSeconds } from './complete.js';
|
||||
|
||||
export function scanCards() {
|
||||
return [...document.querySelectorAll('li.kng-list-new__item')].map((li, i) => {
|
||||
const titleEl = li.querySelector('.yxtf-tooltip');
|
||||
const tags = [...li.querySelectorAll('.kng-list-new__tag')].map(textOf);
|
||||
const status = tags.find((t) => /已学完|学习中|未开始|未学习|已完成/.test(t)) ||
|
||||
tags.find((t) => t !== '课程') || '';
|
||||
return {
|
||||
li: li,
|
||||
i: i,
|
||||
title: norm(titleEl ? titleEl.innerText : ''),
|
||||
status: status,
|
||||
tags: tags,
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
export function currentPage() {
|
||||
const el = document.querySelector('.yxtf-pager .number.active');
|
||||
if (!el) return null;
|
||||
const n = Number(textOf(el));
|
||||
return Number.isFinite(n) ? n : null;
|
||||
}
|
||||
|
||||
export function maxPageNumber() {
|
||||
const nums = [...document.querySelectorAll('.yxtf-pager .number')]
|
||||
.map((e) => Number(textOf(e)))
|
||||
.filter((n) => Number.isFinite(n) && n > 0);
|
||||
return nums.length ? Math.max.apply(null, nums) : null;
|
||||
}
|
||||
|
||||
export function cardsSignature(cards) {
|
||||
cards = cards || scanCards();
|
||||
if (!cards.length) return '';
|
||||
return cards.length + '|' + cards[0].title + '|' + cards[cards.length - 1].title;
|
||||
}
|
||||
|
||||
export function jumpToPage(target) {
|
||||
if (!target) return false;
|
||||
if (Date.now() - R.lastPageJumpAt < 3000) return false;
|
||||
R.lastPageJumpAt = Date.now();
|
||||
R.pageChangeAt = Date.now();
|
||||
R.pageChangeSig = cardsSignature();
|
||||
|
||||
const input = document.querySelector(
|
||||
'.yxtf-pagination__editor input, .yxtf-pagination input[type="number"]'
|
||||
);
|
||||
if (input) {
|
||||
try {
|
||||
const setter = Object.getOwnPropertyDescriptor(
|
||||
window.HTMLInputElement.prototype, 'value'
|
||||
).set;
|
||||
setter.call(input, String(target));
|
||||
} catch (e) {
|
||||
input.value = String(target);
|
||||
}
|
||||
input.dispatchEvent(new Event('input', { bubbles: true }));
|
||||
input.dispatchEvent(new Event('change', { bubbles: true }));
|
||||
input.dispatchEvent(new KeyboardEvent('keydown', {
|
||||
key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true,
|
||||
}));
|
||||
console.log(TAG, '跳转到第', target, '页');
|
||||
return true;
|
||||
}
|
||||
|
||||
const btn = [...document.querySelectorAll('.yxtf-pager .number')]
|
||||
.find((e) => Number(textOf(e)) === target);
|
||||
if (btn) {
|
||||
btn.click();
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
export function nextPage() {
|
||||
if (Date.now() - R.lastPageJumpAt < 3000) return;
|
||||
R.lastPageJumpAt = Date.now();
|
||||
R.pageChangeAt = Date.now();
|
||||
R.pageChangeSig = cardsSignature();
|
||||
const btn = document.querySelector('.yxtf-pagination .btn-next');
|
||||
if (btn && !btn.disabled) {
|
||||
btn.click();
|
||||
console.log(TAG, '翻到下一页');
|
||||
}
|
||||
}
|
||||
|
||||
// ======== 短课程优先(时长正序) ========
|
||||
// 列表卡片本身不显示时长,但列表组件(ul.kng-list-new.__vue__)的 kngListData
|
||||
// 里每门课都带 studyHours(秒)。当前页可据此按时长排序;要进一步跨页优先,
|
||||
// 再用同一套列表接口一次性读取全部课程,按 studyHours 正序排队。
|
||||
// 接口失败时逐级降级:跨页队列 → 当前页时长排序 → 原列表顺序,绝不卡住刷课任务。
|
||||
|
||||
export function formatDuration(seconds) {
|
||||
const n = Number(seconds);
|
||||
if (!Number.isFinite(n) || n <= 0) return '时长未知';
|
||||
const minutes = Math.max(1, Math.round(n / 60));
|
||||
if (minutes < 60) return minutes + ' 分钟';
|
||||
const h = Math.floor(minutes / 60);
|
||||
const m = minutes % 60;
|
||||
return h + ' 小时' + (m ? ' ' + m + ' 分钟' : '');
|
||||
}
|
||||
|
||||
function listData(vm) {
|
||||
return (vm && vm.kngListData) || [];
|
||||
}
|
||||
|
||||
// 列表页组件:优先取直接挂载 kngListData 的父组件
|
||||
export function listVm() {
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let vm = ul && ul.__vue__;
|
||||
while (vm && !Array.isArray(vm.kngListData)) vm = vm.$parent;
|
||||
return vm && Array.isArray(vm.kngListData) ? vm : null;
|
||||
}
|
||||
|
||||
// 列表接口的分页/排序参数:缓存 key 与实际请求共用同一份默认值,避免两处飘移
|
||||
function shortQuery(vm) {
|
||||
return {
|
||||
pageSize: Number(vm && vm.pageSize) || 16,
|
||||
orderBy: (vm && vm.sortColumn) || 'createTime',
|
||||
orderType: (vm && vm.sortType) || 'desc',
|
||||
};
|
||||
}
|
||||
|
||||
export function shortCatalogKey(vm) {
|
||||
const q = shortQuery(vm);
|
||||
const key = {
|
||||
collegeId: (vm && vm.collegeId) || '',
|
||||
catalogId: (vm && vm.currentCatalogId) || '',
|
||||
title: (vm && vm.searchKey) || '',
|
||||
type: vm && vm.kngType != null ? vm.kngType : '',
|
||||
allTag: vm && vm.tagIds && vm.tagIds.length ? 0 : 1,
|
||||
tagIds: (vm && vm.tagIds) || [],
|
||||
orderBy: q.orderBy,
|
||||
orderType: q.orderType,
|
||||
pageSize: q.pageSize,
|
||||
};
|
||||
return JSON.stringify(key);
|
||||
}
|
||||
|
||||
export function readShortCatalog(key) {
|
||||
try {
|
||||
const raw = sessionStorage.getItem(SS_SHORT_CATALOG);
|
||||
if (!raw) return null;
|
||||
const obj = JSON.parse(raw);
|
||||
if (!obj || obj.key !== key || !Array.isArray(obj.items)) return null;
|
||||
if (Date.now() - (obj.at || 0) > SHORT_CATALOG_TTL) return null;
|
||||
return obj;
|
||||
} catch (e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
export function writeShortCatalog(cat) {
|
||||
if (!cat) return;
|
||||
try {
|
||||
sessionStorage.setItem(SS_SHORT_CATALOG, JSON.stringify(cat));
|
||||
} catch (e) { /* 容量不足时只保留内存队列 */ }
|
||||
}
|
||||
|
||||
export function shortApiBase() {
|
||||
try {
|
||||
const hit = performance.getEntriesByType('resource')
|
||||
.map(function (e) { return e.name; })
|
||||
.find(function (u) { return /\/kng\/knowledge\/pagelist/.test(u); });
|
||||
if (hit) return new URL(hit).origin + '/kng/knowledge/pagelist';
|
||||
} catch (e) { /* 用默认域名 */ }
|
||||
return 'https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist';
|
||||
}
|
||||
|
||||
export function shortCatalogRequest(vm) {
|
||||
const orgId = (vm && vm.collegeId) || localStorage.getItem('orgId') || '';
|
||||
const token = localStorage.getItem('token') || '';
|
||||
if (!token) throw new Error('未找到登录 token,可能尚未登录或登录已过期');
|
||||
|
||||
const body = JSON.stringify({
|
||||
collegeId: orgId,
|
||||
catalogId: (vm && vm.currentCatalogId) || '',
|
||||
title: (vm && vm.searchKey) || '',
|
||||
type: vm && vm.kngType != null ? vm.kngType : '',
|
||||
allTag: vm && vm.tagIds && vm.tagIds.length ? 0 : 1,
|
||||
tagIds: (vm && vm.tagIds) || [],
|
||||
});
|
||||
const headers = {
|
||||
'content-type': 'application/json;charset=UTF-8',
|
||||
accept: 'application/json, text/plain, */*',
|
||||
token: token,
|
||||
'yxt-orgdomain': location.hostname,
|
||||
source: '501',
|
||||
};
|
||||
return { body: body, headers: headers };
|
||||
}
|
||||
|
||||
// 刚完成的课程平台记账有延迟,这段窗口内不剔除 done 里的旧记录
|
||||
const DONE_STALE_MS = 10 * 60 * 1000;
|
||||
|
||||
// 一次性读取列表接口(limit=6000 可覆盖当前 5000+ 门课程的站点),
|
||||
// 只保留「未学完」的课程,并映射到它所在的页码。
|
||||
async function fetchShortCatalog(vm) {
|
||||
const key = shortCatalogKey(vm);
|
||||
const q = shortQuery(vm);
|
||||
const req = shortCatalogRequest(vm);
|
||||
const api = shortApiBase();
|
||||
const datas = [];
|
||||
let offset = 0;
|
||||
let total = Infinity;
|
||||
let requests = 0;
|
||||
|
||||
while (offset < total && requests < 20) {
|
||||
const limit = Number.isFinite(total) ? Math.min(6000, total - offset) : 6000;
|
||||
if (limit <= 0) break;
|
||||
const url = api + '?limit=' + limit + '&offset=' + offset +
|
||||
'&orderType=' + encodeURIComponent(q.orderType) +
|
||||
'&orderBy=' + encodeURIComponent(q.orderBy);
|
||||
const res = await fetch(url, { method: 'POST', headers: req.headers, body: req.body });
|
||||
if (!res.ok) throw new Error('列表接口 HTTP ' + res.status);
|
||||
const json = await res.json();
|
||||
const list = json && json.datas;
|
||||
if (!Array.isArray(list)) throw new Error('列表接口返回格式异常');
|
||||
if (!list.length) break;
|
||||
datas.push.apply(datas, list);
|
||||
total = Number(json.paging && json.paging.count);
|
||||
if (!Number.isFinite(total)) total = datas.length;
|
||||
offset += list.length;
|
||||
requests++;
|
||||
}
|
||||
|
||||
const items = [];
|
||||
let pruned = 0;
|
||||
datas.forEach(function (item, index) {
|
||||
if (!item || !item.title) return;
|
||||
const title = norm(item.title);
|
||||
if (Number(item.status) === 2 || item.studyComplete === 1 || item.studyComplete === true) return;
|
||||
// 平台说这门课还没学完,但本地 done 里有记录:说明本地快照旧了
|
||||
// (例如平台回滚了进度、或之前是在另一目录下学完的同名课)。
|
||||
// 刚完成的那门课平台记账有延迟,所以只剔除超过 DONE_STALE_MS 的旧记录。
|
||||
if (S.completedTitles[title] && Date.now() - Number(S.completedTitles[title]) > DONE_STALE_MS) {
|
||||
delete S.completedTitles[title];
|
||||
pruned++;
|
||||
}
|
||||
const seconds = Number(item.studyHours);
|
||||
items.push({
|
||||
id: item.id ? String(item.id) : '',
|
||||
title: title,
|
||||
duration: Number.isFinite(seconds) && seconds > 0 ? seconds : 0,
|
||||
status: item.status,
|
||||
page: Math.floor(index / q.pageSize) + 1,
|
||||
});
|
||||
});
|
||||
if (pruned) {
|
||||
saveRunState();
|
||||
console.log(TAG, '平台显示未学完,已重新纳入队列的旧记录:', pruned, '门');
|
||||
}
|
||||
// 时长未知的排最后;相同时按原来的列表顺序(页码)
|
||||
items.sort(function (a, b) {
|
||||
const da = a.duration > 0 ? a.duration : Number.MAX_SAFE_INTEGER;
|
||||
const db = b.duration > 0 ? b.duration : Number.MAX_SAFE_INTEGER;
|
||||
return da === db ? a.page - b.page : da - db;
|
||||
});
|
||||
|
||||
return { key: key, at: Date.now(), pageSize: q.pageSize, total: datas.length, items: items };
|
||||
}
|
||||
|
||||
// 返回 'off' | 'loading' | 'ready' | 'failed'
|
||||
export function ensureShortCatalog() {
|
||||
if (!state.preferShortCourses) return 'off';
|
||||
|
||||
const vm = listVm();
|
||||
if (!vm) {
|
||||
if (!R.shortNoVmSince) R.shortNoVmSince = Date.now();
|
||||
if (Date.now() - R.shortNoVmSince > 5000) {
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
if (Date.now() - (R.shortWarnedAt || 0) > 10000) {
|
||||
R.shortWarnedAt = Date.now();
|
||||
console.warn(TAG, '未找到课程列表组件,退回当前页时长排序');
|
||||
setStatus('未读取到课程列表数据,先按当前页时长排序');
|
||||
}
|
||||
return 'failed';
|
||||
}
|
||||
return 'loading';
|
||||
}
|
||||
R.shortNoVmSince = 0;
|
||||
|
||||
const key = shortCatalogKey(vm);
|
||||
if (R.shortCatalog && R.shortCatalog.key === key &&
|
||||
Date.now() - (R.shortCatalog.at || 0) < SHORT_CATALOG_TTL) {
|
||||
return 'ready';
|
||||
}
|
||||
|
||||
if (R.shortCatalogLoading) {
|
||||
if (Date.now() - R.shortFetchStartedAt > 20000) {
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
return 'failed';
|
||||
}
|
||||
return 'loading';
|
||||
}
|
||||
if (R.shortCatalogFailedAt && Date.now() - R.shortCatalogFailedAt < 30000) return 'failed';
|
||||
|
||||
const cached = readShortCatalog(key);
|
||||
if (cached) {
|
||||
R.shortCatalog = cached;
|
||||
return 'ready';
|
||||
}
|
||||
|
||||
R.shortCatalogLoading = true;
|
||||
R.shortFetchStartedAt = Date.now();
|
||||
setStatus('正在读取课程时长,优先安排短课程…');
|
||||
fetchShortCatalog(vm).then(function (cat) {
|
||||
R.shortCatalogLoading = false;
|
||||
if (!state.preferShortCourses) return;
|
||||
R.shortCatalogFailedAt = 0;
|
||||
R.shortCatalog = cat;
|
||||
writeShortCatalog(cat);
|
||||
const shortest = cat.items[0];
|
||||
console.log(TAG, '短课程队列已就绪:待学', cat.items.length, '门;最短',
|
||||
shortest ? formatDuration(shortest.duration) : '无');
|
||||
setStatus(shortest
|
||||
? '优先短课程:共 ' + cat.items.length + ' 门待学,最短 ' + formatDuration(shortest.duration)
|
||||
: '时长队列为空,按当前页继续');
|
||||
updatePanel();
|
||||
}).catch(function (e) {
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
if (!state.preferShortCourses) return;
|
||||
console.warn(TAG, '读取课程时长失败,退回当前页时长排序:',
|
||||
e && e.message ? e.message : e);
|
||||
setStatus('未能读取全部课程时长,先按当前页时长排序');
|
||||
updatePanel();
|
||||
});
|
||||
return 'loading';
|
||||
}
|
||||
|
||||
export function shortFallback(reason) {
|
||||
R.shortCatalog = null;
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) { /* ignore */ }
|
||||
if (Date.now() - (R.shortWarnedAt || 0) > 10000) {
|
||||
R.shortWarnedAt = Date.now();
|
||||
console.warn(TAG, '短课程优先暂不可用,退回当前页时长排序:', reason);
|
||||
setStatus('短课程优先暂不可用,先按当前页时长排序');
|
||||
}
|
||||
}
|
||||
|
||||
// ======== 每日积分:文档/音频/微课库存 ========
|
||||
// 列表默认只显示课程容器(fileType=course),文档/音频/微课是单条知识,
|
||||
// 要用列表接口的 type 过滤(1=文档 2=视频 3=音频,更高编号留给微课)单独找。
|
||||
// 只读未学完的条目;视频额度不靠这里(靠课程里的视频课时)。
|
||||
|
||||
function emptyPointsInventory() {
|
||||
return { at: Date.now(), doc: [], audio: [], micro: [] };
|
||||
}
|
||||
|
||||
function pointsInventoryCacheKey(vm) {
|
||||
return String((vm && vm.collegeId) || localStorage.getItem('orgId') || '');
|
||||
}
|
||||
|
||||
function readPointsInventory(key) {
|
||||
try {
|
||||
const raw = sessionStorage.getItem(SS_POINTS_INVENTORY);
|
||||
if (!raw) return null;
|
||||
const obj = JSON.parse(raw);
|
||||
if (!obj || obj.key !== key || !obj.doc || !obj.audio || !obj.micro) return null;
|
||||
if (Date.now() - (obj.at || 0) > POINTS_INVENTORY_TTL) return null;
|
||||
return obj;
|
||||
} catch (e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
function writePointsInventory(inv, key) {
|
||||
if (!inv) return;
|
||||
try {
|
||||
sessionStorage.setItem(SS_POINTS_INVENTORY, JSON.stringify({
|
||||
key: key, at: inv.at, doc: inv.doc, audio: inv.audio, micro: inv.micro,
|
||||
}));
|
||||
} catch (e) { /* 容量不足时只用内存库存 */ }
|
||||
}
|
||||
|
||||
function routeForFileType(fileType) {
|
||||
const s = String(fileType || '').toLowerCase();
|
||||
if (s === 'audio') return 'audio/play';
|
||||
if (s === 'video') return 'video/play';
|
||||
if (s === 'document' || s === 'doc') return 'document/play';
|
||||
if (s === 'article') return 'article/play';
|
||||
if (/micro/.test(s)) return 'micro/play';
|
||||
return 'ppt/play';
|
||||
}
|
||||
|
||||
// 一次读齐文档/音频/微课库存。单类失败不影响其它类;全失败才算读取失败。
|
||||
async function fetchPointsInventory(vm) {
|
||||
const req = shortCatalogRequest(vm);
|
||||
const baseBody = JSON.parse(req.body);
|
||||
const api = shortApiBase();
|
||||
const inv = emptyPointsInventory();
|
||||
const seen = new Set();
|
||||
const types = [1, 3, 4, 5, 6, 7, 8];
|
||||
let failed = 0;
|
||||
|
||||
for (const type of types) {
|
||||
let list = null;
|
||||
try {
|
||||
const body = JSON.stringify(Object.assign({}, baseBody, { type: String(type) }));
|
||||
const res = await fetch(api + '?limit=50&offset=0&orderType=desc&orderBy=createTime', {
|
||||
method: 'POST', headers: req.headers, body: body,
|
||||
});
|
||||
if (!res.ok) throw new Error('HTTP ' + res.status);
|
||||
const json = await res.json();
|
||||
list = Array.isArray(json && json.datas) ? json.datas : [];
|
||||
} catch (e) {
|
||||
failed++;
|
||||
continue;
|
||||
}
|
||||
for (const item of list) {
|
||||
if (!item || !item.title) continue;
|
||||
if (Number(item.status) === 2 || item.studyComplete === 1 || item.studyComplete === true) continue;
|
||||
const key = apiTypeKey(item.type) || detectLessonType({ fileType: item.fileType });
|
||||
if (!key || key === 'video') continue; // 视频靠课程里的课时
|
||||
const id = item.id ? String(item.id) : '';
|
||||
if (!id || seen.has(id)) continue;
|
||||
seen.add(id);
|
||||
inv[key].push({
|
||||
id: id,
|
||||
title: norm(item.title),
|
||||
fileType: item.fileType || '',
|
||||
route: routeForFileType(item.fileType),
|
||||
hours: Number(item.studyHours) || 0,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
if (failed >= types.length) throw new Error('积分库存接口全部失败');
|
||||
return inv;
|
||||
}
|
||||
|
||||
// 返回 'off' | 'loading' | 'ready' | 'failed'
|
||||
export function ensurePointsInventory() {
|
||||
if (!state.pointsEnabled) return 'off';
|
||||
if (R.pointsInventory) return 'ready';
|
||||
|
||||
const vm = listVm();
|
||||
if (!vm) {
|
||||
if (!R.pointsNoVmSince) R.pointsNoVmSince = Date.now();
|
||||
if (Date.now() - R.pointsNoVmSince > 5000) {
|
||||
R.pointsInventory = emptyPointsInventory();
|
||||
R.pointsInventoryFailedAt = Date.now();
|
||||
if (Date.now() - (R.pointsWarnedAt || 0) > 10000) {
|
||||
R.pointsWarnedAt = Date.now();
|
||||
console.warn(TAG, '未找到课程列表组件,积分库存按「只有视频课时」处理');
|
||||
}
|
||||
return 'failed';
|
||||
}
|
||||
return 'loading';
|
||||
}
|
||||
R.pointsNoVmSince = 0;
|
||||
|
||||
if (R.pointsInventoryLoading) {
|
||||
if (Date.now() - R.pointsFetchStartedAt > 20000) {
|
||||
R.pointsInventoryLoading = false;
|
||||
R.pointsInventory = emptyPointsInventory();
|
||||
R.pointsInventoryFailedAt = Date.now();
|
||||
return 'failed';
|
||||
}
|
||||
return 'loading';
|
||||
}
|
||||
if (R.pointsInventoryFailedAt && Date.now() - R.pointsInventoryFailedAt < 30000) return 'failed';
|
||||
|
||||
const key = pointsInventoryCacheKey(vm);
|
||||
const cached = readPointsInventory(key);
|
||||
if (cached) {
|
||||
R.pointsInventory = cached;
|
||||
return 'ready';
|
||||
}
|
||||
|
||||
R.pointsInventoryLoading = true;
|
||||
R.pointsFetchStartedAt = Date.now();
|
||||
setStatus('正在读取文档/音频/微课库存…');
|
||||
fetchPointsInventory(vm).then(function (inv) {
|
||||
R.pointsInventoryLoading = false;
|
||||
R.pointsInventory = inv;
|
||||
writePointsInventory(inv, key);
|
||||
const parts = POINT_RULES
|
||||
.filter(function (r) { return r.key !== 'video'; })
|
||||
.map(function (r) { return r.label + ' ' + ((inv[r.key] && inv[r.key].length) || 0) + ' 条'; });
|
||||
console.log(TAG, '积分库存已就绪:' + parts.join(','));
|
||||
updatePanel();
|
||||
}).catch(function (e) {
|
||||
R.pointsInventoryLoading = false;
|
||||
R.pointsInventory = emptyPointsInventory();
|
||||
R.pointsInventoryFailedAt = Date.now();
|
||||
if (Date.now() - (R.pointsWarnedAt || 0) > 10000) {
|
||||
R.pointsWarnedAt = Date.now();
|
||||
console.warn(TAG, '读取积分库存失败,按「只有视频课时」处理:', e && e.message ? e.message : e);
|
||||
}
|
||||
});
|
||||
return 'loading';
|
||||
}
|
||||
|
||||
// 某类还有没有可学的单条内容(排除本轮已完成 / 已跳过)
|
||||
function nextPointsItem(type) {
|
||||
const inv = R.pointsInventory;
|
||||
const arr = (inv && inv[type]) || [];
|
||||
return arr.find(function (item) {
|
||||
if (!item || !item.title) return false;
|
||||
if (S.completedTitles[item.title] || courseSkipped(item.title)) return false;
|
||||
return true;
|
||||
}) || null;
|
||||
}
|
||||
|
||||
export function pointsAvailability(videoAvailable) {
|
||||
return {
|
||||
doc: !!nextPointsItem('doc'),
|
||||
video: videoAvailable !== false,
|
||||
audio: !!nextPointsItem('audio'),
|
||||
micro: !!nextPointsItem('micro'),
|
||||
};
|
||||
}
|
||||
|
||||
export function pointsDone() {
|
||||
if (!state.pointsEnabled) return false;
|
||||
// 平台台账说今天的学习积分已经到上限 → 以平台为准直接收尾
|
||||
const p = cachedPlatformPoints();
|
||||
if (p && p.ok && p.maxPoints > 0 && p.todayPoints >= p.maxPoints) return true;
|
||||
return points.done(pointsAvailability());
|
||||
}
|
||||
|
||||
export function pointsTarget() {
|
||||
return nextTarget({
|
||||
isFull: function (key) { return points.isFull(key); },
|
||||
available: pointsAvailability(),
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
// 进入单条文档/音频/微课:直接按 kngId 打开对应播放页
|
||||
export function startStandalone(item, type) {
|
||||
if (!item) return false;
|
||||
R.lastCardClickAt = Date.now();
|
||||
R.shortJumpAt = 0;
|
||||
S.activeCourse = {
|
||||
title: item.title,
|
||||
id: item.id,
|
||||
startedAt: Date.now(),
|
||||
standalone: true,
|
||||
pointType: type,
|
||||
};
|
||||
S.coursePhase = PHASE_ENTERING;
|
||||
S.awaitingListReturn = false;
|
||||
resetCourseRuntime();
|
||||
saveRunState();
|
||||
const label = pointLabel(type);
|
||||
setStatus('进入' + label + ':' + truncate(item.title, 26));
|
||||
console.log(TAG, '进入' + label, item.title, '(积分模式)');
|
||||
location.href = location.origin + '/kng/#/' + item.route + '?kngId=' + encodeURIComponent(item.id);
|
||||
return true;
|
||||
}
|
||||
|
||||
export function pendingShortItems() {
|
||||
const cat = R.shortCatalog;
|
||||
if (!cat) return [];
|
||||
return cat.items.filter(function (item) {
|
||||
if (!item || !item.title) return false;
|
||||
// 只排除「本轮已完成」与「本轮已跳过(考试交不了)」;其它失败一律重试,不拉黑
|
||||
if (S.completedTitles[item.title] || courseSkipped(item.title)) return false;
|
||||
return true;
|
||||
});
|
||||
}
|
||||
|
||||
// 列表卡片 -> 课程 id。卡片的打开逻辑按 id 跳转,而播放页 URL 带 kngId:
|
||||
// 有了 id 就能在标题还没刷新时准确判断「进的是不是队列里的这门课」,
|
||||
// 不再因为页面标题短暂是 loading/在线课堂 就误判并退回列表。
|
||||
export function courseIdOfCard(card) {
|
||||
if (!card) return '';
|
||||
const vm = listVm();
|
||||
const data = listData(vm);
|
||||
const byIndex = data[card.i];
|
||||
const t = norm(card.title);
|
||||
if (byIndex && String(byIndex.id || '') && norm(byIndex.title) === t) {
|
||||
return String(byIndex.id);
|
||||
}
|
||||
const hit = data.find(function (x) { return x && norm(x.title) === t; });
|
||||
return hit && hit.id ? String(hit.id) : '';
|
||||
}
|
||||
|
||||
export function durationOfCard(card, vm) {
|
||||
if (!card) return 0;
|
||||
const data = listData(vm);
|
||||
const hit = data.find(function (item) { return norm(item.title) === card.title; });
|
||||
const n = hit ? Number(hit.studyHours) : 0;
|
||||
return Number.isFinite(n) && n > 0 ? n : 0;
|
||||
}
|
||||
|
||||
// 优先用课程 id 匹配卡片,避免同名课程(平台上确实有)点错;
|
||||
// id 不可用时再退回标题匹配。
|
||||
export function cardForShortItem(cards, item) {
|
||||
if (!item) return null;
|
||||
if (item.id) {
|
||||
const vm = listVm();
|
||||
const data = listData(vm);
|
||||
const index = data.findIndex(function (x) { return x && String(x.id) === item.id; });
|
||||
if (index >= 0 && cards[index] && cards[index].title === item.title) return cards[index];
|
||||
}
|
||||
return cards.find(function (c) { return c.title === item.title; }) || null;
|
||||
}
|
||||
|
||||
export function sortCardsByDuration(cards, vm) {
|
||||
vm = vm || listVm();
|
||||
return cards.slice().sort(function (a, b) {
|
||||
const da = durationOfCard(a, vm) || Number.MAX_SAFE_INTEGER;
|
||||
const db = durationOfCard(b, vm) || Number.MAX_SAFE_INTEGER;
|
||||
return da - db;
|
||||
});
|
||||
}
|
||||
|
||||
export function forgetShortCourse(title) {
|
||||
const t = norm(title);
|
||||
if (!t || !R.shortCatalog || !Array.isArray(R.shortCatalog.items)) return;
|
||||
const before = R.shortCatalog.items.length;
|
||||
R.shortCatalog.items = R.shortCatalog.items.filter(function (item) { return item.title !== t; });
|
||||
if (R.shortCatalog.items.length !== before) writeShortCatalog(R.shortCatalog);
|
||||
}
|
||||
|
||||
// 时长队列是否可用(可用时页码导航由 chooseShortCourse 独占,listTick 不再恢复页码)
|
||||
export function isShortCatalogActive() {
|
||||
return !!(state.preferShortCourses && R.shortCatalog &&
|
||||
Date.now() - (R.shortCatalog.at || 0) < SHORT_CATALOG_TTL);
|
||||
}
|
||||
|
||||
// 返回 { card } 表示本 tick 可以进入该课程;{ wait: true } 表示正在加载/翻页。
|
||||
export function chooseShortCourse(cards, pending) {
|
||||
if (!state.preferShortCourses) return null;
|
||||
const status = ensureShortCatalog();
|
||||
|
||||
if (status === 'loading') return { wait: true };
|
||||
|
||||
if (status === 'ready') {
|
||||
const items = pendingShortItems();
|
||||
if (items.length) {
|
||||
const target = items[0];
|
||||
const page = currentPage() || S.listPage || 1;
|
||||
if (target.page && target.page !== page) {
|
||||
if (Date.now() - R.shortJumpAt < 6000) return { wait: true };
|
||||
R.shortJumpAt = Date.now();
|
||||
if (jumpToPage(target.page)) {
|
||||
S.listPage = target.page;
|
||||
saveRunState();
|
||||
setStatus('优先短课程:转到第 ' + target.page + ' 页(' +
|
||||
formatDuration(target.duration) + ')');
|
||||
return { wait: true };
|
||||
}
|
||||
if (Date.now() - R.lastPageJumpAt < 3500) return { wait: true };
|
||||
shortFallback('无法跳转到第 ' + target.page + ' 页');
|
||||
} else {
|
||||
const card = cardForShortItem(cards, target);
|
||||
if (card) {
|
||||
if (card.status === '已学完' || S.completedTitles[card.title] ||
|
||||
courseSkipped(card.title)) {
|
||||
// 缓存与实际状态不一致:剔除这一门,下一 tick 继续挑下一门
|
||||
forgetShortCourse(card.title);
|
||||
return { wait: true };
|
||||
}
|
||||
card.duration = target.duration;
|
||||
R.shortJumpAt = 0;
|
||||
return { card: card };
|
||||
}
|
||||
// 刚翻到目标页时卡片可能还没渲染完
|
||||
if (Date.now() - R.shortJumpAt < 8000) return { wait: true };
|
||||
shortFallback('目标课程不在第 ' + target.page + ' 页');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 兜底:当前页未学完课程按时长正序
|
||||
if (pending && pending.length) {
|
||||
const vm = listVm();
|
||||
const sorted = sortCardsByDuration(pending, vm);
|
||||
if (sorted.length) {
|
||||
sorted[0].duration = durationOfCard(sorted[0], vm);
|
||||
return { card: sorted[0] };
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 短课程优先时页码归 chooseShortCourse 管:它知道下一门课在第几页,会直接跳过去。
|
||||
// 只有「没开短课程优先」或「时长队列拿不到(已明确失败)」时,listTick 才去恢复页码。
|
||||
function shouldRestorePage() {
|
||||
if (!state.preferShortCourses) return true;
|
||||
if (isShortCatalogActive()) return false;
|
||||
// 队列还在加载:先别跳,等 chooseShortCourse 一次跳到位
|
||||
if (R.shortCatalogLoading) return false;
|
||||
return !!R.shortCatalogFailedAt;
|
||||
}
|
||||
|
||||
export function listTick() {
|
||||
const cards = scanCards();
|
||||
if (!cards.length) return; // 列表还没渲染
|
||||
|
||||
// 等待翻页后的新卡片,避免用旧卡片做判断
|
||||
if (R.pageChangeSig) {
|
||||
if (cardsSignature(cards) === R.pageChangeSig &&
|
||||
Date.now() - R.pageChangeAt < 10000) {
|
||||
return;
|
||||
}
|
||||
R.pageChangeSig = '';
|
||||
}
|
||||
if (R.pageChangeAt && Date.now() - R.pageChangeAt < 1500) return;
|
||||
|
||||
// 列表 URL 同时是「目标目录」偏好:它决定刷哪个学院的课,
|
||||
// 也是短课程队列的缓存键来源,所以单独存 localStorage。
|
||||
if (S.catalogUrl !== location.href) setTargetCatalogUrl(location.href, { silent: true });
|
||||
|
||||
const page = currentPage();
|
||||
|
||||
// 回到列表后,恢复到课程所在的页码(仅在拿不到时长队列时才需要)
|
||||
if (S.awaitingListReturn && !shouldRestorePage()) {
|
||||
// 页码不需要恢复:直接交给 chooseShortCourse / 当前页继续
|
||||
S.awaitingListReturn = false;
|
||||
R.pageRestoreAttempts = 0;
|
||||
saveRunState();
|
||||
} else if (S.awaitingListReturn) {
|
||||
if (page != null && S.listPage && page !== S.listPage) {
|
||||
R.pageRestoreAttempts++;
|
||||
if (R.pageRestoreAttempts > 12) {
|
||||
console.warn(TAG, '页码恢复失败,改用当前页继续');
|
||||
S.listPage = page || 1;
|
||||
S.awaitingListReturn = false;
|
||||
saveRunState();
|
||||
} else if (S.listPage > page) {
|
||||
// 短课程优先会直接跳到很靠后的页(例如第 307 页),
|
||||
// 不能一页一页 nextPage,否则要翻几百次;优先用页码输入框直跳。
|
||||
if (jumpToPage(S.listPage)) return;
|
||||
nextPage();
|
||||
return;
|
||||
} else {
|
||||
jumpToPage(S.listPage);
|
||||
return;
|
||||
}
|
||||
} else {
|
||||
S.awaitingListReturn = false;
|
||||
R.pageRestoreAttempts = 0;
|
||||
saveRunState();
|
||||
setStatus('回到列表第 ' + (page || 1) + ' 页,继续…');
|
||||
}
|
||||
}
|
||||
|
||||
// 记录当前页
|
||||
if (!S.awaitingListReturn && page != null && page !== S.listPage) {
|
||||
S.listPage = page;
|
||||
saveRunState();
|
||||
}
|
||||
|
||||
// 已在进入课程的过程中:等路由跳转
|
||||
if (S.activeCourse && S.coursePhase === PHASE_ENTERING) {
|
||||
const waited = Date.now() - (S.activeCourse.startedAt || 0);
|
||||
if (waited > 15000) {
|
||||
failCurrent('未能进入课程页面');
|
||||
return;
|
||||
}
|
||||
// 列表卡片点击偶尔会落在脚本/路由就绪之前(页面毫无反应)。还停在列表时
|
||||
// 最多补点两次,而不是提前判这门课未完成。
|
||||
if (waited > 4000 && R.entryRetries < 2 &&
|
||||
Date.now() - R.lastCardClickAt > 4000) {
|
||||
const card = cards.find(function (c) { return c.title === S.activeCourse.title; });
|
||||
if (card) {
|
||||
R.entryRetries++;
|
||||
R.lastCardClickAt = Date.now();
|
||||
console.log(TAG, '进入课程超时,重试点击卡片(第', R.entryRetries, '次)');
|
||||
setStatus('重新进入课程:' + truncate(S.activeCourse.title, 22));
|
||||
try { clickNode(card.li); } catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 从课程页意外回到列表:判断当前课程是已完成还是中断
|
||||
if (S.activeCourse && S.coursePhase === PHASE_LEARNING) {
|
||||
if (!R.listWithCurrentSince) R.listWithCurrentSince = Date.now();
|
||||
if (Date.now() - R.listWithCurrentSince < 5000) return;
|
||||
|
||||
const card = cards.find(function (c) { return c.title === S.activeCourse.title; });
|
||||
if (card && /已学完|已完成|已学习/.test(card.status)) {
|
||||
S.completedTitles[S.activeCourse.title] = Date.now();
|
||||
S.completedThisRun = (S.completedThisRun || 0) + 1;
|
||||
}
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = false;
|
||||
R.listWithCurrentSince = 0;
|
||||
// 回到列表就重新拿平台实时状态(不用本地旧快照选课)
|
||||
invalidateShortCatalog();
|
||||
saveRunState();
|
||||
setStatus('已重置中断的课程状态,继续…');
|
||||
}
|
||||
|
||||
if (S.activeCourse) return; // 其他异常情况,等路由
|
||||
|
||||
// 上一门没学完、正在退避等待时不进任何课:到点后直接重进同一门(它仍是最短的未完成课)
|
||||
if (retryWaiting()) {
|
||||
const left = retryWaitSeconds();
|
||||
// 只在秒数变化时刷状态,避免每 tick 都打一行日志
|
||||
if (R.retryStatusSec !== left) {
|
||||
R.retryStatusSec = left;
|
||||
setStatus('等待重试:' + truncate(R.retryTitle || '上一门课', 20) +
|
||||
'(' + left + ' 秒后)');
|
||||
}
|
||||
return;
|
||||
}
|
||||
R.retryStatusSec = -1;
|
||||
|
||||
// 每日积分模式:先补文档/音频/微课的单条内容;视频额度靠课程里的视频课时。
|
||||
// 四类都满额(或剩余类型确认没内容)就收尾,不再无意义地刷课。
|
||||
if (state.pointsEnabled) {
|
||||
// 每次到列表页都顺带刷新平台台账(内部有 20 秒缓存,不会刷爆接口)
|
||||
refreshPlatformPoints(points);
|
||||
const invStatus = ensurePointsInventory();
|
||||
if (invStatus === 'loading') return;
|
||||
if (platformNoAward()) {
|
||||
stopBatch('平台连续 3 门课未入账,判定今日积分已满或没有可计分内容');
|
||||
return;
|
||||
}
|
||||
if (pointsDone()) {
|
||||
// 台账明细由面板和收尾通知单独展示,状态栏只留结论,避免同一段文字出现两遍
|
||||
console.log(TAG, '今日积分:平台台账已达上限或可用内容已学完', points.summary());
|
||||
stopBatch('可用内容已学完');
|
||||
return;
|
||||
}
|
||||
const target = pointsTarget();
|
||||
if (!target) {
|
||||
stopBatch('剩余积分类型都没有可学内容');
|
||||
return;
|
||||
}
|
||||
if (target.kind === 'item') {
|
||||
const item = nextPointsItem(target.type);
|
||||
if (item) {
|
||||
if (Date.now() - R.lastCardClickAt < 3000) return;
|
||||
startStandalone(item, target.type);
|
||||
return;
|
||||
}
|
||||
}
|
||||
// target.kind === 'course':继续走下面的短课程 / 原顺序选课
|
||||
}
|
||||
|
||||
const pending = cards.filter((c) => {
|
||||
if (!c.title) return false;
|
||||
if (/已学完|已完成|已学习/.test(c.status)) return false;
|
||||
if (S.completedTitles[c.title] || courseSkipped(c.title)) return false;
|
||||
return true;
|
||||
});
|
||||
|
||||
// 优先短课程:先读时长队列,跨页挑总时长最短的未学完课程;
|
||||
// 接口不可用时 chooseShortCourse 会退回当前页时长排序或原列表顺序。
|
||||
if (state.preferShortCourses) {
|
||||
const choice = chooseShortCourse(cards, pending);
|
||||
if (choice && choice.wait) return;
|
||||
if (choice && choice.card) {
|
||||
if (Date.now() - R.lastCardClickAt < 5000) return;
|
||||
startCourse(choice.card);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
if (pending.length) {
|
||||
if (Date.now() - R.lastCardClickAt < 5000) return;
|
||||
startCourse(pending[0]);
|
||||
return;
|
||||
}
|
||||
|
||||
const max = maxPageNumber();
|
||||
if (page != null && max && page < max) {
|
||||
nextPage();
|
||||
return;
|
||||
}
|
||||
|
||||
stopBatch('所有页面的未学完课程都已处理完毕');
|
||||
}
|
||||
|
||||
export function startCourse(card) {
|
||||
const page = currentPage() || S.listPage || 1;
|
||||
S.activeCourse = {
|
||||
title: card.title,
|
||||
id: courseIdOfCard(card),
|
||||
startedAt: Date.now(),
|
||||
};
|
||||
S.listPage = page;
|
||||
S.coursePhase = PHASE_ENTERING;
|
||||
S.awaitingListReturn = false;
|
||||
R.lastCardClickAt = Date.now();
|
||||
R.shortJumpAt = 0;
|
||||
resetCourseRuntime();
|
||||
saveRunState();
|
||||
const durationText = card.duration ? '(' + formatDuration(card.duration) + ')' : '';
|
||||
setStatus('进入课程' + durationText + ':' + truncate(card.title, 28));
|
||||
console.log(TAG, '进入课程', card.title, '状态', card.status,
|
||||
card.duration ? '时长 ' + formatDuration(card.duration) : '');
|
||||
try {
|
||||
card.li.click();
|
||||
} catch (e) {
|
||||
console.error(TAG, e);
|
||||
failCurrent('课程卡片点击失败');
|
||||
}
|
||||
}
|
||||
-308
@@ -1,308 +0,0 @@
|
||||
// ======== 登录 / 一键刷课 ========
|
||||
import { LS_LOGIN, LS_PENDING } from './config.js';
|
||||
import { R, S, saveRunState, invalidateShortCatalog, PHASE_IDLE } from './state.js';
|
||||
import { route, goToList } from './route.js';
|
||||
import { truncate, isVisible, findVisibleButton } from './utils.js';
|
||||
import { later, onElement } from './lifecycle.js';
|
||||
import { setStatus, updatePanel, loginUserEl, loginPassEl, loginRememberEl, loginAutoEl } from './panel.js';
|
||||
|
||||
// startBatch 内部会调用 tick()(主循环),tick 定义在 index.js;
|
||||
// 用可变绑定 + setter 在 index.js 装配阶段回填,避免 login -> index 的循环导入。
|
||||
let tick = function () {};
|
||||
export function setTick(fn) { tick = fn; }
|
||||
|
||||
// 「登录后自动开始刷课」的一次性标记,用完/失效就清掉
|
||||
function clearPending() {
|
||||
try { localStorage.removeItem(LS_PENDING); } catch (e) {}
|
||||
}
|
||||
|
||||
export function isLoginPage() {
|
||||
if (/\/login(\.html)?($|[?#])/i.test(location.pathname + location.search)) return true;
|
||||
if (/^#\/login/i.test(location.hash)) return true;
|
||||
return !!document.querySelector('input[type="password"]') && /登录/.test(document.title);
|
||||
}
|
||||
|
||||
export function loginFields() {
|
||||
const pwd = [...document.querySelectorAll('input[type="password"]')].find(isVisible) || null;
|
||||
const all = [...document.querySelectorAll('input')].filter(isVisible);
|
||||
let user = all.find(function (el) {
|
||||
return /员工邮箱|账号|用户名|邮箱|手机号/.test(el.placeholder || '');
|
||||
}) || null;
|
||||
if (!user && pwd) {
|
||||
const pi = all.indexOf(pwd);
|
||||
for (let i = pi - 1; i >= 0; i--) {
|
||||
const el = all[i];
|
||||
if (el.type === 'text' || el.type === 'email' || !el.type) { user = el; break; }
|
||||
}
|
||||
}
|
||||
return { user: user, pwd: pwd };
|
||||
}
|
||||
|
||||
export function setNativeValue(el, value) {
|
||||
if (!el) return false;
|
||||
try {
|
||||
const proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
|
||||
const setter = Object.getOwnPropertyDescriptor(proto, 'value').set;
|
||||
setter.call(el, value);
|
||||
} catch (e) {
|
||||
el.value = value;
|
||||
}
|
||||
el.dispatchEvent(new Event('input', { bubbles: true }));
|
||||
el.dispatchEvent(new Event('change', { bubbles: true }));
|
||||
el.dispatchEvent(new Event('blur', { bubbles: true }));
|
||||
return true;
|
||||
}
|
||||
|
||||
export function findLoginVm() {
|
||||
const btn = findVisibleButton(/^登录$/);
|
||||
let vm = btn && btn.__vue__;
|
||||
while (vm && vm.$options.name !== 'Login') vm = vm.$parent;
|
||||
if (vm) return vm;
|
||||
for (const el of document.querySelectorAll('#app, #app *')) {
|
||||
const v = el.__vue__;
|
||||
if (v && v.pwdLoginForm) return v;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function fillLoginForm(user, pass) {
|
||||
const f = loginFields();
|
||||
if (!f.user || !f.pwd) return false;
|
||||
setNativeValue(f.user, user);
|
||||
setNativeValue(f.pwd, pass);
|
||||
const vm = findLoginVm();
|
||||
if (vm && vm.pwdLoginForm) {
|
||||
vm.pwdLoginForm.userName = user;
|
||||
vm.pwdLoginForm.password = pass;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
export function checkLoginAgreement() {
|
||||
const labels = [...document.querySelectorAll('label')].filter(function (l) {
|
||||
return /已阅读并同意|隐私政策/.test(l.innerText || '') && isVisible(l);
|
||||
});
|
||||
if (!labels.length) return true;
|
||||
for (const label of labels) {
|
||||
const cb = label.querySelector('input[type="checkbox"]');
|
||||
if (!cb) continue;
|
||||
if (!cb.checked) {
|
||||
try { label.click(); } catch (e) {}
|
||||
}
|
||||
if (!cb.checked) {
|
||||
try { cb.click(); } catch (e) {}
|
||||
}
|
||||
if (cb.checked) return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
export function b64enc(s) {
|
||||
const bytes = new TextEncoder().encode(String(s));
|
||||
let bin = '';
|
||||
for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
|
||||
return btoa(bin);
|
||||
}
|
||||
|
||||
export function b64dec(s) {
|
||||
const bin = atob(String(s));
|
||||
const bytes = new Uint8Array(bin.length);
|
||||
for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
|
||||
return new TextDecoder().decode(bytes);
|
||||
}
|
||||
|
||||
export function saveCreds(user, pass, remember, auto) {
|
||||
try {
|
||||
if (!remember) {
|
||||
localStorage.removeItem(LS_LOGIN);
|
||||
return;
|
||||
}
|
||||
localStorage.setItem(LS_LOGIN, b64enc(JSON.stringify({ u: user, p: pass, auto: !!auto })));
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function loadCreds() {
|
||||
try {
|
||||
const raw = localStorage.getItem(LS_LOGIN);
|
||||
if (!raw) return null;
|
||||
const obj = JSON.parse(b64dec(raw));
|
||||
if (!obj || !obj.u || !obj.p) return null;
|
||||
return { u: String(obj.u), p: String(obj.p), auto: !!obj.auto };
|
||||
} catch (e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
export function clearSavedCreds() {
|
||||
try { localStorage.removeItem(LS_LOGIN); } catch (e) {}
|
||||
if (loginRememberEl) loginRememberEl.checked = false;
|
||||
}
|
||||
|
||||
export function startBatch() {
|
||||
const freshStart = !S.batchRunning;
|
||||
if (S.batchFinished) {
|
||||
S.completedThisRun = 0;
|
||||
S.batchFinished = false;
|
||||
// 重新开启一轮时清掉重试计数:之前那些课允许重新尝试
|
||||
S.courseRetries = {};
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
}
|
||||
if (freshStart) {
|
||||
// 新一轮(含重启后重新开跑):考试相关的本轮记录也清零。
|
||||
// 否则上次会话里的「已跳过 / 已交卷 N 次」会让这门课开跑就被跳过,
|
||||
// 人工处理过考试也得不到重新尝试的机会。
|
||||
S.skippedCourses = {};
|
||||
S.examEmptySubmits = {};
|
||||
}
|
||||
S.batchRunning = true;
|
||||
// 开跑时丢掉旧的时长队列:第一门课也要按平台实时状态挑
|
||||
invalidateShortCatalog();
|
||||
if (!S.activeCourse) S.coursePhase = PHASE_IDLE;
|
||||
saveRunState();
|
||||
setStatus('列表刷课已开启');
|
||||
const r = route();
|
||||
if (r === 'list' || (r === 'course' && S.activeCourse)) {
|
||||
tick();
|
||||
} else {
|
||||
goToList();
|
||||
}
|
||||
updatePanel();
|
||||
}
|
||||
|
||||
export function consumePendingStart() {
|
||||
let ts = 0;
|
||||
try { ts = Number(localStorage.getItem(LS_PENDING) || 0); } catch (e) {}
|
||||
if (!ts) return false;
|
||||
if (Date.now() - ts > 5 * 60 * 1000) {
|
||||
clearPending();
|
||||
return false;
|
||||
}
|
||||
if (isLoginPage()) return false;
|
||||
clearPending();
|
||||
startBatch();
|
||||
return true;
|
||||
}
|
||||
|
||||
export function watchLoginResult() {
|
||||
if (!isLoginPage()) return;
|
||||
const vm = findLoginVm();
|
||||
if (vm && vm.captchaVisible) {
|
||||
setStatus('需要手动完成验证码/滑块,完成后会自动继续');
|
||||
return; // 保留 pending,手动完成登录后仍会自动开始
|
||||
}
|
||||
if (vm && typeof vm.pwd_tips === 'string' && vm.pwd_tips.trim()) {
|
||||
clearPending();
|
||||
R.loginSubmittingAt = 0;
|
||||
setStatus('登录失败:' + truncate(vm.pwd_tips.trim(), 50));
|
||||
return;
|
||||
}
|
||||
const txt = document.body.innerText || '';
|
||||
const err = txt.match(/(用户名密码错误[^\n]{0,60}|账号或密码错误[^\n]{0,60}|密码错误[^\n]{0,60}|账号不存在[^\n]{0,60}|登录失败[^\n]{0,60})/);
|
||||
if (err) {
|
||||
clearPending();
|
||||
R.loginSubmittingAt = 0;
|
||||
setStatus('登录失败:' + truncate(err[0], 50));
|
||||
return;
|
||||
}
|
||||
if (/验证码|安全验证|滑块/.test(txt) && R.loginSubmittingAt) {
|
||||
setStatus('需要手动完成验证码/滑块,完成后会自动继续');
|
||||
return; // 保留 pending,手动完成登录后仍会自动开始
|
||||
}
|
||||
if (R.loginSubmittingAt && Date.now() - R.loginSubmittingAt > 12000) {
|
||||
R.loginSubmittingAt = 0;
|
||||
setStatus('尚未登录成功:请检查账号密码,或手动完成验证');
|
||||
}
|
||||
}
|
||||
|
||||
export function doLoginAndStart() {
|
||||
const f = loginFields();
|
||||
const user = (loginUserEl ? loginUserEl.value.trim() : '') ||
|
||||
(f.user ? String(f.user.value || '').trim() : '');
|
||||
const pass = (loginPassEl ? loginPassEl.value : '') ||
|
||||
(f.pwd ? String(f.pwd.value || '') : '');
|
||||
if (!user || !pass) {
|
||||
setStatus('请先填写账号和密码');
|
||||
return;
|
||||
}
|
||||
if (loginUserEl) loginUserEl.value = user;
|
||||
if (loginPassEl) loginPassEl.value = pass;
|
||||
|
||||
const remember = !!(loginRememberEl && loginRememberEl.checked);
|
||||
const auto = !!(loginAutoEl && loginAutoEl.checked);
|
||||
saveCreds(user, pass, remember, auto);
|
||||
|
||||
fillLoginForm(user, pass);
|
||||
if (!checkLoginAgreement()) {
|
||||
setStatus('请先勾选《隐私政策》');
|
||||
return;
|
||||
}
|
||||
|
||||
try { localStorage.setItem(LS_PENDING, String(Date.now())); } catch (e) {}
|
||||
R.loginSubmittingAt = Date.now();
|
||||
R.loginAutoTried = true;
|
||||
setStatus('正在登录…');
|
||||
|
||||
const vm = findLoginVm();
|
||||
if (vm) {
|
||||
try {
|
||||
if (vm.pwdLoginForm) {
|
||||
vm.pwdLoginForm.userName = user;
|
||||
vm.pwdLoginForm.password = pass;
|
||||
}
|
||||
try { vm.agreeSecretProtocol = true; } catch (e) {}
|
||||
const p = vm.handleLogin();
|
||||
if (p && typeof p.catch === 'function') {
|
||||
p.catch(function (e) {
|
||||
setStatus('登录异常:' + (e && e.message ? e.message : e));
|
||||
});
|
||||
}
|
||||
} catch (e) {
|
||||
setStatus('登录异常:' + (e && e.message ? e.message : e));
|
||||
}
|
||||
} else {
|
||||
const btn = findVisibleButton(/^登录$/);
|
||||
if (btn) {
|
||||
try { btn.click(); } catch (e) {}
|
||||
} else {
|
||||
setStatus('未找到登录按钮,请手动点击');
|
||||
}
|
||||
}
|
||||
later(watchLoginResult, 2500);
|
||||
}
|
||||
|
||||
export function loginPageTick() {
|
||||
if (!isLoginPage()) return;
|
||||
const f = loginFields();
|
||||
if (f.user && f.pwd && (R.loginBoundUser !== f.user || R.loginBoundPwd !== f.pwd)) {
|
||||
R.loginBoundUser = f.user;
|
||||
R.loginBoundPwd = f.pwd;
|
||||
const sync = function () {
|
||||
if (loginUserEl) loginUserEl.value = f.user.value;
|
||||
if (loginPassEl) loginPassEl.value = f.pwd.value;
|
||||
};
|
||||
onElement(f.user, 'input', sync);
|
||||
onElement(f.pwd, 'input', sync);
|
||||
}
|
||||
if (!R.loginFilled) {
|
||||
if (f.user && f.pwd) {
|
||||
R.loginFilled = true;
|
||||
const creds = loadCreds();
|
||||
if (creds) {
|
||||
fillLoginForm(creds.u, creds.p);
|
||||
if (loginUserEl) loginUserEl.value = creds.u;
|
||||
if (loginPassEl) loginPassEl.value = creds.p;
|
||||
if (loginRememberEl) loginRememberEl.checked = true;
|
||||
if (loginAutoEl) loginAutoEl.checked = !!creds.auto;
|
||||
setStatus('已填充保存的账号,可点「一键登录并刷课」');
|
||||
if (creds.auto && !R.loginAutoTried) {
|
||||
R.loginAutoTried = true;
|
||||
later(function () { doLoginAndStart(); }, 800);
|
||||
}
|
||||
} else {
|
||||
setStatus('填写账号密码后,点「一键登录并刷课」');
|
||||
}
|
||||
}
|
||||
}
|
||||
if (R.loginSubmittingAt) watchLoginResult();
|
||||
}
|
||||
-66
@@ -1,66 +0,0 @@
|
||||
// ==UserScript==
|
||||
// @name 云学堂助手
|
||||
// @namespace yun-xue-tang-assistant.local
|
||||
// @version __YUN_XUE_TANG_VERSION__
|
||||
// @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并在课程列表页逐门自动刷课(单视频/音频课程也支持,含考试章节的课自动空卷交卷,学完自动进入下一门,可优先短课程)
|
||||
// @match *://kfmic.yunxuetang.cn/*
|
||||
// @match *://*.yunxuetang.cn/*
|
||||
// @grant none
|
||||
// @run-at document-idle
|
||||
// ==/UserScript==
|
||||
|
||||
/*
|
||||
* 用法:
|
||||
* 1. 浏览器安装 Tampermonkey,新建脚本,粘贴本文件全部内容并保存。
|
||||
* 2. 打开 https://kfmic.yunxuetang.cn/login.html,在右下角面板填账号/密码,
|
||||
* 点「一键登录并刷课」;登录成功后会自动进入课程列表并开始逐门学习。
|
||||
* 3. 也可以手动登录后,在列表页点「一键刷课」。
|
||||
*
|
||||
* 密码保存:
|
||||
* - 只有勾选「记住密码」才会写入本机 localStorage,使用 base64 混淆(不是加密,
|
||||
* 本机其他脚本仍可读取)。公用电脑请不要勾选。
|
||||
* - 不勾选时密码只用于本次登录,不会落盘。
|
||||
*
|
||||
* 重要说明:
|
||||
* - 平台按“真实播放时长”计时,快进、倍速都不省时间,脚本只做自动播放和自动切节。
|
||||
* - 同时支持多课时课程(#/course/play)和单视频/音频/课件播放页(#/video/play 等):
|
||||
* 单视频课程会自动点「开始学习」;平台汇总变成「已完成学习」/100%/x=y 时判定整门课
|
||||
* 完成,自动回列表并进入下一门。
|
||||
* - 进入课程(列表刷课或自己点开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起
|
||||
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
|
||||
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
|
||||
* - 不按门数设上限:每日积分模式下整门课完成计 1 次,积分目标完成或没有可学内容时收尾。
|
||||
* - 脚本不跳过普通课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
|
||||
* 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试:
|
||||
* 30 秒起每次翻倍、最长 5 分钟,同一门课最多重试 CFG.maxCourseRetries 次,
|
||||
* 超过才停下整轮刷课并在面板写明原因,等人工处理后点「一键刷课」接着跑。
|
||||
* - 选课每次都动态查询:每完成一门课都重新调列表接口,拿平台实时的已完成/未完成状态,
|
||||
* 再按总时长从短到长挑下一门,不使用本地缓存的旧快照。
|
||||
* - 防挂机验证(每 10 分钟一次、120 秒限时)会自动点「继续学习」。
|
||||
* - 考试章节支持:自动进入考试、不答题直接交卷(空白交卷)。交卷后平台会把考试节点
|
||||
* 计入课程进度,含考试章节的课程也能学完。
|
||||
* 只有本页真的点过「提交考试/确定交卷」,看到的结果页才算一次交卷;平台恢复的旧
|
||||
* 结果页会先回考试说明页重新进入,避免在结果页和课程页之间空转。
|
||||
* 同一门课最多交卷 CFG.maxExamTries 次,超过仍没计入进度、或考试页没有可点的
|
||||
* 「开始考试/提交考试」时,本轮跳过这门课继续下一门(会写明原因),不再反复重进。
|
||||
* - 验证码/滑块需要手动完成,脚本不会绕过。
|
||||
* - 课程/单位如有相关规定,请自行确认风险。
|
||||
*
|
||||
* 短课程优先:
|
||||
* - 面板勾选「优先短课程(时长正序)」后,列表刷课会先读课程列表接口里的总时长,
|
||||
* 按「未学完课程的总时长从短到长」选课,而不是按列表顺序。接口不可用时会自动
|
||||
* 退回为「当前页按时长正序」,再不行就按原来的列表顺序,不会卡住刷课任务。
|
||||
*
|
||||
* 无头运行(Linux 服务器 / Windows 无人值守):
|
||||
* - 不装 Tampermonkey 也能跑:仓库里的 runner/headless.mjs 会自己起一个无头 Chromium,
|
||||
* 用 CDP 把本文件注入页面主世界(等价 @grant none),并用固定 profile 持久化登录。
|
||||
* npm run build && npm run headless:check && npm run headless(凭据读环境变量)。
|
||||
* Windows 上也可以直接双击 start-headless.cmd。
|
||||
* - 需要在无头环境里调试本文件时,可以把 window.__yunXueTangAuto 当成调试入口,
|
||||
* 用 runtime.evaluate 直接调 tick()/startBatch()/readSummary() 等,不必开界面。
|
||||
*
|
||||
* 开发热加载:
|
||||
* - 本文件可直接被 dev/dev-loader.user.js 热注入:脚本暴露 window.__yunXueTangDispose(),
|
||||
* 加载器在注入新版本前会先调用它清理定时器、监听器与面板,因此保存文件后
|
||||
* 约 1 秒内即可生效,无需手动刷新页面。
|
||||
*/
|
||||
-338
@@ -1,338 +0,0 @@
|
||||
// ======== 面板 ========
|
||||
import { VERSION, LS_ENABLED, LS_PREFER_SHORT, SS_SHORT_CATALOG, PANEL_ID, TAG } from './config.js';
|
||||
import { R, S, state, points, saveRunState } from './state.js';
|
||||
import { LS_POINTS_MODE } from './points.js';
|
||||
import { cachedPlatformPoints } from './points-platform.js';
|
||||
import { route } from './route.js';
|
||||
import { isLoginPage, startBatch, doLoginAndStart, clearSavedCreds } from './login.js';
|
||||
|
||||
// 会话时长:面板 footer 显示本次脚本会话自加载起已运行多久
|
||||
const SESSION_START_AT = Date.now();
|
||||
export let statusEl = null;
|
||||
let statsEl = null;
|
||||
let footerEl = null;
|
||||
let cbBatch = null;
|
||||
let labelAuto = null;
|
||||
let labelBatch = null;
|
||||
let labelShort = null;
|
||||
let cbPreferShort = null;
|
||||
let labelPoints = null;
|
||||
let cbPoints = null;
|
||||
let pointsEl = null;
|
||||
let cbAuto = null;
|
||||
let loginBox = null;
|
||||
export let loginUserEl = null;
|
||||
export let loginPassEl = null;
|
||||
export let loginRememberEl = null;
|
||||
export let loginAutoEl = null;
|
||||
let btnOne = null;
|
||||
let btnClearCreds = null;
|
||||
|
||||
// 面板里两个复选框行共用同一套 label 样式
|
||||
const LABEL_CSS = 'display:flex;align-items:center;gap:6px;cursor:pointer;margin-top:4px;';
|
||||
|
||||
function formatElapsed(ms) {
|
||||
const total = Math.max(0, Math.floor(ms / 1000));
|
||||
const h = Math.floor(total / 3600);
|
||||
const m = Math.floor((total % 3600) / 60);
|
||||
const s = total % 60;
|
||||
const p = function (n) { return n < 10 ? '0' + n : '' + n; };
|
||||
return h > 0 ? h + ':' + p(m) + ':' + p(s) : m + ':' + p(s);
|
||||
}
|
||||
|
||||
export function setStatus(text) {
|
||||
console.log(TAG, text);
|
||||
if (statusEl) statusEl.textContent = text;
|
||||
}
|
||||
|
||||
// 面板上再带一份平台台账的真实今日积分,避免本地未归类的记录让数字偏小
|
||||
function platformSuffix() {
|
||||
const p = cachedPlatformPoints();
|
||||
return p && p.ok ? ' · 平台 ' + p.todayPoints + '/' + p.maxPoints : '';
|
||||
}
|
||||
|
||||
export function updatePanel() {
|
||||
if (cbBatch) cbBatch.checked = S.batchRunning;
|
||||
if (statsEl) {
|
||||
let text = '本次 ' + S.completedThisRun;
|
||||
const retryTitles = Object.keys(S.courseRetries || {}).length;
|
||||
if (retryTitles) text += ' · 待重试 ' + retryTitles;
|
||||
if (R.retryWaitUntil && Date.now() < R.retryWaitUntil) {
|
||||
text += ' · ' + Math.ceil((R.retryWaitUntil - Date.now()) / 1000) + 's 后重试';
|
||||
}
|
||||
text += (R.idlePassed ? ' · 验证 ' + R.idlePassed : '');
|
||||
statsEl.textContent = text;
|
||||
}
|
||||
if (footerEl) {
|
||||
footerEl.textContent = '会话时长 ' + formatElapsed(Date.now() - SESSION_START_AT);
|
||||
}
|
||||
if (cbAuto) cbAuto.checked = state.autoPlayEnabled;
|
||||
if (cbPreferShort) cbPreferShort.checked = state.preferShortCourses;
|
||||
if (cbPoints) cbPoints.checked = state.pointsEnabled;
|
||||
if (pointsEl) {
|
||||
pointsEl.style.display = state.pointsEnabled ? 'block' : 'none';
|
||||
pointsEl.textContent = state.pointsEnabled ? points.summary() + platformSuffix() : '';
|
||||
}
|
||||
|
||||
const onLogin = isLoginPage();
|
||||
if (loginBox) loginBox.style.display = onLogin ? 'block' : 'none';
|
||||
if (labelAuto) labelAuto.style.display = onLogin ? 'none' : 'flex';
|
||||
if (labelBatch) labelBatch.style.display = onLogin ? 'none' : 'flex';
|
||||
if (labelShort) labelShort.style.display = onLogin ? 'none' : 'flex';
|
||||
if (labelPoints) labelPoints.style.display = onLogin ? 'none' : 'flex';
|
||||
if (statsEl) statsEl.style.display = onLogin ? 'none' : 'block';
|
||||
if (pointsEl) pointsEl.style.display = onLogin ? 'none' : (state.pointsEnabled ? 'block' : 'none');
|
||||
if (btnOne) {
|
||||
// 「停止刷课」只在播放页出现;列表页等位置始终显示「一键刷课」
|
||||
const onCourse = route() === 'course' && !!S.activeCourse;
|
||||
btnOne.textContent = onLogin
|
||||
? '一键登录并刷课'
|
||||
: (onCourse && S.batchRunning ? '停止刷课' : '一键刷课');
|
||||
btnOne.title = onCourse && S.batchRunning ? '停止列表刷课' : '开始 / 继续列表刷课';
|
||||
}
|
||||
}
|
||||
|
||||
export function buildPanel() {
|
||||
if (window.top !== window.self) return;
|
||||
if (document.getElementById(PANEL_ID)) return;
|
||||
|
||||
const box = document.createElement('div');
|
||||
box.id = PANEL_ID;
|
||||
box.style.cssText = [
|
||||
'position:fixed', 'right:16px', 'bottom:16px', 'z-index:2147483647',
|
||||
'background:rgba(24,24,28,.88)', 'color:#eee', 'padding:10px 12px',
|
||||
'border-radius:8px', 'box-shadow:0 4px 16px rgba(0,0,0,.35)',
|
||||
'font:12px/1.5 system-ui,-apple-system,"Microsoft YaHei",sans-serif',
|
||||
'user-select:none', 'max-width:280px', 'min-width:220px',
|
||||
].join(';');
|
||||
|
||||
const title = document.createElement('div');
|
||||
title.style.cssText = 'display:flex;align-items:baseline;gap:6px;margin-bottom:6px;';
|
||||
|
||||
const titleText = document.createElement('span');
|
||||
titleText.textContent = '云学堂助手';
|
||||
titleText.style.cssText = 'font-weight:600;';
|
||||
|
||||
const titleVer = document.createElement('span');
|
||||
titleVer.id = 'yun-xue-tang-version';
|
||||
titleVer.textContent = 'v' + VERSION;
|
||||
titleVer.title = '脚本版本 v' + VERSION;
|
||||
titleVer.style.cssText = 'font-weight:400;font-size:10px;color:#8ee6c0;opacity:.85;';
|
||||
|
||||
title.appendChild(titleText);
|
||||
title.appendChild(titleVer);
|
||||
|
||||
btnOne = document.createElement('button');
|
||||
btnOne.type = 'button';
|
||||
btnOne.id = 'yun-xue-tang-oneclick';
|
||||
btnOne.textContent = '一键刷课';
|
||||
btnOne.style.cssText = [
|
||||
'width:100%', 'margin:2px 0 6px', 'padding:5px 8px', 'cursor:pointer',
|
||||
'background:#2f7d5b', 'color:#fff', 'border:1px solid #3a9a70',
|
||||
'border-radius:5px', 'font-size:12px', 'font-weight:600',
|
||||
].join(';');
|
||||
btnOne.addEventListener('click', function () {
|
||||
if (isLoginPage()) {
|
||||
doLoginAndStart();
|
||||
return;
|
||||
}
|
||||
// 只有播放页的按钮才是「停止」;列表页/门户页点它一律是开始/继续,避免误停
|
||||
if (route() === 'course' && S.activeCourse && S.batchRunning) {
|
||||
S.batchRunning = false;
|
||||
saveRunState();
|
||||
setStatus('列表刷课已暂停');
|
||||
} else {
|
||||
startBatch();
|
||||
}
|
||||
updatePanel();
|
||||
});
|
||||
|
||||
loginBox = document.createElement('div');
|
||||
loginBox.id = 'yun-xue-tang-login-box';
|
||||
loginBox.style.cssText = 'display:none;margin-bottom:6px;';
|
||||
|
||||
const mkInput = function (id, type, ph) {
|
||||
const el = document.createElement('input');
|
||||
el.id = id;
|
||||
el.type = type;
|
||||
el.placeholder = ph;
|
||||
el.autocomplete = type === 'password' ? 'off' : 'username';
|
||||
el.style.cssText = [
|
||||
'width:100%', 'box-sizing:border-box', 'margin:0 0 4px', 'padding:4px 6px',
|
||||
'background:#2a2a30', 'color:#eee', 'border:1px solid #555',
|
||||
'border-radius:4px', 'font-size:12px', 'user-select:text',
|
||||
].join(';');
|
||||
return el;
|
||||
};
|
||||
loginUserEl = mkInput('yun-xue-tang-login-user', 'text', '员工邮箱/账号');
|
||||
loginPassEl = mkInput('yun-xue-tang-login-pass', 'password', '密码');
|
||||
|
||||
const mkCheck = function (id, text) {
|
||||
const label = document.createElement('label');
|
||||
label.style.cssText = 'display:inline-flex;align-items:center;gap:4px;cursor:pointer;margin-right:10px;';
|
||||
const cb = document.createElement('input');
|
||||
cb.type = 'checkbox';
|
||||
cb.id = id;
|
||||
label.appendChild(cb);
|
||||
label.appendChild(document.createTextNode(text));
|
||||
return { label: label, cb: cb };
|
||||
};
|
||||
const rem = mkCheck('yun-xue-tang-login-remember', '记住密码');
|
||||
loginRememberEl = rem.cb;
|
||||
const auto = mkCheck('yun-xue-tang-login-auto', '自动登录');
|
||||
loginAutoEl = auto.cb;
|
||||
loginRememberEl.addEventListener('change', function () {
|
||||
if (!loginRememberEl.checked) clearSavedCreds();
|
||||
});
|
||||
|
||||
const remRow = document.createElement('div');
|
||||
remRow.style.cssText = 'margin:2px 0 4px;font-size:11px;color:#bbb;';
|
||||
remRow.appendChild(rem.label);
|
||||
remRow.appendChild(auto.label);
|
||||
|
||||
btnClearCreds = document.createElement('button');
|
||||
btnClearCreds.type = 'button';
|
||||
btnClearCreds.textContent = '清除密码';
|
||||
btnClearCreds.style.cssText = [
|
||||
'padding:1px 6px', 'cursor:pointer', 'background:#444', 'color:#eee',
|
||||
'border:1px solid #666', 'border-radius:4px', 'font-size:10px',
|
||||
].join(';');
|
||||
btnClearCreds.addEventListener('click', function () {
|
||||
clearSavedCreds();
|
||||
if (loginPassEl) loginPassEl.value = '';
|
||||
if (loginUserEl) loginUserEl.value = '';
|
||||
setStatus('已清除保存的密码');
|
||||
});
|
||||
|
||||
const loginHint = document.createElement('div');
|
||||
loginHint.textContent = '密码仅存本机(base64 混淆,非加密),公用电脑请勿勾选记住';
|
||||
loginHint.style.cssText = 'color:#d9a441;font-size:10px;line-height:1.35;margin-top:2px;';
|
||||
|
||||
loginBox.appendChild(loginUserEl);
|
||||
loginBox.appendChild(loginPassEl);
|
||||
loginBox.appendChild(remRow);
|
||||
loginBox.appendChild(btnClearCreds);
|
||||
loginBox.appendChild(loginHint);
|
||||
|
||||
labelAuto = document.createElement('label');
|
||||
labelAuto.style.cssText = 'display:flex;align-items:center;gap:6px;cursor:pointer;';
|
||||
cbAuto = document.createElement('input');
|
||||
cbAuto.type = 'checkbox';
|
||||
cbAuto.id = 'yun-xue-tang-auto-enabled';
|
||||
cbAuto.checked = state.autoPlayEnabled;
|
||||
cbAuto.addEventListener('change', function () {
|
||||
state.autoPlayEnabled = cbAuto.checked;
|
||||
try { localStorage.setItem(LS_ENABLED, cbAuto.checked ? '1' : '0'); } catch (e) {}
|
||||
setStatus(cbAuto.checked ? '自动连播已开启' : '自动连播已关闭');
|
||||
});
|
||||
labelAuto.appendChild(cbAuto);
|
||||
labelAuto.appendChild(document.createTextNode('当前课程自动连播'));
|
||||
|
||||
labelBatch = document.createElement('label');
|
||||
labelBatch.style.cssText = LABEL_CSS;
|
||||
cbBatch = document.createElement('input');
|
||||
cbBatch.type = 'checkbox';
|
||||
cbBatch.id = 'yun-xue-tang-batch-enabled';
|
||||
cbBatch.checked = S.batchRunning;
|
||||
cbBatch.addEventListener('change', function () {
|
||||
if (cbBatch.checked) {
|
||||
startBatch();
|
||||
} else {
|
||||
S.batchRunning = false;
|
||||
saveRunState();
|
||||
setStatus('列表刷课已暂停');
|
||||
}
|
||||
updatePanel();
|
||||
});
|
||||
labelBatch.appendChild(cbBatch);
|
||||
labelBatch.appendChild(document.createTextNode('课程列表自动刷课'));
|
||||
|
||||
labelShort = document.createElement('label');
|
||||
labelShort.style.cssText = LABEL_CSS;
|
||||
cbPreferShort = document.createElement('input');
|
||||
cbPreferShort.type = 'checkbox';
|
||||
cbPreferShort.id = 'yun-xue-tang-prefer-short';
|
||||
cbPreferShort.checked = state.preferShortCourses;
|
||||
cbPreferShort.title = '按课程总时长从短到长选课';
|
||||
cbPreferShort.addEventListener('change', function () {
|
||||
state.preferShortCourses = cbPreferShort.checked;
|
||||
try { localStorage.setItem(LS_PREFER_SHORT, state.preferShortCourses ? '1' : '0'); } catch (e) {}
|
||||
if (!state.preferShortCourses) {
|
||||
R.shortCatalog = null;
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = 0;
|
||||
try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) {}
|
||||
setStatus('已关闭短课程优先,按列表顺序选课');
|
||||
} else {
|
||||
R.shortCatalogFailedAt = 0;
|
||||
setStatus('已开启短课程优先:时长正序');
|
||||
}
|
||||
updatePanel();
|
||||
});
|
||||
labelShort.appendChild(cbPreferShort);
|
||||
labelShort.appendChild(document.createTextNode('优先短课程(时长正序)'));
|
||||
|
||||
labelPoints = document.createElement('label');
|
||||
labelPoints.style.cssText = LABEL_CSS;
|
||||
cbPoints = document.createElement('input');
|
||||
cbPoints.type = 'checkbox';
|
||||
cbPoints.id = 'yun-xue-tang-points-enabled';
|
||||
cbPoints.checked = state.pointsEnabled;
|
||||
cbPoints.title = '整门课完成计 1 次:文档1 / 视频3 / 音频2 / 微课2,每天最多 24 分';
|
||||
cbPoints.addEventListener('change', function () {
|
||||
state.pointsEnabled = cbPoints.checked;
|
||||
points.setEnabled(state.pointsEnabled);
|
||||
try { localStorage.setItem(LS_POINTS_MODE, state.pointsEnabled ? '1' : '0'); } catch (e) {}
|
||||
R.pointsInventory = null;
|
||||
R.pointsInventoryFailedAt = 0;
|
||||
setStatus(state.pointsEnabled
|
||||
? '已开启每日积分模式:' + points.summary()
|
||||
: '已关闭每日积分模式,恢复普通刷课');
|
||||
updatePanel();
|
||||
});
|
||||
labelPoints.appendChild(cbPoints);
|
||||
labelPoints.appendChild(document.createTextNode('每日积分模式(凑满 24 分就停)'));
|
||||
|
||||
statusEl = document.createElement('div');
|
||||
statusEl.id = 'yun-xue-tang-status';
|
||||
statusEl.textContent = '待机';
|
||||
statusEl.style.cssText = 'margin-top:6px;color:#8ee6c0;word-break:break-all;';
|
||||
|
||||
statsEl = document.createElement('div');
|
||||
statsEl.id = 'yun-xue-tang-stats';
|
||||
statsEl.style.cssText = 'margin-top:2px;color:#aaa;';
|
||||
|
||||
pointsEl = document.createElement('div');
|
||||
pointsEl.id = 'yun-xue-tang-points';
|
||||
pointsEl.style.cssText = 'margin-top:2px;color:#8ee6c0;';
|
||||
|
||||
const hint = document.createElement('div');
|
||||
hint.textContent = '真实播放计时 · 保持窗口可见';
|
||||
hint.style.cssText = 'margin-top:6px;color:#777;font-size:11px;';
|
||||
|
||||
const footer = document.createElement('div');
|
||||
footer.id = 'yun-xue-tang-session-duration';
|
||||
footer.textContent = '会话时长 ' + formatElapsed(0);
|
||||
footer.style.cssText = 'margin-top:4px;color:#8ee6c0;font-size:11px;';
|
||||
footerEl = footer;
|
||||
|
||||
box.appendChild(title);
|
||||
box.appendChild(loginBox);
|
||||
box.appendChild(btnOne);
|
||||
box.appendChild(labelAuto);
|
||||
box.appendChild(labelBatch);
|
||||
box.appendChild(labelShort);
|
||||
box.appendChild(labelPoints);
|
||||
box.appendChild(statusEl);
|
||||
box.appendChild(statsEl);
|
||||
box.appendChild(pointsEl);
|
||||
box.appendChild(hint);
|
||||
box.appendChild(footer);
|
||||
document.documentElement.appendChild(box);
|
||||
}
|
||||
|
||||
export function ensurePanel() {
|
||||
if (window.top !== window.self) return;
|
||||
if (!document.getElementById(PANEL_ID)) buildPanel();
|
||||
updatePanel();
|
||||
}
|
||||
-604
@@ -1,604 +0,0 @@
|
||||
// ======== 播放器 ========
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, state } from './state.js';
|
||||
import { norm, textOf, truncate, isVisible, findVisibleButton, collectDocuments } from './utils.js';
|
||||
import { onElement } from './lifecycle.js';
|
||||
import { setStatus, updatePanel } from './panel.js';
|
||||
import { failCurrent } from './complete.js';
|
||||
|
||||
export function applyMute(v) {
|
||||
if (!CFG.mute) return;
|
||||
try {
|
||||
if (!v.muted) v.muted = true;
|
||||
v.defaultMuted = true;
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function playVideo(v) {
|
||||
if (!v) return;
|
||||
if (state.autoPlayEnabled || S.batchRunning) {
|
||||
try {
|
||||
const p = v.play();
|
||||
if (p && typeof p.catch === 'function') p.catch(() => {});
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
|
||||
export function hookVideo(v) {
|
||||
if (!v) return;
|
||||
if (v.getAttribute && v.getAttribute('data-yun-xue-tang-hooked') === '1') return;
|
||||
if (R.hooked.has(v)) return;
|
||||
R.hooked.add(v);
|
||||
try { v.setAttribute('data-yun-xue-tang-hooked', '1'); } catch (e) {}
|
||||
|
||||
applyMute(v);
|
||||
|
||||
onElement(v, 'play', function () {
|
||||
applyMute(v);
|
||||
R.lastProgressAt = Date.now();
|
||||
});
|
||||
onElement(v, 'ended', function () {
|
||||
R.lastProgressAt = Date.now();
|
||||
});
|
||||
onElement(v, 'timeupdate', function () {
|
||||
R.lastProgressAt = Date.now();
|
||||
});
|
||||
}
|
||||
|
||||
export function hookAllVideos() {
|
||||
for (const doc of collectDocuments()) {
|
||||
let vids;
|
||||
try {
|
||||
vids = doc.querySelectorAll('video, audio');
|
||||
} catch (e) {
|
||||
continue;
|
||||
}
|
||||
for (const v of vids) hookVideo(v);
|
||||
}
|
||||
}
|
||||
|
||||
export function findPlayableVideo() {
|
||||
const vids = [...document.querySelectorAll('video, audio')].filter(function (v) {
|
||||
return v.duration > 0 || v.currentSrc;
|
||||
});
|
||||
return vids.find(function (v) { return !v.paused; }) ||
|
||||
vids.find(function (v) { return isVisible(v) && v.duration > 0; }) ||
|
||||
vids.find(function (v) { return v.duration > 0; }) ||
|
||||
vids[0] || null;
|
||||
}
|
||||
|
||||
export function ensurePlaying(v) {
|
||||
if (!v) return;
|
||||
applyMute(v);
|
||||
if (S.activeCourse) {
|
||||
try {
|
||||
if (Math.abs(v.playbackRate - 1) > 0.01) v.playbackRate = 1;
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
if (!v.paused) return;
|
||||
// 已播完就交给「进度/切节」逻辑处理。
|
||||
// 平台在切到下一节后会自动挂出「还需 5分钟…」,那是下一节的时长,
|
||||
// 不能据此把已结束的视频拉回开头重播。
|
||||
if (v.ended) return;
|
||||
playVideo(v);
|
||||
}
|
||||
|
||||
// 平台完成状态有三种真实文案:
|
||||
// 多课时课程:已完成 2/3
|
||||
// 单视频/音频:已完成 0% -> 已完成 67%
|
||||
// 全部学完: 已完成学习 (此时进度条和倒计时都会消失)
|
||||
// 旧实现只认 x/y,课程真正学完后汇总变成「已完成学习」→ 永远不判完成,
|
||||
// 结果就是停在课程页、不回列表、也不进入下一门。
|
||||
export function readSummary() {
|
||||
const el = document.querySelector('[class*="course-summary"]');
|
||||
if (!el) return null;
|
||||
const t = textOf(el);
|
||||
|
||||
const m = t.match(/已完成(\d+)\/(\d+)/);
|
||||
if (m) {
|
||||
const x = Number(m[1]);
|
||||
const y = Number(m[2]);
|
||||
return {
|
||||
x: x, y: y, percent: y > 0 ? Math.round((x / y) * 100) : 0,
|
||||
complete: y > 0 && x >= y, kind: 'ratio', text: t,
|
||||
};
|
||||
}
|
||||
|
||||
const pct = t.match(/已完成(\d+)%/);
|
||||
if (pct) {
|
||||
const x = Number(pct[1]);
|
||||
return { x: x, y: 100, percent: x, complete: x >= 100, kind: 'percent', text: t };
|
||||
}
|
||||
|
||||
if (/已完成学习|学习完成|已完成本课程|已学完/.test(t)) {
|
||||
return { x: 100, y: 100, percent: 100, complete: true, kind: 'done', text: t };
|
||||
}
|
||||
|
||||
// 兜底:个别页面没有文案,只有进度条
|
||||
const bar = el.querySelector('[role="progressbar"]');
|
||||
if (bar) {
|
||||
const now = Number(bar.getAttribute('aria-valuenow'));
|
||||
const max = Number(bar.getAttribute('aria-valuemax')) || 100;
|
||||
if (Number.isFinite(now)) {
|
||||
return {
|
||||
x: now, y: max, percent: Math.round((now / max) * 100),
|
||||
complete: now >= max, kind: 'percent', text: t,
|
||||
};
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function readCountdown() {
|
||||
const el = document.querySelector('.yxtulcdsdk-course-player__countdown');
|
||||
if (!el) return null;
|
||||
const t = textOf(el);
|
||||
// 平台文案可能是「还需 2小时 7分钟 59秒」,也可能只剩「还需 5分钟」
|
||||
const m = t.match(/还需(?:(\d+)小时)?(?:(\d+)分钟)?(?:(\d+)秒)?/);
|
||||
if (m && (m[1] || m[2] || m[3])) {
|
||||
return Number(m[1] || 0) * 3600 + Number(m[2] || 0) * 60 + Number(m[3] || 0);
|
||||
}
|
||||
if (/已完成|学习完成|已学完/.test(t)) return 0;
|
||||
return null;
|
||||
}
|
||||
|
||||
export function readActiveLessonKey() {
|
||||
const active = document.querySelector('.yxtulcdsdk-catalog .liactive');
|
||||
if (!active) return '';
|
||||
const li = active.closest('li');
|
||||
return norm(li ? li.innerText : active.innerText);
|
||||
}
|
||||
|
||||
// 目录里「章」节点也带 .hand 且包含子 ul;只取真正的课时 li
|
||||
export function lessonItems() {
|
||||
return [...document.querySelectorAll('.yxtulcdsdk-catalog ul > li')]
|
||||
.filter(function (li) { return !li.querySelector('ul'); });
|
||||
}
|
||||
|
||||
export function findNextLessonElement() {
|
||||
const activeLi = lessonActiveLi();
|
||||
if (!activeLi) return null;
|
||||
const lis = lessonItems();
|
||||
const idx = lis.indexOf(activeLi);
|
||||
if (idx < 0 || idx + 1 >= lis.length) return null;
|
||||
// 返回 li 本身:真正的点击目标由 clickLesson 选择。以前返回内部 .hand,
|
||||
// 在真实目录里那是 <svg>,没有 click(),next.click() 会抛异常 → 切节失效。
|
||||
return lis[idx + 1];
|
||||
}
|
||||
|
||||
export function isLessonCompleted(li) {
|
||||
try {
|
||||
// 1) 状态文案:目录里的标签可能在标题前(「已学完 第1节」),也可能在标题后,
|
||||
// 不能只认结尾,否则一个都识别不出来 → 每次都退回第一节
|
||||
const text = textOf(li);
|
||||
if (/已学完|已完成/.test(text)) return true;
|
||||
|
||||
// 2) 语义属性/类名(平台改版时比 svg 路径稳定)
|
||||
const hint = [
|
||||
li.getAttribute('aria-label') || '',
|
||||
li.getAttribute('title') || '',
|
||||
String(li.className || ''),
|
||||
].join(' ');
|
||||
if (/已学完|已完成|finished|completed|is-done/i.test(hint)) return true;
|
||||
|
||||
// 3) 完成态图标:平台用一个起点 M10 2.75 的实心圆 + 对勾
|
||||
const ds = [...li.querySelectorAll('svg path')]
|
||||
.map(function (p) { return String(p.getAttribute('d') || ''); });
|
||||
return ds.some(function (d) {
|
||||
return d.replace(/,/g, ' ').indexOf('M10 2.75') >= 0;
|
||||
});
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function findFirstIncompleteLessonElement() {
|
||||
for (const li of lessonItems()) {
|
||||
if (!isLessonCompleted(li)) return li;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 暂停页面上所有媒体:平台会在课程完成后把播放器重置到 0 秒,不暂停就会又从头播一遍。
|
||||
// 逐个元素 try,单个元素 busy/已卸下时不影响其余视频。
|
||||
export function pauseAllMedia() {
|
||||
try {
|
||||
document.querySelectorAll('video, audio').forEach(function (x) {
|
||||
try { x.pause(); } catch (e) {}
|
||||
});
|
||||
} catch (e) {}
|
||||
}
|
||||
|
||||
// ---- 课时切换(对齐起点 / 纠偏时使用,带多种点击方式与校验) ----
|
||||
export function lessonActiveLi() {
|
||||
const el = document.querySelector('.yxtulcdsdk-catalog .liactive');
|
||||
return el ? el.closest('li') : null;
|
||||
}
|
||||
|
||||
// 浏览器里有布局信息;jsdom 之类的无布局环境下返回 false,避免误判“隐藏”
|
||||
export function layoutAvailable() {
|
||||
try {
|
||||
const r = document.body.getBoundingClientRect();
|
||||
return r.width > 0 && r.height > 0;
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// 目录诊断快照:起点纠正失败时打到控制台,便于定位平台为什么不响应点击
|
||||
export function dumpCatalog() {
|
||||
return lessonItems().map(function (li, i) {
|
||||
return {
|
||||
i: i + 1,
|
||||
text: truncate(textOf(li), 36),
|
||||
active: li.classList.contains('liactive') || !!li.querySelector('.liactive'),
|
||||
done: isLessonCompleted(li),
|
||||
cls: String(li.className || '').slice(0, 48),
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
export function fireMouse(el, type) {
|
||||
try {
|
||||
el.dispatchEvent(new MouseEvent(type, {
|
||||
bubbles: true, cancelable: true, view: window, button: 0,
|
||||
}));
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function firePointer(el, type) {
|
||||
try {
|
||||
el.dispatchEvent(new PointerEvent(type, {
|
||||
bubbles: true, cancelable: true, pointerId: 1, pointerType: 'mouse', isPrimary: true,
|
||||
}));
|
||||
} catch (e) { fireMouse(el, type.replace('pointer', 'mouse')); }
|
||||
}
|
||||
|
||||
// 目录里的展开箭头、课时状态图标都是 <svg>,而 SVGSVGElement 并没有
|
||||
// HTMLElement 的 click() 方法:直接 el.click() 会抛 TypeError 并被静默吞掉,
|
||||
// 等于“点了但什么都没发生”。任何节点都统一走这里,必要时派发鼠标事件。
|
||||
export function clickNode(el) {
|
||||
if (!el) return false;
|
||||
try {
|
||||
if (typeof el.click === 'function') {
|
||||
el.click();
|
||||
return true;
|
||||
}
|
||||
} catch (e) { /* 落到下面的事件派发 */ }
|
||||
fireMouse(el, 'click');
|
||||
return true;
|
||||
}
|
||||
|
||||
// 有些点击逻辑挂在 mousedown/pointerup 上,补一整套鼠标事件序列
|
||||
export function fireClickSequence(el) {
|
||||
if (!el) return;
|
||||
firePointer(el, 'pointerdown');
|
||||
fireMouse(el, 'mousedown');
|
||||
firePointer(el, 'pointerup');
|
||||
fireMouse(el, 'mouseup');
|
||||
clickNode(el);
|
||||
}
|
||||
|
||||
// 课时的点击句柄可能挂在标题 span、行容器、li 或右侧状态图标任意一层,
|
||||
// 这里按「由内向外」返回候选节点:点最内层标题时事件会依次冒泡到行容器和 li,
|
||||
// 能覆盖这三种常见写法;状态图标(svg)放最后作兜底。
|
||||
export function lessonClickNodes(li) {
|
||||
const title = li.querySelector('.item') ||
|
||||
li.querySelector('.yxtf-tooltip') ||
|
||||
li.querySelector('span');
|
||||
const row = li.querySelector('[class*="flex-space-between"]') || li.querySelector('div');
|
||||
const svg = li.querySelector('svg');
|
||||
return [title, row, li, svg].filter(Boolean);
|
||||
}
|
||||
|
||||
// 点击第 attempt 次切换课时,逐次换目标与事件方式:
|
||||
// 1) 标题 span 2) 标题 + 行容器 3) 完整鼠标序列(标题) 4) 行容器 + 课时自带按钮
|
||||
// 5) li 6) 状态图标 …… 避免前两次点偏后就直接放弃
|
||||
export function clickLesson(li, attempt) {
|
||||
if (!li) return;
|
||||
const nodes = lessonClickNodes(li);
|
||||
if (!nodes.length) return;
|
||||
const title = nodes[0];
|
||||
const row = nodes[1] && nodes[1] !== li ? nodes[1] : null;
|
||||
const svg = li.querySelector('svg');
|
||||
|
||||
if (attempt <= 2) {
|
||||
clickNode(title);
|
||||
if (attempt === 2 && row) clickNode(row);
|
||||
return;
|
||||
}
|
||||
|
||||
if (attempt >= 4) {
|
||||
const startBtn = [...li.querySelectorAll('button, [role="button"], span, div')]
|
||||
.find(function (el) {
|
||||
return el.children.length <= 1 && /^(开始学习|继续学习)$/.test(textOf(el));
|
||||
});
|
||||
if (startBtn) clickNode(startBtn);
|
||||
}
|
||||
|
||||
fireClickSequence(title);
|
||||
const targets = [title, row, li, svg].filter(Boolean);
|
||||
const target = targets[(attempt - 3) % targets.length];
|
||||
if (target && target !== title) fireClickSequence(target);
|
||||
}
|
||||
|
||||
// 平台切课时可能弹「确认切换/退出当前学习」,自动点掉。
|
||||
// 先只在弹层里找,避免误点页面上的其它同名按钮。
|
||||
export function confirmLessonDialog() {
|
||||
const pat = /^(确定|确认|是|切换|确定切换|继续切换|继续学习|继续观看|知道了)$/;
|
||||
const boxes = [...document.querySelectorAll(
|
||||
'.yxt-dialog__wrapper, [class*="dialog"], [class*="modal"], [role="dialog"]'
|
||||
)].filter(isVisible);
|
||||
let buttons = [];
|
||||
for (const box of boxes) {
|
||||
buttons = buttons.concat([...box.querySelectorAll('button, [role="button"]')]);
|
||||
}
|
||||
if (!buttons.length) {
|
||||
buttons = [...document.querySelectorAll('button, [role="button"]')];
|
||||
}
|
||||
for (const el of buttons) {
|
||||
if (!isVisible(el)) continue;
|
||||
if (pat.test(textOf(el))) {
|
||||
clickNode(el);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
export function findNextButton() {
|
||||
const els = [...document.querySelectorAll(
|
||||
'[class*="kng-operate"] div, [class*="kng-operate"] span, [class*="kng-operate"] button'
|
||||
)];
|
||||
for (const el of els) {
|
||||
if (textOf(el) === '下一个' && isVisible(el)) return el;
|
||||
}
|
||||
const generic = [...document.querySelectorAll('div, span, button, a')];
|
||||
for (const el of generic) {
|
||||
if (el.children.length <= 1 && textOf(el) === '下一个' && isVisible(el)) return el;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 目录里的考试课时(.tag-type 文案为「考试」)。考试不再跳过,而是自动进考试空卷交卷,
|
||||
// 所以单独提供 finder 给课程页调用。
|
||||
export function examLessonElements() {
|
||||
return lessonItems().filter(function (li) {
|
||||
const tag = li.querySelector('.tag-type');
|
||||
return !!tag && /考试/.test(textOf(tag));
|
||||
});
|
||||
}
|
||||
|
||||
// 第一个还没完成的考试课时
|
||||
export function findPendingExamLesson() {
|
||||
return examLessonElements().find(function (li) { return !isLessonCompleted(li); }) || null;
|
||||
}
|
||||
|
||||
// 课程是否包含「答题/测验/问卷」类章节(这类仍需人工,考试已改为自动交卷)
|
||||
export function courseHasQuizLesson() {
|
||||
// 没有标签课时,some() 本身就返回 false,不必先判 length
|
||||
return [...document.querySelectorAll('.yxtulcdsdk-catalog ul > li .tag-type')]
|
||||
.some(function (t) { return /答题|测验|问卷/.test(textOf(t)); });
|
||||
}
|
||||
|
||||
export function detectQuiz() {
|
||||
// 「开始考试/继续考试」由 exam.js 单独接管(自动空卷交卷),这里只留需要人工的答题类
|
||||
const pat = /^(开始答题|继续答题|提交答案|提交试卷)$/;
|
||||
for (const doc of collectDocuments()) {
|
||||
let els;
|
||||
try {
|
||||
els = doc.querySelectorAll('button, [role="button"], a');
|
||||
} catch (e) {
|
||||
continue;
|
||||
}
|
||||
for (const el of els) {
|
||||
if (pat.test(textOf(el)) && isVisible(el)) return true;
|
||||
}
|
||||
}
|
||||
const dialogs = [...document.querySelectorAll('.yxt-dialog__wrapper, [class*="dialog"]')];
|
||||
for (const d of dialogs) {
|
||||
if (!isVisible(d)) continue;
|
||||
const t = textOf(d);
|
||||
if (/开始答题|提交试卷/.test(t)) return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
// 防挂机验证:平台每 10 分钟(kngConf/cheat.maxMin)弹一次,
|
||||
// 文案「已触发防挂机验证,请点击“继续学习”,否则学习将被停止」,120 秒内不点就停止计时。
|
||||
export function findAntiIdleDialog() {
|
||||
const pat = /防挂机|不要走开|学习将被停止|请点击.?继续学习/;
|
||||
let best = null;
|
||||
let bestLen = Infinity;
|
||||
for (const doc of collectDocuments()) {
|
||||
let cands;
|
||||
try {
|
||||
// 只认 dialog/modal,别把 [class*="popup"] 之类的外层容器算进来:
|
||||
// 平台会把 <body class="yxt-popup-parent--hidden"> 整个页面套进去,误判成弹窗。
|
||||
cands = doc.querySelectorAll('[class*="dialog"], [class*="modal"], [role="dialog"]');
|
||||
} catch (e) {
|
||||
continue;
|
||||
}
|
||||
for (const el of cands) {
|
||||
if (!isVisible(el)) continue;
|
||||
const t = textOf(el);
|
||||
if (t.length > 400) continue; // 包住整页的外层容器直接排除
|
||||
if (!pat.test(t)) continue;
|
||||
// 取文案最短的那层(即最内层弹窗),避免选到大 wrapper
|
||||
if (t.length < bestLen) { best = el; bestLen = t.length; }
|
||||
}
|
||||
}
|
||||
return best;
|
||||
}
|
||||
|
||||
export function findAntiIdleButton(dialog) {
|
||||
if (!dialog) return null;
|
||||
const want = /^(继续学习|我知道了|继续观看)$/;
|
||||
const pick = function (sel) {
|
||||
return [...dialog.querySelectorAll(sel)].find(function (el) {
|
||||
return want.test(textOf(el)) && isVisible(el);
|
||||
}) || null;
|
||||
};
|
||||
// 必须优先点真正的 <button>:平台的点击回调绑在 button 上,
|
||||
// 点文案相同的外层 div(如 <div class="mt24">)不会有任何反应。
|
||||
const el = pick('button') || pick('[role="button"]') || pick('a') || pick('div') || pick('span');
|
||||
if (!el) return findVisibleButton(/^(继续学习)$/);
|
||||
if (el.tagName !== 'BUTTON') {
|
||||
const inner = el.querySelector('button');
|
||||
if (inner) return inner;
|
||||
}
|
||||
return el;
|
||||
}
|
||||
|
||||
// 弹层里是滑块/拼图时脚本过不了,需要人工
|
||||
export function antiIdleNeedsHuman(dialog) {
|
||||
if (!dialog) return false;
|
||||
try {
|
||||
const cands = dialog.querySelectorAll(
|
||||
'input[type="range"], [class*="slider"], [class*="captcha"], [class*="drag-verify"], [class*="verify-slider"]'
|
||||
);
|
||||
for (const el of cands) if (isVisible(el)) return true;
|
||||
return false;
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function handleAntiIdle() {
|
||||
const dialog = findAntiIdleDialog();
|
||||
if (!dialog) return false;
|
||||
|
||||
// 先找按钮:只要弹窗里有「继续学习」就直接点,不要因为页面里别处有 canvas 就误判成滑块
|
||||
const btn = findAntiIdleButton(dialog);
|
||||
if (!btn) {
|
||||
if (antiIdleNeedsHuman(dialog)) {
|
||||
setStatus('防挂机验证需要人工完成(滑块/拼图),本课稍后重试');
|
||||
failCurrent('防挂机验证需要人工完成(滑块/拼图)');
|
||||
} else {
|
||||
setStatus('检测到防挂机验证,未找到「继续学习」按钮');
|
||||
}
|
||||
return true;
|
||||
}
|
||||
if (Date.now() - R.lastIdleClickAt < 2500) return true;
|
||||
|
||||
// 同一个弹层最多点 10 次,防止平台异常不关闭时无限点击
|
||||
const dialogText = truncate(textOf(dialog), 40);
|
||||
const sameDialog = R.idleDialogText === dialogText;
|
||||
if (sameDialog && R.idleDialogClicks >= 10) {
|
||||
if (!R.idleGaveUp) {
|
||||
R.idleGaveUp = true;
|
||||
console.warn(TAG, '防挂机验证弹层点了 10 次仍未关闭,停止点击,等待人工处理',
|
||||
String(dialog.outerHTML || '').slice(0, 800));
|
||||
setStatus('防挂机验证未能通过,等待人工处理');
|
||||
}
|
||||
return true;
|
||||
}
|
||||
R.idleDialogText = dialogText;
|
||||
R.idleDialogClicks = sameDialog ? R.idleDialogClicks + 1 : 1;
|
||||
R.idleGaveUp = false;
|
||||
|
||||
R.lastIdleClickAt = Date.now();
|
||||
R.idlePassed++;
|
||||
try { btn.click(); } catch (e) { /* ignore */ }
|
||||
console.log(TAG, '防挂机验证:已点击「继续学习」(第', R.idlePassed, '次)');
|
||||
setStatus('已通过防挂机验证(第 ' + R.idlePassed + ' 次)');
|
||||
updatePanel();
|
||||
return true;
|
||||
}
|
||||
|
||||
export function courseTitle() {
|
||||
return String(document.title || '')
|
||||
.replace(/\s*-\s*[^-]*(云课堂|云学堂)\s*$/, '')
|
||||
.trim();
|
||||
}
|
||||
|
||||
// 对齐起点:把当前课时切到「第一个未学完的课时」。
|
||||
// 返回 true = 本 tick 已处理(正在切换 / 等待确认),调用方应直接 return;
|
||||
// 返回 false = 无需对齐或已对齐,可以继续播放逻辑。
|
||||
// 成功与否以目录高亮为准(连续两个 tick 都在目标课时才算数),
|
||||
// 避免面板声称已切换、实际仍停在平台上次的位置。
|
||||
export function alignToFirstIncomplete() {
|
||||
if (!CFG.alignToFirstIncomplete || R.initialLessonChecked) return false;
|
||||
|
||||
const lis = lessonItems();
|
||||
if (!lis.length) return false; // 目录还没渲染,等下一轮
|
||||
|
||||
if (!R.phaseSince) R.phaseSince = Date.now();
|
||||
if (Date.now() - R.phaseSince < 1500) return true; // 等平台恢复完上次位置再纠正
|
||||
|
||||
const activeLi = lessonActiveLi();
|
||||
const activeIdx = activeLi ? lis.indexOf(activeLi) : -1;
|
||||
const targetLi = findFirstIncompleteLessonElement();
|
||||
const targetIdx = targetLi ? lis.indexOf(targetLi) : -1;
|
||||
|
||||
if (targetIdx < 0) {
|
||||
// 所有课时都已完成,整门课是否结束交给 summary 判断
|
||||
R.initialLessonChecked = true;
|
||||
return false;
|
||||
}
|
||||
|
||||
if (targetIdx === activeIdx) {
|
||||
// 连续两次确认已在目标课时,才算对齐成功
|
||||
R.alignStable++;
|
||||
if (R.alignStable < 2) return true;
|
||||
R.initialLessonChecked = true;
|
||||
R.lastLessonKey = readActiveLessonKey();
|
||||
console.log(TAG, '起点已对齐:第', targetIdx + 1, '节', truncate(textOf(targetLi), 24));
|
||||
setStatus('从第 ' + (targetIdx + 1) + ' 节开始:' + truncate(textOf(targetLi), 18));
|
||||
return false;
|
||||
}
|
||||
|
||||
R.alignStable = 0;
|
||||
|
||||
if (R.alignTries >= 8) {
|
||||
R.initialLessonChecked = true;
|
||||
R.alignFailed = true;
|
||||
setStatus('未能切换到第 ' + (targetIdx + 1) + ' 节,按当前位置继续');
|
||||
console.warn(TAG, '起点对齐失败:点击课时后平台未切换,目录快照:', dumpCatalog());
|
||||
return false;
|
||||
}
|
||||
R.alignTries++;
|
||||
|
||||
// 章节折叠时子课时不可点,先展开所属章节。
|
||||
// 展开箭头通常是 <svg>,必须用 clickNode 派发事件(svg 没有 click() 方法)。
|
||||
if (layoutAvailable() && !isVisible(targetLi)) {
|
||||
let ul = targetLi.parentElement;
|
||||
while (ul && ul.tagName !== 'UL') ul = ul.parentElement;
|
||||
const collapsed = ul && getComputedStyle(ul).display === 'none';
|
||||
const chapterLi = ul && ul.parentElement ? ul.parentElement.closest('li') : null;
|
||||
if (collapsed && chapterLi && R.alignTries <= 3) {
|
||||
setStatus('展开章节:' + truncate(textOf(chapterLi), 20));
|
||||
clickNode(chapterLi.querySelector('.hand') || chapterLi);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
// 切课时平台可能弹确认框,先点掉(第 1 次不查,避免误点页面上的其他「确定」)
|
||||
if (R.alignTries > 1 && confirmLessonDialog()) {
|
||||
setStatus('已确认切换提示,继续…');
|
||||
return true;
|
||||
}
|
||||
|
||||
console.log(TAG, '对齐起点:第', activeIdx >= 0 ? (activeIdx + 1) : '?', '节 → 第', targetIdx + 1, '节',
|
||||
'(第 ' + R.alignTries + ' 次)');
|
||||
setStatus('正在切换到第 ' + (targetIdx + 1) + ' 节…' +
|
||||
(R.alignTries > 1 ? '(第 ' + R.alignTries + ' 次)' : ''));
|
||||
clickLesson(targetLi, R.alignTries);
|
||||
return true;
|
||||
}
|
||||
|
||||
// 手动模式没有 S.activeCourse,用课程标题判断是否换了一门课,换课时重新对齐
|
||||
export function syncManualCourse() {
|
||||
const key = courseTitle() || location.href;
|
||||
if (R.manualCourseKey === key) return true;
|
||||
R.manualCourseKey = key;
|
||||
R.initialLessonChecked = false;
|
||||
R.phaseSince = 0;
|
||||
R.alignTries = 0;
|
||||
R.alignStable = 0;
|
||||
R.alignFailed = false;
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
return true;
|
||||
}
|
||||
@@ -1,255 +0,0 @@
|
||||
// ======== 平台积分台账 ========
|
||||
// 「我的积分」页 /ssp/#/my/point 背后的接口才是最直接的证据:
|
||||
// GET /ssp/rule/org 各积分规则的每日上限(文档/视频/音频/微课)
|
||||
// POST /ssp/point/history/self 今日积分明细
|
||||
// 脚本不再假设「学完一门就该 +3」,只把平台真实入账的记录折算成积分。
|
||||
//
|
||||
// 鉴权:接口认 localStorage.token(登录后由平台写入),不用 cookie。
|
||||
// 接口不可用(未登录 / 跨域 / 网络)时返回 ok:false,调用方退回本地计数。
|
||||
import { norm } from './utils.js';
|
||||
import { pointLabel } from './points.js';
|
||||
|
||||
const API = 'https://api-phx-tc.yunxuetang.cn/ssp/';
|
||||
const RULE_CODES = { doc: 'SB1031', video: 'SB1032', audio: 'SB1033', micro: 'SB1034' };
|
||||
// 台账里的 nameType 就是平台自己的课件类型:1006 文档 / 1007 视频 / 1008 音频 / 1009 微课
|
||||
const NAME_TYPES = { 1006: 'doc', 1007: 'video', 1008: 'audio', 1009: 'micro' };
|
||||
const CACHE_TTL = 20000;
|
||||
const TAGS_KEY = 'yun-xue-tang-point-awards-v1';
|
||||
const PENDING_TTL = 6 * 60 * 60 * 1000;
|
||||
const NO_AWARD_LIMIT = 3;
|
||||
|
||||
let cache = null;
|
||||
let inflight = null;
|
||||
let mode = ''; // '' | 'platform' | 'local':首次刷新成功与否决定本次会话的计数方式
|
||||
let completionsSinceAward = 0;
|
||||
let lastLedgerCount = -1;
|
||||
|
||||
function pad2(n) {
|
||||
return n < 10 ? '0' + n : '' + n;
|
||||
}
|
||||
|
||||
function dayKey(ms) {
|
||||
const d = new Date(ms);
|
||||
return d.getFullYear() + '-' + pad2(d.getMonth() + 1) + '-' + pad2(d.getDate());
|
||||
}
|
||||
|
||||
function token() {
|
||||
try { return localStorage.getItem('token') || ''; } catch (e) { return ''; }
|
||||
}
|
||||
|
||||
export function platformAvailable() {
|
||||
return !!token();
|
||||
}
|
||||
|
||||
/** 首次刷新是否已经确定计数方式;未确定前调用方按本地模式处理 */
|
||||
export function platformMode() {
|
||||
return mode;
|
||||
}
|
||||
|
||||
export function cachedPlatformPoints() {
|
||||
return cache;
|
||||
}
|
||||
|
||||
/** 平台连续多少门课没有新增入账记录(用于判断「积分其实已满」) */
|
||||
export function platformNoAward() {
|
||||
return mode === 'platform' && completionsSinceAward >= NO_AWARD_LIMIT;
|
||||
}
|
||||
|
||||
// ---- 本地保存「课程名 -> 类型」和「等待对账的完成记录」----
|
||||
|
||||
function loadTags(day) {
|
||||
try {
|
||||
const o = JSON.parse(localStorage.getItem(TAGS_KEY) || '{}');
|
||||
if (o && o.day === day) {
|
||||
return {
|
||||
day: day,
|
||||
titles: o.titles && typeof o.titles === 'object' ? o.titles : {},
|
||||
pending: Array.isArray(o.pending) ? o.pending : [],
|
||||
unknown: o.unknown && typeof o.unknown === 'object' ? o.unknown : {},
|
||||
};
|
||||
}
|
||||
} catch (e) { /* ignore */ }
|
||||
return { day: day, titles: {}, pending: [], unknown: {} };
|
||||
}
|
||||
|
||||
function saveTags(t) {
|
||||
try { localStorage.setItem(TAGS_KEY, JSON.stringify(t)); } catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
/** 整门课完成时记下「这门课算哪一类」,等平台台账入账后据此归类 */
|
||||
export function rememberCourseAward(title, type) {
|
||||
if (!title || !type) return;
|
||||
const t = loadTags(dayKey(Date.now()));
|
||||
t.titles[norm(title)] = type;
|
||||
t.pending.push({ type: type, at: Date.now(), title: norm(title) });
|
||||
if (t.pending.length > 50) t.pending = t.pending.slice(-50);
|
||||
saveTags(t);
|
||||
}
|
||||
|
||||
/** 一门课完成了(平台模式下用来判断「连续 N 门没有入账」) */
|
||||
export function noteCourseCompleted() {
|
||||
if (mode === 'platform') completionsSinceAward++;
|
||||
}
|
||||
|
||||
/**
|
||||
* 把平台台账折算进本地计数器。纯逻辑,方便离线测试。
|
||||
* @returns {number} 本次新增计入的条数
|
||||
*/
|
||||
export function applyLedger(data, tracker, opts = {}) {
|
||||
if (!data || !data.ok) return 0;
|
||||
const t = loadTags(data.day);
|
||||
if (opts.reset) {
|
||||
// 切换到平台模式时丢弃旧口径的本地计数,完全以台账重建
|
||||
if (typeof tracker.resetCounts === 'function') tracker.resetCounts();
|
||||
t.unknown = {};
|
||||
}
|
||||
let added = 0;
|
||||
for (const r of data.records || []) {
|
||||
const id = 'platform:' + r.id;
|
||||
const key = norm(r.remark || '');
|
||||
// 优先用平台台账自带的 nameType,它比标题/待对账记录都可靠
|
||||
let type = NAME_TYPES[Number(r.nameType)] || '';
|
||||
if (!type) type = key && t.titles[key] ? t.titles[key] : '';
|
||||
if (type) {
|
||||
// 这条记录已经对上类型了,把它对应的待对账记录撤掉,避免后面串号
|
||||
const j = t.pending.findIndex((p) => p.title === key && p.type === type);
|
||||
if (j >= 0) t.pending.splice(j, 1);
|
||||
} else {
|
||||
// 平台有时用课时名而不是课程名:把它归给最近一次还没对上的完成记录
|
||||
const i = t.pending.findIndex((p) => Date.now() - (p.at || 0) < PENDING_TTL);
|
||||
if (i >= 0) {
|
||||
type = t.pending[i].type;
|
||||
t.pending.splice(i, 1);
|
||||
}
|
||||
}
|
||||
if (type) {
|
||||
if (tracker.record(type, id)) {
|
||||
added++;
|
||||
console.log('[云学堂助手] 积分 +' + r.point + '(平台入账):' + pointLabel(type) +
|
||||
' · ' + tracker.summary());
|
||||
}
|
||||
} else if (!t.unknown[id]) {
|
||||
t.unknown[id] = 1;
|
||||
console.warn('[云学堂助手] 平台积分 +' + r.point + ' 未能归类:' + (r.remark || r.id));
|
||||
}
|
||||
}
|
||||
saveTags(t);
|
||||
return added;
|
||||
}
|
||||
|
||||
// ---- 拉取 ----
|
||||
|
||||
async function getJson(url, opts) {
|
||||
const res = await fetch(url, opts);
|
||||
if (!res.ok) throw new Error('HTTP ' + res.status);
|
||||
return res.json();
|
||||
}
|
||||
|
||||
export async function fetchPlatformPoints(now) {
|
||||
const tk = token();
|
||||
const at = now || Date.now();
|
||||
if (!tk) return { ok: false, at: at, reason: 'no-token' };
|
||||
const day = dayKey(at);
|
||||
// 平台网关要求 source 头(501 = PC 端);缺了会返回 400「请求头 source 为空」
|
||||
const headers = {
|
||||
'Content-Type': 'application/json;charset=UTF-8',
|
||||
source: '501',
|
||||
'x-yxt-product': 'xxv2',
|
||||
token: tk,
|
||||
};
|
||||
const body = JSON.stringify({
|
||||
startDate: day + ' 00:00:00',
|
||||
endDate: day + ' 23:59:59',
|
||||
sourceType: -1,
|
||||
optionType: 0,
|
||||
type: 1,
|
||||
userId: '',
|
||||
});
|
||||
|
||||
const results = await Promise.all([
|
||||
getJson(API + 'rule/org', { headers: headers }),
|
||||
getJson(API + 'point/history/self?limit=200&offset=0', {
|
||||
method: 'POST', headers: headers, body: body,
|
||||
}),
|
||||
]);
|
||||
const rules = results[0];
|
||||
const ledger = results[1];
|
||||
|
||||
const ruleMap = {};
|
||||
for (const r of (rules && rules.datas) || []) {
|
||||
if (!r || Number(r.enable) !== 1) continue;
|
||||
for (const key of Object.keys(RULE_CODES)) {
|
||||
if (r.code === RULE_CODES[key]) {
|
||||
ruleMap[key] = {
|
||||
cap: Math.max(0, Number(r.times) || 0),
|
||||
point: Math.max(0, Number(r.point) || 0),
|
||||
};
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// sourceType 1002 = 在线学习;登录奖励等其它来源不算每日学习积分
|
||||
const records = ((ledger && ledger.datas) || []).filter((r) =>
|
||||
r && r.id && Number(r.point) > 0 && Number(r.sourceType) === 1002);
|
||||
const todayPoints = records.reduce((n, r) => n + (Number(r.point) || 0), 0);
|
||||
const maxPoints = Object.keys(ruleMap).reduce((n, k) => n + ruleMap[k].cap * ruleMap[k].point, 0);
|
||||
|
||||
return {
|
||||
ok: true,
|
||||
at: at,
|
||||
day: day,
|
||||
rules: ruleMap,
|
||||
records: records,
|
||||
todayPoints: todayPoints,
|
||||
maxPoints: maxPoints,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 刷新平台台账并折算进计数器。并发调用共用一个请求;失败不抛错。
|
||||
* @param {object} tracker points.js 的 tracker(需要 record / resetCounts)
|
||||
* @param {{force?:boolean}} [opts]
|
||||
*/
|
||||
export function refreshPlatformPoints(tracker, opts = {}) {
|
||||
if (!force(opts) && cache && Date.now() - cache.at < CACHE_TTL) {
|
||||
return Promise.resolve(cache);
|
||||
}
|
||||
if (inflight) return inflight;
|
||||
inflight = fetchPlatformPoints().then((data) => {
|
||||
cache = data;
|
||||
if (data.ok) {
|
||||
if (mode !== 'platform') {
|
||||
mode = 'platform';
|
||||
applyLedger(data, tracker, { reset: true });
|
||||
} else {
|
||||
applyLedger(data, tracker);
|
||||
}
|
||||
if (data.records.length > lastLedgerCount) completionsSinceAward = 0;
|
||||
lastLedgerCount = data.records.length;
|
||||
} else if (!mode) {
|
||||
mode = 'local';
|
||||
}
|
||||
return data;
|
||||
}).catch((e) => {
|
||||
cache = { ok: false, at: Date.now(), reason: e && e.message ? e.message : String(e) };
|
||||
if (!mode) mode = 'local';
|
||||
return cache;
|
||||
}).finally(() => { inflight = null; });
|
||||
return inflight;
|
||||
}
|
||||
|
||||
function force(opts) {
|
||||
return !!(opts && opts.force);
|
||||
}
|
||||
|
||||
/** 某个类型在平台规则里是否启用/上限多少;没有平台数据时返回 null */
|
||||
export function platformRule(key) {
|
||||
if (!cache || !cache.ok) return null;
|
||||
return cache.rules[key] || null;
|
||||
}
|
||||
|
||||
/** 全部启用规则加起来的每日积分上限;没有平台数据时返回 0 */
|
||||
export function platformMaxPoints() {
|
||||
if (!cache || !cache.ok) return 0;
|
||||
return cache.maxPoints;
|
||||
}
|
||||
-277
@@ -1,277 +0,0 @@
|
||||
// ======== 每日积分模式 ========
|
||||
// 平台按「学习完成」发积分,四类任务各有每日上限:
|
||||
// 文档 1 次 + 视频 3 次 + 音频 2 次 + 微课 2 次,每次 3 分,单日最多 24 分。
|
||||
//
|
||||
// 这里的口径是「整门课完成算一次」,不是「完成一节课时就算一次」:
|
||||
// · 多课时课程要所有课时(含考试)都完成后才计一次,按今天实际学过的课时类型归类;
|
||||
// · 单视频/音频/课件播放页学完即计一次;
|
||||
// · 只剩考试、今天没学内容的课程不计分;
|
||||
// · 类型识别不出来的课时不猜、不计分;
|
||||
// · 同一天同一门课重复上报(刷新、重进、平台重发)只计一次。
|
||||
//
|
||||
// 计数落 localStorage 并带日期,跨刷新/运行器重启不丢,跨天自动清零。
|
||||
// 纯数据逻辑,不碰 DOM,方便脱离浏览器直接测。
|
||||
|
||||
export const POINT_RULES = [
|
||||
{ key: 'doc', label: '文档', cap: 1 },
|
||||
{ key: 'video', label: '视频', cap: 3 },
|
||||
{ key: 'audio', label: '音频', cap: 2 },
|
||||
{ key: 'micro', label: '微课', cap: 2 },
|
||||
];
|
||||
|
||||
export const POINTS_PER_TASK = 3;
|
||||
export const MAX_DAILY_POINTS = POINT_RULES.reduce((n, r) => n + r.cap, 0) * POINTS_PER_TASK;
|
||||
|
||||
export const LS_POINTS_MODE = 'yun-xue-tang-daily-points-mode';
|
||||
export const LS_POINTS_STATE = 'yun-xue-tang-daily-points-v1';
|
||||
|
||||
// 顺序有讲究:微课/文档/音频在前,视频最后。某一类同时命中多个关键词时,
|
||||
// 按更具体的类型算(例如「微课视频」按微课,而不是按视频)。
|
||||
const TYPE_MATCHERS = [
|
||||
['micro', /微课|micro/i],
|
||||
['doc', /文档|课件|ppt|document|article/i],
|
||||
['audio', /音频|audio/i],
|
||||
['video', /视频|video/i],
|
||||
];
|
||||
|
||||
/**
|
||||
* 识别一个课时的积分类型。
|
||||
* 优先级:播放页路由 > 接口 fileType > 目录里的 tag-type 文本。
|
||||
* 多课时课程的路由(#/course/play)不带类型,会落到 tag-type 上。
|
||||
* 识别不出来返回 '',调用方不应计分。
|
||||
*/
|
||||
export function detectLessonType(input) {
|
||||
input = input || {};
|
||||
const sources = [input.hash, input.fileType, input.tag];
|
||||
for (const src of sources) {
|
||||
if (!src) continue;
|
||||
const s = String(src);
|
||||
for (const pair of TYPE_MATCHERS) {
|
||||
if (pair[1].test(s)) return pair[0];
|
||||
}
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/** 列表接口的 type 字段:1=文档/课件 2=视频 3=音频;0 是课程容器,不计。 */
|
||||
export function apiTypeKey(type) {
|
||||
const n = Number(type);
|
||||
if (n === 1) return 'doc';
|
||||
if (n === 2) return 'video';
|
||||
if (n === 3) return 'audio';
|
||||
return '';
|
||||
}
|
||||
|
||||
/** 类型的中文名(日志/面板用);未知类型原样返回 */
|
||||
export function pointLabel(key) {
|
||||
const rule = POINT_RULES.find((r) => r.key === key);
|
||||
return rule ? rule.label : (key || '未知');
|
||||
}
|
||||
|
||||
/**
|
||||
* 选择本轮该补哪一类:按 文档 → 视频 → 音频 → 微课 的顺序,
|
||||
* 跳过已满额和确认没有内容的类型。
|
||||
*
|
||||
* @param {object} opts
|
||||
* @param {Function} opts.isFull (key) => boolean
|
||||
* @param {object} [opts.available] { doc, video, audio, micro };false = 没内容。
|
||||
* video 的可用性由调用方根据「还有没有可学的课程」判断。
|
||||
* @returns {{type:string, kind:'item'|'course'}|null} null = 今日任务已无可做项
|
||||
*/
|
||||
export function nextTarget(opts) {
|
||||
opts = opts || {};
|
||||
const isFull = typeof opts.isFull === 'function' ? opts.isFull : () => false;
|
||||
const available = opts.available || {};
|
||||
for (const rule of POINT_RULES) {
|
||||
if (isFull(rule.key)) continue;
|
||||
if (rule.key === 'video') {
|
||||
// 视频额度靠课程里的视频课时完成,不依赖单条库存
|
||||
if (available.video !== false) return { type: 'video', kind: 'course' };
|
||||
continue;
|
||||
}
|
||||
if (available[rule.key]) return { type: rule.key, kind: 'item' };
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function pad2(n) {
|
||||
return n < 10 ? '0' + n : '' + n;
|
||||
}
|
||||
|
||||
function dayKey(ms) {
|
||||
const d = new Date(ms);
|
||||
return d.getFullYear() + '-' + pad2(d.getMonth() + 1) + '-' + pad2(d.getDate());
|
||||
}
|
||||
|
||||
function blankState(date) {
|
||||
const counts = {};
|
||||
for (const rule of POINT_RULES) counts[rule.key] = 0;
|
||||
return { date: date, counts: counts, seen: {} };
|
||||
}
|
||||
|
||||
function normalizeState(obj) {
|
||||
const state = blankState(obj && obj.date ? String(obj.date) : '');
|
||||
for (const rule of POINT_RULES) {
|
||||
const n = Number(obj && obj.counts && obj.counts[rule.key]);
|
||||
state.counts[rule.key] = Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
|
||||
}
|
||||
if (obj && obj.seen && typeof obj.seen === 'object') state.seen = obj.seen;
|
||||
return state;
|
||||
}
|
||||
|
||||
/**
|
||||
* @param {object} [opts]
|
||||
* @param {Function} [opts.now] 取当前时间(毫秒),测试用假时钟
|
||||
* @param {object} [opts.storage] getItem/setItem,默认 localStorage
|
||||
* @param {boolean} [opts.enabled] 是否启用积分模式,默认 true
|
||||
* @param {string} [opts.storageKey]
|
||||
*/
|
||||
export function createPointsTracker(opts = {}) {
|
||||
const now = opts.now || (() => Date.now());
|
||||
const storage = opts.storage !== undefined
|
||||
? opts.storage
|
||||
: (typeof localStorage !== 'undefined' ? localStorage : null);
|
||||
const storageKey = opts.storageKey || LS_POINTS_STATE;
|
||||
|
||||
let enabled = opts.enabled !== undefined ? !!opts.enabled : true;
|
||||
let state = load();
|
||||
rollover(); // 打开页面时如果已经跨天,先清零再用
|
||||
|
||||
function load() {
|
||||
try {
|
||||
const raw = storage && storage.getItem(storageKey);
|
||||
if (!raw) return blankState(dayKey(now()));
|
||||
return normalizeState(JSON.parse(raw));
|
||||
} catch (e) {
|
||||
return blankState(dayKey(now()));
|
||||
}
|
||||
}
|
||||
|
||||
function save() {
|
||||
try {
|
||||
if (storage) storage.setItem(storageKey, JSON.stringify(state));
|
||||
} catch (e) { /* 容量不足 / 隐私模式:内存里照常计数 */ }
|
||||
}
|
||||
|
||||
/** 跨天自动清零;返回是否发生了重置 */
|
||||
function rollover() {
|
||||
const today = dayKey(now());
|
||||
if (state.date === today) return false;
|
||||
state = blankState(today);
|
||||
save();
|
||||
return true;
|
||||
}
|
||||
|
||||
function ruleOf(key) {
|
||||
return POINT_RULES.find((r) => r.key === key) || null;
|
||||
}
|
||||
|
||||
function count(key) {
|
||||
return state.counts[key] || 0;
|
||||
}
|
||||
|
||||
function cap(key) {
|
||||
const rule = ruleOf(key);
|
||||
return rule ? rule.cap : 0;
|
||||
}
|
||||
|
||||
function isFull(key) {
|
||||
return count(key) >= cap(key);
|
||||
}
|
||||
|
||||
function remaining(key) {
|
||||
return Math.max(0, cap(key) - count(key));
|
||||
}
|
||||
|
||||
/**
|
||||
* 记一次任务完成(整门课或单条内容)。
|
||||
* @param {string} key detectLessonType 的返回值
|
||||
* @param {string} [taskId] 当天去重键(建议 courseId|course / kngId|media);空串表示不去重
|
||||
* @returns {boolean} 是否真的计入了
|
||||
*/
|
||||
function record(key, taskId) {
|
||||
rollover();
|
||||
if (!enabled) return false;
|
||||
if (!ruleOf(key) || isFull(key)) return false;
|
||||
if (taskId) {
|
||||
if (state.seen[taskId]) return false;
|
||||
state.seen[taskId] = 1;
|
||||
}
|
||||
state.counts[key] = count(key) + 1;
|
||||
save();
|
||||
return true;
|
||||
}
|
||||
|
||||
/** 切换到平台台账口径时清零并重建 */
|
||||
function resetCounts() {
|
||||
rollover();
|
||||
for (const rule of POINT_RULES) state.counts[rule.key] = 0;
|
||||
state.seen = {};
|
||||
save();
|
||||
}
|
||||
|
||||
function totalPoints() {
|
||||
let total = 0;
|
||||
for (const rule of POINT_RULES) {
|
||||
total += Math.min(count(rule.key), rule.cap) * POINTS_PER_TASK;
|
||||
}
|
||||
return total;
|
||||
}
|
||||
|
||||
function maxPoints() {
|
||||
return MAX_DAILY_POINTS;
|
||||
}
|
||||
|
||||
function allFull() {
|
||||
return POINT_RULES.every((rule) => isFull(rule.key));
|
||||
}
|
||||
|
||||
/**
|
||||
* 今日任务是否已完成:四类都满额,或剩余额度的类型都确认没有内容。
|
||||
* available 缺省时不把「没内容」当成完成依据(避免误停)。
|
||||
*/
|
||||
function done(available) {
|
||||
return POINT_RULES.every((rule) =>
|
||||
isFull(rule.key) || (!!available && available[rule.key] === false));
|
||||
}
|
||||
|
||||
function progress() {
|
||||
return POINT_RULES.map((rule) => ({
|
||||
key: rule.key,
|
||||
label: rule.label,
|
||||
count: Math.min(count(rule.key), rule.cap),
|
||||
cap: rule.cap,
|
||||
}));
|
||||
}
|
||||
|
||||
function summary() {
|
||||
const parts = progress().map((p) => p.label + p.count + '/' + p.cap);
|
||||
return '今日积分 ' + totalPoints() + '/' + maxPoints() + ' · ' + parts.join(' ');
|
||||
}
|
||||
|
||||
function snapshot() {
|
||||
return {
|
||||
enabled: enabled,
|
||||
date: state.date,
|
||||
total: totalPoints(),
|
||||
max: maxPoints(),
|
||||
progress: progress(),
|
||||
text: summary(),
|
||||
};
|
||||
}
|
||||
|
||||
function setEnabled(on) {
|
||||
enabled = !!on;
|
||||
if (enabled) rollover();
|
||||
}
|
||||
|
||||
function isEnabled() {
|
||||
return enabled;
|
||||
}
|
||||
|
||||
return {
|
||||
record, count, cap, isFull, remaining, totalPoints, maxPoints,
|
||||
allFull, done, progress, summary, snapshot, setEnabled, isEnabled, rollover,
|
||||
resetCounts,
|
||||
};
|
||||
}
|
||||
@@ -1,40 +0,0 @@
|
||||
// ======== 路由 ========
|
||||
import { R, S, saveRunState } from './state.js';
|
||||
|
||||
// 平台不同内容类型进入的播放页不同:
|
||||
// 多课时课程 #/course/play?kngId=… 单个视频 #/video/play?kngId=…
|
||||
// 单个音频 #/audio/play?kngId=… 单个课件 #/ppt/play?kngId=…
|
||||
// 以前只认 #/course/play,其它类型整页逻辑都不会跑(不自动播放、也不判完成)。
|
||||
// #/scan 是点开课程后的过渡页,也按课程页处理。
|
||||
export function route() {
|
||||
const h = location.hash || '';
|
||||
if (h.indexOf('#/list') === 0) return 'list';
|
||||
if (h.indexOf('#/scan') === 0) return 'course';
|
||||
if (/^#\/[a-z0-9_-]+\/play(?:[?/]|$)/i.test(h)) return 'course';
|
||||
return 'other';
|
||||
}
|
||||
|
||||
// 单媒体播放页(没有多课时目录):完成判定看进度百分比/「已完成学习」,
|
||||
// 不需要找下一节。
|
||||
export function mediaPage() {
|
||||
return /^#\/(?:video|audio|ppt|document|article|micro|microcourse)\/play(?:[?/]|$)/i.test(location.hash || '');
|
||||
}
|
||||
|
||||
// 回列表页。
|
||||
// catalogUrl 决定「刷的是哪个目录」——它同时也是短课程队列的缓存键来源,
|
||||
// 用错目录会把队列建在另一批课程上,所以这里优先用它而不是裸的 /kng/#/list。
|
||||
export function goToList(force) {
|
||||
if (!force && Date.now() - R.lastGoListAt < 5000) return;
|
||||
R.lastGoListAt = Date.now();
|
||||
const url = S.catalogUrl || location.origin + '/kng/#/list';
|
||||
if (route() === 'list') {
|
||||
S.awaitingListReturn = true;
|
||||
saveRunState();
|
||||
return;
|
||||
}
|
||||
try {
|
||||
location.href = url;
|
||||
} catch (e) {
|
||||
location.hash = '#/list';
|
||||
}
|
||||
}
|
||||
-317
@@ -1,317 +0,0 @@
|
||||
// ======== 状态 ========
|
||||
//
|
||||
// 状态分三层,持久化位置按「这条信息跨会话是否还成立」来分:
|
||||
//
|
||||
// 用户偏好(localStorage) —— state / targetCatalogUrl:跨会话、跨标签页都成立
|
||||
// 本次运行状态(sessionStorage)—— S:整页跳转要活,换标签页/重启浏览器即作废
|
||||
// 纯内存(R) —— 运行时计数器、节流时间戳:丢了自愈
|
||||
//
|
||||
// 关键约定:S.batchRunning(是否正在刷课)属于「用户/运行器的授权意图」,
|
||||
// 只活在本标签页内。这样浏览器重启、运行器重建标签页之后都必然是待机状态,
|
||||
// 必须由 runner/session.mjs 或面板显式重新开跑,不会出现「还没登录就开始刷课」。
|
||||
import {
|
||||
CFG, LS_ENABLED, LS_PREFER_SHORT, LS_TARGET_CATALOG_URL,
|
||||
SS_RUN_STATE, SS_SHORT_CATALOG, LEGACY_LS_BATCH,
|
||||
} from './config.js';
|
||||
import { createPointsTracker, LS_POINTS_MODE } from './points.js';
|
||||
|
||||
// ======== 用户偏好(localStorage) ========
|
||||
export const state = {
|
||||
autoPlayEnabled: true, // 当前课程自动连播(自己点开的课)
|
||||
preferShortCourses: CFG.preferShortCourses, // 列表刷课时优先后时长更短的课程(正序)
|
||||
pointsEnabled: true, // 每日积分模式:整门课完成计 1 次,按课时类型封顶
|
||||
};
|
||||
try {
|
||||
state.autoPlayEnabled = localStorage.getItem(LS_ENABLED) !== '0';
|
||||
} catch (e) { /* ignore */ }
|
||||
try {
|
||||
const v = localStorage.getItem(LS_PREFER_SHORT);
|
||||
if (v === '0' || v === '1') state.preferShortCourses = v === '1';
|
||||
} catch (e) { /* ignore */ }
|
||||
try {
|
||||
state.pointsEnabled = localStorage.getItem(LS_POINTS_MODE) !== '0';
|
||||
} catch (e) { /* ignore */ }
|
||||
|
||||
// 每日积分计数落 localStorage(带日期,跨刷新/重启不丢,跨天自动清零)
|
||||
export const points = createPointsTracker({ enabled: state.pointsEnabled });
|
||||
|
||||
// ======== 本次运行状态(sessionStorage) ========
|
||||
export const PHASE_ENTERING = 'entering';
|
||||
export const PHASE_LEARNING = 'learning';
|
||||
export const PHASE_IDLE = 'idle';
|
||||
const VALID_PHASES = new Set([PHASE_IDLE, PHASE_ENTERING, PHASE_LEARNING]);
|
||||
|
||||
export function defaultRunState() {
|
||||
return {
|
||||
// ---- 运行意图 ----
|
||||
batchRunning: false, // 列表刷课是否在跑(只在本标签页内有效)
|
||||
batchFinished: false, // 本轮已停止(达上限 / 重试用尽 / 无课可学)
|
||||
completedThisRun: 0, // 本轮已完成门数
|
||||
|
||||
// ---- 选课范围 ----
|
||||
// 目标目录 URL:决定「刷哪个学院/目录」的课,也是短课程队列的缓存键来源。
|
||||
// 值同时镜像到 localStorage(LS_TARGET_CATALOG_URL),所以跨会话仍然有效。
|
||||
catalogUrl: '', // 例:https://kfmic.yunxuetang.cn/kng/#/list?cid=…
|
||||
listPage: 1, // 列表页码(短课程队列不可用时是唯一的页码来源)
|
||||
|
||||
// ---- 当前课程 ----
|
||||
activeCourse: null, // { title, id, startedAt }
|
||||
coursePhase: PHASE_IDLE, // idle | entering | learning
|
||||
awaitingListReturn: false,// 刚学完/失败,正在回列表途中
|
||||
|
||||
// ---- 本轮记录 ----
|
||||
completedTitles: {}, // 课程名 -> 完成时间戳(防平台记账延迟时重进同一门)
|
||||
courseRetries: {}, // 课程名 -> { n, reason, at }(未完成重试次数)
|
||||
skippedCourses: {}, // 课程名 -> { reason, at }(考试无法自动完成,本轮跳过)
|
||||
examEmptySubmits: {}, // 课程 id -> 空卷交卷次数(防死循环)
|
||||
};
|
||||
}
|
||||
|
||||
export const S = defaultRunState();
|
||||
|
||||
function asMap(v) {
|
||||
return v && typeof v === 'object' && !Array.isArray(v) ? v : {};
|
||||
}
|
||||
|
||||
function restoreFrom(obj) {
|
||||
if (!obj || typeof obj !== 'object') return null;
|
||||
const out = defaultRunState();
|
||||
|
||||
// ---- 运行意图:只有「同一个标签页」内的整页跳转才走到这里,可以整体接续 ----
|
||||
out.batchRunning = obj.batchRunning === true;
|
||||
out.batchFinished = obj.batchFinished === true;
|
||||
const done = Number(obj.completedThisRun);
|
||||
out.completedThisRun = Number.isFinite(done) && done >= 0 ? Math.floor(done) : 0;
|
||||
|
||||
// ---- 选课范围 ----
|
||||
out.catalogUrl = typeof obj.catalogUrl === 'string' ? obj.catalogUrl : '';
|
||||
const page = Number(obj.listPage);
|
||||
out.listPage = Number.isFinite(page) && page >= 1 ? Math.floor(page) : 1;
|
||||
|
||||
// ---- 当前课程 ----
|
||||
// learning 阶段:说明是同一标签页内的整页跳转(sessionStorage 跨跳转存活、跨标签页不存活),
|
||||
// 所以「多年前开始学的课」也是真实的,必须接续,不能用时间戳判过期。
|
||||
// entering 阶段:「正在进课」超过 15 秒就会被 failCurrent,若是重启/长时间挂起后
|
||||
// 恢复一个很旧的 startedAt,只会让 course.js 的进课宽限期立刻判过期,把正常加载
|
||||
// 误判成「课程不一致」—— 所以只有这一段才用 staleCourseMs 守门。
|
||||
const cur = obj.activeCourse;
|
||||
const startedAt = cur && Number(cur.startedAt);
|
||||
const visiblePhase = VALID_PHASES.has(obj.coursePhase) ? obj.coursePhase : PHASE_ENTERING;
|
||||
if (cur && cur.title && Number.isFinite(startedAt)) {
|
||||
const stale = Date.now() - startedAt > CFG.staleCourseMs;
|
||||
const keep = visiblePhase === PHASE_LEARNING || !stale;
|
||||
out.activeCourse = keep
|
||||
? { title: String(cur.title), id: String(cur.id || ''), startedAt }
|
||||
: null;
|
||||
out.coursePhase = keep ? visiblePhase : PHASE_IDLE;
|
||||
} else {
|
||||
out.activeCourse = null;
|
||||
out.coursePhase = PHASE_IDLE;
|
||||
}
|
||||
// 「正在回列表途中」不依赖当前课程:completeCurrent / failCurrent 会先清课程
|
||||
// 再跳回列表,若把它一起丢掉,新页面就不知道需要恢复页码。
|
||||
out.awaitingListReturn = obj.awaitingListReturn === true;
|
||||
|
||||
// ---- 本轮记录 ----
|
||||
out.completedTitles = asMap(obj.completedTitles);
|
||||
out.courseRetries = asMap(obj.courseRetries);
|
||||
out.skippedCourses = asMap(obj.skippedCourses);
|
||||
out.examEmptySubmits = asMap(obj.examEmptySubmits);
|
||||
return out;
|
||||
}
|
||||
|
||||
// 旧版 localStorage 里的整块状态(yun-xue-tang-batch-v2):只挑「进度」迁移,
|
||||
// 运行意图、当前课程一律不接续。迁移完即删除,避免旧数据一直复活。
|
||||
function migrateLegacy() {
|
||||
let raw = null;
|
||||
try { raw = localStorage.getItem(LEGACY_LS_BATCH); } catch (e) { return; }
|
||||
if (!raw) return;
|
||||
try {
|
||||
const old = JSON.parse(raw);
|
||||
if (old && typeof old === 'object') {
|
||||
const done = asMap(old.done);
|
||||
// 清掉一眼过期的完成记录(超过 DONE 有效期的不再迁移)
|
||||
for (const k of Object.keys(done)) {
|
||||
const at = Number(done[k]);
|
||||
if (!Number.isFinite(at) || Date.now() - at > CFG.staleCourseMs) delete done[k];
|
||||
}
|
||||
S.completedTitles = done;
|
||||
S.courseRetries = asMap(old.retries);
|
||||
S.examEmptySubmits = asMap(old.examTried);
|
||||
const page = Number(old.listPage);
|
||||
if (Number.isFinite(page) && page >= 1) S.listPage = Math.floor(page);
|
||||
const url = typeof old.listUrl === 'string' ? old.listUrl : '';
|
||||
if (url) setTargetCatalogUrl(url, { silent: true });
|
||||
}
|
||||
console.log('[云学堂助手] 已迁移旧版本进度记录(不再恢复旧的运行状态)');
|
||||
} catch (e) { /* ignore */ }
|
||||
try { localStorage.removeItem(LEGACY_LS_BATCH); } catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
(function restore() {
|
||||
let restored = null;
|
||||
try {
|
||||
const raw = sessionStorage.getItem(SS_RUN_STATE);
|
||||
if (raw) restored = restoreFrom(JSON.parse(raw));
|
||||
} catch (e) { /* ignore */ }
|
||||
if (restored) Object.assign(S, restored);
|
||||
// 目标目录是偏好:localStorage 里的值优先,会话里没有就沿用会话内的
|
||||
S.catalogUrl = readTargetCatalogUrl() || S.catalogUrl;
|
||||
migrateLegacy();
|
||||
})();
|
||||
|
||||
// 上次写盘的快照:内容没变就不重复序列化+写入
|
||||
let lastWritten = '';
|
||||
|
||||
export function saveRunState() {
|
||||
try {
|
||||
const text = JSON.stringify(S);
|
||||
if (text === lastWritten) return;
|
||||
lastWritten = text;
|
||||
sessionStorage.setItem(SS_RUN_STATE, text);
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
// 收尾/退出前强制落盘(内容没变也会写,防止 lastWritten 与实际不同步)
|
||||
export function flushRunState() {
|
||||
lastWritten = '';
|
||||
saveRunState();
|
||||
}
|
||||
|
||||
// ======== 目标目录 URL(偏好,localStorage + 会话镜像) ========
|
||||
export function readTargetCatalogUrl() {
|
||||
try { return localStorage.getItem(LS_TARGET_CATALOG_URL) || ''; } catch (e) { return ''; }
|
||||
}
|
||||
|
||||
export function setTargetCatalogUrl(url, opt) {
|
||||
const next = String(url || '');
|
||||
if (!next) return;
|
||||
const changed = S.catalogUrl !== next;
|
||||
S.catalogUrl = next;
|
||||
try { localStorage.setItem(LS_TARGET_CATALOG_URL, next); } catch (e) { /* ignore */ }
|
||||
if (changed && !(opt && opt.silent)) saveRunState();
|
||||
}
|
||||
|
||||
// ======== 运行时状态(纯内存,不持久化) ========
|
||||
export const R = {
|
||||
hooked: new WeakSet(),
|
||||
lastCardClickAt: 0,
|
||||
entryRetries: 0, // 点卡片后仍停在列表时,重试进入课程的次数
|
||||
lastPageJumpAt: 0,
|
||||
pageChangeAt: 0,
|
||||
pageChangeSig: '',
|
||||
listWithCurrentSince: 0,
|
||||
lastGoListAt: 0,
|
||||
lastStartClickAt: 0,
|
||||
lastAdvanceAt: 0,
|
||||
manualAdvanceAt: 0,
|
||||
lastLessonKey: '',
|
||||
doneLatchKey: '', // 本节已播完(倒计时归零/video.ended),防止平台把视频拉回开头重播
|
||||
lastSummary: null,
|
||||
lastCountdown: null,
|
||||
lastProgressAt: Date.now(),
|
||||
waitStart: 0,
|
||||
waitSummaryX: -1,
|
||||
waitLessonKey: '',
|
||||
quizChecked: false,
|
||||
// 考试(空卷交卷)自动处理状态
|
||||
examPhase: '', // '' | preview | paper | result
|
||||
examActionAt: 0, // 上次考试页内点击时间
|
||||
examSubmitted: false, // 本页是否真的点过「提交考试/确定交卷」(区分残留结果页)
|
||||
examPreviewAt: 0, // 进入考试说明页的时间(找不到「开始考试」时的超时)
|
||||
examStaleResults: 0, // 本课遇到残留结果页并尝试重进的次数
|
||||
examStarts: 0, // 本形态点了多少次「开始考试」
|
||||
examSubmits: 0, // 本形态点了多少次「提交考试」
|
||||
examConfirms: 0, // 本形态点了多少次交卷确认「确定」
|
||||
examPaperAt: 0, // 进入答卷页的时间(等题目渲染)
|
||||
examLeaving: false, // 已交卷,正在返回课程页
|
||||
examLessonAt: 0, // 上次点「考试节」的时间(防抖)
|
||||
examLessonTries: 0, // 本次进考试节已点次数
|
||||
examLessonKey: '', // examLessonTries 所属课程(换课重置,同课重进保留)
|
||||
initialLessonChecked: false,
|
||||
phaseSince: 0,
|
||||
alignTries: 0,
|
||||
alignStable: 0,
|
||||
alignFailed: false,
|
||||
manualCourseKey: '',
|
||||
lastIdleClickAt: 0,
|
||||
idlePassed: 0,
|
||||
idleDialogText: '',
|
||||
idleDialogClicks: 0,
|
||||
idleGaveUp: false,
|
||||
pageRestoreAttempts: 0,
|
||||
retryWaitUntil: 0, // 重试退避的结束时间(未到点不进课)
|
||||
retryTitle: '', // 正在等待重试的课程名(面板提示用)
|
||||
loginFilled: false,
|
||||
loginSubmittingAt: 0,
|
||||
loginAutoTried: false,
|
||||
loginBoundUser: null,
|
||||
loginBoundPwd: null,
|
||||
// 短课程优先:课程时长队列(只在当前标签页会话内缓存)
|
||||
shortCatalog: null,
|
||||
shortCatalogLoading: false,
|
||||
shortCatalogFailedAt: 0,
|
||||
shortFetchStartedAt: 0,
|
||||
shortJumpAt: 0,
|
||||
shortNoVmSince: 0,
|
||||
shortWarnedAt: 0,
|
||||
retryStatusSec: -1, // 「等待重试」提示上次写出的剩余秒数(只在变化时刷状态)
|
||||
// 每日积分模式:当前课时的类型缓存(课时 id → doc/video/audio/micro),
|
||||
// 以及文档/音频/微课的单条库存(视频靠课程里的课时,不单独存)
|
||||
lessonTypes: {},
|
||||
coursePointCourseId: '', // 「今天学过的类型」所属课程 id
|
||||
coursePointType: '', // 这门课今天学过的类型,整门课完成时计一次
|
||||
pointsInventory: null,
|
||||
pointsInventoryLoading: false,
|
||||
pointsInventoryFailedAt: 0,
|
||||
pointsFetchStartedAt: 0,
|
||||
pointsNoVmSince: 0,
|
||||
pointsWarnedAt: 0,
|
||||
};
|
||||
|
||||
// 丢掉时长队列缓存:下一次选课会重新调列表接口,拿平台实时的
|
||||
// 未学完/已完成状态,而不是用本地旧快照。
|
||||
// 放在 state.js 而不是 list.js,是为了避开 complete.js <-> list.js 的循环引用。
|
||||
export function invalidateShortCatalog() {
|
||||
R.shortCatalog = null;
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = 0;
|
||||
R.shortNoVmSince = 0;
|
||||
try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function resetCourseRuntime() {
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.lessonTypes = {};
|
||||
R.coursePointCourseId = '';
|
||||
R.coursePointType = '';
|
||||
R.lastSummary = null;
|
||||
R.lastCountdown = null;
|
||||
R.lastProgressAt = Date.now();
|
||||
R.waitStart = 0;
|
||||
R.waitSummaryX = -1;
|
||||
R.waitLessonKey = '';
|
||||
R.quizChecked = false;
|
||||
R.examPhase = '';
|
||||
R.examActionAt = 0;
|
||||
R.examSubmitted = false;
|
||||
R.examPreviewAt = 0;
|
||||
R.examStaleResults = 0;
|
||||
R.examStarts = 0;
|
||||
R.examSubmits = 0;
|
||||
R.examConfirms = 0;
|
||||
R.examPaperAt = 0;
|
||||
R.examLeaving = false;
|
||||
// 注意:examLessonAt / examLessonTries 不在这里清。交卷后 backToCourse() 会重进同一门课,
|
||||
// 若清掉冷却就会立即重复点考试节,形成循环。它们在下一次 init() 进入新课时自然重置。
|
||||
R.initialLessonChecked = false;
|
||||
R.phaseSince = 0;
|
||||
R.alignTries = 0;
|
||||
R.alignStable = 0;
|
||||
R.alignFailed = false;
|
||||
R.manualCourseKey = '';
|
||||
R.lastAdvanceAt = 0;
|
||||
R.pageRestoreAttempts = 0;
|
||||
R.entryRetries = 0;
|
||||
}
|
||||
@@ -1,78 +0,0 @@
|
||||
// ======== 基础工具 ========
|
||||
export const norm = (s) => String(s || '').replace(/\s/g, '');
|
||||
export const truncate = (s, n) => (s.length > n ? s.slice(0, n) + '…' : s);
|
||||
|
||||
export function textOf(el) {
|
||||
try {
|
||||
return norm(el.innerText || el.textContent || '');
|
||||
} catch (e) {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
export function isVisible(el) {
|
||||
try {
|
||||
const win = (el.ownerDocument && el.ownerDocument.defaultView) || window;
|
||||
const r = el.getBoundingClientRect();
|
||||
if (r.width === 0 || r.height === 0) return false;
|
||||
const cs = win.getComputedStyle(el);
|
||||
return cs.display !== 'none' && cs.visibility !== 'hidden' && Number(cs.opacity) > 0;
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function findVisibleButton(re) {
|
||||
const els = document.querySelectorAll('button, [role="button"], a');
|
||||
for (const el of els) {
|
||||
if (re.test(textOf(el)) && isVisible(el)) return el;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 平台的「开始学习/继续学习」多数是 <button>,但个别页面把点击句柄放在
|
||||
// 文案 span 或外层 div 上。按由外到内找不到时,再找最内层的纯文字节点,
|
||||
// 点击会冒泡到真正的句柄。只认可见且没有兄弟文字干扰的最内层节点。
|
||||
export function findVisibleClickable(re) {
|
||||
const btn = findVisibleButton(re);
|
||||
if (btn && !btn.disabled) return btn;
|
||||
const els = document.querySelectorAll('div, span');
|
||||
for (const el of els) {
|
||||
if (el.children.length > 0) continue;
|
||||
if (!isVisible(el) || !re.test(textOf(el))) continue;
|
||||
if (el.closest && el.closest('button[disabled]')) continue;
|
||||
return el;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 从播放页 URL 里取课程 id:进课过渡页(#/scan)和真正的播放页
|
||||
// (#/course/play、#/video/play…)都带 kngId。
|
||||
export function courseIdFromUrl() {
|
||||
const m = String(location.hash || '').match(/[?&]kngId=([^&]+)/);
|
||||
if (!m) return '';
|
||||
try { return decodeURIComponent(m[1]); } catch (e) { return m[1]; }
|
||||
}
|
||||
|
||||
// 课程标题的「占位文案」:SPA 切换时页面标题会短暂变成这些通用词。
|
||||
// 用它区分「真的课程名」和「还没加载出来的兜底文案」,避免把兜底文案
|
||||
// 当成课程名写进 done/failed 记录(否则下次会重复进入同一门课)。
|
||||
const GENERIC_TITLE_RE = /^(loading|加载中|在线课堂|云课堂|云学堂|江丰云课堂|课程详情|课程|首页|我的学习)$/i;
|
||||
|
||||
export function isGenericCourseTitle(t) {
|
||||
return !norm(t) || GENERIC_TITLE_RE.test(norm(t));
|
||||
}
|
||||
|
||||
export function collectDocuments(win, out) {
|
||||
win = win || window;
|
||||
out = out || [];
|
||||
try {
|
||||
if (win.document) out.push(win.document);
|
||||
} catch (e) { /* 跨域 */ }
|
||||
try {
|
||||
for (let i = 0; i < win.frames.length; i++) {
|
||||
collectDocuments(win.frames[i], out);
|
||||
}
|
||||
} catch (e) { /* 跨域 */ }
|
||||
return out;
|
||||
}
|
||||
File diff suppressed because it is too large.
Load diff
Reference in new issue
Block a user