psyclaw 0.28.3 → 0.29.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +12 -11
  2. package/agents/recommended/catalog.json +2 -2
  3. package/dist/src/adapters/pi/extension.js +310 -256
  4. package/dist/src/adapters/pi/extension.js.map +1 -1
  5. package/dist/src/analysis/hooks.js +1 -1
  6. package/dist/src/analysis/hooks.js.map +1 -1
  7. package/dist/src/analysis/plan.d.ts +82 -0
  8. package/dist/src/analysis/plan.js +246 -0
  9. package/dist/src/analysis/plan.js.map +1 -0
  10. package/dist/src/analysis/stats-router.d.ts +13 -0
  11. package/dist/src/analysis/stats-router.js +44 -0
  12. package/dist/src/analysis/stats-router.js.map +1 -0
  13. package/dist/src/ars/academic-router.d.ts +33 -0
  14. package/dist/src/ars/academic-router.js +204 -0
  15. package/dist/src/ars/academic-router.js.map +1 -0
  16. package/dist/src/ars/doctor.d.ts +27 -0
  17. package/dist/src/ars/doctor.js +121 -0
  18. package/dist/src/ars/doctor.js.map +1 -0
  19. package/dist/src/ars/mode-editor.d.ts +14 -7
  20. package/dist/src/ars/mode-editor.js +39 -23
  21. package/dist/src/ars/mode-editor.js.map +1 -1
  22. package/dist/src/ars/profile.d.ts +10 -0
  23. package/dist/src/ars/profile.js +15 -2
  24. package/dist/src/ars/profile.js.map +1 -1
  25. package/dist/src/branding.js +15 -16
  26. package/dist/src/branding.js.map +1 -1
  27. package/dist/src/cli.js +1 -8
  28. package/dist/src/cli.js.map +1 -1
  29. package/dist/src/index.d.ts +6 -1
  30. package/dist/src/index.js +6 -1
  31. package/dist/src/index.js.map +1 -1
  32. package/dist/src/panel/server.js +1 -1
  33. package/dist/src/panel/server.js.map +1 -1
  34. package/dist/src/project/approvals.d.ts +4 -3
  35. package/dist/src/project/approvals.js +4 -3
  36. package/dist/src/project/approvals.js.map +1 -1
  37. package/dist/src/project/bootstrap.d.ts +7 -2
  38. package/dist/src/project/bootstrap.js +14 -13
  39. package/dist/src/project/bootstrap.js.map +1 -1
  40. package/dist/src/project/paths.d.ts +10 -0
  41. package/dist/src/project/paths.js +20 -3
  42. package/dist/src/project/paths.js.map +1 -1
  43. package/dist/src/project/workspace.d.ts +14 -0
  44. package/dist/src/project/workspace.js +82 -0
  45. package/dist/src/project/workspace.js.map +1 -0
  46. package/dist/src/session/modes.d.ts +10 -0
  47. package/dist/src/session/modes.js +57 -0
  48. package/dist/src/session/modes.js.map +1 -0
  49. package/dist/src/skills/recommended.js +1 -1
  50. package/dist/src/skills/recommended.js.map +1 -1
  51. package/dist/src/style/cli-ui.js +3 -3
  52. package/dist/src/style/cli-ui.js.map +1 -1
  53. package/dist/src/verify/checklist.d.ts +20 -0
  54. package/dist/src/verify/checklist.js +71 -0
  55. package/dist/src/verify/checklist.js.map +1 -0
  56. package/package.json +2 -1
  57. package/scripts/rebrand-pi.mjs +2 -2
  58. package/skills/core/academic-grill/SKILL.md +1 -1
  59. package/skills/core/analysis-plan/SKILL.md +29 -0
  60. package/skills/core/manifest.json +3 -3
  61. package/vendor/ars/pi/wrapper.js +14 -5
  62. package/vendor/ars/pi/wrapper.test.mjs +10 -0
  63. package/dist/src/research/brief.d.ts +0 -11
  64. package/dist/src/research/brief.js +0 -81
  65. package/dist/src/research/brief.js.map +0 -1
  66. package/skills/core/research-brief/SKILL.md +0 -17
package/README.md CHANGED
@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
4
4
 
5
5
  PsyClaw 自有代码使用 MIT 许可证;随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`,保持上游署名并单独遵循 CC BY-NC 4.0,仅限非商业用途。
6
6
 
7
- 当前版本:`0.28.3`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
7
+ 当前版本:`0.29.2`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
8
8
 
9
9
  ## 发布流程
10
10
 
@@ -21,19 +21,19 @@ RELEASE_MESSAGE="release: describe the change" pnpm release:push
21
21
  需要 Node.js `>=22.19.0`。官方 npm 源:
22
22
 
23
23
  ```powershell
24
- npm install -g psyclaw@0.28.3
24
+ npm install -g psyclaw@0.29.2
25
25
  ```
26
26
 
27
27
  如果本机 npm 配置把 registry 误写成带有 `~/` 的地址,请显式指定官方源:
28
28
 
29
29
  ```bash
30
- npm install -g psyclaw@0.28.3 --registry=https://registry.npmjs.org/
30
+ npm install -g psyclaw@0.29.2 --registry=https://registry.npmjs.org/
31
31
  ```
32
32
 
33
33
  中国大陆网络较慢或无法访问官方源时:
34
34
 
35
35
  ```powershell
36
- npm install -g psyclaw@0.28.3 --registry=https://registry.npmmirror.com
36
+ npm install -g psyclaw@0.29.2 --registry=https://registry.npmmirror.com
37
37
  ```
38
38
 
39
39
  PsyClaw 的 npm 发布包直接携带 Windows x64/arm64 版 `ripgrep` 和 `fd`,Windows 启动时直接使用包内可执行文件,不再联网下载。其他平台缺少这两个工具时仍由锁定的 Pi 原生工具管理器处理:代理环境走 GitHub 官方 API 与 Release,国内 npm registry 环境统一走国内镜像。
@@ -59,13 +59,12 @@ psyclaw
59
59
 
60
60
  初始化会建立 `.psyclaw/data/raw/`、`data/clean/`、`literature/pdfs/`、`notes/` 和 `outputs/`,不再把原始数据目录暴露在项目根目录。`.psyclaw/data/raw/` 是只读保护区;旧项目的 `data/raw/` 仍保持只读兼容,把经确认可用于分析的派生数据放在 `data/clean/`。
61
61
 
62
- 在对话界面中,`/init <研究目标>` 只初始化研究项目和规格,随后使用 `/run [本轮目标]` 才启动受控研究流程。没有依次运行 `/init` `/run` 时,PsyClaw 保持普通对话模式,不强制加入研究门禁或阶段式询问。
62
+ 在对话界面中,`/init <研究目标>` 初始化研究项目与工作区;随后用 Shift+Tab 切换到 `analysis` 或 `academic` 推进。没有单独的 `/run` `/brief` 命令。未 `/init` 时保持普通对话,不强制研究门禁。
63
63
 
64
- 登记本地材料并生成离线证据简报:
64
+ 登记本地材料:
65
65
 
66
66
  ```powershell
67
67
  psyclaw evidence add notes\source.md --level user
68
- psyclaw brief
69
68
  ```
70
69
 
71
70
  ## 常用入口
@@ -74,11 +73,10 @@ psyclaw brief
74
73
  | --- | --- |
75
74
  | 启动研究对话 | `psyclaw` 或 `psyclaw chat` |
76
75
  | 续接当前项目最近一次会话 | `psyclaw --continue` 或 `psyclaw -c` |
77
- | 创建研究项目 | `psyclaw init <goal> --paradigm <profile>` |
78
- | 启动受控研究流程 | 对话中依次输入 `/init <goal>`、`/run [--skills a,b] [objective]` |
76
+ | 创建研究项目 | `psyclaw init <goal> --paradigm <profile>` 或对话 `/init <goal>` |
77
+ | 推进分析 / 写作 | Shift+Tab 切换 analysis / academic;可选 `/loop`、`/review` |
79
78
  | 模拟同行评审 | 论文完成后在对话中输入 `/review` |
80
79
  | 登记本地证据 | `psyclaw evidence add <path> --level user\|fulltext` |
81
- | 生成离线简报 | `psyclaw brief` |
82
80
  | 写研究移交记录 | `psyclaw handoff` |
83
81
  | 扫描本机其他 Agent | `psyclaw agents` |
84
82
  | 查看 PsyClaw 和内置运行时更新 | `psyclaw check-updates` |
@@ -92,7 +90,10 @@ psyclaw brief
92
90
  | 创建项目能力 | `/create-skill`、`/create-hook`、`/create-rule`、`/create-subagent`(均先预览并确认) |
93
91
  | 运行自定义只读角色 | `/agents --agent <id> <task>` 或 `/agents --agents <id,...> <task>`(最多四个隔离 worker) |
94
92
  | 调用已加载 Skill | `/skill:<name>` |
95
- | 使用 PsyClaw ARS | `Shift+Tab` 进入 academic mode(底栏显示);thinking level 改用 `Ctrl+Shift+Tab`;也可用 `/ars doctor` / `/ars full <task>` |
93
+ | 使用模式 | `Shift+Tab`:`chat` `analysis` → `academic`;thinking `Ctrl+Shift+Tab` |
94
+ | 搭建仓库 | `/init`(只建目录 + `psyclaw.md`) |
95
+ | 人确认关键字段 | `/verify list` 或 `/verify <id> verified` |
96
+ | 使用 PsyClaw ARS | 切到 `academic`;也可用 `/ars doctor` / `/ars full <task>` |
96
97
  | 管理 Plugin | `/plugin`;终端使用 `psyclaw plugin install|remove|list` |
97
98
  | 调用已配置 MCP | 模型通过 `psyclaw_mcp` 自动发现并调用 `.psyclaw/mcp/*.json` 中启用的服务器 |
98
99
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schemaVersion": "psyclaw/recommended-agents/v1",
3
- "documentVersion": "0.28.3",
4
- "syncedAt": "2026-09-06",
3
+ "documentVersion": "0.29.2",
4
+ "syncedAt": "2026-09-07",
5
5
  "sourceDocument": "bundled literature/review subagents",
6
6
  "sourceRef": "bundled",
7
7
  "repositoryHint": "对齐 Claude Code:Subagent = md 提示合订本。外仓可后续以 GitHub 源加入 installPrep;当前内置 8 个无需安装。",