Skip to content

docs: 扩充 FAQ 性能/委派/自动化章节,修复 More 索引 - #38

Open
yi-ge wants to merge 3 commits into
mainfrom
docs/faq-more-enhancement
Open

docs: 扩充 FAQ 性能/委派/自动化章节,修复 More 索引#38
yi-ge wants to merge 3 commits into
mainfrom
docs/faq-more-enhancement

Conversation

@yi-ge

@yi-ge yi-ge commented Jul 25, 2026

Copy link
Copy Markdown
Member

修改内容

FAQ 扩充(中文 + 英文)

文件 修改
06-performance.md 从 2 题扩充到 7 题:新增磁盘占用、GPU/风扇、长时间变慢、大量智能体影响、查看资源占用
07-delegation.md 新增 委派与协作 FAQ(7 题):委派 vs 对话、查看进展、取消委派、团队通信、回执、失败排查、创建团队
08-automation.md 新增 自动化 FAQ(7 题):调度 vs 心跳、未触发排查、执行历史、通知频率、Sleep vs Schedule、周期任务、失败排查
index.md 添加新分类链接(委派与协作、自动化问题)

More 完善(中文 + 英文)

文件 修改
index.md 添加缺失的「第三方软件与许可」链接

截图

  • 添加 DesireCore 主界面真实截图(通过 CDP 远程调试端口截取)

真实性说明

  • 所有新增内容基于 DesireCore 真实功能(Electron 架构、Agent 服务、调度系统、委派机制)
  • 未修改任何算力(compute)相关文档
  • 性能 FAQ 中的数值范围基于 Electron 应用通用经验

未修改

  • 04-supported-providers.md(算力相关,禁区)
  • 01-05 FAQ 原有内容(已足够完善,不做无依据修改)

FAQ 改进:
- 06-performance.md: 从 2 题扩充到 7 题(磁盘、GPU、资源查看等)
- 新增 07-delegation.md: 委派与协作 FAQ(7 题)
- 新增 08-automation.md: 自动化 FAQ(7 题)
- index.md: 添加新分类链接

More 改进:
- index.md: 添加第三方软件与许可链接(zh+en)

截图:
- 添加 DesireCore 主界面真实截图

i18n:
- 同步更新英文版 FAQ(06-performance 扩充、07-delegation、08-automation 新增)
- 同步更新英文版索引
@vercel

vercel Bot commented Jul 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 26, 2026 2:08am

Request Review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 26e2d36185

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".


1. **确认调度存在** --- 使用 ManageSchedule(action=list)查看调度列表,确认任务未被删除或取消
2. **检查触发时间** --- 确认 trigger_value 的时区正确(使用带时区的 ISO 格式,如 `2026-07-26T09:00:00+08:00`)
3. **检查应用是否运行** --- 调度需要 DesireCore 在运行中才能触发;应用关闭期间到期的调度会在下次启动后补触发

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Honor missed-fire policy instead of promising a catch-up

This guarantee is false when a schedule uses the documented skip missed-fire policy: docs/02-user-guide/08-automation/03-scheduled-tasks.md:268-280 says only missed interval runs are detected for compensation and that missed_fire_policy determines whether they run at all. A user relying on this FAQ may close the app expecting a reminder or job to execute on restart even though it is skipped. Describe the policy-dependent behavior here and in the English mirror.

Useful? React with 👍 / 👎.

Comment on lines +43 to +44
2. **使用 notify=false** --- 无变化时静默记录,不发送通知
3. **优化检查逻辑** --- 只在确实有变化或需要关注时才设置 notify=true

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace the unsupported heartbeat notify flag

The documented heartbeat contract does not expose a notify configuration flag: HeartbeatRespond submits an outcome and optional notificationText, and no_change is the outcome that records silently (docs/02-user-guide/08-automation/01-heartbeat.md:66-86). Consequently, setting notify=false or notify=true as suggested here will not adjust notification behavior. Direct users to return no_change or the appropriate structured outcome, and update the English mirror as well.

Useful? React with 👍 / 👎.

…mage

- Rename 09-third-party-software.md → 10-third-party-software.md to
  eliminate duplicate 09- numbering with 09-open-source-repos.md
  (file content unchanged, originally added in PR #29 commit 18d6617)
- Rename 10-changelog/ → 11-changelog/ for sequential numbering
- Update all 14 cross-references (zh + en) to new paths
- Remove unreferenced docs/06-faq/assets/desirecore-main-interface.png
yi-ge added a commit that referenced this pull request Jul 26, 2026
修复 PR #35 审核反馈:
- 删除误提交的 PLAN-interface-conversations.md
- 还原 interface/conversations/super-document/memory/capabilities/email/
  concepts/more/faq 章节至 origin/main(由 PR #36/#38 各自负责)
- 移除 .drawio 源文件(keyboard-shortcuts-overview, data-flow-diagram)
- 移除不属于本 PR 的 static/img 图片文件
- 移除 FAQ 中越界新增的 07-delegation.md、08-automation.md

本 PR 现仅包含 user-guide/06-agents/ 和 03-teaching/ 的内容增强。

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review


P1 Badge Update changelog consumers after renaming the directory

This rename removes docs/05-more/10-changelog, but the Docusaurus plugin in plugins/changelog-json-plugin.ts still passes that path to readdirSync during loadContent, so every site start/build aborts with ENOENT before generating the documentation. The cover-generation scripts also retain the old Chinese and English paths; update all hard-coded consumers to 11-changelog as part of the move.

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

- plugins/changelog-json-plugin.ts: fix build-breaking path reference
- scripts/backfill-en-covers.mjs: fix utility script path
- scripts/generate-changelog-cover.mjs: fix utility script path

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 36f0b299fc

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +34 to +36
1. 在智能体的对话历史中找到对应时间的会话记录
2. 调度触发时的 prompt 会作为该会话的第一条消息
3. 如果调度执行失败,可以在会话记录中看到错误信息

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Direct users to the automation panel for schedule history

For triggers whose result is stored only as an execution record, there may be no corresponding conversation to find: the scheduled-task guide says results can enter a conversation, notification, or execution record, while every trigger—including failed and skipped runs—is recorded in the task detail's execution history (docs/02-user-guide/08-automation/03-scheduled-tasks.md:282-306). Direct users to Automation → task details → execution history rather than presenting conversation history as the way to inspect runs, and update the English mirror as well.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant