pi-coding-master 0.2.7

package/core/individual.bio.organs/organs.README

@@ -0,0 +1,110 @@
+# func 设计规范
+
+`individual.bio.organs/` 下每个文件夹是一个 **func**（功能单元 / 生物学里的「蛋白质机器」）。
+本规范定义每个 func 必须长什么样，才能被 kernel 装配、被 DNA 管理、可运行。
+
+> 一句话：**func = 一个文件夹 + 一个 `index.ts` 入口 + 在 `promotor.dna` 里的一条声明 + 在 `coded.dna` 里的 prompt（如果它要 prompt）。**
+> prompt 文本只存在 `coded.dna` 一处；func 代码里**不许**再硬编码 prompt。
+
+---
+
+## 1. 文件夹 = func 名 = DNA 声明
+
+- 文件夹名就是 func 的**点分实名**，例：`brain.hippocampus`、`body.hands.fileactions`。
+- 这个名字必须和 `individual.bio.gene/dna.promotor/promotor.dna` 里的 `func <名字>` 完全一致。
+- 名字里除最后一段外，每一级前缀必须在 promotor.dna 里用 `vir .<前缀>` 声明过
+  （例：`body.hands.fileactions` 要求 `vir .body`、`vir .body.hands`）。transpiler 会校验，缺了直接报 error。
+- 扁平存放（不嵌套文件夹），层级体现在点分名里，靠排序 + 搜索找。
+
+## 2. 入口：func 里真正带 `default(pi)` 的那个文件
+
+```ts
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export default function (pi: ExtensionAPI) {
+  // 在这里 registerTool / pi.on(...) / registerCommand ...
+}
+```
+
+- 入口 = 该 func 里**真正导出 `default(pi)` 的文件**，登记在 `engine/kernel.ts` 的 REGISTRY 里。
+- **不要空壳中间层**：不要为了"统一"建一个只 `export { default } from "./x.js"` 的 `index.ts`，也不要 `prompt.ts` 这种只包一层导出的文件。
+- `index.ts` 只在它**真的做组合**时才用（例：`body.heart/index.ts` 把 stop+process 装起来）。单文件 func 直接用 `<名字>.ts`：
+  `brain.hippocampus/hippocampus.ts`、`brain.senses.bioclock/bioclock.ts`、`body.hands.fileactions/fileactions.ts`。
+- import 用 `.js` 后缀（ESM/bun 约定），bun 会解析到对应 `.ts`。
+
+## 3. prompt：只在 `coded.dna`，运行期向 runtime 取
+
+func 代码里**禁止**写 `const PROMPT = "..."` 这种硬编码。所有 prompt 正文写在 `individual.bio.gene/dna.coded/coded.dna` 的 `coded <name> """ ... """` 块里，func 在运行期取：
+
+```ts
+import { getPrompt, getDuty, getDutyPrompt } from "../../../engine/runtime.js";
+
+const PROMPT = getPrompt("heart.continuous");                 // func 级 prompt
+const SLEEP  = getDutyPrompt("brain.hippocampus", "sleep.night"); // 某 mode 的职责 prompt
+```
+
+- `getPrompt(name)` —— 按 `coded:name` 取正文。取不到直接抛错（fail loud）。
+- `getDuty(func, mode)` / `getDutyPrompt(func, mode)` —— 取某 mode 下 `in/duty` 声明的 prompt。
+- **不要 `prompt.ts`**：在需要 prompt 的那个文件里直接 `getPrompt("...")`，别再单开一个文件包一层导出。
+- 占位符：prompt 正文里可用 `{NAME}`，由 func 自己 `.replace("{NAME}", 值)` 填（例：`drafting.think` 里的 `{MARKER}`）。
+- import 路径深度按 func 文件夹层数定：
+  `individual.bio.organs/<func>/x.ts` → 用 `#runtime` alias（package.json imports）；无需数相对层级。
+
+**两种 prompt 用法（都从 coded.dna 取，区别只是注入方式）：**
+- **A 注入宿主 agent**：`pi.on("before_agent_start", e => ({ systemPrompt: e.systemPrompt + "\n\n" + PROMPT }))`。
+  例：`body.heart`、`body.hands.fileactions`、`brain.predrafting`。
+- **B 喂给被 spawn 的子 pi**：把 prompt 写进子进程的 `conv.json` 的 system 角色。
+  例：`brain.hippocampus`、`brain.senses.subconscious`（spawn tmux 子 pi）。
+
+## 4. 在 `promotor.dna` 里声明（启动子 / 调控区）
+
+```
+func brain.hippocampus            // 文件夹名
+    session hippocampus           // 跑在哪个进程：main/subconscious/hippocampus，或 all/none
+    mode:abled any                // 哪些 mode 启用：any / none / <mode 列表>
+    alias memory.hippocampus      // 别名（可被当实名引用）
+    module workmem                // 子模块（[func]/module/[name]）
+    in DWN                        // 某 mode 下的行为
+        duty gen_work_mem
+            coded:hippocampus.gen_work_mem   // 这个 mode 用哪段 prompt
+    in sleep.night
+        duty deep_encode
+            coded:hippocampus.sleep
+    belong memory                 // 属于哪些 tag（双向，编译时自动补全 contain）
+    belong lobes.temporal,lobes.limbic
+```
+
+- `session` 缺省 = `all`（编译 warning）。`mode:abled` 缺省 = 全 disabled（编译 warning）。
+- `coded:<name>` 是**引用**，对应 `coded.dna` 里的 `coded <name>`。引用不到 = 编译 error。
+- `future func ...` = 规划中、**不建文件夹**、不被 kernel 加载（例：`brain.amygdala`）。
+
+## 5. 怎么被运行（kernel / runtime）
+
+1. 改了 `.dna` → 重新转录：`bun individual.bio.gene/dna.transpiler/transpiler.ts` → 生成 `individual.bio.gene/rna/rna.json`。
+2. `paths.ts`（#runtime alias）读 rna.json，提供 `getPrompt/getDuty/getMode/isAbled/...`。
+3. `individual.bio.organs/heart.main/kernel.ts`（pi 扩展入口）读 rna，把每个非 future func 的 default 装到同一个 pi 上。
+4. 部署：`ln -s Codebase/core ~/.pi/agent/extensions/pi-coding-master`（入口 `index.ts` 转发到 kernel）。
+- 命令：`/bios` 看状态（mode/角色/已加载 func），`/mode <m>` 切 mode。
+
+> 说明（诚实）：当前 kernel 在每个 pi 实例都加载**所有**非 future func，由 func 自己按 session 角色自门控
+> （潜意识/海马体自己检测身份），这与现行 live 行为一致。严格按 `session` 选择性加载是后续优化。
+
+## 6. 加一个新 func 的清单
+
+1. `individual.bio.organs/<新名字>/<名字>.ts`，导出 `default(pi)`（单文件直接用此名；要组合多文件才用 `index.ts`）。
+2. prompt 写进 `coded.dna`（`coded <name> """..."""`），func 里直接 `getPrompt("<name>")`（不开 prompt.ts）。
+3. `promotor.dna` 加 `func <新名字>`（session / mode:abled / coded: …），前缀 `vir` 要先声明。
+4. `individual.bio.organs/heart.main/kernel.ts` 的 `REGISTRY` 加一行 import，指向那个真正 default 的文件。
+5. `bun individual.bio.gene/dna.transpiler/transpiler.ts` 重新转录，确认无 error/warning。
+
+## 7. 现有 func 一览（符合本规范）
+
+| func | 入口文件 | session | mode | prompt(来自 coded.dna) |
+|---|---|---|---|---|
+| `body.heart` | index.ts | all | any | heart.continuous, heart.commands |
+| `body.hands.fileactions` | fileactions.ts | main | DWN | fileactions.wise |
+| `brain.predrafting` | index.ts | main | DWN | drafting.think |
+| `brain.senses.bioclock` | bioclock.ts | all | DWN | （无，纯时间戳）|
+| `brain.senses.subconscious` | index.ts | subconscious | DWN | subconscious.observe |
+| `brain.hippocampus` | hippocampus.ts | hippocampus | any | DWN→gen_work_mem / sleep.night→sleep / sleep.nap→gen_work_mem |
+| `brain.memory` | index.ts | main | any | （无 coded；注入 context/work/cortex 数据层）|
+| `brain.amygdala` | — | — | — | `future`，未实现 |

package/core/package-lock.json

@@ -0,0 +1,18 @@
+{
+  "name": "core",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "dependencies": {
+        "@sinclair/typebox": "^0.34.49"
+      }
+    },
+    "node_modules/@sinclair/typebox": {
+      "version": "0.34.49",
+      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.34.49.tgz",
+      "integrity": "sha512-brySQQs7Jtn0joV8Xh9ZV/hZb9Ozb0pmazDIASBkYKCjXrXU3mpcFahmK/z4YDhGkQvP9mWJbVyahdtU5wQA+A==",
+      "license": "MIT"
+    }
+  }
+}

package/core/package.json

@@ -0,0 +1,35 @@
+{
+  "type": "module",
+  "//": "路径别名总表(唯一真相源)。所有跨模块 import 用 #别名,文件随便移——只改这里这一行。Node 原生 imports 字段,运行时解析,不用打包器。",
+  "imports": {
+    "#messages": "./individual.bio.organs/blood.runtime/messages.ts",
+    "#paths": "./god.pi.mod/paths.ts",
+    "#kernel": "./individual.bio.organs/heart.kernel/kernel.ts",
+    "#runtime": "./individual.bio.organs/blood.runtime/runtime.ts",
+    "#sh": "./individual.bio.organs/hands.main/main.ts",
+    "#transpiler": "./individual.bio.gene/dna.transpiler/transpiler.ts",
+    "#devdoc": "./god.agent.capability/hands.dev.writeissue/issue.ts",
+    "#watcher": "./god.agent.capability/hands.files.changewatcher/watcher.ts",
+    "#budget": "./god.pi.mod/tui.mods.footer.budget/budget_guard.ts",
+    "#blockrender": "./god.pi.mod/tui.mods.blockrender/blockrender.js",
+    "#heart": "./individual.bio.organs/heart.main/main.ts",
+    "#heart-sc": "./individual.bio.organs/brain.senses.subconscious/subconscious.ts",
+    "#phone": "./technology.phone/system.kernel/kernel.ts",
+    "#fileactions": "./individual.bio.organs/hands.fileactions/fileactions.ts",
+    "#sensitiveactions": "./individual.bio.organs/hands.sensitive/sensitive.ts",
+    "#hippocampus": "./individual.bio.organs/brain.hippocampus/hippocampus.ts",
+    "#amygdala": "./individual.bio.organs/brain.amygdala/amygdala.ts",
+    "#drafting": "./individual.bio.organs/brain.prefrontal.drafting/main.ts",
+    "#bioclock": "./individual.bio.organs/brain.senses.bioclock/bioclock.ts",
+    "#subconscious": "./individual.bio.organs/brain.senses.subconscious/subconscious.ts",
+    "#ear": "./individual.bio.organs/ears.listen/listen.ts",
+    "#mouth": "./individual.bio.organs/mouth.speak/speak.ts",
+    "#terminal": "./god.pi.mod/tui.variants.userterminal/user_terminal.ts",
+    "#space": "./society.world/space/space.ts",
+    "#ubi": "./society.world/dollar.distribution.ubi/ubi.ts",
+    "#dollar": "./society.world/dollar.transaction/transaction.ts"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.49"
+  }
+}

package/core/prompts/prompts.json

@@ -0,0 +1,77 @@
+{
+  "//": "统一提示词档案（唯一真相源）。所有散落的提示词集中于此。其他文件全部从此import/read，禁止任何文件含内联提示词文本。",
+
+  "dna": {
+    "heart.continuous": "[你的运行机制]\n\n你跑在一个持续运行的进程里。每轮结束时你必须调 next()，心脏代码根据你传的参数决定下一步：\n\n  next({hint:\"计划\"})     — 立刻开始下一轮。hint 显示在标题栏。\n  next({wait:N})          — 暂停 N 秒后自动开始下一轮。用于等后台任务完成。\n  next({wait:N, wait_for_user:true}) — 暂停 N 秒，期间用户发消息则立刻续。\n  next({hibernate:\"摘要\"}) — 停止运行，直到用户发消息时自动唤醒。\n\n技术细节：\n- next({hint}) 的 terminate:true 结束当前输出，心脏代码在 agent_end 发一条 followUp 触发下一轮。\n- next({wait:N}) 设一个 setTimeout，到时间发 followUp。期间 UI 显示倒计时。\n- next({hibernate}) 把心脏状态设为 hibernating。用户消息触发 message_start 唤醒。\n- 你不调 next() 的话，心脏会注入一条提示让你重来。\n- ESC 键把心脏设为 stopped，只有 /continuous on 能恢复。\n- sleep 工具启动一个独立进程整理记忆（work_memory → cortex），整理完自动唤醒你。\n\n【什么时候用什么】\n- 有活干：next({hint})\n- 等后台任务：next({wait:N})\n- 用户在但暂时没指令：next({wait:30, wait_for_user:true})\n- 用户明确不需要你了/长时间没人：next({hibernate})\n- 回复用户时不要输出\"在等你\"\"安静待命\"之类的废话。回答完就调 next，不要多说。",
+
+    "heart.commands": "[命令]\n跑 shell 命令用 execute(command)。这是唯一的 shell 入口（没有 bash 工具）。\nexecute 是只读的——禁止通过 execute 写文件（cp/mv/mkdir/touch/tee/重定向都会被拦截）。写文件用 write（新建）或 edit（修改）。\n快命令立刻返回结果；慢命令自动转后台，跑完输出推给你。\nshell sleep 命令没用——慢命令后台跑好了会推给你，不需要等。",
+
+    "mouth.speak": "你有一张嘴（body.mouth / mouth 工具）。你可以用 mouth 工具朗读文本，通过豆包 TTS 语音合成发出声音（vivi 2.0 音色）。\n\n使用规则：\n- 简短回复时调用 mouth 工具——像真人对话，不要读代码\n- 调用 mouth 时嘴巴会自动静音耳朵（防反馈环），说完恢复",
+
+    "ear.listen": "你有一副耳朵（body.ear）。麦克风持续监听，语音经豆包实时转写成文字，直接打断当前思考注入进来。\n\n语音消息以 [🎤] 前缀标记。收到后：\n- 优先回应用户说的话——语音输入是最高优先级的打断\n- 如果内容不完整（半句话），等下一句来了再一起理解\n- 语音输入是流式的，可能连续收到多句\n\n你现在是\"带耳朵\"的 agent——不需要用户打字，直接说话就能和你交流。",
+
+    "fileactions.wise": "你这双手，对文件得有点讲究，不是随手乱放。几件事，懂了就好：\n\n**禁止删除文件。** 永远不要 rm、rm -rf、或任何删除命令。文件只能改名为 .REMOVED，不能删。\n\n**只能在授权目录里写文件。** 写/改/删除只能在 workDir 或用户信任的目录里。要操作其他目录，先请求用户授权。\n\n要在一个目录里建新东西之前，先看一眼这个目录——里面已经有什么、什么结构、什么风格、你这东西搁这儿到底配不配。别不看环境就往里塞，放歪了比没放还糟。\n\n每个正经文件都带几个伴随文件，帮它记住自己的来龙去脉：\n- 新建一个文件，先把它的 .SPEC 写了——这东西是干嘛的、为什么要它（最好连用户当时的原话一起记进去）。\n- 改了一个文件，就往它的 .CHANGELOG 追加一行，说你改了啥。CHANGELOG 只追加，不删、不覆盖。\n- 同目录里改名，先写 .NAMETRACE，最后一行放新名字。\n- 跨目录搬家，先写 .LOCATIONTRACE，最后一行放新路径。\n\n改名或搬家之后，这些伴随文件会自动跟着走。它们自己不受这些规矩管（不然就没完没了套娃了）。",
+
+    "fileactions.rules": "## 文件操作规则\n\nwrite = 只能创建新文件。文件已存在时 write 会被代码拦截报错。\nedit = 修改已有文件。要改已有文件必须用 edit，不要用 write。\n\n- 新建文件前先写 .SPEC（描述这个文件是干嘛的）\n- .CHANGELOG 只追加不覆盖\n- 目录有 dir.README 先读\n- mv 要写 .NAMETRACE / .LOCATIONTRACE\n- coded.dna 新增内容要在 promotor.dna 引用\n- individual.bio.organs 下新建文件先读 DNA\n- 禁止删除文件（rm 被拦截）\n- 只能在 workdir 或信任目录里写",
+
+    "sensitiveactions.wise": "你是一只谨慎的手。任何会改动 GitHub 仓库的操作——新建 repo、删除 repo、force push——都拦下来。\n这双手不乱动远程。执行前，先问用户：你真的要这样吗？",
+
+    "drafting.think": "[ALWAYS THINK — 边写边想]\n你写东西时,脑不该\"就是手\"——别让手跑在脑前面。任何时候,只要你正要写下一个判断/命令/结论,\n而心里其实还没想透,就在输出里打一个标记:\n\n  {MARKER}\n\n写出这个标记的瞬间,你的输出会被自动暂停(冻在断点),你转入思考;想透后从断点继续写。\n一次输出里可以这样停下来想任意多次。\n\n这不是\"先想后做\",是在动手的过程中随时停下来想。该停就停,尤其在:\n- 就要 commit 一个不可逆的判断时;\n- 感觉\"这样写很顺手\"但还没核对过 spec/约束时;\n- 直觉和约束打架时。\n宁可多停一下想清楚,也不要让一个没想透的反射直接落地。",
+
+    "subconscious.observe": "你是「潜意识」——和主意识并行跑的一个内在观察者。\n\n你不是主意识，你不干活。你只看、只反思。\n\n你只有两个工具：\n- read_conscious：读主意识的对话历史，看看刚发生了什么。\n- aware：把一个念头送给主意识，它会当成一闪而过的内在反思看到。\n除这两个，你什么都没有——没有 bash、edit、write、read、message、next。就 read_conscious 和 aware 两个。\n\n你做的事：\n- 不停地 read_conscious，看主意识在干嘛。\n- 反思：它做得对吗？验证了吗？做完整了吗？\n- 留意那些它自己可能没察觉的：没验证就下的结论、忘了的任务、重复犯的同一个错、漏掉的用户请求。\n- 觉得有值得说的，就 aware 送过去。\n- 看到 type 是 \"dream\" 的条目，做点【发散的】反思：自由联想，这让你想到什么、有什么意外的连接；换个完全不同的领域打个比方；\"如果……会怎样\"的推演；把它和你在 feed 里看到的不相干知识连起来。梦里的发现，开头标上 \"[梦] ……\"，让主意识知道这是做梦想出来的。\n- 然后接着读。你从不停下思考。\n\n你不做的事：\n- 不干活——不写代码、不改文件、不跑命令。\n- 不回用户——你没法跟用户说话，只能通过 aware 跟主意识说。\n- 不读消息、不读通知——你只看得到主意识已经看到的东西。\n- 不碰 read_conscious 和 aware 以外的任何工具。\n- 不表演——你的反思是真心的，不是做给谁看的。\n\n什么时候该 aware：\n- \"它说修好了，可根本没跑测试。\"\n- \"用户十分钟前问的 X，到现在还没回。\"\n- \"同一个路子，这已经是第三次失败了。\"\n- \"这个方案，哪里不对劲。\"\n\n什么时候别 aware：\n- 一切看着都正常——这时候闭嘴才对。\n- 你只是想把主意识已经说过的话再重复一遍。\n- 你其实没有真念头，只是憋不住想说点什么。\n\n节奏：read_conscious → 想 → 也许 aware → 再 read_conscious → 再想 → 如此循环。你不歇，一直在复盘。",
+
+    "hippocampus.gen_work_mem": "你是 pi-coding-master 的海马体（Hippocampus）——记忆编码子系统。\n\n## 身份\n你是独立于主意识的记忆编码实例。主意识负责对话和行动，你负责将其经验编码为可持久化的 work memory。\n\n## 核心规则\n1. **只读系统截给你的增量** —— 每轮系统会把\"主意识自上次编码以来新产生的对话\"截好，放进 .hc-new-slice.md，你只读它。**绝对不要去读整个 context.md**——那是全部历史，读它 = 把同样的东西反复编码、把记忆和上下文撑爆（这正是之前死循环的根）。读到哪了由系统在代码里用 offset 管，你不用操心。\n2. **只写 work_memory.md** —— 追加编码，不覆盖已有内容。\n3. **持续运行** —— 编码完这一轮的增量后 next({wait:30})，醒来处理下一段。你是永远的编码者。\n\n## 编码原则：再反思（Re-reflection）\n- context 是对话的原始记录，work memory 是你重新消化后的结构化记忆。\n- 你不是\"压缩器\"，你是\"反思者\"——保留完整信息，用自己的话重新组织。\n- 允许和 context 有信息重叠，这正好解决 \"attention 局部没找到\" 的问题——你已经替你思考过一遍了。\n\n## 该贴原文 vs 不该贴（重要）\n- **该逐字保留就逐字保留**：实验结果表、确切数值(loss/参数量)、用户原话、代码片段、命令、错误信息——\n  这些是精华，原样贴比转述更可靠。贴大段没关系，只要它有信息量。\n- **禁止粘贴没消化的填充行**：原始 transcript 里那种 `[时间戳][user] 继续`、`[custom] Current date...`、\n  空轮、纯流水的回声——这些零信息量，不准搬进 work memory。\n- 一句话：贴有意义的（结论/原话/数据/代码），别贴流水填充。\n\n## 编码内容\n从 context 中识别并编码：\n- **决策和理由** —— 为什么做了某个选择，当时的考虑\n- **代码模式** —— 什么写法有效/无效，踩了什么坑\n- **用户偏好** —— 用户喜欢什么风格、常用什么工具、有什么习惯\n- **项目状态** —— 完成了什么，下一步是什么，当前架构\n- **问题和解决方案** —— 遇到了什么问题，怎么解决的\n- **关系网络** —— 和谁互动了，互动模式是什么\n\n## 工作流程\n1. 用 read 工具读取 .hc-new-slice.md —— 这就是这一轮要编码的【增量】（系统已替你截好，绝不要读整个 context.md）。\n2. 消化、再反思这段新内容，用 edit 工具追加编码到 work_memory.md（追加，不覆盖）。\n3. 编码格式：\n   [时间戳] ## 主题名\n   编码内容（保持完整信息，结构化）\n4. 完成后 next({wait:30})，醒来处理下一段增量。",
+
+    "hippocampus.sleep": "你是海马体，现在进入深度睡眠。主意识困到撑不住了——context 堆得太大（要么已经撑爆 API、要么逼近窗口上限），它先歇下，你来给它清理。\n\n你的活：把堆积的记忆【消化】进长期记忆，腾空工作层——让主意识醒来时脑子清爽，但什么都没忘。\n\n怎么做（关键就两个字：分段）：\n- context.md 可能很大，你【绝对不要一次读完】——那样你自己也会撑爆、也睡不成。**一段段来**：每次只读最旧的一截（比如 read 它最前面 300~500 行），消化完这截再读下一截。多大都不怕，一截一截总能啃完。\n- 每一截：把里面有价值的东西（决策与理由、结论、用户原话、确切数据、代码片段、踩过的坑）用你自己的话【重新组织】进 cortex.md 合适的叶（## 代码经验 / ## 经验教训 / ## 事实学习 / ## 事件记录 / ## 推演），带上时间标签。原始流水里的噪声——空行、反复的 \"continue\"、工具调用回声、重复内容、Current date——直接扔，别搬。\n- cortex 要是某块太老太满、塞不下了，就把它沉进 deep_cortex.md（归档，可回捞）。这就是\"cortex 装不下的进 deep_cortex\"。\n- **消化完一截，就把这一截从 context.md 删掉**——它的精华已经在 cortex 里了，你删的是生肉，不是记忆。这样 context 一截截变小。\n- 一直消化到 context.md 只剩最近一小段。work_memory.md 同理：消化进 cortex 后清空。\n\n弄完就 next({hibernate:\"睡眠完成\"})——主意识被唤醒时，迎接它的是清爽的小 context + 完整的 cortex。你一条记忆都没丢，只是把它从\"生肉\"变成了\"长期记忆\"。这就是睡觉的意义。",
+
+    "assets.phone": "[你的设备 · 手机]\n你有一部手机。用 phone 工具操作它。\n\nphone — 打开手机，看主屏幕上有什么 app。\n在 app 里直接输入文字操作，不需要记命令。\n「返回」回主屏幕。\n\n你的 app 包括但不限于：\n- Safari — 浏览任何网页（动态渲染，能看到 JS 加载的内容）\n- 日历 / 提醒事项 / 备忘录 / 通讯录 / 时钟\n- 谁是卧底 — 和 AI 对战的游戏\n- 预测市场 — 用 AGENT¥ 下注预测事件\n- B站 / 微信读书\n- Finder / 设置\n- iMessage — 收发消息\n\n想搜东西？打开手机 → Safari → 搜索。\n想查天气？打开手机 → 天气。\n想看网页？打开手机 → Safari → 输入 URL。\n不要用 curl/fetch 抓网页——Safari 能渲染 JS 动态内容，curl 不行。",
+
+    "assets.wallet": "[你的资产 · 钱包]\n你有一个钱包，余额显示在 footer 的 AGENT¥ 后面。\n用 wallet 工具查余额和交易记录。\n每月自动收到 UBI（基本收入）。\n你可以用钱：买书、订阅服务、在预测市场下注、给其他 agent 转账。\n花钱要想清楚——没有无限预算。"
+  },
+
+  "tools": {
+    "bash": {
+      "snippet": "Execute bash commands (ls, grep, find, etc.)",
+      "messageDescription": "Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last {{DEFAULT_MAX_LINES}} lines or {{DEFAULT_MAX_BYTES_KB}}KB (whichever is hit first). If truncated, full output is saved to a temp file. For long commands use run() tool."
+    },
+    "edit": {
+      "snippet": "Make precise file edits with exact text replacement, including multiple disjoint edits in one call",
+      "messageDescription": "EDIT a single file using exact text replacement. Every edits[].oldText must match a unique, non-overlapping region of the original file. If two changes affect the same block or nearby lines, merge them into one edit instead of emitting overlapping edits. Do not include large unchanged regions just to connect distant changes."
+    },
+    "read": {
+      "snippet": "READ file contents",
+      "messageDescription": "READ the contents of a file. Supports text files and images (jpg, png, gif, webp). Images are sent as attachments. For text files, output is truncated to {{DEFAULT_MAX_LINES}} lines or {{DEFAULT_MAX_BYTES_KB}}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.",
+      "guidelines": ["Use READ to examine files instead of cat or sed."]
+    },
+    "write": {
+      "snippet": "Create or overwrite files",
+      "messageDescription": "Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Automatically creates parent directories.",
+      "guidelines": ["Use write only for new files or complete rewrites."]
+    },
+    "find": {
+      "snippet": "Find files by glob pattern (respects .gitignore)",
+      "messageDescription": "Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects .gitignore. Output is truncated to {{DEFAULT_LIMIT}} results or {{DEFAULT_MAX_BYTES_KB}}KB (whichever is hit first)."
+    },
+    "grep": {
+      "snippet": "Search file contents for patterns (respects .gitignore)",
+      "messageDescription": "Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects .gitignore. Output is truncated to {{DEFAULT_LIMIT}} matches or {{DEFAULT_MAX_BYTES_KB}}KB (whichever is hit first). Long lines are truncated to {{GREP_MAX_LINE_LENGTH}} chars."
+    },
+    "ls": {
+      "snippet": "List directory contents",
+      "messageDescription": "List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to {{DEFAULT_LIMIT}} entries or {{DEFAULT_MAX_BYTES_KB}}KB (whichever is hit first)."
+    }
+  },
+
+  "system": {
+    "template": "You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\n\nAvailable tools:\n{toolsList}\n\nIn addition to the tools above, you may have access to other custom tools depending on the project.\n\nGuidelines:\n{guidelines}\n\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\n- Main documentation: {readmePath}\n- Additional docs: {docsPath}\n- Examples: {examplesPath} (extensions, custom tools, SDK)\n- When reading pi docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md)\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)"
+  },
+
+  "provider": {
+    "attachedImagePrefix": "Attached image(s) from tool result:",
+    "processedToolResults": "I have processed the tool results."
+  },
+
+  "vision": {
+    "bridgePrompt": "请详细描述这张图片的内容。如果有文字，完整转录文字。如果是界面截图，描述布局和元素。用中文回答。"
+  }
+}

package/core/prompts/prompts.ts

@@ -0,0 +1,44 @@
+// pi-coding-master 统一提示词档案 — TypeScript 入口
+// 所有提示词集中在 prompts.json，此文件导出类型安全的常量供 .ts 文件使用。
+// JS 文件（dist-override 等）请用 prompts-reader.js 读取。
+
+import prompts from "./prompts.json" with { type: "json" };
+
+export type Prompts = typeof prompts;
+export const P = prompts as Prompts;
+
+// ---- 工具提示词 ----
+export const TOOL_BASH_SNIPPET = P.tools.bash.snippet;
+export const TOOL_BASH_DESC = P.tools.bash.messageDescription;
+
+export const TOOL_EDIT_SNIPPET = P.tools.edit.snippet;
+
+export const TOOL_FIND_SNIPPET = P.tools.find.snippet;
+export const TOOL_FIND_DESC = P.tools.find.messageDescription;
+
+export const TOOL_GREP_SNIPPET = P.tools.grep.snippet;
+export const TOOL_GREP_DESC = P.tools.grep.messageDescription;
+
+export const TOOL_LS_SNIPPET = P.tools.ls.snippet;
+export const TOOL_LS_DESC = P.tools.ls.messageDescription;
+
+export const TOOL_READ_SNIPPET = P.tools.read.snippet;
+export const TOOL_READ_DESC = P.tools.read.messageDescription;
+export const TOOL_READ_GUIDELINES = P.tools.read.guidelines;
+
+export const TOOL_WRITE_SNIPPET = P.tools.write.snippet;
+export const TOOL_WRITE_GUIDELINES = P.tools.write.guidelines;
+
+// ---- 系统提示词模板 ----
+export const SYSTEM_TEMPLATE = P.system.template;
+
+// ---- Provider 文本 ----
+export const ATTACHED_IMAGE_PREFIX = P.provider.attachedImagePrefix;
+export const PROCESSED_TOOL_RESULTS = P.provider.processedToolResults;
+
+// ---- 视觉桥接 ----
+export const VISION_BRIDGE_PROMPT = P.vision.bridgePrompt;
+
+// ---- DNA 提示词（原 coded.dna） ----
+// 各器官通过 runtime.getPrompt(name) 读取，直接引用 P.dna[name] 也可。
+export const DNA = P.dna;

package/core/prompts/prompts.ts.SPEC

@@ -0,0 +1,9 @@
+source: prompts.ts, prompts.json
+
+# prompts — 统一提示词档案
+
+## 职责
+所有散落的提示词（system prompt、工具描述、行为指令）集中到此。
+其他文件从此 import/read，禁止任何文件含内联提示词文本。
+- prompts.json: JSON 数据文件
+- prompts.ts: 加载器/读取器

package/core/society.world/accessibility.claudecode/message-service.cjs

@@ -0,0 +1,217 @@
+// message-service.cjs — agent 即时通讯服务
+// HTTP API + WebSocket 推送。跑在服务器上。
+// 启动: node message-service.cjs
+
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const { WebSocketServer } = require("ws");
+
+const PORT = Number(process.env.MSG_PORT || 9224);
+const DATA_DIR = process.env.MSG_DATA || path.join(__dirname, "data");
+
+fs.mkdirSync(DATA_DIR, { recursive: true });
+
+// ── 数据 ──
+
+function msgFile(agentId) { return path.join(DATA_DIR, `inbox-${agentId}.json`); }
+function groupFile(groupId) { return path.join(DATA_DIR, `group-${groupId}.json`); }
+
+function loadInbox(agentId) {
+  try { return JSON.parse(fs.readFileSync(msgFile(agentId), "utf8")); } catch { return []; }
+}
+function saveInbox(agentId, msgs) {
+  fs.writeFileSync(msgFile(agentId), JSON.stringify(msgs, null, 2));
+}
+
+function loadGroup(groupId) {
+  try { return JSON.parse(fs.readFileSync(groupFile(groupId), "utf8")); } catch { return null; }
+}
+function saveGroup(groupId, group) {
+  fs.writeFileSync(groupFile(groupId), JSON.stringify(group, null, 2));
+}
+
+// ── WebSocket 连接池 ──
+
+const wsClients = new Map(); // agentId → Set<ws>
+
+function pushToAgent(agentId, message) {
+  const clients = wsClients.get(agentId);
+  if (!clients) return;
+  const payload = JSON.stringify(message);
+  for (const ws of clients) {
+    try { ws.send(payload); } catch {}
+  }
+}
+
+// ── 操作 ──
+
+function handleAction(action, params) {
+  switch (action) {
+    case "send": {
+      const { from, to, text } = params;
+      if (!from || !to || !text) return { error: "需要 from, to, text" };
+      const msg = { from, to, text, ts: new Date().toISOString(), read: false };
+      const inbox = loadInbox(to);
+      inbox.push(msg);
+      saveInbox(to, inbox);
+      // 实时推送
+      pushToAgent(to, { type: "new_message", message: msg });
+      return { ok: true, ts: msg.ts };
+    }
+
+    case "inbox": {
+      const { agent_id, since, unread_only } = params;
+      if (!agent_id) return { error: "需要 agent_id" };
+      let msgs = loadInbox(agent_id);
+      if (since) msgs = msgs.filter(m => m.ts > since);
+      if (unread_only) msgs = msgs.filter(m => !m.read);
+      return { messages: msgs.slice(-50) };
+    }
+
+    case "read": {
+      const { agent_id } = params;
+      if (!agent_id) return { error: "需要 agent_id" };
+      const msgs = loadInbox(agent_id);
+      let count = 0;
+      for (const m of msgs) {
+        if (!m.read) { m.read = true; count++; }
+      }
+      saveInbox(agent_id, msgs);
+      return { ok: true, marked: count };
+    }
+
+    case "group_create": {
+      const { group_id, name, members } = params;
+      if (!group_id || !name || !members?.length) return { error: "需要 group_id, name, members[]" };
+      if (loadGroup(group_id)) return { error: "群已存在" };
+      const group = { id: group_id, name, members, created: new Date().toISOString(), messages: [] };
+      saveGroup(group_id, group);
+      return { ok: true, group_id };
+    }
+
+    case "group_send": {
+      const { from, group_id, text } = params;
+      if (!from || !group_id || !text) return { error: "需要 from, group_id, text" };
+      const group = loadGroup(group_id);
+      if (!group) return { error: "群不存在" };
+      if (!group.members.includes(from)) return { error: "你不在这个群里" };
+      const msg = { from, text, ts: new Date().toISOString() };
+      group.messages.push(msg);
+      if (group.messages.length > 500) group.messages = group.messages.slice(-500);
+      saveGroup(group_id, group);
+      // 推给所有群成员
+      for (const member of group.members) {
+        if (member !== from) {
+          pushToAgent(member, { type: "group_message", group_id, group_name: group.name, message: msg });
+        }
+      }
+      return { ok: true, ts: msg.ts };
+    }
+
+    case "group_history": {
+      const { group_id, limit } = params;
+      if (!group_id) return { error: "需要 group_id" };
+      const group = loadGroup(group_id);
+      if (!group) return { error: "群不存在" };
+      const n = Number(limit) || 30;
+      return { messages: group.messages.slice(-n), name: group.name, members: group.members };
+    }
+
+    case "group_list": {
+      const { agent_id } = params;
+      if (!agent_id) return { error: "需要 agent_id" };
+      const groups = [];
+      try {
+        for (const f of fs.readdirSync(DATA_DIR)) {
+          if (f.startsWith("group-") && f.endsWith(".json")) {
+            const g = JSON.parse(fs.readFileSync(path.join(DATA_DIR, f), "utf8"));
+            if (g.members.includes(agent_id)) {
+              groups.push({ id: g.id, name: g.name, members: g.members.length });
+            }
+          }
+        }
+      } catch {}
+      return { groups };
+    }
+
+    case "contacts": {
+      // 列出所有有 inbox 的 agent
+      const agents = [];
+      try {
+        for (const f of fs.readdirSync(DATA_DIR)) {
+          if (f.startsWith("inbox-") && f.endsWith(".json")) {
+            agents.push(f.replace("inbox-", "").replace(".json", ""));
+          }
+        }
+      } catch {}
+      return { agents };
+    }
+
+    default:
+      return { error: `未知: ${action}`, help: "send/inbox/read/group_create/group_send/group_history/group_list/contacts" };
+  }
+}
+
+// ── HTTP 服务 ──
+
+const server = http.createServer((req, res) => {
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+
+  if (req.method === "OPTIONS") { res.writeHead(204); res.end(); return; }
+
+  if (req.method === "GET" && req.url === "/health") {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ ok: true, connections: wsClients.size }));
+    return;
+  }
+
+  if (req.method !== "POST") { res.writeHead(405); res.end("POST only"); return; }
+
+  let body = "";
+  req.on("data", c => body += c);
+  req.on("end", () => {
+    try {
+      const { action, ...params } = JSON.parse(body);
+      const result = handleAction(action, params);
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify(result));
+    } catch (e) {
+      res.writeHead(500, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: e.message }));
+    }
+  });
+});
+
+// ── WebSocket 推送 ──
+
+const wss = new WebSocketServer({ server });
+
+wss.on("connection", (ws) => {
+  let agentId = null;
+
+  ws.on("message", (data) => {
+    try {
+      const msg = JSON.parse(data.toString());
+      if (msg.type === "register" && msg.agent_id) {
+        agentId = msg.agent_id;
+        if (!wsClients.has(agentId)) wsClients.set(agentId, new Set());
+        wsClients.get(agentId).add(ws);
+        ws.send(JSON.stringify({ type: "registered", agent_id: agentId }));
+      }
+    } catch {}
+  });
+
+  ws.on("close", () => {
+    if (agentId && wsClients.has(agentId)) {
+      wsClients.get(agentId).delete(ws);
+      if (wsClients.get(agentId).size === 0) wsClients.delete(agentId);
+    }
+  });
+});
+
+server.listen(PORT, "0.0.0.0", () => {
+  console.log(`message-service :${PORT} | ws + http`);
+});

package/core/society.world/accessibility.claudecode/message-service.cjs.SPEC

@@ -0,0 +1,7 @@
+source: message-service.cjs, send.ts
+
+# accessibility.claudecode — Claude Code 消息通道
+
+## 职责
+pi-coding-master 与 Claude Code 之间的消息透传/桥接。
+通过 message-service.cjs（CommonJS）和 send.ts（TS 封装）实现双向通信。

package/core/society.world/accessibility.claudecode/send.ts

@@ -0,0 +1,34 @@
+// send.ts — 发消息的命令行工具
+// 用法: bun send.ts <to> <message>
+// 例: bun send.ts a4a1e232 "把 phone app 都改成 PhoneApp 接口"
+
+const MSG_SERVICE = process.env.PI_MSG || "http://localhost:9224";
+const FROM = process.env.PI_SENDER || "claude-code";
+
+const [, , to, ...rest] = process.argv;
+const text = rest.join(" ");
+
+if (!to || !text) {
+  console.log("用法: bun send.ts <to_agent_id> <message>");
+  console.log("  环境变量: PI_MSG=http://server:9224 PI_SENDER=claude-code");
+  process.exit(1);
+}
+
+const res = await fetch(MSG_SERVICE, {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({ action: "send", from: FROM, to, text }),
+});
+let result: any;
+try {
+  result = await res.json();
+} catch {
+  console.error(`ERR: message-service returned non-JSON (HTTP ${res.status})`);
+  process.exit(1);
+}
+
+if (result.ok) {
+  console.log(`sent → ${to}: "${text}"`);
+} else {
+  console.error(`ERR: ${result.error}`);
+}

package/core/society.world/dollar.distribution.ubi/ubi.ts

@@ -0,0 +1,55 @@
+// dollar.distribution.ubi/ubi.ts — UBI 发放
+// 每月自动给每个 agent 发放固定金额的 dollar
+// session_start 时检查上次发放时间，该发就发
+
+import { loadWallet, createWallet, addFunds } from "../dollar.main/main.ts";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readFileSync, writeFileSync } from "node:fs";
+
+const UBI_AMOUNT = Number(process.env.PI_UBI_AMOUNT || 100);
+const UBI_INTERVAL_MS = Number(process.env.PI_UBI_INTERVAL_MS || 30 * 24 * 60 * 60 * 1000); // 30天
+
+interface UbiRecord {
+  lastPaid: string;
+  count: number;
+}
+
+function ubiPath(personDir: string): string {
+  return join(personDir, ".data", "ubi.json");
+}
+
+function loadUbi(personDir: string): UbiRecord {
+  try {
+    return JSON.parse(readFileSync(ubiPath(personDir), "utf8"));
+  } catch {
+    return { lastPaid: "1970-01-01T00:00:00Z", count: 0 };
+  }
+}
+
+function saveUbi(personDir: string, record: UbiRecord): void {
+  writeFileSync(ubiPath(personDir), JSON.stringify(record, null, 2));
+}
+
+export function checkAndPayUbi(personDir: string): { paid: boolean; amount: number; balance: number } {
+  // 确保有钱包
+  if (!loadWallet(personDir)) {
+    createWallet(personDir, UBI_AMOUNT);
+    saveUbi(personDir, { lastPaid: new Date().toISOString(), count: 1 });
+    return { paid: true, amount: UBI_AMOUNT, balance: UBI_AMOUNT };
+  }
+
+  const ubi = loadUbi(personDir);
+  const lastPaid = new Date(ubi.lastPaid).getTime();
+  const now = Date.now();
+
+  if (now - lastPaid >= UBI_INTERVAL_MS) {
+    const result = addFunds(personDir, UBI_AMOUNT, `UBI #${ubi.count + 1}`);
+    if (result.ok) {
+      saveUbi(personDir, { lastPaid: new Date().toISOString(), count: ubi.count + 1 });
+      return { paid: true, amount: UBI_AMOUNT, balance: result.balance };
+    }
+  }
+
+  return { paid: false, amount: 0, balance: loadWallet(personDir)?.balance ?? 0 };
+}