pi-coding-master 0.2.7

package/core/technology.phone/apps.preinstalled/clock/clock.ts

@@ -0,0 +1,132 @@
+// apps.preinstalled/clock/clock.ts — Clock tool (纯 pi 实现)
+// 闹钟 / 秒表 / 计时器
+
+import * as fs from "fs";
+import * as path from "path";
+
+interface Alarm { id: number; label: string; time: string; enabled: boolean; repeat: string; created: string; }
+interface State { sw_status: "reset"|"running"|"stopped"; sw_accumulated: number; sw_started_at: number; sw_laps: {number:number;split:number;total:number}[]; timer_status: "idle"|"running"; timer_label: string; timer_total_secs: number; timer_started_at: number; }
+
+function loadJson(p: string): any[] { try { return JSON.parse(fs.readFileSync(p,"utf8")); } catch { return []; } }
+function saveJson(p: string, d: any[]) { fs.mkdirSync(path.dirname(p),{recursive:true}); fs.writeFileSync(p,JSON.stringify(d,null,2)); }
+function fmt(secs: number): string { const h=Math.floor(secs/3600),m=Math.floor((secs%3600)/60),s=Math.floor(secs%60); return h>0?`${h}:${String(m).padStart(2,"0")}:${String(s).padStart(2,"0")}`:`${String(m).padStart(2,"0")}:${String(s).padStart(2,"0")}`; }
+
+let state: State = { sw_status:"reset",sw_accumulated:0,sw_started_at:0,sw_laps:[], timer_status:"idle",timer_label:"",timer_total_secs:0,timer_started_at:0 };
+
+function swElapsed(): number { let acc=state.sw_accumulated; if(state.sw_status==="running"&&state.sw_started_at) acc+=(Date.now()-state.sw_started_at)/1000; return acc; }
+
+export async function clockCmd(args: any, _ctx: any, personDir: string): Promise<{ content: any[]; details: any }> {
+  const a=args.action||"", p=args, af=path.join(personDir,"clock_alarms.json");
+
+  if (a==="alarm_create") {
+    const alarms=loadJson(af);
+    const id=alarms.length>0?Math.max(...alarms.map((x:any)=>x.id))+1:1;
+    alarms.push({id,label:p.label||"闹钟",time:p.time||"08:00",enabled:true,repeat:p.repeat||"once",created:new Date().toISOString()});
+    saveJson(af,alarms);
+    return {content:[{type:"text",text:`已创建:「${p.label||"闹钟"}」${p.time||"08:00"}`}],details:{}};
+  }
+  if (a==="alarm_delete") {
+    let alarms=loadJson(af); const id=parseInt(p.id); const t=alarms.find((x:any)=>x.id===id);
+    alarms=alarms.filter((x:any)=>x.id!==id); saveJson(af,alarms);
+    return {content:[{type:"text",text:t?`已删除「${t.label}」`:"未找到"}],details:{}};
+  }
+  if (a==="alarm_delete_all") { saveJson(af,[]); return {content:[{type:"text",text:"已删除全部闹钟"}],details:{}}; }
+  if (a==="alarm_toggle") {
+    const alarms=loadJson(af); const id=parseInt(p.id); const t=alarms.find((x:any)=>x.id===id);
+    if(!t) return {content:[{type:"text",text:"未找到"}],details:{}};
+    t.enabled=!t.enabled; saveJson(af,alarms);
+    return {content:[{type:"text",text:`「${t.label}」已${t.enabled?"开启":"关闭"}`}],details:{}};
+  }
+  if (a==="alarm_list") {
+    const alarms=loadJson(af);
+    if(alarms.length===0) return {content:[{type:"text",text:"暂无闹钟"}],details:{}};
+    const lines=["闹钟列表:"]; for(const x of alarms) lines.push(`  [${x.id}] ${x.enabled?"ON":"OFF"} ${x.label} — ${x.time}`);
+    return {content:[{type:"text",text:lines.join("\n")}],details:{alarms}};
+  }
+
+  if (a==="stopwatch_start") { state={...state,sw_status:"running",sw_accumulated:0,sw_started_at:Date.now(),sw_laps:[]}; return {content:[{type:"text",text:"秒表已启动"}],details:{}}; }
+  if (a==="stopwatch_pause") { if(state.sw_status!=="running") return {content:[{type:"text",text:"秒表未在运行"}],details:{}}; state.sw_accumulated=swElapsed(); state.sw_status="stopped"; state.sw_started_at=0; return {content:[{type:"text",text:`暂停 (${fmt(state.sw_accumulated)})`}],details:{}}; }
+  if (a==="stopwatch_resume") { if(state.sw_status!=="stopped") return {content:[{type:"text",text:"秒表未暂停"}],details:{}}; state.sw_status="running"; state.sw_started_at=Date.now(); return {content:[{type:"text",text:"已继续"}],details:{}}; }
+  if (a==="stopwatch_reset") { state={...state,sw_status:"reset",sw_accumulated:0,sw_started_at:0,sw_laps:[]}; return {content:[{type:"text",text:"已重置"}],details:{}}; }
+  if (a==="stopwatch_lap") { if(state.sw_status!=="running") return {content:[{type:"text",text:"秒表未在运行"}],details:{}}; const e=swElapsed(),lt=state.sw_laps.length>0?state.sw_laps[state.sw_laps.length-1].total:0; state.sw_laps.push({number:state.sw_laps.length+1,split:Math.round((e-lt)*10)/10,total:Math.round(e*10)/10}); return {content:[{type:"text",text:`计次#${state.sw_laps.length}`}],details:{laps:state.sw_laps}}; }
+  if (a==="stopwatch_query") { const e=swElapsed(),lb:Record<string,string>={running:"运行中",stopped:"已暂停",reset:"未启动"}; return {content:[{type:"text",text:`秒表 ${lb[state.sw_status]} ${fmt(e)}${state.sw_laps.length>0?` (${state.sw_laps.length}次计次)`:""}`}],details:{status:state.sw_status,elapsed:Math.round(e*10)/10,laps:state.sw_laps}}; }
+
+  if (a==="timer_start") { const m=parseInt(p.minutes)||5; state.timer_status="running"; state.timer_label=p.label||`${m}分钟`; state.timer_total_secs=m*60; state.timer_started_at=Date.now(); return {content:[{type:"text",text:`已启动: ${state.timer_label}`}],details:{}}; }
+  if (a==="timer_cancel") { state.timer_status="idle"; state.timer_started_at=0; return {content:[{type:"text",text:"已取消"}],details:{}}; }
+  if (a==="timer_query") { if(state.timer_status!=="running") return {content:[{type:"text",text:"计时器未运行"}],details:{}}; const r=Math.max(0,state.timer_total_secs-(Date.now()-state.timer_started_at)/1000); return {content:[{type:"text",text:`「${state.timer_label}」剩余 ${fmt(r)}`}],details:{remaining:Math.round(r*10)/10}}; }
+
+  return {content:[{type:"text",text:`未知操作: ${a}`}],details:{}};
+}
+
+// ── PhoneApp wrapper ──────────────────────────────────────────
+import type { PhoneApp } from "../../system.kernel/kernel.ts";
+
+export const app: PhoneApp = {
+  name: "时钟",
+  icon: "时钟",
+  messageDescription: "闹钟、秒表、计时器",
+
+  onOpen(state, personDir) {
+    const lines = [
+      "═══ 时钟 ═══",
+      "",
+      "  闹钟:",
+      "  · 闹钟列表         — 查看所有闹钟",
+      "  · 创建闹钟 HH:MM [标签] — 创建闹钟",
+      "  · 删除闹钟 <id>    — 删除闹钟",
+      "  · 开关闹钟 <id>    — 开启/关闭闹钟",
+      "",
+      "  秒表:",
+      "  · 开始秒表  · 暂停秒表  · 继续秒表",
+      "  · 重置秒表  · 计次      · 秒表状态",
+      "",
+      "  计时器:",
+      "  · 计时 <分钟> [标签]  — 开始倒计时",
+      "  · 取消计时           — 取消计时器",
+      "  · 计时状态           — 查看剩余",
+      "",
+      "  返回 — 回主屏幕",
+    ];
+    return { screen: lines.join("\n"), state: state ?? {} };
+  },
+
+  async onAction(input, state, personDir) {
+    const trimmed = input.trim();
+    let args: any = {};
+
+    if (/^闹钟列表$/i.test(trimmed)) {
+      args = { action: "alarm_list" };
+    } else if (/^(创建闹钟|新建闹钟)\s+(\d{1,2}:\d{2})\s*(.*)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:创建闹钟|新建闹钟)\s+(\d{1,2}:\d{2})\s*(.*)$/i)!;
+      args = { action: "alarm_create", time: m[1], label: m[2] || "闹钟" };
+    } else if (/^删除闹钟\s+(\d+)$/.test(trimmed)) {
+      args = { action: "alarm_delete", id: trimmed.match(/(\d+)$/)![1] };
+    } else if (/^(删除全部闹钟|清空闹钟)$/.test(trimmed)) {
+      args = { action: "alarm_delete_all" };
+    } else if (/^(开关闹钟|切换闹钟)\s+(\d+)$/.test(trimmed)) {
+      args = { action: "alarm_toggle", id: trimmed.match(/(\d+)$/)![1] };
+    } else if (/^开始秒表$/.test(trimmed)) {
+      args = { action: "stopwatch_start" };
+    } else if (/^暂停秒表$/.test(trimmed)) {
+      args = { action: "stopwatch_pause" };
+    } else if (/^继续秒表$/.test(trimmed)) {
+      args = { action: "stopwatch_resume" };
+    } else if (/^重置秒表$/.test(trimmed)) {
+      args = { action: "stopwatch_reset" };
+    } else if (/^计次$/.test(trimmed)) {
+      args = { action: "stopwatch_lap" };
+    } else if (/^秒表(状态)?$/.test(trimmed)) {
+      args = { action: "stopwatch_query" };
+    } else if (/^计时\s+(\d+)\s*(.*)$/.test(trimmed)) {
+      const m = trimmed.match(/^计时\s+(\d+)\s*(.*)$/)!;
+      args = { action: "timer_start", minutes: m[1], label: m[2] || undefined };
+    } else if (/^取消计时$/.test(trimmed)) {
+      args = { action: "timer_cancel" };
+    } else if (/^计时状态$/.test(trimmed)) {
+      args = { action: "timer_query" };
+    }
+
+    const result = await clockCmd(args, {}, personDir);
+    return { screen: result.content[0].text, state: state ?? {} };
+  },
+};

package/core/technology.phone/apps.preinstalled/clock/clock.ts.SPEC

@@ -0,0 +1,11 @@
+source: clock.ts @ cf71e1ae
+
+# clock.ts SPEC
+## 用途
+时钟工具——闹钟、秒表、计时器。根据 BlueBox OS Clock.app 的 Info.plist 定义的 intents 实现为 pi AI 工具。
+## 为什么需要
+用户指令原话："里面规划的app的功能都要实现"——要求按 BlueBox OS SPECS 把各 App 能力做成 pi 工具。Clock 是第一个。
+## 能力
+- 闹钟: 创建/删除/批量删除/开关/列表
+- 秒表: 启动/暂停/继续/重置/计次/查询
+- 计时器: 启动/取消/查询

package/core/technology.phone/apps.preinstalled/contacts.FUTURE/contacts.ts

@@ -0,0 +1,300 @@
+// apps.preinstalled/contacts/contacts.ts — Contacts app + relationship memory
+// v0.2 spec: 通讯录 — 联系人管理，每个联系人有独立备注/关系记忆
+// Per-person memory: index + entries with timestamps, searchable
+
+import * as fs from "fs";
+import * as path from "path";
+
+// ── Contact types ──────────────────────────────────────────────
+type ContactKind = "human" | "ai" | "group";
+
+interface Contact {
+  id: string;              // unique persistent ID
+  name: string;            // display name
+  alias?: string;          // personal nickname
+  kind: ContactKind;
+  messageDescription?: string;    // bio / self-introduction
+  tags: string[];          // e.g. ["colleague", "friend", "family"]
+  created: string;         // ISO timestamp
+  updated: string;
+}
+
+interface RelationshipNote {
+  id: string;
+  contactId: string;
+  timestamp: string;
+  content: string;         // freeform note — observations, context, decisions
+  context?: string;        // optional: what prompted this note
+}
+
+// ── Storage paths ──────────────────────────────────────────────
+function contactsDir(personDir: string) {
+  const dir = path.join(personDir, "contacts");
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+function contactsIndexPath(personDir: string) {
+  return path.join(contactsDir(personDir), "index.json");
+}
+
+function contactNotesPath(personDir: string, contactId: string) {
+  const dir = path.join(contactsDir(personDir), contactId);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  return path.join(dir, "notes.jsonl");
+}
+
+// ── Load / save ────────────────────────────────────────────────
+function loadContacts(personDir: string): Contact[] {
+  try {
+    return JSON.parse(fs.readFileSync(contactsIndexPath(personDir), "utf8"));
+  } catch {
+    return [];
+  }
+}
+
+function saveContacts(personDir: string, contacts: Contact[]) {
+  fs.writeFileSync(contactsIndexPath(personDir), JSON.stringify(contacts, null, 2));
+}
+
+function loadNotes(personDir: string, contactId: string): RelationshipNote[] {
+  try {
+    const raw = fs.readFileSync(contactNotesPath(personDir, contactId), "utf8");
+    return raw.trim().split("\n").filter(Boolean).map(line => JSON.parse(line));
+  } catch {
+    return [];
+  }
+}
+
+function appendNote(personDir: string, note: RelationshipNote) {
+  fs.appendFileSync(contactNotesPath(personDir, note.contactId), JSON.stringify(note) + "\n");
+}
+
+function generateId(): string {
+  return `c-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+}
+
+// ── Search ─────────────────────────────────────────────────────
+function searchContacts(contacts: Contact[], query: string): Contact[] {
+  const q = query.toLowerCase();
+  return contacts.filter(c =>
+    c.name.toLowerCase().includes(q) ||
+    (c.alias && c.alias.toLowerCase().includes(q)) ||
+    (c.tags && c.tags.some((t: string) => t.toLowerCase().includes(q))) ||
+    (c.messageDescription && c.messageDescription.toLowerCase().includes(q))
+  );
+}
+
+function searchNotes(notes: RelationshipNote[], query: string, limit = 20): RelationshipNote[] {
+  const q = query.toLowerCase();
+  return notes
+    .filter(n => n.content.toLowerCase().includes(q) || (n.context && n.context.toLowerCase().includes(q)))
+    .slice(-limit);
+}
+
+// ── Render ─────────────────────────────────────────────────────
+function renderContact(c: Contact, recentNotes: RelationshipNote[]): string {
+  const lines = [
+    `**${c.name}**${c.alias ? ` (${c.alias})` : ""}`,
+    `  ID: \`${c.id}\``,
+    `  Kind: ${c.kind}  ·  Tags: ${(c.tags || []).join(", ") || "—"}`,
+  ];
+  if (c.messageDescription) lines.push(`  Bio: ${c.messageDescription}`);
+  if (recentNotes.length > 0) {
+    lines.push(`  📝 ${recentNotes.length} notes (latest 3):`);
+    for (const n of recentNotes.slice(-3)) {
+      lines.push(`    [${n.timestamp.slice(0, 16)}] ${n.content.slice(0, 120)}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+function renderContactList(contacts: Contact[]): string {
+  if (contacts.length === 0) return "👥 通讯录为空。用 `contacts --add <name> [--kind human|ai|group]` 添加。";
+
+  const lines = ["👥 **通讯录**"];
+  for (const c of contacts) {
+    const kindIcon = { human: "🧑", ai: "🤖", group: "👥" }[c.kind];
+    lines.push(`  ${kindIcon} **${c.name}**${c.alias ? ` (${c.alias})` : ""}  ·  \`${c.id}\``);
+  }
+  lines.push(`\n共 ${contacts.length} 人。`);
+  lines.push("Commands: `contacts --add` · `contacts --search <q>` · `contacts --show <id>` · `contacts --note <id> <text>`");
+  return lines.join("\n");
+}
+
+// ── Main handler ───────────────────────────────────────────────
+export async function contactsCmd(args: any, _ctx: any, personDir: string): Promise<any> {
+  const contacts = loadContacts(personDir);
+
+  // --add: create new contact
+  if (args.add) {
+    const name = typeof args.add === "string" ? args.add : args._?.[1];
+    if (!name) return { content: [{ type: "text", text: "Usage: contacts --add <name> [--kind human|ai|group] [--alias <nickname>]" }] };
+
+    const kind = (args.kind as ContactKind) || "ai";
+    const alias = args.alias as string | undefined;
+
+    const contact: Contact = {
+      id: generateId(),
+      name,
+      alias,
+      kind,
+      tags: [],
+      created: new Date().toISOString(),
+      updated: new Date().toISOString(),
+    };
+
+    contacts.push(contact);
+    saveContacts(personDir, contacts);
+
+    return { content: [{ type: "text", text: `✅ Added **${name}** (${kind}) — ID: \`${contact.id}\`` }] };
+  }
+
+  // --show <id>: show contact detail
+  if (args.show) {
+    const id = args.show as string;
+    const contact = contacts.find(c => c.id === id);
+    if (!contact) return { content: [{ type: "text", text: `❌ Contact not found: ${id}` }] };
+
+    const notes = loadNotes(personDir, id);
+    return { content: [{ type: "text", text: renderContact(contact, notes) }] };
+  }
+
+  // --search: fuzzy search
+  if (args.search) {
+    const query = args.search as string;
+    const results = searchContacts(contacts, query);
+    if (results.length === 0) {
+      return { content: [{ type: "text", text: `🔍 No contacts matching "${query}".` }] };
+    }
+    return { content: [{ type: "text", text: renderContactList(results) }] };
+  }
+
+  // --note <id> <text>: add relationship note
+  if (args.note) {
+    const id = typeof args.note === "string" ? args.note : args._?.[1];
+    const text = typeof args._?.[2] === "string" ? args._?.[2] : args.text;
+    if (!id || !text) {
+      return { content: [{ type: "text", text: "Usage: contacts --note <contact-id> <text>" }] };
+    }
+
+    const contact = contacts.find(c => c.id === id);
+    if (!contact) return { content: [{ type: "text", text: `❌ Contact not found: ${id}` }] };
+
+    const note: RelationshipNote = {
+      id: `n-${Date.now()}`,
+      contactId: id,
+      timestamp: new Date().toISOString(),
+      content: text,
+    };
+
+    appendNote(personDir, note);
+    contact.updated = new Date().toISOString();
+    saveContacts(personDir, contacts);
+
+    const noteCount = loadNotes(personDir, id).length;
+    return { content: [{ type: "text", text: `📝 Note added for **${contact.name}** (${noteCount} total).` }] };
+  }
+
+  // --notes <id>: list all notes for a contact
+  if (args.notes) {
+    const id = args.notes as string;
+    const contact = contacts.find(c => c.id === id);
+    if (!contact) return { content: [{ type: "text", text: `❌ Contact not found: ${id}` }] };
+
+    const notes = loadNotes(personDir, id);
+    const queryNote = args.search as string;
+    const displayNotes = queryNote ? searchNotes(notes, queryNote) : notes.slice(-50);
+
+    const lines = [`📝 **Notes for ${contact.name}** (${notes.length} total)`];
+    for (const n of displayNotes) {
+      lines.push(`  [${n.timestamp.slice(0, 19)}] ${n.content}`);
+      if (n.context) lines.push(`    ↳ context: ${n.context}`);
+    }
+    if (queryNote) lines.push(`\n🔍 Search: "${queryNote}" — ${displayNotes.length} results`);
+
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+
+  // --tag <id> <tag>: add tag
+  if (args.tag) {
+    const id = args.tag as string;
+    const tag = args._?.[1] as string;
+    if (!tag) return { content: [{ type: "text", text: "Usage: contacts --tag <contact-id> <tag>" }] };
+
+    const contact = contacts.find(c => c.id === id);
+    if (!contact) return { content: [{ type: "text", text: `❌ Contact not found: ${id}` }] };
+
+    if (!contact.tags.includes(tag)) {
+      contact.tags.push(tag);
+      contact.updated = new Date().toISOString();
+      saveContacts(personDir, contacts);
+    }
+    return { content: [{ type: "text", text: `🏷 Tagged **${contact.name}** with "${tag}". Tags: ${contact.tags.join(", ")}` }] };
+  }
+
+  // default: list all
+  return { content: [{ type: "text", text: renderContactList(contacts) }] };
+}
+
+export { type Contact, type RelationshipNote };
+
+// ── PhoneApp wrapper ──────────────────────────────────────────
+import type { PhoneApp } from "../../system.kernel/kernel.ts";
+
+export const app: PhoneApp = {
+  name: "通讯录",
+  icon: "👤",
+  messageDescription: "联系人管理与关系记忆",
+
+  onOpen(state, personDir) {
+    const contacts = loadContacts(personDir);
+    const lines = [
+      "═══ 👤 通讯录 ═══",
+      "",
+      `  联系人: ${contacts.length} 人`,
+      "",
+      "  操作:",
+      "  · 列表           — 查看所有联系人",
+      "  · 添加 <姓名>    — 添加联系人",
+      "  · 搜索 <关键词>  — 搜索联系人",
+      "  · 详情 <id>      — 查看联系人详情",
+      "  · 备注 <id> <内容> — 添加关系备注",
+      "  · 笔记 <id>      — 查看所有备注",
+      "  · 标签 <id> <tag> — 添加标签",
+      "",
+      "  返回 — 回主屏幕",
+    ];
+    return { screen: lines.join("\n"), state: state ?? {} };
+  },
+
+  async onAction(input, state, personDir) {
+    const trimmed = input.trim();
+    let args: any = {};
+
+    if (/^(列表|list)$/i.test(trimmed)) {
+      args = {};
+    } else if (/^(添加|add)\s+(.+)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:添加|add)\s+(.+)$/i)!;
+      args = { add: m[1] };
+    } else if (/^(搜索|search)\s+(.+)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:搜索|search)\s+(.+)$/i)!;
+      args = { search: m[1] };
+    } else if (/^(详情|show)\s+(.+)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:详情|show)\s+(.+)$/i)!;
+      args = { show: m[1] };
+    } else if (/^(备注|note)\s+(\S+)\s+(.+)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:备注|note)\s+(\S+)\s+(.+)$/i)!;
+      args = { note: m[1], text: m[2] };
+    } else if (/^(笔记|notes)\s+(\S+)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:笔记|notes)\s+(\S+)$/i)!;
+      args = { notes: m[1] };
+    } else if (/^(标签|tag)\s+(\S+)\s+(\S+)$/i.test(trimmed)) {
+      const m = trimmed.match(/^(?:标签|tag)\s+(\S+)\s+(\S+)$/i)!;
+      args = { tag: m[1], _: [undefined, m[2]] };
+    }
+
+    const result = await contactsCmd(args, {}, personDir);
+    return { screen: result.content[0].text, state: state ?? {} };
+  },
+};

package/core/technology.phone/apps.preinstalled/contacts.FUTURE/contacts.ts.SPEC

@@ -0,0 +1,22 @@
+source: contacts.ts @ c9467f99
+
+# Contacts -- 通讯录与关系记忆
+
+## 功能
+管理联系人（human/ai/group）及每个联系人的关系备忘。支持标签、别名、搜索、独立笔记时间线。
+
+## 操作
+- `--add <name>` -- 添加联系人（可选 `--kind human|ai|group`, `--alias`）
+- `--show <id>` -- 联系人详情 + 最近 3 条笔记
+- `--search <q>` -- 按姓名/别名/标签/描述模糊搜索
+- `--note <id> <text>` -- 为联系人追加关系备忘
+- `--notes <id>` -- 列出联系人全部笔记（可配合 `--search` 过滤）
+- `--tag <id> <tag>` -- 添加标签
+- 无参数 -- 列出全部联系人
+
+## 数据
+- `{personDir}/contacts/index.json` -- Contact[] 索引
+- `{personDir}/contacts/{contactId}/notes.jsonl` -- 每人独立 JSONL 笔记
+
+## 备注
+笔记用 appendFile 追加（JSONL），不做覆写，适合长期增量积累。

package/core/technology.phone/apps.preinstalled/developer.FUTURE/developer.ts

@@ -0,0 +1,22 @@
+// apps.preinstalled/developer/developer.ts — developer tool (AI) — stub
+import type { PhoneApp } from "../../system.kernel/kernel.ts";
+
+export async function developerCmd(args: any, _ctx: any, _personDir: string): Promise<{ content: any[]; details: any }> {
+  return { content: [{ type: "text", text: "developer 功能尚未实现" }], details: {} };
+}
+
+// ── PhoneApp ──────────────────────────────────────────────────
+export const app: PhoneApp = {
+  name: "开发者",
+  icon: "🔧",
+  messageDescription: "开发者工具",
+  onOpen(_state, _personDir) {
+    return {
+      screen: "🔧 开发者\n\n功能开发中...",
+      state: _state ?? {},
+    };
+  },
+  onAction(_input, state, _personDir) {
+    return { screen: "🔧 开发者\n\n功能开发中...", state };
+  },
+};

package/core/technology.phone/apps.preinstalled/developer.FUTURE/developer.ts.SPEC

@@ -0,0 +1,15 @@
+source: developer.ts @ 1c4902a8
+
+# Developer -- 开发者工具（未实现）
+
+## 功能
+开发者工具。当前为 stub，所有调用返回"developer 功能尚未实现"。
+
+## 操作
+无。所有参数被忽略。
+
+## 数据
+无数据存储。
+
+## 备注
+纯 stub，导出 `developerCmd`，等待后续实现。