@foolsecret/pi-prompt 0.4.0

package/src/time.ts

@@ -0,0 +1,40 @@
+/**
+ * 北京时间工具（低层纯函数，无项目内依赖）。
+ *
+ * 为什么单独一层：`isDeepSeekPeakHours` 被 auto（选档）与 stats（兜底价格）
+ * 双方使用；若留在 auto.ts，stats.ts import 它就会与 auto.ts→stats.ts
+ * 的导入形成循环（参见 pi-pricer 踩坑 #2：共享函数必须下沉到低层模块）。
+ */
+
+/** 北京时间偏移（UTC+8，无夏令时） */
+const BEIJING_OFFSET_MS = 8 * 60 * 60 * 1000;
+
+/**
+ * DeepSeek 高峰时段（北京时间）：工作日 9-12 与 14-18；周六/周日全天非高峰。
+ * 注意：这是**硬编码的公开时段**，仅用于内置兜底价格；用户装了 pi-pricer 后，
+ * 峰谷由其在 model-pricing.json 里配置的 schedule 决定。
+ */
+export function isDeepSeekPeakHours(date: Date): boolean {
+	// +8h 后的 UTC 周几/几点 = 北京周几/几点
+	const bj = new Date(date.getTime() + BEIJING_OFFSET_MS);
+	const bjDay = bj.getUTCDay();
+	if (bjDay === 0 || bjDay === 6) return false; // 周日/周六全天非峰
+	const bjHour = bj.getUTCHours();
+	return (bjHour >= 9 && bjHour < 12) || (bjHour >= 14 && bjHour < 18);
+}
+
+/** 北京时区（UTC+8）的 YYYY-MM-DD 字符串（抽样日计数/频控用） */
+export function beijingDate(date: Date): string {
+	const bj = new Date(date.getTime() + BEIJING_OFFSET_MS);
+	const y = bj.getUTCFullYear();
+	const m = String(bj.getUTCMonth() + 1).padStart(2, "0");
+	const d = String(bj.getUTCDate()).padStart(2, "0");
+	return `${y}-${m}-${d}`;
+}
+
+/** 时间戳归一为 Date（缺省 = 此刻）；数值视为毫秒时间戳 */
+export function toDate(timestamp?: Date | number): Date {
+	if (timestamp instanceof Date) return timestamp;
+	if (typeof timestamp === "number") return new Date(timestamp);
+	return new Date();
+}

package/src/ui.ts

@@ -0,0 +1,156 @@
+/**
+ * 三轴设置抽屉（复刻 pi /settings 的交互效果）：上下 DynamicBorder 彩色边框 +
+ * 中间 SettingsList，选中行时说明栏随键盘上下切换（description 即"帮助栏/说明栏"）。
+ *
+ * 设计规范见仓库根 DESIGN.md（design-md 格式）：本模块是可复用部件，
+ * 只负责"渲染 + 把变更转发给回调"，不接触配置/台账（由调用方接线）。
+ */
+
+import { DynamicBorder, getSettingsListTheme } from "@earendil-works/pi-coding-agent";
+import { Container, SettingsList, Text, type SettingItem } from "@earendil-works/pi-tui";
+import type { DoMode, ShowMode, WriteMode } from "./modes.ts";
+import type { AxisName } from "./command.ts";
+
+/** 抽屉展示所需的当前状态：会话轴 + 默认轴（各三档） */
+export interface PromptConfigDrawerState {
+	session: { show: ShowMode; write: WriteMode; do: DoMode };
+	defaults: { show: ShowMode; write: WriteMode; do: DoMode };
+}
+
+/** 抽屉各行的值域（show 含 auto 元档位，放第一项便于循环命中"自动"） */
+const SHOW_VALUES: readonly string[] = ["auto", "normal", "lite", "full", "ultra"];
+const WRITE_VALUES: readonly string[] = ["minimal", "normal", "complete"];
+const DO_VALUES: readonly string[] = ["direct", "normal", "deep"];
+
+/** 设置项 id 的取值：会话轴 show|write|do；默认档 default-<轴> */
+const SESSION_IDS: readonly AxisName[] = ["show", "write", "do"];
+const DEFAULT_PREFIX = "default-";
+
+/**
+ * 依据当前状态生成设置项列表（纯函数，不依赖 TUI，可单测）。
+ * 每项都有 description —— SettingsList 会把选中项的 description 渲染在
+ * 提示行上方，这就是"说明栏随光标切换"的机制。
+ */
+export function buildSettingItems(state: PromptConfigDrawerState): SettingItem[] {
+	const session: SettingItem[] = [
+		{
+			id: "show",
+			label: "会话输出风格（show）",
+			currentValue: state.session.show,
+			values: [...SHOW_VALUES],
+			description:
+				"输出风格：auto 按成本函数每轮自动选档；ultra 电报式最省、full 常规精炼、lite 轻柔、normal 不注入（基础行为）。",
+		},
+		{
+			id: "write",
+			label: "会话代码量（write）",
+			currentValue: state.session.write,
+			values: [...WRITE_VALUES],
+			description: "代码写量：minimal 只交付最小可跑实现、normal 常规、complete 富注释带文档。",
+		},
+		{
+			id: "do",
+			label: "会话行为力度（do）",
+			currentValue: state.session.do,
+			values: [...DO_VALUES],
+			description: "行为力度：direct 收敛最小步骤、normal 常规、deep 主动查证根因与边界。",
+		},
+	];
+	const defaults: SettingItem[] = [
+		{
+			id: `${DEFAULT_PREFIX}show`,
+			label: "默认输出风格（show）",
+			currentValue: state.defaults.show,
+			values: [...SHOW_VALUES],
+			description: "新会话默认的输出风格（后续会话生效，不影响当前会话）。",
+		},
+		{
+			id: `${DEFAULT_PREFIX}write`,
+			label: "默认代码量（write）",
+			currentValue: state.defaults.write,
+			values: [...WRITE_VALUES],
+			description: "新会话默认的代码写量。",
+		},
+		{
+			id: `${DEFAULT_PREFIX}do`,
+			label: "默认行为力度（do）",
+			currentValue: state.defaults.do,
+			values: [...DO_VALUES],
+			description: "新会话默认的行为力度。",
+		},
+	];
+	return [...session, ...defaults];
+}
+
+/** 设置项 id → 是否为默认档行，以及对应的轴 */
+export function resolveSettingId(id: string): { axis: AxisName; isDefault: boolean } | null {
+	if (SESSION_IDS.includes(id as AxisName)) return { axis: id as AxisName, isDefault: false };
+	if (id.startsWith(DEFAULT_PREFIX)) {
+		const axis = id.slice(DEFAULT_PREFIX.length) as AxisName;
+		if (SESSION_IDS.includes(axis)) return { axis, isDefault: true };
+	}
+	return null;
+}
+
+/** 抽屉所需的回调接线（由 PromptExtension 提供，注入以便单测） */
+export interface PromptConfigDrawerCallbacks {
+	onSessionAxisChange: (axis: AxisName, value: string) => void;
+	onDefaultAxisChange: (axis: AxisName, value: string) => void;
+}
+
+/**
+ * 三轴设置抽屉：open 时在 ctx.ui 上开一个 /settings 同款抽屉；
+ * 无 TUI（非交互模式）时交给 onUnavailable 回退。
+ */
+export class PromptConfigDrawer {
+	constructor(
+		private readonly readState: () => PromptConfigDrawerState,
+		private readonly callbacks: PromptConfigDrawerCallbacks,
+		private readonly onUnavailable: (context: unknown) => void,
+	) {}
+
+	/** 打开抽屉；无 custom UI 时走回退分支 */
+	async open(context: unknown): Promise<void> {
+		const ui = (context as { ui?: { custom?: unknown } })?.ui;
+		if (typeof ui?.custom !== "function") {
+			this.onUnavailable(context);
+			return;
+		}
+		const items = buildSettingItems(this.readState());
+		await (ui.custom as (factory: unknown) => Promise<unknown>)(
+			(tui: unknown, theme: { fg: (color: string, text: string) => string; bold: (text: string) => string }, _kb: unknown, done: (result?: undefined) => void) => {
+				const container = new Container();
+				container.addChild(new DynamicBorder((s: string) => theme.fg("borderAccent", s)));
+				container.addChild(
+					new Text(theme.fg("accent", theme.bold("pi-prompt 设置")), 1, 1),
+				);
+				const settingsList = new SettingsList(
+					items,
+					Math.min(items.length + 4, 12),
+					getSettingsListTheme(),
+					(id, newValue) => this.handleChange(String(id), String(newValue)),
+					() => done(undefined),
+					{ enableSearch: true },
+				);
+				container.addChild(settingsList);
+				container.addChild(new DynamicBorder((s: string) => theme.fg("borderAccent", s)));
+				return {
+					render: (w: number) => container.render(w),
+					invalidate: () => container.invalidate(),
+					handleInput: (data: unknown) => settingsList.handleInput?.(data as string),
+				};
+			},
+		);
+	}
+
+	/** 行变更分发：会话行 vs 默认档行，分别走对应回调 */
+	private handleChange(id: string, value: string): void {
+		const resolved = resolveSettingId(id);
+		if (!resolved) return;
+		if (resolved.isDefault) {
+			this.callbacks.onDefaultAxisChange(resolved.axis, value);
+		} else {
+			this.callbacks.onSessionAxisChange(resolved.axis, value);
+		}
+	}
+}