✨ feat(vscode): 代码阅读的解析与模板直译核心

vscode/src/codeReader/fixtures/envLock.ts.txt

@@ -0,0 +1,61 @@
+/**
+ * .env file lock / unlock helpers.
+ *
+ * Recursively scans the main workspace folder for `.env*` files (skipping
+ * `node_modules`, `.git`, `.claude`) and chmods them to 0o444 (locked) or
+ * 0o644 (unlocked) in bulk. Backs the toolbar Lock toggle in `PanelHeader`.
+ *
+ * No persistent watcher — re-scan happens on every toggle, so newly created
+ * `.env` files are only picked up the next time the user clicks the button.
+ */
+
+import { promises as fsp } from 'node:fs'
+import { RelativePattern, workspace } from 'vscode'
+
+const ENV_PATTERN = '**/.env*'
+const EXCLUDE_PATTERN = '{**/node_modules/**,**/.git/**,**/.claude/**}'
+
+/**
+ * Scan the workspace folder rooted at `workspaceRoot` for all `.env*`
+ * files, skipping `node_modules`, `.git`, and `.claude`. Returns absolute
+ * fs paths. Empty array if the workspace folder isn't currently open.
+ */
+export async function findEnvFiles(workspaceRoot: string): Promise<string[]> {
+  const folder = workspace.workspaceFolders?.find(f => f.uri.fsPath === workspaceRoot)
+  if (!folder)
+    return []
+  const include = new RelativePattern(folder, ENV_PATTERN)
+  const uris = await workspace.findFiles(include, EXCLUDE_PATTERN)
+  return uris.map(u => u.fsPath)
+}
+
+export interface EnvLockResult {
+  total: number
+  ok: string[]
+  failed: { path: string, reason: string }[]
+}
+
+async function chmodAll(workspaceRoot: string, mode: number): Promise<EnvLockResult> {
+  const files = await findEnvFiles(workspaceRoot)
+  const result: EnvLockResult = { total: files.length, ok: [], failed: [] }
+  for (const f of files) {
+    try {
+      await fsp.chmod(f, mode)
+      result.ok.push(f)
+    }
+    catch (err) {
+      result.failed.push({ path: f, reason: err instanceof Error ? err.message : String(err) })
+    }
+  }
+  return result
+}
+
+/** Set every `.env*` file in the workspace to 0o444 (read-only). */
+export async function lockEnvFiles(workspaceRoot: string): Promise<EnvLockResult> {
+  return chmodAll(workspaceRoot, 0o444)
+}
+
+/** Restore every `.env*` file in the workspace to 0o644 (read-write). */
+export async function unlockEnvFiles(workspaceRoot: string): Promise<EnvLockResult> {
+  return chmodAll(workspaceRoot, 0o644)
+}

vscode/src/codeReader/fixtures/issueLock.ts.txt

@@ -0,0 +1,25 @@
+import type { Issue } from '../gitea/types'
+
+export interface LockedReason {
+  locked: boolean
+  prerequisiteNumber?: number
+  prerequisiteColumn?: string
+}
+
+/**
+ * 纯判定：工单被未完成的前置挡住才算锁定。快照里找不到工单或前置一律放行，
+ * 与 webview 的 `isIssueLocked` 保持同一语义。
+ */
+export function evaluateLockedReason(issues: Issue[], issueNumber: number): LockedReason {
+  const issue = issues.find(i => i.number === issueNumber)
+  if (!issue || issue.prerequisite === undefined)
+    return { locked: false }
+  const prereq = issues.find(i => i.number === issue.prerequisite)
+  if (!prereq || prereq.column === 'done')
+    return { locked: false }
+  return {
+    locked: true,
+    prerequisiteNumber: prereq.number,
+    prerequisiteColumn: prereq.column,
+  }
+}

vscode/src/codeReader/fixtures/sample.py

@@ -0,0 +1,40 @@
+"""Scan a workspace for .env files."""
+
+import os
+from pathlib import Path as P
+
+MAX_DEPTH = 8
+skipped = []
+
+
+def find_env_files(root: str) -> list[str]:
+    """Return every .env file under root."""
+    # 跳过备份文件
+    found = [p for p in os.listdir(root) if p.startswith('.env') and not p.endswith('.bak')]
+    if not found:
+        return []
+    elif len(found) > MAX_DEPTH:
+        found = found[:MAX_DEPTH]
+    else:
+        pass
+    for name in found:
+        if name in skipped:
+            continue
+    try:
+        with open(os.path.join(root, found[0])) as handle:
+            handle.read()
+    except OSError as err:
+        raise RuntimeError(str(err)) from err
+    finally:
+        skipped.clear()
+    return found
+
+
+class EnvLockResult:
+    total: int
+    ok: list[str] = []
+    failed: dict[str, str] = {}
+    label = 'env'
+
+    def summary(self, verbose: bool = False) -> str:
+        return f'{self.total} files' if verbose is not None else ''